{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://dollycut.com/schemas/shotplan.schema.json","title":"Dollycut Shot Plan","description":"Declarative edit + virtual 2D camera plan. Sole input to the renderer besides the source file. See docs/SPEC.md for semantics.","type":"object","required":["version","source","output","segments"],"additionalProperties":false,"properties":{"version":{"const":"0.1"},"source":{"type":"object","required":["file","duration","width","height"],"additionalProperties":false,"properties":{"file":{"type":"string","minLength":1},"duration":{"type":"number","exclusiveMinimum":0,"description":"Seconds"},"width":{"type":"integer","minimum":16},"height":{"type":"integer","minimum":16},"fps":{"type":"number","exclusiveMinimum":0},"hash":{"type":"string","description":"Content hash of the source, for render caching"}}},"output":{"type":"object","required":["aspect","maxDuration"],"additionalProperties":false,"properties":{"aspect":{"type":"string","pattern":"^[1-9][0-9]*:[1-9][0-9]*$","description":"Output aspect ratio, e.g. \"16:9\""},"maxDuration":{"type":"number","exclusiveMinimum":0,"maximum":30},"fps":{"type":"number","exclusiveMinimum":0,"default":30},"profiles":{"type":"array","items":{"enum":["mp4","webm","gif"]},"minItems":1,"uniqueItems":true,"default":["mp4"]},"gifBudgetBytes":{"type":"integer","minimum":1,"default":8388608},"upscaleMax":{"type":"number","minimum":1,"default":1.5}}},"intent":{"type":"string","description":"Intent text the plan was built for. Provenance only."},"segments":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/segment"}}},"$defs":{"segment":{"type":"object","required":["id","tIn","tOut"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"tIn":{"type":"number","minimum":0,"description":"Source-clock start, seconds (inclusive)"},"tOut":{"type":"number","exclusiveMinimum":0,"description":"Source-clock end, seconds (exclusive); must be > tIn"},"speed":{"type":"number","exclusiveMinimum":0,"maximum":8,"default":1.0},"camera":{"type":"array","items":{"$ref":"#/$defs/keyframe"},"description":"Camera keyframes in output time relative to segment start, ascending by t. Empty/absent means full-frame (0.5, 0.5, z=1) throughout."},"why":{"type":"string","description":"Planner provenance. Ignored by the renderer."}}},"keyframe":{"type":"object","required":["t","cx","cy","z"],"additionalProperties":false,"properties":{"t":{"type":"number","minimum":0,"description":"Output-clock seconds from segment start"},"cx":{"type":"number","minimum":0,"maximum":1},"cy":{"type":"number","minimum":0,"maximum":1},"z":{"type":"number","minimum":1,"description":"Zoom factor; upper bound is the profile's readability ceiling (spec §3.5)"},"ease":{"enum":["linear","easeIn","easeOut","easeInOut","hold"],"default":"easeInOut","description":"Easing applied on the interval from this keyframe to the next"}}}}}