elevation-ink은(는) 무엇을 하나요?
This skill turns an architectural elevation into an illustrated, animated scene. The building is a clean measured line redraw, simplified but with no information lost. Fills are either a small editorial colour palette or distinct grey tones, laid under the lines. A foreground the user chooses (a park, a plaza, a street, or nothing) lives in front of the building. Output is a single self-contained HTML page plus MP4 clips.
Input matters most. The closer the input is to a true elevation, the better the result: a CAD elevation, a frontal drawing, or a photo taken square to the facade from far away with a long lens. Strong perspective (a corner view, a view down a street) loses information that has to be guessed. Ask for the most frontal image available. If only a perspective exists, say which parts will be assumed.
The quality comes from measured hand redraw, not automatic vectorising. Automatic CAD simplification (measure/) is a measuring aid only.
Files
template/scene.ts the scene: sky, building block (EXAMPLE, replace), colour pass, trees,
people, avenue, framing, capture hooks
template/shell.html page shell the build inlines the bundle into
template/people.ts walkers and pigeons; template/kit.ts colour and maths helpers
lib/ ink, motion and gait from line-art-animation (MIT, see LICENSE file)
scripts/build.sh bundle a scene into one HTML page (esbuild)
scripts/check.sh information-loss check against the source image
scripts/record.sh record 16:9 and 9:16 MP4s
scripts/export.ts export one moment as SVG and PDF (vector) and high-resolution PNG
scripts/capture.ts deterministic headless Chrome frame capture (?debug)
scripts/missing_lines.py the diff behind check.sh
measure/ optional PDF/DXF/SVG readers and pen-group inspection for measuring
measure/raster_lines.py trace a raster elevation into H/V/other line segments with weights (a measuring aid)
references/style.md line weights, palette, colour rules, scale table
references/foreground.md foreground options and the depth convention
template/snippets/ paste-in blocks: desert planting (palms, cactus, agave, tufts)
examples/ example output (the terrace scene)
Setup, once per session: copy the skill folder to a work directory, then run npm i -D esbuild. Node 22.18 or later runs .ts directly. Chrome or Chromium must be installed (set CHROME= if it is not found). ffmpeg is needed for video.
Workflow
Follow these stages in order. Each one that asks the user waits for the answer; if the user is away, stop and wait rather than choosing for them.
Write every question, message and file in English. Use the wording in "Question script" below so every session asks the same way.
- Check the input. Analyse the uploaded image or drawing before anything else.
- Suitable inputs are views close to a true elevation: a CAD or drawn elevation, a frontal rendering, or a photo taken square to the facade from a distance.
- If the view is not suitable (a corner view, a view down a street, strong foreshortening, the facade mostly hidden), say so plainly. Explain what would be guessed, and ask for a view closer to an elevation. Do not start drawing from it.
- If it is suitable but not perfect (slight perspective, a low camera), say which parts will be corrected or assumed, then continue.
- Ask the style, the season and the time of day. Ask three multiple-choice questions together.
- Style: Colour or Grey tones.
- Season: Spring, Summer, Autumn or Winter. The scene shows only that one season, from the first frame to the last (
?season=, setSEASON_DEFAULT). Winter has bare deciduous trees, dry grass and light snow. - Time: Day, Night, or Day to night (dusk over the length of the clip) (
?time=day|night|dusk). At night the drawing is darkened and cooled, about half the windows and every shop are lit, lamps glow and a few stars show; at dusk they come on one by one.
- Draw the building. Measure it, redraw it, and check it for lost information and identity (see "Drawing the building" below). Draw the building and its own ground only; do not add a foreground yet.
- Ask about the foreground. If the input has nothing in front of the building (no street, plaza or garden shown), ask what should fill it, as a multiple-choice question.
- Offer the options from
references/foreground.mdthat fit the place, with the one you suggest first and a short reason. - There is no default: a road is only one option. Never carry a foreground over from a previous scene.
- If the input already shows its surroundings, use them and say so.
- Offer the options from
- Show one 16:9 review image. Build the page and capture a single 16:9 still (
?debug, 1920x1080). Show only this image; do not render 9:16 or any video yet. Before showing it, check it at full size against the "finished picture" rule and the identity check. - Ask for changes. Ask what to change. Make the changes, show the updated 16:9 still, and repeat until the user is happy.
- Export stills (on request, or with the videos). Run
node scripts/export.ts page.html out/name --at <s>with the same flags as the approved still (for example--query "style=grey").name.svgis a vector file for Illustrator or Figma. Styles are written onto the elements, blending is flattened to plain fills, and scene groups are kept.name.pdfis a vector file for print.name.pngis 4K by default (--png-width).
- Make the videos. Only after the user approves the still, record both clips with
scripts/record.sh page.html out/name.name-16x9.mp4shows the whole scene.name-9x16.mp4slides from left to right across the whole scene.- Both are 29 s at 30 fps. Deliver the two MP4s and the HTML page.
Question script
Ask with the multiple-choice question tool where available; otherwise as a numbered list. Put the recommended option first and mark it "(Recommended)" with a one-line reason.
Stage 1, input not suitable (stop here):
This image is not close enough to an elevation to redraw faithfully. It is a [corner view / view down the street / strongly foreshortened view], so [the side facade, the true heights, the depth of the setbacks] would have to be guessed. Please upload a view closer to a true elevation: a CAD or drawn elevation, a frontal rendering, or a photo taken square to the facade from across the street.
Stage 1, input suitable (one or two sentences, then stage 2 in the same message):
This works as an elevation. I'll correct [the slight perspective / the low camera angle] and assume [what is assumed].
Stage 2, three questions together:
- Style: "Which style should the illustration use?"
- Colour: warm editorial palette, flat fills under black line
- Grey tones: distinct greys, black line
- Season: "Which season should the scene show? It stays the same for the whole video."
- Spring / Summer / Autumn / Winter
- Time of day: "What time of day?"
- Day / Night / Day to night (dusk falls over the length of the video)
Stage 4, only if nothing is shown in front of the building:
"What should fill the foreground in front of the building?" Offer 3 or 4 options that fit the place, recommended first. For example: Park edge (Recommended: [reason]) / Plaza / Street / None.
Stage 5, with the review image:
"Here is the 16:9 review image. What would you like to change? If it's ready, I'll make the 16:9 and 9:16 videos next."
Stage 6, after each round of changes:
"Updated. Anything else to change, or shall I make the videos?"
Stage 8, delivering:
"Here are the 16:9 and 9:16 videos and the HTML page. I can also export the still as SVG, PDF or a 4K PNG."
Drawing the building
Converting a photo or rendering:
- Pick the elevation the image looks at: the face seen most nearly head-on. Measure at the facade plane.
- Recover true proportions. Use people (1.72 m), doors, rails (1.435 m gauge) and panel modules as rulers, measured at the plane of the object they stand in.
- Undo perspective: verticals stay vertical, receding parallels become one line, foreshortened depths become true sizes. Equalise rows and columns that perspective compresses. Drop side faces that show only because of perspective.
- Place things by real-world layout, not by their x in the picture: rebuild the plan logic first (widths, setbacks, where supports land).
- Where two elements meet in the picture, make them share one edge. Never leave two near-parallel lines forming a sliver.
- A row of trees or posts running into the depth reads as one tree or post. Elements seen from below (soffits, bellies) get their true silhouette.
- Characteristic surface patterns (letters, graphics, cushions) are part of the architecture. Render them as a pattern, not as the exact text.
- Note every assumption, such as a clearance or a depth, in the reply.
Measuring:
- Put the source in its own folder.
- Read positions from gridded zoom crops (25 px grid, labelled every 100) and from pixel row and column scans.
measure/raster_lines.py --contrast 24traces raster lines and their weights as a measuring aid. It is never the drawing, because it breaks frames and misses grey lines.- Set
SRCto the image size,UPMfrom a known dimension, andGY(x)from the ground line. Treat the drawing as orthographic. - Author the building in the source's own px inside a group scaled by
UPM / sourcePxPerMetre, so people, vehicles and trees keep the scene's calibrated scale. Multiply line weights by the inverse scale inside that group.
Redrawing:
- Replace the
EXAMPLE BUILDINGandEXAMPLE ROOFblocks in a copy oftemplate/scene.ts. - Author clean components: windows with panes, surrounds and sills; railings; cornice bands; rustication; hoods; arched doors; slat screens.
- Use
hide()for occluding areas andink()for lines, following the weight hierarchy inreferences/style.md. - Register colour roles (
R.glass,R.shop,R.fascia,R.focal,R.roof,R.lobby) as you draw. - With many materials, draw opaque flat fills first and every line in a group above them. Patterns that belong to a material (brick courses, timber grain, slats) go with the fills, under the glazing. Where two volumes meet, shape the lower area to follow the upper edge rather than stacking colours.
- Remove glass reflections and interior views seen through glass. Replace real tenant names, brands and artworks with blank sign bands and abstract gestures.
Checking:
- Lost information: run
scripts/check.sh page.html source.png overlay.png --exclude ... --contrast 30. Exclude annotation (level lines, grids, dimensions, text, the area outside the building). Fix every reported run that is real geometry. Faint lines count as missing too. The rule: simplify, never drop information. - Identity: put the source and the render side by side at the same scale and look for what reads differently, not only for missing lines (see Pitfalls).
Foreground and life:
- Fit trees, people, vehicles and furniture to the chosen foreground, at the true scale in
references/style.md. - Use one consistent depth oblique (
references/foreground.md). Everything is a pure side elevation; never use 3/4 views.
Defaults (the house style)
- Framing.
- The default is 16:9, the whole elevation.
- 9:16 (
?ratio=9:16) is a portrait camera that slides from the left end of the whole scene to the right end over the clip, with a short eased hold at each end, so the video shows everything.?pan=<s>sets the slide time (default 29 s, the clip length). Build the scene at full 16:9 width; only the camera is portrait. - Set the
VBcentres for each scene.
- A finished picture, even as a still. No part of the frame should read as empty. Use these layers:
- ground with tint and texture (paving, lawn strips, a path to the entrance)
- a background layer between the trees (pale low buildings, canopies)
- a few flat clouds
- framing elements at the near corners (a tall tree or palm cut by the frame, plants at the bottom edge)
- enough people at several depths, including groups and children, each with a soft flat shadow Check the still at full size before calling it done.
- Opening. The scene opens complete. There is no draw-on (
?drawonbrings it back). Life is moving from frame one. - Sky. Very pale blue at the top, fading to white at the horizon. Everything that masks the sky (canopies, figures) fills with the same user-space gradient.
- City behind. Background buildings are very light grey masses with light grey lines, kept apart from the sky.
- Lines.
- Black and greys only, in the weights W1 to W4.
- Lines are clean: no wobble, no overshoot, no doubled strokes.
- Style: colour or grey tones (asked in stage 2).
- Colour is a flat editorial palette under the lines, in the manner of a printed city poster. Rules and roles are in
references/style.md. - Grey tones (
?style=grey) gives every fill a grey chosen for its role. Known material colours have designed greys inGREYS; any other colour maps by lightness along a curve that keeps whites white and lifts darks off black. The mapping applies wherever a colour is set, so seasonal trees and moving figures stay grey too. - Either way: no print misregistration, no grain, no gradients on objects.
?monogives the line-only version.
- Colour is a flat editorial palette under the lines, in the manner of a printed city poster. Rules and roles are in
- Living things.
- Trees have green lines that differ slightly from tree to tree, with a pale wash of the same colour as fill.
- Their colour follows the chosen season: fresh green in spring, varied greens in summer, yellows and oranges in autumn with leaves falling, bare branches in winter with snow.
- Trunks are brown and grass is green.
- The tree kinds are oval linden, round, cypress and cloud-pad pine. Do not use triangle conifers. Ground cover is meadow grass and planters.
- Motion must agree with itself.
- Vehicles are drawn facing right and mirrored when they move left, so the front always leads. Two-way streets put the near lane to the right and the far lane to the left (
?onewayfor one-way avenues). - Walkers alternate directions, so people always move both ways.
- Clouds, falling leaves and the lean of trees all follow the one wind value, in its direction and in proportion to its strength.
- Vehicles are drawn facing right and mirrored when they move left, so the front always leads. Two-way streets put the near lane to the right and the far lane to the left (
- Season and time. One season per scene and one time of day (or the day-to-night change), chosen in stage 2 and kept for the whole clip.
?cycleturns the year instead, for a special request only. For a new scene, register glazing inR.glassand lamps inLAMPS, so night lighting finds them.
Pitfalls
-
Keep the building's identity. Before delivering, put the source and the render side by side at the same scale and look for what reads differently, not only for missing lines. Check these:
- Glazing tone: a drawing's mid-grey glass turned pale changes the whole facade.
- Material colours: take them from the source (brick, timber, slate), quieted but recognisable.
- Emphasis: a minor element (a fin, a band) must not become a dominant stripe.
- Additions: lit windows and scenes stay at 10 % or fewer on a drawing and never go into feature volumes.
-
Many materials: draw opaque flat fills first, then every line in a group above them. Do not multiply-blend stacked colours. Patterns that belong to a material (brick courses, timber grain, slats) go with the fills, under the glazing, so they never cross a window.
-
Run a Write over a file only after reading it.
-
Use esbuild bundles inlined into one page. Do not use a dev server, because it dies during captures.
-
Keep
SRCequal to the source size, orcheck.shcompares the wrong frames. -
After big moves, re-check the occlusion order: building, then far lane, near lane, near props, near people.
-
Never publish a confidential drawing, or a page or video made from one, anywhere public.