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 / 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: 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 |