size

Layer size. Specifies the size or maximum layer size for a layer, before rotate=, perspective=, and extend= are applied to the layer.

size=width,height

sizeN=widthN,heightN

width,height

Layer size constraint in pixels (int, int, 0 or greater).

widthN,heightN

Layer size constraint normalized relative to the layer 0 size (real, real, 0.0…1.0).

When specified for an image layer, size= constrains the layer image's width, or height, or both. The image will be scaled to be no larger than size=. If a normalized size is specified, it is relative to the size of layer 0. If both width and height are specified, the source image is scaled (after crop= is applied) so that neither dimension exceeds the specified size. The aspect ratio of the source rectangle is maintained in all cases. Either width or height may be set to 0; in this case the value is calculated by the server based on the aspect ratio of the image.

When specified for a text layer, size= specifies the text box size. width is required; height may be set to 0, in which case the height of the laid out text is used as the layer height. By default, the text layout engines insert line breaks to ensure that text always fits horizontally into the available space. If height is specified, lines which do not fit into the available space will be clipped (text=) or omitted (textPs=). text= supports additional fit modes; refer to textAttr= for details.

When specified for a solid color layer, size= defines the exact layer size; both values must be specified (unless a mask is provided). If mask= is also specified, the mask image will be sized to fit size= the same way images are scaled in image layers.

Properties

Layer attribute. Applies to layer 0 if layer=comp. sizeN= is not permitted for layer=0 or layer=comp. sizeN= is permitted for layer=0 and layer=comp only in catalog records which define watermark images. In this case, sizeN defines the scaling of the watermark image relative to the composite image to which the watermark is being applied. If size= is specified, res= and scale= are ignored for this layer. Ignored by effect layers.

Default

size=0,0, the layer size is unconstrained. For image layers, the layer size is then determined based on the layer image size after any crop=, scale=, or res= operations have been applied. For text layers, if size= is not specified, the layer will be sized automatically to fit the rendered text.

Solid color layers require either a fully specified size=, a mask=, or clipPath=.

Example

See Example A in Templates.