This part covers tool usage and configuration.
Common Tool Configuration
Tool configuration is stored at by default in Documents/Paint/Tools folder. Each of the sub-directories contains a tool.xml file that configures the tool and it's resources. Beware the changes in tool.xml are applied only when the tool is drag/dropped to the tool palette. The Paint profile file (.top ) in Documents/Paint/Profiles contains tool.xml content of all tools installed in the palette.
All tool.xml files support the following common tool parameters:
(parameters in italics are advanced)
Tools placed to the tool palette allow changing their configuration by clicking the right mouse button and selecting Properties... item in the popup menu. Changes in configuration are applied immediately when the property dialog is closed.
Id |
Unique identifier of the tool |
In/OutEffectName |
Name of the In/Out effect. |
ChromaKeyEnabled |
Setting value 'true'/'false' ('1'/'0') enables/disables keying of the tool |
KeyframeAnimEnabled |
Setting value 'true'/'false' ('1'/'0') enables/disables tool keyframe animation. |
DefaultDuration |
Default length of the production. Infinite when disabled. Used in case that length of the production is not defined by keyframes. |
Thumbnail |
Thumbnail image displayed on the tool button in GUI. |
ThumbnailSelected |
Thumbnail image displayed on the selected tool button in GUI. If not defined, Thumbnail property is used for selected tool as well. |
ThumbnailColoringEnabled |
Setting value 'true'/'false' ('1'/'0') enables/disables application of Color value to the thumbnail. |
PlaceType |
Tracking of the tool graphics. Values available are: aki.productplacement.place.screen.PlaceModelScreen (default) aki.productplacement.place.screen.PlaceModelScreenMotion |
ClearOnPlay |
Setting value 'false' ('0') disables application of global Clear on Play for this particular tool. |
Value types
- Duration is expressed in fields. For example 50 fields per second.
- Color is a vector of Red, Green, Blue and Alpha. Values are in range from 0.0 to 1.0.
- Opacity is a number from 0.0 (fully transparent) to 1.0 (fully opaque).
Tool Texture Settings
Most tools are rendering graphical elements covered with texture. There are two possible types of texture source that can be used with Paint:
static |
|
| dynamic |
|
For any texture, a standard set of properties is available.
File |
Name of the texture resource file (image or .gtc clip) |
PauseFrame |
Index of the texture frame to pause playback at. Applied when PlayIn_Pause_PlayOut PlayMode is set. Ignored for image-based textures. |
LoopStart |
Index of the .gtc clip frame to wrap to on loop. Used when Loop, PlayIn_Loop play mode is set. Ignored for image-based textures. |
PlayMode |
Decides how the .gtc clip is played on production. One of Loop, PlayIn_Loop, PlayIn_Pause_PlayOut values. See GTC Texture Play Modes for details. |
GTC Texture Play Modes
The PlayMode property gives user precise control over the presentation of the .gtc-based texture while the clip is being played. A detailed description of individual modes follows.
Diagrams are showing timeline overview, with following colors:
| Paint clip range (between in- and out- point) | |
| Drawing production range | |
| .gtc clip frame being displayed |
Loop
Default play mode for most tools. Start of the texture playback is not synchronized with the start of the graphics production. As a result, the texture shows an arbitrary clip frame at the beginning of the production.
PlayIn_Loop
Allows to synchronize the start of the texture playback with the beginning of the production. Useful in combination with the LoopStart property to use .gtc clips having some in-effect rendered in: at the start of the production, the texture starts to play from its beginning, continuing to the loop over its trailing part.
PlayIn_Pause_PlayOut
Starts playback of texture in sync with the start of the production, pausing playback of the gtc clip at the frame specified by PauseFrame property value. As the production continues close to its end, the playback is unpaused and the trailing part of the cursor clip is played out, finishing together with the end of the production.
Column
chyron.paint.tools.column.ColumnTool
Displays a textured 3D column with a textured spot on the ground. Supports keyframed animation. Requires pitch calibration.
Tracking: 3D
Keyframing: yes
Chroma key: column spot only
Counter
aki.paint.tools.counter.CounterTool
Displays a numeric value over background graphics. In the specified time interval, the value runs in given range.
Two modes are supported (see CountMode property):
FROM_TO |
Counter shows values from a CountFrom to a CountTo range, starting at Count Start time and finishing at Count End time. |
SECONDS |
Counter shows the number of seconds from Count Start time to Count End time. |
Counting in pause can be enabled by setting the RelativeCounting property to true. When set to false, the counter shows the same number during pause.
Optionally, an additional label can be displayed, showing a text content retrieved from accompanying labels.csv file. Individual labels in file are newline-separated. To split label text into multiple lines, use a comma character.
Placing the counter shows up a counter settings dialog:
Count From |
Sets a counter starting value (in FROM_TO count mode). |
Count To |
Sets counter final value (in FROM_TO count mode). |
Count Start |
Pressing the button sets current video time as a count start time. |
Count End |
Pressing the button sets current video time as a count end time. |
Label |
If the label is enabled, user can choose between possible label texts found in a labels.csv file. |
Time |
Current video time. |
Reset Shape |
Press button to reset shape of the counter graphics while keeping its position. Helps to get rid of distortion produced by tracking. |
After closing, the dialog can be opened again by RMB over the tool button, selecting the Edit... item in the popup menu. Placing another counter into the video also makes the dialog appear.
Parameters “Count From” and “Count To” could be remotely modified by the following XML-based protocol actions:
<SetToolCounterFrom value=”...”/>
<SetToolCounterTo value=”...”/>
| See section Remote Control for more details. |
Tracking: Screen, Motion
Keyframing: no
Chroma key: no
Configurable parameters
| CountMode | Decides counting range: either the <CountFrom, CountTo> (the FROM_TO CountMode) or a number of seconds since CountStart time (the SECONDS mode) |
| File | Name of the background graphics resource file (image/clip). |
| Size | Float value defining size of the background graphics. Value of 1.0 means that the background pixels have the same height as the background video pixels. |
| BackgroundPreroll | Specifies difference between background and counter text production beginning, in video fields. |
| ProductionEndDelay |
When enabled specifies how long the counter is in production (including out effect) after reaching the Count End time, in video fields. Production is infinite when disabled. |
| LabelEnabled | If true, additional label text is displayed, according to the Label... properties settings. If false, only the counter text is shown. |
| LabelTextValue | Label text content. |
| Label<FontParameter> | These parameters define the font style of the label text. See font parameters below. |
| TextFormat | Formatting rules for counter text. The place holder for the value is "%f". To specify, for example, 3 decimal places use "%.3f". You can add any text before/after the number. To specify, for example, units use "%.1f sec". |
AnchorPoint |
Reference point of the counter graphics. Values are in the <0,1> range. [0.5,0.5] by default. |
| <FontParameter> | These parameters define the font style of the counter text. See font parameters below. |
Font parameters
| TextPosition | Text position relative to the whole composition. Value is vector [x, y] in pixels of the background graphics. Value [0,0] is left/top corner. |
| TextSize | Height of one text line in pixels of the background graphics. |
| FontHAlign | Horizontal alignment { LEFT | CENTER | RIGHT | DOT_FIRST | DOT_LAST } |
| FontHAlignChar | Horizontal alignment character |
| FontVAlign | Vertical alignment { TOP | CENTER | BOTTOM | FIRST | LAST } |
| FontLineSpacing | Relative line spacing. Value 1.0 means spacing by the height of the font. |
| FontLineFlowPolicy |
Behavior for lines wider then defined limit. { DONT_CARE | SCALE | UNIFORM_SCALE | SOFT_NEWLINE | HARD_NEWLINE | SOFT_SKIP | HARD_SKIP | SINGLE_LINE } |
| FontLineWidth | Line width limit. (see FontLineFlowPolicy) |
| FontFixedPitch | Fixed character pitch. (disables kerning defined by font). |
| FontKerning | Additional kerning. |
| FontCapitalsRatio | If enabled (value > 0) then all characters are made capitals. The original non capital letters are rendered smaller. This value defines factor for that scale. |
| FontName | Name of the font. All system fonts are available. |
| FontResolution | Font texture resolution in pixels. It should approximately match the pixel size on the screen. |
| FontBaseColorMode | Coloring text mode. { SOLID | CHAR_4POINTS | LINE_4POINTS | GLOBAL_4POINTS | LINE_2GRADIENTS } |
| FontBaseColor | Color to be used when mode is SOLID |
| FontBaseColorP1 | Color for gradient coloring |
| FontBaseColorP2 | Color for gradient coloring |
| FontBaseColorP3 | Color for gradient coloring |
| FontBaseColorP4 | Color for gradient coloring |
| FontOutlineSize | Size of outline in pixels. Set to zero to disable outline. |
| FontOutlineColor | Outline color. |
| FontShadowOffset | Relative offset of shadow to normal text. |
| FontShadowBlur | Amount of blur of the shadow. |
| FontShadowColor | Shadow color. |
Cursor
aki.paint.tools.cursor.CursorTool
Image or .gtc clip that is put into image by clicking a mouse. Can be dragged with a mouse after it is placed. Supports keyframe animation.
File |
Name of the cursor resource file (image/clip). |
Perspective |
Amount of artificial perspective distortion applied to the cursor graphics. Value between 0.0 (no perspective) and 1.0 (flat) |
Size |
Float value defining size of the cursor. Value of 1.0 means that the cursor pixels have the same height as the background video pixels. |
ColorMatrix |
Advanced cursor coloring. Changed from GUI. |
Opacity |
Opacity multiplication constant. |
PivotFrame |
Index of the gtc clip frame used to create thumbnail. Ignored if the cursor is image-based. Ignored if Thumbnail property defines thumbnail image file. |
SizeReference |
Reference frame for the Size value. PREVIEW – if Size value equals to 1.0, cursor resource pixels match y-pixels of the preview. VIDEO – if Size value equals to 1.0, cursor resource pixels match y-pixels of the video. |
SizeTracking |
Controls how graphics size is affected by background video zoom changes. KEEP_CONSTANT - size stays constant when background zooms in/out FOLLOW_ZOOM - size follows background zoom change |
AnchorPoint |
Reference point of the cursor graphics. Values are in the <0,1> range. [0.5,0.5] by default. |
AutoPause |
If enabled, pause of AutoPauseDuration length is created. |
AutoPauseDuration |
Duration of automatically generated pause. |
| 3DScale | By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: yes
Example
<Tool type="aki.paint.tools.cursor.CursorTool"> <Id value="CursorCircle"/> <File value="circle.png"/> <Size value="0.5"/> <Perspective value="0"/> <KeyframeAnimEnabled value="1" /> </Tool>
Redefining GTC cursor color with ColorMatrix property
Paint allows you to customize the color of .gtc clip-cursor. We provide animcursor1.gtc. You can redefine the colors in that cursor.
Use the popup menu on a tool button to open the Properties editor. Change color mode of the ColorMatrix property to Three Colors mode. Colors are then replaced by following rules:
- The first color replaces Red
- The second color replaces Green
- The third color replaces Blue
- The final color is computed as a mix of all three replacing colors modulated by the original RGB values in the cip.
If the provided cursor has 2 colors only, select 2 colors of your choice and the original colors in the cursor will be replaced.
Cursor With Trail
aki.paint.tools.advancedcursor.CursorWithTrailTool
Image or .gtc clip that is put into image by clicking a mouse. Can be dragged with a mouse after it is placed. Supports keyframe animation. While the keyframe is animated, it leaves a trail stroke.
Trail stroke can have applied fade off gradient (see TrailAlphaGrad... properties).
Used preferably with a PlaceModelScreenMotion place.
To not show trailing stroke through the cursor, usage of masked .gtc clip for cursor is recommended. See Masked .gtc clip chapter for details.
Size |
Float value defining size of the cursor. Value of 1.0 means that the cursor pixels have the same height as the background video pixels. |
SizeTracking |
Controls how cursor size is affected by background zooming. KEEP_CONSTANT – Cursor size stays constant when background zooms in/out. Default. FOLLOW_ZOOM - Cursor size follows background zoom changes. |
Perspective |
Amount of artificial perspective distortion applied to the cursor graphics. Value between 0.0 (no perspective) and 1.0 (flat) |
StrokeColor |
Coloring of the trail stroke. |
ColorMatrix |
Advanced cursor coloring. Changed from GUI. |
Opacity |
Opacity multiplication constant. Applied on the cursor itself only. |
TrailAlphaGradStart |
Distance from the head of the trail where the alpha gradient effect starts. |
TrailAlphaGradEnd |
Distance from the head of the trail where the alpha gradient effect ends. |
TrailAlphaGradPower |
Exponent to control alpha gradient shape. Value 1..N. For example value 1.0 makes the gradient linear. |
TrailAlphaGradEnabled |
Enables or disables trail alpha gradient effect. |
TrailType |
Type of trail. Possible values are: FROM_START – Trail drawn from start of the path to cursor. Default. TO_END – Trail drawn from cursor to end of the path. START_TO_END – Trail drawn from start to end of the path. Cursor moves along the trail. |
File |
Name of the cursor resource file (image/clip). |
StrokeThickness |
Relative trail stroke thickness. Related to a single pixel of 576i video. |
StrokeStretch |
Range that is stretched along the trail stroke, in relative coordinates (0.0-1.0). Texture areas outside the range are not stretched. |
StrokeTextureFile |
Image/clip file used as a trail stroke texture. Empty value results in solid color stroke. |
StrokeTexturePauseFrame |
Index of the texture frame to pause playback at. Applied when PlayIn_Pause_PlayOut PlayMode is set. Ignored for image-based textures. |
StrokeTexturePlayMode |
Decides how the .gtc clip is played on production. One of Loop, PlayIn_Loop, PlayIn_Pause_PlayOut values. See GTC Texture Play Modes for details. |
StrokeTextureSpeed |
Speed of possible texture movement along the stroke. |
| 3DScale | By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
Tracking: ScreenMotion, 3D
Keyframing: yes
Chroma key: yes
Example
<Tool type="aki.paint.tools.advancedcursor.CursorWithTrailTool"> <Id value="CursorWithTrail"/> <File value="playerMasked.gtc"/> <Size value="1.2"/> <Thumbnail value="tCursorWithTrail.png" /> <ThumbnailColoringEnabled value="true" /> <ChromaKeyEnabled value="1" /> <KeyframeAnimEnabled value="1"/> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion"/> <StrokeColor value="[0.0, 1.0, 0.0, 1.0]"/> <StrokeThickness value="2"/> <StrokeTexture value="line_dash.png"/> </Tool>
CutOut
aki.paint.cutout.tools.cutout.CutOutTool
CutOut tool allows to highlight, move or resize players.
Object detection
After selecting the tool, Paint starts to automatically detect suitable objects in video. Detected objects are presented to user by displaying their bounding boxes. Because the automatic detection is based on chroma keyer data, it is necessary to have chroma keyer set properly to get suitable detection results.
Mask editor
Results of automatic detection can be further enhanced using mask editor. To start the mask editor, click a scissors button in a preview, then click an object you want to edit. Preview window zooms to the selected object and a mask editor toolbar shows up.
Mask editor supports multiple different tools:
|
Brush tool. Fine-tuning of object shape.
By default, stroke removes object area. Holding Ctrl key inverts the effect, so the stroke adds an object area. Size of the brush is controlled by a mouse wheel. |
|
|
Knife tool. Quick removal of large object parts using cutting line.
Clicking into the image creates a cutting line that should split object into two or more separate areas. When finished, hold the Shift key and click the object area(s) to remove from the object. |
|
|
Lasso tool. Quick removal of closed object areas.
Clicking into the image creates a closed polygon that splits object into two separate areas. When finished, click the polygon inner area to remove all parts of the object that are not inside the polygon. Click outside the polygon to remove the inner part. |
|
|
Revert back tool.
Reverts the object to the state when the editor was opened. |
|
| When finished, leave the mask editor with this button. |
Effects
The tool is applied by clicking one of the players. CutOut effects are applied immediately after the player has been selected.
CutOut tool supports three effects that can be combined arbitrarily.
| Glow | Adds a color glow effect around the player. | |
| Move |
Moves the player to a different position by dragging him with a mouse. The original location is patched with surrounding background texture. Optionally, a 'ghost' player can be rendered there. It is possible to show an arrow connector between the original and moved position. |
|
| Scale | Scales player using mouse wheel while holding Ctrl key. |
Preparing for production
It is recommended to use the CutOut tool in Playback Speed tool pause, otherwise it will be only applied to the current frame. When created, CutOut effects are applied from the time of the creation for a time period defined by the DefaultProductionLength property. To control duration of CutOut effects production, use the Production Start/End button.
All types of In/Out Effects are supported, though mixing DRAW with multiple keyframe move effect is not recommended.
Keyframed move effect
Since Paint 9.4 it is possible to create a keyframed animation of move effect, meaning the player will smoothly pass through any path defined by these keyframes.
- Jog to the timecode when the player should start moving (in a pause).
- Click on the desired player.
- Jog forward to another time.
- Drag the player to another place.
To define more keyframes, simply repeat steps 3 and 4. If a keyframe is defined outside current CutOut production, it is automatically extended. The move effect will always start in the original player position so it's not possible to drag the player in the timecode of creation.
Tool properties reference
| DefaultProductionLength | Initial length of production after the tool is created. |
| ShowBoundingBoxes | Show bounding boxes of the Cutout drawings even when Operator mode is off. |
| Glow/Blur | Amount of blur applied to the glow effect. Influences glow size. |
| Glow/Color | Glow effect color. |
| Glow/Intensity | Intensity of glow effect. |
| Move/Connector | Connector stroke style. Fetches styles of freehand tools present in a toolbar. Set to -none- to not use connector stroke. |
| Move/ConnectorColor | Color of the connector stroke. |
| Move/GhostOpacity | Opacity of the player ghost rendered at the original player position. 0 by default. |
| Move/PlayerOpacity | Opacity of the moved player. 1 by default. |
| Scale/ScaleCentre | Pivot point of the scale effect, in relative mask coordinates. E.g.: [0,0] uses mask bottom-left corner as a scale pivot. [0.5,0.5] uses mask center as a scale pivot. |
Sequential Cursor
aki.paint.tools.cursor.SequentialCursorTool
The tool has predefined sequence of images/gtc clips. Once you place sequential cursor into the screen, it automatically changes its resource file. Next placed cursor is different.
This is useful e.g. to place sequence of cursors with numbers. The number is automatically increased.
The sequence is reset on Clear or after reaching the maximum index within the sequence.
FilePattern |
Pattern of the cursor resource files (image/clip). Example: numbered_cursor_red_%s.png The '%s' substring will be replaced by numbers from the range defined in 'SequenceBegin' and 'SequenceEnd' elements. |
SequenceBegin |
Begin index of the sequence of files |
SequenceEnd |
End index of the sequence of files |
Perspective |
Amount of artificial perspective distortion applied to the cursor graphics. Value between 0.0 (no perspective) and 1.0 (flat) |
Size |
Float value defining size of the cursor. Value of 1.0 means that the cursor pixels have the same height as the background video pixels. |
ColorMatrix |
Advanced cursor coloring. Changed from GUI. |
Opacity |
Opacity multiplication constant. |
PivotFrame |
Index of the gtc clip frame used to create thumbnail. Ignored if the cursor is image-based. Ignored if Thumbnail property defines thumbnail image file. |
SizeReference |
Reference frame for the Size value. PREVIEW – if Size value equals to 1.0, cursor resource pixels match y-pixels of the preview. VIDEO – if Size value equals to 1.0, cursor resource pixels match y-pixels of the video. |
| 3DScale | By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: yes
Example
<Tool type="aki.paint.tools.cursor.SequentialCursorTool"> <Id value="SequentialCursor"/> <FilePattern value="numbered_cursor_red_%s.png"/> <Size value="1.2"/> <ChromaKeyEnabled value="1" /> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion"/> <StrokeFile value="lineDashed.fhs" /> <KeyframeAnimEnabled value="1"/> <SequenceBegin value="1"/> <SequenceEnd value="9"/> </Tool>
Number tool
aki.paint.tools.numbertool.NumberTool
Similar to sequential cursor, a number value is rendered as pure text.
Value is incremented every time, when a drawing is placed on the screen.
The value is set to first number value on Clear or after reaching the last number value.
FirstNumberValue |
First value of sequence. Set to 1 when disabled. |
LastNumberValue |
Last value of sequence. When disabled actual value is never reset to first value. |
Size |
Float value defining size of the cursor. Value of 1.0 means that the cursor pixels have the same height as the background video pixels. |
ColorMatrix |
Advanced cursor coloring. Changed from GUI. |
| 3DScale | By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
Font parameters
| TextPosition | Offset of the text layer line relative to reference point, in background graphics pixels. |
| TextPositionReference | Reference point for the text position offset. Can be TOP_LEFT(default) or TOP_RIGHT of the background graphics. |
| TextSize | Height of one text line in pixels of the background graphics. |
| FontHAlign | Horizontal alignment { LEFT | CENTER | RIGHT | DOT_FIRST | DOT_LAST } |
| FontHAlignChar | Horizontal alignment character |
| FontVAlign | Vertical alignment { TOP | CENTER | BOTTOM | FIRST | LAST } |
| FontFixedPitch | Fixed character pitch. (disables kerning defined by font). |
| FontKerning | Additional kerning. |
| FontCapitalsRatio | If enabled (value > 0) then all characters are made capitals. The original non capital letters are rendered smaller. This value defines factor for that scale. |
| FontName | Name of the font. All system fonts are available. |
| FontResolution | Font texture resolution in pixels. It should approximately match the pixel size on the screen. |
| FontBaseColorMode | Coloring text mode. { SOLID | CHAR_4POINTS | LINE_4POINTS | GLOBAL_4POINTS | LINE_2GRADIENTS } |
| FontBaseColor | Color to be used when mode is SOLID |
| FontBaseColorP1 | Color for gradient coloring |
| FontBaseColorP2 | Color for gradient coloring |
| FontBaseColorP3 | Color for gradient coloring |
| FontBaseColorP4 | Color for gradient coloring |
| FontOutlineSize | Size of outline in pixels. Set to zero to disable outline. |
| FontOutlineColor | Outline color. |
| FontShadowOffset | Relative offset of shadow to normal text. |
| FontShadowBlur | Amount of blur of the shadow. |
| FontShadowColor | Shadow color. |
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: no
Example
<Tool type="aki.paint.tools.numbertool.NumberTool"> <Thumbnail value="tNumberTool.png"/> <File value="background.png"/> <KeyframeAnimEnabled value="true"/> <Size value="0.5"/> <FontHAlign value="CENTER"/> <FontVAlign value="CENTER"/> <FontResolution value="50"/> <TextSize value="100"/> <ThumbnailColoringEnabled value="false"/> </Tool>
Linked Cursors
aki.paint.tools.advancedcursor.LinkedCursorsTool
Group of cursors connected by stroke link. Defined by subsequent clicking into the video. Cursors can be dragged to create keyframe animation.
To not show link stroke through the cursors, usage of masked .gtc clip for cursors is recommended. See Masked .gtc clip chapter for details.
Linked cursors
| Closed | True – cursors are linked all around. False – cursors are linked from the first to the last. |
| FillEnabled | Enables fill. |
| FillTextureFile | Name of the fill texture resource file (image/clip). |
| FillColor | Coloring of the fill. Used only when Closed is True. |
Size |
Float value defining size of the cursor. Value of 1.0 means that the cursor pixels have the same height as the background video pixels. |
ColorMatrix |
Advanced coloring of cursor. Changed from GUI. |
Opacity |
Opacity multiplication constant. Applied on the cursors only. |
Perspective |
Amount of artificial perspective distortion applied to the cursor graphics. Value between 0.0 (no perspective) and 1.0 (flat) |
StrokeThickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
StrokeSmooth |
If true, the stroke data are being smoothed to remove possible input jittering. |
StrokeSmoothRadius |
Affects smoothing effect strength. Value 4 leads to acceptable results. |
StrokeLineJoin |
Joining of stroke segments. One of: [ ROUND | MITER | BEVEL ] |
StrokeLineCap |
Stroke line endpoint shape. One of: [ ROUND | FLAT ]. ROUND by default. |
StrokeAlphaGradient |
Applies alpha gradient along the stroke length. 4-number vector, in a |
StrokeStretch |
Range that is stretched along the stroke, in relative coordinates (0.0-1.0). Texture areas outside the range are not stretched. |
StrokeTexture |
Image file used as a connection stroke texture. Empty value results in solid color stroke. |
StrokeTextureSpeed |
Speed of possible texture movement along the stroke. |
StrokeColor |
Coloring of the polygon stroke. |
| 3DScale | By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
It is possible to display a text showing a distance between cursor points. Distance text appearance is controlled from the Distance property tab. An important property is a TrackingType that decides how the distance text is presented:
| NONE | On-screen distance text. Overall length of the arrow is shown. TextPosition defines the absolute position of the text, in normalized screen coordinates. |
| SHAPE_ALIGNED | Distance text in pitch plane. Shown for each arrow segment. TextPosition defines metric offset of text from the center point of linked cursors segment. |
| CAMERA_FACING | 3D distance text standing on pitch. Shown for each arrow segment. TextPosition defines metric offset of text from the center point of linked cursors segment. |
Distance text supports background texture. Background texture is controlled from the Distance Texture properties tab.
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: yes
Example:
<Tool type="aki.paint.tools.advancedcursor.LinkedCursorsTool"> <Id value="LinkedCursors"/> <File value="playerMasked.gtc"/> <Size value="1.2"/> <FillEnabled value="true"/> <FillColor value="[1.0,0.0,0.0,1.0]"/> <Thumbnail value="tLinkedCursors.png"/> <ThumbnailColoringEnabled value="true"/> <ChromaKeyEnabled value="1"/> <KeyframeAnimEnabled value="1"/> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreen"/> <StrokeThickness value="3"/> <StrokeColor value="[0.0, 1.0, 0.0, 1.0]"/> </Tool>
Freehand
aki.paint.tools.freehand.FreehandTool
Allows to paint strokes by dragging the mouse over the image.
Thickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
Smooth |
Enables stroke smoothing |
SmoothRadius |
Radius of stroke smoothing algorithm |
LineJoin |
Joining of stroke segments. One of: [ ROUND | MITER | BEVEL ] |
LineCap |
Line endpoint shape. One of: [ ROUND | FLAT ]. ROUND by default. |
AlphaGradient |
Applies alpha gradient along the stroke length. 4-number vector, in a |
Stretch |
Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
Texture |
Image/clip file used as a stroke texture. Empty value results in solid color stroke. |
TextureSpeed |
Speed of possible texture movement along the stroke. |
Tracking: Screen, ScreenMotion
Keyframing: no
Chroma key: yes
<Tool type="aki.paint.tools.freehand.FreehandTool"> <Id value="Freehand" /> <Color value="[1.0, 1.0, 1.0, 1.0]" /> <Thumbnail value="tFreehand.png" /> <ThumbnailColoringEnabled value="true" /> <ChromaKeyEnabled value="false"/> <Thickness value="10"/> <Smooth value="true"/> <LineJoin value="MITER"/> <Texture value="arrow.png"/> <TextureSpeed value="1"/> </Tool>
Line
aki.paint.tools.freehand.LineTool
Allows to paint straight line strokes by dragging mouse over the image from the line's start point to its end point.
Thickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
LineCap |
Line endpoint shape. One of: [ ROUND | FLAT ]. ROUND by default. |
AlphaGradient |
Applies alpha gradient along the stroke length. 4-number vector, in a |
Stretch |
Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
Texture |
Image/clip file used as a stroke texture. Empty value results in solid color stroke. |
TextureSpeed |
Speed of possible texture movement along the stroke. |
Tracking: Screen, ScreenMotion
Keyframing: no
Chroma key: yes
<Tool type="aki.paint.tools.freehand.LineTool"> <Id value="StraightArrow" /> <Color value="[1.0, 1.0, 1.0, 1.0]" /> <Thumbnail value="tStraightArrow.png" /> <ThumbnailColoringEnabled value="true" /> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion" /> <Thickness value="10"/> <Stretch value="[0.05, 0.08]"/> <Texture value="StraightArrow.png"/> <LineCap value="FLAT"/> </Tool>
Animated Line
aki.paint.tools.animatedline.AnimatedLineTool
Allows to paint straight line stroke by creating begin and end point. Points can be keyframe animated.
Color |
Fill color. Only if the texture file is empty. |
Thickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
LineCap |
Line endpoint shape. One of: [ ROUND | FLAT ]. ROUND by default. |
AlphaGradient |
Applies alpha gradient along the stroke length. 4-number vector, in a |
Stretch |
Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
Texture |
Image/clip file used as a stroke texture. Empty value results in solid color stroke. |
TextureSpeed |
Speed of possible texture movement along the stroke. |
Tracking: Screen, ScreenMotion
Keyframing: yes
Chroma key: yes
<Tool type="aki.paint.tools.animatedline.AnimatedLineTool"> <Thumbnail value="tAnimatedLine.png"/> <ThumbnailColoringEnabled value="true"/> </Tool>
Polygon
aki.paint.tools.freehand.PolygonTool
Allows to define closed polygon by subsequently clicking points into the image. Polygon creation is finished by either clicking back to the starting point or by switching to different tool.
Thickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
LineJoin |
Joining of stroke segments. One of: [ ROUND | MITER | BEVEL ] |
AlphaGradient |
Applies alpha gradient along the stroke length. 4-number vector, in a |
Stretch |
Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
Texture |
Image/clip file used as an outline stroke texture. Empty value results in solid color stroke. |
TextureSpeed |
Speed of possible texture movement along the stroke. |
TextureLoopStart |
Frame that the texture animation wraps to. Applied only if a gtc clip is applied as a stroke texture. |
ShowFill |
True – the internal area of the polygon is filled with texture/color. False – internal area of the polygon is empty. |
FillTexture |
Texture applied to the polygon internal area. |
FillColor |
Coloring of the polygon internal area. If FillTexture is defined, the FillColor colorizes texture. |
Tracking: Screen, ScreenMotion
Keyframing: no
Chroma key: yes
<Tool type="aki.paint.tools.freehand.PolygonTool"> <Id value="Polygon"/> <Color value="[1.0, 1.0, 1.0, 1.0]"/> <Thumbnail value="tPolygon.png"/> <ThumbnailColoringEnabled value="true"/> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion"/> <ChromaKeyEnabled value="1"/> <FillTexture value="white.png"/> <FillColor value="[0.0,0.0,0.5,0.5]"/> <Thickness value="5"/> <LineCap value="FLAT"/> </Tool>
Trail
aki.paint.tools.trailtool.TrailTool
Keyframe animated trail stroke.
Trail stroke can have applied fade off gradient (see TrailAlphaGrad... properties).
Used preferably with a PlaceModelScreenMotion place.
TrailAlphaGradEnabled |
Enables or disables trail alpha gradient effect. |
TrailAlphaGradLength |
Length of the alpha gradient effect, in screen normalized coordinates along stroke. |
TrailAlphaGradPower |
Exponent to control alpha gradient shape. Value 1..N. For example value 1.0 makes the gradient linear. |
TrailAlphaGradStart |
Distance from the head of the trail where the alpha gradient effect starts. |
LineCap |
Line endpoint shape. One of: [ ROUND | FLAT ]. ROUND by default. |
LineJoin |
Joining of stroke segments. One of: [ ROUND | MITER | BEVEL ] |
Smooth |
Enables stroke smoothing |
SmoothRadius |
Radius of stroke smoothing algorithm |
Stretch |
Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
Texture |
Image/clip file used as a stroke texture. |
TextureSpeed |
Speed of possible texture movement along the stroke. |
Thickness |
Relative stroke thickness. Related to a single pixel of 576i video. |
Type |
Type of trail. Possible values are: FROM_START – Trail drawn from start of the path to cursor. Default. TO_END – Trail drawn from cursor to end of the path. START_TO_END – Trail drawn from start to end of the path. Cursor moves along the trail. |
Tracking: Screen, ScreenMotion
Keyframing: yes
Chroma key: yes
<Tool type="aki.paint.tools.trailtool.TrailTool"> <ResourcePath value="Trail"/> <Thumbnail value="tTrail.png"/> <Color value="[1.0, 1.0, 1.0, 1.0]"/> <Texture value="trail.png"/> <Stretch value="[0.1,0.5]"/> </Tool>
Zone Polygon
aki.paint.tools.advancedcursor.DecoratedPolygonTool
Filled polygon area which points are defined by clicking into the image. Displays image/clip decorations at the polygon vertices.
| FillTexture | Name of the polygon fill texture resource file (image/clip) |
| FillColor | Coloring of the polygon fill. |
File |
Name of the vertex decoration resource file (image/clip). |
Size |
Float value defining size of the vertex decoration. Value of 1.0 means that the decoration pixels have the same height as the background video pixels. |
StrokeThickness |
Relative polygon stroke thickness. Related to a single pixel of 576i video. |
StrokeStretch |
Range that is stretched along the stroke, in relative coordinates (0.0-1.0). Texture areas outside the range are not stretched. |
StrokeTexture |
Image file used as an outline stroke texture. Empty value results in solid color stroke. |
StrokeTextureSpeed |
Speed of possible texture movement along the stroke. |
StrokeColor |
Coloring of the polygon stroke. |
3DScale |
By enabling the value, the graphics is placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: yes
Example:
<Tool type="aki.paint.tools.advancedcursor.DecoratedPolygonTool"> <Id value="DecoratedPolygon"/> <File value="spark.png"/> <Size value="0.3"/> <Thumbnail value="tDecoratedPolygon.png"/> <ThumbnailColoringEnabled value="true"/> <ChromaKeyEnabled value="1"/> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion"/> <StrokeThickness value="2"/> <StrokeTexture value="stroke.png"/> <StrokeStretch value="[0, 1]"/> <StrokeColor value="[1.0, 1.0, 1.0, 1.0]"/> <FillTexture value="white.png"/> <FillColor value="[0.0,0.0,0.5,0.5]"/> <Closed value="true"/> </Tool>
Thumbnail coloring
Thumbnail coloring is controlled by ThumbnailColoringEnabled property. When is enabled, thumbnail pixels are colored with tool colors according to following table:
| RED | FillColor |
| GREEN | StrokeColor |
| BLUE | Not used. Always white. |
Label
aki.paint.tools.label.LabelTool
Label tool combines an on-screen image/clip displaying some information with a keyframe-animated pointer line.
The tool allows to choose from multiple label contents: any image/.gtc clip found in a LabelContentPath folder is considered to be a label content option. Currently selected option file name is displayed over the tool thumbnail.
The tool supports optional text layer containing one or more texts.
LabelFile |
Name of the label resource file (image/clip) |
ConnectorAnchor |
Connector start point related to a label position. Anchor is scaled by Size property. |
Size |
Float value defining size of the label. Value of 1.0 means that the label pixels have the same height as the background video pixels. |
ConnectorThickness |
Relative connector thickness. Related to a single pixel of 576i video. |
ConnectorTexture |
Image/clip file used as a connector texture. |
ConnectorStretch |
Range that is stretched along the connector, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
ThumbnailTextYPos |
Y-position of the thumbnail text position, in pixels |
ThumbnailTextSize |
Size of the thumbnail text |
ThumbnailText |
Text rendered into the thumbnail |
ThumbnailTextColor |
Color of the thumbnail text in rgba floats notation. Black by default. |
LabelContentPath |
Path to a label content resources |
Tracking: Screen,
Keyframing: yes
Chroma key: no
Example
<Tool type="aki.paint.tools.label.LabelTool"> <Thumbnail value="tLabel.png"/> <LabelFile value="../DriverAssets/driver1.png"/> <ConnectorThickness value="5" /> <ConnectorTexture value="connector.gtc" /> <ConnectorTextureLoopStart value="49" /> <ConnectorStretch value="[0, 0.99]" /> <LabelLoopStart value="350"/> <ThumbnailTextYPos value="30"/> <ThumbnailTextSize value="15"/> <ThumbnailText value="Label"/> <ThumbnailTextColor value="[0,0.5,0,1]"/> <LabelContentPath value="../DriverAssets"/> </Tool>
Light Shaft
aki.paint.tools.offside.LightShaftTool
Light shaft tool allows to highlight a player by spotlight. Tool is composed from a spot at the bottom and a shaft coming from the top.
Perspective |
Amount of artificial perspective distortion applied to the spot graphics. Value between 0.0 (no perspective) and 1.0 (flat) |
Color |
Color of the spot and the shaft. |
File |
Spot file. Image or a .gtc clip. |
ShaftFile |
Shaft file. Image or a .gtc clip. |
ShaftType |
|
ShaftOriginX |
Horizontal shaft origin position. |
ShaftOriginY |
Vertical shaft origin position. |
Size |
Size of spot. |
TopShaftSize |
Top shaft size ratio to the spot size. |
BottomShaftSize |
Bottom shaft size ratio to the spot size. |
BottomShaftOffset |
Offset of the spot from the bottom of the shaft. Relative to the spot size. |
Tracking: no
Keyframing: yes
Chroma key: yes
Example
<Tool type="aki.paint.tools.lightshaft.LightShaftTool"> <File value="Spot.png"/> <ShaftFile value="Shaft.gtc"/> <Size value="0.6"/> <Perspective value="0.17230769"/> <Color value="[1.0,0.9,0.793,1.0]"/> <ShaftType value="FIXED"/> <ShaftOriginX value="0.44"/> <ShaftOriginY value="1.5"/> <TopShaftSize value="0.2"/> <BottomShaftSize value="0.85"/> </Tool>
Eye View
aki.paint.tools.eyeview.EyeViewTool
Eye view tool allows to highlight the view range from the player's point of view.
File |
Name of the texture resource file (image/clip). |
Color |
Color of the texture. |
LoopStart |
Applied on gtc texture. Specifies frame from which the playback loops. 0 by default. |
PauseFrame |
Applied on gtc texture. Specifies frame on which the playback is paused. -1 by default (no pause). |
Tracking: no
Keyframing: yes
Chroma key: yes
Example
<Tool type="aki.paint.tools.eyeview.EyeViewTool"> <File value="EyeView.png"/> <Thumbnail value="tEyeView.png"/> <ThumbnailColoringEnabled value="false"/> </Tool>
Offside
aki.paint.tools.offside.OffsideTool
Offside tool allows to show virtual offside at specified time.
After setting up line, and saving to the clip, clip playback automatically stops at the offside time and the line shows up. Starting the playback again starts out effect.
Single offside line can be drawn at one time.
Texture |
Offside zone texture. Either an image or a .gtc clip. |
TexturePivotFrame |
Pivot frame of the offside zone texture clip. Ignored if an image is used as a texture. |
OffsideZoneWidth |
Pixel width of the offside zone at the bottom of the screen. |
TextureCoordinateSpace |
Pixel dimensions of the offside zone texture. |
TextureOffsideLinePos |
Pixel position of the offside line in offside zone texture. |
Tracking: always
Keyframing: no
Keyframing: always
Example
<Tool type="aki.paint.tools.offside.OffsideTool"> <Id value="Offside"/> <Texture value="offside_line.png"/> <Thumbnail value="tOffside.png"/> <OffsideZoneWidth value="500"/> <TextureCoordinateSpace value="[512,8]"/> <TextureOffsideLinePos value="7"/> </Tool>
Pause
aki.paint.tools.pause.PauseTool
Pause tool allows to define point in a clip where the playback automatically stops.
When selected, a pause button and a timeline shows up in preview. Pressing the button puts/removes pause at that time. The pause is indicated by showing a pause mark at the timeline. Pause button turns red at pause.
Pressing the Clear button while the Pause tool is activated removes all pauses from the timeline.
Pauses are saved to the current clip by pressing the Save button.
Pitch Focus
aki.paint.tools.pitchfocus.PitchFocusTool
The tool applies discolor and blur effects to an area surrounding pitch bounds. Requires pitch calibration.
Properties of the effect applied to pitch surroundings can be controlled in global Settings dialogue, on the Discolor page.
Configurable parameters
| SoftEdge | Softening of the effect boundaries |
Pitch Zone
aki.paint.tools.pitchzone.PitchZoneTool
The tool highlights single or multiple zones on the pitch with desired background texture and border. Zone is a rectangular strip spanning across the shorter dimension of the pitch with configurable length.
Zones can be defined in the Zones section of the tool Property Editor in a simple click and drag manner.
Tracking: 3D
Keyframing: no
Chroma key: yes
Often used zone configurations can be also saved as presets and shared between individual Pitch Zone tools.
Presets are stored in an external file:
Documents/Paint9/PitchZones/zonePresets.xml
Configurable parameters
| Thickness | Relative border thickness. |
| AlphaGradient | Applies alpha gradient along the stroke length. 4-number vector, in a [t0, t1, a0, a1] form, where t0, t1 are relative coordinates from <0,1> range and a0, a1 are alpha values in t0 and t1, respectively. |
| Stretch | Range that is stretched along the stroke, in relative coordinates <0,1>. Texture areas outside the range are not stretched. |
| Texture | Image/clip file used as an outline stroke texture. Empty value results in solid color stroke. |
| TextureSpeed | Speed of texture movement along the borders. |
| TextureLoopStart | Frame that the texture animation wraps to. Applied only if a gtc clip is applied as a border texture. |
| ShowFill |
True – the internal area of the zone is filled with texture/color. False – the internal area of the zone is empty. |
| FillTexture | Texture applied to the zone internal area. |
| FillColor | Coloring of the zone internal area. If FillTexture is defined, the FillColor colorizes texture. |
Trajectory
aki.paint.tools.trajectory.TrajectoryTool
Usage
The tool is designed to work in a clip, not live.
Jog to the start of the object trajectory and select the tool. Select the flying object and jog forward about half a second (do not make steps more then one second apart). Repeat until the end of the trajectory. You should have about 10 key frames on the trajectory.
When the ball is lost during the tracking then mark it immediately when it returns back. The tool tries to approximate the missing path.
During the manual object tracking process, the opacity and thickness gradient is disabled. This is done deliberately to help you see the current shape of the trajectory.
After you finished making the trajectory save your work to the clip!
When you select the clip again, you should see the visualized trajectory (including opacity and thickness gradient).
This tool requires reliable camera motion tracking. The tracking will likely fail if the object is tracked against a solid color area, like a clean blue sky.
When the object is blurred due to motion blur, try to always select the same spot on the blurred blob. It is better to select the head of the trajectory. Not the average of the blob.
Configurable parameters
| Thickness | Stroke thickness in pixels in PAL video format. |
| Texture | Image file that is repeated along the trajectory. Empty value results in solid color stroke. |
| OpacityStartLength | Length (in time units) of opacity gradient at the start of the line. The gradient is always from 0 to 1. |
| OpacityEndValue | Opacity value at the end of the curve. |
| OpacityEndPower | Exponent to control gradient shape. Value 1..N. For example value 1.0 makes the gradient linear. See below. |
| ThicknessEndFactor | Thickness factor (to be multiplied with Thickness) at the end of the line. |
| ThicknessEndPower | Exponent to control gradient shape. Value 1..N. For example value 1.0 makes the gradient linear. |
| TextureStretch | Controls texture stretching along the curve. Value 1.0 means that the whole texture is repeated along the curve over the duration of one field. |
| Flip | Set to 1 to flip the opacity/thickness gradient. This could help to visualize the situation when the object flies towards the camera. |
Power property
The power properties controls the shape of the gradient. See the following graph. The X axis is the position along the curve from the beginning to the end. The Y axis is the value that is used to module the parameter (either opacity or thickness). At the beginning of the trajectory, the parameter has full value that decreases up to the specified end value. The way the value decreases is determined by the power property.
Example
<Tool type="aki.paint.tools.trajectory.TrajectoryTool"> <Id value="Trajectory"/> <Thumbnail value="tTrajectory.png"/> <ChromaKeyEnabled value="0"/> <Thickness value="2.5"/> <Texture value="line_dash.png"/> <PlaceType value="aki.productplacement.place.screen.PlaceModelScreenMotion"/> <OpacityStartLength value="3"/> <OpacityEndValue value="0"/> <OpacityEndPower value="2"/> <ThicknessEndFactor value="0.5"/> <ThicknessEndPower value="1"/> <TextureStretch value="0.1"/> </Tool>
Tag
aki.paint.tools.tag.TagTool
Image or .gtc clip that is put into image by clicking a mouse. Can be dragged with a mouse after it is placed. Supports keyframe animation. Supports pausing at specified gtc frame, playing out the rest of the clip as a cut-out effect.
Tag graphics can display additional textual layers that’s content that can change in time according to user-defined timeline.
File |
Name of the tag resource file (image/clip). |
Size |
Float value defining size of the tag graphics. Value of 1.0 means that the graphics pixels have the same height as the background video pixels. |
|
ContentPath
|
Path to a tag content resources |
AnchorPoint |
Reference point of the tag graphics. Values are in the <0,1> range. [0.5,0.5] by default. |
TextValue |
Text overlay static text content. |
|
ThumbnailTextYPos
|
Y-position of the thumbnail text position, in pixels |
|
ThumbnailTextSize
|
Size of the thumbnail text |
|
ThumbnailTextColor
|
Color of the thumbnail text in rgba floats notation. Black by default. |
| ThumbnailText | Text rendered into the thumbnail |
| RotationAngleDeg | Rotation of tag graphics, in degrees. |
| 3DScale | By enabling the value, the graphics are placed on 3D pitch, when available. Scale value defines default size of the graphics in 3D space. |
| BillboardEnabled | When enabled, the tag is rendered in a stand-up position when placed on pitch. |
| BillboardOffset | Offset from the ground up in meters. |
| BillboardType |
STATIC - Camera position is determined at the drawing creation and then remains static (drawing is facing in the same direction). DYNAMIC - Camera position is determined dynamically throughout the drawing existence. |
Font parameters
| TextPosition | Offset of the text layer line relative to reference point, in background graphics pixels. |
| TextPositionReference | Reference point for the text position offset. Can be TOP_LEFT(default) or TOP_RIGHT of the background graphics. |
| TextSize | Height of one text line in pixels of the background graphics. |
| FontHAlign | Horizontal alignment { LEFT | CENTER | RIGHT | DOT_FIRST | DOT_LAST } |
| FontHAlignChar | Horizontal alignment character |
| FontVAlign | Vertical alignment { TOP | CENTER | BOTTOM | FIRST | LAST } |
| FontLineSpacing | Relative line spacing. Value 1.0 means spacing by the height of the font. |
| FontLineFlowPolicy |
Behavior for lines wider then defined limit. { DONT_CARE | SCALE | UNIFORM_SCALE | SOFT_NEWLINE | HARD_NEWLINE | SOFT_SKIP | HARD_SKIP | SINGLE_LINE } |
| FontLineWidth | Line width limit. (see FontLineFlowPolicy) |
| FontFixedPitch | Fixed character pitch. (disables kerning defined by font). |
| FontKerning | Additional kerning. |
| FontCapitalsRatio | If enabled (value > 0) then all characters are made capitals. The original non capital letters are rendered smaller. This value defines a factor for that scale. |
| FontName | Name of the font. All system fonts are available. |
| FontResolution | Font texture resolution in pixels. It should approximately match the pixel size on the screen. |
| FontBaseColorMode | Coloring text mode. { SOLID | CHAR_4POINTS | LINE_4POINTS | GLOBAL_4POINTS | LINE_2GRADIENTS } |
| FontBaseColor | Color to be used when mode is SOLID |
| FontBaseColorP1 | Color for gradient coloring |
| FontBaseColorP2 | Color for gradient coloring |
| FontBaseColorP3 | Color for gradient coloring |
| FontBaseColorP4 | Color for gradient coloring |
| FontOutlineSize | Size of outline in pixels. Set to zero to disable outline. |
| FontOutlineColor | Outline color. |
| FontShadowOffset | Relative offset of shadow to normal text. |
| FontShadowBlur | Amount of blur of the shadow. |
| FontShadowColor | Shadow color. |
Tracking: Screen, ScreenMotion, 3D
Keyframing: yes
Chroma key: no
Example
<Tool type="aki.paint.tools.tag.TagTool"> <File value="Tags/tag.gtc"/> <PauseFrame value="15"/> <ThumbnailTextColor value="[.1, .1, .1, 1]"/> <ThumbnailTextYPos value="35" /> <ThumbnailTextSize value="15"/> <ThumbnailText value="Tag"/> <ContentPath value="Tags"/> <AnchorPoint value="[0.5,0.4]"/> </Tool>
Tackle Box
aki.paint.tools.tacklebox.TackleBoxTool
Textured rectangle drawn onto the pitch to highlight an area at the pitch. Displays color outline at the head side of the box.
Insertion is optimized to quickly set up the correct pitch perspective. Use following workflow to define the rectangle shape:
- A head line is defined by clicking and dragging the left mouse button over the video. A tackle box graphics appears in its default perspective.
- A manipulator shows up over the head line, following the mouse. Dragging the manipulator lets user define the first horizontal perspective line.
- Another manipulator following the mouse shows up to define the second horizontal perspective line.
Properties allow to define textured fill of the inner area and textured outline. Both textures can be colored using Color or ColorMatrix coloring. Setting empty texture filename results in solid color fill/outline.
Tracking: Motion
Keyframing: no
Chroma key: yes
Example
<Tool type="aki.paint.tools.tacklebox.TackleBoxTool"> <TextureFile value="texture.png"/> <TextureLoopStart value="0"/> <OutlineThickness value="2"/> <OutlineTexture value="stroke.png"/> <OutlineColor value="[1, 1, 0, 1]"/> <FillColor value="[1, 1, 1, 1]"/> </Tool>
Thumbnail coloring
Thumbnail coloring is controlled by ThumbnailColoringEnabled property. When is enabled, thumbnail pixels are colored with tool colors according to following table:
| RED | FillColor |
| GREEN | Not used. Always white. |
| BLUE | OutlineColor |
ZoomSpot
aki.paint.tools.zoomspot.ZoomSpotTool
Shows a spot shape (either circular or rectangular) with optional zoom effect inside. Saturation of video outside the spot can be dimmed.
| ColorMatrix | Color mapping of the outer texture. |
| Opacity | Outer texture effect opacity. |
| Size | Size of the spot shape. In normalized screen coordinates. |
Zoom |
Magnification factor applied to the inward area of the spot shape. |
BWFactor |
Amount of de-saturation effect of the outward area. <0,1>. |
Shape |
CIRCLE or RECTANGLE. CIRCLE is default. |
RectangleAspect |
Aspect of the rectangle shape; ignored for CIRCLE. |
| RimThickness | Thickness of the spot rim, in normalized screen coordinates. |
| Texture | Texture image applied radially to the spot shape. |
TextureCoordinateSpace |
Texture image dimensions |
| TextureSpotEdgePos | X coordinate in texture for the inner edge. In texture image pixels. |
Tracking: Screen, ScreenMotion
Keyframing: yes
Chroma key: no
Example
<Tool type="aki.paint.tools.zoomspot.ZoomSpotTool"> <Id value="Zoom"/> <Zoom value="2.0"/> <Size value="0.35"/> <BWFactor value="0.5"/> <Thumbnail value="tZoom.png"/> <Texture value="zoomspot_line.png"/> <TextureCoordinateSpace value="[65,8]"/> <TextureSpotEdgePos value="7"/> <RimThickness value="0.018"/> </Tool>
ZoomClip
aki.paint.tools.zoomspot.ZoomSpotTool
Shows a clip with optional zoom effect inside of the masked part of clip.
File |
Path to gtc clip. |
| Size | Size of the clip. In normalized screen coordinates. |
Zoom |
Magnification factor applied to the masked area of the clip. |
Opacity |
Opacity multiplication constant. |
ColorMatrix |
Advanced clip coloring. Changed from GUI. |
ThumbnailOverlay |
Overlay part of thumbnail. |
Tracking: Screen
Keyframing: yes
Chroma key: no
Example
<Tool type="aki.paint.tools.zoomclip.ZoomClipTool"> <Id value="Zoom"/> <Zoom value="2.0"/> <Size value="0.35"/> </Tool>
Zoom Pan
aki.paint.tools.zoompan.ZoomPanTool
Zoom Pan tool allows to select zoomed picture area in the video footage. Available both for Live and recorded footage.
Zoom Pan can be animated, stored into the clip, and replayed together with the clip.
There is a playback speed timeline integrated into the zoom pan tool. Timeline allows to schedule playback speed changes into the ZoomPan production. Additionally, the timeline shows ZoomPan keyframes for better overview of created animation.
Pan
When the video is zoomed-in, panning is used to change the viewport of the video sequence. Simply drag the Video preview canvas with the left mouse button down.
Controls
Change the current zoom. Drag the thumb on the zoom scale. |
|
Delete the current keyframe. Available only when a keyframe has been defined at the current timecode. |
|
Zoom pivot. Click into preview to define the pivot. When not defined (not visible), the center of the screen is used as pivot. |
|
Center of the screen. The cross-hair may help to keep the tracked target in the center of the screen when creating an animation.
|
|
Save animation modifications. |
|
Edit animation. |
Animation Framework
Define several keyframes with custom Zoom and Pan values. Transitions between different Zoom/Pan values are automatically interpolated.
If there's an Zoom Pan animation in the clip, you have to press Edit animation button first. Clips don't support multiple animations but you can edit (extend) the existing one.
Save the animation to the clip.
Zoom Pan timeline
Zoom Pan Keyframe. Click the keyframe to jump to the time of the keyframe. |
|
Active keyframe. Current time equals the time of the keyframe. |
|
Time marker (current time). |
Zoom Pan animations with Pause and Slow Motion blocks
You can use the Zoom Pan tool with Pause/Slow motion at once to create more advanced animations.
Example (Pause during Zoom-in and Zoom-out, Slow motion playback in-between).
More info is in chapter Playback speed timeline.
Supported features
Tracking: None
Keyframing: yes
Chroma key: no
Example of configuration
<Tool type="aki.paint.tools.zoompan.ZoomPanTool"> <Thumbnail value="tZoomPan.png" /> </Tool>
Playback Speed
aki.paint.tools.playbackspeed.PlaybackSpeedTool
This tool allows to insert pause or slow motion blocks into clip playback.
More info is in chapter Playback speed timeline.
Example
<Tool type="aki.paint.tools.playbackspeed.PlaybackSpeedTool"> <Thumbnail value="tPlaybackSpeed.png"/> </Tool>
Blocking Line
aki.paint.tools.freehand.PolyLineTool
Special kind of Poly Line with blocking marker at the end. See Poly Line for list of properties.
Subtitles
chyron.subtitlestool.SubtitlesTool
This tool allows you to create subtitles in the video area and save them into a clip.
To create a subtitle, just select the Subtitles tool to show the input/navigation dialog. The dialog is shown only when a clip is selected.
Type in the text of the subtitle and press Enter key. Duration of one subtitle is from the point of definition to the point of redefinition to a new value.
Tracking: Screen
Keyframing: no
Chroma key: no
Arrow Tool
chyron.paint.tools.arrowtool.ArrowTool
Arrow tool allows to create 3D arrows. First you have to set perspective for the clip – see 3D Calibration. Since 3D Pitch might be defined in clip only, this tool works in clip only as well.
The arrow is composed of segments called bounces. Each bounce is controlled by three points, two of which are at the ends of the bounce and lie on the ground. The third control point is between them and controls the height of the arc.
If MultipleBounces property is checked, each click into the preview appends a bounce into currently edited arrow.
In case a simple start-to-end arrow without any bounces is desired, uncheck the MultipleBounces property. In such case new arrows are created instead of appending bounces to the last one.
It is possible to display a text showing a distance between arrow end points. Distance text appearance is controlled from the Distance property tab. An important property is a TrackingType that decides how the distance text is presented:
NONE |
On-screen distance text. Overall length of the arrow is shown. TextPosition defines the absolute position of the text, in normalized screen coordinates. |
SHAPE_ALIGNED |
Distance text in pitch plane. Shown for each arrow segment. TextPosition defines metric offset of text from the center point of arrow segment. |
CAMERA_FACING |
3D distance text standing on pitch. Shown for each arrow segment. TextPosition defines metric offset of text from the center point of arrow segment. |
Distance text supports background texture. Background texture is controlled from the Distance Texture properties tab.
Tracking: 3D
Keyframing: yes
Chroma key: Off or Shadow only