DeepReformat

DeepReformat is the Reformat node for deep data. You can use it to set your deep image’s dimensions, scale, and so on.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The deep image to resize. This can also be a DeepMerge node with merged deep data.

Control (UI)

Knob (Scripting)

Default Value

Function

DeepReformat Tab

type

type

to format

Select how to resize the image:

to format - Set the output width and height to the selected format. Choose the format in the output format dropdown menu. If the format does not yet exist, you can select new to create a new format from scratch. The default setting, root.format, resizes the image to the format indicated on the Project Settings dialog.

to box - Set the output width and height to dimensions you define (in pixels). Enter values in the width/height and pixel aspect fields to specify the dimensions. This option is useful for creating a thumbnail of the input image.

scale - Set the output width and height to a multiple of the input size. Use the scale slider to define the factor. The scale factor is rounded slightly, so that the output image is an integer number of pixels in the direction chosen under resize type.

output format

format

root.format

The format to which you want to output the deep image sequence. If the format does not yet exist, you can select new to create a new format from scratch. The default setting, root.format, resizes the image to the format indicated in the Project Settings.

This control is only available if you have set type to to format.

width/height

box_width

200

The output width for your deep image. The units are in pixels.

This control is only available if you have set type to to box.

box_height

200

The output height for your deep image. The units are in pixels.

This control is only available if you have set type to to box.

force this shape

box_fixed

disabled

When enabled, the output image matches the width/height fields exactly, even if the original image is a different shape. To achieve this, one direction gets either clipped or padded.

When disabled, the output image is approximately the same shape as the original, rounded to the nearest integer number of pixels.

This control is only available if you have set type to to box.

pixel aspect

box_pixel_aspect

1

Sets the pixel aspect ratio for the output image.

This control is only available if you have set type to to box.

scale

scale

1

The scale factor for the width and the height. To scale each direction separately using different scale factors, click the 2 button.

This control is only available if you have set type to scale.

resize type

resize

width

Choose the method by which you preserve or override the original pixel aspect ratio. Select:

none - to not resize the original.

width - to scale the original until its width matches the output width. Height is then scaled in such a manner as to preserve the original aspect ratio.

height - to scale the original so that it fills the output height. Width is then scaled in such a manner as to preserve the original aspect ratio.

fit - to scale the original so that its smallest side fills the output width or height. The longest side is then scaled in such a manner as to preserve the original aspect ratio.

fill - to scale the original so that its longest side fills the output width or height. The smallest side is then scaled in such a manner as to preserve the original aspect ratio.

distort - to scale the original so that both sides fill the output dimensions. This option does not preserve the original aspect ratio, so distortions may occur.

center

center

enabled

When enabled, DeepReformat translates the image to center it in the output.

When disabled, DeepReformat translates the image so that the lower left corners line up.

flip

flip

disabled

When enabled, flips the image upside down.

flop

flop

disabled

When enabled, flops the image left and right.

turn

turn

disabled

When enabled, rotates the image 90 degrees counter-clockwise.

black outside

black_outside

disabled

When enabled, pixels outside the image boundary are set to black.

When disabled, the outside area is filled with the outermost pixels of the image area.

preserve bounding box

pbb

disabled

When enabled, pixels outside the output format are preserved.

When disabled, pixels outside the output format are clipped off.

Step-by-Step Guides

Reformatting Deep Images