wid

Last update: 2023-09-28
  • Created for:
  • Developer
    User

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 either has the size of the composite image or attribute::DefaultPix, whichever is smaller.

Properties

View attribute. It applies regardless of the current layer setting.

Example

Request an image so it can 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. In this case, align= would have no effect at all.

http:// *Server*/myRootId/myImageId?wid=200

See also

hei= , fit=, scl=, align=, attribute::DefaultPix, attribute::MaxPix

On this page