Reference
스키마 레퍼런스
Comic Strip Document의 모든 필드를 정리한 문서로, 공개된 JSON Schema로부터 생성됩니다.
아래 표는 @toonstrip/schema의 schema.json(draft-07, 전체적으로 additionalProperties: false 적용)으로부터 빌드 시점에 생성됩니다. 필드 이름과 타입, 필수 여부는 스키마에서
가져오며, 한 줄 설명은 이 사이트에서 별도로 관리합니다.
Note
TypeScript 타입은 @toonstrip/schema에서 ComicStripDocument, Panel, Body, Line,
Emotion, CameraPreset, BalloonKind로 내보내집니다. JSON Schema는 TypeScript를 쓰지
않는 생산자를 위한 기계 검증 가능한 원본입니다.
ComicStripDocument
| Field | Type | Required | Description |
|---|---|---|---|
version | 1 | yes | Document format version. Always 1 for now. |
panels | Panel[] | yes | The strip, in reading order. |
CameraPreset
One of: "reaction", "establishing", "wide", "close-up", "over-shoulder", "medium"
BalloonKind
One of: "speech", "thought", "caption"
Emotion
| Field | Type | Required | Description |
|---|---|---|---|
angle | number | yes | Radians around the wheel. 0 is HAPPY; each named emotion is π/4 further. |
intensity | number | yes | 0 to 1. 0 is NEUTRAL regardless of angle. |
Body
| Field | Type | Required | Description |
|---|---|---|---|
character | string | yes | Id of a character declared by a registered pack. |
emotion | Emotion | yes | Point on the emotion wheel that picks the face. |
pose | "wave" | "point" | "shrug" | no | Gesture that claims the torso independently of the face. |
requested | boolean | no | Keep the body on stage even when it has no line this panel. Defaults to true for bodies with a line. |
Line
| Field | Type | Required | Description |
|---|---|---|---|
speaker | string | yes | A body's character id, or "caption" for the bodiless caption channel. |
balloon | BalloonKind | yes | Balloon shape. A caption speaker must use "caption". |
text | string | yes | The words. Wrapped by the renderer; keep it short. |
Panel
| Field | Type | Required | Description |
|---|---|---|---|
backdrop | string | yes | Id of a backdrop declared by a registered pack. An unknown id is a load-time error. |
roomTitle | string | no | Optional banner text drawn in the panel's top-left, like a location caption. |
dark | boolean | no | Paint the panel black and omit the figures. Balloons still draw. |
camera | CameraPreset | no | Framing preset. Defaults to "medium". |
bodies | Body[] | yes | Who is on stage, left to right. |
speakers | Line[] | yes | Balloons, in draw order: the caption first, then each speaking body. |