Write node

This documentation is for version 1.0 of Write.

Description

Node used to write images or videos on disk. The image/video is identified by its filename and its extension. Given the extension, the Writer selected from the Preferences to encode that specific format will be used.

Inputs

Input Description Optional
Source   No

Controls

Parameter / script name Type Default Function
Frame Increment / frameIncr Integer 1 The number of frames the timeline should step before rendering the new frame. If 1, all frames will be rendered, if 2 only 1 frame out of 2, etc. This number cannot be less than 1.
Read back file / readBack Boolean Off When checked, the output of this node comes from reading the written file instead of the input node
Encoder / encodingPluginChoice Choice Default
Select the internal encoder plug-in used for this file format. By default this uses the plug-in selected for this file extension in the Preferences.
Default: Use the default plug-in chosen from the Preferences to write this file format
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
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: Scene-linear, high dynamic range. Used for rendering and compositing. (reference, scene_linear)
sRGB: Standard RGB Display Space (color_picking, texture_paint, matte_paint)
rec709: Rec. 709 (Full Range) Display Space
Cineon: Cineon (Log Film Scan) (compositing_log, color_timing)
Gamma1.8: Emulates an idealized Gamma 1.8 display device.
Gamma2.2: Emulates an idealized Gamma 2.2 display device.
Gamma2.4: Emulates an idealized Gamma 2.4 display device.
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
raw: Raw Data. Used for normals, points, etc. (default, data)
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: Scene-linear, high dynamic range. Used for rendering and compositing. (reference, scene_linear)
sRGB: Standard RGB Display Space (color_picking, texture_paint, matte_paint)
rec709: Rec. 709 (Full Range) Display Space
Cineon: Cineon (Log Film Scan) (compositing_log, color_timing)
Gamma1.8: Emulates an idealized Gamma 1.8 display device.
Gamma2.2: Emulates an idealized Gamma 2.2 display device.
Gamma2.4: Emulates an idealized Gamma 2.4 display device.
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
raw: Raw Data. Used for normals, points, etc. (default, data)
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