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.
The Viewpoint card places the camera at a named pose and sets its lens.
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.
isometricThe classic isometric view from above a corner.
iso 2:1The 2:1 isometric used for pixel art, where each diagonal line steps two pixels across for one down.
frontA view of the model from the front.
rightA view of the model from the right.
backA view of the model from the back.
leftA view of the model from the left.
topA view of the model from the top.
bottomA 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.
LensThe 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 viewThe 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.
14Set Lens to 14 millimetres.
24Set Lens to 24 millimetres.
35Set Lens to 35 millimetres.
50Set Lens to 50 millimetres.
85Set Lens to 85 millimetres.
135Set Lens to 135 millimetres.
FFCamera body: 36 × 24 mm full frame.
S35Camera body: 24.9 × 18.7 mm Super 35.
APS-CCamera body: 23.6 × 15.6 mm APS-C.
M4/3Camera body: 17.3 × 13 mm Four Thirds.
PhoneCamera body: 9.8 × 7.4 mm phone sensor.
Near clip from nearest surfaceThe 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 clipBrings 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 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 cameraAdd a camera at the current view and cut to it at the playhead.
Look throughShow 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 cameraKey the picked camera's position at the playhead.
Aim at selectedKeep the selected object in view as the camera moves.
While this is on, the button reads "Following".
RemoveRemove the picked camera.
NameThe name of the camera in use, so cameras can be told apart.
Camera
Places
Saves and opens named views inside a capture.
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 nameThe name to save this place under.
The place is numbered if this box is left empty.
AddSaves the current view as a place.
The view is saved with the name in the box, or numbered if the box is empty.
Start hereThe capture opens at this place from now on.
The capture loads at this place when the file is opened next.
RemoveDeletes 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.
KeyboardMove 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 padA 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 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 environmentThe first cell of the gallery; the model is lit without a map.
SunTurns the environment map around the model, moving the sun and every light. Range 0 to 360 degrees.
Lights the modelWhether the environment map lights the model.
When off, the Strength slider is greyed.
StrengthHow strongly the environment map lights the model. Range 0.05 to 2.
colourA flat colour stands behind the model.
gradientA vertical sweep from the picked colour at the top to a darker colour at the bottom stands behind the model.
mapThe environment map itself stands behind the model, turned with the Sun slider.
imageA picture from the backdrop folder stands behind the model, scaled to cover the whole view.
FalloffHow much darker the bottom of the gradient is than the picked colour. Range 0 to 0.9.
Works with the gradient backdrop.
BlendHow strongly the map or picture covers the backdrop colour beneath it. Range 0.05 to 1.
Works with the map and image backdrops.
StopsThe 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.
BlurSoftens 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 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.
FloorShows or hides the floor.
Same state as the toolbar button and the F key.
GridDraws 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.
neutralPlain untextured floor.
The default material.
marblePolished marble.
tilesTiled floor.
woodWooden floor of long boards.
planksRough plank boards.
metalMetal tread plate with raised diamond pattern.
rockNatural rock.
groundBare earth with leaves and grit.
concretePoured concrete.
showroomDark polished stone with wavy veins.
pavingOutdoor paving stones.
grassLawn.
carpetCarpet.
ScaleMultiplier 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 XSlides the material sideways across the floor.
Range -4 to 4 tiles, default 0.
Pan YSlides the material along the other floor axis.
Range -4 to 4 tiles, default 0.
RotationTurns the material on the floor.
Range 0 to 360 degrees, default 0.
HeightRaises 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 belowDisplays 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 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 lightsSwitch 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.
KeyTurn the key light on or off.
The key is the main light.
FillTurn the fill light on or off.
The fill light lifts the shadows.
RimTurn the rim light on or off.
The rim light lights the model's edge from behind.
DistanceHow far the picked light stands from the model.
The range is 1.1 to 8 model radii.
IntensityHow 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.
SizeHow large the picked light is.
The range is 0.02 to 1. A larger light gives softer shadows and broader highlights.
NoneThe 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.
NearThe distance at which the light takes its "At near" intensity.
The range is 0 to 8 model radii.
FarThe distance at which the light takes its "At far" intensity.
Between Near and Far, intensity moves smoothly from one to the other.
At nearThe 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 farThe 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.
FileThe whole group on or off
Switch for all the lights stored in the model file.
GlowingThe whole group on or off
Switch for the model's glowing parts acting as lights on the scene.
CastingLamps and spots that cast shadows at once
A number with minus and plus buttons, 0 to 16.
ShadowsAll shadows on or off
Contact shadowsDarkens where parts meet surfaces under placed lamps and the file's own lights
SoftSoftens 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 cardOpens the Rendering card.
The Rendering card is where the key light's ray-traced shadow is set.
three-pointThe default rig: a warm key front-left, a cool fill, an amber rim behind.
rembrandtA high, hard key at 45 degrees and a faint fill.
This is the classic triangle of light on the shadowed cheek.
butterflyThe key high over the camera with a broad soft fill beneath.
splitOne light square from the side, lighting half the model.
rimTwo lights behind the model and a weak front light.
This setup creates a strong silhouette.
productLarge, near-white, even light, as in a catalogue photograph.
windowedLight 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.
linearLight fades in a straight line to the edge of its reach.
flatConstant brightness at every distance, like sunlight from a placed lamp.
Emitters / StrengthHow 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 / SoftnessHow soft the edge of the key light's shadow is.
noneThe light casts no pattern.
This is the default.
stripesCasts stripes through the lights.
Like a stencil in front of a lamp.
windowCasts a window frame through the lights.
Like a stencil in front of a lamp.
dappleCasts dappled light through the lights.
Like a stencil in front of a lamp.
causticsCasts moving water caustics through the lights.
The Phase slider moves them.
leavesCasts moving leaves through the lights.
The Phase slider moves them.
RepeatHow many times the pattern repeats across the light.
The range is 0 to 8. At 0 the pattern tiles endlessly.
OutsideWhat 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).
ScaleThe size of the pattern.
The range is 0.1 to 8 on a logarithmic scale.
Pan XSlides the pattern across the light horizontally.
The range is -4 to 4.
Pan YSlides the pattern across the light vertically.
The range is -4 to 4.
RotationTurns the pattern.
The range is 0 to 360 degrees.
Gobo / SoftnessBlurs the pattern's edges.
The range is 0 to 1.
Gobo / StrengthHow deeply the pattern darkens the light.
The range is 0.05 to 1.
PhaseMoves 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 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.
KelvinColour 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.
CustomColour 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.
candle1900 K preset swatch.
tungsten2700 K preset swatch.
warm white3200 K preset swatch.
neutral4000 K preset swatch.
daylight5600 K preset swatch.
overcast6500 K preset swatch.
shade7500 K preset swatch.
TemperatureColour temperature slider from 1700 K (deep orange) to 12000 K (blue).
The track shows the colours it passes through as you change the temperature.
HexType a colour as a hex code such as #FF0000.
Only hex digits and the # symbol are accepted.
R G BRed, 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.
HueHue around the colour wheel, in degrees.
SaturationHow strong the colour is, from grey to full colour, in percent.
BrightnessHow 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 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.
ExposureBrightens 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.
GammaAdjusts 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.
LinearBrightness is shown as it is and everything brighter than white is clipped to white.
ReinhardRolls bright values off smoothly towards white.
ACESThe ACES filmic curve used in film production.
ACES is the default operator.
FilmicThe Hable filmic curve, with a soft toe in the shadows and a soft shoulder in the highlights.
RGBThe full-colour picture.
RGB is the default channel.
ROnly the red channel, shown in grey.
GOnly the green channel, shown in grey.
BOnly the blue channel, shown in grey.
AThe alpha (transparency) channel, shown in grey.
LumThe luminance (perceived brightness), shown in grey.
Look
Effects
The card sets the picture's finishing effects.
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 / StrengthHow strongly bright areas glow into their surroundings, 0 to 1.
At 0 bloom is off.
ThresholdHow bright a pixel must be before it glows, 0 to 4.
SizeHow far the glow spreads, 0.25 to 4.
Background glowsThe backdrop and environment glow as well as the model.
Ambient occlusion / StrengthHow strongly creases and corners where light struggles to reach are darkened, 0 to 2.
RadiusHow far the darkening reaches from a crease, 0.02 to 1.
Bounced lightLight 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 fieldBlurs what is in front of and behind the focus distance, like a camera lens.
FocusMoves 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.
RangeHow deep the sharp zone around the focus plane is, 0.05 to 2.
Depth of field / StrengthHow strongly the out-of-focus areas blur.
roundRound aperture shape.
3Triangle aperture shape.
4Square aperture shape.
5Pentagon aperture shape.
6Hexagon aperture shape.
7Heptagon aperture shape.
8Octagon aperture shape.
9Nonagon aperture shape.
RotationTurns the aperture polygon, 0 to 360 degrees.
SilhouettesDraws lines along the model's outline.
CreasesDraws lines along sharp edges inside the model, where faces meet at an angle.
Against backgroundDraws lines wherever anything meets the background, including the far edge of the floor.
ThicknessLine width in pixels, 1 to 12.
OpacityHow solid the lines are, 0.05 to 1.
AngleHow sharp an edge must be to count as a crease, 5 to 90 degrees.
solidSolid line style.
dashedDashed line style.
dottedDotted line style.
offHard pixel edges, useful for sprite captures.
jitterEdges, soft shadows, ambient occlusion and bokeh smooth out over a few frames while the view is still.
2xMultisampling at 2 samples makes edges smooth from the first frame, which helps while dragging.
This keeps the jitter smoothing as well.
4xMultisampling 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 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.
OnTurn the Cartoon look on and off.
The switch controls the entire effect. Slider settings are preserved while the Cartoon effect is off.
FlattenSimplifies surface colours towards flat areas.
This slider in the PAINT section ranges from 0 (off) to 1, collapsing surface variation into unified colour regions.
BandsSplits 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.
SoftnessSoftens the edge between light bands.
This slider in the CEL section ranges from 0 to 1, smoothing the transition at each band boundary.
RimControls the brightness of light along the model's edges.
This slider in the RIM section ranges from 0 (off) to 4.
Rim widthControls 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.
HalftoneBreaks 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 sizeControls the size of the halftone screen dots.
This slider ranges from 3 to 40 pixels and controls the scale of the screen pattern.
Screen angleRotates the halftone screen pattern.
This slider ranges from 0 to 90 degrees and turns the screen, following the conventions of printed screens.
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 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.
OnTurns accumulation on.
Lens blurReal depth of field from a camera lens, with true bokeh.
Point light shadowsThe point lights cast soft shadows whose width follows each light's Size.
Motion blurMoving objects in an animation blur along their motion.
ApertureHow wide the lens opens, 0% to 25%; a wider opening blurs more.
FocusThe focus distance as a multiple of the distance to the camera's target, 0.05× to 4×; 1.00× focuses on the target.
BladesThe shape of the out-of-focus highlights: circular at the low end, then a polygon of 3 to 11 blades.
RotationTurns the blade polygon, 0 to 360 degrees.
ShutterHow 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 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."
OnTurns the haze on and off.
Key lightThe key light shines through the haze.
Point lightsThe placed point lights shine through the haze.
EmissiveThe model's own glowing surfaces light the haze.
DensityHow thick the haze is, 0.005 to 2.
Thicker haze also dims the model behind it.
HeightHow 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.
GlowBrightens the light in the haze while leaving its thickness as it is, 0 to 8.
ScatterWhich 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.
draftFastest haze.
mediumMedium haze.
highFine haze.
ultraFinest haze.
Bloom the hazeBloom 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 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.
CloudSet the volume to look like a cloud.
FogSet the volume to look like fog.
SteamSet the volume to look like steam.
SmokeSet the volume to look like smoke.
SootSet the volume to look like soot.
FireSet the volume to look like fire.
DustSet the volume to look like dust.
DensityHow 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.
DropletsThe 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 lightHow strongly the sky lights the volume.
The sky light slider ranges from 0 to 4, with a default of 1.
Fire glowHow 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 glowLight 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.
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 occlusionThe darkening in creases and corners is ray traced, following the true shape.
Key shadowThe key light's shadow is ray traced, sharp where objects touch.
The shadow is softer further away.
Specular occlusionReflections are darkened where surroundings are hidden from a surface.
This happens inside crevices.
TransmissionLight passing through glass and other see-through materials is ray traced.
1K1024-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.
2KMaps grow up to 2048 pixels.
4KMaps grow up to 4096 pixels.
fileMaps grow up to the full size stored in the file.
autoThe 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.
256The smallest size every map keeps, in pixels.
512The smallest size every map keeps, in pixels.
1 GBHow much graphics memory texture maps may use.
2 GBHow much graphics memory texture maps may use.
4 GBHow 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 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 skeletonFits a skeleton to the model; once there is one, reads "Fit again".
StopStops the fit.
Fit manuallyPuts 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 jointsFits the skeleton to the joints as you placed them.
Clear allPuts 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 weightsStarts 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.
PaintingWeight painting is on; the cross on the Weight paint chip leaves it.
Weight paintShows that weight painting is on; its cross offers Keep weights, Keep as draft and Discard strokes.
BoneShows 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.
DrawPaints toward the brush's weight.
AddAdds weight.
SubtractTakes weight away.
SmoothEvens the weights out with their neighbours.
FillSets the brush's weight on the whole connected part of the figure under the click.
The fill is one stroke.
Over the surfaceSpreads the brush along the figure's surface, so painting an arm leaves the body alone.
Lock this boneKeeps the picked bone's weights as they are while other bones are painted.
SizeThe brush's size on screen, 4 to 200 px, default 40.
StrengthHow much a stroke changes, 0.05 to 1, default 0.5.
SmoothingHow strongly Smooth evens the weights out, default 0.5.
WeightThe 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.
UndoTakes the last stroke back.
RedoBrings the stroke back.
Rig the shapeFits a skeleton that follows the model's shape, for a model that is not a standing figure; bones carry plain names.
Adjust jointsShows 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 skeletonShows 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.
DoneKeeps the joints as they now stand and leaves fitting.
Discard changesPuts the skeleton and its weights back to how they were when fitting began.
Remove skeletonTakes 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 rigSaves 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 rigPuts 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 characterAdds the rigged model to the character library so animation clips can play on it.
Export modelSaves the model with its skeleton, skin weights and clips to a .glb or .fbx file you choose.
Move this joint onlyDragging a joint moves that joint alone; when off, the joints below it move with it.
XShows the held joint's position along its X axis.
Drag to move it a millimetre per pixel, or type a value.
YShows the held joint's position along its Y axis.
Drag to move it a millimetre per pixel, or type a value.
ZShows the held joint's position along its Z axis.
Drag to move it a millimetre per pixel, or type a value.
CenterMoves the held joint to the middle of its limb.
RefitPuts the held joint back where a fresh fit would place it.
MirrorMoves the held joint's partner on the other side of the body to its mirror image.
Add boneAdds a bone under the held joint, for a tail, an ear or a strap.
Remove boneTakes the held bone out; its children hang from its parent and its skin goes to the parent.
ReachHow far the held bone's influence reaches into the skin, 0.1 to 4, default 1.
FalloffHow gradually the influence fades beyond the reach, 0.05 to 4, default 1.
Rigid piecesSeparate 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 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.
MoveDrag 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.
TurnDrag 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.
SizeDrag 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.
ChainSet how many bones follow a move, from 2 to 5 (default 3).
StandSets 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.
SitSets 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.
WalkSets 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.
TSets the figure with the arms straight out to the sides and the legs straight.
The arms are level with the shoulders.
ASets 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.
UndoTakes back the last change in the view, like the toolbar's Undo.
Clear poseReturns the figure to the pose it had when the card opened.
ParentPicks the joint above the picked one, towards the pelvis.
Dead when the picked joint has none above it.
ChildPicks 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.
JointsShows 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.
XShows the picked joint's angle around its own X axis.
Number boxes display degrees; type a value or drag across the box.
YShows the picked joint's angle around its own Y axis.
Number boxes display degrees; type a value or drag across the box.
ZShows the picked joint's angle around its own Z axis.
Number boxes display degrees; type a value or drag across the box.
Key poseKeeps the pose as animation keys at the current frame, leaving the frame and the pose as they are.
Reset jointPuts the picked joint back to how it stood when the Pose card opened, including that frame's pose on a playing clip.
MirrorCopies the picked joint's pose onto its partner on the other side of the body.
Pin jointKeeps 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.
CurlBends 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.
SpreadFans 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.
FistCloses the hand into a fist.
OpenStraightens the fingers and spreads them a little.
PointCurls every finger but the index, which stays straight, and folds the thumb most of the way.
FalloffSets 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 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 fileA clip file of your own is added to the library.
Repair motionMends 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 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.
clayNeutral clay with darker joints, the default for judging motion.
boneBone white with dark joints.
slateDark slate with light joints.
authoredThe mannequin's own colours from its file.
bodyThe colour picker edits the body's colour.
jointsThe 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 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 modelA rigged model of your own becomes a character.
Open folderThe 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 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 placeThe model stays on the spot during the clip.
A jump still rises and falls through its motion.
Show rigThe 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 card shapes the animation keys you have picked. Each key type is drawn in its own colour on the timeline.
KeyA main pose.
BreakdownThe pose between poses; it keeps its share of the time when the keys around it move.
HoldA pose held still.
ExtremeThe furthest point a motion reaches.
StepThe value holds until the next key, as for a stop-motion pose or a switch.
Curve / LinearThe default: the value moves in a straight line to the next key.
BezierA smooth curve shaped by the keys' handles.
BounceSettles onto the next key in a run of shrinking hops.
ElasticOvershoots and springs about the next key before settling.
AutoThe default: smooth through the neighbouring keys and level at a peak or a dip.
PlateauLike 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.
ClampedLike Auto, and level wherever two neighbouring keys hold nearly the same value, so a held value stays held.
FlatLevel handles on both sides.
Tangents / LinearHandles aimed straight at the neighbouring keys.
FreeThe handles stay exactly where you place them.
InThe motion eases into the key.
OutThe motion eases out of the key.
BothThe default: the motion eases at both ends.
SineGentlest ease preset; sets the keys' handles to that curve at the end chosen under EASE.
QuadEase preset; sets the keys' handles to that curve at the end chosen under EASE.
CubicEase preset; sets the keys' handles to that curve at the end chosen under EASE.
QuartEase preset; sets the keys' handles to that curve at the end chosen under EASE.
QuintEase preset; sets the keys' handles to that curve at the end chosen under EASE.
ExpoStrongest ease preset; sets the keys' handles to that curve at the end chosen under EASE.
BackOvershoots 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 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.
AllAdd key writes every channel: position, rotation and scale.
MoveAdd key writes position alone.
TurnAdd key writes rotation alone.
ScaleAdd key writes scale alone.
BetweenWrite 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 keysRemove 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 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.
24Set the frame rate to 24 frames per second.
25Set the frame rate to 25 frames per second.
30Set the frame rate to 30 frames per second.
48Set the frame rate to 48 frames per second.
50Set the frame rate to 50 frames per second.
60Set the frame rate to 60 frames per second.
FramesTimes are shown as frame numbers.
TimecodeTimes are shown as timecode, in minutes, seconds and frames.
File's rangeSet 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 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 sceneSaves the whole scene, with every object, its position and the look, as a scene file.
Load sceneOpens a saved scene file.
Lighting cardOpens the Lighting card, where the studio rig is set.
Add a modelAdds another model file to the scene.
AttachMakes 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.
DuplicatePuts 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 centreMoves 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 bottomMoves 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.
PointShines in every direction from one spot.
SpotShines a cone of light in the direction it faces.
SunLights the whole scene from one direction; only which way it faces matters, not where it stands.
AreaA 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.
BrightnessSets how bright the light is; 1.00x lights the middle of the model about as much as the main key light does.
ConeSets how wide the spot's cone is, as its half angle in degrees.
SizeSets the light's size compared with the model; a bigger light gives softer shadows, and an Area light's rectangle grows with it.
ShadowSets whether the light casts shadows.
RemoveTakes 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 removingAsks "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 objectThe name that Rename gives the picked row, or that Group gives a new group.
GroupMakes a group of the picked objects; moving the group moves them all.
RenameGives the picked row the name in the box.
Override globalThe picked object's own texture limits below replace the Traced effects card's for this object.
1KThe picked object's maps grow up to 1024 pixels.
2KThe picked object's maps grow up to 2048 pixels.
4KThe picked object's maps grow up to 4096 pixels.
fileThe picked object's maps grow to the full size in its file.
autoThe viewer chooses the smallest size the picked object's maps keep.
256The picked object's maps keep a minimum size of 256 pixels.
512The picked object's maps keep a minimum size of 512 pixels.
Open the folderOpens the folder the scene was saved in.
Scene
Snapping
Snap placed objects to steps, the grid, other objects and the floor.
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.
SnappingTurns snapping on or off. Hold Ctrl while pressing a handle or dragging to reverse it.
StepMoves, 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.
GridThe object's origin lands on the lines of the floor grid.
SurfaceThe 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.
CornerThe 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.
EdgeThe 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.
BoxCorners, 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.
PivotThe object's origin meets another object's origin when they come close.
FloorThe bottom of the object lands on the floor when it comes close to it.
Move stepThe 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 stepThe size of a turn step in degrees. Click for the next value, or use the mouse wheel.
Size stepThe size of a resize step. Click for the next value, or use the mouse wheel.
ResetPuts 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 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.
XShows 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.
YShows 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.
ZShows 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.
LevelTake the tilt out of the picked object and keep the way it faces.
ZeroReturn the held tool's three numbers to their defaults.
UniformScale all three axes as one, so the object keeps its proportions.
Scene
Timeline
Manage animation keys and playback across time.
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 frameShows the frame the clock is on.
Type a frame to go there or drag across the box.
StartSets the first frame of the scene's range.
EndSets the last frame of the scene's range.
RowsShows 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.
GraphShows the keys as curves of value over time.
AllNew keys hold every channel.
MoveNew keys hold position only.
TurnNew keys hold rotation only.
ScaleNew keys hold scale only.
Clip to keysTurns the playing animation clip into keys that can be edited.
This button is active when a clip plays.
CamerasOpens the Cameras card, where cameras are added, keyed and looked through.
All actorsEvery character plays its animation together.
This button is shown when the scene holds more than one character.
FrameSets 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.
ValueSets 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 valueShows 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 valueShows 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.
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 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.
EverythingEvery 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.
PositionsEvery 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.
SceneThe 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 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.
TooltipsShows 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.
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.
shadedThe finished model with its materials, textures and lighting.
wire on shadedThe mesh's edges drawn over the shaded, textured model.
wire on flatThe edges drawn over a plain untextured grey surface.
hidden lineThe edges alone, with the surfaces hiding the edges behind them.
see-throughEvery edge, including those the model's own form hides, which are drawn dimmer and thinner so they read as further away.
albedoThe base colour of every surface, unlit.
normalsThe direction each surface faces, shown as colour.
roughnessThe material's roughness shown in grey: white is rough, black is glossy.
metalnessThe material's metalness shown in grey: white is metal.
UV checkerA checker pattern laid on through the model's texture coordinates, which shows stretching and seams in the texture mapping.
backfacesFaces seen from their back side are shown in a colour of their own, which reveals faces pointing the wrong way.
overhangFaces 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 wallsPoints 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 widthAdjust 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 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.
mmThe file's numbers are read as millimetres.
cmThe file's numbers are read as centimetres.
inThe file's numbers are read as inches.
mThe 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 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 pxSizes 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 backgroundThe 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 shadowThe shadow the model casts on the floor stays in the picture.
This is active when Transparent background is on.
Trace saved imagesSaved and copied pictures are rendered with the ray-traced effects.
When off, they follow the Rendering card's switches.
Whole frameSets the region to the whole view.
ClearRemoves the region so the capture takes the whole view.
CopyCopies the picture to the clipboard.
Save PNGSaves 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 folderOpens 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.
ModelsChooses 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.
ScriptChooses 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.
StillChooses 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.
SendSends 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.
LeaveKeeps 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 GulltoppHands 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.
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.
TurboSquidThe five product angles TurboSquid asks for, a wireframe pass and a 36 frame turntable as numbered images.
CGTraderPreview pictures and a turntable for a CGTrader listing.
FabPreview pictures and a turntable for a Fab listing.
ArtStationPreview pictures and a turntable for an ArtStation listing.
Microsoft StorePoster art at 2:3 and a 1920 by 1080 trailer for a Microsoft Store listing.
BehancePictures of a portfolio post for Behance.
CaraPictures of a portfolio post for Cara.
Instagram feedThe picture or clip in the shape that Instagram feed shows.
BlueskyThe picture or clip in the shape that Bluesky shows.
MastodonThe picture or clip in the shape that Mastodon shows.
XThe picture or clip in the shape that X shows.
LinkedInThe picture or clip in the shape that LinkedIn shows.
RedditThe picture or clip in the shape that Reddit shows.
DiscordThe picture or clip in the shape that Discord shows.
YouTubeThe picture or clip in the shape that YouTube shows.
Instagram ReelsA tall turning clip for Instagram Reels.
YouTube ShortsA tall turning clip for YouTube Shorts.
TikTokA tall turning clip for TikTok.
Web stillA still image for web use.
Blog headerA still image for a blog header.
Social squareA square still image for social media.
Social portraitA portrait still image for social media.
Story or shortA tall still image for stories or short posts.
Pin or posterA still image for pins or posters.
Turnaround sheetThe model from the front, right, back and left for a character or product sheet.
Product setA hero view, a detail view and a wide view of a product.
FiverrGallery 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.
MovieTurntables written as a video file.
StillsTurntables written as numbered images.
BothTurntables written both ways from one run.
FramesHow many frames one turn has; the same controls as the Presentation card for this template's turns.
LengthThe same turn given in seconds.
RateFrames per second a turn plays at.
FrameThe room around the model in every shot; more Frame makes the model smaller in the picture.
ProduceRenders 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 folderAsks 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 runsStops 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."
ResetReturns the template to how it was last saved.
Re-deriveReturns an edited copy to the built-in template it came from.
CaptionThe caption for the post, filled in from the scene and editable here.
Credit Heimdall3DAdds a line crediting Heimdall3D to the caption.
Name this templateThe name the edited template is saved under.
SaveSaves the edited template under the name in the box.
DeleteDeletes a template you saved.
Pick a templateAsks 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 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.
TurntableStarts and stops the rotation.
This switch shares its state with the turntable button on the toolbar.
SpeedHow 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.
ElevationThe 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 wayReverses the direction of rotation.
The turntable rotates in one direction by default. Turn this on to rotate in the opposite direction.
Keep the lighting stillThe 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.
FramesHow 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.
LengthThe 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 sequenceRecords one PNG per frame, saved beside the model.
Record APNGRecords one lossless file that keeps transparency.
Record GIFRecords one file with 256 colours and one-bit transparency.
Record MP4Records one compressed video file.
Make
Record
Records the animation to a file with your choice of format, size, frame rate and sample count.
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.
StartThe first frame recorded.
The frame number where the recording begins. The range is the same as the Timeline's Start control.
EndThe last frame recorded.
PNGRecord to one PNG file per frame in a numbered sequence.
APNGRecord to one animated PNG file, lossless, keeping transparency.
GIFRecord to one animated GIF file with 256 colours and one-bit transparency.
MP4Record to one compressed MP4 video file.
RateFrames per second the recording plays at.
Choose between 1 and 120; the default is 30. Higher frame rates produce smoother playback and larger files.
PaneRecord at the pane's own size.
512²Record at 512 by 512 pixels.
720pRecord at 1280 by 720 pixels.
1080pRecord at 1920 by 1080 pixels.
8Render each frame with 8 samples.
32Render each frame with 32 samples.
The default. More samples take longer to render and produce a smoother image.
64Render each frame with 64 samples.
Record the animationRecord 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 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 mmPrint the model's size in millimetres on the thumbnail.
This helps sort 3D prints at a glance.
ClearThumbnails have a transparent background.
EnvThumbnails show the environment behind the model.
FlatThumbnails have a flat colour behind the model.
Refresh the folders I am looking atThe 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.
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 setupThe name a new setup is saved under, or the new name for Rename.
SaveSaves the current look as a setup with the name in the box.
LoadPuts the picked setup's look on the scene.
RenameGives the picked setup the name in the box.
DeleteDeletes the picked setup.
Recall
Bookmarks
The card keeps camera views for the file that is open.
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.
emptyThe 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.
SaveSaves 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 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 findTyping 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
Will it fit the machine
The card shows the model on each 3D printer's build volume.
The BUILD VOLUME card lists 3D printers as cells. Press one to draw that printer's build volume around the model on the floor and see whether the model fits. The chosen printer is remembered for every file. A line shows "No machine chosen" until a printer is selected. For a printer with a round bed, a line on the card says the bed is circular. To add your own printers, create a file named printers.ini in the Heimdall3D folder of your application data.
FitScales the model to the largest size that fits the chosen printer.
The scale is the same on all three axes, and a round bed fits the footprint to the circle. The size figures, the measurement plates and the drawn build volume show the fitted size, and the fit line reads, for example, "Fits · at 14.3%". The scale moves in steps of a tenth of a percent, the model file is not changed, and the scale lasts until another file is opened.
Actual sizeReturns the model to its own size from the file.
The button is shown whenever the model is scaled, by Fit or by a size typed on the X, Y or Z rows. It is shown also when no printer is chosen.
Print XSets the model's printed width in millimetres.
Drag the slider or click the value and type a number. The model scales uniformly so this axis prints at that size, and Print Y and Print Z follow. The track runs from 1 mm to 2 m on a curved scale, and typed entry accepts 0.1 mm to 100 m. The sliders show once the model's unit is known, whether the file states it, it is assumed from the model's size, or it is chosen on the Measure card.
Print YSets the model's printed depth in millimetres.
Drag the slider or click the value and type a number. The model scales uniformly so this axis prints at that size, and Print X and Print Z follow. The scale is the one the Fit button sets. It lasts until another file is opened, and the model file itself is unchanged.
Print ZSets the model's printed height in millimetres.
Drag the slider or click the value and type a number. The model scales uniformly so this axis prints at that size, and Print X and Print Y follow. The track runs from 1 mm to 2 m, and typed entry accepts 0.1 mm to 100 m.
Print
Where supports will be needed
The card colours faces that overhang too steeply to print unsupported.
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 overhangsShows 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 verticalSets 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 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.
4Renders the sheet from four directions.
8Renders the sheet from eight directions.
16Renders the sheet from sixteen directions.
Lock anglesWhen on, the 2D view turns only to the sheet's directions.
The cells stay exactly as set whatever the view does.
Scene light and effectsWhen on, the cells are lit as the view is, with its effects.
Turning it off gives plain sprites.
TiltSets the camera's tilt for every cell, from 0 to 90 degrees.
SideSide on view.
2:12:1 pixel art isometric view.
IsoTrue isometric view.
TopStraight down view.
FramesSets how many frames of the clip each direction has.
The range is 2 to 24, with a default of 8.
Animate keysWhen on, the frames follow the animation keys.
CellSets 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."
PaddingSets 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 bottomAdds 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 backgroundWhen on, the cells have a transparent background and no floor.
The cells sit on the game's own ground.
Start at the model's frontWhen on, the first row faces the model's front exactly.
Cells in the paneThe view shows the cells as they will be written.
2D
Pixel look
Renders the model as pixel art with a limited colour palette.
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 lookTurns the pixel art look on.
HeightSets the picture's height in art pixels, from 16 to 256.
ModelA palette taken from the model's own colours, with as many colours as the Colours slider sets.
PICO-8The 16-colour PICO-8 palette by Lexaloffle.
Endesga 32The 32-colour Endesga 32 palette by ENDESGA.
ColoursSets how many colours the Model palette holds, from 2 to 64.
DitherBlends between palette colours with a regular pattern of pixels for smoother gradients.
OutlineA 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.
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.
NormalWrites the surface direction of each pixel for 2D lighting.
The normal is recorded in the camera's frame.
DepthWrites how far each pixel is from the camera.
OcclusionWrites the ambient occlusion that shading uses.
This is the darkening in creases.
IDWrites 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 writes the sprite sheet, any chosen maps, and data files that game engines and tools use to cut the sheet into individual frames.
GodotWrites the data file Godot reads alongside the sheet.
TexturePackerWrites the data file TexturePacker reads alongside the sheet.
AsepriteWrites the data file Aseprite reads alongside the sheet.
GameMakerWrites the data file GameMaker reads alongside the sheet.
Export sheetWrites 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 folderOpens 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 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.
ExposureBrightens or darkens the picture in photographic stops.
Range -5 to +5, default 0.
GammaSets the display's transfer curve.
Default 2.2; 1.0 for a display that applies its own.
LinearOperator: brightness as it is, clipped at white.
ReinhardOperator: rolls bright values off smoothly towards white.
ACESOperator: the ACES filmic curve used in film production.
The default operator.
FilmicOperator: the Hable filmic curve with a soft toe and shoulder.
ReadoutShows 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.
TooltipsShows 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.
A source section appears above these controls when the file offers more than one choice of what feeds the colour.
RGBShows the full-colour picture.
This is the default.
RShows the red channel alone in grey.
GShows the green channel alone in grey.
BShows the blue channel alone in grey.
AShows the alpha transparency channel in grey.
LumShows the luminance, the perceived brightness, in grey.
Image viewer
Alpha
Shows how the picture stores its transparency.
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 onlyShows the alpha channel alone.
Read as premultipliedReads the colour as already multiplied by alpha.
Mark fringesMarks the edge pixels that will show as a fringe.
CheckerShows a checkerboard through the clear parts.
BlackShows black through the clear parts.
WhiteShows white through the clear parts.
GreyShows grey through the clear parts.
Image viewer
Pixels
Set how enlarged pictures are drawn and at what factor they are saved.
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.
NearestEach pixel grows into a sharp square block.
Scale2xAn enlarger made for pixel art that smooths diagonal edges while keeping the pixel look.
xBRAn enlarger made for pixel art that rounds curves and slopes more smoothly still.
1xThe picture is saved at its original size.
2xThe picture is saved at twice the original size.
3xThe picture is saved at three times the original size.
4xThe picture is saved at four times the original size.
Image viewer
Region
Selects the region that a save writes.
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 imageSelects the whole picture.
ClearRemoves 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 card contains the playback transport, the file's animation names, and a grid to divide sprite sheets when the file carries no frame description.
BackSteps one frame back.
PausePauses or resumes playback.
NextSteps one frame forward.
LoopPlays the frames round and round.
Onion skinShows the frames either side faintly over the current one.
SpeedSets the playback speed from 0.25x to 4x.
ColumnsSets how many columns the sheet is cut into, from 1 to 64.
RowsSets 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.
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.
0The full-size picture.
Numbered levels from 1 are each half the previous size; the list shows as many as the picture has.
Linear lightThe levels are averaged in linear light, as light adds up physically.
sRGBThe 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 card puts the picture into the environment gallery. A line shows whether it is already in the gallery.
Use this HDRICopies the picture into the environment gallery.
Show folderOpens the gallery folder.
Image viewer
Brightest region
Finds the brightest region of an HDR picture and reads out its direction, brightness and size.
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 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 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 colourPaints 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 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.
BrowseShows the picture and the everyday tools.
LightShows 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 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.
PrintMeasure 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.
RiggingFit a skeleton to the model and pose it.
AnimationMake animation keys on the timeline.
2DExport the model as sprite sheets with their maps.
The model becomes sprites: sheets, their textures and their export settings.
Gaussian SplatWalk 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 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 controlsGo to the next page of the list.
This row sits at the foot of the first page.
Back to the first pageReturn 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.
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.
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 fileClears 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 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 drawsA 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 agentA 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 goSaved 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 folderOpens 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 withOffers 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 lineSwitches 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 keyPaste 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 licenceTakes 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 licenceOpens 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 keptThe 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 pipeA 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.
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.
InstallingDownload 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 inPress 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 iconThe 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 rowShows 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.
StorageThe 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.
FilesYour 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 filesCtrl, 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.
LinkGives the file its own address on the site, or takes it away.
A link mark shows on the file while it has an address.
CopyCopies the file's address.
RightsSets 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.
sha256Copies 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 memberSends 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.
RenameChanges 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 siteOpens the file's page in the browser.
The page sets the file's background, camera and floor.
RemovePress twice within three seconds to remove the file.
The file is removed from the site. A file another member also stored stays for them.
Client linksOpens the links that open your whole portfolio.
The Client links symbol in the Files tab's row opens the links that each open the whole portfolio, unlisted, for whoever holds them. Type who a link is for and press the plus symbol, or Enter. The new link's address is shown once, with a copy symbol, so copy it then.
Each link lists its name, how many times it was opened and when last. The bin symbol, pressed twice within three seconds, withdraws a link. A withdrawn link opens nothing.
CollectionsNamed 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 collectionMakes a private collection.
The plus makes a private collection. Type its name and press Enter or the tick.
VisibilitySteps 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.
ThemesGives 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 collectionChanges 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 collectionPress 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'sPublic 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 collectionPuts 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 windowOpens 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 collectionMoves, 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.
LibraryYour 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.
AuthorsA 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.
KitsConverting 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 portfolioWhat 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.
MessagesConversations 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.
SmileysOpens 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.
ForumForum 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.
LookSets 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 WindowsStarts Gulltopp when Windows starts.
On a Mac, this switch is named Open at login.
Tell meChooses 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 forChooses 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 outSigns this program out of your account.
Signed in as shows the account in use.
VersionShows 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 Heimdall3DShows 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 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 itYour 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 workDrop 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 drawerThe 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.
RightsView 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.
ManageYour 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 sharingThe 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 youYour 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.
PlacesYour 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 factsWhat 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 workNewest first, or in the order you arranged by dragging each piece.
Newest first is the default. The hero is featured first in either order.
ThemeLight (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.
FoundersA 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.
OrganisationsA 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 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 animationSaves 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 animationPuts 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 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 downRests 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 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.
CutCuts 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 heightSets 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.
LayerChooses 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
Is the surface closed
Shows whether the model's surface is closed, as a slicer needs.
A slicer prints a model as a solid when its surface is watertight. The card shows "Closed" or "Not closed", followed by two counts. The measurement is made while the file loads. Vertices at the same position count as one, so edges split for textures still count as joined.
Open edgesCounts edges used by only one face.
These are the rims of holes in the surface. A closed model shows 0.
Shared by three or more facesCounts edges where more than two faces meet.
Slicers treat these edges as broken geometry. A closed model shows 0.
Portfolio
How much it will weigh
Shows the model's volume and weight at the size it will print.
The card shows the volume in cubic centimetres at the size the model prints. It follows the unit and the print scale from the Build volume card. The weight in grams is shown for the chosen material and infill. It is the volume times the material's density times the infill, and it covers the model itself. The walls and supports a slicer adds are not part of it.
PLAWeighs the model in PLA at 1.24 g/cm³.
Sets the material density to 1.24 g/cm³.
PETGWeighs the model in PETG at 1.27 g/cm³.
Sets the material density to 1.27 g/cm³.
ResinWeighs the model in resin at 1.12 g/cm³.
Sets the material density to 1.12 g/cm³.
InfillSets how much of the volume is filled, from 0% to 100%.
The default is 100%, a solid model. The weight scales with this value, and Reset restores the default. Reset also puts the material back to PLA.
Portfolio
Scripts
Opens the Scripts card, where scripts that build or change a scene are run and edited.
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.
NewStarts an empty script in the notebook.
New opens the notebook with an empty script. The script is given a name when it is saved.
OpenPicks 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.
EditOpens 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 scriptWrites 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.
ScriptThe 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 libraryNames 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}
RunRuns 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.
UndoUndoes 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.
RedoPuts 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.
CopyCopies the selected text, or the whole script when nothing is selected.
PastePastes text into the script at the cursor.
Send to GulltoppSends 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.
SaveWrites 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 asWrites 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.
DockedPuts 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.
FloatingMakes 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.
CloseCloses 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 commandsLets 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 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 wallsShows 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 wallSets 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.