Heimdall3D Manual

Directory Opus · Windows Explorer

Heimdall3D’s manual covers every card in the Windows viewer for 3D models and HDR images, shown as a picture with its toolbar button and each control described, and a search finds any word.

Camera

Look

Rigging

Animation

Scene

Read

Make

Recall

Print

2D

Image viewer

The toolbar

Alerts

Explorer and licence

Gulltopp

Portfolio

Camera

Viewpoint

The Viewpoint card places the camera at a named pose and sets its lens.

The Viewpoint card

The card's title shows the pose the camera is at; it shows "custom" after you drag the view. The lens is read on a camera body, and the body's sensor size is shown at the foot of the card, for example "36 × 24 mm full frame, vertical fit". Every slider returns to its default on a double-click; the Reset button restores all defaults.

Choosing a body keeps the picture exactly as it is and changes the millimetres the Lens reads, so a view can be matched to a real camera.

Hold Shift and drag with the middle mouse button to pan. With the orbit camera, the point the camera turns around slides across the screen, so the model moves with your hand while the angle and zoom stay; with the free camera, the camera slides sideways and up or down and keeps looking where it looked; and while walking through a capture, the walker steps sideways and forward or back along the ground. While you look through a scene camera made on the Cameras card, the gesture slides that camera's picture in the view, up to one view's width or height each way. The camera itself stays where it is, so what it records is unchanged, and the view keeps looking through it. The slide stays until you slide it back or look through another camera. The gesture works over a card or the toolbar too, where it pans the view behind it, and Viewpoint's presets and Reset bring the centre back to the model.

isometric The classic isometric view from above a corner.
iso 2:1 The 2:1 isometric used for pixel art, where each diagonal line steps two pixels across for one down.
front A view of the model from the front.
right A view of the model from the right.
back A view of the model from the back.
left A view of the model from the left.
top A view of the model from the top.
bottom A view of the model from the bottom.
Parallel (orthographic) The camera draws without perspective, keeping parallel lines parallel and sizes equal at every distance.

Isometric views use orthographic projection.

Lens The focal length in millimetres, 12 mm to 400 mm.

The track is logarithmic so the wide lenses have room. A shorter lens sees more of the scene; a longer one sees less and flattens depth.

Field of view The vertical angle of view in degrees, from about 3 degrees to 90 degrees.

The default is 40 degrees. Moving either this or Lens moves the other.

14 Set Lens to 14 millimetres.
24 Set Lens to 24 millimetres.
35 Set Lens to 35 millimetres.
50 Set Lens to 50 millimetres.
85 Set Lens to 85 millimetres.
135 Set Lens to 135 millimetres.
FF Camera body: 36 × 24 mm full frame.
S35 Camera body: 24.9 × 18.7 mm Super 35.
APS-C Camera body: 23.6 × 15.6 mm APS-C.
M4/3 Camera body: 17.3 × 13 mm Four Thirds.
Phone Camera body: 9.8 × 7.4 mm phone sensor.
Near clip from nearest surface The camera's near clipping plane moves in to stand just short of the nearest surface in view.

This switch is on by default. A close-up of a surface stays whole.

Near clip Brings the near clipping plane closer to the camera, as a share of where it would otherwise sit.

The slider ranges from 1% to 100%, with a default of 100%. Use this for work very close to a surface.

Camera

Cameras

Switch between named views of the scene and key camera positions as the animation plays.

The Cameras card

The scene's cameras are listed as cells in the card. Pressing a cell cuts the view to that camera at the playhead, and the cut is recorded on the timeline's camera cut row. As the animation plays or the playhead moves, the view switches camera at each recorded cut. Picking a camera row in the Scene list does the same as pressing its cell.

Add camera Add a camera at the current view and cut to it at the playhead.
Look through Show the view through the picked camera.

Look through switches between the camera's view and the pane's own view. A camera is picked by pressing its eye in the pane in Edit, or its row in the Scene list.

While looking through a camera that is not picked, turning, flying or orbiting the view by hand, or sliding it with the middle mouse button (with or without Shift), hands the view to the pane's own view at the same place, and Look through goes back to the camera. The mouse wheel zooms the camera's picture about its centre and the camera stays where it is. Turning the wheel back shows the camera's own frame again.

While looking through the picked camera, the hand moves the camera itself and the view stays through it. The middle mouse button (with or without Shift) slides the camera, the mouse wheel moves it toward or away from what it aims at, and a left drag turns it around what it aims at. If the camera has keys, or Record is on, the move is keyed at the playhead. Undo puts the camera back. A click on empty space lets go of the camera, in the pane and in the Scene list.

Key camera Key the picked camera's position at the playhead.
Aim at selected Keep the selected object in view as the camera moves.

While this is on, the button reads "Following".

Remove Remove the picked camera.
Name The name of the camera in use, so cameras can be told apart.
Camera

Places

Saves and opens named views inside a capture.

The Places card

The card appears when the open file is a photographed scene that is a place: a scene with ground to stand on, or one whose author saved a starting spawn beside it. Places are shown as cells. Pressing a cell moves the camera to that place. Each capture file keeps its own places. A renamed or moved copy of the same capture, with the same size and start, opens with the same places. The D-pad on a game controller steps through them. The line at the foot names where the capture opens.

Place name The name to save this place under.

The place is numbered if this box is left empty.

Add Saves the current view as a place.

The view is saved with the name in the box, or numbered if the box is empty.

Start here The capture opens at this place from now on.

The capture loads at this place when the file is opened next.

Remove Deletes this place.

The place is removed from the capture.

Camera

Walk

Walk through a photographed scene on its ground.

The Walk button is on the strip when the open file is a photographed scene that has ground to stand on. Such a scene opens walking. Pressing Walk again stops, and pressing it once more starts again.

Walking puts a body under the camera. It follows the ground, runs, crouches and jumps. Places saved in the scene are available while you walk.

Keyboard Move with W A S D or the arrow keys.
  • W A S D or the arrow keys move.
  • Shift runs.
  • C or Ctrl crouches.
  • Space jumps.
  • Escape stops walking.

The keys act on the window that has the focus.

Game pad A game pad walks and looks.
  • The left stick moves.
  • The right stick looks.
  • A starts walking, and jumps while walking.
  • Y stops walking.
  • B crouches.
  • The left shoulder button or a press on the left stick runs.
  • The D-pad steps through the saved places, to the right for the next and to the left for the previous.

Only the window you are in takes the pad.

Look

Environment

The Environment card picks the panoramic HDR image that lights the model and stands behind it.

The Environment card

The card displays a gallery of HDR maps as picture cells. Pressing a cell switches to that map. The name of the map under the pointer shows beneath the gallery. The H key opens and closes this card; the H beside the title indicates this. Buttons beside the title add your own HDRIs to the gallery and remove maps you have added.

Beneath the Sun slider is a colour picker that sets the sun's colour and has a Kelvin mode; its controls are documented on the Colour page. The Backdrop section sets what stands behind the model. A colour picker beneath the Backdrop cells sets the backdrop colour, the top colour of the gradient, and the colour that maps or pictures are blended over. The backdrop folder button opens the folder where backdrop pictures are stored. Every slider returns to its default on a double-click. The card's Reset button restores all defaults.

No environment The first cell of the gallery; the model is lit without a map.
Sun Turns the environment map around the model, moving the sun and every light. Range 0 to 360 degrees.
Lights the model Whether the environment map lights the model.

When off, the Strength slider is greyed.

Strength How strongly the environment map lights the model. Range 0.05 to 2.
colour A flat colour stands behind the model.
gradient A vertical sweep from the picked colour at the top to a darker colour at the bottom stands behind the model.
map The environment map itself stands behind the model, turned with the Sun slider.
image A picture from the backdrop folder stands behind the model, scaled to cover the whole view.
Falloff How much darker the bottom of the gradient is than the picked colour. Range 0 to 0.9.

Works with the gradient backdrop.

Blend How strongly the map or picture covers the backdrop colour beneath it. Range 0.05 to 1.

Works with the map and image backdrops.

Stops The brightness of the backdrop in photographic stops. Range -5 to +5.

Applies only to map and image backdrops. Separate from the view's own exposure on the Tone card.

Blur Softens the map or picture behind the model. Range 0 to 1.

Applies only to map and image backdrops.

Look

Floor

Sets the ground the model stands on and controls its appearance.

The Floor card

The floor catches the model's shadows, contact darkening, and reflections. The toolbar button switches the floor on and off and opens this card; the F key also switches it. Use the icon buttons beside the title to add a custom floor material or remove one you added.

Built-in materials are shown as tiles and repeat at 60 cm per tile at Scale 1, with colour, relief and roughness. Every slider returns to its default when double-clicked, and the Reset button restores every control to its default.

Floor Shows or hides the floor.

Same state as the toolbar button and the F key.

Grid Draws ruled grid lines on the ground.

The grid works with the floor on or off; without the floor, the grid is drawn on its own.

neutral Plain untextured floor.

The default material.

marble Polished marble.
tiles Tiled floor.
wood Wooden floor of long boards.
planks Rough plank boards.
metal Metal tread plate with raised diamond pattern.
rock Natural rock.
ground Bare earth with leaves and grit.
concrete Poured concrete.
showroom Dark polished stone with wavy veins.
paving Outdoor paving stones.
grass Lawn.
carpet Carpet.
Scale Multiplier for material tile size.

Range 0.1 to 8, default 1. At Scale 1, each tile is 60 cm wide. The track is logarithmic. Type a number for a precise value.

Pan X Slides the material sideways across the floor.

Range -4 to 4 tiles, default 0.

Pan Y Slides the material along the other floor axis.

Range -4 to 4 tiles, default 0.

Rotation Turns the material on the floor.

Range 0 to 360 degrees, default 0.

Height Raises or lowers the ground.

Affects floor, grid, shadows and contact darkening. Range is one quarter of the model's largest dimension up or down. When a model includes its own floor, use this to position the floor on or beneath it.

Seen from below Displays the floor from below.

When on, the floor stays visible with its underside showing as the camera passes beneath it. When off, the floor fades away. Default is off.

Look

Lighting

The card places studio lights around the model and sets how all lights behave.

The Lighting card

The card places three studio lights (Key, Fill and Rim) around the model. It also controls the file's own lights, the model's glowing surfaces, shadows, falloff and patterns. When "Point lights" is off, the model is lit by an automatic three-light rig, and a line reads "Lit by the automatic rig". The three handles in the pane stand on the directions the rig's key, fill and rim light from, and turn with them; the key follows the environment's sun when there is one. Pressing a handle switches Point lights on with the three lights placed where their handles were, and the pressed light moves with your hand. When "Point lights" is on, the three lights appear as handles on a dome and can be repositioned by dragging. Press a light to pick it; the picked light's name, colour, distance, intensity and size appear below. The strip's Move lights button shows or hides the lights' handles in the pane: the studio rig's three and every light placed in the scene. Each handle is drawn where its light stands, at the light's distance from the model. A light outside the picture, or behind you, keeps its handle at the edge of the pane on the side the light lies, with a small arrow pointing towards it, and the handle can be pressed and dragged from there like any other. While the turntable spins the lights, the handles turn with them. Dragging a handle moves the light around the model at the same distance, and Distance on the card changes how far it stands. In Edit the handles show until the button is pressed off, and a light picked in the Scene list keeps its own handle.

Distances are measured in model radii, the radius of the sphere that frames the model. This means the same numbers work for objects of any size. The colour picker's controls are documented on the Colour page. Every slider returns to its default on a double-click, and the card's Reset button restores every default.

The EMITTERS section appears only when the model has glowing surfaces. Custom images can be added to the GOBO section and appear as picture cells below the built-in patterns.

Point lights Switch between placed lights and the automatic rig.

With Point lights off, the automatic three-light rig lights the model. With Point lights on, the three placed lights on this card light the model.

Key Turn the key light on or off.

The key is the main light.

Fill Turn the fill light on or off.

The fill light lifts the shadows.

Rim Turn the rim light on or off.

The rim light lights the model's edge from behind.

Distance How far the picked light stands from the model.

The range is 1.1 to 8 model radii.

Intensity How bright the picked light is.

The range is off, then one sixteenth up to 4096 times, with each step along the slider doubling or halving it.

Size How large the picked light is.

The range is 0.02 to 1. A larger light gives softer shadows and broader highlights.

None The picked light's intensity is set by the Intensity slider.

This is the default in the DRIVE BY section. The other cells in this section are objects in the scene. Picking one drives the light's intensity from its distance to that object, and four sliders appear below.

Near The distance at which the light takes its "At near" intensity.

The range is 0 to 8 model radii.

Far The distance at which the light takes its "At far" intensity.

Between Near and Far, intensity moves smoothly from one to the other.

At near The intensity at the Near distance.

The range is off, then one sixteenth up to 4096 times, with each step along the slider doubling or halving it.

At far The intensity at the Far distance.

The range is off, then one sixteenth up to 4096 times, with each step along the slider doubling or halving it.

File The whole group on or off

Switch for all the lights stored in the model file.

Glowing The whole group on or off

Switch for the model's glowing parts acting as lights on the scene.

Casting Lamps and spots that cast shadows at once

A number with minus and plus buttons, 0 to 16.

Shadows All shadows on or off
Contact shadows Darkens where parts meet surfaces under placed lamps and the file's own lights
Soft Softens shadow edges while the camera moves

Four positions with minus and plus buttons: Off, Main (the main light's shadow), Distance (softness grows with distance from the object casting it), All (lamps and spots as well).

Rendering card Opens the Rendering card.

The Rendering card is where the key light's ray-traced shadow is set.

three-point The default rig: a warm key front-left, a cool fill, an amber rim behind.
rembrandt A high, hard key at 45 degrees and a faint fill.

This is the classic triangle of light on the shadowed cheek.

butterfly The key high over the camera with a broad soft fill beneath.
split One light square from the side, lighting half the model.
rim Two lights behind the model and a weak front light.

This setup creates a strong silhouette.

product Large, near-white, even light, as in a catalogue photograph.
windowed Light fades with the square of distance and ends smoothly at the edge of its reach.

This is the default falloff.

1/d² Physical inverse-square fading with endless reach.
linear Light fades in a straight line to the edge of its reach.
flat Constant brightness at every distance, like sunlight from a placed lamp.
Emitters / Strength How bright the model's glowing surfaces are.

The range is -4 to +10 stops. This slider appears only when the model has glowing surfaces.

Shadow / Softness How soft the edge of the key light's shadow is.
none The light casts no pattern.

This is the default.

stripes Casts stripes through the lights.

Like a stencil in front of a lamp.

window Casts a window frame through the lights.

Like a stencil in front of a lamp.

dapple Casts dappled light through the lights.

Like a stencil in front of a lamp.

caustics Casts moving water caustics through the lights.

The Phase slider moves them.

leaves Casts moving leaves through the lights.

The Phase slider moves them.

Repeat How many times the pattern repeats across the light.

The range is 0 to 8. At 0 the pattern tiles endlessly.

Outside What the light does outside a pattern that has an edge.

The range is 0 (blocked, like the wall around a window) to 1 (open, like sky around leaves).

Scale The size of the pattern.

The range is 0.1 to 8 on a logarithmic scale.

Pan X Slides the pattern across the light horizontally.

The range is -4 to 4.

Pan Y Slides the pattern across the light vertically.

The range is -4 to 4.

Rotation Turns the pattern.

The range is 0 to 360 degrees.

Gobo / Softness Blurs the pattern's edges.

The range is 0 to 1.

Gobo / Strength How deeply the pattern darkens the light.

The range is 0.05 to 1.

Phase Moves the animated patterns through their cycle.

This applies to the caustics and leaves patterns.

Look

Colour

Pick a colour for this element from presets, a temperature scale, hex code, or sliders.

The Colour card

The colour picker sets the colour of the element on this card. The title line shows the current colour as a swatch and its hex code. For a light (lamp or sun), the colour controls hue only, and a note says "Hue only - brightness is Intensity" because the light's brightness is set by the Intensity slider on the same card. A light picker has Kelvin and Custom modes. For a backdrop or surface, the picker has Custom controls and its own Brightness slider.

Every slider returns to its default on a double-click.

Kelvin Colour temperature mode: pick from presets or the Temperature slider.

In this mode the colour is set as a colour temperature in kelvin. Choose from the preset swatches or use the Temperature slider to set any temperature.

Custom Colour mode: set the colour freely with hex, R G B, hue and saturation.

In this mode the colour is set with individual controls: type a hex code, set red/green/blue values, or use the Hue and Saturation sliders.

candle 1900 K preset swatch.
tungsten 2700 K preset swatch.
warm white 3200 K preset swatch.
neutral 4000 K preset swatch.
daylight 5600 K preset swatch.
overcast 6500 K preset swatch.
shade 7500 K preset swatch.
Temperature Colour temperature slider from 1700 K (deep orange) to 12000 K (blue).

The track shows the colours it passes through as you change the temperature.

Hex Type a colour as a hex code such as #FF0000.

Only hex digits and the # symbol are accepted.

R G B Red, green and blue values, each 0 to 255.

Type a value into a box, or drag across a box to change it one level per pixel.

Hue Hue around the colour wheel, in degrees.
Saturation How strong the colour is, from grey to full colour, in percent.
Brightness How light or dark the colour is, in percent.

This slider appears only on pickers that carry their own brightness: backdrops and surfaces.

Look

Tone

The card adjusts the picture's exposure, tone curve and colour channel.

The Tone card

The image viewer has the same card on the same tone mapper, so an HDR image and a 3D model can be graded the same way. Its sections are titled OPERATOR and CHANNEL. Every slider returns to its default on a double-click; the card's Reset button restores every default.

Exposure Brightens or darkens the picture in photographic stops.

The slider ranges from -5 to +5, with a default of 0. When a file carries an exposure of its own, the readout shows the total the picture is drawn at.

Gamma Adjusts the display's brightness transfer curve.

The slider ranges from 1.0 to 3.0, with a default of 2.2. 2.2 suits ordinary displays; 1.0 is for a display that applies its own transfer curve.

Linear Brightness is shown as it is and everything brighter than white is clipped to white.
Reinhard Rolls bright values off smoothly towards white.
ACES The ACES filmic curve used in film production.

ACES is the default operator.

Filmic The Hable filmic curve, with a soft toe in the shadows and a soft shoulder in the highlights.
RGB The full-colour picture.

RGB is the default channel.

R Only the red channel, shown in grey.
G Only the green channel, shown in grey.
B Only the blue channel, shown in grey.
A The alpha (transparency) channel, shown in grey.
Lum The luminance (perceived brightness), shown in grey.
Look

Effects

The card sets the picture's finishing effects.

The Effects card

The Effects card gathers bloom, ambient occlusion, bounced light, depth of field, lines and antialiasing in one place. On a wide pane the controls sit in two columns. Every slider returns to its default on a double-click, and the card's Reset button restores all defaults at once.

Lines draw ink over the model. The Ink Colour picker sets the lines' colour; its controls are documented on the Colour page.

Bloom / Strength How strongly bright areas glow into their surroundings, 0 to 1.

At 0 bloom is off.

Threshold How bright a pixel must be before it glows, 0 to 4.
Size How far the glow spreads, 0.25 to 4.
Background glows The backdrop and environment glow as well as the model.
Ambient occlusion / Strength How strongly creases and corners where light struggles to reach are darkened, 0 to 2.
Radius How far the darkening reaches from a crease, 0.02 to 1.
Bounced light Light bounces off surfaces onto others, so colours spill between nearby parts.

Uses the graphics card's ray tracing. When the frame rate falls too low it pauses by itself.

Depth of field Blurs what is in front of and behind the focus distance, like a camera lens.
Focus Moves the plane in focus nearer or further from the point the camera looks at, -1.5 to 1.5.

The middle is the camera's target.

Range How deep the sharp zone around the focus plane is, 0.05 to 2.
Depth of field / Strength How strongly the out-of-focus areas blur.
round Round aperture shape.
3 Triangle aperture shape.
4 Square aperture shape.
5 Pentagon aperture shape.
6 Hexagon aperture shape.
7 Heptagon aperture shape.
8 Octagon aperture shape.
9 Nonagon aperture shape.
Rotation Turns the aperture polygon, 0 to 360 degrees.
Silhouettes Draws lines along the model's outline.
Creases Draws lines along sharp edges inside the model, where faces meet at an angle.
Against background Draws lines wherever anything meets the background, including the far edge of the floor.
Thickness Line width in pixels, 1 to 12.
Opacity How solid the lines are, 0.05 to 1.
Angle How sharp an edge must be to count as a crease, 5 to 90 degrees.
solid Solid line style.
dashed Dashed line style.
dotted Dotted line style.
off Hard pixel edges, useful for sprite captures.
jitter Edges, soft shadows, ambient occlusion and bokeh smooth out over a few frames while the view is still.
2x Multisampling at 2 samples makes edges smooth from the first frame, which helps while dragging.

This keeps the jitter smoothing as well.

4x Multisampling at 4 samples makes edges smooth from the first frame, which helps while dragging.

This keeps the jitter smoothing as well.

Look

Cartoon

The Cartoon card renders the scene in a drawn style with simplified paint, flat lighting bands, edge lighting, a printed halftone screen and posterised colour.

The Cartoon card

The Cartoon card applies a sequence of effects to create a hand-drawn appearance: simplified surface colours (PAINT section), light organized in flat bands (CEL section), rim lighting (RIM section), a halftone pattern overlay (HALFTONE section), and posterised colour (POSTERISE section). On a wide pane these sections lay out in two columns. For ink outlines, use the LINES section of the Effects card.

Every slider returns to its default on a double-click. The card's Reset button restores every slider to its default. Sliders that read 'off' at their lowest end switch that part of the look off. The three cells in the PATTERN section select the shape of the halftone screen.

On Turn the Cartoon look on and off.

The switch controls the entire effect. Slider settings are preserved while the Cartoon effect is off.

Flatten Simplifies surface colours towards flat areas.

This slider in the PAINT section ranges from 0 (off) to 1, collapsing surface variation into unified colour regions.

Bands Splits the light into flat levels.

This slider in the CEL section creates 2 to 8 flat lighting bands; its lowest end is off. Reflections on metals are banded too.

Softness Softens the edge between light bands.

This slider in the CEL section ranges from 0 to 1, smoothing the transition at each band boundary.

Rim Controls the brightness of light along the model's edges.

This slider in the RIM section ranges from 0 (off) to 4.

Rim width Controls how wide the rim of light appears.

This slider in the RIM section ranges from 0.05 to 1; a thin rim reads as a highlight while a wide one appears as an outline of light surrounding the model.

Halftone Breaks band edges into a printed screen pattern.

This slider in the HALFTONE section ranges from 0 (off) to 1 and applies a halftone effect to the boundaries between light bands. The effect activates once Bands is on.

Dot size Controls the size of the halftone screen dots.

This slider ranges from 3 to 40 pixels and controls the scale of the screen pattern.

Screen angle Rotates the halftone screen pattern.

This slider ranges from 0 to 90 degrees and turns the screen, following the conventions of printed screens.

dots The halftone pattern uses dots.
lines The halftone pattern uses lines.
cross The halftone pattern uses crosshatched lines.
Levels Reduces the picture to a few flat colours.

This slider in the POSTERISE section ranges from off at its lowest end up to 16 flat levels per colour channel, simplifying the image's colour palette.

Look

Accumulated

The card renders depth of field, soft shadows and motion blur by accumulating frames while the view is still.

The Accumulated card

The card averages many slightly different pictures over successive frames, so the picture refines while the view is still. It renders real lens blur, soft shadows from the point lights and motion blur. These effects cost frame rate. The card is organized into two sections: Lens for depth of field, and Motion for motion blur.

Every slider returns to its default on a double-click. The card's Reset button restores every default.

On Turns accumulation on.
Lens blur Real depth of field from a camera lens, with true bokeh.
Point light shadows The point lights cast soft shadows whose width follows each light's Size.
Motion blur Moving objects in an animation blur along their motion.
Aperture How wide the lens opens, 0% to 25%; a wider opening blurs more.
Focus The focus distance as a multiple of the distance to the camera's target, 0.05× to 4×; 1.00× focuses on the target.
Blades The shape of the out-of-focus highlights: circular at the low end, then a polygon of 3 to 11 blades.
Rotation Turns the blade polygon, 0 to 360 degrees.
Shutter How long the shutter stays open, as a shutter angle from 0 to 360 degrees: 360 blurs over the whole frame interval and 0 freezes motion, as in cinema cameras.
Look

Volumetric

The card fills the air around the model with haze that the lights shine through, so beams and shafts of light show in the air.

The Volumetric card

The haze amounts are measured against the model's own size, so a small earring and a building haze over the same share of the picture. Every slider returns to its default on a double-click; the card's Reset button restores every default.

The card holds three sections. IN THE AIR names which lights shine through the haze. MEDIUM controls the haze itself, with a colour picker documented on the Colour page. QUALITY sets the haze's fineness. A note on the card states "Density thickens the air; Glow brightens it alone."

On Turns the haze on and off.
Key light The key light shines through the haze.
Point lights The placed point lights shine through the haze.
Emissive The model's own glowing surfaces light the haze.
Density How thick the haze is, 0.005 to 2.

Thicker haze also dims the model behind it.

Height How high above the floor the haze reaches before it thins away, 0.1 to 8 model heights.

At the top of the range the haze is even throughout, as in a room full of fog.

Glow Brightens the light in the haze while leaving its thickness as it is, 0 to 8.
Scatter Which way the haze sends light, -0.9 to 0.9.

Positive values send light forward, so beams blaze when the camera looks towards the light; 0 sends it evenly; negative values send it back towards the light.

draft Fastest haze.
medium Medium haze.
high Fine haze.
ultra Finest haze.
Bloom the haze Bloom from the Effects card also glows around the bright shafts in the haze.
Look

Volume

Set a volume's density, droplet size, colour and light, with presets for clouds, smoke and fire.

The Volume card

The card appears when the file is a volume: a three-dimensional grid of density values such as a cloud, smoke or fire simulation. A sequence of volume files plays as an animation on the time dock. Files beside the opened one that are named alike and differ only in a frame number of the same width form the sequence. It plays at 24 frames a second from the frame you opened. The card has three sections: PRESETS holds material templates, MEDIUM holds the volume's density and appearance, and LIGHT controls how the key light and sky light pass through it.

Each preset sets the whole medium in one press: its density, colour, droplet size and glow. The sky light and inner glow settings stay as they are.

Every slider returns to its default on a double-click. The card's Reset button restores every default.

Cloud Set the volume to look like a cloud.
Fog Set the volume to look like fog.
Steam Set the volume to look like steam.
Smoke Set the volume to look like smoke.
Soot Set the volume to look like soot.
Fire Set the volume to look like fire.
Dust Set the volume to look like dust.
Density How dense the volume is, as a multiple of the file's density.

The density slider ranges from 0 to 4, with a default of 1.

Droplets The size of the droplets the light scatters off.

The droplets slider ranges from 5 to 50 micrometres, with a default of 20. The size shapes how light passes through the medium, as in real clouds of that droplet size.

Sky light How strongly the sky lights the volume.

The sky light slider ranges from 0 to 4, with a default of 1.

Fire glow How brightly a file's temperature or flame data glows.

The fire glow slider ranges from 0 to 4, with a default of 1. The glow shows the colours of heated material from deep red to white.

Inner glow Light that bounces inside the volume brightens its interior.

Inner glow is on by default. Light that bounces many times inside the volume is carried round it, which brightens the inside of thick clouds.

Look

Traced effects

The card chooses ray traced effects and controls texture map streaming into memory.

The Traced effects card

Ray tracing is an option layered on the everyday picture; each switch adds accuracy at some cost in frame rate. The first four controls enable ray traced effects.

The TEXTURES section controls how texture maps stream into memory. As the camera approaches, each map grows toward the size the view needs, limited by maximum size (Largest), minimum size (Smallest), and graphics memory (Budget). The Capture a still card's "Trace saved images" option renders saved pictures with all four ray traced effects. Reset restores every default.

Ambient occlusion The darkening in creases and corners is ray traced, following the true shape.
Key shadow The key light's shadow is ray traced, sharp where objects touch.

The shadow is softer further away.

Specular occlusion Reflections are darkened where surroundings are hidden from a surface.

This happens inside crevices.

Transmission Light passing through glass and other see-through materials is ray traced.
1K 1024-pixel maximum or minimum texture size.

In the Largest row, 1K caps maps at 1024 pixels. In the Smallest row, 1K makes 1024 pixels the size every map keeps at least.

2K Maps grow up to 2048 pixels.
4K Maps grow up to 4096 pixels.
file Maps grow up to the full size stored in the file.
auto The viewer chooses the starting size or graphics memory budget.

In the Smallest row, the viewer chooses the starting size. In the Budget row, the viewer chooses how much graphics memory textures may use.

256 The smallest size every map keeps, in pixels.
512 The smallest size every map keeps, in pixels.
1 GB How much graphics memory texture maps may use.
2 GB How much graphics memory texture maps may use.
4 GB How much graphics memory texture maps may use.
Rigging

Fit a skeleton

Fits a skeleton to a model so it can be posed and animated.

The Fit a skeleton card

The fit finds the body's joints by itself, including fingers and toes, and takes a few seconds. Bones take standard names, so animation clips made for common skeletons play on the figure. A line on the card shows how many bones the skeleton has.

The buttons change as you work: Stop appears while a fit runs, Fit manually puts the joints on the model for you to drag into place, Clear all takes the joints and the fitted skeleton away, Rig the shape creates a skeleton from the model's shape alone, and the joint and weight tools appear once there is a skeleton.

Save rig writes the skeleton and its skin weights to a file you name, and Load rig puts them back on the model. The model remembers the rig file it was last saved to or loaded from, wherever that is, and opens with it next time. With none remembered, a file beside the model with its name is used.

When the fit cannot find a figure it recognises, it fits a best guess instead and says so: check the joints with Fit manually. A skirt or loincloth that joins the legs is set aside while the body is fitted, then follows the legs and hips.

Fit a skeleton Fits a skeleton to the model; once there is one, reads "Fit again".
Stop Stops the fit.
Fit manually Puts the thirteen main joints on the model so you can drag any that are wrong, then fit to them.

Fit manually starts fitting. The joints start where the last fit put them, or where they sit on most human figures. The other side follows as a mirror image while you drag. When Fit to my joints finishes, the joints the fit made are shown for adjusting and you stay in fitting until you press Done or Discard changes. The joints you placed are kept, and the next Fit manually starts from them.

Fit to my joints Fits the skeleton to the joints as you placed them.
Clear all Puts the rig back exactly as the file opened, undoing every fit, joint move, bone change and painted weight.

Clear all returns the rig to the state the file opened in: its own skeleton and its own skin weights, or no skeleton for a model that came without one. It does this whatever you did since, including an automatic fit, Fit manually, Adjust joints, added or removed bones and painted weights. Weights you kept from painting and a fitted rig kept for the file are dropped with it. Clear all never deletes a .h3rig file you saved. The file stays on disc, but the model opens without it until Save rig or Load rig names a file again. Clear all can itself be undone. With several models in the scene, Clear all does the same for every model at once. Each model gets back the rig its own file came with (its own skeleton and weights, or none) and stays where you placed it, and the whole Clear all is a single step of Undo.

Every rigging edit is a step of the toolbar's Undo. This covers a fit, a joint moved, a bone added or removed, a change to reach or rigid pieces, and painted weights you kept. Undo puts back the joints together with the weights that went with them. Press Undo repeatedly to go back through every rigging edit to the rig the file opened with.

Paint weights Starts weight painting on a rigged figure.

The figure shows the picked bone's weights as a heat map drawn on its shape: blue for none, red for full.

The strip along the bottom becomes the painting strip: the Weight paint chip, the orbit centre, the free camera, the bone chip, Undo, Redo and Reset view. A rail on the left edge holds the brushes, three switches and four values. Mirror, one of the switches, paints the same stroke on the other side of the body, on the matching bone.

A left press on the figure paints. Shift with the left button takes weight away, and Ctrl with the left button picks the bone under the cursor. With no bone picked, the first press picks the bone under it and paints it. A left drag that starts beside the figure turns the view, and it stays a turn when it crosses the figure. The middle or right button turns the view, and in the free camera it looks around. Shift with the middle or right button slides the view. The wheel zooms, and Ctrl with the wheel changes the brush size. With the orbit centre armed, a click on the figure makes that point the centre to turn around and paints nothing.

The cross on the Weight paint chip is the only way out of painting. It offers Keep weights, Keep as draft and Discard strokes. Opening another card, pressing the strip or clicking the pane leaves painting on.

Keep weights keeps the painted weights with the model, including a model that brought its own skeleton. Keep as draft puts the model back to the weights it had when painting began and keeps the strokes as a draft. Discard strokes puts the weights back as they were when painting began.

A draft is kept after every stroke. The next time you press Paint weights on the same model, the draft is offered: Resume draft continues it, Start fresh paints from the model's weights, and Delete draft throws it away.

Painting Weight painting is on; the cross on the Weight paint chip leaves it.
Weight paint Shows that weight painting is on; its cross offers Keep weights, Keep as draft and Discard strokes.
Bone Shows the bone being painted; press it to pick another bone or lock one.

The chip opens the bone list. A bone is picked there, and each bone has a lock.

Draw Paints toward the brush's weight.
Add Adds weight.
Subtract Takes weight away.
Smooth Evens the weights out with their neighbours.
Fill Sets the brush's weight on the whole connected part of the figure under the click.

The fill is one stroke.

Over the surface Spreads the brush along the figure's surface, so painting an arm leaves the body alone.
Lock this bone Keeps the picked bone's weights as they are while other bones are painted.
Size The brush's size on screen, 4 to 200 px, default 40.
Strength How much a stroke changes, 0.05 to 1, default 0.5.
Smoothing How strongly Smooth evens the weights out, default 0.5.
Weight The weight Draw paints towards and Fill sets, 0 to 1, default 1.

Size, Strength, Weight and Smoothing each have a smaller button, the value and a larger button. Pressing the value opens the Brush card.

Undo Takes the last stroke back.
Redo Brings the stroke back.
Rig the shape Fits a skeleton that follows the model's shape, for a model that is not a standing figure; bones carry plain names.
Adjust joints Shows the joints on the model so you can drag them into place.

Adjust joints starts fitting. The model is shown in the pose it was bound in and stays still. Drag a joint to move that joint of the skeleton; the body does not move with it. When you let go, the skin is fitted to the joints where they now are. With Move this joint only on, the joints below the one you drag stay where they are; with it off, they move along. Pressing Adjust joints again while fitting does nothing. After Done, pose the limbs on the Pose card.

Fit skeleton Shows that you are fitting; the cross, or Escape, leaves fitting.

While fitting, the toolbar shows the Rigging card button, Undo, Redo, the orbit centre, the free camera and Reset view; everything else is in the More menu. The Pose card does not open, and Paint weights, Clear all and Remove skeleton are turned off. The cross on the chip is the only way out, and Escape does the same. Both show a card with Done and Discard changes.

Done Keeps the joints as they now stand and leaves fitting.
Discard changes Puts the skeleton and its weights back to how they were when fitting began.
Remove skeleton Takes the fitted skeleton out; a skeleton that came in the file stays.

Remove skeleton never deletes a .h3rig file you saved. The file stays on disc, but the model opens without it until Save rig or Load rig names a file again.

Save rig Saves the skeleton, skin weights, Reach, Falloff and Rigid pieces to a .h3rig file you name.

Save rig opens a save dialog. The first time, it opens in the model's own folder with the model's name and the .h3rig extension, so Ninja.fbx gives Ninja.h3rig. After a save or a load it opens on that same file. You can name the file anything and keep it anywhere; it is always written with the .h3rig extension. The file holds the skeleton with its joints and binding, the skin weights, each bone's Reach and Falloff, and the Rigid pieces switch. Saving is free and needs no licence.

Save rig is there when the model has a skeleton with skin weights: one fitted here, or the model's own skeleton with weights painted here. It is turned off while fitting, until Done or Discard changes, and while painting, until the cross on the Weight paint chip. It is drawn highlighted while the rig is in no file or has changed since it was saved.

A line under the two buttons says where the rig stands: "Saved in Ninja.h3rig", "Changed since saved in Ninja.h3rig" or "Not saved to a file". A model's own skeleton exactly as its file opened shows no line, because the model file holds it.

Heimdall3D also keeps your latest rigging work for each model, so moving to another file or closing the window loses nothing. When the rig file was written after that kept work, for example because you saved over it or copied it in from elsewhere, the model opens with the file. When the kept work is newer, the model opens with the kept work and the line says "Changed since saved in Ninja.h3rig". Press Save rig to write it to the file, or Load rig to go back to what the file holds. If the rig cannot be written, the line says "The rig could not be written".

Load rig Puts the skeleton and weights from a .h3rig file on the model.

Load rig opens a dialog to pick a .h3rig file. A rig file fits only the model it was made on. On a model that came with its own skeleton, the rig file must have the same joints, and only its weights are taken. Load rig is one step of Undo. Loading is free and needs no licence.

When a file is chosen that holds no rig the viewer can read, the line says "That file holds no rig that could be read". A rig made on another model shows "That rig was made on a different model". Closing the dialog without choosing changes nothing and shows no message.

When a model opens, the rig file it was last saved to or loaded from is put on the model by itself, and the line says "Saved in Ninja.h3rig". If the model remembers none, a file with its name and the .h3rig extension beside it is used, such as Ninja.h3rig beside Ninja.fbx.

In the Explorer preview pane the dialogs are shown by the Heimdall3D export agent, which must be running; it is switched on in Configure. Everything else is the same.

Use as character Adds the rigged model to the character library so animation clips can play on it.
Export model Saves the model with its skeleton, skin weights and clips to a .glb or .fbx file you choose.
Move this joint only Dragging a joint moves that joint alone; when off, the joints below it move with it.
X Shows the held joint's position along its X axis.

Drag to move it a millimetre per pixel, or type a value.

Y Shows the held joint's position along its Y axis.

Drag to move it a millimetre per pixel, or type a value.

Z Shows the held joint's position along its Z axis.

Drag to move it a millimetre per pixel, or type a value.

Center Moves the held joint to the middle of its limb.
Refit Puts the held joint back where a fresh fit would place it.
Mirror Moves the held joint's partner on the other side of the body to its mirror image.
Add bone Adds a bone under the held joint, for a tail, an ear or a strap.
Remove bone Takes the held bone out; its children hang from its parent and its skin goes to the parent.
Reach How far the held bone's influence reaches into the skin, 0.1 to 4, default 1.
Falloff How gradually the influence fades beyond the reach, 0.05 to 4, default 1.
Rigid pieces Separate pieces of the model, such as armour plates, follow a single bone whole.
Rigging

Pose a limb

Pose a model with a skeleton, by hand.

The Pose a limb card

The card poses a model that has a skeleton, by hand. While the card is open, the skeleton's joints show as dots on the model. Pressing a dot picks that joint, and the card's title line names it. Closing the card takes the dots away.

Opening the card keeps the pose the model is showing. The skin follows the joint on every frame of a drag. While a drag moves a joint, the skeleton as it stood when the card opened is drawn faint beneath the live one, and it goes when the drag ends.

Three cells under Tool choose what the handles on the picked joint do: Move, Turn or Size. The picked joint also shows how far it can bend. A dotted outline marks its range, one arc for an elbow or knee, from straight to fully bent, and two arcs for a shoulder, hip or neck. A solid line shows where the bone points now, and it turns orange at either end of the range.

A joint stops at the end of its range however it is moved: by its dot, an arrow, a ring, the free roll or a typed angle. A typed angle past the range is set on the end of the range. Turning and dragging both slow over the last part of a range, and moving back is not slowed. A hand or foot goes as far towards the pointer as the ranges allow, then slides along the edge of what the body can reach. Bringing the pointer back puts the limb back where it was. An arm or leg raised forward can cross further in front of the body. Every joint also has a limit on how far it twists about its own bone, and an elbow or knee stays close to the plane it bends in. Ranges cover the elbows, knees, shoulders, hips, neck, spine, collarbones, wrists, ankles and head. Holding Alt while dragging a dot or an arrow, turning with a ring or the free roll, or scrubbing an angle field lets the joint pass its range. A pose the file already has past a range is kept, and a drag from it may stay as far past.

Move Drag an arrow to move the picked joint along an axis, or drag its dot to move it across the screen, and the limb above follows.

The picked joint carries move arrows, both ways along each of the three axes: red for X, green for Y and blue for Z. An arrow is drawn orange where the joint cannot go further that way. With a hand, foot, elbow or knee picked, a dot stands out beside the elbow or knee, on the side it bends towards, joined to it by a line. Dragging the dot swings the way the elbow or knee points, round the line from the shoulder or hip to the hand or foot. The hand or foot stays where it is and keeps its own direction. The swing stops at the end of the shoulder's or hip's range, and holding Alt lets it go past. A limb held straight has no dot, since it has no bend to swing.

Turn Drag a ring to turn the picked joint's bone about that axis, or drag the outer white ring to turn it about the line of sight.

The picked joint carries three rings, one per axis, and an outer white ring. Dragging the joint's dot rolls the joint freely under the hand, like a ball.

Size Drag an arm to scale the picked bone along that axis, or drag the centre square to scale it evenly.

The picked joint carries three arms along the bone's own axes and a square at the centre.

Chain Set how many bones follow a move, from 2 to 5 (default 3).
Stand Sets the figure standing, with the arms down at the sides and the legs straight.

Arms hang at the sides with the elbows a little bent. Each starting pose begins from the model's rest pose and sets only the arms and legs. The spine, neck, head and hands stay as they are at rest, and the feet stand where the rest pose stood them. Undo takes the pose back. The buttons work for figures whose rig names its arms and legs.

Sit Sets the figure seated, with the thighs level and the hands resting over the knees.

The thighs point forward and the shins hang down. The hands rest forward over the knees. The body is lowered so the feet stay on the floor.

Walk Sets the figure at the contact moment of a step, with the left heel down in front.

The left leg reaches ahead nearly straight onto its heel, with the toes raised. The right leg is behind with the knee bent, on its toes. The arms swing the opposite way to the legs.

T Sets the figure with the arms straight out to the sides and the legs straight.

The arms are level with the shoulders.

A Sets the figure with the arms straight and angled down and out, and the legs straight.

The arms are at forty-five degrees from the body.

Undo Takes back the last change in the view, like the toolbar's Undo.
Clear pose Returns the figure to the pose it had when the card opened.
Parent Picks the joint above the picked one, towards the pelvis.

Dead when the picked joint has none above it.

Child Picks the joint below the picked one, along the chain that carries on the furthest.

Where a joint has several children, the one with the most joints beyond it is picked. Dead when there is none.

Joints Shows or hides the list of every joint that can be picked.

Each row is indented by how far its joint hangs from the pelvis. Pressing a row picks that joint, which helps when it is hidden behind another or under the card.

X Shows the picked joint's angle around its own X axis.

Number boxes display degrees; type a value or drag across the box.

Y Shows the picked joint's angle around its own Y axis.

Number boxes display degrees; type a value or drag across the box.

Z Shows the picked joint's angle around its own Z axis.

Number boxes display degrees; type a value or drag across the box.

Key pose Keeps the pose as animation keys at the current frame, leaving the frame and the pose as they are.
Reset joint Puts the picked joint back to how it stood when the Pose card opened, including that frame's pose on a playing clip.
Mirror Copies the picked joint's pose onto its partner on the other side of the body.
Pin joint Keeps the picked joint where it stands while the joints above it move.

A pinned joint stays where it stood as each move begins. Pull the pelvis down and the legs bend while the feet stay put. Dragging another joint holds the pinned one too: pulling a knee with its foot pinned moves the knee and leaves the foot. Turning the hips, or typing an angle on another joint, leaves it in place as well. Its own limb bends to reach it, and a joint in that limb turns only as far as the pin allows. The pinned joint keeps its direction in the world. Feet are pinned when the card opens, but only when they stand on the model's floor; a figure caught in the air has none pinned. A square round the dot marks a pinned joint. Moving the pinned joint itself still moves it, and it is held at its new place from the next move. Mirror and Reset joint move a pinned joint like any other.

Curl Bends every finger of the picked hand from straight to a fist.

Curl runs from 0% to 100%, and each joint folds towards the palm. The slider shows how curled the hand already is when you pick it. Curl and the three shapes set the fingers from the model's own rest hand, so they replace what a clip had the fingers doing. Moving Curl moves every finger by the same amount, so a pointing hand stays pointing. The hand controls appear only for a hand that has an index, middle and little finger.

Spread Fans the fingers apart or closes them together at the knuckles.

Spread runs from -100% to 100%. Above 0% the fingers fan apart, and below 0% they close together.

Fist Closes the hand into a fist.
Open Straightens the fingers and spreads them a little.
Point Curls every finger but the index, which stays straight, and folds the thumb most of the way.
Falloff Sets how many frames a keyed pose blends in and out of the playing motion, from 0 to 30 (default 6, Off at 0).

With Falloff on, Key pose over a playing clip makes the edit rise from the clip over that many frames before the key and return to it over that many frames after. The clip plays unchanged outside that span. A joint keyed again nearby keeps one run, with the fade moving to the outside of the last key. The fade stops at another pose key on the layer, so a pose keyed there stays as it was. The two fade points show on the Rows as smaller breakdown keys at each end of the span, and they can be dragged or deleted like any key. With Falloff off, the keyed pose is held from the key onward. On a figure with no clip under it, Key pose holds the pose.

Rigging

Motion

The card is a library of motion clips that play on the model's skeleton; press a clip to play it.

The Motion card

The clips come from the CMU motion capture library and Quaternius, credited on the card. When the model has no skeleton, a line on the card points to the Fit a skeleton card.

Add a clip file A clip file of your own is added to the library.
Repair motion Mends glitches in a clip as it is put on the character, and leaves the clip file unchanged.

Repair motion is on by default. When it is on, a clip is mended as it is put on your character. A single sample that jumps far from the samples on both sides of it is replaced by the value between them. A knee that bends backwards past straight is brought back to at most 10 degrees past straight. A foot that twists about the shin more than 45 degrees from the direction its knee points is turned back to 45 degrees. Only the motion playing in the viewer is mended, and the clip file on disk is never changed. When the switch is off, clips play exactly as their files hold them. The switch applies to the next clip you press or open.

Rigging

Mannequin colours

The card sets the two colours of the shipped mannequin: its body and its joints.

The Mannequin colours card

The setting is global. Your own characters retain their colours from their files. The colour picker's controls are described on the Colour page. The Reset button returns the mannequin to the clay preset.

clay Neutral clay with darker joints, the default for judging motion.
bone Bone white with dark joints.
slate Dark slate with light joints.
authored The mannequin's own colours from its file.
body The colour picker edits the body's colour.
joints The colour picker edits the joints' colour.
Rigging

Character

A motion file plays on a body you choose from the characters shown on the card.

The Character card

The bodies appear as cells: the mannequin that ships with Heimdall3D and any rigged models of your own. When a character is added, the card reports whether every joint of the motion reaches it.

Add a model A rigged model of your own becomes a character.
Open folder The folder where your own characters are kept opens.

A model file dropped into that folder becomes a character.

Animation

Animation

The card lists animation clips in a scrolling grid; press one to play it, and its name appears at the top right.

The Animation card

The current clip's cell is highlighted. Play and loop controls are on the Timeline dock, which runs the same clock as the animation.

Play in place The model stays on the spot during the clip.

A jump still rises and falls through its motion.

Show rig The skeleton appears over the model during playback.
Animation

Key shape

This card shapes animation keys: their type, the motion curves between them, how handles are computed, and where the motion eases.

The Key shape card

The card shapes the animation keys you have picked. Each key type is drawn in its own colour on the timeline.

Key A main pose.
Breakdown The pose between poses; it keeps its share of the time when the keys around it move.
Hold A pose held still.
Extreme The furthest point a motion reaches.
Step The value holds until the next key, as for a stop-motion pose or a switch.
Curve / Linear The default: the value moves in a straight line to the next key.
Bezier A smooth curve shaped by the keys' handles.
Bounce Settles onto the next key in a run of shrinking hops.
Elastic Overshoots and springs about the next key before settling.
Auto The default: smooth through the neighbouring keys and level at a peak or a dip.
Plateau Like Auto, with every peak and dip falling exactly on a key, so the curve stays within the key values; the safe choice for a whole channel.
Clamped Like Auto, and level wherever two neighbouring keys hold nearly the same value, so a held value stays held.
Flat Level handles on both sides.
Tangents / Linear Handles aimed straight at the neighbouring keys.
Free The handles stay exactly where you place them.
In The motion eases into the key.
Out The motion eases out of the key.
Both The default: the motion eases at both ends.
Sine Gentlest ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Quad Ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Cubic Ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Quart Ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Quint Ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Expo Strongest ease preset; sets the keys' handles to that curve at the end chosen under EASE.
Back Overshoots slightly before arriving; sets the keys' handles to that curve at the end chosen under EASE.
Animation

What a key holds

Choose which animation channels Add key writes.

The What a key holds card

The card opens from the button beside Add key on the Timeline dock. The button's word names the current choice. The card chooses which channels Add key writes, sets a breakdown between two keys, and clears every animation key.

All Add key writes every channel: position, rotation and scale.
Move Add key writes position alone.
Turn Add key writes rotation alone.
Scale Add key writes scale alone.
Between Write a breakdown key at the playhead, between the key before and the key after.

At 0 it matches the key before, at 1 the key after, and past either end it overshoots. Range is -0.5 to 1.5 with a default of 0.5.

Clear all keys Remove every animation key in the scene.

It removes every key in the scene, including the keys of the model file's own animation, which the Rows and the Graph show, and never changes the file itself. The model then stands in its rest pose and stays cleared when the file is opened again, until you pick a clip in the clip list or put a motion on the character. It asks once before clearing, and Undo brings everything back.

Animation

Timing

Set the frame rate and how times are shown.

The Timing card

The card opens from the Timing button on the Timeline dock. It sets the frame rate the scene's range counts in and chooses how times are shown: as frame numbers or as timecode in minutes, seconds and frames. The File's range button returns the scene's range to the range stored in the file.

24 Set the frame rate to 24 frames per second.
25 Set the frame rate to 25 frames per second.
30 Set the frame rate to 30 frames per second.
48 Set the frame rate to 48 frames per second.
50 Set the frame rate to 50 frames per second.
60 Set the frame rate to 60 frames per second.
Frames Times are shown as frame numbers.
Timecode Times are shown as timecode, in minutes, seconds and frames.
File's range Set the scene's range back to the range stored in the file.
Scene

Scene

The Scene dock lists every object in the view, so you can select, arrange and limit their textures.

The Scene card

The dock lists everything in the scene as a tree: the models, the lights (the studio rig, the file's lights and the glowing parts) and the cameras. Pressing a row picks it; the buttons below act on the picked rows. Pressing a model's row or a placed light's row twice moves the view to it: the camera glides over, turning to the object and coming in until it fills the view, as the Frame command does. A line above the list sums up the lights. The dock stays open until the toolbar button or the close button at its top right closes it; the view makes room for the dock.

The TEXTURES section sets texture limits for the picked object alone. The SCENES section lists the saved scenes that already hold this model; press a scene twice to open it. When there are none, a line says so. Every control on the dock shows its default, and the dock's Reset button restores every default.

Save scene Saves the whole scene, with every object, its position and the look, as a scene file.
Load scene Opens a saved scene file.
Lighting card Opens the Lighting card, where the studio rig is set.
Add a model Adds another model file to the scene.
Attach Makes the picked object follow another object as it moves and animates.

Pick an object in the list and press Attach, then click the object it should follow, either in the picture or in its row in the list. Esc cancels. The object stays exactly where it stands, and from then on it moves, turns and plays its keyframes together with the object it follows. Objects can follow in a chain, such as a cup on a tray on a cart.

When you click a character with a skeleton, the picked object follows the joint nearest the click, or the joint picked on the Pose card if one is picked. A sword clicked onto a hand follows that hand through a walk or any animation clip. While an object follows something, the button reads Detach. Pressing it lets go, and the object stays where it is at that moment.

Duplicate Puts a copy of the picked object beside it and picks the copy.

Duplicate sets a copy of the picked object one object-width beside it along X and picks the copy. Copies are named after the original with a number, such as "Chair 2" and "Chair 3". A copy of a group copies everything in it, a copy of an object carried by a group or a hand stays with that group or hand, and a piece row copies just that part. Ctrl+D duplicates the picked object; Ctrl+C copies it and each Ctrl+V puts a copy one step further along, including after opening another model, so an object can travel from one scene to another. Copies share the original file's model data, so they open instantly and add almost no memory. Undo takes a duplicate back out.

Origin to centre Moves the picked object's origin to the centre of its box, and the object stays where it is.

The origin is the point the move, turn and size handles stand at, and the point that turning and sizing go around. Files that hold several objects often put an origin well away from its object. This puts it back in the middle. It acts on the picked object only and is undone with Undo. They sit in the Scene dock's Origin row, below the Remove button, and become available once an object is picked in the list or in the picture. A group and a light take neither.

Origin to bottom Moves the picked object's origin to the middle of its base, where it stands on the floor, and the object stays where it is.

The object's position then is the point where it touches the ground, which suits animating it along the floor. It acts on the picked object only and is undone with Undo.

Add light

Add light has four tiles: Point, Spot, Sun and Area. Pressing a tile readies that light, the tile lights up and the pointer becomes a cross over the view. The next press in the view drops the light where the press lands, on the model, on any other surface or on the floor, standing a little off the surface. A press on empty sky drops it out along that line, in front of the view. The light faces the model and is bright enough to light the model about as much as the main key light does. Dropped on the model's own surface, it faces out from that surface. Pressing the same tile again, or Esc, puts the light away without dropping it. One press drops one light, and pressing a tile again readies the next. The new light is picked. A light is an object in the scene. Its row is in the list, and you can pick it by pressing its round marker in the view. Move and turn it with the move and turn tools or by typing values, hide it with its eye, key it on the timeline, or duplicate it. The row under it switches the light on and off and sets its shadow, and the light is saved with the scene.

Point Shines in every direction from one spot.
Spot Shines a cone of light in the direction it faces.
Sun Lights the whole scene from one direction; only which way it faces matters, not where it stands.
Area A glowing flat rectangle that lights softly, like a window or a softbox.
Light

The Light section appears in the Scene dock while a light you added to the scene is picked. Its four tiles, Point, Spot, Sun and Area, change the picked light to that type in place. The light keeps where it stands, which way it faces, its colour and its brightness, and a light changed to Area takes an area's usual size while one changed from Area takes a lamp's. Below the tiles you set the light's colour, with a temperature mode in kelvin, its brightness (off, then one sixteenth up to 4096 times, with each step along the slider doubling or halving it), its size, its shadow, and the cone width of a Spot.

Brightness Sets how bright the light is; 1.00x lights the middle of the model about as much as the main key light does.
Cone Sets how wide the spot's cone is, as its half angle in degrees.
Size Sets the light's size compared with the model; a bigger light gives softer shadows, and an Area light's rectangle grows with it.
Shadow Sets whether the light casts shadows.
Remove Takes the picked object out of the scene.

Remove takes the picked object out of the scene. The cross at the right end of a row does the same for that row, and so does the Delete key while an object is picked. Undo brings the object back.

Ask before removing Asks "Remove from the scene?" before anything is removed.

With this switch on, which is the default, a card names the object and offers Remove and Keep it. Keep it leaves the scene as it was, and pressing Esc answers the card the same way. With the switch off, the cross, Remove and Delete remove the object at once. The dock's Reset button turns this switch back on.

Name this object The name that Rename gives the picked row, or that Group gives a new group.
Group Makes a group of the picked objects; moving the group moves them all.
Rename Gives the picked row the name in the box.
Override global The picked object's own texture limits below replace the Traced effects card's for this object.
1K The picked object's maps grow up to 1024 pixels.
2K The picked object's maps grow up to 2048 pixels.
4K The picked object's maps grow up to 4096 pixels.
file The picked object's maps grow to the full size in its file.
auto The viewer chooses the smallest size the picked object's maps keep.
256 The picked object's maps keep a minimum size of 256 pixels.
512 The picked object's maps keep a minimum size of 512 pixels.
Open the folder Opens the folder the scene was saved in.
Scene

Snapping

Snap placed objects to steps, the grid, other objects and the floor.

The Snapping card

The snap bar stands across the top of the 3D view while you place objects in the Edit section. The magnet switch on its left turns snapping on or off. It is off until you switch it on.

Hold Ctrl while you drag, or while you press a handle of the move, turn or size tool, to turn snapping the other way for that drag. When a snap to another object or to the floor holds, a ring marks the point where they meet. Surface, Corner and Edge are off until you switch them on, and they work while you move an object with the move tool, not while you turn or size it.

Snapping Turns snapping on or off. Hold Ctrl while pressing a handle or dragging to reverse it.
Step Moves, turns and sizes go in steps of the values set on the step chips.

Moves are counted from where the object started. Turns and sizes step from where they were when the drag began, using the turn step and the size step.

Grid The object's origin lands on the lines of the floor grid.
Surface The object rests on the surface under the pointer as you drag.

While you drag, the object rests on the surface under the pointer. Over another object, the side of your object that faces away from that surface sits on the point under the pointer, so it lies on a table top, hangs on a wall or sits under a ceiling. Over no other object, it rests on the floor at the point under the pointer. A green ring marks the point. Surface applies when no other snap is holding.

Corner The object's nearest corner meets a corner of another object near the pointer.

When the pointer comes close to a corner of another object, such as the corner of a box or a table, the moved object's nearest corner, face centre, centre or origin moves onto it. A pink ring marks the point.

Edge The object's nearest corner meets an edge of another object near the pointer.

When the pointer comes close to an edge of another object, where its surface folds or ends, the moved object's nearest corner, face centre, centre or origin moves onto the nearest point of that edge. Near the middle of the edge, it moves onto the middle. A cyan ring marks the point.

Box Corners, face centres and centres of boxes meet those of other objects.

A corner, face centre or centre of the moved object's box meets the nearest one on another object's box when they come close on screen. Use it to line objects up side by side, stack them and centre them. An amber ring marks the point.

Pivot The object's origin meets another object's origin when they come close.
Floor The bottom of the object lands on the floor when it comes close to it.
Move step The size of a move step. Click for the next value, or use the mouse wheel.

The move step follows the size of what is open. The scene's size is the power of ten at or below its largest side, so a figure 1.8 units tall counts as 1, a 5 cm part as 0.01 and a 240 m town as 100. The steps are 0.01, 0.05, 0.1, 0.25, 0.5 and 1 of that, and the chip shows the result in the scene's own units: 0.001 on the 5 cm part, 0.1 on the figure, 10 on the town. The size is set when a file opens and when an object is added or removed. Turn steps are in degrees and size steps are a share of the object's size, so neither changes with the scene.

Turn step The size of a turn step in degrees. Click for the next value, or use the mouse wheel.
Size step The size of a resize step. Click for the next value, or use the mouse wheel.
Reset Puts the snap kinds and the three steps back to their defaults.

Step, Box, Pivot and Floor are on and Grid is off. Move steps by a tenth of the scene's size, turn by 15 degrees and size by 0.1. The magnet switch stays as it is.

Scene

Move, rotate and scale

Show the picked object's position, rotation and scale as X, Y and Z.

The Move, rotate and scale card

The card opens from its button on the edit rail, the column of editing tools on the left of the view. It shows the picked object's numbers for the tool that is held: Move shows position, Rotate shows rotation, and Scale shows size. Each number can be typed for an exact value or dragged.

X Shows the picked object's X value for the held tool.

Move shows position, Rotate shows angle, Scale shows scale. Type a value or drag across the box.

Y Shows the picked object's Y value for the held tool.

Move shows position, Rotate shows angle, Scale shows scale. Type a value or drag across the box.

Z Shows the picked object's Z value for the held tool.

Move shows position, Rotate shows angle, Scale shows scale. Type a value or drag across the box.

Level Take the tilt out of the picked object and keep the way it faces.
Zero Return the held tool's three numbers to their defaults.
Uniform Scale all three axes as one, so the object keeps its proportions.
Scene

Timeline

Manage animation keys and playback across time.

The Timeline card

The dock runs along the bottom of the view. It opens from the Timeline button, and entering the Animation section opens it. The picture makes room for it.

The transport controls in the top row step through frames and keys, play the scene, record the animation to a file, set the playback range and choose the loop mode. The buttons labeled All, Move, Turn and Scale specify what channels a new key will hold; pressing any of them opens the card where the choice is made. In the Rows and the Graph, a thin line marks the first and the last frame of the scene's range, and the lines move when Start or End changes; time outside the range is shown dimmed.

Hold Shift and drag with the middle mouse button to pan. In the Rows, time moves across and the rows move up and down with your hand; in the Graph, time moves across and the values move up and down.

Current frame Shows the frame the clock is on.

Type a frame to go there or drag across the box.

Start Sets the first frame of the scene's range.
End Sets the last frame of the scene's range.
Rows Shows the keys as rows, one row per animated object or setting.

Press a key to pick it. Ctrl+click adds a key to the picked keys, and Ctrl+click on a picked key takes it out. Dragging across empty lane draws a box and picks every key inside it, across as many rows as it covers, and Ctrl+drag adds the box to what is already picked. A click on empty lane clears the pick. Dragging any picked key moves all the picked keys together in time. The ruler at the top of the Rows moves the playhead when pressed or dragged. In the Graph, dragging across empty graph draws a box and picks every key inside it, and Ctrl or Shift adds the box to what is already picked. Dragging a picked key in the Graph moves the values of all the picked keys together by the same amount. When picked keys are dragged past the top or bottom of the Graph, releasing them widens the view just enough to show them again, and a drag that stays inside the Graph leaves the view as it was. Ctrl+C copies the picked keys (in the Graph, the keys picked there), and Ctrl+V pastes them at the playhead with their spacing in time kept. When the copied keys all belong to one object and another object is picked, they paste onto the picked object, and Undo takes a paste back. A key on an object's top row stands for every channel keyed at that time. Picking a key on the Rows or in the Graph draws the path its object or joint travels between the first and last key in the view. The stretch up to the picked key is amber and the key's mark fills amber, so the first key lights only its own mark and the last key lights the whole path before it, while the rest of the path stays a thin white line.

Graph Shows the keys as curves of value over time.
All New keys hold every channel.
Move New keys hold position only.
Turn New keys hold rotation only.
Scale New keys hold scale only.
Clip to keys Turns the playing animation clip into keys that can be edited.

This button is active when a clip plays.

Cameras Opens the Cameras card, where cameras are added, keyed and looked through.
All actors Every character plays its animation together.

This button is shown when the scene holds more than one character.

Frame Sets the picked key's frame.

This number box appears in the Graph view. The picked key's frame shows above the curves, where it can be typed or dragged.

Value Sets the picked key's value.

This number box appears in the Graph view. The picked key's value shows above the curves, where it can be typed or dragged.

Second value Shows the second value of a key picked on the rows.

Shown when the key holds more than one channel such as X, Y and Z of a position; set it here.

Third value Shows the third value of a key picked on the rows.

Shown when the key holds more than one channel such as X, Y and Z of a position; set it here.

Scene

Material variants

For a model file that carries material variants, the card lists each variant as a cell, and pressing one shows the model in that variant.

The Material variants card

A material variant is a set of colors and textures, such as different color options for a product. The card appears on the toolbar when the loaded file carries variants.

Scene

Reset

The scene returns to its defaults.

The Reset card

The Reset card puts the scene back to its defaults. A separate Reset view button on the toolbar resets the camera alone. The same three reset options appear in the right-click menu under Reset. Any reset can be undone with one Undo press.

Everything Every position and the scene's look return to their defaults.

This resets both positions and the scene's appearance. All animation keys are removed. You can press Undo to restore everything.

Positions Every moved object returns to where it was, and the camera returns to its default.

Moved objects return to their original positions, and any extra cameras are removed. The main camera returns to its default view. Animation keys on objects and cameras are removed. You can press Undo to restore them.

Scene The scene's look returns to its defaults.

The environment, lighting, floor, effects and all other settings return to their defaults. Any saved appearance for this file is cleared, and animation keys on settings are removed. You can press Undo to restore them.

Read

Model info

The card displays the open model's properties and carries the tooltips switch.

The Model info card

The card shows properties of the open model: format, triangle and vertex counts, material and texture counts, the model's dimensions in width, depth and height, and its up axis. The tooltips switch here controls tooltips throughout the viewer and the image viewer. One setting applies to both viewers and is kept with the viewer's settings.

Tooltips Shows a tooltip when the pointer rests on a control.

When on, the switch shows a tooltip whenever the pointer rests on a control throughout the viewer and the image viewer. The switch is on by default. The image viewer's tone card carries this same switch.

Read

Shading mode

The card picks how the model is drawn: the finished look, one of four wireframe views, or a view of one material property for inspecting a model.

The Shading mode card

Each mode is a cell with its own glyph; pressing one switches the view. The card's title names the current mode. The Reset button restores the default, shaded.

shaded The finished model with its materials, textures and lighting.
wire on shaded The mesh's edges drawn over the shaded, textured model.
wire on flat The edges drawn over a plain untextured grey surface.
hidden line The edges alone, with the surfaces hiding the edges behind them.
see-through Every edge, including those the model's own form hides, which are drawn dimmer and thinner so they read as further away.
albedo The base colour of every surface, unlit.
normals The direction each surface faces, shown as colour.
roughness The material's roughness shown in grey: white is rough, black is glossy.
metalness The material's metalness shown in grey: white is metal.
UV checker A checker pattern laid on through the model's texture coordinates, which shows stretching and seams in the texture mapping.
backfaces Faces seen from their back side are shown in a colour of their own, which reveals faces pointing the wrong way.
overhang Faces coloured by their angle to the print's up direction, so the places a 3D printer will need supports under are visible. The same view as the switch on the Print section's overhang card.
thin walls Points coloured by the thickness of the wall behind them, so the walls too thin to print are visible. The same view as the switch on the Print section's Thin walls card.
Edge width Adjust the width of the wireframe lines in pixels, from 1 to 12.

The slider is active in the four wireframe modes and greyed in the others. Double-click to return to the default width.

Read

How big this is, in millimetres

The card shows the model's dimensions in millimetres.

The How big this is, in millimetres card

The SIZE card displays the model's size along X, Y and Z in millimetres. A 3D file stores plain numbers without units, so the card explains how they are read: "Units: from the file" when the file states its unit, "Units: assumed" when Heimdall3D has judged the unit from the model's size, and "Units: not stated" otherwise. The unit cells set how the file's numbers are read in, and this choice is remembered for that file.

mm The file's numbers are read as millimetres.
cm The file's numbers are read as centimetres.
in The file's numbers are read as inches.
m The file's numbers are read as metres.
Make

Capture a still

The card takes a still picture of the current view at a chosen size, with or without its background, and copies or saves it as a PNG.

The Capture a still card

The picture leaves out the toolbar. Every choice is set before the press, so a large render is taken right the first time. The size in pixels of the chosen multiple is shown under the size cells.

While the card is open, dragging a rectangle across the view marks a region, and the capture takes only that region; the card shows the region's size in its Region line. After a save, a link to the folder appears.

1× Sets the picture to the pane's own size.
2× Sets the picture to twice the pane's own size.
3× Sets the picture to three times the pane's own size.
4× Sets the picture to four times the pane's own size.
Allow sizes past 8192 px Sizes wider or taller than 8192 pixels become available.

With it on, sizes go up to 16384 pixels on a side. Such pictures take longer and use more memory.

Transparent background The backdrop is removed and the background is transparent.

The environment still lights the model and shows in its reflections, so a chrome object stays chrome on a transparent background.

Keep ground shadow The shadow the model casts on the floor stays in the picture.

This is active when Transparent background is on.

Trace saved images Saved and copied pictures are rendered with the ray-traced effects.

When off, they follow the Rendering card's switches.

Whole frame Sets the region to the whole view.
Clear Removes the region so the capture takes the whole view.
Copy Copies the picture to the clipboard.
Save PNG Saves the picture as a PNG file beside the model file, or in the export folder when the model's folder cannot be written.
Open the folder Opens the folder the last picture was saved in, or the export folder before any picture has been saved.

The GULLTOPP section appears in the "Capture a still" card while Gulltopp is installed and signed in on this computer. It sends the scene's parts to Gulltopp. You answer three choices first, then press Send to Gulltopp.

Models Chooses whether the scene's model files are sent to Gulltopp.

Each model file is sent once, however many times the scene uses it. Pick Send or Leave. Nothing is picked the first time you send a scene. The answer is kept for that scene and comes back the next time you open it.

Script Chooses whether the scene is sent as a script that builds it again.

The script is the scene written out so that it can be rebuilt. Pick Send or Leave. Nothing is picked the first time you send a scene. The answer is kept for that scene and comes back the next time you open it.

Still Chooses whether the picture in the view is sent as it is now.

The still is the picture in the view at the moment you press Send to Gulltopp. Pick Send or Leave. Nothing is picked the first time you send a scene. The answer is kept for that scene and comes back the next time you open it.

Send Sends this part to Gulltopp.

Each of Models, Script and Still has a Send cell. At least one of the three must be set to Send before you can send the scene.

Leave Keeps this part out of what is sent to Gulltopp.

Each of Models, Script and Still has a Leave cell. A part set to Leave stays in Heimdall3D.

Send to Gulltopp Hands the chosen parts to Gulltopp, which opens and asks where they go.

The button stays unavailable until you have answered Models, Script and Still and at least one answer is Send. The note under the button reads "Sending", then "In Gulltopp". If the scene was not sent, the note gives the reason.

Make

Shot templates

Produces the set of pictures and clips a destination asks for in one press.

The Shot templates card

Pick a template and press Produce to render every shot of the template. A template is a list of shots at the sizes that destination uses, showing the scene from set angles, as turntables, or as wireframe passes.

The templates that follow a destination's published requirements keep to them; the rest are Heimdall3D's own recommendations for that destination. A caption for the post is written from the scene before the run and can be edited on the card; a count beside it measures it against the destination's own limit, and a button beside it restores the generated caption.

An edited template can be saved under a name and appears among the templates. After a run, a link opens the folder the run wrote.

TurboSquid The five product angles TurboSquid asks for, a wireframe pass and a 36 frame turntable as numbered images.
CGTrader Preview pictures and a turntable for a CGTrader listing.
Fab Preview pictures and a turntable for a Fab listing.
ArtStation Preview pictures and a turntable for an ArtStation listing.
Microsoft Store Poster art at 2:3 and a 1920 by 1080 trailer for a Microsoft Store listing.
Behance Pictures of a portfolio post for Behance.
Cara Pictures of a portfolio post for Cara.
Instagram feed The picture or clip in the shape that Instagram feed shows.
Bluesky The picture or clip in the shape that Bluesky shows.
Mastodon The picture or clip in the shape that Mastodon shows.
X The picture or clip in the shape that X shows.
LinkedIn The picture or clip in the shape that LinkedIn shows.
Reddit The picture or clip in the shape that Reddit shows.
Discord The picture or clip in the shape that Discord shows.
YouTube The picture or clip in the shape that YouTube shows.
Instagram Reels A tall turning clip for Instagram Reels.
YouTube Shorts A tall turning clip for YouTube Shorts.
TikTok A tall turning clip for TikTok.
Web still A still image for web use.
Blog header A still image for a blog header.
Social square A square still image for social media.
Social portrait A portrait still image for social media.
Story or short A tall still image for stories or short posts.
Pin or poster A still image for pins or posters.
Turnaround sheet The model from the front, right, back and left for a character or product sheet.
Product set A hero view, a detail view and a wide view of a product.
Fiverr Gallery pictures, a turntable video and a caption for a Fiverr gig.

One press writes three pictures at 1280 by 769 (a hero view, a three-quarter view and a detail view), a 30 second turntable video at 1920 by 1080, and a caption file. The caption file holds the gig's title in the "I will ..." form, its description and its search tags, to fill in before posting.

Movie Turntables written as a video file.
Stills Turntables written as numbered images.
Both Turntables written both ways from one run.
Frames How many frames one turn has; the same controls as the Presentation card for this template's turns.
Length The same turn given in seconds.
Rate Frames per second a turn plays at.
Frame The room around the model in every shot; more Frame makes the model smaller in the picture.
Produce Renders every shot of the template in the background; pressing it again queues another run.

The run carries on if you leave the panel, switch to other windows, select another file or close the viewer, and the files land in a folder beside the model. Pressing Produce again queues another run, and runs go one after another. A run queued with Produce or Run on a folder uses the destination exactly as the card shows it when you press, including changes you have not saved, so you do not need to save first. If Directory Opus or the Heimdall3D viewer closes before every queued run has finished, the runs still waiting are taken up and finished the next time you open a viewer, with nothing for you to press. The Activity window opens and shows each run's progress and when it ends. While runs are queued, the note under Produce counts them and updates every second: how many are waiting, with the one rendering included, how many are done and how many failed, for example "2 waiting, 3 done, 0 failed." When the queue is empty, the note shows how many runs were done and how many failed, for example "4 done, 1 failed." A run that wrote no files counts as failed. If a run's renderer makes no progress for thirty minutes, the run ends and counts as failed, and the next run in the queue goes ahead.

Run on a folder Asks for a folder and queues a run for every model file directly inside it.

Choose a folder and the Shots card queues every model directly inside it. Each model uses the destination picked on the card and opens at its own default look. Other files and subfolders are left alone. The runs join the Produce queue and go one after another. The Activity window shows their progress, and each model's files land in a folder beside it. If the folder holds no model files, the note under Produce says "No models in that folder." and nothing is queued.

Stop the runs Stops every queued run.

The stop symbol appears beside Run on a folder while runs are waiting. Pressing it stops every run queued up to that moment. Runs not yet started are dropped with their files, and the run that is rendering is stopped. Runs queued after the press go ahead as usual. Once the queue is empty, the note under Produce also counts the runs that were stopped, for example "3 done, 0 failed, 2 stopped."

Reset Returns the template to how it was last saved.
Re-derive Returns an edited copy to the built-in template it came from.
Caption The caption for the post, filled in from the scene and editable here.
Credit Heimdall3D Adds a line crediting Heimdall3D to the caption.
Name this template The name the edited template is saved under.
Save Saves the edited template under the name in the box.
Delete Deletes a template you saved.
Pick a template Asks for a template before a run; after a run, opens the folder the run wrote.
Make

Presentation

The model turns on a turntable while the camera and lights stay still or walk around it, and you record one full turn as a sequence of images or video.

The Presentation card

The Presentation card runs an automatic turntable: the model rotates continuously in front of the camera. Use it to record a sequence of pictures or video from all angles. A recording captures the model at the size and background you set on the Capture a still card.

Every slider returns to its default when you double-click it. The Reset button restores all settings to their defaults.

Turntable Starts and stops the rotation.

This switch shares its state with the turntable button on the toolbar.

Speed How fast the model turns, in degrees per second.

Choose a speed from 3 to 180 degrees per second. The default is 24 degrees per second.

Elevation The camera's height angle during the turn.

The camera looks at the model from below or above during the rotation. Angles range from 85 degrees below the horizon to 85 degrees above.

Turn the other way Reverses the direction of rotation.

The turntable rotates in one direction by default. Turn this on to rotate in the opposite direction.

Keep the lighting still The lights stay fixed while the model turns, like a real turntable.

When this switch is on, the model rotates under fixed lights and the camera stays still. When this switch is off, the camera walks around the model and the lighting rotates with the model. This switch is on by default.

Frames How many pictures one full turn is recorded as.

The slider ranges from 24 to 360 frames per turn, with a default of 120. You can type a value from 1 to 100000 to set an exact frame count.

Length The recording's duration at playback rate.

This shows the same recording expressed in seconds. Typing a length automatically adjusts the frame count to match.

Record PNG sequence Records one PNG per frame, saved beside the model.
Record APNG Records one lossless file that keeps transparency.
Record GIF Records one file with 256 colours and one-bit transparency.
Record MP4 Records one compressed video file.
Make

Record

Records the animation to a file with your choice of format, size, frame rate and sample count.

The Record card

The card sets which frames are recorded, what kind of file, how fast it plays, how large and how smooth. The turntable on the Presentation card records with the same format, size and samples. Lines at the foot of the card show the recording's final size and what it will cost in time.

A recording is written beside the model's file. When that folder cannot be written, it goes into the Heimdall3D folder in Documents. A recording never replaces an existing file. It takes the next free name.

Start The first frame recorded.

The frame number where the recording begins. The range is the same as the Timeline's Start control.

End The last frame recorded.
PNG Record to one PNG file per frame in a numbered sequence.
APNG Record to one animated PNG file, lossless, keeping transparency.
GIF Record to one animated GIF file with 256 colours and one-bit transparency.
MP4 Record to one compressed MP4 video file.
Rate Frames per second the recording plays at.

Choose between 1 and 120; the default is 30. Higher frame rates produce smoother playback and larger files.

Pane Record at the pane's own size.
512² Record at 512 by 512 pixels.
720p Record at 1280 by 720 pixels.
1080p Record at 1920 by 1080 pixels.
8 Render each frame with 8 samples.
32 Render each frame with 32 samples.

The default. More samples take longer to render and produce a smoother image.

64 Render each frame with 64 samples.
Record the animation Record the frames from Start to End with these settings.
Make

What a lister thumbnail shows

This card sets how Heimdall3D draws thumbnails in folder listings.

The What a lister thumbnail shows card

The card controls how thumbnails appear in Directory Opus listers and Windows Explorer, as a computer-wide setting that also appears on the Directory Opus Configure page. Changes take effect when a listing next draws its thumbnails. The refresh button redraws the thumbnails in the currently visible folders, and a line beneath it shows the result.

Stamp size in mm Print the model's size in millimetres on the thumbnail.

This helps sort 3D prints at a glance.

Clear Thumbnails have a transparent background.
Env Thumbnails show the environment behind the model.
Flat Thumbnails have a flat colour behind the model.
Refresh the folders I am looking at The thumbnails in the currently open folders are drawn again with the current settings.
Recall

Named setups

Save and load a whole look under a name.

The Named setups card

A setup stores the entire look of a scene: environment, lighting, floor, tone, effects and all the other cards' settings. Setups are shared across every file, so a look made on one model can be put on another. The saved setups appear as cells; press one to pick it. Setups saved from another viewer window appear when the card opens.

Name this setup The name a new setup is saved under, or the new name for Rename.
Save Saves the current look as a setup with the name in the box.
Load Puts the picked setup's look on the scene.
Rename Gives the picked setup the name in the box.
Delete Deletes the picked setup.
Recall

Bookmarks

The card keeps camera views for the file that is open.

The Bookmarks card

Each row is one slot: a wide button that takes you to a saved view, and a Save button beside it. Bookmarks are kept per file, so each model has its own set. A renamed or moved copy of the same model opens with the same bookmarks, because they are also kept by what the model holds.

empty The button shown in this slot before saving a view.

The button reads "empty" and is greyed. Once you save a view in this slot using Save, the button displays the view's name and becomes active to move the camera there when pressed.

Save Saves the current camera view in this slot.

Save replaces any view that the slot previously held.

Recall

Recently opened

The card shows recently opened files as a grid of pictures, most recent first.

The Recently opened card

The card displays recently opened files as thumbnail images arranged in a grid, with the most recent at the front. Each thumbnail shows the file as it appeared when last opened. Model files and environment maps display a small mark indicating their type. Files that have been moved or deleted remain in the grid as greyed thumbnails. Pressing a thumbnail opens that file. The name of the file under the pointer appears below the grid. The search box is active when the card opens.

Type to find Typing narrows the grid to files whose names match, best match first.

Typing in the search box filters the grid to display only files whose names match the text, ordered by best match first. Pressing Enter opens the first matching file.

Print

Where supports will be needed

The card colours faces that overhang too steeply to print unsupported.

The Where supports will be needed card

The card colours the faces of the model that overhang too steeply to print unsupported, so the places a slicer will add supports are visible before slicing. Faces within 10 degrees of the limit are amber and faces past it are red, as a legend on the card shows. The angle is measured from vertical. Each preset names the slicer whose default it sets.

Show overhangs Shows the overhang colouring.

The same view as the overhang cell on the Shading mode card.

Orca 40° Sets the limit to 40 degrees, OrcaSlicer's default.
Cura 45° Sets the limit to 45 degrees, Cura's default.
Prusa 55° Sets the limit to 55 degrees, PrusaSlicer's default.
From vertical Sets the overhang limit in degrees from vertical.

The limit ranges from 0 to 90 degrees.

2D

Sprite sheet

The card lays out the animation clip from several directions, one row per direction and one cell per frame.

The Sprite sheet card

The card lays out a sprite sheet of the chosen animation clip, seen from several directions, with one row per direction and one cell per frame. A line shows the sheet's size in pixels and whether the clip loops or plays once. Every slider returns to its default on a double-click; the card's Reset button restores every default.

4 Renders the sheet from four directions.
8 Renders the sheet from eight directions.
16 Renders the sheet from sixteen directions.
Lock angles When on, the 2D view turns only to the sheet's directions.

The cells stay exactly as set whatever the view does.

Scene light and effects When on, the cells are lit as the view is, with its effects.

Turning it off gives plain sprites.

Tilt Sets the camera's tilt for every cell, from 0 to 90 degrees.
Side Side on view.
2:1 2:1 pixel art isometric view.
Iso True isometric view.
Top Straight down view.
Frames Sets how many frames of the clip each direction has.

The range is 2 to 24, with a default of 8.

Animate keys When on, the frames follow the animation keys.
Cell Sets the size of each cell in pixels.

The cell steps in powers of two from 64 to 2048 pixels, with a default of 256. The whole sheet must fit within the largest picture the viewer can render and within 256 MB. When it does not, the card says "That sheet is too large; use a smaller cell."

Padding Sets the clear pixels between the figure and its cell's edges.

The range is 0 to 64 pixels, with a default of 2.

Top and bottom Adds a view from straight above and one from straight below.
Parallel (orthographic) When on, the cells are drawn without perspective, as 2D games expect.
Transparent background When on, the cells have a transparent background and no floor.

The cells sit on the game's own ground.

Start at the model's front When on, the first row faces the model's front exactly.
Cells in the pane The view shows the cells as they will be written.
2D

Pixel look

Renders the model as pixel art with a limited colour palette.

The Pixel look card

The viewer draws the model at a low resolution with crisp square pixels. The look works on its own or together with the Cartoon look. Settings are kept with the viewer's configuration and in saved setups. Each slider returns to its default on a double-click, and the card's Reset button restores every default.

Pixel look Turns the pixel art look on.
Height Sets the picture's height in art pixels, from 16 to 256.
Model A palette taken from the model's own colours, with as many colours as the Colours slider sets.
PICO-8 The 16-colour PICO-8 palette by Lexaloffle.
Endesga 32 The 32-colour Endesga 32 palette by ENDESGA.
Colours Sets how many colours the Model palette holds, from 2 to 64.
Dither Blends between palette colours with a regular pattern of pixels for smoother gradients.
Outline A dark outline of pixels around the model's silhouette.
2D

Maps

The card chooses extra maps written beside the colour sheet, cell for cell, for lighting and effects in a 2D engine.

The Maps card

Maps are additional textures written alongside the colour sheet, one per cell, for lighting and effects in a 2D game engine. None are chosen by default.

Normal Writes the surface direction of each pixel for 2D lighting.

The normal is recorded in the camera's frame.

Depth Writes how far each pixel is from the camera.
Occlusion Writes the ambient occlusion that shading uses.

This is the darkening in creases.

ID Writes a flat colour per material for picking out parts.

The colour is the same in every cell.

2D

Export

The card writes the sheet, its maps and the data files game engines and tools read to cut it into frames.

The Export card

The export writes the sprite sheet, any chosen maps, and data files that game engines and tools use to cut the sheet into individual frames.

Godot Writes the data file Godot reads alongside the sheet.
TexturePacker Writes the data file TexturePacker reads alongside the sheet.
Aseprite Writes the data file Aseprite reads alongside the sheet.
GameMaker Writes the data file GameMaker reads alongside the sheet.
Export sheet Writes the sheet, the chosen maps and the chosen data files.

While the export runs, this button reads "Stop export" and pressing it stops.

Open the folder Opens the folder the export wrote.

This link appears after an export finishes.

Image viewer

Image tone

Sets how the picture's range of brightness becomes what the screen shows.

The Image tone card

The 3D view's Tone card works on the same tone mapper, so a picture and a model can be graded alike. The Reset button restores every default; sliders return to their default on a double-click.

Exposure Brightens or darkens the picture in photographic stops.

Range -5 to +5, default 0.

Gamma Sets the display's transfer curve.

Default 2.2; 1.0 for a display that applies its own.

Linear Operator: brightness as it is, clipped at white.
Reinhard Operator: rolls bright values off smoothly towards white.
ACES Operator: the ACES filmic curve used in film production.

The default operator.

Filmic Operator: the Hable filmic curve with a soft toe and shoulder.
Readout Shows the pixel under the pointer in a line under the toolbar.

It appears on screen only and stays out of saved pictures. On by default.

Tooltips Shows a tooltip when the pointer rests on a control.

Available here and in the 3D viewer; the same setting as the switch on the Model info card. On by default.

Image viewer

Channels

Chooses which channel of the picture is shown.

The Channels card

A source section appears above these controls when the file offers more than one choice of what feeds the colour.

RGB Shows the full-colour picture.

This is the default.

R Shows the red channel alone in grey.
G Shows the green channel alone in grey.
B Shows the blue channel alone in grey.
A Shows the alpha transparency channel in grey.
Lum Shows the luminance, the perceived brightness, in grey.
Image viewer

Alpha

Shows how the picture stores its transparency.

The Alpha card

The card displays edge pixel counts and how many will show as a fringe. The Behind section chooses what shows through where the picture is clear.

Alpha only Shows the alpha channel alone.
Read as premultiplied Reads the colour as already multiplied by alpha.
Mark fringes Marks the edge pixels that will show as a fringe.
Checker Shows a checkerboard through the clear parts.
Black Shows black through the clear parts.
White Shows white through the clear parts.
Grey Shows grey through the clear parts.
Image viewer

Pixels

Set how enlarged pictures are drawn and at what factor they are saved.

The Pixels card

When a pixel art picture is shown larger, the viewer draws it using one of three enlargement methods. A save enlarges the picture by the chosen factor.

Nearest Each pixel grows into a sharp square block.
Scale2x An enlarger made for pixel art that smooths diagonal edges while keeping the pixel look.
xBR An enlarger made for pixel art that rounds curves and slopes more smoothly still.
1x The picture is saved at its original size.
2x The picture is saved at twice the original size.
3x The picture is saved at three times the original size.
4x The picture is saved at four times the original size.
Image viewer

Region

Selects the region that a save writes.

The Region card

Dragging a rectangle over the picture selects the region. The Selection line shows its size, and after saving, the card names where the file went.

Whole image Selects the whole picture.
Clear Removes the selection.

With no selection, a save writes the whole picture.

Save on the picture's toolbar writes a PNG of what the pane shows, with the exposure, tone mapping, gamma and channel as set. The PNG has 8 bits per channel, so an HDR or EXR picture is saved as it looks. The file is written beside the picture's file, or in the Heimdall3D folder in Documents when that folder cannot be written. Save never replaces an existing file. Saving needs a licence.

Image viewer

Frames

Plays an animated picture or a sprite sheet.

The Frames card

The card contains the playback transport, the file's animation names, and a grid to divide sprite sheets when the file carries no frame description.

Back Steps one frame back.
Pause Pauses or resumes playback.
Next Steps one frame forward.
Loop Plays the frames round and round.
Onion skin Shows the frames either side faintly over the current one.
Speed Sets the playback speed from 0.25x to 4x.
Columns Sets how many columns the sheet is cut into, from 1 to 64.
Rows Sets how many rows the sheet is cut into, from 1 to 64.
Image viewer

Mips

The smaller copies of a picture made for display at smaller sizes: which to view and how to average them.

The Mips card

A picture shown at smaller sizes is made into smaller copies, each half the previous size. The card shows which copy to display, the averaging method, the size and detail lost from each, and how linear and sRGB averaging differ.

0 The full-size picture.

Numbered levels from 1 are each half the previous size; the list shows as many as the picture has.

Linear light The levels are averaged in linear light, as light adds up physically.
sRGB The levels are averaged on the stored sRGB values.
Image viewer

Use this HDRI

Add this picture to the environment gallery so it can light 3D renders.

The Use this HDRI card

The card puts the picture into the environment gallery. A line shows whether it is already in the gallery.

Use this HDRI Copies the picture into the environment gallery.
Show folder Opens the gallery folder.
Image viewer

Brightest region

Finds the brightest region of an HDR picture and reads out its direction, brightness and size.

The Brightest region card

The card finds the brightest region, usually the sun, and shows its direction in the sky, peak luminance, size and what share of the picture's light it produces. When the picture's projection is unknown, the direction reading explains why.

Image viewer

Probes

Three balls lit by the picture as an environment to judge its light for 3D renders.

The Probes card

The card renders three balls lit by the picture: one chrome, one 18% grey, and one matte. The render starts when the card opens, so the picture's light can be judged before it lights a 3D model.

Image viewer

Analyse

Four views of the picture: histogram, false colour, clipping and brightness positioning.

The Analyse card

The card shows a histogram from dark through 18% grey to blown highlights. False colour paints the picture in the same colour scale. Readouts show the scene's brightness, dynamic range, clipping at the bright and dark ends, and how the picture sits relative to middle grey.

False colour Paints the picture in the histogram's colour scale so every brightness level reads at a glance.
Image viewer

Image sections

Opens the list of sections available in the image viewer.

The Image sections card

The section chip at the left end of the toolbar names the current section. Pressing it opens this list. The cross on the chip leaves the section.

Hold Shift and drag with the middle mouse button to move the picture with your hand, as a plain left drag does.

Browse Shows the picture and the everyday tools.
Light Shows what an HDR picture will do to a render as an environment.

The section displays the histogram and false colour, the brightest region, probe balls lit by it, and a button to add it to the environment gallery.

The toolbar

Sections

The section chip at the left of the toolbar opens a list of specialized tool groups for different kinds of work.

The Sections card

The section chip at the left of the toolbar names the section the viewer is in, and pressing it opens the list: Print, Rigging, Animation, 2D and Gaussian Splat. A section shows its own tools plus undo, redo, the camera tools, reset view, reset scene, the floor and grid switches, the scene list and Save scene. Every other tool is one press away in the More menu at the end of the toolbar, and a switch that is on, such as free camera, stays on the toolbar so you can turn it off. The cross on the chip leaves the section and brings every tool back. The viewer remembers the section for each kind of file, and a section a file has no use for appears greyed with the reason beside it.

Print Measure the model's size and whether it fits a printer's build volume.

The tools for 3D printing show the model's dimensions in millimetres and mark where supports will be needed.

Rigging Fit a skeleton to the model and pose it.
Animation Make animation keys on the timeline.
2D Export the model as sprite sheets with their maps.

The model becomes sprites: sheets, their textures and their export settings.

Gaussian Splat Walk through a captured scene and jump to its saved places.

A capture opens in this section. It is a photographed scene made of splats. Named views let you jump between places inside it. The toolbar carries five buttons here: Walk, Places, the free camera, the orbit centre and Viewpoint. Every other tool is in the More menu at the end of the toolbar.

Press the orbit centre button and point at the scene. A marker shows where the point lands on the splats. Click to make that point the centre the view turns around. In the free camera or while walking, clicking a point with the orbit centre switches to turning around that point, and the view stays where it is.

The toolbar

More controls

The toolbar's last button opens a card that lists every control without room at the pane's current width.

The More controls card

The controls are grouped under the same headings the toolbar uses. Each row works the same way as its toolbar button does. A row that opens a card shows a chevron. When the list is longer than the card, it splits into pages.

More controls Go to the next page of the list.

This row sits at the foot of the first page.

Back to the first page Return to the first page of the list.

This row sits at the foot of the last page.

The toolbar

Documentation

Opens the Heimdall3D manual in your web browser.

The Documentation button, a book icon at the top right of the viewer, opens the manual at heimdall3d.com/docs. The manual has a searchable page for every card with its controls, and the viewer's tooltips use the same words.

Alerts

Installation incomplete

Models are not drawn until the missing render files are restored; reinstall to fix it.

The Installation incomplete card

Heimdall3D cannot find the render program that draws every model (heimdall3d_render.exe) or its shader files in the Heimdall3D folder. Until they are back, the pane shows the reason instead of a picture and thumbnails of models are not made. Pictures such as HDR and EXR images open as before. Installing Heimdall3D again from the installer puts the missing files back. A security program that removed or quarantined heimdall3d_render.exe is the usual cause, so restoring the file or allowing it there fixes this too. Drawing models also needs a graphics card that runs Vulkan.

Alerts

Windows blocks previews of downloaded files - click to clear the mark

Downloaded files are marked by Windows and skipped by the preview pane.

The Windows blocks previews of downloaded files - click to clear the mark card

Windows marks every file downloaded from the internet. The Explorer preview pane leaves a marked file unpreviewed. Thumbnails and this viewer window show the file as usual. The card names the file and can clear its mark, which is the same as ticking Unblock in the file's Properties.

Unblock this file Clears the downloaded mark so the preview pane shows the file.
Alerts

This picture was drawn without some of what the settings asked for

The graphics card renderer was unavailable.

The This picture was drawn without some of what the settings asked for card

The picture was drawn by the processor renderer, which leaves out some of what the settings ask for. The card's title reads SIMPLIFIED RENDER and lists what the picture was drawn without and why the graphics card renderer was unavailable. The picture stays as it is and the button appears quietly.

Explorer and licence

The Explorer preview pane

Thumbnails and a preview of models and images in Windows Explorer.

Heimdall3D draws thumbnails in Windows Explorer and fills the preview pane with the file you select. Models are drawn lit and textured with a transparent background, so Explorer shows them on its own background. Images are shown at the viewer's default exposure, so the same file looks the same here as in the viewer window.

The formats are glTF, GLB, VRM, OBJ, PLY, STL, 3DS, 3MF, COLLADA, FBX, BVH, VRML, AMF, USD, Alembic, voxel and volume files, OpenVDB and NanoVDB, Gaussian splats, EXR, HDR, PIC, PFM, DDS, KTX2, Basis, TIFF, Aseprite, Tiled and LDtk maps, and the print files from slicers (G-code, binary G-code and the resin formats).

A file inside a zip previews too.

Pictures Windows draws A picture Heimdall3D does not draw keeps Windows' own thumbnail.

When Heimdall3D has no picture of a file, Explorer shows the thumbnail Windows would have drawn for it. Some TIFF files are drawn this way.

The export agent A small helper that saves files for the preview pane.

The preview pane runs in a protected sandbox. Saving a file, recording, adding a model or a character, opening a scene, producing a set of shots and opening a browser all go through the export agent, a small helper that starts when you log on. The agent is part of heimdall3d_view.exe. The pane's own viewing never needs it.

The Configure page shows whether the agent is running and whether it starts at logon. A button on that page switches the logon start on and off.

From a command line, heimdall3d_view.exe takes these switches:

  • --register-agent starts the agent now and at every logon.
  • --agent-if-wanted starts it if the logon task is registered.
  • --stop-agent ends the running agent and keeps the logon task.
  • --unregister-agent stops the agent and removes the logon task.
  • --agent runs it now, in the console you started it from.
Where files go Saved files land in the export folder.

Files the agent writes go to the export folder, Documents\Heimdall3D by default. The Configure page shows the folder in use. Forget folder returns it to the default.

Open the folder Opens the folder a file was just saved to.

After the agent has saved a file, the card carries an Open the folder button that opens the folder it went into.

Explorer and licence

The Heimdall3D viewer

The viewer window that runs on its own, without Directory Opus.

heimdall3d_view.exe opens a model or an image in a window of its own. The same viewer is available in Directory Opus and in the Explorer preview pane.

Open with Offers the viewer for the formats it reads.

heimdall3d_view.exe --register adds Heimdall3D to Open with for every format it reads. That includes saved scenes (.h3scene) and scripts (.h3ds). heimdall3d_view.exe --unregister withdraws the offer. Registering leaves the default program for a file type as you set it in Windows Settings. Tiled maps (.tmx) and LDtk projects (.ldtk) are in the list, and they open drawn from the tilesets beside them.

Command line Switches for opening, driving and watching the viewer.
  • heimdall3d_view.exe <file> opens a model or an image.
  • --help prints the list of switches.
  • --serve opens the viewer for a model to drive through the control pipe. --size WxH sets the window size and --hidden keeps it off screen.
  • --call <verb> makes one control call and prints the reply as text.
  • --mcp speaks MCP on standard input and output, and starts a serving viewer when none is running.
  • --watch shows what a model is doing to the serving viewer.
  • --journal <file.h3ds> writes each step you take in the window into the file, as a script that replays them.
  • --register-agent, --agent-if-wanted, --stop-agent and --unregister-agent manage the export agent for the Explorer preview pane.
Explorer and licence

Licence

What a licence unlocks, and where to enter the key.

Viewing is free. Every format Heimdall3D reads opens for as long as you like, and nothing counts down. Nothing is sent anywhere when a key is checked.

A licence unlocks eight things:

  • Saving an image
  • Copying a still
  • Recording a turntable
  • Exporting a sprite sheet
  • Saving a set of shots
  • Fitting a skeleton
  • Playing motion on your model
  • Exporting the model

One licence covers Directory Opus, Windows Explorer and the standalone viewer.

Entering a key Paste the key and press Apply.

The licence card and the Configure page both have a field for the key. Paste puts the clipboard's text in the field and Apply checks and keeps the key. Once a key is kept, the card shows who it is licensed to, the edition, the key's id and when it was issued.

Remove licence Takes the key off this computer.

Remove licence deletes your key from this computer. A licence installed for all users stays until an administrator removes it.

Buy a licence Opens the purchase page in your browser.

The card and the Configure page each carry a Buy a licence button. From the Explorer preview pane the browser is opened by the export agent.

Where the key is kept The key is a file named licence.key.

Heimdall3D reads the key from these places, in this order:

  • %APPDATA%\Heimdall3D\licence.key
  • a copy in the LocalLow folder, which the preview pane writes
  • %PROGRAMDATA%\Heimdall3D\licence.key, for a machine-wide rollout

A key applied or removed in one window or program is picked up by the others within a few seconds.

Looks over the control pipe A look without a licence is up to 1024 pixels on its long side.

A model driving Heimdall3D over the control pipe can ask for a look at the scene. Without a licence the look is up to 1024 pixels on its long side. With a licence the look can be as large as 2048.

Gulltopp

Gulltopp

Gulltopp is the small program in the notification area on Windows or the menu bar on a Mac that keeps your heimdall3d.com files, messages and forum notices at hand.

The Gulltopp card

Gulltopp is named for Gulltoppr, Heimdall's horse. It sits in the notification area beside the clock on Windows or in the menu bar on a Mac, for members of heimdall3d.com, and shows your storage, files, conversations and forum notices.

On Windows, the panel needs a graphics card that runs Vulkan. Without one, the tray icon, its dot and the Windows notifications still work. On a Mac, it requires Apple silicon (M1 or later) and macOS 13 or later.

Installing Download Gulltopp from your account on heimdall3d.com, then run the installer, ZIP or installer package.

Sign in to heimdall3d.com and open the Gulltopp page on your account.

On Windows, the installer, about 3 MB, installs for you alone under your own user profile without asking for administrator rights. It adds Gulltopp to the Start menu, sets it to start with Windows and starts it when it finishes. The ZIP holds gulltopp.exe alone and runs from any folder you put it in; its Start with Windows switch registers that folder. The files are not code-signed, so Windows SmartScreen may show "Windows protected your PC" the first time. Choose "More info", then "Run anyway". To compare a file first, run Get-FileHash <file> -Algorithm SHA256 in PowerShell and match it to the value on the page. To remove Gulltopp, open Settings > Apps. The installer's entry removes it together with its start-with-Windows entry.

On a Mac, you need Apple silicon (M1 or later) and macOS 13 or later. The Installer refuses other Macs before installing anything. Opening the package starts the macOS Installer, which installs Gulltopp for you alone into the Applications folder in your home folder without the administrator password. It quits a running Gulltopp first.

The download is not notarised by Apple. The first time you open the package, macOS shows a dialog titled “Gulltopp-1.0.0.pkg” Not Opened saying Apple could not verify it. Press “Done”. Then open System Settings, choose Privacy & Security, and in its Security section beside “Gulltopp-1.0.0.pkg” was blocked to protect your Mac, press “Open Anyway”, enter your Mac password, and confirm “Open”.

When the Installer finishes it starts Gulltopp, which sets it to open at login. To compare the file first, run shasum -a 256 <file> in Terminal and match it to the value on the page. To remove Gulltopp, quit it from its menu, then drag Gulltopp from the Applications folder in your home folder to the Bin.

Signing in Press Sign in and allow Gulltopp on heimdall3d.com.

Press Sign in. Your browser opens heimdall3d.com on a page that shows a code, and Gulltopp shows the same code. If you are not signed in to the site, it asks you to sign in first.

Check that the codes match and press Allow. Gulltopp signs in by itself. Not me refuses.

The site makes a key named Gulltopp on and the computer's name, with Portfolio, Storage, Messages, Forum notices and Library. It is listed under Keys on the account page with when it was last used. Removing it there signs Gulltopp out. On Windows, the key is kept in Windows Credential Manager. On a Mac, it is kept in the login Keychain. After Gulltopp is updated, macOS may ask once for your Mac password before Gulltopp can read its key; choose "Always Allow".

A code lasts ten minutes. While Gulltopp waits, the globe symbol opens the page again and the cross stops.

Use a key instead, below the button, takes a key made by hand under Keys with the same five ticked. Paste it and press Enter. The globe beside the field opens the key page.

The tray icon The icon opens the panel above the clock on Windows or from the menu bar on a Mac.

On Windows, a press on the icon opens the panel, and a second press, a press elsewhere, Esc, or the close symbol at the top right of the panel closes it to the tray. A double press on the icon opens the window. The icon shows a dot while a message or a forum notice is waiting. Resting the pointer on it shows the storage in use. The right-click menu opens the window or quits. The window button in the panel opens a larger window with the same views. Closing the panel or a window sends Gulltopp back to the tray, and it keeps running. Starting Gulltopp again, from the Start menu for example, brings its window back. Windows may keep the icon under "Show hidden icons", the arrow by the clock; dragging it from there onto the taskbar keeps it in view.

On a Mac, a press on the horse in the menu bar opens the panel beneath it; a second press, a press elsewhere, Esc, or the close symbol closes it. A right press or Control and a press opens a menu with "Open Gulltopp" and "Quit". While the window or a collection's window is open, Gulltopp is in the Dock and in Cmd-Tab; a press on its Dock icon brings the window back. Opening Gulltopp again while it runs opens the panel. A dot beside the horse means a message or forum notice is waiting.

The title row Shows who is signed in.

Once you are signed in, the title row shows your own mark, the patterned square the forum shows beside your posts, and your name. Before sign-in it shows the horse and the name Gulltopp.

Storage The bar shows the space used of your plan's space.

The bar stays in view in every tab and turns red at nine tenths full. The line beneath names the source: the Heimdall3D licence and its end date, a storage plan with its size and paid-to date, or "No storage plan" or "Plan ended" with the date. A warning mark beside Storage means the site cannot be reached. Gulltopp shows what it last knew and tries again.

Files Your files on heimdall3d.com, newest first.

The tabs Messages, Forum and Files are symbols, each with a count of what is new. Files lists your files with a picture, size and age. A row of its own shows how many files there are and how much they take, with the Client links symbol.

Upload by dropping files and folders on the panel or by pressing the upload area. Any number can be dropped at once, or sent to gulltopp.exe, for example by dragging them onto it. Folders are opened all the way down. On a Mac, the panel closes as soon as you press a Finder window, so drop files and folders on the horse in the menu bar instead; that uploads them and opens the panel on Files. The window and a collection's window take dropped files directly.

Gulltopp takes every format the site takes: glTF and glb, FBX, OBJ, 3MF, STL and PLY models, point clouds and scans (LAS, LAZ, E57, PCD, XYZ, PTS), splats, voxels, streamed captures (.ssog.zip), and pictures (png, jpg, webp). A model can also come as a zip with its textures. A capture, a picture and a glb that holds its own textures go up as they are; a glb that names texture files beside it is converted, so the textures go with it. Any other model is first converted on your computer, by the same converter the site's portfolio page runs, using all of your processor. While it works, the row names the step it is on (Reading textures, Reading the model, Textures, Point tree, Writing, Streamed mesh), how long it has taken, and a bar that fills as the work gets done, with its share in percent. Reading one very large file is a single step, so the bar can rest there for a while as the time goes on. The stop symbol stops a conversion at its next step. A model of a million triangles or more goes up as a streamed mesh, and a large point cloud as a streamed point cloud, as on the site. Text FBX files are not read yet; save them as binary FBX.

A model takes the files beside it: a .gltf its .bin and textures, an .obj its .mtl and maps. Dropping a model's folder makes one file of the model, not one for each texture. A picture alone in its folder is a file of its own.

The original is kept. Once a converted model is up, Gulltopp sends the files you gave it, the model and the files it read beside it, and the site keeps them with it (several as one zip). A symbol on the row shows while they go. Readers may download the original when the file is free to use, under Rights. If the original could not be kept, the model stays and its row says why until you dismiss it.

Two files go up at a time. Large files go up in parts and continue where they stopped. With several on their way, a line shows how many are through of how many, and how much is left. Each waiting, converting or sending file has a stop symbol. The line has one that stops every upload not yet started. A file Gulltopp cannot send keeps its row with the reason in red until you dismiss it with its cross. For a model the converter refuses, the reason says what went wrong.

If Gulltopp is updated or Windows shuts down whilst files are uploading, those being sent get a moment to finish, and any that have not finished are sent again when Gulltopp next starts, into the same collection. No action is required from you.

Press a file to show its controls.

Picking several files Ctrl, Shift and Ctrl+A pick more than one file.

A press picks one file. Ctrl and a press adds a file or takes it away. Shift and a press picks the run from the last file picked. Ctrl+A picks every file. Esc lets go.

On a Mac, Cmd takes the place of Ctrl.

With several picked, a bar shows how many and their size. Its symbols act on all of them at once: give each its own link or turn their links off, set their rights, and remove them. Remove asks for a second press within three seconds. A last symbol clears the selection.

Copy Copies the file's address.
Rights Sets whether a file is view only or free to use.

The certificate symbol among a file's actions opens its rights. It is lit while the file is free to use.

View only is the default. The file is shown in the viewer and never offered for download. All rights are reserved.

Free to use lets anyone download the file and use it, commercially too, under CC0 1.0 or CC BY 4.0.

Each file has an Author and a Source. Author, left empty, credits the portfolio's name. Source is an optional web address.

The switch "I own the rights to this piece" records that you own them, or have permission from whoever does.

A free licence cannot be taken back once someone has downloaded the piece.

Save keeps the choice.

With several files picked, the certificate on the bar sets View only or a licence for all of them at once. Each keeps its own author and source.

A file in a shared collection stays free to use. The site keeps it, and Gulltopp says so.

A download is offered only for a piece that is free to use, under CC0 or CC BY 4.0, chosen in the piece's drawer on the site under Rights. For a view only piece the site refuses the file and the model, and Nothing makes a free piece view only.

sha256 Copies the file's fingerprint.

The window shows the file's sha256, the fingerprint the site stores the file under. It is shortened in the middle to fit. Resting the pointer on it shows it whole, and its copy symbol copies all of it. In the panel, the fingerprint symbol among a picked file's controls copies it. It is what a copy of the file is checked against.

Send to a member Sends the file's link to a member in a message.

Press the send symbol on a picked file to open a search. Type a member's name and press them. Gulltopp gives the file its own link if it has none and sends the link in a message, with the file's name. A line at the bottom says who it went to.

Rename Changes the name the file is shown under.

The pencil among a file's actions, or F2 on the picked file, turns the action row into the file's name, ready to type over. Enter or the tick keeps the new name. Esc or the cross leaves the name as it was. A name is up to 120 characters, and an empty name is not kept.

Rename changes only the name shown, on heimdall3d.com and in Gulltopp. The file's link, its address, its sha256, its collections and the people it was sent to stay as they were. Nobody's link breaks, so a file can be renamed at any time, even while clients are using it.

Open on the site Opens the file's page in the browser.

The page sets the file's background, camera and floor.

Remove Press twice within three seconds to remove the file.

The file is removed from the site. A file another member also stored stays for them.

Collections Named sets of your files, and everyone's public ones.

The Collections tab has two symbols at the top. One shows your own collections and the other shows everyone's public ones.

A collection is a named set of your files with a page of its own. A file can be in any number of collections. Removing a collection leaves its files where they are.

New collection Makes a private collection.

The plus makes a private collection. Type its name and press Enter or the tick.

Visibility Steps through who can see the collection.

Each press moves to the next choice:

  • Private: only you. A lock.
  • Unlisted: anyone with its link. A link symbol.
  • Public: anyone sees it, and your gallery lists it. An eye.
Themes Gives the collection up to three themes.

The tag symbol among your collection's actions shows the twelve themes as symbols. Press one to give your collection that theme. Press it again to take it away.

A collection carries up to three themes. While three are chosen, the others stand dimmed. A collection's themes show as small symbols at the end of its row.

The themes are Architecture, Interiors, Characters, Creatures, Vehicles, Products, Props, Nature, Scans and captures, Animation, Stylised and Abstract. Each symbol's name shows when the pointer rests on it.

Themes are also set on heimdall3d.com, in the collection's editor.

Rename a collection Changes the name the collection is shown under.

The pencil turns the collection's row into its name, ready to type over. Enter or the tick keeps the new name.

A collection's address is set when it is made. Renaming changes only the name shown, and links already given out keep working.

Remove a collection Press twice within three seconds to remove the collection.

The bin removes the collection when pressed twice within three seconds. Its files stay in your storage.

Everyone's Public collections from members of heimdall3d.com.

The list holds the public collections of members whose portfolios are public, newest change first. The search finds a collection by its name or a member by name.

Press a member's name to show only their collections. The cross on the "by" chip shows everyone's again.

A row of the twelve theme symbols sits under the search. Press one to show only collections with that theme. Press it again to show all. It works together with the search and with a member's name.

An unlisted collection opens from its link pasted in the field at the bottom.

Put in a collection Puts the picked files in a collection.

The collection symbol sits among a file's actions, and on the bar when several files are picked. Pick a collection, or type a new one's name to make it with them. A tick marks a collection that already holds them.

The collection window Opens the collection as a grid of pictures.

Double-click a collection, or press its open symbol, to open it in its own window as a grid of pictures. Double-click a picture to open it on heimdall3d.com.

The download symbol appears only where the file's owner allows downloads.

Arranging your own collection Moves, removes and adds pictures in your collection.

In the collection's window, drag a picture onto another's place to move it. The cross on a picture takes it out of the collection, and the file stays in your storage. Files dropped on the window are uploaded and put in the collection.

Library Your collection of world-building kits available in any scene.

The Library is where you add kits under authors and send them to the site. Others can then use your kits in their scenes on heimdall3d.com.

Kits are named in the form library:author/kit/piece. For example, library:kenney/castle/tower-round is a tower piece from the castle kit published by kenney.

Authors A person or organisation providing kits for the library.

An author is a person or an organisation—a company, a studio, a museum. You create an author once, providing its name as it appears in credits, its web address, and its usual licence (CC0 or CC BY). Every kit you add under that author inherits these details. The web address is required because credits link to it. The author's name appears in short form in Gulltopp; Poly Haven becomes poly-haven.

Authors appear as folders in the Collections tab. Press an author's folder to see its kits. To add a kit to an author, drop the kit's folder, or a .zip file containing it, on the author's page. Gulltopp searches the contents for models, including nested folders. Kits often contain several formats (GLB, glTF, FBX, OBJ); Gulltopp selects the best format available. Files only in lesser formats are omitted and listed on the row with their count, so nothing is dropped without notice.

To edit an author, press the pen icon. To remove an author, press the bin icon twice. Kits already on the site remain even if their author is removed. An author cannot be deleted whilst one of its kits is being made.

Kits Converting and publishing your models as kits for the library.

Before anything is sent, the row shows the kit's title, its name in the library (castle-kit becomes castle), the kit's own web page, and the detail level (Stylised, Detailed or Realistic), all changeable. The kit's own page starts as the author's web address; it is credited as where the kit comes from. The row also says how many pieces and which format they are made from ("76 pieces, from its FBX files"). The full name library:author/name appears below. Press the tick to make the kit, or the cross to leave it.

Making a kit has four steps, and each shows a bar that fills from real counts: Converting (pieces done of all pieces; each piece is converted on your computer, using all of your processor, into one self-contained model with its textures inside), Writing the kit (bytes written of the whole), Sending (bytes sent of the whole; sent in parts that continue where they stopped), and the site's check.

During the site's check the row shows the site's own words for what it is doing (for example "Reading the pieces · 21 of 76") with the seconds waited. When the site is waiting for another kit or recording the collection, a short bar sweeps across instead, because there is nothing to count.

If the connection drops or the site is busy for a moment, Gulltopp asks again; if the site had a problem of its own, Gulltopp sends the kit's finish again, up to three times. After 15 minutes Gulltopp stops waiting and says so.

Press the cross to stop a kit being made. During the site's check the cross only stops Gulltopp watching: the site goes on, and the kit appears in your collection when it is done.

When the kit is taken, the row shows the kit's name and piece count. On the site it is a draft until a still of each piece is drawn; then it can be published.

Below the kits being made, an author's page lists "On heimdall3d.com": that author's kits as the site holds them, drafts included. Each row shows the kit's name, its pieces, and how many of its stills are drawn, with a bar, until all are. Press a kit to see its pieces as a grid of the site's stills, each with the piece's name, category and size in metres (width × height × depth), as the site's library shows it. Press the back arrow to return to the author.

A piece whose still is not drawn yet shows "Still to be drawn". The line above the grid says how many of the stills are drawn. To draw the missing ones, press the globe beside the kit or above its grid. It opens the kit's page on heimdall3d.com; while signed in, press play there and your browser draws each missing still. Gulltopp looks again every few seconds while stills are missing, so they appear as they are drawn.

If something is wrong (a folder with no models, two models that would have the same name, a zip that cannot be read, or a kit the site refuses, with its reasons), the row says so in red. Press the cross to dismiss it. Several kits dropped at once are named one after another.

Your portfolio What your portfolio page says about you, edited here.

The last tab, your mark, holds what your page on heimdall3d.com shows beside your work. In the window, the left side is your column as visitors see it, in your own theme, and it follows what you change. The cards on the right make it:

  • Person: your name, the line under it, and a few words about you. Drop a picture on the tab to make it your portrait; the cross under it removes it.
  • Places: your shop, which stands first and largest on your page, Patreon and your own site, then any other platforms. Paste a platform's address in the last box and press Enter; the cross on a row removes it.
  • Offers: press an offer to show or hide it. Type another in the box below and press Enter.
  • Facts: where you are based, since when, and what you work in.
  • Theme: light or dark, the lettering (House, Classic or Sans) and an accent. Your portfolio, collections and pieces are all drawn in it.

A field is taken when you leave it or press Enter, and a press on an offer, a theme or an accent shows at once; what you change is saved together once you pause, and straight away when you leave the tab, close or minimise the window, or quit Gulltopp. The website keeps exactly the same things, so a change made here shows on your page at once, and one made on the page shows here. If the site refuses a change, for example a year that is not four digits or an accent too pale to read on your theme, the line at the bottom says why in the site's words and the field shows what is kept; the other changes saved with it are kept. The globe at the top of the column opens your page.

Messages Conversations with other members.

Conversations are listed newest first, with unread ones marked. Members are shown with their own marks, as on the forum, and by the name on their portfolio; a member without one is shown by their account's name, or their handle. A ring at the corner of a mark means they are about. Enter sends, and Shift+Enter starts a new line.

Esc goes back to the list when the message box is empty. With words in the box, the first Esc lets go of the box and the second goes back. Esc in the list closes the panel.

A message can carry bold, italic and code. Two stars on each side of a word make it bold, one star italic, a backtick code.

To write to somebody, press the pen button and type part of a member's name, portfolio name or handle. The members found are listed under the box as you type, each with their mark and name, once you pause; Enter picks the first. Before you type, the list holds the people you have talked with. "Looking…" shows while the site answers, and "No one found" when nobody matches. You never find yourself: typing your own name says "That's you", with your mark, which also shows which account Gulltopp is signed in as. Sending a file to a member uses the same search.

Smileys Opens the smiley picker over the conversation.

The smiley button sits beside Send in a conversation. Pressing it opens the picker over the conversation, and pressing it again or pressing Esc closes it. The picker has a tab for the smileys used most recently, a tab for each group (Smileys & Emotion, People & Body, Animals & Nature, Food & Drink, Travel & Places, Activities, Objects and Symbols) and a search box on its own row under the group tabs that finds smileys by name. It lists only smileys that show in colour. The mouse wheel over the open picker scrolls the picker only. Pressing a smiley puts it into the message where the cursor is, and the cursor stays in the message, so you can keep typing straight away. The recent tab keeps the last 24 used, newest first, and Gulltopp remembers them. Typing a smiley's name between colons, such as :grinning_face: or :thumbs_up:, turns it into the smiley as the second colon is typed, provided the first colon begins a word. Text such as "10:30:" or "a:b:" stays as typed. Resting the pointer on a smiley in the picker shows its name. Smileys show in full colour in Gulltopp's messages, and messages sent from Gulltopp show them on the website's chat as well. A smiley with a skin tone, or one made of several joined together, such as a technologist with a skin tone or a heart on fire, shows as one smiley in messages.

Forum Forum notices that concern you.

A notice appears for a mention of you and for a reply in a thread you started or posted in. Press a notice to open the post. Opening the tab marks the notices read. New notices keep an accent edge until you open the tab again.

Look Sets the colours of the panel.

Each style is shown as a small window in its own colours in Settings. Light and Dark are heimdall3d.com's own (Gulltopp starts with Light), Pearl and Onyx are Gulltopp's own warmer light and dark versions, and Fjord is deep blue-grey. As Windows (or As macOS on a Mac) follows your system's setting by using Light or Dark, shown in its tile.

Start with Windows Starts Gulltopp when Windows starts.

On a Mac, this switch is named Open at login.

Tell me Chooses what Gulltopp tells you about.
  • New messages.
  • Forum notices.
  • With a Windows notification on Windows or with a notification on a Mac. A press on the notification opens the conversation or the post.

New messages and Forum notices decide whether Gulltopp tells you, with the dot on the icon and the notification. The Messages and Forum tabs keep working with them off. On a Mac, the first time, macOS asks whether Gulltopp may send notifications; choose "Allow" or turn it on later in System Settings, Notifications, Gulltopp. A message notification shows the sender's mark, the patterned square the forum shows beside their posts. A press on a notification opens that conversation or forum post.

Forum notices for Chooses which forum events make a notice.
  • Replies in my threads.
  • Replies after my posts.
  • Mentions of me.

These three switches are the same settings as Forum mail on your account page at heimdall3d.com, so they also decide which of these events heimdall3d.com emails you about, one email per post. Choosing "All forum mail off" on the account page stops the emails, and Gulltopp's notices keep coming.

These are the same settings as on the account page.

Sign out Signs this program out of your account.

Signed in as shows the account in use.

Version Shows which Gulltopp you have.

The foot of Settings shows the version, for example Gulltopp 1.2.5, and so does the tooltip on the tray icon (the menu bar icon on a Mac) until it shows your storage. The site's download page lists the newest version so you can compare.

Sent from Heimdall3D Shows the files a scene sent from Heimdall3D and lets you choose where they go.

When Heimdall3D sends a scene, Gulltopp opens on its Files tab. A sheet named Send and the scene's name lists the files that came.

You choose where they go in one of three ways:

  • Type a name for a new collection and press the plus. The eye, link or lock symbol beside the name sets who sees the new collection: public, unlisted or private.
  • Press one of your own collections.
  • Press Files only to upload the files as files.

The back arrow cancels without sending.

The files upload as any file does. Once the last file has landed, Gulltopp makes the new collection with them, or adds them to the collection you chose. If you send the same scene again, that scene's collection is listed first and marked with a tick.

A file that sits in the same folder as a model goes up with that model.

Portfolio

Your portfolio

Your page at heimdall3d.com/u/your-name: your work beside a column about you, in your own light or dark theme.

The Your portfolio card

The page shows all your work under All work, with the count and the order beside it. The piece marked as the hero is featured first on the column's tint; without one, the first piece is. The rest follow in an even grid, each with its title, its kind and a line of facts. Opening a piece shows it at full size with the column still beside it, except on a piece's own shared link, which shows that piece alone.

The column holds your picture, name and line, then your places, offers, about, sections, facts and numbers. A block you leave empty is not shown. Everything is set on Your portfolio, under your account.

A piece's title is the one you give it. Until you do, it is its file's name made readable: kalasatama-2.ssog.zip shows as Kalasatama 2, CL_Head1.glb as Cl head1. Once you change a title it is shown exactly as you wrote it.

Your portfolio, as you see it Your own page with a bar over it: View, Edit and Manage, your storage, and symbols to add files, add a folder, set the theme, share, and see the page as a visitor does.

Your portfolio is drawn in your own theme, light or dark, as visitors see it. The bar's storage line opens what you hold against your plan, this month's traffic and the storage plans. Each symbol's name is in its tooltip.

View shows the page as it stands. Edit makes the column editable where it stands: your name, line, contact, places, offers, about and facts are fields in the column, each saved when you leave it or stop typing. The order of your work is chosen beside All work. Each piece carries two handles on its corner: drag the dotted one to move the piece, or press it and use the arrow keys, and press the pencil to open the piece's drawer. Dragging a piece lists your work in the order you arranged.

Adding work Drop files or a folder anywhere on the page, or use the bar's upload and folder symbols.

Files dropped on the page go into All work; dropped on a section in the column, or on a section in Manage, they go into that section too; with your work listed as arranged, dropped on a piece they go before it. A folder keeps a model and its textures together as one piece. A zip of many models, a kit, becomes one piece per model, each with the textures beside it; a zip holding one model, a streamed capture, mesh or point cloud, and a zip that cannot be opened in the page go up as they are. Every file goes through one queue in the corner, in order, with its progress; one that has not started can be taken out, and a large one can be paused and continued.

A piece's drawer The live view on top, then Details, Look and Sharing, saved as you go.

Details holds the title, the line under it, the sections it is in and whether it is featured first. Look holds the light (None is no environment at all: the piece lit by its key, fill and rim lights and any lights placed in it, its background behind), the sun, the ground and the background as choices you see change in the view above, the surface for a point cloud, and Picture only; the camera symbol, Keep this view, keeps the view you turned it to as where the piece opens and takes the piece's still from exactly that view in the same press, then shows the new still at once. The same camera symbol sits over each running piece on your gallery and on the piece's own page, for you alone: turn the piece there and press it to keep that view and its still the same way, without opening the drawer. The view in the drawer is the still's own shape, so what you frame there is what the still holds; pause an animated model first to keep its pose. The picture-and-arrow symbol beside it remakes the thumbnail from where the piece opens, at its look, in your own browser: a model framed to fill the picture, a capture, point cloud or streamed mesh from where its walk starts, and a streamed mesh that is a point cloud's surface from that cloud's start. A streamed mesh with no start of its own is seen from above, filling the picture, until you walk into it and keep that view with the camera symbol. Until you choose a look, a piece is shown on the sky's picture, standing on a floor with no grid. Sharing holds the piece's rights, its own link with its picture and embed to copy, and who else may edit its exhibit. At the foot: replace the file (its exhibit, links, embeds and views stay), copy the embed, copy its own link (both turn the link on if it is off), and remove, which asks first. The exhibit is edited in the view itself.

Rights View only, or free to use under CC0 or CC BY 4.0, chosen for each piece in its drawer.

Every piece is in one of two modes. View only is the default: the piece is shown in the viewer and never offered to download, and all rights stay with you. Free to use lets anyone download the original and the glb and use them, commercially too, under CC0 1.0 or CC BY 4.0; no other licence is offered. Choosing free to use starts at CC BY 4.0, credited to your portfolio's name; the author and an optional source link can be changed beside it. A streamed capture, mesh or point cloud offers its original only.

The credit shows wherever the piece does: in the corner of the viewer, the author linked to the source and the licence's name to its deed, under the piece on its page, on collection walls, in embeds, and in what a collection link gives a program. Shared collections and kits for building worlds take free-to-use pieces only.

Three things to know. View only stops casual copying, not a determined one: to show a model, a browser has to be sent it. A free licence cannot be taken back once someone has downloaded the piece, and a piece used in a world can only be unlisted. By putting a piece here you confirm you own its rights, or have permission from whoever does; the tick under Rights records it and never stops anything. The site's terms say the same under Models you put on the site.

Pieces that offered downloads before there were licences had none recorded, so they became view only; each says so once in its drawer until you choose a mode or close the notice.

Manage Your sections down the left, a section's pieces to pick from, and the library's checks.

Pick pieces with their boxes, then put them into a section or take them out of this one, turn their own links on or off, set their rights, or remove them together. Drag a piece by its handle to order the section. The plus under the sections makes a new one; the gear beside a section's name opens its name, words, who sees it and its link. All work offers everything as one download. The library's checks are listed there and run once the library is open.

Theme and sharing The bar's brush opens the theme; its link symbol opens sharing.

Sharing holds whether the page is public, the client links (each opens the unlisted page for whoever holds it, is shown once when made, and can be revoked), and the sites a free account's embeds may be on.

A public portfolio with a picture to show is listed at heimdall3d.com/portfolios, newest first, drawn in your own light or dark base and accent with your portrait, your featured piece's still and your count of pieces. Community's Portfolios card leads there. An unlisted or private portfolio is never listed.

About you Your name, the line under it, how to contact you, and a few words about you and your work.

The line is shown under your name. The contact, an email address or a web address, becomes the envelope symbol. The words appear under About.

Places Your shop, your Patreon, your own site and the platforms you post on.

The shop is shown first and largest, as a dark block. Patreon and your own site follow as rows, then each platform as its symbol, with its name in the tooltip. ArtStation, Sketchfab, YouTube, Ko-fi, Instagram, Bluesky, Mastodon, Patreon and itch.io are known by their marks; any other address shows a link symbol named by its site. Write each as a web address, platforms one to a line, up to 12. An address without https:// is taken as one.

Offers and facts What you offer, where you are based, since when, and what you work in.

Offers are one to a line, up to 8, each up to 60 characters. Since is a year. Views under Numbers counts the views of all your pieces. Sections lists All work and each of your public collections with its number of pieces, and appears once you have a public collection.

Order of your work Newest first, or in the order you arranged by dragging each piece.

Newest first is the default. The hero is featured first in either order.

Theme Light (pearl) or dark (onyx), an accent, a type pair, a banner and a portrait.

The theme draws your portfolio, your collections and your pieces' pages, and nothing else; embeds keep their own look. Choose one of the accents offered or write your own as # and six digits or letters, like #0D6680. An accent is refused when it reads below 4.5 : 1 on its page or on the column, and the refusal names the nearest colour that reads. The preset accents read on both bases. The type pairs are Newsreader with Public Sans, Georgia with the system's sans, and the system's sans throughout. The banner runs across the top of the page and the portrait replaces the pattern drawn from your name; each is a PNG, JPEG or WebP picture of up to 2 MB, removed with its own button. A picture is kept exactly as sent, with whatever it carries, such as where a photo was taken, so remove that first if it should not be public.

Founders A personal invitation link: 25 GB of storage for twelve months with nothing to pay, and the Founders board.

A founding tester's link works with a new account or one you already have: register or sign in from it, then accept the invitation. The account then holds 25 GB for twelve months from that day, as the 25 GB plan does, with nothing to pay, and can read and post in the Founders space on the board, which only founding testers and the site's administrators see. Each link works once, and an account can be a founding tester once. We mail you a month and a week before the twelve months end. After that the account has the free storage again, or the same 25 GB at EUR 3.99 a month; nothing is deleted, but while the account holds more than the free storage every piece shows as its still with the mark, and tours need a plan to stay published.

Organisations A museum, gallery, heritage site, park or other venue: its own place, seen only by its team.

An organisation's work is private. Its page never goes public, its collections are never public or shared to the library, and none of its pieces gets a shared link of its own. Visitors see its work only in the organisation's embeds and exhibitions on its own website or at the venue. Its address answers only to its members, even through an access link. A piece moved into an organisation keeps its views, but a shared link it had stops working.

Working for an organisation, its home shows two columns: its exhibitions on the left (its tours, for a park or heritage site), and its objects on the right. Choosing an exhibition shows only the objects in it. When you make an organisation you say what it is, a museum, gallery, heritage site, castle or park, trade fair or memorial, and the workspace uses that venue's words.

The code the Website section gives for an organisation's piece carries that piece's own embed address. It opens that one view and the files it draws, and nothing else: not the organisation's page, not its other pieces. Under the code, the arrow symbol gives the piece a new address, and the old code stops working. The cross withdraws the address until you ask for a new one. Neither touches the organisation's access links.

Portfolio

Animation file

Opens the card that saves the animation to a file or loads one.

The Animation file card

The card holds Save animation, Load animation and a line that says where the animation stands: "Saved in Ninja.h3anim", "Changed since saved in Ninja.h3anim" or "Not saved to a file". When the model has no animation yet, Save animation cannot be pressed and the line reads "No animation to save". The button at the right end of the Timeline dock's top row, after Loop, opens it. The button is drawn in the warm accent colour while the animation is in no file or has changed since it was saved.

Save animation Saves the animation to a .h3anim file you name.

Save animation opens a save dialog. The first time, it opens in the model's own folder with the model's name and the .h3anim extension, so Ninja.fbx gives Ninja.h3anim. After a save or a load it opens on that same file. You can name the file anything and keep it anywhere; it is always written with the .h3anim extension. Saving is free and needs no licence.

The file holds the keys on every layer, the scene's cameras and their cuts, the timeline's range and rate, the motions put on characters, Drive bys, the camera held and whether the file's own clip was cleared. Save animation is there once the model has an animation: keys, a camera, a motion or a Drive by. If the animation cannot be written, the line says "The animation could not be written".

The model remembers the file it was last saved to or loaded from, wherever it is, and opens with it next time. With none remembered, the file beside the model with its name is used. Heimdall3D also keeps your latest animation work for each model, so moving to another file or closing the window loses nothing. When the file was written after that kept work, the model opens with the file. When the kept work is newer, the model opens with the kept work and the line says "Changed since saved in Ninja.h3anim".

Clear all keys never deletes a .h3anim file you saved: the card keeps naming the file, and the model opens without it until Save animation or Load animation names a file again, or until an Undo brings the keys back to what the file holds, when the model opens with that file again.

Load animation Puts the animation from a .h3anim file on the model.

Load animation opens a dialog to pick a .h3anim file. Keys follow objects by their names, so a key for an object this model does not have is left out. Load animation is one step of Undo. Loading is free and needs no licence.

When the file holds no animation the viewer can read, the line says "That file holds no animation that could be read". Closing the dialog without choosing changes nothing and shows no message.

In the Explorer preview pane the dialogs are shown by the Heimdall3D export agent, which must be running; it is switched on in Configure. Everything else is the same.

Portfolio

Which face is the largest flat one

Shows the area of the model's largest flat outer face and turns that face onto the build plate.

The Which face is the largest flat one card

The Lay Flat card reports the area of the largest flat face on the outside of the model, in square centimetres, at the size the model prints. The figure follows the unit and print scale set on the Build volume card. The face is found while the file loads, so the area is ready when the model appears. A model resting on a large flat face usually prints with fewer supports and a firmer grip on the bed.

Largest face down Rests the largest flat face on the build plate.

The opened model turns so that its largest face sits on the plate, and the model is set on the floor. It is one step, and Undo reverses it. The face is the opened model's own, also when other models have been added to the scene, and only the opened model turns. Pressing it with the face already down sets the model on the floor if it is not already there.

Portfolio

The model cut at one layer

Shows the model as a printer builds it, cut at the chosen layer with the cut face filled in amber.

The The model cut at one layer card

The Layers card is in Print mode, on the Print strip beside Overhang. Everything above the chosen layer is cut away and the cut face is filled in a flat amber, so the inside of the model at that height can be seen. Heights are measured from the model's lowest point, which is where it rests on the build plate. Layers follow the unit and the print scale set on the Build volume card. When the file's unit is not known, the card says so and the layer track is unavailable. The cut applies only while in Print mode.

Cut Cuts the model at the chosen layer.

On, the model is cut at the chosen layer. Off, the whole model is shown. The default is off, and Reset restores it.

Layer height Sets the height of one layer, from 0.025 mm to 0.6 mm.

It moves in steps of 0.01 mm. The default is 0.2 mm, and Reset restores it. Changing it keeps the cut at the same height, so the layer number under the cut changes.

Layer Chooses the layer the model is cut at, from 1 to the model's layer count.

It moves in whole layers. A newly opened model starts at its middle layer. The line under the track reads, for example, "Layer 57 of 286, 11.40 mm up".

Portfolio

Scripts

Opens the Scripts card, where scripts that build or change a scene are run and edited.

The Scripts card

A script is a plain text file with the extension .h3ds. It holds commands that build or change a scene: adding models, placing and turning them, grouping, lights, cameras, settings and keys. An AI model can also write scripts through the viewer's control pipe.

The card shows every script as a tile: the scripts in the Documents\Heimdall3D\Scripts folder, the scripts that ship with Heimdall3D, and scripts opened from anywhere else. A tile shows a picture of the scene from the script's last run, or a script symbol if it has not run yet. The name of the script under the pointer appears below the grid.

Pressing a tile runs that script. A script runs as one step, so Undo takes back everything it did. If a line cannot be carried out, nothing the script did stays, and the card says which line and why. A line under the grid says what the last run, save or open did. A .h3ds file dropped on the viewer, or opened from Directory Opus or Explorer, opens in the notebook ready to run.

New Starts an empty script in the notebook.

New opens the notebook with an empty script. The script is given a name when it is saved.

Open Picks a .h3ds file from anywhere and opens it in the notebook.

Open shows a file picker for .h3ds files. The chosen script joins the grid and opens in the notebook.

Edit Opens the script last pressed in the notebook.

Edit opens the script you pressed last in the notebook. Its file name is shown in the notebook's top band.

Save the scene as a script Writes the scene in the viewer as a script file that rebuilds it.

The script holds the models, where each one stands, groups, lights, cameras, settings and keys. Running it later rebuilds the scene. The new script joins the grid.

Script The text of the script being edited.

The notebook is a panel of its own, and the grid stays in the Scripts card while a script is edited. The notebook stands docked at the right edge of the pane or floats over the picture, and its top band shows the script's file name. The text is the list of commands the script runs.

The script is coloured as you type: verbs amber, names blue, numbers green, quoted text lilac, settings teal, functions gold and comments dim grey. The full table is in the language specification's appendix "Colours in the notepad".

A long line stays one line and the text scrolls sideways to keep the cursor in view. A script of a hundred thousand lines stays quick to type in and scroll.

The notebook shows a line number beside every line. A line that starts with ## opens a section, and the words after ## are the section's name. For example:

## Make the lamp $lamp = add light point as Lamp at 0 2 0 ## Move it place $lamp at {1 2 0}

A section runs to the next ## line or the end of the script. To a script run in full, a ## line is a comment, so a notebook is an ordinary .h3ds file, shared and run like any other.

Beside each ## line, in the left margin, is an amber run button. Pressing it runs that section alone. A section run starts from the names ($lamp) that earlier section runs made, so sections can be run one after another, skipped, or run again. A section run again makes its names again: a line such as $lamp = add light ... adds another light to the scene. Lines before the first ## line run only with Run. Undo, Redo, opening another file and closing the notebook clear the names the sections made and what the sections showed. When a section has run, its button turns green and the line shows the run's number and how many lines ran, for example "[2] Ran 1 line.". When a section stops on a line, its button turns red and the line shows the refusal, with the line number as the notebook shows it.

Escape while typing in the notebook leaves the text with every edit kept.

Pieces from the library Names a model from the heimdall3d.com library in place of a file path.

The model library at heimdall3d.com/library holds collections of pieces, each collection published by an author, for example Kenney's Castle Kit. A script or a scene names a piece as library:<author>/<collection>/<piece>, such as library:kenney/castle/wall or library:kenney/castle/tower-hexagon-roof. The name is the same on every computer. add model and open take a library name where they take a file's path.

The first time a piece is used, Heimdall3D looks the name up in the site's catalogue and downloads that piece once from heimdall3d.com. Afterwards the piece is read from a copy kept on this computer, and the copy is checked against the piece's fingerprint (its sha256) before it is used. The download happens off the window's thread, and the picture shows the piece when it arrives.

A piece in a published collection stays there, so a script that names library pieces builds the same scene for everyone who runs it. A scene saved as a script keeps the library names. If the site cannot be reached, or the name is not in a collection, the line is refused with the reason, for example "the library has no piece kenney/castle/wal".

$wall = add model "library:kenney/castle/wall" at 0 0 0 each x in 1..4: add model "library:kenney/castle/wall" at {$x 0 0}

Run Runs the text as it stands in the notebook.

Run carries out the commands in the notebook, including changes that have not been saved. It runs the whole script from the top, starting from no names, and clears what the sections showed. The run is one step, and Undo takes back all of it.

Undo Undoes the last change to the script's text.

A run of typing, or of backspaces, is one step, and a paste is one step. Ctrl+Z does the same while typing in the notebook; elsewhere Ctrl+Z still undoes the scene.

Redo Puts back the change Undo took.

Ctrl+Y or Ctrl+Shift+Z does the same while typing in the notebook. A new change after an Undo clears what Redo could put back.

Copy Copies the selected text, or the whole script when nothing is selected.
Paste Pastes text into the script at the cursor.
Send to Gulltopp Sends the script in the notebook to Gulltopp.

The Send to Gulltopp symbol sits in the notebook's row of symbols. It appears only while Gulltopp is installed and signed in on this computer. Press it to hand Gulltopp the script as it stands, unsaved changes included. Gulltopp opens and asks where the script goes: a new collection, one of your own collections, or a file. The notebook's status line reads "Sending", then "In Gulltopp". If the script was not sent, the status line gives the reason. The scene's models and a still are sent from the Capture a still card.

Save Writes the script to its file.

Save writes the text to the script's file. A script that ships with Heimdall3D, or a new one, asks for a name first.

Save as Writes the script under a name and place you choose.

Save as asks for a file name and a folder, then writes the script there. The notebook continues with the new file.

Docked Puts the notebook back at the right edge of the pane.

Docked stands the notebook in a column at the right edge of the pane, as tall as the pane and beside the scene dock when that is open. The picture becomes narrower to make room, and dragging the notebook's left edge makes the column wider or narrower. In a pane too narrow to spare the width, the notebook stands as a window even when Docked is chosen.

Floating Makes the notebook a window of its own over the picture.

Floating gives the picture its full width back. Drag the top band to move the window, and drag any edge or corner to resize it. Where the notebook stands, its docked width and the floating window's place and size are kept for next time.

Close Closes the notebook.

Close closes the notebook. The grid of scripts stays in the Scripts card.

The notebook tracks whether its text has changed since it was opened or last saved. When unsaved changes would be replaced or closed, a question appears first. This happens on New, on Close, on editing a shipped script, and when a script file is opened, dropped on the picture or opened from Directory Opus or Explorer; for a file, the question appears once the file has been read. Discard throws the changes away and goes ahead, and Keep it leaves the text as it is. If the viewer window closes with unsaved changes in the notebook, the text is kept as a new script named "Unsaved" followed by the date and time, in the Scripts folder, where it appears as a tile in the Scripts card.

Take commands Lets other programs on this computer send commands to the open window.

Take commands is a switch on the Configure page (Directory Opus: Preferences > Viewers > Heimdall3D > Configure). It is off unless you turn it on. While it is on, the Heimdall3D window you used last takes commands from other programs on this computer, for example heimdall3d_view.exe --call apply <file> or an AI assistant connected through heimdall3d_view.exe --mcp. You see each command happen in that window. Only programs running under your own Windows account can send commands. Programs on other computers cannot. The commands are the same ones a script uses. Each change can be undone, and files are written only into the export folder. Exports that need a licence still need one. Pressing in another Heimdall3D window makes that window take the commands. Closing the last window stops them. While Take commands is on, the window that takes commands shows a terminal symbol on the toolbar at the top right of the picture, under the book that opens the manual. Like the rest of the toolbar, it shows while the pointer is over the picture. Pressing the symbol turns Take commands off, and no window takes commands until you turn it on again on the Configure page. Programs that run with lower rights under your account, such as a web browser's sandbox, cannot send commands either.

Portfolio

Which walls are too thin to print

The card colours the model by wall thickness, red where a wall is thinner than the minimum.

The Which walls are too thin to print card

The Thin walls card is in Print mode, on the Print strip beside Overhang. The card colours each point of the model by the thickness of the wall behind it. Points are red where the wall is thinner than the minimum, amber where it is under 1.5 times the minimum and grey elsewhere, as a legend on the card shows. The thickness is measured on the graphics card, through the model along the direction the surface faces, from the model as it is placed and posed. The minimum follows the unit and the print scale set on the Build volume card. When the file's unit is not known, the card says so and nothing is coloured red.

Show thin walls Shows the thin walls colouring.

The same view as the thin walls cell on the Shading mode card. On, the thin walls view is shown. Off, the shaded model is shown. The default is off.

Minimum wall Sets the thinnest wall that counts as printable, from 0.2 mm to 3.0 mm.

It moves in steps of 0.05 mm. The default is 0.8 mm, and Reset restores it.