The latest version of this document can be found at www.broad.ology.org.uk/amiga/sketchblock/painttool.html

SketchBlock 2.8 - Digital Sketching For The Amiga (SVN: 133:363M)

Paint Tool

The paint tool allows drawing / painting into the currently active layer with smooth strokes of the mouse / tablet stylus.

Colour Picker

The paint tool also has a colour picker built in. Whilst the paint tool is active you can press the CTRL key and pick a colour from any point in the sketch window.

Paint Tool Settings

When the Paint tool is active the settings for the tool can be modified via the settings panel in the Tools Window.(Shown Right)

The following attributes can be controlled.

Paint Tool ARexx Commands

To pass ARexx commands to the Paint tool you must use the SketchBlock ARexx command COMMANDTOOL

SET

ATTR/K,STEM/K

Sets the Paint settings to the provided values. You may set individual attributes or pass many at one time using STEM. The following attributes are suported. When passing a STEM variable attributes not explicitly set are unchanged.
PAINTMODE
Specify the required paint mode as a case sensitive string. ie "Multiply" != "MULTIPLY"
PRESSURESIZE
BOOLEAN (0 or 1)
PRESSUREOPACITY
BOOLEAN (0 or 1)
PRESSUREHARDNESS
BOOLEAN (0 or 1)
PRESSURECOLOR
BOOLEAN (0 or 1)
PRESSUREJITTER
BOOLEAN (0 or 1)
PROGRESSIVE
BOOLEAN (0 or 1)
OPACITY
This sets the opacity of the paint stroke, it takes a value from 0 to 100
SCALE
This sets the scaling of the paint stroke, it takes a value from 0 to 500 (although the smallest resulting brush size is always 1 pixel square)
SHOWBRUSH
0 (Hide) 1 (Outline) or 2 (Solid)
JITTERPOSITION
BOOLEAN (0 or 1)
JITTERPRESSURE
BOOLEAN (0 or 1)
JITTERSCALE
BOOLEAN (0 or 1)
JITTERPOSITIONVALUE
Percentage Value from 0 to 500
JITTERPRESSUREVALUE
Percentage value from 0 to 100
JITTERSCALEVALUE
Percentage value from 0 to 100
/* 2B pencil Setting  */
ADDRESS SKETCHBLOCK
'SETCURRENTTOOL TOOLNAME "Paint"'
'SETCURRENTBRUSH BRUSHNAME "Pencil_Small_ABR"'

P.PRESSURESIZE = 1
P.PRESSUREOPACITY = 1
P.PRESSURECOLOR = 0
P.PRESSUREHARDNESS = 0
P.PROGRESSIVE = 1
P.OPACITY = 60
P.SCALE = 20

'COMMANDTOOL TOOLNAME "Paint" COMMAND "SET STEM P"'
'SETCOLOR FF191919'

GET

ATTR/K,STEM/K

Retrieves the current settings via a STEM variable, or individualy by specifying the with ATTR keyword, see above for attributes.
STEM/K
Pass the variable to which the settings will be added. The values will be added to the stem variable useing the name above with no index component. eg If the STEM var was FOO pressure size will be added as FOO.PRESSURESIZE Additional the stem variable ATTR is added so that a list of attributes may ne determined. This aides automatic creation of presets etc. STEM.ATTR.0 -- number of attributes.
STEM.ATRR.1.<attrname_1>
STEM.ATTR.n.<attrname_n>
See the MakePreset.rexx script for a detailed example of usage.

DRAW

PRJID/K/N,LAYID/N/K,STEM/K,ARRAY/S,COORDS/M/N

Draw stroke with the paint tool.
PRJID/K/N
Specify Project to draw into if not provided use active project
LAYID/N/K
Specify layer to draw into, if not provided use activelayer of specified project
STEM/K
Provide point data via a stem var (not implmented in painttool.sktl v 1.2)
ARRAY/S
Provide point data by an array of numbers on the command line...
COORDS/M/N
Triplets giveing the cooordinates X Y Pressure (%)

The latest version of this document can be found at www.broad.ology.org.uk/amiga/sketchblock/painttool.html