Repository navigation
Releases
v0.13.0
Upgrading from 0.12.0.
- The depth map of every panel with a ground, floor, water or ceiling changes once (#227),
and with it the bytes of its.depth.svg: regenerate golden depth maps of your own. Nothing
else changes, Panel Core included.
Added
-
The front door and the story (#323). The README and the site's landing page open the
same way: the gallery tour's picture, one sentence on what Scenet does today, buttons to the
playground, the gallery and the install guide, the AI-generated notice word for word, and a door
for each reader: Discover, Write comics, Build with Python, Drive from a model, Contribute. The
README is the PyPI page too, so every link in it is absolute and it stays under 120 lines; a
test holds it to both. About gains Why Scenet, the score-and-performer thesis rewritten for
what Scenet is now, with the style layer defined; What Scenet does today, a feature matrix in
place of the phase log, whose every "since" is checked against the releases mined from the tags
and the CHANGELOG, unreleased work marked; and What's new, this file. The navbar reads Learn,
Guides, Language, Python API, Gallery, Playground, About, with Contribute in the footer; the
how-to guides are grouped by what the reader is doing, a line each; and Use the playground
documents every button, Puppet… included, which a test holds to the page's toolbar.
Design decisions is named so and grouped by theme, the PDF print spike is a design note marked
superseded, the glossary gains character, scene, sequence, page, book and retreat, and reader
pages say what a thing does rather than which issue added it. -
One umbrella panel. The gallery's
01-two-charactersis the example every page shows: the
README, the landing page, the skill and the Python track. The language reference's complete
example, gallery71, is that panel with a setting, and a test holds every copy to it. The six
files at the top ofexamples/are folded into the gallery, whose files the reference's commands
now name. -
Learn Scenet from Python (#322): the developer's track, five chapters under
docs/tutorial/python/, frompip install scenetto Scenet inside a program of your own.
Compile and render calls everycompile_*entry point and every renderer, writes files,
and hands fonts and pictures back withfonts=andembed=; Read what it decided reads
a Panel Core as objects and as JSON, edits one and draws it again, and shows determinism;
Errors and notes walks theScenetErrortree, a fault's rule and place, and notes
matched by their codes; Bring your own adds a puppet library, a font asmetrics=, a
document's files asbase=, and a picture; Outputs, batch and CI builds a folder,
keeps golden files, runsscenet check, writes SARIF from Python, and calls the MCP tools
and server in process. Every example is a complete script followed by what it prints:
the test suite runs each one alone, in a folder holding the documents its chapter saved,
and compares its output with the page.tests/test_python_track.pyholds every chapter
to its parts, its examples to their output, and the track to every publiccompile_*and
render_*function, each called and linked to its reference page. The Tutorial page now
leads to both tracks. -
The author's tour (#321): twelve chapters under
docs/tutorial/, from a first panel to
a printed page, comic scripts, art and puppets of your own, right to left, and what Scenet
tells you. Each shows what you will make, as a gallery picture, beside its complete
document; builds it and says what the compiler decided; opens its examples in the
playground; runsscenet check; and links the key cards and the diagnostics entries. The
gallery's groups are now the tour's chapters, in its order, in the playground's menu too,
and the Gallery page sends each group to its chapter.tests/test_tutorial.pyholds every
chapter to that shape, every "Try it" list to its group, every printed output to what the
command prints, and the tour to the whole language: every key of a panel or a scene, and
every top-level key of a puppet file and an artwork contract, is written in a chapter's
document and linked to its card. The first chapter,first_panel.md, is rewritten for an
author: it installs withuv tool install, builds the file it wrote, and names a note by
its id. -
The install guide names the
mcpandwatchextras. -
A documented command runs on the files its page wrote. A
bashblock in the docs now
finds every file a block above it, captioned with a file name, shows, and the gallery's
pictures, fonts and puppets; a line ending in# exits 1must exit 1, so a page can show
scenet checkfailing on a mistake. A captioned copy of a gallery example counts as that
example. -
The command-line reference is complete (#320). Every option of every command has an
example, which the test suite runs -- a--watchexample runs its first build -- and every
command and option says the release it appeared in, mined from the tags into
docs/reference/cli.since.tomlbyscripts/mine_cli_since.py:--pdf,--mono,--watch
and--puppetare 0.13, not yet released.scenet schemahas an exit-status table, held to
a scenario for each code as the other commands' are. Each rule in the table of rules links
its entry in the diagnostics reference. A test fails on an option without an example or a
release, and on an issue number in the page. -
A finding links its entry (#320). SARIF gives every rule a
helpUri, its entry in the
diagnostics reference, and itshelpends by naming that entry, in text and in Markdown, so
code scanning and an editor send a reader to why it happens and how to fix it. The MCP
server's findings carry the same address ashelp_uri, and the VS Code extension opens the
rule's own entry from Problems rather than the list of every rule.
scenet.diagnostics.help_urigives the address for an id.puppet-file's help names the
published how-to instead of a path in the repository. The spec pack'sdiagnosticspart
and the skill'sreferences/diagnostics.mdare the reference page itself, entry for entry,
with its documents and their fixes, the compile notes included; a cross-reference to the
Python API in any page the pack carries is printed as code instead of as raw MyST. -
A diagnostics reference (#320), as Rust's error index is: an entry for each of the 37 rules
scenet checkreports and each of the 8 notes the compiler gives, at
docs/reference/diagnostics.md. An entry gives the id, its level, what it says, why it
happens, how to fix it, the keys that can give it, the release it was first given in and the
gallery examples that show it -- then a document that gives it, whatscenet checkor
scenet buildprints of that document, and the same document fixed. The page is generated by
scripts/build_diagnostics.pyfrom the catalogue andtests/rule_corpus/, which gains a
fixed twin for every document infixed/and a document for every compile note; the test
suite holds each document to giving exactly its diagnostic and each twin to giving nothing.
The compile notes are described in a new catalogue,scenet.diagnostics.COMPILE_NOTES, as
the rules are. Every key card links the entry of each diagnostic it can give, compile notes
included, and every entry links back to its keys. The gallery's "Read about it" for the
examples of "What Scenet tells you" opens the entry of the note they show. A
{scenet-example}can show a fault on purpose with:gives: <id>: the build fails unless the
document gives exactly that. "Since" is mined from the release tags into
docs/reference/diagnostics.since.toml. -
Every key of the language has a card (#319), as a cppreference entry does: all 128 keys a
panel, a scene, an artwork contract or a puppet file can write. A card opens on the key's
meaning -- the line an editor shows on hover -- then a table of where it is written (in a
document and in a comic script), its type, values, default, the release it appeared in, the
findings it can give and the gallery examples that show it; then what it means, how it
resolves against everything else and its limits; then a minimal document, compiled when the
documentation is built by a new{scenet-example}directive and shown with its picture and an
"Open in the playground" link. The facts are generated from the published schemas by
scripts/build_language_pages.py, between markers, and a test fails on a key without a card,
a card for a key that does not exist, a stale table or an example that does not compile.
"Since" is mined from the editor's schemas at each release tag into
docs/reference/language/since.toml, values added later marked on their own (warm, 0.13).
Every default an audit found unstated is now stated, the nine placement zones are listed, and
the missing sections are written: the scene document (panels,over, the merge rules and
null), the staging mapping form,setting's own keys, the camera's retreat, puppet files
and artwork contracts. An All keys, A to Z page lists every key, and a glossary says
what the reference's words mean. The gallery's "Read about it" opens the card of the key an
example shows, andunknown-keyandinvalid-fieldsend a reader to the index. The spec pack
and the skill print each card's example as YAML and each included file in full. -
The language reference is a page per block (#319).
docs/reference/language/holds an
overview, the blocks, a complete example, conflicts and determinism, then a page each for
panel,camera,setting,cast,staging,script,description,lettering,
direction,palette, andpageandpages. The old page keeps each heading it had, with a
li...
v0.12.0
Upgrading from 0.11.1.
- A font path written with
\between folders is refused, on Windows as everywhere else:
write/. So is one holding a control character, which used to crashbuildandcheck. conflicting-settingcovers a picture too: animagebeside aplace,massesor a
horizon. Its SARIF description and help say so; a place beside masses is reported exactly
as before. A panel that inherits a place and names an image is refused the same way; it
writesplace: nullbeside the image.- A comic script's prose is now read, as its panel's description. A line of it holding a
control character an SVG cannot hold, which used to pass unnoticed, is reported at that
line asinvalid-field.descriptionin a script's front matter is refused. - Every Panel Core gains
description, and each balloon, caption and sound effect a
label. Nothing else in it moves, andformat_versionstays 1: a Core without them is
still valid and writes back byte for byte, but golden Core files of your own will need
regenerating once. 0.11 refuses the new keys. - Every Panel Core gains
camera; each actorjoints,featuresand, when it looks at
somebody,looking_at; a backdrop of massestimeand, for a named place,place(#72).
Nothing else in it moves, no SVG changes, andformat_versionstays 1: a Core without them is
still valid and writes back byte for byte, but golden Core files of your own will need
regenerating once. Every gallery Core was compared with its 0.11.1 golden and differs by these
keys alone. A panel whose cast a picture draws has nocamera, and 0.11 refuses the new keys. - A balloon over its own speaker's body costs what it always should have when the actor id
is not the puppet's name (ALICE: {reference: alice},carol: {reference: alice}). Such a
speaker was charged as a bystander, so balloons drifted away from them. Three gallery
panels letter differently, each balloon now beside its speaker: regenerate golden Cores of
your own that cast an actor under another name. CaptionEvent.preferisNonewhen it was not written, where it used to readtop_left:
an unwritten zone is where reading starts, which the solver decides fromdirection. A caption
is placed exactly where it was. Code reading it from the Python API takesNoneastop_left
for a left-to-right panel.CastMember.referencemay beNone, for a member that is a figure a picture draws, and
CompileResult.cameraisNonefor a panel whose cast is all figures. Code reading either
from the Python API narrows them first;PanelIR.puppets()gives every puppet's reference.
A member that names neither a puppet nor a figure is reported exactly as before.- Every SVG's bytes change once, to carry what a screen reader reads: a
roleand a<title>
per panel, andaria-hiddenon a page's own shapes. Nothing is drawn
differently and lettering stays outlines.--no-aria(aria=False) gives back exactly the
SVG written before, for a pipeline that post-processes it; debug overlays are unchanged.
Added
- Export a panel's staging for image models (#72):
scenet build --conditioningwrites five
files beside each panel's SVG — the pose as OpenPose COCO-18 JSON, a phrase and a box per
figure as GLIGEN takes them, a depth map (stepped grey planes in painter's order, white near),
an instance mask under the panel's own ids, where a character keeps its colour across panels
unless another in the same panel has the same hue, and the semantics: camera, setting, cast
with each character's mask colour, and lettering, as structure and never as a prompt. No model runs in Scenet: each is one more
emitter reading Panel Core, text, JSON or SVG, byte-identical like the rest, and nothing is
rasterised. The pose names left and right as OpenPose does, by the subject's side; a point
outside the panel, an ear, or a joint a puppet does not name is0, 0, 0. Figures a picture
draws have boxes and masks and no pose; a picture is the far plane; a panel read right to left
exports the same pose, boxes, depth and mask.render_conditioningandConditioningjoin
scenet.__all__; MCPrendertakesconditioning(still five tools); the playground offers
the five downloads for a one-panel document. See the how-to, "Export a panel's staging for
image models". direction: ltr | rtl, which way a comic is read (#68):rtlfor manga, read from the
top right. It is the comic's progression, not its text's, and EPUB's word for it. Written once
for the whole document — at the top of a panel, besidepanels:, or in a comic script's front
matter — and inherited by every panel; a panel's own, and a script's@direction:, are the new
rulepanel-direction. The editor's schema offers it. Panel Core and Page Core record it when it
isrtl; a left-to-right Core is byte-identical andformat_versionstays 1.- A panel read right to left is lettered from the top right. A balloon or caption may never sit
above and right of one before it; a caption with noprefer, and a voice from off panel with no
side named, start top right; every tiebreak between equal placements is mirrored, so the mirror
image of a panel is lettered as the exact mirror of the original; and a generated description
names the cast from the right. Nothing in the picture moves: figures, gaze, tails and sound
effects are byte-identical, andprefer:,at:and named sides keep meaning places on the panel.
The debug overlay says "read right to left". - Pages and strips read right to left. Under
direction: rtla tier's first panel, or first
column, is at its right; each frame is the one the tier reversed would have, so every panel
keeps its size and its art, an inset keeps its corner and a slant leans as written. The pages of
a document side by side (render_pages, the playground) and a strip start at the right, and every
one is still written in reading order. A strip or a row of pages read two ways is refused. - Two gallery pages, the same manga page read right to left and left to right.
setting: {image: ..., fit: cover | contain}: a picture drawn elsewhere, behind the
cast (#70). It is a backdrop of its own, so it is written instead of aplaceor
masses, never beside them or beside ahorizon(conflicting-setting); afitwith
no image isinvalid-field. A panel that inherits a place writesplace: nullbeside
its image, and the editor's schema now accepts thatnull.- The picture is read from its PNG or JPEG header, beside the document as a font is, and
only its size is taken.scenet checkreports a picture that is absolute, missing, not a PNG
or JPEG, or turned by its EXIF orientation as the new ruleimage-file, without the solver.
Text compiled with no folder may be handed the files it names instead:basetakes a
mapping from the path the document writes to the file's bytes, for fonts as for pictures. - The picture is placed, and Panel Core records it. Centred, filling the panel (
cover)
or shown whole inside it (contain), never stretched.backdrop.imageholds the path as
written, the media type, a digest of the bytes, the pixel size, the fit in SVG's words and
the rectangle it is drawn in; over a picturebackdrop.horizonis left out. A Core of masses
is byte-identical, andformat_versionstays 1. The picture costs a balloon nothing and does
not move the camera, and a generated description names no place and no hour over it — only
the weather drawn on top. - The picture is drawn, as an
<image>on the paper, under every figure and the weather,
in the rectangle Panel Core placed it in. It is linked byxlink:href— Inkscape does not
load plainhref— to the path exactly as written, which resolves when the SVG is beside
the document;scenet build --embed-images(embed=on every renderer) writes its bytes in
as adata:URI instead, andbuildsays so in a note when a link will not resolve. The
debug overlay shows where it was placed. A new how-to, Letter over your own art, and a
gallery example drawn over a picture the repository paints itself, under its own licence. - The MCP server's
validate,compileandrendertakefiles: the files a document
names, by the path it writes, as base64. They stand in for the document's folder, read in
memory, so a model can letter over a picture — or in a font — it sends;renderembeds
the picture. Still five tools. - The playground's Image… button adds a
.pngor.jpgto the document'sart/folder,
for as long as the tab is open, and the preview and every download embed it. The VS Code
preview embeds pictures too, since it is not drawn beside the document. - An artwork contract declares the figures a supplied picture draws (#71): beside
art/p01.png,art/p01.art.yamlgives each figure'sface(a disc lettering may not
cover),mouth(where a tail ends) andbody, andkeep_outregions lettering should stay
off, all in the picture's own pixels, with thesizethey were measured on.
scenet schema --artworkemits its JSON Schema, which the VS Code extension associates with
*.art.yamland the documentation site publishes beside the others. Panel Core records what a
contract declares, mapped into the panel through the picture's fit:figures, beside
actors, and the picture'skeep_out. Both are left out when empty, so every Core reads and
writes as before andformat_versionstays 1; the debug overlay draws each figure's face,
mouth and body, and each keep-out. - Figures a picture draws, in the cast (#71):
cast: {ana: {figure: ana}}in place of
reference:. The panel's picture's artwork contract says where each face, mouth and body is,
and lettering is placed by the same rules as around a puppet...
v0.11.1
The documentation site documents the release you install, and shows off its playground;
and two comic-script fixes. The site's root now serves the latest release, main moves under
/dev/, and each minor version keeps its own path; the playground says which version it runs,
and the home page shows its example compiled, with a button to open it there. A full stop
now ends a PAGE heading, and no line of a comic script can stall the compiler.
Upgrading from 0.11.0. The language, the command line and the Python API are unchanged,
and so is every YAML document's output. A comic script changes only where a PAGE heading
ends in a full stop, as in PAGE 7. or PAGE TWENTY ONE.: see Fixed.
Added
- The documentation site documents what you install. Its root, and every address
already in use there — the documentation, the playground,schemas/panel.schema.json,
scenet-spec.md,llms.txt— now serves the latest release, not unreleasedmain.
mainmoves to/dev/, and each minor version
from 0.8 stays online under its own path, such as
/v0.10/, its playground running that
release's compiler. A version switcher in the navbar keeps the page you are on./dev/and
older versions carry a banner linking to the same page in the latest. Pin a schema or the
spec pack to a release by putting its version in the path:
…/scenet/v0.11/schemas/panel.schema.json(#171). - Each release attaches its built site as
scenet-X.Y.Z-site.zip, built from the wheel
it publishes, before PyPI. The site serves every version from these, unchanged. Releases
0.8.0 to 0.11.0 have theirs backfilled. - The playground says which version it runs, with the same version switcher as the
documentation, keeping a shared document across the switch. Onmain's and on an old
release's it says so, with a link to the latest. Playgrounds built before this change,
those of 0.11.0 and earlier, carry no switcher. - The documentation's home page shows its example compiled — the file
scenet build
writes for it, kept current with the golden files — and a button opens that example in the
playground. The navbar names the playground beside the sections, and every link to it
opens the playground of the version being read. - Dependencies and code are watched by GitHub's own security tooling. Dependabot alerts
and security updates cover the dependency graph, which GitHub builds fromuv.lockand both
package-lock.jsonfiles, transitive dependencies included. A pull request adding a
dependency with a high or critical vulnerability fails dependency review. CodeQL analyses
the Python, the TypeScript and the workflows on every pull request, onmainand weekly.
Secret scanning rejects a push that contains a credential. SeeSECURITY.md.
Changed
- Every pull request checks the package as a release would. CI's new Package job builds
the sdist and the wheel, runstwine check --stricton them, smoke-tests the wheel from an
empty directory, and builds the wheel again from the sdist alone, comparing the two. The
smoke test is now one script,scripts/smoke_wheel.py, that the release runs too.
Nothing is published: TestPyPI stays a manual rehearsal.
Fixed
- A full stop ends a PAGE heading, as it ends a PANEL one.
Page 4B.named its page
4B.andPAGE 7.a page called7.;PAGE TWENTY ONE.andPLANCHE 3.were not
read as headings at all, sinceONE.and3.are not numbers, so their panels ran on
into the page before. They are pages4B,7,21and3now. A full stop inside a
label, as inPAGE 3.5, stays.
Security
- A comic script cannot stall the compiler with one crafted line. The PAGE heading
pattern backtracked exponentially on a line likePAGE !-!-!-…(: fifty characters took
seconds, and each two more took four times as long. Found by CodeQL, which led to the
rest: the PAGE, SFX, caption and cue-with-its-line patterns each let two parts take the
same run of space, so a long gap was quadratic or cubic -- a caption line of sixty
thousand tabs took twenty seconds, an SFX line with a note three minutes. Every line
is now read in time linear in its length, soscenet build,scenet check(which the
editor runs on open and save), the MCP server and the playground cannot be hung by a
script. The patterns read every script as before, with one exception at the edge: in
PAGE A - .the full stop now ends the heading, as it already did inPAGE A .,
rather than ending the label. - The playground's DOMPurify is 3.4.17, past two advisories affecting versions up to
3.4.15 (GHSA-6688-9rhm-gjv2, GHSA-p98j-92pf-mc4p). It reaches the playground through
monaco-editor, which pins an older version, so the override that lifts it is raised by
hand: Dependabot's security update cannot do it.
Install
pip install scenet==0.11.1The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...
v0.11.0
Lettering, sound effects, and comic scripts as publishers write them. A stressed word is
lettered in bold italic, every pair is kerned, the type size can be set, and an author can
letter in their own face. Sound effects are lettered into the picture in a display face. A comic
script may be written as Dark Horse publishes its format, or in French, with captions that carry
speech, voices from off panel, small type, and its PAGE headings laid out as pages; scenet check gains notes, the first of them a publisher's word limits.
Upgrading from 0.10.
- Every example's lettering shifts slightly. Kerning makes most balloons and captions up to
about 1.5% narrower, and where two positions had scored nearly equal a balloon may sit
somewhere else. Golden files of your own will need regenerating once. - A few comic-script lines mean something new, each listed under Changed: prose before the
first heading is a title page,PANEL ONEis panel1,Panel 1. A description.is a
heading, an all-capsNAME: textwith NAME in the cast is dialogue, a bareCAPTIONstarts a
caption, andCAP,CAPTIONandSFXare reserved. - A comic script with PAGE headings now writes its pages, and the panels on them are
compiled at the size of their frames and lettered at the page's one size, so they look
different; the front matter'spanel: {size}now sizes only panels on no page. scenet checkcan print notes --file:line:column: note: rule: message-- and exits 0
when there are only notes. The MCP server's findings gainlevel, andvalidatecalls a
document with only notes valid.
Added
-
scenet checkreports notes as well as errors. A note is a house limit rather than a
contradiction: the document still builds, so a note never fails the check. The first is
Dark Horse's word limit,word-limit: a balloon or caption over about 25 words, or a
panel over about 50, in YAML and in comic scripts alike. Words are counted as lettered,
so--and emphasis underscores add none, and sound effects are not counted.- In text, a note reads
file:line:column: note: rule: message; an error's line is
unchanged. - In SARIF, the level comes from the rule, in
defaultConfigurationand in each result,
so VS Code and the playground show a note as information. checkexits 1 only on an error, and printsokfor a document with only notes.- The MCP server's findings gain
level, andvalidatecalls a document valid when
none is an error. (Part of #75)
- In text, a note reads
-
Comic scripts in Dark Horse's published layout compile.
PAGE ONE (five panels)is a
page heading whose count is checked against the panels under it, as the new
panel-countnote.Panel 1. Alice and Bob on a corner.is a panel heading with its
description on the same line, andPanel Oneis panel1. A title page — the writer's
name and address — may come before the first heading. Markdown's## PANEL 2,
**PANEL 2**and horizontal rules are read as the headings and blank lines they mark.
A cue with nothing said under it, and a name in capitals with a line under it on the
title page, arelooks-like-dialoguenotes.scenet buildprints these notes, and
Book.notescarries them. (Part of #75) -
Comic scripts read Dark Horse's lettering labels.
CAP:andCAPTIONtake their
text from the line or the lines under them; Dark Horse'sCAP/ALICEis a spoken
caption by Alice, with the writer's quotation marks taken off so they are not doubled;
ALICE (V.O.)is a voice over, lettered as a spoken caption.ALICE: Hello.is
dialogue when Alice is in the panel's cast, and alooks-like-dialoguenote otherwise.
(burst)is a shout, several parentheticals are read together, and Blambot's numbered
items,1. ALICE:, are read with their number set aside. (Part of #75) -
@over:in comic scripts writes a panel as a change to another, with the merge
rulesover:has in YAML: the panel inherits the other's directives, never its
dialogue.@over: 1names panel 1 on the same page first, then the panel named1. A
missing panel, a cycle or a panel over itself is onecompositionfinding at the
@over:line. (Part of #75) -
Off-panel speech.
say: {by: caller, text: "Open up!", off_panel: left}is spoken by
somebody nobody draws: the balloon's tail ends on the frame, on that side, or on the
slanted outline of a slanted panel.off_panel: truelets the compiler take the nearer of
left and right. The speaker is not in the cast, and one who is drawn cannot speak from off
panel: the new erroroff-panel-speaker. Panel Core balloons gainoff_panel, the side,
written only when set, so no existing Core changes. (Part of #75) -
ALICE (OP)in a comic script is off-panel speech, as are(OFF),(O.S.)and
(O.C.). Alice is left out of that panel's cast and of the staging that names her, each
relation with adropped-relationnote, and her tail ends on the frame on the side she
was written to stand, unless the cue names one,(OP, right). A cue for somebody never
cast,PHONE (OP), works too. (Part of #75) -
Small lettering.
say: {..., size: small}letters a line at three quarters of the
dialogue size, in a balloon padded as the normal size would be: muttered, as Blambot
describes it. A comic script's(small)and(weak)give it. (Part of #75) -
French comic scripts.
PLANCHE 1 (six cases),CASE 2andVIGNETTE 2are headings;
RÉCITATIF,CARTOUCHEandNARRATIFare captions;ONOMATOPÉEis a sound effect;
LÉA : « Bonjour. »is a cue and its line, with a no-break space before the colon.(pensée)
is a thought,(off)and(hors champ)off-panel speech.@shot:and@angle:take the
échelle des plans —gros planisbig_close_up,plan rapproché épauleisclose_up—
and plongée, contre-plongée. Both highlighters follow, and the gallery gains
33-planche.script. (Part of #75) -
A figure may look at somebody heard from off panel:
bob looking_at carol, where Carol
speaksoff_panel: left, turns Bob toward the left of the frame and aims his eyes out of it.
With no side named, Carol is heard from the side Bob faces. In a comic script,
BOB looking_at ALICEnow survivesALICE (OP)instead of being dropped with a note.
(Part of #75) -
nullleaves an inherited cast member out of a panel:cast: {bob: null}in a scene's
panel, underover:or over the scene's defaults, or@cast: {BOB: null}in a script. It
follows JSON Merge Patch (RFC 7386), "If the value is null, remove". The staging relations
that name him go too, each adropped-relationnote, and the JSON Schema accepts thenull.
(Part of #75) -
French delivery words, from the BnF's sheet on balloons:
(murmure)and(chuchoté)are
a whisper,(cri)and(crié)a shout,(à voix basse)small type. (Part of #75) -
compile_scriptcompiles a comic script handed over as text, exactly asscenet buildcompiles a.scriptfile.scenet check --deep, the MCP server and the
playground now all go through it, rather than assembling a script each their own way.
(Part of #75) -
A stressed word is lettered in bold italic. Write it between underscores, the way a
script underlines it:I _told_ you. It works in dialogue and captions, in YAML and in
comic scripts, and the word is measured in bold italic as well as drawn in it, so it
widens its balloon by exactly as much as it is drawn wider. An underscore inside a word
stays an underscore, and\_writes one anywhere. Emphasis that is opened and never
closed is reported asunbalanced-emphasis, and a value starting with*, which YAML
reads as an alias, now says to quote it. Panel Core gainsrunsbesidelines, written
only for a line with emphasis, so every existing panel compiles byte for byte as before.
(Part of #74) -
The editor guide shows how to see
scenet checkfindings in VS Code today: write them
as SARIF and open the file with Microsoft's SARIF Viewer. (Part of #77) -
The VS Code extension shows what
scenet checkfinds, as you open and save a panel,
scene or comic script: an actor not in the cast, an ordering cycle, a pose the puppet
lacks, which the schema cannot see. Each finding is underlined where it is and listed
under Problems with its rule, linked to its explanation, and goes away when it is fixed.
scenet.checkDeepadds--deep;scenet.checkOnSaveturns it off. Ifscenetcannot
be run, or crashes, a notification says so once rather than leaving the list empty.
(Part of #77) -
The extension is now versioned with the compiler, starting at 0.10.0, so the
.vsixon
a release says which release it belongs to. -
The VS Code extension highlights comic scripts, as the playground does: headings,
directives, captions, cues and their parentheticals, dialogue set apart from prose, and
the front matter as YAML. Both highlighters are tested against one set of fixture
scripts, which are themselves checked against the compiler's reading, so neither can
drift from the other or from the format. (Closes #77) -
Type size can be set:
lettering: {size: N}is the dialogue size in panel units,
and captions keep their proportion to it. Set besidepanels:it applies to every
panel, so a whole page letters at one size you chose; on one panel, to that panel
alone; in a comic script, in the front matter or an@lettering:directive. Left out,
nothing changes. (Part of #74) -
Letter in your own face.
lettering: {font: fonts/Comic.ttf}, or a file per face
underregular,italicandbold_italic, sets the lettering in fonts the document
names, read relative to the folder it is in -- never a system font, and never an
absolute path. A face left out stands in from one given, and the compiler says so when
that matters. Panel Core record...
v0.10.0
Pages. A scene can now be laid out on pages -- tiers of panels, columns beside them,
insets set into corners and gutters that lean -- and scenet build writes each page beside
its panels. This release also closes more than twenty ways a document could lose something,
point at the wrong line, or end in a traceback, and the test suite now holds the compiler to
its promises with generated documents, golden outputs on every platform and weekly mutation
testing.
Upgrading from 0.9.
- Some documents that compiled now refuse, each for a fault that was losing something
without a word: a key written twice in YAML, a panel named with an unquoted number,.inf
or.nananywhere, a control character in a line or an actor id, an inset that does not
fit its panel, and two outputs that would be the same file. - Every panel with lettering renders slightly differently. Glyphs are now drawn at the
size they were measured, which at some sizes is 14% smaller than before; a strip's ids are
prefixed by each panel's position; and--stripno longer writes a strip of one panel. - Some findings moved: an unknown speaker is at
script.N.say.by, a block-style key at
its own line, a brokenover:at theover:. Code that matched on the old paths, the MCP
server'swhereincluded, needs updating. - A comic script that numbers its panels per page now names them by page and panel
(2-1), where before the later page overwrote the earlier one.
Added
-
Pages. A scene can lay its panels out with
pages:: each page a list of tiers, each
tier a list of panels, and a weight for each tier's height and each panel's width, shared
out of whatpage:'s margin and gutters leave, the way CSS Grid shares a row. A panel on a
page is compiled at its frame's size and nothing else changes about it, except that every
panel on a page letters at one type size. (#66)scenet buildwrites each page asstem.page-<n>.svg, with its Page Core and overlay
under--coreand--debug, and refuses a panel whose file would be a page's.- A new tier, Page Core, records where every frame is and the type height the page
shares.compile_bookreturns the panels and the pages;render_pageand
render_pagesdraw them. scenet checkreportsscenet/page-layoutfor a placement naming no panel, a panel
placed twice, or no room left by the margin and gutters.- The published schema, the VS Code extension and the playground understand pages; the
playground shows a document's pages side by side, and its Panel Core view holds the
Page Cores. MCPcompilereturns each Page Core andrenderone SVG per page. - A gallery example, a how-to (Compose a page), and a prior-art entry on where the rules
come from: Cohn's reading-order experiments, Peeters, Groensteen, CSS Grid.
-
Columns on a page: a tall panel beside a stack. A tier can hold
columns:in place of
panels:, each column a stack of panels shared out byheight, and a column of one panel
spans the whole tier. A tier of columns is read down each column before across, as readers
read a stack blocked by a tall panel. Two stacks side by side block nothing, readers go
across them, andscenet checkrefuses them aspage-layout. (Part of #67) -
Insets: a small panel set into a corner of another, drawn over it inside a ring of white.
insets:on any placed panel takes a corner, asize(a fraction of the parent, at most a
half) andread: beforeorafter. Readers split about evenly over an inset, so its place
in the reading order is written, never guessed: after its parent by default. (Part of #67)- The parent's art does not move. Its lettering keeps clear of every inset, as firmly as of
a face, and its Panel Core records what it kept clear of asexclusions. A note says when
an inset covers a face. - Page Core frames gain
inset_ofandclearance, and the page paints every inset over its
parent whatever its reading order. Neither new field is written where it is unused, so
every existing Core is byte-identical. scenet checkreports two insets that overlap aspage-layout, located at the second.- The debug overlay draws what an inset covers. A gallery example, and a section of the
Compose a page how-to.
- The parent's art does not move. Its lettering keeps clear of every inset, as firmly as of
-
Slanted tiers:
slanton a tier of panels leans every gutter in it, up to 30 degrees
either way, for a beat that should not sit square. Neighbours share one cut, a gutter stays a
gutter wide across it, and the tier's outer edges stay upright, so every frame is a convex
four-sided shape. (Closes #67)- A slanted panel is staged in its bounding box and cropped to its
outline, which its Panel
Core and its Page Core frame record; its lettering stays inside the outline, a margin in. A
note says when the cut runs through a face. - A rectangle writes no
outline, so every existing Core and page is byte-identical. scenet checkrefuses, aspage-layout, a slant on a tier of columns, on a tier of one
panel or on panels with insets, and one too steep to leave every panel some width.
- A slanted panel is staged in its bounding box and cropped to its
-
scenet/duplicate-panel, the finding for two panels in a script that would still share a
name:PANEL 1twice on one page, or twice with no PAGE heading between them. It points at
the heading that repeats. (#63) -
scenet/duplicate-key, the finding for a key written twice in one YAML mapping. It points
at the second and names the line of the first. (#83) -
Golden outputs, checked on every platform. The gallery is built through
scenet build
in every CI job, Windows included, and the bytes on disk must match committed goldens: every
Panel and Page Core in full, and a digest of every SVG. Two processes with different hash
seeds, and a relative path against an absolute one, must write the same bytes, and no output
may hold the path it came from.scripts/update_golden.pyregenerates them. (#94) -
Weekly mutation testing of the solver and the emitters.
.github/workflows/mutation.yml
runs mutmut oversolve/andemit/every Monday and
on demand, and reports every small edit to the code that no test notices, with the score in
the job summary. A second job runs the property tests with fresh random seeds and 300
examples each. Neither runs on pull requests or blocks a merge. mutmut is in its own
mutationdependency group, so a plainuv syncdoes not install it. (#95) -
The command-line reference is a tested contract. Each command's options, choices,
defaults and exit statuses, the frontends, and every behavioural sentence in
docs/reference/cli.mdare checked against the code in both directions, so neither can
drift alone. Every rule has a document intests/rule_corpus/that must produce exactly
one finding of it. And thescenetcommands in the documentation's shell examples now run
in the test suite, as its Python examples already did. (#93) -
Property-based tests for pages, scripts and broken documents. Generated books are
held to the documented reading order, worked out from the pages as written, to frames that
stay inside the margins and clear of each other, and to sound SVG with ids unique across
pages. Generated comic scripts lose no panel and no line. And a valid document given any
one mistake from a catalogue of twenty-odd must get exactly one finding fromscenet check, under the right rule and on the right line; arbitrary input must never get a
traceback. The eight bugs they found are fixed above. (#92) -
Property-based tests. The checks a compiled panel must pass, which ran on five
hand-written panels, now also run on panels Hypothesis generates: lettering inside the
margin, off every face and in reading order against every earlier box; an SVG that
parses, whose ids resolve and whose glyphs are drawn at their measured size; compiles
that are byte-identical; Panel Core that round-trips; andscenet check --deepagreeing
with the compiler. The examples are fixed, so a failure replays on every machine.
docs/maintainer/testing.mdexplains the profiles and how to add a generator. (#91)
Fixed
- The same panel could compile to different bytes. kiwisolver, which places the cast,
keys its internal maps by object address, so the same layout solved twice could come back
a few ulps apart. A coordinate derived from it that sat on a rounding boundary then
printed as247.95in one compile and247.96in the next, in the same process. Solved
positions are now snapped to a millionth of a unit as they leave the solver, far above
that noise and far below anything the output shows. One gallery golden moves by 0.01 as a
result. Found by the weekly Hypothesis exploration. (#117) - One mistake in a puppet part was reported six times. A part is a bone (
from,to,
width) or a blob (at,radius), and a bone with a badwidthwas also tried as a blob,
so pydantic listed five more errors about a blob nobody wrote, under paths naming its
classes. A part is now checked only as the kind its keys say it is, atparts.N.boneor
parts.N.blob, and a part with the keys of both kinds or of neither is one error that
says what a part must be. The same fix #98 made for script entries. (#92) - A font with no character map raised
KeyError: 'cmap'from inside fontTools when
passed asmetrics=, instead of theValueErrorthatFontMetricsdocuments for a font
it cannot measure text against. Found while triaging mutation testing. (#95) scenet buildcould silently overwrite one output with another. Only a panel named
like a page was refused. A panel namedstripreplaced the strip,x.debugreplaced panel
x's overlay, and two names differing only in case wrote one file on Windows and macOS.
Every output is now planned before anything is written, and two ...
v0.9.0
A release for maintainers: Scenet can now be listed in the MCP registry from a workflow. The
language, the compiler and the scenet mcp server are unchanged from 0.8.0.
Added
- A workflow lists releases in the MCP registry.
mcp-publisher login githubcannot publish
under an organisation namespace, because the registry's GitHub App is not installed on the
organisation andio.github.creatoan/*answers 403 whatever the role. The new
.github/workflows/registry.ymllogs in with the workflow's OIDC token instead, which proves the
namespace through the repository and needs no secret. Run it by hand for an existing tag, or set
the repository variableMCP_REGISTRY_PUBLISHto haverelease.ymlcall it after each release.
It checks thatserver.jsonnames the tag's version and that the version is on PyPI before it
publishes, and pinsmcp-publisherto a version and a SHA-256. (#60)
Fixed
- The release guide advised
mcp-publisher publish --dry-run, which publishes.publishhas no
such flag, so an unknown one is ignored and the listing happens. The guide now says to use
validate, which checks the manifest against the live registry and changes nothing. (#60)
Install
pip install scenet==0.9.0The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...
v0.8.0
Models can now be told how to write Scenet, and can check what they wrote: a spec pack, an
Agent Skill and an MCP server. A comic's marks — sweat, dizziness, oaths, dust — join the
language, and diagnostics in comic scripts and shared casts now point at the right line.
Added
- Emanata: what a comic draws around a character. A cast member takes
marks:, a list
from Mort Walker's Lexicon of Comicana:plewds(sweat flying off the head),squeans
(dizziness),grawlixes(an oath, as a spiral, a star, a bolt and a hash) andbriffits
(the dust of a hasty exit). A list rather than a secondexpression:, because they compose
— a character can be angry and sweating. Every puppet gets every mark; nothing new is
declared per puppet. Atlong_shoteach mark collapses to a dot, and a figure too small to
have a face has none. (#21) - Marks cost a balloon space, and never move anybody. They are drawn outside the head,
where balloons go, so each mark has a zone that balloons and captions pay to cover —
weighted above covering a body, with no discount for the speaker. They stay out of the
hull, so staging, the camera and every figure are exactly where they would be without them,
and a crowded panel still compiles. The camera makes no room for them either, so a mark
cropped by a tight shot is reported in the compile notes. The debug overlay draws the zones. scripts/contact_sheet.py --marksrenders every mark across the shot ladder, and the
gallery gains23-emanata.scene.yaml.- A way to tell a model how to write Scenet. The spec pack puts the language
reference, the shot types, the comic-script format, the shipped characters, every
diagnostic rule, the JSON Schema and the whole gallery in one file, published at
/scenet-spec.mdbeside an
llms.txt. It is what to hand a chat app
that cannot run code, such as NotebookLM, which can then write a comic script for you to
compile.skills/scenetis
an Agent Skill for coding agents. All of it is generated from
the compiler's own sources, and a test fails if a committed copy goes stale. (#11) scenet mcp, an MCP server, so a model can validate its own panel, read findings
that name the rule, the line and the fix, and render the result with nobody relaying
errors. Five read-only tools —get_spec,list_puppets,validate,compile,
render— over stdio or Streamable HTTP, on protocol revision 2026-07-28. It needs the
new optional extra:pip install 'scenet[mcp]'. Aserver.jsondescribes it for the
official MCP registry. (#11)- Driving Scenet from a model,
a how-to for each kind of client, and two entries in prior art: WordsEye, the ancestor of
text-to-scene, and Gumin et al. 2025, the strongest argument against a declarative
language, recorded for what it actually found. (#11)
Changed
- Panel Core actors gain
marks,emanataandemanata_zones. All default to empty, so
format_versionstays 1 and a Core document written before them still reads. Every actor
now serialises the three keys, so a golden file captured against 0.7.0 will differ by them
— and by nothing else: every example in the repository lays out byte-identically.
Fixed
- A comic script's line numbers counted from the end of its front matter, not from the
top of the file, soscenet checkand the playground pointed several lines above the
fault in any script with a cast block — which is nearly all of them. - A panel in a comic script that failed validation — a misspelled
@shot:, say — was
reported at line 1 whichever panel it was. It is now reported at that panel'sPANEL
heading. - A bad name in a shared cast was reported once per panel, every copy pointing at the
panel rather than at the line that was wrong — in a comic script's front matter, all
of them at line 1. A fault in a scene's defaults or a script's front matter is now
reported once, where it is written. A panel's own mistakes still carry its name. scenet buildprinted a traceback for a file with an unsupported extension, and
scenet checkcalled the same fileok. Both now report it as a usage error, exit 2.scenet build foo.panel.ymlwrotefoo.panel.yml.svg..ymlis now named
exactly as.yamlis:foo.svg.- The command-line reference's
scenet check examples/gallery/*.yamlexamples failed,
because the glob also matched the gallery's manifest. CI's gallery check now includes
the gallery's comic script, which it had skipped.
Install
pip install scenet==0.8.0The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...
v0.7.0
The playground became a place to work, the editor schema stopped rejecting valid
documents, and the project moved to the creatoan organisation.
Added
- The playground became a place to work, not just a demo. The output zooms and pans —
scroll or pinch about the pointer, drag, double-click for Fit or 100%,+ - 0 1and
the arrows — and keeps the zoom while you edit. Download saves the panel as SVG or a
2× PNG, the overlay, the Panel Core and the source, named asscenet buildnames them;
Ctrl+Ssaves the source. Edits survive a reload, and Share copies a link that
carries the whole document in its fragment, so no server is involved. A failed compile
is reported by the same checkerscenet checkruns: each finding is a squiggle on its
own line, and the list under the output jumps to it. Actors, staging relations and
script verbs are coloured; Panel Core opens in a read-only editor with folding; the
split between the panes can be dragged; the output can go full screen. The editor also
shows the example at once instead of sitting empty while Python boots. (#45) render_strip(..., debug=True)lays out each panel's overlay where the strip puts the
panel, so a scene has an overlay too. (#44)
Changed
-
The project moved to
creatoan/scenet.
GitHub redirects the repository, its issues and pull requests, andgitremotes. The
documentation and playground are now at
creatoan.github.io/scenet; the old
azias.github.io/scenetaddresses do not redirect, because GitHub Pages never does.
If a YAML document names the schema, update its first line to:# yaml-language-server: $schema=https://creatoan.github.io/scenet/schemas/panel.schema.json
Fixed
- The published JSON Schema rejected the syntax people write. It described the IR,
after the frontend has rewritten staging sentences,- say:wrappers,place:and
partial scene overrides away — so 21 of the 22 gallery documents failed it, and the
playground and the VS Code extension underlined lines that compiled. The new
scenet.schemamodule puts each of those back; a test now validates every shipped
example against the shipped schema. (#44) - The overlay wrote actor ids into SVG unescaped, in an
idattribute and in text
labels. The playground puts that SVG into the page, so an actor id could close its
attribute and add markup. Identifiers are now escaped as they already were in the
panel itself. (#44) scenet checkreported a bad staging sentence or script entry against the whole
document. It now points at the entry — an unknown predicate, a malformed sentence,
an unknown verb. (#44)
Install
pip install scenet==0.7.0The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...
v0.6.0
Setting: a panel can now show where and when it happens — and a caption box can be
tinted to read against it.
Added
-
The setting layer: a panel can show where and when it happens. Every panel rendered
figures on white; there was nosettingblock at all. Captions (0.4.0) shipped the
cheap half of establishing place — alocalebox can sayMIDNIGHT. THE DOCKS.—
and this is the expensive half.setting: place: docks horizon: mid time: night weather: rain
-
Backdrops are described tonal masses, never drawn geometry. Crisp architecture needs
a vanishing point and this is deliberately a flat, orthographic compiler, so drawn
buildings would fight the compiler's own model — soft masses have no perspective to get
wrong. It is also how comics actually establish place: notan (Dow, Composition,
1899) says place is read from the arrangement of masses rather than from rendered
detail, and aerial perspective supplies the parametric rule — with distance, value
contrast drops toward the atmosphere. -
Twelve mass kinds, from COCO-Stuff supercategories —
building,ground,plant,
sky,solid,structural,wateroutdoors,ceiling,floor,furniture,wall,
windowindoors. Taken from an existing taxonomy of stuff rather than invented, for
the same reason the predicates came from Visual Genome. Not its leaf names: the real
classes arebuilding-otherandsky-other, and nobody should have to type that. -
Ten named places —
alley,desert,docks,field,forest,mountain,
office,room,shore,street— each expanding into a mass list the author could
have written themselves. That rule is what keeps a preset a library rather than a second
opaque format, and it is enforced by a test. The expansion happens in the frontend, so
the IR has noplacefield at all — the same treatmentalice left_of bobgets. -
planereuses the existing painter's order rather than introducing a second one.
The three backdrop planes take negative depths;foregroundtakes one above the
frontmost actor, so a foreground mass draws over the cast the way a silhouetted doorway
does. Value follows from the plane and from nothing else, which is what keeps the notan
reading literal. -
timeandweather.timesupplies the two ends of the value ladder rather than
tinting a daytime panel, sonightis a darker, narrower ladder — and the ladder stays
monotonic in depth at every hour by construction.weatheraddsfogas a
feTurbulenceveil, andrainandsnowas that veil plus falling marks. -
CoreBackdropon Panel Core, carrying fully resolved numeric polygons and tone
values — the same discipline ascapsules,blobsandface_marks, so the emitter
still makes no layout decision. Absent on a panel that says nothing about where it is,
which is why this needed noformat_versionbump. -
Masses are a soft cost for balloon placement, never an exclusion. Balloons sit over
backgrounds routinely; that is what a background is for. Covering one costs an order of
magnitude less than covering a face, weighted so a foreground silhouette costs more than
empty sky. -
scenet checkreportsunknown-placeandconflicting-setting, each naming the
field. A place and a mass list together is rejected rather than guessed at: a place is
a mass list. -
scripts/setting_sheet.py, the calibration instrument — every place against every
hour on one sheet, every weather on another. Whether three greys read as depth is not a
question a test can answer, and four things moved because of what the first sheet showed. -
Gallery examples 19, 20 and 21, and a
docs/reference/language.mdsection for the block. -
Caption boxes can be tinted. Captions shipped in 0.4.0 with four kinds and the
typography that goes with them, and one value:#ffffff, hardcoded in the emitter. A
tonekey now chooses from a three-value palette.- caption: {text: "Noon. Nothing for miles.", kind: locale, tone: ink}
The failing case is the pale end, not the dark one. A caption box is opaque, so its
lettering was never at risk — the text sits on the fill whatever is behind it. The
box is what stops reading: against the ladder above, a white box on a noon sky is
1.16:1, and only the stroke separates it at all. -
The palette is rungs of the backdrop's own value ladder —
paper#ffffff,pale
#adadad,ink#090909, the last two taken from thedayrow by index rather than
restated, so lettering and backdrop cannot drift apart as either is tuned.paperis
the default, so no existing panel moves. No free-formfill:, and no yellow: an open
colour field would be this language's one open vocabulary, and the classic yellow
localebox would be the first non-neutral value in the codebase. -
inkinverts the lettering to paper — reversed type — chosen by contrast in the
solver and carried onCoreCaptionasfillandink. The same rule and the same
reason as falling rain, and it leaves the emitter with no decision about which mark
reads. Both fields are defaulted, so a Core document written before this still parses
and noformat_versionbump was needed. -
The lettering floor is enforced rather than asserted.
contrast_ratioin
solve/backdrop.pymeasures WCAG relative luminance — the ladder is spaced in OKLab
because that predicts even perceived steps, but legibility is checked against the
published threshold. Every tone clears 4.5:1 against its own lettering, and every rung
of every hour has at least one tone above 3:1 to sit on. This is the one visual rule in
the compiler with an objective answer, so it is a test rather than a taste. -
Gallery example 22, a
tonerow and section indocs/reference/language.md, and
fill/inkindocs/reference/panel_core.md. -
scenet check --deep. Runs the full compiler on any document that passes the
cheap checks, to additionally catchlayoutandballoon-placementfailures — the
two rules in the catalogue that were in the catalogue but unreachable fromcheck.
Off by default: it costs a real compile, including font metrics, andcheckstays
the cheap pass it is documented as unless asked otherwise.
Changed
-
long_shotreframes noticeably wider, andwidewith it — headroom0.14→0.28,
footroom0.06→0.10.solve/camera.pyadmitted the problem in a comment: with no
environment to show,long_shotandfull_shotcrop at the same landmark and could
differ only by a little headroom, so two rungs at the widest end of the ladder stayed
degenerate. There is an environment now, so a long shot can mean what it says — the
figure fills roughly two thirds of what a full shot does. Every existing panel that
asks forlong_shotorwiderenders smaller than it did. The comment is gone and
docs/reference/shot_types.mdis updated. -
PanelSyntaxErrorcarries an optionalruleandloc, so a check the frontend
performs itself can name a catalogue rule and a field instead of arriving as a generic
invalid-field. Both default to nothing, so every existing raise is unchanged. -
The determinism boundary is written down in
docs/reference/language.md: the
contract is on the emitted SVG text, which stays byte-identical, and has never been on
pixels.feTurbulenceis reproducible by specification and browsers still agree only
approximately on what to paint from it. Stated now, while adding the first feature that
depends on it, rather than left for somebody to rediscover when a screenshot test flakes. -
docs/explanation/prior_art.md: shape grammars move from future to load-bearing,
with the finding that no open-source Python CGA implementation exists — the reference one
is commercial, inside Esri CityEngine — so the formalism is reused rather than a library.
Notan, aerial perspective and COCO-Stuff are added as load-bearing; physically based sky
models (Preetham, Hosek-Wilkie) are recorded as examined and rejected, since they solve a
radiometric problem this compiler does not have. -
PuppetSpec.pose_anglesand.expression_statesraiseUnknownPoseErrorand
UnknownExpressionErroron a name the puppet does not declare, rather than a bare
KeyError. Both are alsoKeyError— following the precedentUnknownPuppetError
already set — soexcept KeyErrorand the documentedRaises: KeyErroron both
methods keep working unchanged.
Fixed
extreme_close_upframed the forehead, not the eyes. Its crop landmark (eyes)
sits inside the face rather than at its edge, and the anchoring rule bottom-anchors
every crop line — which put the eyes exactly on the panel's bottom edge and the rest
of the eye region, and the whole face centre, below it.extreme_close_upnow
carriesfootroom: 0.45, the only lever that can move a crop line off the bottom
edge; headroom cannot, because it shifts the figure down and shrinks it by exactly
the same amount.docs/reference/shot_types.mdexplains why in the Resolution
section, and the table now shows the footroom instead of—.scenet checksaid nothing about an unknownpose:orexpression:, thenscenet buildcrashed with a bareKeyError. The IR validates syntax and structure
without knowing the puppet library exists, sopose: smirkingpassed every check and
only failed once the solver tried to look it up.checknow resolves every cast
member'sreference,poseandexpressionagainst the puppet library — reading it
once per document, only when there is a cast to check — and reportsunknown-pose,
unknown-expressionand (newly reachable fromcheck)unknown-puppet, each with a
ruleIdand a location naming the field. This closes the `ch...
v0.5.0
Faces: a character can now look like something.
Added
- Faces. A character can now look angry, bored or asleep.
expression:on a cast
member selects one by name, exactly aspose:does — because a face is the same kind
of thing as a body: a small closed set of arrangements a character can be in. - The odd part was that the face was already in the contract and simply never drawn.
The puppets declaredeyesandchinlandmarks andeyes/mouthanchors,FaceSpec
reserved a disc no balloon may cover, and the emitter drew the head as one filled
circle. This is the rendering that was missing, not new modelling. - Ten expressions, and they are a drawing convention.
neutral,happy,laughing,
coy,bored,scared,sad,angry,shouting,surprise— Comic Chat's emotion
wheel plussurprise, taken from a system that actually rendered faces for live
conversations rather than from a psychology of emotion. They are the small closed set of
faces comics draw, not a claim that a person feeling anger produces this face;
Barrett et al. 2019 is recorded inprior_art.mdso that claim is never reintroduced. - Feature points, named after MPEG-4 FDP groups — brow, eye, nose, mouth — with a
mapping to MediaPipe landmark indices in the asset contract. The groups are the reusable
part; the standard's 66 displacements are a measurement, not a notation. No jaw: the head
is a circle that does not deform, so a jaw group would have nothing to move. looking_atfinally shows on the face. Pupils are aimed at whoever a character is
looking at, using a vector computed after placement and stored asCoreActor.gaze_aim.
The existinggazewas the head's forward direction — horizontal for every actor in
every panel, since no pose rotates the head — so a pupil offset by it would have shown
nothing that mirroring did not already show.CoreActor.face_marks, as sampled polylines and discs. Curves are sampled during
compilation, so everything an expression does is a number in Panel Core and the emitter
keeps making no decisions.scripts/contact_sheet.pyrenders every expression at every shot type onto one page.
Whether a furrowed brow reads as anger at fourteen panel units is not a question a test
can answer, and this is the instrument for answering it by looking.- Two gallery examples: ten expressions across a scene, and a big close-up that is the
first panel in the gallery to show a face at all.
Changed
- Level of detail. Below a threshold face radius no features are drawn, because five
of them inside a head a couple of dozen units across stop being a face and become a
smudge. Panels large enough to show a face are unaffected.
Upgrading
Nothing was removed and no document stops compiling. Two things a caller might notice:
CoreActorgainedexpression,gaze_aimandface_marks. A panel whose puppets
declare no features compiles exactly as before, but the shipped puppets now declare
some — so Core output for any panel usingaliceorbobhas changed, and a
golden file captured against 0.4.0 will differ.scenet.assets.contractgainedFeature,FeatureSpec,ExpressionSpecand the
three state enums. They are puppet-authoring types and are not inscenet.__all__;
expression:in a document is a plain name, aspose:is.
Known limitations
extreme_close_upframes the forehead rather than the eyes. The crop rule anchors a
shot's landmark at the bottom of the frame, which is right for every rung except the
tightest, where the landmark sits inside the thing being framed. Correct per
shot_types.md, which is normative, and newly visible now that there is a face to
look at.- An unknown
expression:is not reported byscenet checkand fails the build with a
bareKeyError, exactly as an unknownpose:has always done. Consistency was the
deliberate choice; the fix belongs to the checker.
Install
pip install scenet==0.5.0The VS Code extension is the attached scenet.vsix:
Extensions -> ... -> Install from VSIX...