> For the complete documentation index, see [llms.txt](https://docs.vioso.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vioso.com/guide/custom-3d-model-preparation-for-calibrations.md).
# Custom 3D Model preparation for calibrations
Example: Tower projection model prepared in Blender
VIOSO software provides built-in generation for several standard surface geometries: flat screen, cylinder, dome, panodome, cone, and disc.
For projection surfaces that do not match these predefined shapes, a custom 3D model can be used instead. The supported formats are:
* .Obj
* .Dae
* .Fbx
Use the checklist below to verify that your 3D model is ready for use in VIOSO.
### Checklist: 3D-model for VIOSO calibration
#### 1. Mesh
☐ Contains the projection surface only: no frames, no extra building/environment elements, no structure or extra geometry that is not receiving projection content.\
☐ Single-sided faces only\
☐ Correct face normals: facing the direction of the viewer\
☐ No loose geometry, duplicate vertices or faces
#### 2. Tessellation
☐ Sufficient subdivision for surface accuracy\
☐ Smooth curved surfaces without visible faceting\
☐ Consistent polygon distribution
#### 3. UV Mapping
**☐ Model should have a valid UV layout.** It must reflects the final content mapping: coverage, orientation, texture continuity, uniformity..etc\
\&#xNAN;**☐ UV texture test pattern** available as 8 or 24-bit PNG.\
Tip: you can generate free HQ grid patterns in our [testpatterngenerator.com](https://testpatterngenerator.com/)
#### 4. Coordinate System
**☐ Correct real-world scale**. VIOSO uses millimeters, take this into account when exporting/importing.\
\&#xNAN;**☐ Meaningful model origin defined:** Place the model origin at a logical reference point. Common choices include:
* Center of the projection surface
* Center of the room
* Floor center
* Camera or viewer reference position
A well-defined origin simplifies the calibration step of virtual camera alignment and allows you to estimate precisely the pose.\
\
\&#xNAN;**☐ Correct axis orientation after export**. VIOSO uses **X-right, Y-up, z-Backward**.
### Testing the model in VIOSO7
You can test the model in VIOSO7 free mode, without having to go through the calibration process.
* Go to main menu > **Calibration** > **Content Spaces**.
* Select "**New**" : name i.e "custom 3d model", type: "**3D model**" then **Create Empty Definition**.
* A new entry will be added to the list, there you can find the "**browse**.." button for the model file path.
Now you can play that 3D model simply on a target monitor display:
* From the main UI, select a monitor from the "target" dropdown -> **Activate**
* Go to **Player :** + > add model item > add MRD
* Doube click the model item in the list to play it.
* Click on "Properties" to open the 3D model scene preview. There you can check if the mesh is displayed correctly, you can preview as wireframe or texture, switch between different patterns..etc
### Using the model in VIOSO7
After testing your model, you can it use in your calibration workflow:
1. [Project mode: use the designer node editor to import your file in the "surface" element.](https://docs.vioso.com/start/project-mode/designer#projection-surface)
2. [Free mode: use the MRD workflow and conversion tasks to apply it to your scans.](https://docs.vioso.com/workflows/mrd-freemode)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.vioso.com/guide/custom-3d-model-preparation-for-calibrations.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.