> ## Documentation Index
> Fetch the complete documentation index at: https://www.nexrender.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nx:text-params-set

> Comprehensive text layer parameter modification

Comprehensive text customization function that allows you to modify typography, appearance, layout, content, and animation. Perfect for creating dynamic text content with complete control over styling.

## Examples

### Basic text modification

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

### Complete text styling

```json theme={null}
{
  "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

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

## Parameters

### Typography

<ParamField path="font" type="string">
  Font family name
</ParamField>

<ParamField path="fontSize" type="number">
  Font size in points
</ParamField>

<ParamField path="tracking" type="number">
  Letter spacing/tracking value
</ParamField>

### Appearance

<ParamField path="fillColor" type="array | string">
  Fill color in multiple formats:

  * RGB arrays: `[1,1,1]` (0-1 range) or `[255,255,255]` (0-255 range)
  * Hex strings: `#ffffff`
</ParamField>

<ParamField path="strokeColor" type="array | string">
  Stroke color in multiple formats:

  * RGB arrays: `[1,1,1]` (0-1 range) or `[255,255,255]` (0-255 range)
  * Hex strings: `#ffffff`
</ParamField>

<ParamField path="strokeWidth" type="number">
  Width of the text stroke
</ParamField>

<ParamField path="strokeOverFill" type="boolean">
  Whether stroke appears over fill
</ParamField>

<ParamField path="applyStroke" type="boolean">
  Whether to apply stroke to text
</ParamField>

<ParamField path="applyFill" type="boolean">
  Whether to apply fill to text
</ParamField>

### Layout

<ParamField path="justification" type="string">
  Text alignment: 'left', 'right', or 'center'
</ParamField>

<ParamField path="positionValue" type="array">
  \[x, y] position coordinates
</ParamField>

### Content

<ParamField path="layerName" type="string" required>
  Name of the text layer to modify
</ParamField>

<ParamField path="textValue" type="string">
  The actual text content
</ParamField>

<ParamField path="textExpression" type="string">
  After Effects expression for text
</ParamField>

### Animation

<ParamField path="positionExpression" type="string">
  After Effects expression for position
</ParamField>

<ParamField path="scaleExpression" type="string">
  After Effects expression for scale
</ParamField>

<ParamField path="opacityExpression" type="string">
  After Effects expression for opacity
</ParamField>

### Composition

<ParamField path="composition" type="string">
  Name/ID of the composition (optional)
</ParamField>
