平

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

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

本頁內容