Skip to main content

Asset Creation Instructions​

Resources​

Download Blender 3D: https://www.blender.org/download/

Download the Blender to Babylon exporter: https://doc.babylonjs.com/resources/blender

Scene Setup​

3D Visualizr has a scale of 1 unit = 1 meter.

In Change scene units into metric and keep unit scale as 1

On default the Babylon exporter applies PBR materials to the export, which has to be ticked off in the World settings as PBR Materials aren't currently supported in 3D Visualizr

Items.png

Modeling Setup​

Keep the pivot of your 3D objects in center and bottom of the object for easy placement in the 3D Visualizr

Any 3D model you want to export should also has its location to be in the origo of the scene, meaning 0,0,0.

Only the first UV channel is used

Materials & Textures​

By default the 3D visualizr scenes have no real time lighting to save in rendering time. All models are displayed fully lit and expect the models to have textures with prebaked lighting.

This setting is possible to be changed to a setting in which the 3D Visualizr scene has a real time light source that can be used to light the models.

Export​

Collections in Blender can be used to control what in the scene gets exported. If a collection is disabled none of the objects inside it will be included in the export

  • If an object doesn't belong to any collection it will always get exported

  • If a collection is enabled, everything inside it will be exported, except for contents in nested collections that are turned off.

Export Folder​

As the exporter creates several files, it is adviseable to create a separate folder for the export to keep files in order. The created files are:

  • FILENAME.babylon - Contains all the 3D data

  • FILENAME.babylon.manifest - Contains files version number and some other useful metadata

  • FILENAME.log - log file of the export. Only needed for checking export

  • Texture files used by the 3D model

Upload and Validation​

Deployment​

Deploying to 3D Portal​

Models are uploaded by dragging a zip file of the export to the page. The zip must be created by the user and must contain:

  • .babylon

  • .babylon.manifest

  • All the textures required by the 3D model, located in the export folder

  • Once the zip is uploaded it is processed by the site and checked for several things.

Are there any problems in the file, for example multiple UV channels

Are all the referenced textures included

Possible problems are listed on the right side of the page with red errors preventing proceeding until they are fixed and the file reuploaded, but yellow warnings are only heads ups and left on users dicretion to decide whether fixing and reuploading is required.

Settings in the upload page:​

Model Thumbnail - The thumbnail that's visible in the asset library. Clicking the thumbnail allows you to take a better image for the thumbnail

Name - Name of the file in the repository. Can't be changed later so pick a good name

Friendly Name - Name of the file visible for the end user. Can be changed later

Variant - Used for having variations of the same model such as "Animated" or "Logo"

Version - Version number of the file. Can be adjusted to be latest if needed

Model File Path - Path to the model filen insided the uploaded zip

Is Asset - The file is an asset if it's a single machine that can be added to the scene through

AssetLibrary and it's not if it's a scene model such as factory floor.

Upload - Uploads the file to the registry once it has passed the tests

Validate - Recheck the file

Non-Uniform Transform​

3D Portal doesn't allow uploading of models that contain meshes with non-uniform scale or rotation. Before exporting ensure that all of the objects/meshes in your scene have:

  • Rotation set to X=0.0, Y=0.0, Z=0.0

  • Scale set to X=1.0, Y=1.0, Z=1.0

You can apply/collapse the rotation and scale in Blender by following these instructions