Natron Documentation Release 3.0.0 The Natron documentation authors Mar 29, 2021 Contents 1 User Guide 3 1.1 What is compositing?........................................3 1.1.1 Theory............................................3 1.1.2 Practice...........................................4 1.2 Getting started............................................4 1.2.1 About............................................4 1.2.2 Installation.........................................6 1.2.3 Environment........................................ 15 1.2.4 Troubleshooting....................................... 16 1.3 Compositing............................................. 17 1.3.1 Managing Projects..................................... 17 1.3.2 Reformatting elements (empty)............................... 18 1.3.3 Channels (empty)...................................... 18 1.3.4 Merging images (empty).................................. 18 1.3.5 Noise removal (empty)................................... 18 1.3.6 Keying (empty)....................................... 18 1.3.7 Using Rotopaint (empty).................................. 18 1.3.8 Tracking and stabilizing.................................. 18 1.3.9 Transforming elements (empty).............................. 20 1.3.10 Working with color (empty)................................ 20 1.3.11 Stereoscopic compositing.................................. 20 1.3.12 Preview and rendering (empty)............................... 24 1.3.13 Expressions (empty).................................... 24 1.4 Tutorials............................................... 34 1.4.1 Writing documentation................................... 34 1.4.2 HSVTool.......................................... 36 1.4.3 FFmpeg (empty)...................................... 43 1.4.4 Using PanoTools projects within Natron.......................... 44 1.4.5 Vector graphics workflow.................................. 47 1.4.6 Alternative Matte Extraction Tutorial............................ 51 2 Reference Guide 57 2.1 Preferences.............................................. 57 2.1.1 General........................................... 57 2.1.2 Threading.......................................... 57 2.1.3 Rendering.......................................... 58 2.1.4 GPU Rendering....................................... 59 2.1.5 Project Setup........................................ 59 2.1.6 Documentation....................................... 59 2.1.7 User Interface........................................ 59 2.1.8 Color Management..................................... 60 i 2.1.9 Caching........................................... 60 2.1.10 Viewer............................................ 61 2.1.11 Nodegraph......................................... 62 2.1.12 Plug-ins........................................... 62 2.1.13 Python............................................ 63 2.1.14 Appearance......................................... 63 2.2 Environment Variables........................................ 65 2.2.1 What are Environment Variables?............................. 65 2.2.2 How do I set an environment variable?........................... 65 2.2.3 Natron Environment Variables............................... 67 2.3 Image nodes............................................. 67 2.3.1 CheckerBoard node..................................... 67 2.3.2 ColorBars node....................................... 70 2.3.3 ColorWheel node...................................... 72 2.3.4 Constant node........................................ 74 2.3.5 OpenRaster node...................................... 75 2.3.6 Read node.......................................... 80 2.3.7 ReadCDR node....................................... 84 2.3.8 ReadFFmpeg node..................................... 88 2.3.9 ReadKrita node....................................... 93 2.3.10 ReadMisc node....................................... 98 2.3.11 ReadOIIO node....................................... 103 2.3.12 ReadPDF node....................................... 111 2.3.13 ReadPFM node....................................... 115 2.3.14 ReadPNG node....................................... 120 2.3.15 ReadPSD node....................................... 124 2.3.16 ReadSVG node....................................... 134 2.3.17 RunScript node....................................... 139 2.3.18 Solid node.......................................... 145 2.3.19 Write node......................................... 147 2.3.20 WriteFFmpeg node..................................... 149 2.3.21 WriteOIIO node....................................... 160 2.3.22 WritePFM node....................................... 167 2.3.23 WritePNG node....................................... 171 2.4 Draw nodes.............................................. 176 2.4.1 LightWrap node....................................... 176 2.4.2 Noise node......................................... 181 2.4.3 Plasma node......................................... 182 2.4.4 Radial node......................................... 183 2.4.5 Ramp node......................................... 185 2.4.6 Rand node.......................................... 186 2.4.7 Rectangle node....................................... 188 2.4.8 Roto node.......................................... 189 2.4.9 RotoPaint node....................................... 192 2.4.10 SeGrain node........................................ 195 2.4.11 SeNoise node........................................ 197 2.4.12 Text node.......................................... 200 2.5 Time nodes.............................................. 204 2.5.1 AppendClip node...................................... 204 2.5.2 Deinterlace node...................................... 204 2.5.3 FrameBlend node...................................... 206 2.5.4 FrameHold node...................................... 207 2.5.5 FrameRange node...................................... 207 2.5.6 NoTimeBlur node...................................... 208 2.5.7 Retime node......................................... 209 2.5.8 SlitScan node........................................ 210 2.5.9 TimeBlur node....................................... 211 2.5.10 TimeOffset node...................................... 212 ii 2.6 Channel nodes............................................ 213 2.6.1 Shuffle node......................................... 213 2.7 Color nodes.............................................. 216 2.7.1 Add node.......................................... 216 2.7.2 Clamp node......................................... 217 2.7.3 ClipTest node........................................ 218 2.7.4 ColorCorrect node..................................... 219 2.7.5 ColorLookup node..................................... 221 2.7.6 ColorMatrix node...................................... 224 2.7.7 ColorSuppress node..................................... 225 2.7.8 Equalize node........................................ 226 2.7.9 Gamma node........................................ 227 2.7.10 Grade node......................................... 227 2.7.11 HSIToRGB node...................................... 229 2.7.12 HSLToRGB node...................................... 230 2.7.13 HSVToRGB node...................................... 230 2.7.14 HSVTool node....................................... 231 2.7.15 HistEQ node........................................ 233 2.7.16 HueCorrect node...................................... 234 2.7.17 Invert node......................................... 235 2.7.18 LabToRGB709 node.................................... 236 2.7.19 LabToXYZ node...................................... 236 2.7.20 Log2Lin node........................................ 237 2.7.21 Multiply node........................................ 238 2.7.22 OCIOCDLTransform node................................. 238 2.7.23 OCIOColorSpace node................................... 240 2.7.24 OCIODisplay node..................................... 242 2.7.25 OCIOFileTransform node.................................. 245 2.7.26 OCIOLogConvert node................................... 247 2.7.27 OCIOLookTransform node................................. 248 2.7.28 PLogLin node........................................ 253 2.7.29 Quantize node........................................ 254 2.7.30 RGB709ToLab node.................................... 255 2.7.31 RGB709ToXYZ node.................................... 256 2.7.32 RGBToHSI node...................................... 256 2.7.33 RGBToHSL node...................................... 257 2.7.34 RGBToHSV node...................................... 257 2.7.35 RGBToYCbCr601 node.................................. 258 2.7.36 RGBToYCbCr709 node.................................. 258 2.7.37 RGBToYPbPr601 node................................... 259 2.7.38 RGBToYPbPr709 node................................... 259 2.7.39 RGBToYUV601 node................................... 260 2.7.40 RGBToYUV709 node................................... 260 2.7.41 Saturation node....................................... 261 2.7.42 VectorToColor node..................................... 262 2.7.43 XYZToLab node...................................... 262 2.7.44 XYZToRGB709 node.................................... 263 2.7.45 XYZToxyY node...................................... 263 2.7.46 YCbCrToRGB601 node.................................. 264 2.7.47 YCbCrToRGB709 node.................................. 264 2.7.48 YPbPrToRGB601 node................................... 265 2.7.49 YPbPrToRGB709 node..................................