Beta: The 3D view is a beta feature. It is fully usable but may still change. Feedback is welcome at support@justselling.de.
The 3D view connects a 3D model with your configurator. How well that works is largely decided in the model itself. This article is for you or your 3D artist and describes how a model has to be built.
Format
- GLB (binary glTF 2.0) in one file, with all textures inside. Blender, SketchUp, 3ds Max, Rhino and many CAD programs export GLB directly.
- Convert other formats such as OBJ, FBX or STEP to GLB first.
- At most 25 MB. Above 10 MB the model loads noticeably slowly on phones.
- Up to about 300,000 triangles the view runs smoothly on phones too.
- Textures at most 2048 pixels on each side.
Scale and orientation
- 1 unit = 1 metre.
- Y points up.
- The front of the product points towards +Z, that is towards the viewer.
- The origin is on the ground, below the product.
Naming parts
Everything that changes with the configuration is a separate part with its own name: every door variant, the green roof, the side door, every window. Only named parts can be bound in the admin. The check on upload lists parts without a name.
Good names are short and unique, e.g. Door_Roller, Door_UpAndOver, Wall_left, Green_roof.
Naming materials
A material that gets recoloured has its own name, e.g. Wall, Door, Fascia. Parts that always change colour together share a material. If a part should be coloured independently, it needs its own material.
Parts that grow
If a part grows with a dimension, such as a side wall with the length of the garage, it is scaled. Scaling always happens around the part's pivot. So put the pivot where the part should stay in place:
- A side wall with its pivot at the front edge grows backwards.
- A roof with its pivot at the bottom edge does not grow into the wall.
Model the product at a reference size, e.g. a garage 2.50 m high. In the 3D view you then scale with a formula such as H / 2.5.
Unit-size parts
Parts that come in several sizes, such as doors (87.5 × 187.5 cm or 100 × 200 cm) or windows, are best modelled at 1 × 1 m and scaled to the chosen size. With a scale of -1 on one axis, the same part can be mirrored and placed on the other wall.
Parts that must keep their shape, such as handles or frames, are moved, not scaled.
Print areas for the product designer
If custom text or a logo from the product designer should appear on the model, the model needs a print area:
- a separate part with its own material, e.g.
Label, lying 0.2 to 0.5 mm above the surface, - with UV coordinates that map the design zone 1:1: on a cylinder, U runs once around the product (U = 0.5 is the front) and V goes from bottom to top across the print area.
The flat design zone in the product designer is then exactly the unrolled print area in millimetres, for a glass with an 80 mm diameter about 251 mm wide. In the admin's list of materials, materials with UV coordinates are marked UV.
Glass and transparent parts
- Glass is a closed body with outer wall, rim, inner wall and base.
- In the admin, choose the surface Glass and the scene Glass studio. A bright studio otherwise shows as a milky veil across the whole glass.
Without UV coordinates
If your model has no UV coordinates, surfaces such as Plaster or Wood still get a texture: the 3D view applies it at real size, even when a wall is stretched. A model with its own UV coordinates takes precedence.
Checklist
| Item | Done when … |
|---|---|
| Format | one .glb file, at most 25 MB |
| Scale | 1 unit = 1 metre, Y up, front +Z |
| Parts | everything that changes is a separate, named part |
| Materials | materials to be recoloured have their own names |
| Pivots | growing parts have their pivot where they stay in place |
| Print area | separate part with material and UV coordinates |