Gradients (.fgradient)

Use in the application

The shared gradient editor imports and exports its user catalogue. Choose a preset to change the current gradient. Changing a catalogue entry does not replace gradients already stored in documents.

File structure

UTF-8 JSON with an explicit format tag and version. The current reader and writer use version 1. The example shows the library envelope; the full reference describes the complete value schemas.

Each presets entry has id, name, optional groupPath and gradient. gradient contains interpolation and ordered stops with position, packed ARGB color and optional midpoint. Native files retain the authored gradient values.

{
  "format": "focale-gradient-presets",
  "version": 1,
  "presets": [
    {
      "id": "gradient.user.example",
      "name": "Editorial",
      "groupPath": [
        "Studio"
      ],
      "gradient": {
        "interpolation": "perceptual",
        "stops": [
          {
            "position": 0.0,
            "color": 4279246896,
            "midpoint": 0.4
          },
          {
            "position": 1.0,
            "color": 4292927712
          }
        ]
      }
    }
  ]
}

Validation and limits

Maximum: 16 MiB and 4,096 entries. A gradient has 2–256 strictly ordered stops spanning 0 to 1. Unknown interpolation values, duplicate ids or malformed stops reject the complete file.

Photoshop interchange

GRD is import-only for supported custom solid gradients. Use .fgradient for native backup and exchange; importing a Photoshop file does not guarantee every gradient variant is supported.

Complete format references

Download the full Markdown specifications in English, including schemas, validation rules and compatibility details.

• Download reusable-presets.md