Write node

This documentation is for version 1.0 of Write.


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.


Input Description Optional
Source   No


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 (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)
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.
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 (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