檢視高度. 指定在請求中沒有符合時回應影像(檢視影像)的高度。

hei= *val*

var

影像高度(以像素為單位)(整數大於0)。

如果同時指定了wid=scl=,則可根據align=屬性裁切複合影像。 當fit=存在時,hei=會指定確切、最小或最大的響應影像高度;如需詳細資訊,請參閱 [fit=](/docs/dynamic-media-developer-resources/image-serving-api/image-serving-api/http-protocol-reference/command-reference/r-fit.html?lang=zh-Hant#reference-f11bff6d93d143d6b135de3a923bc989)說明。

如果未指定scl=,則複合影像會縮放以適合。 如果同時指定了wid=hei=,並且未指定scl=,則影像將縮放以完全適合在寬/平矩形內,使盡可能少的背景區域暴露;在這種情況下,影像會根據align=屬性放在檢視矩形內。 背景區域會填入bgc=,若未指定attribute::BkgColor則填入。

注意

如果計算的回覆影像大小大於attribute::MaxPix,則會傳回錯誤。

屬性

檢視屬性。 無論目前的層設定為何,都適用。

預設

如果未指定wid=hei=scl=,則回復影像的大小為複合影像或attribute::DefaultPix,以較小者為準。

範例

請求影像以適合200x200的矩形;如果影像不是正方形,則左上對齊影像。 任何背景區域都會填入attribute::BkgColor

http://server/myRootId/myImageId?wid=200&hei=200&align=-1,-1

相同的影像,以200像素的固定高度傳送,但寬度可變以符合影像的長寬比。 在這種情況下,傳回的影像從來沒有任何背景填充區域。 請注意,在此情況下,align=將完全無效。

http://server/myRootId/myImageId?hei=200

另請參閱

wid= , fit=, scl=, align=, bgc=, rgn=, 屬性::DefaultPix, 屬性::MaxPix

本頁內容