nx:text-params-set

Sets the style, content, and transform expressions of a text layer

Changes the typography, colors, content, position, and transform expressions of a text layer. Set only the parameters you want to change. The rest of the layer stays as it is.

​

Examples

​

Basic text modification

{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Title",
    "textValue": "Hello World!",
    "fontSize": 48,
    "fillColor": "#ffffff"
  }
}

​

Complete text styling

{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Styled Text",
    "textValue": "Custom Text",
    "font": "Arial-Black",
    "fontSize": 36,
    "fillColor": [1, 1, 1],
    "strokeColor": [0, 0, 0],
    "strokeWidth": 2,
    "applyStroke": true,
    "justification": "center",
    "tracking": 100
  }
}

​

Text with positioning and expressions

{
  "type": "function",
  "name": "nx:text-params-set",
  "params": {
    "layerName": "Animated Title",
    "textValue": "Dynamic Text",
    "positionValue": [960, 540],
    "scaleExpression": "wiggle(2, 10)",
    "opacityExpression": "Math.sin(time * 2) * 50 + 50"
  }
}

​

Parameters

This function has no composition parameter. It changes text layers named layerName in every composition of the project. The API rejects parameters that are not listed on this page.

Values of 0, false, or an empty string are skipped, so they leave the layer as it is. For example, "applyFill": false does not turn the fill off, and "tracking": 0 does not reset tracking.

​

Typography

font · string

PostScript name of the font, for example Arial-Black

fontSize · number

Font size in points

tracking · number

Letter spacing/tracking value

​

Appearance

fillColor · array | string

Fill color in multiple formats:

• RGB arrays of exactly three numbers: [1,1,1] (0-1 range) or [255,255,255] (0-255 range)
• Hex strings: #ffffff or #fff

strokeColor · array | string

Stroke color in multiple formats:

• RGB arrays of exactly three numbers: [1,1,1] (0-1 range) or [255,255,255] (0-255 range)
• Hex strings: #ffffff or #fff

strokeWidth · number

Width of the text stroke

strokeOverFill · boolean

Whether stroke appears over fill

applyStroke · boolean

Whether to apply stroke to text

applyFill · boolean

Whether to apply fill to text

​

Layout

justification · string

Text alignment: left, right, or center. Other values are rejected.

positionValue · array

[x, y] position coordinates, as exactly two numbers

​

Content

layerName · string | string[] · required

Name of the text layer to modify. Pass an array of names to change several layers.

textValue · string

The actual text content

textExpression · string

After Effects expression for text

​

Animation

positionExpression · string

After Effects expression for position

scaleExpression · string

After Effects expression for scale

opacityExpression · string

After Effects expression for opacity