Docs menu: Documentation
Documentation homeDocumentation
MSX is a vector graphics format with a DixScript source layer and a compact binary layer. These pages explain how to write scenes, what each element and def does, and what each renderer supports.
Start here
What MSX is, how to run it, and how a scene is put together.
Introduction
What MSX is, the two layers of the format, and the path from source to pixels.
Quick start
Build the tools, render a first scene, compile it to binary and check the roundtrip.
How a scene fits together
Canvas, defs, elements and animations, how ids connect them, and the coordinate system.
Authoring
Source files, the canvas, styling and transforms.
Source files and DixScript
File sections, QuickFuncs, enums, interpolated strings and color literals.
Canvas and viewbox
Scene size, background color and the optional viewbox.
Style and paint
Style keys, defaults, paint values and which renderer honors what.
Transforms
The three accepted transform shapes and the order a chain applies in.
Importing SVG
Reading an SVG file into MSX source, what the importer resolves and what it reports.
Elements
Every drawable element type and the fields it accepts.
Element overview
All fourteen element types at a glance, with required fields and renderer support.
Basic shapes
rect, circle, ellipse and line.
Paths, polylines and polygons
Path data, point lists and closed shapes.
Text
The text element, its style keys, and where it renders.
Groups and use
Grouping, shared transforms and reusing an element by id.
Layers, blend modes and effects
Isolated compositing buffers, blend modes, effects, clipping and paint order.
Signed distance fields
Shape trees built from primitives and boolean operations, evaluated per pixel.
Gaussian splats
Soft elliptical blobs with a Gaussian falloff.
Images and audio
Embedded or referenced image elements and audio defs.
Defs
Gradients and shaders, referenced by id from fills and strokes.
Gradients
Linear, radial and conic gradients, stops and bounding-box units.
Shaders
WGSL fragment shaders as fills, uniforms, the time clock and the fallback color.
Animation
Keyframe tracks, easing and loop modes.
Internals
The renderers and the binary format.
Rendering backends
What the SVG, CPU and GPU renderers each support today.
Binary format
The compiled layer: header, string pool, tags, compression and versioning.
Reference
Command line usage and the complete specification.