Pixarra TwistedBrush Pro Studio 18.08 serial key or number

STUDIO REFERENCE
MANUAL
Table of Contents
Keyboard Shortcuts .................................................................................................................................. 4
Keyboard Shortcuts ...................................................................................................................... 5

Lua Filter Scripts...................................................................................................................................... 11

Overview of Lua Filter Scripts ....................................................................................................12
Example Lua Filter.......................................................................................................................13
Lua Filter Gluas Compatible APIs ..............................................................................................14
Lua Filter Gluas Compatible Globals.........................................................................................16
TwistedBrush Lua Filter General APIs.......................................................................................17
TwistedBrush Lua Filter Bitwise APIs ........................................................................................19
TwistedBrush Lua Filter Paint APIs ...........................................................................................20
TwistedBrush Lua Filter Globals................................................................................................24
TwistedBrush Lua Filter Constants ...........................................................................................26
TwistedBrush Lua Filter User Interface Directives ..................................................................27

Revision History ...................................................................................................................................... 29

Version 18 .................................................................................................................................... 30
Version 17 .................................................................................................................................... 40
Version 16 .................................................................................................................................... 49
Version 15 .................................................................................................................................... 61
Version 14 .................................................................................................................................... 91
Version 13 ..................................................................................................................................106
Version 12 ..................................................................................................................................121
Version 11 ..................................................................................................................................138
Version 10 ..................................................................................................................................176
Version 9 ....................................................................................................................................186
Version 8 ....................................................................................................................................198
Version 7 ....................................................................................................................................208
Version 6 ....................................................................................................................................221
Version 5 ....................................................................................................................................230
Version 4 ....................................................................................................................................240
Version 3 ....................................................................................................................................248
Version 2 ....................................................................................................................................258
Version 1 ....................................................................................................................................266
 Keyboard Shortcuts

TwistedBrush Pro Studio Reference Manual Page 4

Keyboard Shortcuts

User Interface / Configuration

F1 TwistedBrush Pro Studio User Guide

F2 Show Page Explorer

F3 Toggle full screen mode.

F4 Toggle floating panel for Brush Shortcuts.

F5 Toggle floating panel for Brush Modifiers.

F6 Toggle floating panel for Brush Adjustments.

F7 Toggle floating panel for Color Adjustments.

F8 Toggle floating panel for Color Palettes.

Ctrl + B Toggle Stats Mode

Y Show Layer dialog

M Edit ArtSet Dialog

B Select Brush Dialog

Alt + Z Toggle between ArtSet and Brush names in the brush shortcut panel

T Toggle tracing paper mode on and off

Page Management
Ctrl + S Save

TwistedBrush Pro Studio Reference Manual Page 5

 Ctrl + Z Undo

Ctrl + Y Redo

Ctrl + X Cut

Ctrl + C Copy

Ctrl + V Paste

Page Up Previous Page

Page Down Next page

Ctrl + Left Arrow Scroll canvas left

Ctrl + Right arrow Scroll canvas right

Ctrl + Up arrow Scroll canvas up

Ctrl + Down arrow Scroll canvas down

Tools
Ctrl Alter the origin point of the tool.

Alt Center around the cursor rather than the top left.

Shift Constrain rectangles to squares and ellipses to circles

Spacebar While using a tool holding down the spacebar will hide the
coordinate info.

S Brush tool

I Color Picker tool

TwistedBrush Pro Studio Reference Manual Page 6

 . Brush Cleaner tool

L Line tool

U Rectangle tool

C Crop tool

V Move tool

O Ellipse tool

H Paint Bucket tool

G Gradient tool

F Rectangle Mask tool

J Ellipse Mask tool

Z Polygon Mask tool

K Magic Wand Mask tool

Q Copy tool

W Paste tool

X Text tool

P or Spacebar Pan tool

N Rotate Brush tool

R Adjust Brush tool

, Clean the brush when auto brushing cleaning is off.

TwistedBrush Pro Studio Reference Manual Page 7

 Shift + T Drawing Guides. Toggle display of the drawing guides.

Shift Adjustments to the fill tolerance for Paint Bucket tool.

Shift Adjustments to the fill tolerance for the Magic Wand Mask tool.

Layers
A Reference layer toggle.

Ctrl + Q Move layer up in the stack

Ctrl + A Move layer down in the stack

Ctrl + M Merge current layer and don't remove layer.

Cloning
Ctrl + click Sets the cloning absolute offset position

Alt + click Sets the cloning relative offset position

Ctrl + Alt + Click Sets the cloning fixed offset position

Brushes Settings
E Increase brush size by 1

D Decrease brush size by 1

Shift + E Increase brush density by 1

Shift + D Decrease brush density by 1

Ctrl + E Increase brush opacity by 1

TwistedBrush Pro Studio Reference Manual Page 8

 Ctrl + D Decrease brush opacity by 1

Ctrl + T Generate a random brush

Ctrl Merge brush effect from current to clicked shortcut

Shift + Click Adjusts the Size, Density or Opacity sliders in a one-unit

increments.

Shift + Click Copies brush to the clicked shortcut slot.

Ctrl + Click Selects color from the current layer.

Shift + Click Selects color from the scratch layer.

Alt + Click Selects color from the merged layers.

Ctrl + Alt + Click Selects color from the trace layer.

Image Brushes
Ctrl + Click Captures the image from the current layer.

Shift + Click Captures the image from the scratch layer.

Alt + Click Captures the image from the merged layers.

Alt + Shift + Click Captures the image of the entire page from the merged layers.

Ctrl + Alt + Click Captures the image from the trace layer.

Drawing
Shift + P Center the point on the page

Shift Constrain the stroke to a straight line.

TwistedBrush Pro Studio Reference Manual Page 9

 Esc Cancels the current brush stroke.

Ctrl When drawing, moves the stroke origin. Use with Lines and Outlines
ArtSet.

Zoom
+ Zoom in and center the position to where the cursor was.

- Zoom out and center the position to where the cursor was.

[ or { Zoom 1 to 1 (Actual pixels)

Color Palettes and Color Bar

Ctrl + Right Click Mark the start and end color for horizontal color spans in a
palette.

Alt + Right Click Mark the start and end color for vertical color spans in a palette.

Shift + Click Copy the current color to the clicked color bar location.

TwistedBrush Pro Studio Reference Manual Page 10

 Lua Filter Scripts

TwistedBrush Pro Studio Reference Manual Page 11

Overview of Lua Filter Scripts

A Lua script filter in TwistedBrush is a small piece code written in the Lua programming
language (versin 5.1) that can be used to quickly implement image processing filters right
within TwistedBrush.

The Lua scripting filter is designed to be somewhat compatible with the gluas plug-ins used
in The Gimp image editing software package. The gluas plugin system was developed by
Øyvind Kolås. There is a nice tutorial of gluas titled Image Processing with gluas a large part
is applicable to TwistedBrush and most (if not all) of the sample scripts shown should work
within TwistedBrush.

Additional information on gluas can be found at http://www.gluas.org.

An excellent online book covering all the details of the Lua programming language can be
found here.

In case you haven't determined this yet, this topic and programming of filters with Lua is
designed for those with computer programming experience. However, this doesn't limited
anyone from using filters that are either included with TwistedBrush or shared from
developers.

TwistedBrush Pro Studio Reference Manual Page 12

Example Lua Filter

Here is an example of a Lua Script Filter that does a simple invert (negative).

for y = 0, height - 1 do

for x = 0, width - 1 do

local r, g, b

r, g, b = get_rgb(x, y)

r = 1 - r

g = 1 - g

b = 1 - b

set_rgb(x, y, r, g, B)

end

end

TwistedBrush Pro Studio Reference Manual Page 13

Lua Filter Gluas Compatible APIs

v = get_value(x, y)

set_value(x, y, v)

r, g, b = get_rgb(x, y)

set_rgb(x, y, r, g, B)

r, g, b, a = get_rgba(x, y)

set_rgba(x, y)

h, s, v = get_hsv(x, y)

set_hsv(x, y, h, s, v)

h, s, l = get_hsl(x, y)

set_hsl(x, y, h, s, l)

l, a, b = get_lab(x, y)

set_lab(x, y)

TwistedBrush Pro Studio Reference Manual Page 14

 c, m, y, k = get_cmyk(x, y)

set_cmyk(x, y, c, m, y, k)

flush()

progress(v) // only a stub, progress is not shown in TwistedBrush

TwistedBrush Pro Studio Reference Manual Page 15

Lua Filter Gluas Compatible Globals

width

height

bound_x0 -- Always 0 in TwistedBrush

bound_y0 -- Always 0 in TwistedBrush

bound_x1 -- Always width - 1 in TwistedBrush

bound_y1 -- Always height - 1 in TwistedBrush

TwistedBrush Pro Studio Reference Manual Page 16

TwistedBrush Lua Filter General APIs

a = get_alpha(x, y)

set_alpha(x, y, a)

m = get_mask(x, y) -- added in 16.02

set_mask(x, y, m) -- added in 16.02

r, g, b = get_color() -- Gets the current brush color

r, g, b = get_color1() -- Gets the current color from slot 1

r, g, b = get_color2() -- Gets the current color from slot 2

r, g, b = get_color3() -- Gets the current color from slot 3

r, g, b = get_color4() -- Gets the current color from slot 4

single_buffer() -- All functions work from the same buffer

message_box(message, title) -- Display message box

merge(merge_mode, opacity) -- Like the flush() method but a merge mode and opacity
can be specified for the

TwistedBrush Pro Studio Reference Manual Page 17

 merging of the destination buffer back into the source buffer. The valid merge
types are listed here.

output_debug_string(message) -- Send the string to the Windows debug monitor.

is_escape() -- Returns 1 if the escape key is currently pressed.

TwistedBrush Pro Studio Reference Manual Page 18

TwistedBrush Lua Filter Bitwise APIs

r = bit_not(v1) -- Bitwise Not (added in version 15.53)

r = bit_and(v1, v2) -- Bitwise And (added in version 15.53)

r = bit_or(v1, v2) - Bitwise Or (added in version 15.53)

r = bit_xor(v1, v2) -- Bitwise Xor (added in version 15.53)

r = bit_shfr(v1, bits) -- Bitwise shift right (added in version 15.53)

r = bit_shfl(v1, bits) -- Bitwise shift left (added in version 15.53)

TwistedBrush Pro Studio Reference Manual Page 19

TwistedBrush Lua Filter Paint APIs

paint_open(seed) -- Seed is a random seed

paint_close() -- End the paint session

paint_stroke_start(x, y) - Start a new stroke.

paint_stroke_stop() -- End the stroke

paint_stroke_pos(x, y, pressure) -- New stroke position

paint_select_brush(artsetName, brushName, mergeEffects)

paint_brush_size(size)

paint_brush_density(density)

paint_brush_opacity(opacity)

paint_brush_color(r, g, B)

paint_set_color_banks(selectedBank, r1, g1, b1, r2, g2, b2, r3, g3, b3, r4, g4, b4)

paint_line(x1, y1, x2, y2)

paint_spline(x1, y1, x2, y2, cx1, cy1, cx2, cy2)

paint_dab(x, y, pressure)

-- The parameters for the paint_filter() function directly correspond to the

controls for the filter in question.
paint_filter(filtername, variant, slider1, slider2, slider3, slider4, slider5,
slider6, style1, style2, flag1, flag2, flag3, flag4,

TwistedBrush Pro Studio Reference Manual Page 20

 flag5, flag6, r, g, b, ustring)

-- These paint functions were available starting in 17.28

paint_buffer_from_layer(bufNum) -- Copy contents of the current layer into the
bufNum

paint_buffer_to_layer(bufNum) -- Copy contents of the bufNum into the current

layer

paint_buffer_copy(srcBufNum, dstBufNum) -- Copy contents of SrcBufNum to DstBufNum

paint_buffer_clear(bufNum) -- Clear content of the bufNum

paint_buffer_merge_layer(bufNum, mixMode, opacity) -- Merge conents of the bufNum

into the current layer, using the
mix mode (merge type) and opacity

paint_buffer_from_mask(bufNum) -- Copy contents of the current mask into the

bufNum

paint_buffer_to_mask(bufNum) -- Copy contents fo the bufNum into the current

mask

paint_flip_horizontal() -- Flip horizontal

paint_flip_vertical() -- Flip vertical

paint_clear_page() -- Clear the current layer

paint_fill_page() -- Fill the current layer with the current color.

paint_set_page(r, g, b, a) -- Set current layer to the r, g, b, a values

paint_mask_on(flag) -- Turn mask on or off (values 1 or 0)

TwistedBrush Pro Studio Reference Manual Page 21

 paint_mask_clear() -- Clear the mask

paint_mask_invert() -- Invert the mask

paint_create_from_mask() -- Set current layer values from current mask

paint_alpha_create_from_mask() -- Set alpha values of current layer from the

current mask

paint_mask_create_from_image() -- Create mask from current layer data

paint_mask_create_from_image_luma() -- Create mask from current layer data using

luma values

paint_mask_create_from_alpha() -- Create mask from current layer alpha data

paint_flood_fill(r, g, b, x, y, tolerance, fillType) -- Flood fill

tool

paint_rectangle(r, g, b, x1, y1, x2, y2, opacity) -- Rectangle

tool

paint_ellipse(r, g, b, x1, y1, x2, y2, opacity) -- Ellipse tool

paint_text(r, g, b, x, y, fontName, fontHeight, fontBold, fontItalic,

string) -- Text tool. Note: The paint_text function is currently non-
operational unless a font if first selected wia the Text tool.

paint_gradient(r1, g1, b1, r2, g2, b2, r3, g3, b3, r4, g4, b4, colorCount, x1, y1,
x2, y2, gradType) -- Gradient tool

paint_mask_ellipse(x1, y1, x2, y2, maskLevel) -- Old Mask Ellipse tool

paint_mask_rectangle(x1, y1, x2, y2, maskLevel) -- Old Mask Rectangle tool

TwistedBrush Pro Studio Reference Manual Page 22

 paint_mask_wand(x, y, tolerance, opacity, maskWandType) -- Mask Wand tool

paint_copy(x1, y1, x2, y2) -- Old Copy

tool

paint_paste(x, y, size, rotateAngle, highQualityFlag) -- Old Paste tool

paint_warp(x1, y1, x2, y2, warpMode, warpStrength) -- Warp tool

paint_rotate_brush(x1, y1, x2, y2)

TwistedBrush Pro Studio Reference Manual Page 23

TwistedBrush Lua Filter Globals

variantVal -- The variant slider value

slideVal1 -- The sliderValx values come from gui sliders when defined.

slideVal2

slideVal3

slideVal4

slideVal5

slideVal6

flagVal1 -- The flagValx values come from the gui checkboxes

flagVal2

flagVal3

flagVal4

flagVal5

TwistedBrush Pro Studio Reference Manual Page 24

 flagVal6

styleVal1 -- 1 based index into the option choosen

styleVal2

TwistedBrush Pro Studio Reference Manual Page 25

TwistedBrush Lua Filter Constants

Merge Types

MERGE_NORMAL
MERGE_MULTIPLY
MERGE_SCREEN
MERGE_DARKEN
MERGE_LIGHTEN
MERGE_DIFFERENCE
MERGE_NEGATION
MERGE_EXCLUSIO
MERGE_OVERLAY
MERGE_HARD_LIGHT
MERGE_SOFT_LIGHT
MERGE_DODGE
MERGE_BURN
MERGE_REFLECT
MERGE_GLOW
MERGE_ADD
MERGE_SUBTRACT
MERGE_COLOR
MERGE_HARD_COLOR
MERGE_HSL_HUE
MERGE_HSL_SAT
MERGE_HSL_LUM
MERGE_HSL_COLOR
MERGE_TEXTURIZE
MERGE_TEXTURIZE2
MERGE_TEXTURIZE3

TwistedBrush Pro Studio Reference Manual Page 26

TwistedBrush Lua Filter User Interface
Directives

Within a comment in the Lua script a directive can be defined for creating up to 6 user
slider controls and up to 6 check box controls that appear within the TwistedBrush Filter
dialog. This allows users to dynamically adjust values in the script without ever needing to
look at a script. In addition this also allows for the filters to be recorded like all the other
filters in TwistedBrush. The format of this directives are:

--@TBCONFIG VARIANT: name, default value

--@TBCONFIG SLIDER: name, default value

--@TBCONFIG SLIDERV2: name, value, start range, end range, increment, decimal
places, units

--@TBCONFIG FLAG: name, default value

--@TBCONFIG STYLE: name, default index, choice1, choice2, ... choice20

--@TBCONFIG INFO: message for the info box.

TwistedBrush Pro Studio Reference Manual Page 27

Example of the user interface directives

For example these three lines in a script will define three sliders Red, Green and Blue with
values of a middle gray.

--@TBCONFIG SLIDER: Red, 50.0

--@TBCONFIG SLIDER: Green, 50.0

--@TBCONFIG SLIDER: Blue, 50.0

Above is the Filter dialog that shows the sliders that will be created based on the directives.
However, the sample image shows values of 100.0 for each rather than the default shown
above (it's a screen shot from a different example)

TwistedBrush Pro Studio Reference Manual Page 28

 Revision History

TwistedBrush Pro Studio Reference Manual Page 29

Version 18
18.18

• Added - Basic Animation supported added. Accessed from the new top level menu named
Animation.
• Improved - When zooming in and out with the mouse wheel or + or - keys retain the actual
position on screen of the area of interest.
• Improved - Books can now have up to 1000 pages.
• Improved - When starting Page Explorer or selecting a new book in the Page Explorer give a
indicator in the title bar that the thumbnails are being built.
• Improved - Support key repeat for the next and prev keys (Page Down and Page Up) to allow
flipping through pages more quickly.
• Improved - Automatic zoom to fit has been refined to only do it in cases when a new file is
being imported and not in cases the interrupt work flow such as when paging up and down
or when working with filters or solutions.
• Fixed - When zooming out with the mouse wheel quickly there could be some visual artifacts
on the drawing area background panel.
• Fixed - Using the Set Preview Area with the Motion Blur filter or any filter without a
checkview check box would result in a crash.
• Fixed - When deleting a page not all the page elements were deleted.
• Fixed - When moving a page up or down in the Page Explorer not all page elements were
moved.
• Fixed - The Pro Watercolor Dry 4 Pro, Watercolor Dry 5 and Pro Watercolor Wet 3 brushes
had incorrect default size values.

18.17

• Added - Pro Air Flow Brush to the Art Pro - Natural Media ArtSet.
• Added - Pro Twister to the Art Pro - Smoke and Gases ArtSet
• Added - Many fire and plasma brushes added to the Art Pro - Smoke and Gases ArtSet.
• Added - Lineto Reset brush effect.
• Added - Pro Spriro Line 2, Pro Snaker, Pro Spinner, Pro Fractal Snaker and Pro Fractal
Spinner to the Art Pro - Design ArtSet.
• Added - Pro Img Shp Shaded, Pro Img Shp Pattern Shaded, Pro Img Shp Cloner Shaded, Pro
Img Shp Shaded Rotate, Pro Img Shp Pattern Shaded Rotate and Pro Img Shp Cloner Shaded
Rotate brushes.
• Added - Pro Snow Laden Tree, Pro Foliage, Pro Foliage 5, Pro Leaf 1, Pro Leaf 2, Pro Leaf 2,
Pro Twigs and Pro Butterflies added to Art Pro - Plants and Trees ArtSet.
• Added - HSL Adjustments brush effects modifiers to the Effects - Color Modifier ArtSet.
• Added - Brush effects pRot To Dir and pRot to DirInv to rotate the brush to the current
particle direction.
• Added - Brush effect Spac text clip added for supporting varible pitched spacing for Text
brushes.
• Added - Brush effect envelope db-ang3.
• Added - Brush effect Shaded Direction and Shaded Length.

TwistedBrush Pro Studio Reference Manual Page 30

 • Improved - Pressing and holding the Shift key will constrain the painting tool to a straight
line.
• Improved - The Dab Mode Rate brush effect is now set at a scale of 10x faster.
• Improved - When the Dab Mode Rate brush effect is in use don't draw triggered by
movement, only by the flow rate.
• Improve - Most Pro brushes have been updated to set the brush rotation to 0 (no rotation).
This results in improved quality and performance.
• Improved - The Dab Pos Mode effect is now compatible with Lay brush effects.
• Improved - Text brushes now support varable pitch spacing and also been updated to take
advantage of the Brush Control option (check box) features.
• Fixed - The Tool Shortcut is Always Dynamic preference was not working properly.
• Fixed - The Dab Mode Rate brush effect and brushes that use it was not working properly on
non-tablet installations.

18.16

• Added - Art Pro - Smoke and Gases ArtSet added.

• Added - Pro Image Shape Particle 1, Pro Image Shape Particle 2 and Pro Image Shape
Particle 3 added to the Art Pro - Image Shape ArtSet
• Added - Pro Image Brush Particle 1, Pro Image Brush Particle 2 and Pro Image Brush Particle
3 added to the Art Pro - Image Brush ArtSet.
• Added - Pro Shape Particle 1, Pro Shape Particle 2 and Pro Shape Particle 3 added to the Art
Pro - Design ArtSet
• Added - Pro Clip Particles to the Art Pro - Clip Brush ArtSet
• Added - Pro Nu Spray Wave and Pro Nu Spray Shot to the Art Pro - Nu Media ArtSet.
• Added - TwistedBrush Automation System! Experimental but functioning. Found at menu
File > Automation.
• Added - Tool Shortcut is Always Dynamic preference added.
• Added - Pro Eraser Text Brush added to the Art Pro - Test Brush ArtSet.
• Added - Brush effects pRot, pAdj Rot, pRot Init, pRnd Rot and pRnd Rot Init added.
• Added - Brush effect Dab mode rate added. Allows for Dab Mode and Dab Pos Mode
brushes to paint without moving the cursor (like an air brush)
• Improved - The Brush Control panel now supports the ability to turn off and on control
parameters.
• Improved - Remember the last text entered for Text brushes
• Improved - When selecting a brush effect in the Brush Effect panel clear out the envelope,
freq and amount fields if the brush effect doesn't use them
• Improved - Particle emitter have been changed to not filter drawing, just emitting, when it's
not time to emit a new particle.
• Improved - The Paste tool, clip brushes and text brushes have improved performance with
rotating.
• Improved - RAW camera reading has been updated to use version 1.444 of dcraw.
• Changed - Remove unused Text Clip Brush effect.
• Changed - The Hide Circle Cursor option has been changed to Hide Circle Cursor while
Drawing.
• Fixed - Don't display the Clips panel when Text Clip brushes are selected.
• Fixed - The New Combo Palette popup menu action was clearing the current palette when it
shouldn't

TwistedBrush Pro Studio Reference Manual Page 31

 • Fixed - bStrokeScript and ubStrokeScript brush effects, if referencing an incorrect script file
would lose recent changes to the brush.
• Fixed - Paste tool, clip brushes and text brushes could crash in rare cases when rotating.
• Fixed - Using the Import Brush Code or Export Brush Code from the brush shortcut popup
menu would trigger a color selection mode for reference images.
• Fixed - Closing the Brush Control panel when a Text Brush is selected would result in a crash
on the next brush selected.
• Fixed - Selecting a Hue Adj, Sat Adj or Luminence Adj brush effect when the Brush Control
panel was not visible would result in a crash.
• Fixed - Selecting a Text Clip Once or Text Clip Repeat brush effect when the Brush Control
panel was not visible would result in a crash.

18.15

• Added - Art Pro - Text Brushes ArtSet added!! Allows painting with text.
• Added - Brush effects Text Clip Once, Text Clip Repeat and Text Clip Brush.
• Improved - When using the Color Picker with an ImageBrush also capture the color in
addition to the image beneath the cursor.
• Improved - Selecting of tools in normal and dynamic mode has been improved so that
anytime a tool shortcut key is pressed and the tool is used while the key is down it will be
considered a dynamic tool usage regardless of how quickly this is done.
• Improved - Don't allow tool selection while drawing.
• Changed - Some of the Help menus have been changed.
• Changed - Reinstate the feature that allows either mouse button to activate a tool when the
tool is being used in dynamic mode
• Changed - Default on new installations is to not disable Aero themes when TwistedBrush
starts.
• Fixed - Script recording was not recording the Color Picker action when the capturing from
the current layer or trace layer.
• Fixed - The Brush Control panel was not always properly predrawn when switching brushes
in Aero themes.
• Fixed - The Center Cursor shortcut Shift + P was only working at 1:1 zoom level.
• Fixed - Clip Array brushes, Image Brush Array brushes and Image Shape Array brushes were
not working properly.
• Fixed - Skip 2 If brush effect was not working properly resulting in a number of brushes not
working properly.

18.14

• Added - Exposed the option to disable the Windows Aero themes on start-up. Found in the
Preferences dialog. Previously the Aero themes were always disabled.
• Improved - Tool selection with shortcut keys is improved. Press a key to select a tool, press
and hold the key and use the tool will use the tool in dynamic mode.
• Fixed - The Grid Snap drawing guide was not working when is was not displayed for
performance reasons.

18.13

• Added - Clear button added to the Drawing Guide tool to clear the set drawing guides.

TwistedBrush Pro Studio Reference Manual Page 32

 • Added - Load from File as Reference Image menu option added to the File menu.
• Added - The Page Summary dialog gets a Reset button.
• Added - The Shortcut Key F2 will now launch the Page Explorer
• Added - Pro Clip Designer brush in the Art Pro Clips ArtSet.
• Improved - A number of drawing guides have rendering performance improvements. These
include not displaying them when the size would be too small and only rendering the areas
that are visible.
• Improved - Script Brush strokes can now be Undone just like any other stroke. This makes
them much more usable.
• Changed - The multitude of directly selectable Zoom levels in the View menu have been
moved to the Zoom submenu.
• Changed - The Opacity slider for the Magic Wand Mask took is now called Level.
• Changed - When recording scripts for the Script Brush tool the Undo system is disabled.
• Changed - Don't clear the current palette when using the New Palette option.
• Fixed - Modifier ArtSets were appearing in the User Created ArtSet category when they
should not have appeared at all.
• Fixed - The tool tip popup help was not correct for the page and book navigation icons.
• Fixed - Added Shortcut Key (F1) to the Help > User Guide menu item.

18.12

• Added - Layer locking is now possible. A layer can either be not locked, alpha channel locked
or fully locked. Previously no alpha channel locking was supported.
• Added - The Hue adj, Sat adj and Luminance adj brush effects when exposed in the Brush
Controls will have a color preview bar.
• Added - Pro Nu Puddy Paint to the Art Pro - Nu Media ArtSet.
• Changed - The Pro Img Shp Basic brush has the erase option removed since it is not
compatible with the brush layer options used in that brush.
• Fixed - Pattern modifier ArtSets were appearing in the wrong category in the Brush Selection
dialog.
• Fixed - Brush modifier ArtSets were not always appearing in the in the ArtSet list while in the
ArtSet Edit dialog and they were also appearing in the Brush Select dialog when they should
not.
• Fixed - Numerous Pro brushes where not working properly. Specifically those with optional
features such as Directional Rotate On/Off for Image Brushes.

18.11

• Added - Batch processing!! Automatically apply a script to multiple files.

• Added - New menu Reset All Pop-up Messages added to the File menu to restore all hidden
pop-up messages.
• Improved - Art Pro - Image Shape brushes will now automatically convert clip luminance
value to alpha values for clips that are fully opaque. This does not alter the stored clip, only
the version loaded for the shape brushes.
• Improved - All help resources are now online rather than integrated in the application.
• Improved - Alpha channel fidelity improvements when using clips and some filters.
• Improved - The Pro Img Shp Basic brush gets a wash option and fix for the eraser mode
option.

TwistedBrush Pro Studio Reference Manual Page 33

 • Improved - The Last Settings for Lua filters are now suffixed with the script name so that last
settings will be saved per script.
• Changed - Installation default for the mouse button control is changed to use left mouse
button for tools (more standard).
• Changed - Don't allow hiding the mouse button control message when switching between
left and right mouse buttons used for tools.
• Fixed - Lua filter scripts and integrated Lua filter scripts were not recording properly in the
TwistedBrush script recording system.
• Fixed - Entering a name in the Layer panel and then closing the Layer panel before selecting
something else would result in the layer name not being saved.

18.10

• Added - New ArtSet Art Pro - Pattern added. With more powerful and easier to use pattern
brushes that previously available,
• Added - Clip Fill filter added to the Generate category of filters.
• Added - Detail Enhance filter to the Photo category of filters.
• Added - New brush effects Luminance Rnd, Luminance add, Luminance sub, Hue adj, Sat adj
and Luminance adj.
• Added - New brush effects, Bsh Pat Scale, Select Pattern, Select Rotation, Select Shape and
Select Texture.
• Added - New brush effect, Clip Pattern.
• Added - It is now possible for the Brush Control panel to have a button for selecting a
Pattern, Rotation, Shape or Texture.
• Improved - The Brush O Matic brush in the Art Pro - Design ArtSet has been updated for
better pattern handling.
• Fixed - When selecting and canceling a brush effect type in the Brush Effects panel for an
effect that has brush control settings do not lose the brush control settings.
• Fixed - The Saturation brush effects where not correct when saturation was set as full.
• Fixed - The Contrast Mask filter and other other filters that rely on it could crash at some
very specific image sizes.
• Fixed - With certain special brush types selected were selected the Filters dialog would not
work properly to beyond the first preview.

18.09

• Added - Graphite filter added to the Artist category.

• Added - Drawn filter added to the Artist category.
• Added - Edge 6 filter added to the Stylized category.
• Added - Skin Enhance filter added to the Photo category.
• Added - Tone filter added to the Color category.
• Added - Contrast Luminance Map filter added to the Brightness and Contrast category.
• Added - Contrast Overload filter added to the Brightness and Contrast category.
• Added - Contrast Soft Light filter added to the Brightness and Contrast category.
• Improved - The various Hue and Saturation brush effects have been updated to give more
controlled results, especially when used in combination with each other and the Luminance
brush effect.

TwistedBrush Pro Studio Reference Manual Page 34

 • Improved - The Combo and Global brush envelopes now are mapped to the full range of
values. Previous percentages of 0 to 99 were available. The percentages 0 to 100 are now
properly available (in increments of slightly more then 1%).
• Improved - The various controls sliders, lists etc in the Filter dialog box have been
improvement to be more accurate.
• Improved - The Clear Page and Fill Page features are now called Clear Layer and Fill Layer
and have been moved to the Edit menu.
• Changed - Adjusted the default value for the Histogram Stretch filter to be that of a value of
more common usability.
• Fixed - The buffers in Lua filter scripts were not being cleared properly which could result in
a crash or old image data being present in a filter.
• Fixed - Lua Integrated filters were not showing the additional information area properly.

18.08

• Added - Zoom Fit has been added to the Quick Command feature.
• Added - Brush effect Luminance added.
• Improved - Added some additional common PPI sizes for the Page Size dialog. Including 100,
110, 120, 180, 240, 400 and 500. These are in addition to the sizes that were already
available.
• Improved - The random frame solutions now can be used on any layer without the need to
flatten the image.
• Improved - The history palette is now shown as an 8x8 grid of colors rather than 16x16. This
makes it much easier to find a select a specific previously used color.
• Changed - The default values for the Alpha Edge Color filter have been updated.
• Fixed - Allow for more space for the text "Select the position of current image on the new
page." on the Set Page Size dialog.
• Fixed - Deleting pages in the Page Explorer would not properly clear the page title.
• Fixed - The Paint Bucket tool in Erase Connected mode could result in a crash.
• Fixed - The Layer Mask layer mixing mode was not appearing properly on screen with many
brushes while a paint stroke was in progress.
• Fixed - Lua function print_buffer_clear() had an issue that could lead to stability problems in
scripts that use it.
• Fixed - Don't display the layer transparency warning during script playback when layers are
moved to and from the background.

18.07

• Added - ArtSet Art Pro Large Format added. Brushed designed for huge brush sizes.
• Added - A Rule of Thirds Grid option has been added to the Crop tool.
• Added - Alpha Edge Color filter added to the Color category.
• Improved - When Entering a name for a Combo palette check for user supplied prefix of
"Combo - " and remove it from the name otherwise that prefix will be duplicated.
• Improved - Significant improvement in the automatic disposal of Undo steps when memory
is low at the time the memory is needed!
• Improved - Undo memory was not being freed as soon as it could be resulting in some
actions failing if memory was low.

TwistedBrush Pro Studio Reference Manual Page 35

 • Improved - When using the Save Base Palette pop-up menu option if the palette file exists
present a overwrite confirm dialog.
• Improved - Pressing the space bar while using any of the rectangle or ellipse based tools will
hide the coordinate information box.
• Improved - Don't allow pasting into an invisible layer.
• Improved - Don't allow loading from file into an invisible layer.
• Fixed - Eraser brushes on layer 1 (background layer) were not honoring masks.

18.06

• Added - Pro Pen Fine Line brush added to the Art Pro - Natural Media ArtSet.
• Added - Pro Soft Pastel 2 and Pro Oil Paint 3 brushes added to the Art Pro - Natural Media
ArtSet.
• Added - Swap with Current Color pop-up menu added to the current selected color bar.
• Improved - When loading a page, default zoom level will now be to fit the page into the
viewable area. Previously it was always at the 100% zoom level.
• Improved - Pressing and holding the Alt key with Lasso Mask tool will constrain the next
segment to a line.
• Improved - When using the Search feature of the Brush Select dialog the Brush Category,
Brush Variation and Effect Envelope fields will also be searched.
• Improved - When using the Search feature of the Brush Select dialog the currently selected
brush if part of the search result set will appear with a yellow background to make known
that it is part of the search results.
• Fixed - The Polygon Mask tool was not canceling when selecting a different tool.
• Fixed - The Palette menu commands, Create 1 Color Span, Create 2 Color Span, Create 3
Color Span, Create 4 Color Span, Create Hue Span From Current Color, Create From Image
(Spot) and Create From Image (Average) were not working properly with Combo Palettes.
• Fixed - The Layer Panel, Clips Panel and Page View Panel were not honoring the Dialog
Visible Adjust option when it was disabled.
• Fixed - The Polygon Mask was not accurately allowing the placement of the end point of a
segment.
• Fixed - In the Filter dialog when doing adjustments for Lua based filters with a mask present
the canvas was updating too frequently resulting in a flicker.
• Fixed - Lua Script filter list in the Filter dialog could not be navigated with the up and down
arrow keys.
• Fixed - The gussy filter with a Blur value of 0 was not working.

18.05

• Added - New palette type added - Combo. This palette type will allow for easily selecting and
saving all four colors from the color bar!
• Added - Additional pop-up menu options for palettes. New Palette, New Combo Palette,
Save Base Palette and Clear Palette.
• Added - New default palette added in P3 position. Combo - Default 16.
• Added - Three new scribbler brushes. Pro Nu 4 Color Scribbler 1, Pro Nu 4 Color Scribbler 2
and Pro Nu 4 Color Scribbler 3,
• Improved - The default Elevation value for the Emboss2 filter has been adjusted to a more
usable value.

TwistedBrush Pro Studio Reference Manual Page 36

 • Improved - Added Save Restore Point and Revert to Store Point to the Quick Command
panel.
• Improved - All pop-up menus have a Cancel option added. Additionally some pop-up menus
have been rearranged to make more common choices easier to select.
• Improved - The Pro Nu Sketched Scribbler 2 and Pro Nu Sketched Scribbler 3 have been
updated to be usable with the currently selected color.
• Fixed - One step undo was not working after a Revert to Restore Point action.
• Fixed - It was not possible to delete a book name.

18.04

• Improved - The Apply and Continue feature was added back to the Filter Dialog.
• Improved - Exit the special layers (Paper, Scratch and Mask Edit) when restore points are
stored.
• Improved - When moving a layer with transparency into the background layer present a
warning message and choice if this action should be continued since the transparency will
be lost.
• Fixed - Using the filter preview area on a special layer (Paper, Scratch and Mask Edit) was not
working.
• Fixed - Don't auto save when special layers (Paper, Scratch and Mask Edit) are active.
• Fixed - Undo was not working properly with special layers. This change will disable the undo
system while working on special layers. This may be enhanced in the future to fully support
undo within the special layers.

18.03

• Added - Standard Banner Ad sizes added to the Set Page Size dialog.
• Added - Mirror Filter added.
• Improved - For the special layers (Paper, Scratch and Mask Edit). Don't allow transparency.
• Improved - For the special layers (Paper, Scratch and Mask Edit). Don't allow layer actions,
layer up, layer down, merge or duplicates.
• Improved - For the special layers (Paper, Scratch and Mask Edit). Don't allow Blob and Liquid
brushes.
• Improved - When using the Paper Select dialog show the special Paper layer as selected for a
visual cue.
• Improved - Clicking on an active special layer (Paper, Scratch and Mask Edit) in the Layer Mini
bar will now toggle it off rather than do nothing.
• Improved - Select a special layer (Paper, Scratch and Mask Edit) from the Layers panel will
now activate the special layer.
• Changed - Don't give a warning message when using the Paper Select dialog about the layer
being deleted.
• Fixed - Zoom levels were not being properly preserved when switching to and from the
scratch layer.
• Fixed - Background Removal solutions were allowed to run on the background layer when
they shouldn't. This could result in a crash.
• Fixed - When setting a new page size the special layers (Paper, Scratch and Mask Edit) new
area were not properly initialized.

18.02

TwistedBrush Pro Studio Reference Manual Page 37

 • Fixed - Using the Page Exploring when the special layer (Paper, Scratch or Mask) was
selected could result in a crash.
• Fixed - The Paper Select dialog was creating the paper layer at the wrong layer location.

18.01

• Fixed - The eraser brushes were not working.

18.00

• Added - A new Polygon Mask tool has been added.

• Added - A new Lasso Mask tool has been added.
• Added - The Filter dialog now includes an option to select a rectangle area for previews. This
is useful for very large pages.
• Added - The Lua filter scripts now support a variant slider type. This allows for a greater
range of values.
• Added - New preference, Dialog Visible Adjustment. Allows during off the automatic
movement of dialog boxes and panels. Useful for those with duel monitors.
• Added - Special Layer added. Mask Edit Layer allows quick and easy highly refined mask
editing.
• Added - The three special layers (30, 31, and 32) now are shown with icons. P - Paper Layer, S
- Scratch Layer, M - Mask Layer. Selecting one of these special layers from the layer mini bar
will immediately enter the edit mode for that special layer.
• Added - Brush Code Import and Brush Code Export menus added to the Brush Shortcut
pop-up menu.
• Improved - The Rectangle Mask tool now includes options for Replace, Add, and Subtract as
well as an inverted rectangle option.
• Improved - The Ellipse Mask tool now includes options for Replace, Add, and Subtract as well
as an inverted ellipse option.
• Improved - Scratch Layer: Editing mode of the scratch layer is now persistent so that it is no
longer required to hold the A key to remain on the scratch layer.
• Improved - Scratch Layer: Textual indicator at the top of the page when editing the scratch
layer was added.
• Improved - Scratch Layer: Switching to and from the scratch layer can now be done view the
A key, layer menu, or Quick Command button.
• Improved - Scratch Layer: When exiting the scratch layer a Reference Image titled Scratch
Layer Reference is automatically created / updated! Allows for easy color selections.
• Improved - Scratch Layer: The scratch layer's zoom and page position is remembered the
next time you go to edit the scratch layer.
• Improved - Scratch Layer: The scratch layer is automatically named Scratch layer.
• Improved - Scratch Layer: The visibility of the scratch layer is now always turned off when
exiting the scratch layer.
• Improved - Scratch Layer: When creating the scratch layer via toggling into the scratch layer
edit mode the layer is automatically filled with fully opaque white. If desired the layer can be
cleared for transparency.
• Improved - The Frame Maker filter now allows for a much great range of variations.
• Improved - The Quick Command panel buttons are now color coded to make it easier to
quick find the desired button.

TwistedBrush Pro Studio Reference Manual Page 38

 • Improved - The Layer Panel Launcher has been replaced with a more general Panel
Launcher. This is the little bar that appears under the color palette area.
• Improved - The Paper Layer (previously called Texture Layer) now can more easily be
manually edited in addition to the paper select dialog.
• Improved - Non-blending brushes work more logically with soft mask edges.
• Improved - Up to 256 layers can now be created. This is increased from the previous
maximum of 32 layers.
• Improved - In the Layers panel the Click to Create Layer text now includes the layer number
for reference.
• Changed - The Filter dialog no longer supports the Apply and Continue option.
• Changed - Hot keys for changing pages in a book are now Page Up and Page Down keys
instead of the Left and Right arrow keys.
• Removed - The Unmask Grid Cell tool has been removed.
• Removed - The menu Mask > Mask Filter has been removed since it is now easier and more
powerful to use the special Mask Edit layer.
• Removed - The menu Layer > Set Scratch Layer has been remove. The scratch layer will
always be at layer position 31.
• Removed - Removed the hot keys Up and Down arrows for changing books. It was too easy
to accidentally press these.
• Fixed - The Quick Command panel was not always properly sized.
• Fixed - The Move tool was not working correctly when ESC was used to cancel the Move
action.
• Fixed - Don't remove the Scratch Layer when flattening a page.

TwistedBrush Pro Studio Reference Manual Page 39

Version 17
17.28 - Available Now

• Added - New advanced filters Cartoon, Painted and Illustrated added to the Artistic filter
category.
• Added - New advanced filter Frame Maker added to the Generate filter category.
• Added - Buffer commands added to the Lua Filter scripts in the paint category. Up to 32
buffers can be used. New commands include paint_buffer_from_layer, paint_buffer_to_layer,
paint_buffer_copy, paint_buffer_clear, paint_buffer_merge_layer, paint_mask_to_buffer,
paint_mask_from_buffer. This is very powerful addition.
• Added - Numerous commands add to the Lua Filter scripts in the paint category.
paint_flip_horizontal, paint_flip_vertical, paint_clear_page, paint_fill_page, paint_mask_on,
paint_mask_clear, paint_mask_invert, paint_create_from_mask,
paint_alpha_create_from_mask, paint_mask_create_from_image,
paint_mask_create_from_image_luma, paint_mask_create_from_alpha, paint_flood_fill,
paint_rectangle, paint_ellipse, paint_text, paint_gradient, paint_mask_ellipse,
paint_mask_rectangle, paint_mask_wand, paint_copy, paint_paste, paint_warp,
paint_rotate_brush
• Improved - The Edge4 and Edge5 filters have been improved with new options.
• Improved - Indicate "Density not used for this brush" when appropriate.
• Improved - Constrain the Line tool to make horizontal or vertical lines with the shift key.
• Changed - Shortcut keys Ctrl + F1 - Ctrl + F12 no longer activate the quick command buttons.
• Fixed - When using the Copy to Shortcut feature in the ArtSet Editor dialog the current brush
was not being update for the new ArtSet.
• Fixed - Added the layer merge types HSL_HUE, HSL_SAT, HSL_LUM and HSL_COLOR to Lua
scripting.
• Fixed - The Tile X and Tile Y brush effects were placing dabs incorrectly. This was broken in
release 17.25 and impacted the Seamless brushes and many other brushes that use the
Tile_X and Tile_Y brush effects.

17.27

• Added - Option to create a reference image from a Clip was added. Located in the pop-up
menu on the clip panel.
• Added - The Paste tool now supports Transform Size and Transform Rotate modes. Allow
isolated transformations of size or rotation.
• Added - The Paste tool now has a Centered option to place the pasted image into the center
of the page.
• Added - New filter added. Adjust RGBA in the Color category.
• Added - Two new Edge filters added. Edge4 and Edge5. Very fine edge filters in the Stylize
filter category.
• Improvement - The Paste tool now supports rotation precision to 100th of a degree!
• Improvement - The Glow filter now includes a Burn option for a more intense effect.
• Changed - The Paste tool Transform Mode is now call Transform Size and Rotate.

17.26

TwistedBrush Pro Studio Reference Manual Page 40

 • Improvement - Hide the Density slider when a brush is selected that does not make use of
the density values.
• Change - The Pro HSL Sat brush is changed to not save the color information.
• Fixed - Smooth Felt Brush in the Markers ArtSet was not working properly.
• Fixed - The Surface Blur and Noise Reduction 2 filters were not working in 17.25. Additionally
many solutions use those filters and therefore didn't work also.

17.25

• Added - New ArtSet added. Art Pro - Scribblers with a total of 11 brushes.
• Added - 4 new layer mix modes. HSL Hue, HSL, Sat, HSL Lum and HSL Color
• Added - 4 new brush effects. Lay HSL Hue, Lay HSL Sat, Lay HSL Lum and Lay HSL Color.
• Added - 4 new brushes added to the Art Pro - Photo Edit ArtSet. Pro HSL Colorize, Pro HSL
Hue, Pro HSL Sat and Pro HSL Lum.
• Added - A new brush was added to the Art Pro - Natural Media ArtSet. Pro Pen Sketch.
• Added - A new option was added to hide the circle cursor when the precision cursor is
active.
• Added - A new brush effect added Fill. Fills the page evenly with dabs.
• Added - Pro Clip Fill brush added to the Art Pro - Clips ArtSet.
• Added - Pro Image Brush Fill brush added to the Art Pro - Image Brush ArtSet.
• Added - Pro Image Shape Fill brush added to the Art Pro - Image Shape ArtSet.
• Added - Horizontal Flip and Vertical Flip options added to the Clip Panel. Access from the
right click pop-up menu.
• Changed - The scribbler brushes have been moved from the Art Pro - Nu Media ArtSet to the
new Art Pro - Scribblers ArtSet.
• Improved - The Art Pro - Natural Media, Pro Artist Pen has been improved with smoother
edges.
• Improved - Most clip brushes have received a significant performance improvement.
• Improved - Camera RAW file reading improvements.
• Fixed - Art Tools - Pens, Velvety Smooth Pen, Thick Smooth Pen, Flowing Pen 3 and Flowing
Pen 4 were not working properly.
• Fixed - The Tile X and Tile Y brush effects were not always properly distributing the dabs on
the page.

17.24

• Added - 3 Scribbler brushes added Pro Nu Scribbler 1, Pro Nu Scribbler 2 and Pro Nu
Scribbler 3. Found in the Pro Nu Media ArtSet.
• Added - The options for Horizontal Flip and Vertical Flip to the Quick Command panel.
• Added - Added brush effects Scribbler 1, Scribbler 2, Scribbler 3 and Scribbler 4.
• Improved - Don't automatically stop Time-Lapse Recording when switching pages or
changing page sizes. However, recording will only resume when the page size matches the
original page size used when the recording started.
• Improved - Added controls (buttons) to the Time-Lapse Recording dialog to allow manually
forcing frames to record in 1, 5, 10 and 20 frame groups.