WriteOIIO node

pluginIcon

This documentation is for version 1.0 of WriteOIIO (fr.inria.openfx.WriteOIIO).

Description

Write images using OpenImageIO.

OpenImageIO supports writing the following file formats:

BMP (*.bmp)

Cineon (*.cin)

DPX (*.dpx)

FITS (*.fits)

HDR/RGBE (*.hdr)

HEIC/HEIF (*.heic *.heif)

Icon (*.ico)

IFF (*.iff)

JPEG (*.jpg *.jpe *.jpeg *.jif *.jfif *.jfi)

JPEG-2000 (*.jp2 *.j2k)

OpenEXR (*.exr)

Portable Network Graphics (*.png)

PNM / Netpbm (*.pbm *.pgm *.ppm)

PSD (*.psd *.pdd *.psb)

RLA (*.rla)

SGI (*.sgi *.rgb *.rgba *.bw *.int *.inta)

Softimage PIC (*.pic)

Targa (*.tga *.tpic)

TIFF (*.tif *.tiff *.tx *.env *.sm *.vsm)

Zfile (*.zfile)

Inputs

Input Description Optional
Source   No

Controls

Parameter / script name Type Default Function
Output Components / outputComponents Choice RGBA
Map the input layer to this type of components before writing it to the output file.
Alpha
RGB
RGBA
File / filename N/A   The output image sequence/video stream file(s). The string must match the following format: path/sequenceName###.ext where the number of # (hashes) will define the number of digits to append to each file. For example path/mySequence###.jpg will be translated to path/mySequence000.jpg, path/mySequence001.jpg, etc. %d printf-like notation can also be used instead of the hashes, for example path/sequenceName%03d.ext will achieve the same than the example aforementioned. there will be at least 2 digits). The file name may not contain any # (hash) in which case it will be overridden everytimes. Views can be specified using the “long” view notation %V or the “short” notation using %v.
Overwrite / overwrite Boolean On Overwrite existing files when rendering.
Format Type / formatType Choice Project Format
Determines which rectangle of pixels will be written in output.
Input Format (input): Renders the pixels included in the input format
Project Format (project): Renders the pixels included in the project format
Fixed Format (fixed): Renders the pixels included in the format indicated by the Format parameter.
Format / NatronParamFormatChoice Choice HD 1920x1080
The output format to render
PC_Video 640x480 (PC_Video)
NTSC 720x486 0.91 (NTSC)
PAL 720x576 1.09 (PAL)
NTSC_16:9 720x486 1.21 (NTSC_16:9)
PAL_16:9 720x576 1.46 (PAL_16:9)
HD_720 1280x720 (HD_720)
HD 1920x1080 (HD)
UHD_4K 3840x2160 (UHD_4K)
1K_Super_35(full-ap) 1024x778 (1K_Super_35(full-ap))
1K_Cinemascope 914x778 2.00 (1K_Cinemascope)
2K_Super_35(full-ap) 2048x1556 (2K_Super_35(full-ap))
2K_Cinemascope 1828x1556 2.00 (2K_Cinemascope)
2K_DCP 2048x1080 (2K_DCP)
4K_Super_35(full-ap) 4096x3112 (4K_Super_35(full-ap))
4K_Cinemascope 3656x3112 2.00 (4K_Cinemascope)
4K_DCP 4096x2160 (4K_DCP)
square_256 256x256 (square_256)
square_512 512x512 (square_512)
square_1K 1024x1024 (square_1K)
square_2K 2048x2048 (square_2K)
Clip To RoD / clipToRoD Boolean On
When checked, the portion of the image written will be the region of definition of the image in input and not the format selected by the Output Format parameter.
For the EXR file format, this will distinguish the data window (size of the image in input) from the display window (the format specified by Output Format).
OCIO Config File / ocioConfigFile N/A   OpenColorIO configuration file
Input Colorspace / ocioInputSpaceIndex Choice   Input data is taken to be in this colorspace.
File Colorspace / ocioOutputSpaceIndex Choice   Output data is taken to be in this colorspace.
key1 / key1 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value1 / value1 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key2 / key2 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value2 / value2 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key3 / key3 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value3 / value3 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
key4 / key4 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
value4 / value4 String  
OCIO Contexts allow you to apply specific LUTs or grades to different shots.
Here you can specify the context name (key) and its corresponding value.
Full details of how to set up contexts and add them to your config can be found in the OpenColorIO documentation:
OCIO config help… / ocioHelp Button   Help about the OpenColorIO configuration.
Input Premult / inputPremult Choice PreMultiplied
Input is considered to have this premultiplication state.
Colorspace conversion is done on the input RGB data, even if it is premultiplied, and may thus give a wrong result if the input is premultiplied and the target colorspace is nonlinear.
This is set automatically from the input stream information, but can be adjusted if this information is wrong.
Opaque (opaque): The image is opaque and so has no premultiplication state, as if the alpha component in all pixels were set to the white point.
PreMultiplied (premult): The image is premultiplied by its alpha (also called “associated alpha”).
UnPreMultiplied (unpremult): The image is unpremultiplied (also called “unassociated alpha”).
Clip Info… / clipInfo Button   Display information about the inputs
Frame Range / frameRange Choice Project frame range
What frame range should be rendered.
Union of input ranges (union): The union of all inputs frame ranges will be rendered.
Project frame range (project): The frame range delimited by the frame range of the project will be rendered.
Manual (manual): The frame range will be the one defined by the first frame and last frame parameters.
First Frame / firstFrame Integer 0  
Last Frame / lastFrame Integer 0  
Tile Size / tileSize Choice Scan-Line Based
Size of a tile in the output file for formats that support tiles. If scan-line based, the whole image will have a single tile.
Scan-Line Based (0)
64
128
256
512
Bit Depth / bitDepth Choice auto
Number of bits per sample in the file [TIFF,DPX,TGA,DDS,ICO,IFF,PNM,PIC].
auto: Guess from the output format
8i: 8 bits integer
10i: 10 bits integer
12i: 12 bits integer
16i: 16 bits integer
16f: 16 bits floating point
32i: 32 bits integer
32f: 32 bits floating point
64i: 64 bits integer
64f: 64 bits floating point
Quality / quality Integer 100 Indicates the quality of compression to use (0-100), for those plugins and compression methods that allow a variable amount of compression, with higher numbers indicating higher image fidelity. [JPEG, TIFF w/ JPEG comp., WEBP]
DWA Compression Level / dwaCompressionLevel Double 45 Amount of compression when using Dreamworks DWAA or DWAB compression options. These lossy formats are variable in quality and can minimize the compression artifacts. Higher values will result in greater compression and likewise smaller file size, but increases the chance for artifacts. Values from 45 to 150 are usually correct for production shots, whereas HDR vacation photos could use up to 500. Values below 45 should give no visible imprrovement on photographs. [EXR w/ DWAa or DWAb comp.]
Orientation / orientation Choice normal
The orientation of the image data [DPX,TIFF,JPEG,HDR,FITS].
By default, image pixels are ordered from the top of the display to the bottom, and within each scanline, from left to right (i.e., the same ordering as English text and scan progression on a CRT). But the “Orientation” parameter can suggest that it should be displayed with a different orientation, according to the TIFF/EXIF conventions.
normal: normal (top to bottom, left to right)
flop: flipped horizontally (top to bottom, right to left)
180: rotate 180deg (bottom to top, right to left)
flip: flipped vertically (bottom to top, left to right)
transposed: transposed (left to right, top to bottom)
90clockwise: rotated 90deg clockwise (right to left, top to bottom)
transverse: transverse (right to left, bottom to top)
90counter-clockwise: rotated 90deg counter-clockwise (left to right, bottom to top)
Compression / compression Choice default
Compression type [TIFF,EXR,DDS,IFF,SGI,TGA]
Indicates the type of compression the file uses. Supported compression modes will vary from format to format. As an example, the TIFF format supports “none”, “lzw”, “ccittrle”, “zip” (the default), “jpeg”, “packbits”, and the EXR format supports “none”, “rle”, “zip” (the default), “piz”, “pxr24”, “b44”, “b44a”, “dwaa” or “dwab”.
default: Guess from the output format
none: No compression [EXR, TIFF, IFF]
zip: Zlib/Deflate compression (lossless) [EXR, TIFF, Zfile]
zips: Zlib compression (lossless), one scan line at a time [EXR]
rle: Run Length Encoding (lossless) [DPX, IFF, EXR, TGA, RLA]
piz: Piz-based wavelet compression [EXR]
pxr24: Lossy 24bit float compression [EXR]
b44: Lossy 4-by-4 pixel block compression, fixed compression rate [EXR]
b44a: Lossy 4-by-4 pixel block compression, flat fields are compressed more [EXR]
dwaa: lossy DCT based compression, in blocks of 32 scanlines. More efficient for partial buffer access. [EXR]
dwab: lossy DCT based compression, in blocks of 256 scanlines. More efficient space wise and faster to decode full frames than DWAA. [EXR]
lzw: Lempel-Ziv Welsch compression (lossless) [TIFF]
ccittrle: CCITT modified Huffman RLE (lossless) [TIFF]
jpeg: JPEG [TIFF]
packbits: Macintosh RLE (lossless) [TIFF]
Layer(s) / outputChannels Choice Color.RGBA
Select which layer to write to the file. This is either All or a single layer. This is not yet possible to append a layer to an existing file.
Color.RGBA (uk.co.thefoundry.OfxImagePlaneColour)
DisparityLeft.Disparity (uk.co.thefoundry.OfxImagePlaneStereoDisparityLeft)
DisparityRight.Disparity (uk.co.thefoundry.OfxImagePlaneStereoDisparityRight)
Backward.Motion (uk.co.thefoundry.OfxImagePlaneBackMotionVector)
Forward.Motion (uk.co.thefoundry.OfxImagePlaneForwardMotionVector)
All Planes / processAllPlanes Boolean Off When checked all planes in input will be processed and output to the same plane as in input. It is useful for example to apply a Transform effect on all planes.
Parts / partSplitting Choice Split Views,Layers
Defines whether to separate views/layers in different EXR parts or not. Note that multi-part files are only supported by OpenEXR >= 2
Single Part (single): All views and layers will be in the same part, ensuring compatibility with OpenEXR 1.x
Split Views (views): All views will have its own part, and each part will contain all layers. This will produce an EXR optimized in size that can be opened only with applications supporting OpenEXR 2
Split Views,Layers (views_layers): Each layer of each view will have its own part. This will produce an EXR optimized for decoding speed that can be opened only with applications supporting OpenEXR 2
Views / viewsSelector Choice All
Select the views to render. When choosing All, make sure the output filename does not have a %v or %V view pattern in which case each view would be written to a separate file.
All
Main
OpenImageIO Info… / libraryInfo Button   Display information about the underlying library.