{
        "$schema": "http://json-schema.org/draft-07/schema",
        "$id": "https://raw.githubusercontent.com/Slicer/Slicer/main/Modules/Loadable/Markups/Resources/Schema/markups-v1.0.0-schema.json#",
        "type": "object",
        "title": "Schema for storing one or more markups",
        "description": "Stores points, lines, curves, etc.",
        "required": ["@schema", "markups"],
        "additionalProperties": true,
        "properties": {
            "@schema": {
                "$id": "#schema",
                "type": "string",
                "title": "Schema",
                "description": "URL of versioned schema."
            },
            "markups": {
                "$id": "#markups",
                "type": "array",
                "title": "Markups",
                "description": "Stores position and display properties of one or more markups.",
                "additionalItems": true,
                "items": {
                    "$id": "#markupItems",
                    "anyOf": [
                        {
                            "$id": "#markup",
                            "type": "object",
                            "title": "Markup",
                            "description": "Stores a single markup.",
                            "default": {},
                            "required": ["type"],
                            "additionalProperties": true,
                            "properties": {
                                "type": {
                                    "$id": "#markup/type",
                                    "type": "string",
                                    "title": "Basic type",
                                    "enum": ["Fiducial", "Line", "Angle", "Curve", "ClosedCurve", "Plane"]
                                },
                                "name": {
                                    "$id": "#markup/name",
                                    "type": "string",
                                    "title": "Name",
                                    "description": "Displayed name of the markup.",
                                    "default": ""
                                },
                                "coordinateSystem": {
                                    "$id": "#markup/coordinateSystem",
                                    "type": "string",
                                    "title": "The coordinateSystem schema",
                                    "description": "An explanation about the purpose of this instance.",
                                    "default": "LPS",
                                    "enum": ["LPS", "RAS"]
                                },
                                "locked": {
                                    "$id": "#markup/locked",
                                    "type": "boolean",
                                    "title": "Locked",
                                    "description": "Markup can be interacted with on the user interface.",
                                    "default": true
                                },
                                "labelFormat": {
                                    "$id": "#markup/labelFormat",
                                    "type": "string",
                                    "title": "Label format",
                                    "description": "Format of generation new labels. %N refers to node name, %d refers to point index.",
                                    "default": "%N-%d"
                                },
                                "controlPoints": {
                                    "$id": "#markup/controlPoints",
                                    "type": "array",
                                    "title": "Control points",
                                    "description": "Stores all control points of this markup.",
                                    "default": [],
                                    "additionalItems": true,
                                    "items": {
                                        "$id": "#markup/controlPointItems",
                                        "anyOf": [
                                            {
                                                "$id": "#markup/controlPoint",
                                                "type": "object",
                                                "title": "The first anyOf schema",
                                                "description": "An explanation about the purpose of this instance.",
                                                "default": {},
                                                "required": [],
                                                "additionalProperties": true,
                                                "properties": {
                                                    "id": {
                                                        "$id": "#markup/controlPoint/id",
                                                        "type": "string",
                                                        "title": "Control point ID",
                                                        "description": "Identifier of the control point within this markup",
                                                        "default": "",
                                                        "examples": ["2", "5"]
                                                    },
                                                    "label": {
                                                        "$id": "#markup/controlPoint/label",
                                                        "type": "string",
                                                        "title": "Control point label",
                                                        "description": "Label displayed next to the control point.",
                                                        "default": "",
                                                        "examples": ["F_1"]
                                                    },
                                                    "description": {
                                                        "$id": "#markup/controlPoint/description",
                                                        "type": "string",
                                                        "title": "Control point description",
                                                        "description": "Details about the control point.",
                                                        "default": ""
                                                    },
                                                    "associatedNodeID": {
                                                        "$id": "#markup/controlPoint/associatedNodeID",
                                                        "type": "string",
                                                        "title": "Associated node ID",
                                                        "description": "ID of the node where this markups is defined on.",
                                                        "default": "",
                                                        "examples": ["vtkMRMLModelNode1"]
                                                    },
                                                    "position": {
                                                        "$id": "#markup/controlPoint/position",
                                                        "type": "array",
                                                        "title": "Control point position",
                                                        "description": "Tuple of 3 defined in the specified coordinate system.",
                                                        "examples": [[-9.9, 1.1, 12.3]],
                                                        "additionalItems": false,
                                                        "items": { "type": "number" },
                                                        "minItems": 3,
                                                        "maxItems": 3
                                                    },
                                                    "orientation": {
                                                        "$id": "#markup/controlPoint/orientation",
                                                        "type": "array",
                                                        "title": "Control point orientation",
                                                        "description": "3x3 orientation matrix",
                                                        "examples": [[1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0 ]],
                                                        "additionalItems": false,
                                                        "items": {"type": "number"},
                                                        "minItems": 9,
                                                        "maxItems": 9
                                                    },
                                                    "selected": {
                                                        "$id": "#markup/controlPoint/selected",
                                                        "type": "boolean",
                                                        "title": "Control point is selected",
                                                        "description": "Specifies if the control point is selected or unselected.",
                                                        "default": true
                                                    },
                                                    "locked": {
                                                        "$id": "#markup/controlPoint/locked",
                                                        "type": "boolean",
                                                        "title": "Control point locked",
                                                        "description": "Control point cannot be moved on the user interface.",
                                                        "default": false
                                                    },
                                                    "visibility": {
                                                        "$id": "#markup/controlPoint/visibility",
                                                        "type": "boolean",
                                                        "title": "The visibility schema",
                                                        "description": "An explanation about the purpose of this instance.",
                                                        "default": true
                                                    },
                                                    "positionStatus": {
                                                        "$id": "#markup/controlPoint/positionStatus",
                                                        "type": "string",
                                                        "title": "The positionStatus schema",
                                                        "description": "An explanation about the purpose of this instance.",
                                                        "enum": ["undefined", "preview", "defined"],
                                                        "default": "defined"
                                                    }
                                                }
                                            }
                                        ]
                                    }
                                },
                                "display": {
                                    "$id": "#display",
                                    "type": "object",
                                    "title": "The display schema",
                                    "description": "An explanation about the purpose of this instance.",
                                    "default": {},
                                    "required": [],
                                    "additionalProperties": true,
                                    "properties": {
                                        "visibility": {
                                            "$id": "#display/visibility",
                                            "type": "boolean",
                                            "title": "Markup visibility",
                                            "description": "Visibility of the entire markup.",
                                            "default": true
                                        },
                                        "opacity": {
                                            "$id": "#display/opacity",
                                            "type": "number",
                                            "title": "Markup opacity",
                                            "description": "Overall opacity of the markup.",
                                            "minimum": 0.0,
                                            "maximum": 1.0,
                                            "default": 1.0
                                        },
                                        "color": {
                                            "$id": "#display/color",
                                            "type": "array",
                                            "title": "Markup color",
                                            "description": "Overall RGB color of the markup.",
                                            "default": [0.4, 1.0, 1.0],
                                            "additionalItems": false,
                                            "items": {"type": "number", "minimum": 0.0, "maximum": 1.0},
                                            "minItems": 3,
                                            "maxItems": 3
                                        },
                                        "selectedColor": {
                                            "$id": "#display/selectedColor",
                                            "title": "Markup selected color",
                                            "description": "Overall RGB color of selected points in the markup.",
                                            "default": [1.0, 0.5, 0.5],
                                            "additionalItems": false,
                                            "items": {"type": "number", "minimum": 0.0, "maximum": 1.0},
                                            "minItems": 3,
                                            "maxItems": 3
                                        },
                                        "activeColor": {
                                            "$id": "#display/activeColor",
                                            "title": "Markup active color",
                                            "description": "Overall RGB color of active points in the markup.",
                                            "default": [0.4, 1.0, 0.0],
                                            "additionalItems": false,
                                            "items": {"type": "number", "minimum": 0.0, "maximum": 1.0},
                                            "minItems": 3,
                                            "maxItems": 3
                                        },
                                        "propertiesLabelVisibility": {
                                            "$id": "#display/propertiesLabelVisibility",
                                            "type": "boolean",
                                            "title": "Properties label visibility",
                                            "description": "Visibility of the label that shows basic properties.",
                                            "default": false
                                        },
                                        "pointLabelsVisibility": {
                                            "$id": "#display/pointLabelsVisibility",
                                            "type": "boolean",
                                            "title": "Point labels visibility",
                                            "description": "Visibility of control point labels.",
                                            "default": false
                                        },
                                        "textScale": {
                                            "$id": "#display/textScale",
                                            "type": "number",
                                            "title": "Markup overall text scale",
                                            "description": "Size of displayed text as percentage of window size.",
                                            "default": 3.0,
                                            "minimum": 0.0
                                        },
                                        "glyphType": {
                                            "$id": "#display/glyphType",
                                            "type": "string",
                                            "title": "The glyphType schema",
                                            "description": "An explanation about the purpose of this instance.",
                                            "default": "Sphere3D",
                                            "enum": ["Vertex2D", "Dash2D", "Cross2D", "ThickCross2D", "Triangle2D", "Square2D",
                                                "Circle2D", "Diamond2D", "Arrow2D", "ThickArrow2D", "HookedArrow2D", "StarBurst2D",
                                                "Sphere3D", "Diamond3D"]
                                        },
                                        "glyphScale": {
                                            "$id": "#display/glyphScale",
                                            "type": "number",
                                            "title": "Point glyph scale",
                                            "description": "Glyph size as percentage of window size.",
                                            "default": 1.0,
                                            "minimum": 0.0
                                        },
                                        "glyphSize": {
                                            "$id": "#display/glyphSize",
                                            "type": "number",
                                            "title": "Point glyph size",
                                            "description": "Absolute glyph size.",
                                            "default": 5.0,
                                            "minimum": 0.0
                                        },
                                        "useGlyphScale": {
                                            "$id": "#display/useGlyphScale",
                                            "type": "boolean",
                                            "title": "Use glyph scale",
                                            "description": "Use relative glyph scale.",
                                            "default": true
                                        },
                                        "sliceProjection": {
                                            "$id": "#display/sliceProjection",
                                            "type": "boolean",
                                            "title": "Slice projection",
                                            "description": "Enable project markups to slice views.",
                                            "default": false
                                        },
                                        "sliceProjectionUseFiducialColor": {
                                            "$id": "#display/sliceProjectionUseFiducialColor",
                                            "type": "boolean",
                                            "title": "Use fiducial color for slice projection",
                                            "description": "Choose between projection color or fiducial color for projections.",
                                            "default": true
                                        },
                                        "sliceProjectionOutlinedBehindSlicePlane": {
                                            "$id": "#display/sliceProjectionOutlinedBehindSlicePlane",
                                            "type": "boolean",
                                            "title": "Display slice projection as outline",
                                            "description": "Display slice projection as outline if behind slice plane.",
                                            "default": false
                                        },
                                        "sliceProjectionColor": {
                                            "$id": "#display/sliceProjectionColor",
                                            "type": "array",
                                            "title": "Slice projection color",
                                            "description": "Overall RGB color for displaying projection.",
                                            "default": [1.0, 1.0, 1.0],
                                            "additionalItems": false,
                                            "items": {"type": "number", "minimum": 0.0, "maximum": 1.0},
                                            "minItems": 3,
                                            "maxItems": 3
                                        },
                                        "sliceProjectionOpacity": {
                                            "$id": "#display/sliceProjectionOpacity",
                                            "type": "number",
                                            "title": "Slice projection opacity",
                                            "description": "Overall opacity of markup slice projection.",
                                            "minimum": 0.0,
                                            "maximum": 1.0,
                                            "default": 0.6
                                        },
                                        "lineThickness": {
                                            "$id": "#display/lineThickness",
                                            "type": "number",
                                            "title": "Line thickness",
                                            "description": "Line thickness relative to markup size.",
                                            "default": 0.2,
                                            "minimum": 0.0
                                        },
                                        "lineColorFadingStart": {
                                            "$id": "#display/lineColorFadingStart",
                                            "type": "number",
                                            "title": "Line color fading start",
                                            "description": "Distance where line starts to fade out.",
                                            "default": 1.0,
                                            "minimum": 0.0
                                        },
                                        "lineColorFadingEnd": {
                                            "$id": "#display/lineColorFadingEnd",
                                            "type": "number",
                                            "title": "Line color fading end",
                                            "description": "Distance where line fades out completely.",
                                            "default": 10.0,
                                            "minimum": 0.0
                                        },
                                        "lineColorFadingSaturation": {
                                            "$id": "#display/lineColorFadingSaturation",
                                            "type": "number",
                                            "title": "Color fading saturation",
                                            "description": "Amount of color saturation change as the line fades out.",
                                            "default": 1.0
                                        },
                                        "lineColorFadingHueOffset": {
                                            "$id": "#display/lineColorFadingHueOffset",
                                            "type": "number",
                                            "title": "Color fadue hue offset",
                                            "description": "Change in color hue as the line fades out.",
                                            "default": 0.0
                                        },
                                        "handlesInteractive": {
                                            "$id": "#display/handlesInteractive",
                                            "type": "boolean",
                                            "title": "Handles interactive",
                                            "description": "Show interactive handles to transform this markup.",
                                            "default": false
                                        },
                                        "snapMode": {
                                            "$id": "#display/snapMode",
                                            "type": "string",
                                            "title": "Snap mode",
                                            "description": "How control points can be defined and moved.",
                                            "default": "toVisibleSurface",
                                            "enum": ["unconstrained", "toVisibleSurface"]
                                        }
                                    }
                                }
                            }
                        }
                    ]
                }
            }
        }
    }