{
    "command": "sgoverlayps",
    "description": "Overlay compatible SIGCLEAR-generated PostScript files or insert PostScript\nannotation snippets at supported page positions. This is not a general-purpose\nPDF/image compositor: input files need SIGCLEAR's expected page markers and\nannotations must be valid PostScript accepted by the base figure.",
    "examples": [
        {
            "command": "sgoverlayps b.ps c.ps <a.ps >abc.ps",
            "expected": "All three files must use compatible SIGCLEAR PostScript content markers.\nInspect the combined pages, axes and clipping; arbitrary PostScript is not guaranteed.",
            "title": "Overlay two SIGCLEAR PostScript files on a base figure"
        },
        {
            "command": "sgoverlayps '796 139 50 10 -130 20 arrow' <a.ps >arrow.ps",
            "expected": "The base file must define the arrow procedure; these are illustrative coordinates.\nQuote the annotation so the shell passes it as one positional argument.",
            "title": "Add an arrow to a SIGCLEAR PostScript figure"
        },
        {
            "command": "sgoverlayps '/Helvetica findfont 10 scalefont setfont' \\\n  '0 0 1 setrgbcolor' '720 80 moveto (SH50202527) show' <a.ps >text.ps",
            "expected": "Annotations are trusted literal PostScript, not shell commands or sanitized text.\nReplace the illustrative label and coordinates and inspect the rendered result.",
            "title": "Add blue Helvetica text to a SIGCLEAR PostScript figure"
        },
        {
            "command": "sgoverlayps '425 225 10 40 rectstroke' '125 225 10 40 rectfill' <a.ps >rectangles.ps",
            "expected": "Rectangle arguments are x, y, width and height in the figure coordinate system.\nVerify placement and clipping on the actual base figure.",
            "title": "Add outlined and filled rectangles to a SIGCLEAR PostScript figure"
        }
    ],
    "input_description": "base PostScript file generated by SIGCLEAR",
    "notes": [],
    "output_description": "output PostScript file",
    "package": "sigclear-plot",
    "parameters": [
        {
            "choices": [],
            "default": "stdin",
            "default_known": false,
            "description": "base PostScript file generated by SIGCLEAR",
            "name": "in",
            "required": false,
            "type": "ifile",
            "units": null
        },
        {
            "choices": [],
            "default": false,
            "default_known": true,
            "description": "retain axes from auxiliary PostScript files",
            "name": "-axis",
            "required": false,
            "type": "bool",
            "units": null
        },
        {
            "choices": [],
            "default": "stdout",
            "default_known": false,
            "description": "output PostScript file",
            "name": "out",
            "required": false,
            "type": "ofile",
            "units": null
        }
    ],
    "related": [],
    "schema_version": 1,
    "summary": "Overlay SIGCLEAR PostScript figures and annotation snippets",
    "synopsis": "sgoverlayps <stdin -axis=false >stdout",
    "version": "1.0.1-2"
}