wid

View width. Specifies the width of the response image (view image) when fit= is not present in the request.

wid=val

val

Image width in pixels (int greater than 0).

If both hei= and scl= are specified, the composite image may be cropped according to the align= attribute. When fit= is present, wid= specifies the exact, the minimum, or the maximum response image width; refer to the description of fit= for details.

If scl= is not specified, the composite image is scaled to fit. If both wid= and hei= are specified, and scl= is not specified, then the image is scaled to fit entirely within the wid/hei rectangle, leaving as little background area exposed as possible. In this case, the image is positioned within the view rectangle according to the align= attribute.

Note: An error is returned if the calculated or default reply image size is larger than attribute::MaxPix.

Default

If neither wid=, hei=, nor scl= are specified, the reply image will either have the size of the composite image or attribute::DefaultPix, whichever is smaller.

Properties

View attribute. Applies regardless of the current layer setting.

Example

Request an image to fit into a 200x200 rectangle; top-right align the image if it is not square. Any background area is filled with attribute::BkgColor.

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

The same image, delivered at a fixed width of 200 pixels, but with a variable height to maintain the aspect ratio of the image. In this case, the returned image never has any background fill areas. Note that in this case align= would have no effect at all.

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