Docs Reference

Tool options reference

Every option in the Tool Options bar, tool by tool, with its range, its default and whether it is remembered between sessions.

The Tool Options bar sits under the menu bar and changes with the active tool. It is a fixed-height strip: it does not resize or dock elsewhere. When a tool has more options than the window is wide enough to hold, what does not fit moves into a menu at the end of the bar, dropping out from the right, and comes back out the moment there is room for it again.

Every bar follows the same shape. Values you adjust while working sit out in the open as compact boxes, each one sized to the number it has to show rather than to a fixed width, so a two-digit field is not as wide as a six-character one. Toggles are icon squares with their names in the tooltip. Related controls are grouped between thin dividers, and an amount always sits with the buttons that use it.

What does not fit goes into that menu, and nothing else does. There is no curated drawer of set-once settings: on a wide enough window every option a tool has is out on the bar, and the chevron does not appear at all. Its tooltip counts what is hidden behind it, so you can tell at a glance whether anything is out of sight.

Options marked Yes in the Remembered column are written to the settings file when you close Celas Studio and come back on the next launch. The brush Size, Opacity and Flow belong to the brush preset instead, and travel with the brush set. See Settings persistence for the full picture.

The Tool Options bar with the Brush tool active, showing the tip swatch, the preset combo, Size, Opacity, Flow, Streamline and Smooth, and the More options chevron.

With a Shape layer selected, the Move, Pen, Node, Brush, Pencil and shape tool bars also carry the layer's fill and stroke swatches and its stroke width, so a quick restyle needs no trip to the Properties panel. See Fill and stroke.

Move

OptionRangeDefaultRemembered
Auto SelectOn / offOnYes
Sub LayerOn / offOnYes
Lock ChildrenOn / offOffYes
Motion Path (Animate mode)On / offOnYes. Greyed out in Edit mode

Sub Layer only appears while Auto Select is on. The bar also carries the four boolean operations: Union, Subtract, Intersect and XOR. With two or more layers selected they build a boolean group from the selection; with one piece of a boolean group selected they set that piece's own operation; with neither they are greyed out rather than hidden, so the row never reflows as you click around. With the group itself selected the four give way to a single Boolean switch. Blend Radius, Elasticity and Blend Colors join them whenever a boolean group or one of its pieces is selected, and a selected piece adds its Blend Weight. See Boolean and liquid shapes.

Transform

OptionRangeDefaultRemembered
ModeFree / Skew / Perspective / Distort / WarpFreeYes
Center PivotOn / offOnYes
SeparatelyOn / offOffYes
Lock ChildrenOn / offOffYes
Show AnchorOn / offOnYes
Motion Path (Animate mode)On / offOnYes. Shared with Move; greyed out in Edit mode
Anti-alias (pixel selection)On / offOnYes. Greyed out in Pixel Mode, where pixels are always placed sharp

While a pixel selection is up on a Raster Cells or Pixel layer, the Move and Transform bars add Anti-alias, Flip Horizontal, Flip Vertical, Apply and Cancel, then W and H as percentages, Rotation, and Skew X from -85 to 85 degrees. The fields grey out once the box is no longer a parallelogram. Center Pivot, Separately, Lock Children and Show Anchor grey out while the pixels own the transform.

Pen

OptionRangeDefaultRemembered
ModePen / Smart / Polygon / LinePenYes
Line Mode (mesh layers)On / offOffYes
Connect / Remove (mesh layers)Connect / RemoveConnectYes
Rubber bandOn / offOnYes
Curve directionOn / offOffYes
Anti-aliasOn / offOnYes. Greyed out on a Shape layer

The mode pill is hidden on a mesh layer, where Line Mode and Connect / Remove take its place. With a shape selected the bar also carries the six curve buttons shared with the Node tool: Split Curve, Break Curve, Close Path, Simplify, Join Curves and Reverse.

Node

OptionRangeDefaultRemembered
ModeSelect / Hide Edge / Line Width / SculptSelectYes
Line width (Line Width mode)0 to 100 px, step 0.1The vertex valueStored in the project
Radius (Sculpt mode)8 to 400 px60 pxYes
Node typeSharp / Smooth / SmartThe vertex valueStored in the project
WeldOn / offOffYes
RadiusOn / offOnYes
Curve directionOn / offOffYes
Selected handles onlyOn / offOffYes
LassoOn / offOffYes
Anti-aliasOn / offOnYes. Greyed out on a Shape layer

To Line and To Curve sit with the curve buttons and act on the segments between two or more selected neighbouring points.

Turning Weld on also forces vertex snapping on while you drag, whatever the toolbar snap button says.

Weld Vertices, Join Curves, Unweld Vertex and Convert to Curves appear only when they apply: two or more selected vertices, two open endpoints, a vertex that already has a weld, and a vertex with a corner radius above zero.

Pencil

OptionRangeDefaultRemembered
Auto CloseOn / offOffYes
Size1 to 100 px2 pxYes
Smooth0.00 to 1.001.00Yes
Stabilize0.00 to 1.000.00Yes
Anti-aliasOn / offOnYes
Stroke brushOff, or a tip with its own spacing, scatter, jitter, count and grainOffYes
Draw IntoNew Layer / Current LayerNew LayerYes
New LayerVector / PixelVectorYes

With a pen, Size is the line width at full pressure, and a lighter touch draws thinner. Anti-alias is one shared setting: changing it here changes it for the Brush, the Pen and the shape tools too. It only affects paint layers. The stroke-brush swatch is on the Pen, Node and Shapes bars as well, and it both draws the next line brushed and converts a shape you already have selected.

Eyedropper, Hand, Rotate View and Zoom

OptionRangeDefaultRemembered
Source (Eyedropper)Screen / All visible / This layerAll visibleYes
Size (Eyedropper)1 px / 3 × 3 / 5 × 5 / 11 × 111 pxYes. Greyed out while Source is Screen

The Eyedropper bar ends with the hint Click: Fill | Shift+Click: Stroke. The Hand, Rotate View and Zoom tools have no options at all, so their bar stays empty.

Gradient

OptionRangeDefaultRemembered
TypeNone / Solid / Linear / Elliptical / Radial / ConicalLinearThe four gradient kinds are; None and Solid are not
TargetFill / Stroke / BothFillYes. Hidden on a bitmap layer
Stop stripUp to 64 stopsTwo stopsThe tool's own stops are, with their colour, noise and mid point
Position (stop popup)0 to 100%Where the stop sitsIn the stops
Opacity (stop popup)0 to 100%The stop's alphaIn the stops
Mid Point (stop popup)0 to 100%50%In the stops
Add Stop / Duplicate / Delete Stop / ReverseButtonsNoneNot applicable
Lock Aspect RatioOn / offOffYes. Shown only on an Elliptical gradient
ExtendPad / Reflect / RepeatPadOn a shape it is saved in the fill; on a bitmap it is tool state and remembered
Opacity (bitmap layers)1 to 100%100%Yes
Dither (bitmap layers)On / offOnYes. Hidden on Solid

None and Solid leave the tool inert, so they deliberately do not survive a restart: coming back to a dead tool with nothing on screen to explain it is worse than losing the setting. Solid also hides the five stop operations and Extend, since two stops locked to the same colour have nothing to reorder or extend.

Picking a type on a shape that has no gradient yet creates one from the stops the strip is showing, and the choice is applied to every editable vector shape in the selection. Switching between kinds keeps the geometry each kind already had rather than resetting the handles. The step is undoable and auto-keys the style channel.

Shape tools

OptionRangeDefaultRemembered
ShapeEighteen shapes, from Rectangle to CloudRectangleThis session only
Width0.50 to 50.002.00Yes
PositionInside / Center / OutsideCenterYes
Each shape's own settingsSee Shape toolsSee Shape toolsYes
Keep SelectedOn / offOnYes
Anti-aliasOn / offOnYes. Greyed out on a Shape layer

With a shape selected, dragging Width or any of the shape's own settings edits that shape and lands as one undo step per drag. With nothing selected they only set the values for the next shape you draw, and are not undoable. The full list of each shape's settings, with ranges and defaults, is on the Shape tools page.

Line

OptionRangeDefaultRemembered
Width0.50 to 50.002.00Yes
Keep SelectedOn / offOnYes
Anti-aliasOn / offOnYes. Decides the edge when the line is painted into a paint layer

Bone

OptionRangeDefaultRemembered
Bone Type (Edit mode)Stretched / StaticStretchedYes
MoveOn / offOffYes
Reparent (Edit mode)On / offOffYes
Snap (Edit mode)On / offOffYes
Motion Path (Animate mode)On / offOnYes
Branch Switch (selected bone)On / off, then a branch listOffStored in the project

Bone Type: Static, Move and Reparent are mutually exclusive: turning one on clears the other two. Snap is independent. Branch Switch appears only when the selected Stretched bone has at least two Stretched child bones, or is already a switch. A grey hint at the end of the bar tells you what a click and a drag will do in the current combination.

Bone Bind

OptionRangeDefaultRemembered
Weight Area0 to 100000, step 2The bone value (100 for a new bone)Stored in the project
Weight PaintOn / offOffYes
Weight / UnweightWeight / UnweightWeightYes
Radius5 to 300 screen px, step 0.540Yes
Strength1 to 100%50%Yes
FalloffLinear / Smooth / HardLinearYes

The bar also carries Bind, Unbind, Auto Weight, Link Layer (which becomes Unlink for a linked layer) and Mirror Weights. Weight Area appears only while a bone is selected, and edits every selected bone at once. The four painting controls appear only while Weight Paint is on; with it off you get the hint Click bone, select vertices, then Bind/Unbind. Every one of these is Edit mode only and shows as unavailable in Animate mode, where posing is what the rig is for.

Camera

OptionRangeDefaultRemembered
Depth of Field0 to 100The camera valueStored in the project
Point of InterestOn / offThe camera valueStored in the project

Depth of Field updates the canvas live and writes a keyframe on release when auto-key is armed; Reset sets it to 0 the same way. There is no zoom slider here: Zoom is set from the Properties panel, and it is keyframeable, with its own timeline track and graph curve. Camera dolly lives on the camera Position Z channel.

Brush and Eraser

OptionRangeDefaultRemembered
PresetThe brush listFirst presetYes
Size1 to 300 (logarithmic)From the presetWith the brush set
Opacity0 to 100%From the presetWith the brush set
Flow0 to 100%From the presetWith the brush set
Blend Mode (Brush only)The 29 brush blend modes, Normal to LuminosityFrom the presetWith the brush set
Streamline0 to 60 px0 pxYes
Smooth0 to 100%20%Yes
Pen PressureOn / offOnYes
Anti-aliasOn / offFrom the presetWith the brush set
EraserOn / offOffYes
SymmetryOff / Horizontal / Vertical / BothOffYes
Draw Into (Brush only)New Layer / Current LayerCurrent LayerYes
New Layer (Brush only)Vector / PixelVectorYes

The Eraser tool shares this bar. Its Eraser toggle is hidden, because erasing is what the tool does, and so are Draw Into and New Layer: an eraser cuts into what is already there and never creates a layer, so both would name a decision the tool does not make. Streamline, Smooth, Pen Pressure and Symmetry are global, so they stay put when you change presets; the rest belong to the brush and travel with it. Hardness and every other preset parameter live in Brush Studio rather than being repeated here. Blend Mode is the one exception: the Brush shows it on this bar too.

Fill

OptionRangeDefaultRemembered
SourceThis layer / Layer above / Layer below / All visibleThis layerYes
Tolerance0 to 100%16%Yes
Expand-16 to 16 px0 pxYes
Gap0 to 64 px0 pxYes
ContiguousOn / offOnYes
Anti-aliasOn / offOffYes
Output (vector targets)Vector / PixelVectorYes
Opacity0 to 100%100%Yes
Blend ModeThe same 29 modes as the brushNormalYes. Greyed out while a vector fill comes out as a shape
Expand modeRectangle / Round / To darkest pixelTo darkest pixelYes
Fill narrow areasOn / offOnYes

With Contiguous off the bucket fills every similar-coloured pixel in the cell, connected or not, and Gap is greyed out while it is off: a fill that ignores connectivity has no edges to bridge. Output only appears on a Shape or Vector Cells layer, where there is a choice to make; a paint layer target cannot hold a shape. Expand mode is live only while Expand is positive, since it governs the shape of the growth.

Marquee and Magic Wand

These two build the same pixel selection, so Mode and the Expand, Inset, Feather, Invert and Deselect block are shared by both bars.

OptionRangeDefaultRemembered
Shape (Marquee only)Rectangle / Ellipse / Polygon / Freehand / BrushRectangleYes
Style (Rectangle and Ellipse)Normal / Fixed Ratio / Fixed SizeNormalYes
W, H (Fixed Ratio)0.01 to 1001, 1Yes
W, H (Fixed Size)1 to 16384 px1 pxYes. The same two fields as Fixed Ratio
Size (Brush)1 to 1000 px40 pxYes
Tolerance (Magic Wand only)0 to 100%16%Yes
Source (Magic Wand only)This layer / All visibleThis layerYes
Contiguous (Magic Wand only)On / offOnYes
Anti-alias (Magic Wand only)On / offOnYes
ModeReplace / Add / Subtract / IntersectReplaceYes
Expand / Inset amount1 to 64 px2 pxYes
Feather amount1 to 64 px4 pxYes

Mode is a dropdown rather than a four-segment pill: the pill cost about four times the width, and the bar has to survive on a small screen without pushing later controls off the end. A dropdown shows one word that is easy to read past, so any mode other than Replace draws an accent line under the control. Subtracting from nothing and intersecting with nothing both leave an empty selection, and a latched mode is the one way these tools can look broken.

Mode is one setting shared by both tools: a combine mode belongs to the selection rather than to one tool, so choosing Add once keeps applying whichever of the two you pick up next. Holding Shift, Alt or Shift+Alt overrides it for a single click or drag.

The amount always sits with the buttons that use it. Expand and Inset flank their shared number, one on each side, so it can only belong to them and the pair reads as one control with two directions; those two are icons rather than words, because flanking a number all they have to carry is direction. Feather has one direction, so its amount follows its button. Invert and Deselect take no amount at all and sit behind their own divider, out of reach of the eye trying to pair a button with the nearest field.

Both amounts are narrow fields you can also scrub by dragging sideways. Only the buttons need a live selection; the amounts stay editable so you can dial them in first.

Expand, Inset, Feather, Invert and Deselect are greyed out until a pixel selection exists. With Shape set to Polygon a hint appears: double-click or Enter closes the outline, Esc cancels it.

Smudge

OptionRangeDefaultRemembered
Mode (Raster Cells or Pixel layer)Smudge / Blur / Sharpen / Dodge / Burn / CloneSmudgeYes
Size (retouch modes)1 to 800 px40 pxYes
Strength (retouch modes)1 to 100%50%Yes
TipRound disc or a brush tipThe preset's own tipIn the preset
Tip Angle0 to 360 degrees0In the preset
Angle Jitter0 to 100%0%In the preset
Scatter0 to 100%0%In the preset
Direction FollowOn / offOffIn the preset
Size, on a Raster Cells or Pixel layer1 to 800 (logarithmic)The preset's own sizeIn the preset
Size, on a Shape or Mesh layer4 to 400 (logarithmic)60Yes
Strength1 to 100%60%Yes
Mix0 to 100%0%In the preset
FalloffLinear / Smooth / HardSmoothYes

Tip, Tip Angle, Angle Jitter, Scatter and Direction Follow live in the tip popup. The popup, along with Size and Mix, is shown only on a Raster Cells or Pixel layer, where the tool runs the brush engine; on vector and mesh artwork it is a plain radius magnet, and Falloff appears there instead. Strength is the one slider both paths share.

Blur, Sharpen, Dodge, Burn and Clone replace the tip popup, Size and Mix with their own Size and Strength, shared by all five. Clone adds the hint Source: Alt+click.

The rows marked "In the preset" are not tool options at all: they read and write the active brush preset, so they follow the preset rather than the tool, and they are saved with the brush library. Each painting tool remembers which preset it had, which is what makes them feel like tool settings.
The Smudge tool tip popup open over the Tool Options bar, showing Tip Angle, Angle Jitter, Scatter and Direction Follow.

Knife

OptionRangeDefaultRemembered
ModeSplit / TrimSplitYes
StrokeLine / FreehandLineYes

Split cuts straight through the shape; Trim cuts only up to the intersections it crosses. On a pixel drawing the knife cuts along the line as well, on any brush, scattered and textured ones included.