Reformat
Reformat lets you resize and reposition your image sequences to a different format (width and height). This also allows you to use plates of varying image resolution on a single script without running into issues when combining them. All scripts should include Reformat nodes after each Read node to specify, at the very least, the output resolution of the images in the script.
Inputs and Controls
Connection Type |
Connection Name |
Function |
Input |
unnamed |
The image to resize. |
Control (UI) |
Knob (Scripting) |
Default Value |
Function |
Reformat 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 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 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 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, Reformat translates the image to center it in the output. When disabled, Reformat translates the image so that the lower left corners line up. |
flip |
flip |
disabled |
When enabled, Reformat flips the image upside down. |
flop |
flop |
disabled |
When enabled, Reformat flops the image left and right. |
turn |
turn |
disabled |
When enabled, Reformat rotates the image 90 degrees counter-clockwise. |
filter |
filter |
Cubic |
Select the filtering algorithm to use when remapping pixels from their original positions to new positions. This allows you to avoid problems with image quality, particularly in high contrast areas of the frame (where highly aliased, or jaggy, edges may appear if pixels are not filtered and retain their original values). • Impulse - remapped pixels carry their original values. • Cubic - remapped pixels receive some smoothing. • Keys - remapped pixels receive some smoothing, plus minor sharpening (as shown by the negative -y portions of the curve). • Simon - remapped pixels receive some smoothing, plus medium sharpening (as shown by the negative -y portions of the curve). • Rifman - remapped pixels receive some smoothing, plus significant sharpening (as shown by the negative -y portions of the curve). • Mitchell - remapped pixels receive some smoothing, plus blurring to hide pixelation. • Parzen - remapped pixels receive the greatest smoothing of all filters. • Notch - remapped pixels receive flat smoothing (which tends to hide moire patterns). • Lanczos4, Lanczos6, and Sinc4 - remapped pixels receive sharpening which can be useful for scaling down. Lanczos4 provides the least sharpening and Sinc4 the most. |
clamp |
clamp |
disabled |
When using filters that employ sharpening, such as Rifman and Lanczos, you may see a haloing effect. If necessary, check clamp to correct this problem. |
black outside |
black_outside |
enabled |
This renders as black pixels outside the image boundary, making it easier to layer the element over another. If you uncheck this control, the outside area is filled with the outermost pixels of the image sequence. In most cases, you should keep black outside checked. However, you may want to turn this off for camera shake, or if you want to texture-map or intersect the output with a similar shape. Note: Enabling black outside also adds a solid alpha covering the input image area if no alpha is present. |
preserve bounding box |
pbb |
disabled |
When enabled, pixels outside the output format are preserved. When disabled, pixels outside the output format are clipped off. |