Portal 3D Editor v0.1 beta - Quick Guide x

Supported file formats

Import

• Images: PNG, JPG/JPEG, WebP (+ Image, + Floor Img)
• Video: MP4, WebM (+ Video, + Floor Vid) - used as looping textures
• 3D models: .glb, .gltf (+ Model)

For models, materials must be named with the prefixes inside_specs, outside_specs, or floor_specs (L/R) to project onto the correct surface. Otherwise the model loads but won't map to a wall/floor.

Export

• MP4 (H.264), one file per surface: Inside.mp4, Floor.mp4, Outside.mp4
• Fixed resolution 3840x2160, default 25 fps, 10 s duration

There is no hard file-size limit, but keep videos roughly 50-200 MB for fast loading.

How to use

1. Pick a context - choose the Interior or Exterior tab (top-left).
2. Add content - use the + Image / + Video / + Model buttons, or drag and drop files onto the editor (auto-routed by type). + Cube / + Plane / Room add 3D primitives.
3. Position it - select a layer in the list, then adjust with the sliders: 2D layers: X, Y, Scale %, Rotate degree, Opacity.
4. 3D layers: Pos X/Y/Z, Scale %, Tilt, Rotation Y.
5. Check the illusion - in the right 3D pane, click Snap to Eye E (or Sweetspot Front/Back) to view from the correct projection point. Orbit = drag, zoom = scroll.
6. Tune the look (optional) - open Environment for lights, fog, backdrop, brightness.
7. Animate (optional) - use the timeline dock to set keyframes; set FPS (1-60) and duration.
8. Export - click Export MP4s, tick the surfaces you need (Inside / Floor / Outside), and the files download automatically.

✋ Place decals on surface

A toggle mode that lets you position your image/video layers by clicking directly on the wall or floor in the 3D preview - instead of entering X/Y values in the 2D pane.

How to use it:

1. Select the layer you want to position in the layer list.
2. Click ✋ Place decals on surface (the button highlights when active).
3. In the 3D view, click a wall or floor - the selected layer jumps to exactly where you clicked.
4. Click and drag a layer to slide it across the surface. It stays locked to that surface.
5. Click the button again to turn the mode off and return to normal orbit/zoom.

Good to know:

• Clicking a surface auto-switches to that surface's tab.
• Clicking empty space does nothing - you can still orbit and zoom freely.
• A layer can only be dragged within its own surface; it won't jump to a different wall.

Use this for quick, visual placement ("paint by pointing"); use the 2D pane sliders for precise numeric adjustments.

Using a video backdrop: Click Floor Upright to drop the video onto the matching surface for rough positioning, then fine-tune its placement with the transform sliders (or via Place decals on surface).

Tip: live preview renders at 50% resolution for speed; the export always renders full 3840x2160.