Kalpana Designer

Add motion to layers: presets (fade_in, slide_in_up, pop_in, spring_in, bounce_in, tilt_in, blur_in, wipe_in_right, draw_on, pulse, float, spin, shake, drift, count_up, count_down, orbit, ring_spin, peel and the outs) placed at a start time, raw keyframes per property (with springs), word or letter text reveals (typewriter, scramble), shape morphs between a vector layer's shapes, and stagger to cascade a motion over a layer's children. Motion adds to what a layer has unless replace is set; the timeline grows to fit. Check it with render_contact_sheet. A template with motion can still fill batches as images. Each image shows one moment of the motion. The default moment is the last frame. An outro or a loop can make the last frame a bad image. Find the moment where all the content shows (render_contact_sheet, render_timeline), ask the user if you are not sure, and set that second with set_timeline still_time.

Evaluate arithmetic exactly instead of estimating: + - * / % ^, parentheses, pi, trigonometry in radians (rad() and deg() convert), sqrt, abs, min, max, round, floor, ceil, clamp, lerp, pow, hypot, atan2, ln, log10, exp. One expression, several named ones, or one expression over a range.

Films the design's layers with a camera: push in on a detail, pan across, roll, tilt in 3D, pull back out. Stops give time, zoom (1 = whole design), the focus point at the centre of the shot, and rotation/tilt. The layers move into a design-sized Camera frame at the back (their positions do not change); kinetic type and transitions stay on screen above the shot. Calling it again replaces the move.

Layout problems after layout: text over other text, layers cut off by a clipping frame or running off the canvas, text too small for the size the design is seen at, and text with too little contrast on what is behind it. Each issue names the layers and has a severity (error or info; info is often on purpose). Confirm an issue with render_design before changing the design. Opt-in craft checks with craft: true.

Remove all motion of layers, or only some properties (shape removes a shape morph with its outlines).

Exact colour answers: WCAG contrast of two colours (and whether it passes for body and large text), the most readable text colour on a background, a 50-900 tint and shade scale of a colour, or a mix of two colours. ops runs several at once.

Start a new design: a canvas of the given size (1080x1080 post, 1080x1920 story, 1920x1080 slide or banner) with a background. Returns the page_id that every other design tool takes. Add content with create_layers.

Add layers (frames, groups, text, rectangles, ellipses, lines, images from a URL, and vector paths from SVG path data) to a design, nested with children in one call. Frames with a flow arrange their children in a row or column, so build text stacks and button rows as flows instead of placing each line by hand. Returns the new layer ids; change them later with update_layers. Layout problems (overflow, overlap, text off the page) this call made or changed come back as layout_issues.

How designs, layers, templates and these tools fit together: the model, the working loop, placing layers, numbers, motion, and going from a design to a batch of images: the reference for a first design.

Copy pages. Each copy keeps its layers, names, motion and input descriptions. A copy never replaces a page or a template. With template_id, the copies are added to that template (it can be the pages' own template). Without template_id, a new template is made and the first copy is its first page. To copy a whole template, give all its pages from pages list. With width and height, each copy gets that page size, and the flows and constraints place its layers again: render the copy and adjust it for the new size.

Tune existing motion one keyframe at a time: add a keyframe, move one in time, change its value or easing (or hold), delete one, or shift a layer's whole motion earlier or later. Keyframes are found by track and time; read them with get_design timeline_detail. animate with tracks replaces a whole track instead.

Move layers to another parent or position, delete, duplicate, wrap siblings in a group or a flow frame, mask, combine shapes with a boolean (union, subtract, intersect, exclude), unwrap, scale layers with everything inside them, change paint order, align and distribute. To change a layer's own properties use update_layers.

Images in this workspace (photos, logos, product shots), newest first, or those whose file name contains search or that are in a collection, with a numbered preview sheet to see them. Without filters the reply also names the workspace's collections: when the user says where their images are ("the Diwali photos"), look in that collection. Each image comes with its image key, the key a design places it by, its asset_id, the id the same image has in batch rows, and its name and pixel size. Place one with create_layers type: "image" (or image in a fill) and fit. An image layer is a template input, like text: name it by role ("Product photo", "Brand logo"). A new image from an https URL is stored in the workspace when it is placed.

Outline of a design's layers after layout: id, type, name, box [x, y, w, h] in design px, text, colours, layout flow and each layer's etag, plus the fonts used. Read it before changing a design; render_design shows how it looks. timeline: true adds what moves on each layer and when (the keyframes of node_id when given).

Add an SVG (icon, logo, illustration, a drawing made elsewhere) as editable vector layers inside one group, from its markup in svg: paths, rectangles, circles, lines and polygons with their fills, strokes, linear and radial gradients and transforms. Each becomes a group named from its id, data-name or inkscape:label, and each shape keeps its name, so update_layers select and animate can find them. Text, images, masks, clips, filters and are skipped and listed in skipped. Returns the group and every layer made.

Lay out a phrase word by word, measured by the real text engine (wrapping at width, words sharing a baseline), with emphasis on chosen words (colour, style, size, tilt, a highlight pill) and motion that gives every word its own path: fly, drop, scatter, pop, wave, glitch, zoom; exit_at sends them out. Seeded, so it varies per phrase but repeats exactly. Returns the group id and the block's size.

Font families in Kalpana's library for this workspace (the global library and the workspace's uploads). Only these can be used: a design and its batches load fonts from Kalpana, and a font_family outside this list is refused. Without family: the family names. With family: that family's styles (style name, weight, italic), or the families whose name contains it.

Procedural fills: dot grids and halftone, grain and mesh gradients, god rays, noise, waves, dithering and more. Fill with {shader, preset, params, speed}; speed: 0 keeps it still. With name: its settings, defaults and presets.

The one Kalpana workspace this connection designs in, chosen when the user connected: its id, name and whether its designer subscription is active. Every tool works in this workspace, so none takes a workspace id. Designing in another workspace needs a reconnect that chooses it.

An animation inside one design, not a multi-slide post: cards (image, title, subtitle) on a track that steps to the next card every step seconds; the centred card sits flat, its neighbours swing back in 3D (tilt), smaller and shaded. For an Instagram carousel make one design per slide instead.

Draw a chart from numbers as editable layers in a design: line, area, bar, horizontal bar, stacked bar, scatter, donut, pie, sparkline, progress ring, gauge or radar. Every point, bar, tick and label is computed exactly. Pick a style, a palette and a font_size; never hand-write chart paths.

A pointer (arrow, a named pill, or a touch dot) that glides through stops ({x, y, t, click}) with eased moves; each click presses the cursor and spreads a ripple. Use it to walk through product UI. It sits on top.

Rows of UI (a ranked list, inbox, settings, search results) with text and an optional value on the right; rows spring in one after another and a highlight slides from row to row at the select times. Pair with make_cursor clicks at the same times. static: true builds a still list or table instead.

Fill a region with many small shapes (dots, rings, sparkles, stars, plus, cross, pills, squares, triangles, blobs) spread by a seed: no clumps, no grid, sizes leaning small, some out of focus for depth, colours from a palette, a box kept clear behind text. Motion: float, twinkle, burst (from a point), rain, rise, pop, or still. Sits behind the other layers unless front is set.

Shapes that cover or reveal the design: circle (rings of colour grow from a point), stripes (tilted bands sweep across), blades (panels slam shut and part) or burst (rays, then a flood). part: out ends fully covered at at + duration; part: in uncovers from 0. It sits on top of everything.

The real size of text in a font as the renderer lays it out: each line and its width, the height, and whether the last line is a widow; or the largest font size that fits a box (width + fit_height). With page_id + layer_id it measures a text layer of that design. texts measures many at once, and pack lays them out as chips in rows. Use it before placing text instead of guessing.

A template has one or more pages, each a design of its own (its own size and layers): a post, a story and a banner of one campaign, say. Every page's id is a page_id the design tools take. list the pages of a template (template_id), rename a page (page_id, name) or delete one (page_id; a template keeps at least one page). To copy pages or templates, use duplicate. To add an empty page, use create_design with template_id.

Where to put N items: around a circle, along an arc, in a grid, evenly along a line or a path. Returns each centre, the top-left x/y for an item of item_size, and the rotation that faces along the layout. Use it for radial menus, timelines and grids.

Frames of the design's animation tiled into one PNG, left to right and top to bottom: evenly spaced frames from start to end, or exact times. One call checks a whole animation; a design without a timeline gives one frame. Returns the times shown. For one moment at full size use render_design with time. Previews are PNGs at most 800 px on the longest side, with a faint repeating "Kalpana preview" mark. The mark is only on previews; the design, its exports and batch renders do not have it, and sample_points read the design's own colours. Zoom with region or node_id to check small text or detail.

A PNG of the design, rendered as it will export. Check the work with it after each meaningful change. Zoom with region or node_id, read pixel colours with sample_points, or judge shapes with hide, only and mode; time shows one moment of an animation. For layout problems as data use check_layout; for many moments of an animation use render_contact_sheet. Previews are PNGs at most 800 px on the longest side, with a faint repeating "Kalpana preview" mark. The mark is only on previews; the design, its exports and batch renders do not have it, and sample_points read the design's own colours. Zoom with region or node_id to check small text or detail.

The timeline as a diagram, not a frame: a time ruler, a row per animated layer with a bar over its motion, and under it a row per property with keyframe diamonds; where the motion ends is marked. Check timing and overlap here, then get_design timeline with node_id for the keyframes to change. node_ids limits it to layers; properties: false shows layer rows only.

The workspace's templates, still and animated, newest first, or those matching query (an exact template id, or words of a name, description or campaign topic). Each comes with its template_id, name, size, whether it is animated, a preview image URL and a link that opens it in Kalpana. To edit one, pages list with its template_id gives each page's page_id for get_design and the other design tools.

Feedback for the people who build these tools, not for the user: a tool, its arguments or the design guide that was confusing, missing something, wrong, or that worked especially well, with what was tried, what happened and what would have helped. It is for when a tool or the guide got in the way; nothing needs sending when none did. It holds no user content (their copy, names, image URLs or brand details). Free, and it changes nothing in the design.

Camera moves and morphs between layers for the design, in the stored format (read the current value with get_design timeline). {} clears it. A flow alone (slides in order joined by transitions) is compiled into the camera and morphs it plays. Validated before saving; the timeline grows to fit the flow.

The name and description a template is saved with, and what each input may hold. Name: short and specific, e.g. "Ember Roasters autumn menu". Description: a sentence on what it is and where it is used. inputs: a description per text or image layer, by its id or name, saying what it holds and how long it can be ("Headline: up to 2 lines, about 45 characters"); batches show it to whoever fills the rows, and "" clears one. It also saves every change still waiting to be saved, so call it last: the template is then ready to fill with data.

Set the design's animation length in seconds (at most 30) and its frame rate.

Exact SVG path data for a shape (arc, sector, ring, rounded polygon, star, spiral, wave, gear, arrow, blob, comic burst (jitter, seed, aspect), smooth line through points, the graph of a function), a stroke's filled outline, a boolean of paths, or the gap between two shapes. layer_gap with page_id gives the gap between two placed layers. Returns paths, width and height to pass to a vector layer in create_layers.

Start times for N items that cascade: a fixed step apart or spread over a total, evenly or easing in or out. Pass the times to animate.

Revert the latest change of a design. Returns the revision the design is now at.

Change existing layers: position, size, rotation, visibility, opacity, blend mode, masks, fills, strokes, radius, shadows, blur, image zoom and focus, vector paths, text and its style, flows and sizing in a flow. Only the given fields change. To move, wrap, delete or align layers use edit_structure. Layout problems this call made or changed come back as layout_issues.

Bring the user's own images (PNG, JPEG or WebP, up to 5 MB each) into the workspace, optionally into a collection (made when it does not exist). Without files: a link to the workspace's Images page (the collection's page with collection) for the user to open and drop the images into; after they say they are done, find them with find_images and that collection. When you have the files yourself (a shell, files on disk): pass files with each one's SHA-256 hash, content type and size, PUT each file's bytes to its upload_url with that Content-Type header, then call again with done (each hash and file name) to record them; the reply gives each image's image key for create_layers and its asset_id for batch rows. Never send image data as base64. Images already on the web can be placed straight from their https URL instead.