RotoPaint node — Natron 2.5.0 documentation

# RotoPaint node

This documentation is for version 1.0 of RotoPaint (fr.inria.built-in.RotoPaint).

## Description

RotoPaint is a vector based free-hand drawing node that helps for tasks such as rotoscoping, matting, etc…

## Inputs

Input | Description | Optional
--- | --- | ---
Bg |  | Yes
Bg2 |  | Yes
Bg3 |  | Yes
Bg4 |  | Yes

## Controls

Parameter / script name | Type | Default | Function
--- | --- | --- | ---
Opacity / `opacity` | Double | 1 | Controls the opacity of the selected shape(s).
Color / `color` | Color | r: 1 g: 1 b: 1 | The color of the shape. This parameter is used when the output components are set to RGBA.
Life Time / `lifeTime` | Choice | Single | Controls the life-time of the shape/stroke All: All frames Single: Only for the specified frame From start: From the start of the sequence up to the specified frame To end: From the specified frame to the end of the sequence Custom: Use the Activated parameter animation to control the life-time of the shape/stroke using keyframes
Frame / `lifeTimeFrame` | Integer | 0 | Use this to specify the frame when in mode Single/From start/To end
Feather / `feather` | Double | 1.5 | Controls the distance of feather (in pixels) to add around the selected shape(s)
Feather fall-off / `featherFallOff` | Double | 1 | Controls the rate at which the feather is applied on the selected shape(s).
Source / `sourceType` | Choice | background | Source color used for painting the stroke when the Reveal/Clone tools are used. foreground: The painted result at this point in the hierarchy. background: The original image unpainted connected to bg. background 2: The original image unpainted connected to bg1. background 3: The original image unpainted connected to bg2. background 4: The original image unpainted connected to bg3. background 5: The original image unpainted connected to bg4. background 6: The original image unpainted connected to bg5. background 7: The original image unpainted connected to bg6. background 8: The original image unpainted connected to bg7. background 9: The original image unpainted connected to bg8. background 10: The original image unpainted connected to bg9.
Translate / `cloneTranslate` | Double | x: 0 y: 0 |
Rotate / `cloneRotate` | Double | 0 |
Scale / `cloneScale` | Double | x: 1 y: 1 |
Uniform / `cloneUniform` | Boolean | On |
Skew X / `cloneSkewx` | Double | 0 |
Skew Y / `cloneSkewy` | Double | 0 |
Skew Order / `cloneSkewOrder` | Choice | XY | XY YX
Center / `cloneCenter` | Double | x: 0.5 y: 0.5 |
Reset Center / `resetCloneCenter` | Button |  | Reset the clone transform center
Reset Transform / `resetCloneTransform` | Button |  | Reset the clone transform to an identity
Filter / `cloneFilter` | Choice | Cubic | Filtering algorithm - some filters may produce values outside of the initial range (*) or modify the values even if there is no movement (+). Impulse: (nearest neighbor / box) Use original values. Bilinear: (tent / triangle) Bilinear interpolation between original values. Cubic: (cubic spline) Some smoothing. Keys: (Catmull-Rom / Hermite spline) Some smoothing, plus minor sharpening (*). Simon: Some smoothing, plus medium sharpening (*). Rifman: Some smoothing, plus significant sharpening (*). Mitchell: Some smoothing, plus blurring to hide pixelation (*)(+). Parzen: (cubic B-spline) Greatest smoothing of all filters (+). Notch: Flat smoothing (which tends to hide moire’ patterns) (+).
Black Outside / `blackOutside` | Boolean | On | Fill the area outside the source image with black
Clone time offset / `timeOffset` | Integer | 0 | When the Clone tool is used, this determines depending on the time offset mode the source frame to clone. When in absolute mode, this is the frame number of the source, when in relative mode, this is an offset relative to the current frame.
Mode / `timeOffsetMode` | Choice | Relative | Time offset mode: when in absolute mode, this is the frame number of the source, when in relative mode, this is an offset relative to the current frame. Relative Absolute
Brush Size / `brushSize` | Double | 25 | This is the diameter of the brush in pixels. Shift + drag on the viewer to modify this value
Brush Spacing / `brushSpacing` | Double | 0.1 | Spacing between stamps of the paint brush
Brush Hardness / `brushHardness` | Double | 0.2 | Fall off of the brush effect from the center to the edge
Brush effect / `brushEffect` | Double | 15 | The strength of the effect
Opacity / `pressureOpacity` | Boolean | On | Alters the opacity of the paint brush proportionate to changes in pen pressure
Size / `pressureSize` | Boolean | Off | Alters the size of the paint brush proportionate to changes in pen pressure
Hardness / `pressureHardness` | Boolean | Off | Alters the hardness of the paint brush proportionate to changes in pen pressure
Build-up / `buildUp` | Boolean | Off | When checked, the paint stroke builds up when painted over itself
Visible portion / `strokeVisiblePortion` | Double | start: 0 end: 1 | Defines the range of the stroke that should be visible: 0 is the start of the stroke and 1 the end.
Translate / `translate` | Double | x: 0 y: 0 |
Rotate / `rotate` | Double | 0 |
Scale / `scale` | Double | x: 1 y: 1 |
Uniform / `uniform` | Boolean | On |
Skew X / `skewx` | Double | 0 |
Skew Y / `skewy` | Double | 0 |
Skew Order / `skewOrder` | Choice | XY | XY YX
Center / `center` | Double | x: 0.5 y: 0.5 |
Reset Center / `resetTransformCenter` | Button |  | Reset the transform center
Interactive / `RotoTransformInteractive` | Boolean | On | When check, modifying the transform will directly render the shape in the viewer. When unchecked, modifications are applied when releasing the mouse button.
Extra Matrix / `extraMatrix` | Double | x: 1 y: 0 z: 0 w: 0 : 1 : 0 : 0 : 0 : 1 | This matrix gets concatenated to the transform resulting from the parameter above.
Reset Transform / `resetTransform` | Button |  | Reset the transform to an identity