WriteOIIO node

pluginIcon

This documentation is for version 1.0 of WriteOIIO.

Description

Write images using OpenImageIO.

OpenImageIO supports writing the following file formats:

BMP (*.bmp)

Cineon (*.cin)

DPX (*.dpx)

FITS (*.fits)

HDR/RGBE (*.hdr)

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)

All supported formats and extensions: bmp: bmp; cineon: cin; dds: dds; dpx: dpx; field3d: f3d; fits: fits; gif: gif; hdr: hdr, rgbe; ico: ico; iff: iff, z; jpeg: jpg, jpe, jpeg, jif, jfif, jfi; jpeg2000: jp2, j2k, j2c; openexr: exr, sxr, mxr; png: png; pnm: ppm, pgm, pbm, pnm, pfm; psd: psd, pdd, psb; raw: bay, bmq, cr2, crw, cs1, dc2, dcr, dng, erf, fff, k25, kdc, mdc, mos, mrw, nef, orf, pef, pxn, raf, raw, rdc, sr2, srf, x3f, arw, 3fr, cine, ia, kc2, mef, nrw, qtk, rw2, sti, rwl, srw, drf, dsc, ptx, cap, iiq, rwz; rla: rla; sgi: sgi, rgb, rgba, bw, int, inta; socket: socket; softimage: pic; tiff: tiff, tif, tx, env, sm, vsm; targa: tga, tpic; webp: webp; zfile: zfile;

OIIO versions:

compiled with 1.7.12

running with 1.7.12

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.
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 aforementionned. there will be at least 2 digits). The file name may not contain any # (hash) in which case it will be overriden everytimes. Views can be specified using the “long” view notation %V or the “short” notation using %v.
Format Type / formatType Choice Project Format
Determines which rectangle of pixels will be written in output.
Input Format: Renders the pixels included in the input format
Project Format: Renders the pixels included in the project format
Fixed Format: Renders the pixels included in the format indicated by the Format parameter.
Format / NatronParamFormatChoice Choice HD 1920x1080 The output format to render
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 / ocioInputSpace String scene_linear Input data is taken to be in this colorspace.
Input Colorspace / ocioInputSpaceIndex Choice Linear
Input data is taken to be in this colorspace.
Linear: Rec. 709 (Full Range), Blender native linear space (reference, scene_linear)
Raw: (color_picking, texture_paint)
adx10: Film Scan, using the 10-bit Academy Density Encoding
Linear ACES: ACES linear space
display/nuke_rec709: Rec. 709 (Full Range) Display Space
display/dci_xyz: OpenDCP output LUT with DCI reference white and Gamma 2.6
display/lg10: conversion from film log (color_timing)
lgf: lgf : conversion from film log (compositing_log)
display/srgb8: RGB display space for the sRGB standard.
sRGB: Standard RGB Display Space
VD16: The simple video conversion from a gamma 2.2 sRGB space
Cineon: Cineon (Log Film Scan)
Panalog: Sony/Panavision Genesis Log Space
REDLog: RED Log Space
ViperLog: Viper Log Space
AlexaV3LogC: Alexa Log C
PLogLin: Josh Pines style pivoted log/lin conversion. 445->0.18
SLog: Sony SLog
SLog1: Sony SLog1
SLog2: Sony SLog2
SLog3: Sony SLog3
CLog: Canon CLog
Protune: GoPro Protune
Non-Color: Color space used for images which contains non-color data (i,e, normal maps)
display/p3dci8: p3dci8 :rgb display space for gamma 2.6 P3 projection.
File Colorspace / ocioOutputSpace String scene_linear Output data is taken to be in this colorspace.
File Colorspace / ocioOutputSpaceIndex Choice Linear
Output data is taken to be in this colorspace.
Linear: Rec. 709 (Full Range), Blender native linear space (reference, scene_linear)
Raw: (color_picking, texture_paint)
adx10: Film Scan, using the 10-bit Academy Density Encoding
Linear ACES: ACES linear space
display/nuke_rec709: Rec. 709 (Full Range) Display Space
display/dci_xyz: OpenDCP output LUT with DCI reference white and Gamma 2.6
display/lg10: conversion from film log (color_timing)
lgf: lgf : conversion from film log (compositing_log)
display/srgb8: RGB display space for the sRGB standard.
sRGB: Standard RGB Display Space
VD16: The simple video conversion from a gamma 2.2 sRGB space
Cineon: Cineon (Log Film Scan)
Panalog: Sony/Panavision Genesis Log Space
REDLog: RED Log Space
ViperLog: Viper Log Space
AlexaV3LogC: Alexa Log C
PLogLin: Josh Pines style pivoted log/lin conversion. 445->0.18
SLog: Sony SLog
SLog1: Sony SLog1
SLog2: Sony SLog2
SLog3: Sony SLog3
CLog: Canon CLog
Protune: GoPro Protune
Non-Color: Color space used for images which contains non-color data (i,e, normal maps)
display/p3dci8: p3dci8 :rgb display space for gamma 2.6 P3 projection.
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.
If it is Premultiplied, red, green and blue channels are divided by the alpha channel before applying the colorspace conversion.
This is set automatically from the input stream information, but can be adjusted if this information is wrong.
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: The image is premultiplied by its alpha (also called “associated alpha”).
UnPreMultiplied: 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: The union of all inputs frame ranges will be rendered.
Project frame range: The frame range delimited by the frame range of the project will be rendered.
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.
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.
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: All views and layers will be in the same part, ensuring compatibility with OpenEXR 1.x
Split 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: 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.