Schemas / Geometry / paint

rig.paint.library

v0.31.0 · draft 1 field 1 required

Fields

FieldTypeMeaning
paints array<entity> required Paint entities in panel order; each carries rig.paint.solid or rig.paint.gradient

Ordered swatch collection. Format when present.

A library answers the question a reader otherwise cannot: which paint entities are the document's swatches, and in what order they should be presented. Without it, shared paints are just entities floating in the scene.

Order is presentation order, nothing more. Membership does not affect rendering - a paint referenced by rig.paint.fill or rig.paint.stroke paints its users whether or not any library lists it.

A document usually has one library entity, but nothing forbids several (per page, per theme). A paint may appear in more than one.

JSON Schema

Resolves at https://rig.works/schemas/rig.paint.library.schema.jsonraw file.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://rig.works/schemas/rig.paint.library.schema.json",
  "title": "rig.paint.library",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "paints": {
      "type": "array",
      "items": {
        "$ref": "./_defs.schema.json#/$defs/entity"
      }
    }
  },
  "required": [
    "paints"
  ]
}