Skip to content

File formats and compatibility ​

Every kind of file airZ Editor reads and writes, what each is for, and what to expect when a file moves between versions or to another player.

At a glance ​

FileWhat it isOpenImportSave or export
.airzAn airZ Editor documentOpen…Merge artboard from file…Save, Save As…, Export artboard…
.airzsceneAn airZ Editor document with the earlier file nameOpen…Merge artboard from file…Saved as it is when you save it
.airzplayThe playout graphic. A double-click opens it in airZ PlayerOpen…, Import playout graphic…Merge artboard from file…Export playout graphic…
.rivThe same playout graphic, under the name other players expectOpen…, Import playout graphic…Merge artboard from file…Export playout graphic… (For other players), Send to air…
OGraf manifest (.ograf.json)An OGraf graphic's description: its fields and actions—Data + › From an OGraf graphic…, or drop it on the stage: its fields as a view model. See Data panel—
OGraf package (.zip)The graphic, its fields and the airZ web player, for any EBU OGraf renderer——Export OGraf package…. See For an OGraf renderer
.bindings.jsonWhat the graphic lets someone change——Written with every Export playout graphic…
.airzversionsA folder of kept versions, beside the documentFile › Versions…—Keep this state
PNG, JPEGPictures—+ › Image, drop on the stage, pasteExport frame as PNG…, Export PNG sequence…
WebPA reference picture to trace over—View aids › Reference underlay—
SVGVector artwork—+ › Artwork (SVG)—
PSDLayered artwork—+ › Layered artwork (PSD)—
Lottie (.json, .lottie)An animation—+ › Animation (Lottie)—
HTML (.html, .htm)An animation written to the airZ HTML scene format, translated into a native graphic—+ › Animation (HTML scene), or drop it on the editor: see Bring in an HTML animation—
TTF, OTFTypefaces—+ › FontCarried inside the document
glTF (.glb, .gltf), OBJ, FBX, DAE, 3DS, STL, PLY3D models—Import Model…: see 3D objects—
HDR, or a PNG or JPEG panoramaA sky that lights the 3D scene—Import… in the sky library: see Sky and environment—
MP4, MOV, M4V, MXF, WMV, AVI, MKV, WebMA clip for a live video slot—Clip › Choose…: see Live video slots—

The document: .airz ​

Everything you made: every artboard, timeline, Animation States and view model, and the fonts, pictures and scripts they use. One file, so it can be sent to someone as it is.

  • It keeps what only the editor needs: folders in the panels, the default source of a live slot, the reference picture. Undo history is not kept: it starts again each time the document is opened.
  • A document from a newer editor does not open in an older one. The editor says: "Saved by a newer build … this build reads up to format …". Update the editor.
  • A damaged file says "The file is damaged (unreadable header)." Look for a version or an autosave: see Recovering a document.

The playout graphic: .airzplay ​

What goes to air. Export playout graphic… writes it, with its bindings.json beside it. On a computer with airZ Editor installed, a double-click opens it in airZ Player.

It is a standard .riv file under our own name. .airzplay and .riv hold the same bytes; choose For other players (.riv) when you export for another player, or for an older airZ Engine. Other players that read the format play it, with two exceptions they cannot know about:

WhatIn airZ Editor, the controller and airZ EngineIn another player
Live video slotsPlay their camera, clip or channelShow the placeholder
Scripts written in the editorRunDo nothing: they carry no signature other players accept

Everything else — artwork, timelines, Animation States, data, layouts, converters — plays the same everywhere.

Opening a playout graphic made elsewhere ​

Open… or File › Import playout graphic… reads an .airzplay or a .riv from any source into a new, untitled document. The import report then lists anything the editor has no place for, and any value it could not carry. Scripts that arrive compiled travel on untouched: their inputs can be changed, their code cannot.

A picture a script asks for by name is kept in the file on export, even when no Image object shows it. A layer a script draws inside a group keeps its place in the stacking order through import and export.

Import and export again, and the file you get is a new file written by this editor. For a file you only want to play, there is no need to import it at all: send it to the playout server as it is.

The scene compiler ​

Some features — the assistant, custom 3D materials — use the scene compiler, which comes with airZ Editor. Designing and exporting do not need it. Settings › Scene compiler says it is there, and its version. See Settings.

Pictures ​

FormatWhere
PNG, JPEGImport with + › Image in the Assets panel, drop onto the stage, or paste with Ctrl+V
PNG, JPEG, WebPAs the reference picture to trace over, under View aids — never part of the graphic. See View aids and zoom

A picture keeps its own pixel size. Import it at the size it is shown: a 4000-pixel photograph in a 400-pixel box costs memory on every playout server that plays it.

Export frame as PNG… writes the stage as it is now; Export PNG sequence… writes one PNG per frame, with transparency. See Export PNG and sequence.

Artwork and animation from other tools ​

FormatComes in as
SVGEditable shapes and paths
PSDA group per layer: pictures, and shape layers as editable shapes
LottieShapes and a timeline

Each is imported from the + menu of the Assets panel. Anything the editor has no equivalent for is left out, and named: one thing in the notice, two or more in the import report.

What a PSD brings ​

In PhotoshopIn airZ Editor
A picture layerA picture, at the layer's fill opacity
A picture layer with layer stylesA group named after the layer, with the same parts as a shape layer's. The styles follow the picture's vector mask, or else an outline traced from its transparency: shadows and glows below it, strokes along it, and inner styles (overlays, inner shadow and glow, bevel) in a copy of the outline over the picture, named layer (inside). The picture itself stays a picture
A text layerEditable text you can bind to data: its characters, fonts, sizes, colours, tracking, leading and alignment as text styles, its first baseline where Photoshop put it. In a font this computer does not have, see below
A shape layerAn editable shape: its outline with its curves, its solid or gradient fill at the layer's fill opacity, and its stroke, solid or gradient
A shape layer with layer stylesA group named after the layer, its parts in Photoshop's order: below it Drop shadow and Outer glow, each a blurred copy of the outline (a shadow moved by its distance, so you can drag it, and hidden under the layer where Photoshop hides it); on the layer itself, colour and gradient overlays, inner shadow and inner glow as extra fills, each with its blend mode; on top, Stroke, inside, outside or centred. A bevel comes in as highlights and shadows along the edges, close to Photoshop's but not the same, and the import report says so
A vector maskClips its layer by the path
A clipping mask on a shapeClips the layer above to the shape's outline; on a semi-transparent base, the layer shows only as far as the base does
A layer with the Lighter Color or Darker Color blendLighten or Darken: the same on black and white, close elsewhere, and the import report says so. A layer style's own blend mode, such as a Multiply drop shadow, is read as Photoshop stores it
A groupA group, with its layers
A group with a blend mode or a soft maskLooks as it does in Photoshop: a group drawn as one, its layers on an artboard of their own, still editable, drawn in the group's place with the group's blend mode, opacity and mask (the mask comes in as a picture asset, file/group mask). A Pass Through group's mask is applied to its layers directly
An adjustment layerLeft out, and named in the import report

The import report names a layer clipped to a picture rather than a shape: it comes in, but it is not clipped.

When the PSD's fonts are not installed ​

Fonts that are not installed: each font with the layers that use it and a menu, As text in a stand-in, and Cancel and Import

If the file's text uses fonts this computer does not have, the editor asks first, under Fonts that are not installed: "This file's text uses fonts this computer does not have. Bring the text in as editable text in a stand-in font, or as a picture that looks exactly as in Photoshop." Each font is listed with the layers that use it, "Used by …", and a choice:

ChoiceWhat comes in
As text: stand-inThe usual choice: editable text in a font this computer has, with the same weight and slant; a condensed font gets Bahnschrift, set condensed
As text in another font…Editable text in a font you pick
As a pictureA picture of the text that looks exactly as in Photoshop, with its layer styles

"Install a font and choose it in the text's font row later for Photoshop's look." Cancel stops the import. The import report names each missing font and its stand-in. A text in a stand-in font comes in without its layer styles, and the report says so. See Fonts look wrong.

Fonts ​

TTF and OTF. A document carries the fonts it uses, so it opens and plays the same on any machine. Check a commercial typeface's licence before a document leaves your facility: see Licensing and Fonts.

See also ​

airZ Editor manual