PaintToolbar
Class: PaintToolbar
Paint tools toolbar panel.
Extends
Component<PaintToolbarProps,PaintToolbarState>
Implements
Accessors
paintLayer
Get Signature
get paintLayer(): IImageLayer;
Gets the paint layer containing the HTML canvas for drawing the image.
Returns
selectedToolKey
Get Signature
get selectedToolKey(): PaintToolType;
Selected tool type.
Returns
foreColor
Get Signature
get foreColor(): Color;
Pencil color.
Returns
Color
penSize
Get Signature
get penSize(): number;
Pencil size.
Returns
number
brushSize
Get Signature
get brushSize(): number;
Brush size.
Returns
number
eraserSize
Get Signature
get eraserSize(): number;
Eraser size.
Returns
number
cloneStampSize
Get Signature
get cloneStampSize(): number;
Clone Stamp size.
Returns
number
fontSize
Get Signature
get fontSize(): number;
Font size.
Returns
number
pencilOpacity
Get Signature
get pencilOpacity(): number;
Pencil opacity.
Returns
number
brushOpacity
Get Signature
get brushOpacity(): number;
Brush opacity.
Returns
number
eraserOpacity
Get Signature
get eraserOpacity(): number;
Eraser opacity.
Returns
number
cloneStampOpacity
Get Signature
get cloneStampOpacity(): number;
Clone Stamp opacity.
Returns
number
fontOpacity
Get Signature
get fontOpacity(): number;
Font opacity.
Returns
number
brushHardness
Get Signature
get brushHardness(): number;
Brush hardness.
Returns
number
eraserHardness
Get Signature
get eraserHardness(): number;
Eraser hardness.
Returns
number
cloneStampHardness
Get Signature
get cloneStampHardness(): number;
Clone Stamp hardness.
Returns
number
fontName
Get Signature
get fontName(): string;
Font name.
Returns
string
fontItalic
Get Signature
get fontItalic(): boolean;
Italic font style.
Returns
boolean
fontBold
Get Signature
get fontBold(): boolean;
Bold font style.
Returns
boolean
maxWidth
Get Signature
get maxWidth(): number;
Max possible crop width.
Returns
number
maxHeight
Get Signature
get maxHeight(): number;
Max possible crop height.
Returns
number
naturalRatio
Get Signature
get naturalRatio(): number;
Natural aspect ratio.
Returns
number
useOriginalImage
Get Signature
get useOriginalImage(): boolean;
Use the original image as source while applying edits.
Returns
boolean
Set Signature
set useOriginalImage(value): void;
Use the original image as source while applying edits.
Parameters
value
boolean
Returns
void
toolSize
Get Signature
get toolSize(): number;
Tool size.
Returns
number
toolHardness
Get Signature
get toolHardness(): number;
Tool hardness.
Returns
number
toolOpacity
Get Signature
get toolOpacity(): number;
Tool opacity.
Returns
number
Methods
showDialog()
static showDialog(paintToolsPlugin): void;
Show toolbar.
Parameters
paintToolsPlugin
Returns
void
getPaintObjectDesigners()
getPaintObjectDesigners(): IPaintObjectDesigner[];
Get a reference to an array with object designers.
Returns
Implementation of
IPaintDesignerContext.getPaintObjectDesigners
removeObjectDesigner()
removeObjectDesigner(id): boolean;
Removes an object designer by its ID and disposes of it.
Parameters
id
string
The ID of the object to remove.
Returns
boolean
True if the object was found and removed, false otherwise.
findObjectDesigner()
findObjectDesigner(id):
| undefined
| IPaintObjectDesigner;
Finds a paint object designer by its unique identifier.
Parameters
id
string
The unique identifier of the paint object designer.
Returns
| undefined
| IPaintObjectDesigner
The matching designer if found, otherwise undefined.
getX()
getX(): number;
Crop x position.
Returns
number
getY()
getY(): number;
Crop y position.
Returns
number
getWidth()
getWidth(): number;
Crop width.
Returns
number
getHeight()
getHeight(): number;
Crop height.
Returns
number
ensurePaintLayerReady()
ensurePaintLayerReady(): Promise<IImageLayer>;
Call this method to create paint layer.
Returns
Promise<IImageLayer>
toggleTool()
toggleTool(toolKey?, checked?): Promise<void>;
Toggle active paint tool.
Parameters
toolKey?
Optional. Tool type.
checked?
boolean
Optional. Checked state.
Returns
Promise<void>
onPaintObjectPropertyChanged()
onPaintObjectPropertyChanged(
propertyName,
val,
dirty?): void;
Called when paint object property changed.
Parameters
propertyName
val
any
dirty?
boolean
Returns
void
show()
show(): void;
Show toolbar.
Returns
void
hide()
hide(): void;
Hide toolbar.
Returns
void
undoPaint()
undoPaint(endIndex?): Promise<void>;
Parameters
endIndex?
number
Optional. End undo index (excluding).
Returns
Promise<void>
componentWillUnmount()
componentWillUnmount(): void;
Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as
cancelled network requests, or cleaning up any DOM elements created in componentDidMount.
Returns
void
Overrides
Component.componentWillUnmount
componentDidMount()
componentDidMount(): void;
Called immediately after a component is mounted. Setting state here will trigger re-rendering.
Returns
void
Overrides
Component.componentDidMount
confirmChanges()
confirmChanges(): Promise<void>;
Called when parent viewer requests confirm and apply changes, usually when the Ctrl+Enter or Enter key is pressed.
Returns
Promise<void>
Implementation of
IViewerTransactionSupport.confirmChanges
cancelChanges()
cancelChanges(): Promise<boolean | void>;
Called when parent viewer requests cancel changes, usually when the ESCAPE key is pressed.
Returns
Promise<boolean | void>
Implementation of
IViewerTransactionSupport.cancelChanges
undoTransactionStep()
undoTransactionStep(): boolean | void;
Undo viewer transaction step. Return true if undo operation is consumed.
Returns
boolean | void
Implementation of
IViewerTransactionSupport.undoTransactionStep
redoTransactionStep()
redoTransactionStep(): boolean | void;
Redo viewer transaction step. Return true if redo operation is consumed.
Returns
boolean | void
Implementation of
IViewerTransactionSupport.redoTransactionStep
downloadCommandStack()
downloadCommandStack(args): Promise<void>;
Serializes and downloads the current command stack as a JSON file. If the browser supports the File System Access API, a native "Save as..." dialog will be used (user can edit the filename). Otherwise the method falls back to creating a Blob and triggering a download via an anchor element (with an optional prompt).
Parameters
args
Options for export. objectsOnly: true will attempt to export only object-related commands.
objectsOnly
boolean
Returns
Promise<void>
Resolves when the download/save operation is initiated or completed.
Throws
When serialization or file writing fails.
importCommandsFromFile()
importCommandsFromFile(): Promise<IPaintCommand[]>;
Opens a file dialog to load commands from a JSON file
Returns
Promise<IPaintCommand[]>
Promise resolving with loaded commands
exportCommands()
exportCommands(commands): string;
Serializes an array of paint commands to a JSON string
Parameters
commands
Array of paint commands to serialize
Returns
string
JSON string representing the command stack
Throws
When invalid commands are provided
importCommands()
importCommands(serializedData): Promise<IPaintCommand[]>;
Deserializes a JSON string to an array of paint commands
Parameters
serializedData
string
JSON string containing serialized commands
Returns
Promise<IPaintCommand[]>
Array of reconstructed paint commands
Throws
When the data cannot be deserialized