res

Resolution-based image scaling. Scales the image to the requested resolution.

res=val

val

Target resolution; typically in pixels per inch (real).

The scale factor is calculated by dividing val by catalog::Resolution. Note that this command does not affect the print resolution of the reply image.

To use this feature, the resolution of the original source images must be known and set in catalog::Resolution. Depending on the application, the resolution units may vary. For repeatable 2D textures or material swatches, such as wallpapers or fabrics, the resolution may be expressed as pixels/inch, or pixels/mm. Aerial photos and maps may be better served by pixels/mile or pixels/km. In any case, the units used for catalog::Resolution must be the same as the units used for res=.

In addition to obtaining images at precise resolutions, res= can also be used to combine multiple images at the same resolution, so that the items visible in these images are in accurate proportion to each other.

Note: Normally, a composite image is resized to the target view size (specified by wid=, hei=, or attribute::DefaultPix) before it is returned to the client. To prevent this resizing and obtain an image with the exact resolution specified by res=, it may be necessary to disable view scaling by explicitly specifying scl=1. This instructs the server to crop the composite image to the target view size rather than scaling it.

Properties

Source image/mask attribute. Ignored by layers not associated with a source image or mask. Applied to layer 0 is specified for layer=comp. Ignored if either scale= or size= is specified for the same layer.

Default

If not specified, scale= or size= determines the scale factor, or, if neither is specified, the image is used without scaling.

Example

Retrieve a texture image at 12 pixels/inch object resolution for use with Image Rendering or Image Authoring. We specify loss-less PNG format and better quality resampling for best-possible quality,

http://server/myTexture?res=12&fmt=png&resMode=sharp