Repository navigation
Project Format
A project is a zip (.fmv; before 0.90.0 .formvis, still read) holding manifest.json and an images/ folder. formvis writes format com.nodemode.formvis version 1 and reads that and, since 0.97.0, NodeMode canvasor's com.nodemode.canvasor version 1 (.canvasor, a zip). Since 1.40.0 it also opens .comp projects (a zip, .comp.zip or the package folder), which share this layout and name themselves with a reverse-DNS id ending in .project at versions 1 to 7; they are recognised by that shape, held to the same validation, and saved as .fmv. formvis never writes .comp. A canvasor project has the layout below under its own id: layers bottom to top, each transform an origin and a displayed size that may differ from its image's size; it opens through the same reader and saves as .fmv. (NodeMode's canvasor plugin also saves *.canvasor.json, a different format that formvis does not read.)
| Manifest key | Meaning |
|---|---|
format, version
|
Format id and version |
colorSpace, resolution
|
Always sRGB; pixels per inch (72 when absent) |
documentID, width, height
|
Document id and canvas size in pixels |
activeLayerID |
The selected layer |
layers |
Bottom-to-top layer records |
alphas |
Alpha channels (1.65.1): each id, name and file, a grayscale PNG the canvas's size in images/ (white selected); absent when there are none |
patterns |
The patterns the layer styles use that are not built in, so the project opens the same elsewhere: each id, name and file, a PNG in images/; Pattern Overlay's, from 1.65.2 Bevel & Emboss's Texture's, and from 1.66.0 pattern fill layers' |
| Layer key | Meaning |
|---|---|
id, name, isVisible
|
Identity and visibility |
transform |
origin [x, y], size [w, h], rotation degrees, flipX, flipY, sampling (Nearest, Smooth, High quality) |
imageFile |
images/<id>.png, absent for folders and adjustments |
parentID, isGroup
|
Folder membership and folder flag |
opacity, blendMode
|
0 to 1; blend label such as Multiply or Color Dodge
|
maskFile, maskEnabled, maskLinked, maskPlacement
|
Grayscale mask PNG (white shows), on or off, follows the layer or not, where an unlinked mask sits |
maskSourceID |
The layer this one is clipped to |
linkID |
Layer > Link Layers (1.65.3): layers with the same value move and transform together; absent is unlinked, and a value no other layer holds links nothing |
effects |
The layer style: each effect by name (dropShadow, outerGlow, stroke, innerShadow, innerGlow, colorOverlay, gradientOverlay, patternOverlay, satin, bevel), extra holding further instances; from 1.65.2 hidden (Hide All Effects), Bevel & Emboss's technique, contour and texture, and its style stroke, which older projects lack and older formvis reads as no flag, Smooth and Inner Bevel |
adjustment |
Kept verbatim; kind is Hue/Saturation, Levels, Curves, Exposure, Gradient Map or Grain
|
shape |
Shape description, kept verbatim |
fillContent |
A fill layer (1.66.0), its pixels as drawn in imageFile: kind solid with color {r, g, b}; gradient with stops (each at 0 to 1, color, alpha), style (linear, radial, angle, reflected or diamond), angle in degrees, scale (1 is 100 percent), reverse, dither, align and offset {x, y}; or pattern with pattern (a pattern id), scale, angle, link and phase {x, y}. Older formvis opens it as a pixel layer |
- Field names and value labels match exactly; never rename them.
- Unknown fields inside
adjustmentandshapesurvive a round trip. - A reader rejects versions it does not know instead of guessing.