@add-on-hlapi-sdk / Node
Class: Node
A Node represents an object in the scenegraph, the document's visual content tree.
Hierarchy
Table of contents
Accessors
- absoluteRotation
- absoluteTransform
- allChildren
- blendMode
- locked
- opacity
- parent
- relativeRotation
- relativeTransform
- translateX
- translateY
- type
Methods
Accessors
absoluteRotation
• get absoluteRotation(): number
The node's absolute (global) rotation angle in degrees – includes any cumulative rotation from the node's parent containers.
Returns
number
• set absoluteRotation(value): void
Parameters
| Name | Type |
|---|---|
value | number |
Returns
void
absoluteTransform
• get absoluteTransform(): mat2d
The node's absolute (global) transform matrix.
Returns
allChildren
• get allChildren(): Readonly<Iterable<Node>>
Returns a read-only list of all children of the node. General-purpose content containers such as ArtboardNode or
GroupNode also provide a mutable children list. Other nodes with a more specific structure can
hold children in various discrete "slots"; this allChildren list includes all such children and reflects their
overall display z-order.
Returns
Readonly<Iterable<Node>>
blendMode
• get blendMode(): BlendModeValue
Blend mode determines how a node is composited onto the content below it. The default value is normal for most nodes, and passThrough for GroupNodes.
Returns
• set blendMode(value): void
Parameters
| Name | Type |
|---|---|
value |
Returns
void
locked
• get locked(): boolean
The node's lock/unlock state. Locked nodes are excluded from the selection (see selection), and cannot be edited by the user unless they are unlocked first.
Returns
boolean
• set locked(locked): void
Parameters
| Name | Type |
|---|---|
locked | boolean |
Returns
void
opacity
• get opacity(): number
The node's opacity, from 0.0 to 1.0
Returns
number
• set opacity(opacity): void
Parameters
| Name | Type |
|---|---|
opacity | number |
Returns
void
parent
• get parent(): undefined | Node
The node's parent. Undefined if the node is an orphan, or if the node is the artwork root.
Returns
undefined | Node
relativeRotation
• get relativeRotation(): number
The node's local rotation value in degrees, relative to its parent's axes. Modifying this value will also adjust the node's x & y translation such that the node's center is in the same location after the rotation – i.e. this setter rotates the node about its bounding box's center, not its origin.
Returns
number
• set relativeRotation(value): void
Parameters
| Name | Type |
|---|---|
value | number |
Returns
void
relativeTransform
• get relativeTransform(): mat2d
The node's transform matrix relative to its parent.
Returns
translateX
• get translateX(): number
The translation of the node along its parent's x-axis.
Returns
number
• set translateX(value): void
Parameters
| Name | Type |
|---|---|
value | number |
Returns
void
translateY
• get translateY(): number
The translation of the node along its parent's y-axis.
Returns
number
• set translateY(value): void
Parameters
| Name | Type |
|---|---|
value | number |
Returns
void
type
• get type(): SceneNodeTypeValueID
The node's type.
Returns
Methods
removeFromParent
▸ removeFromParent(): void
Removes the node from its parent - for a basic ContainerNode, this is equivalent to node.parent.children.remove(node).
For nodes with other slots, removes the child from whichever slot it resides in, if possible. Throws if the slot does
not support removal. Also throws if node is the artwork root. No-op if node is already an orphan.
Returns
void
