Before uploading any 3D files, you need to prepare them for CMS use.
Here is the list of technical requirements needed to run 3D objects smoothly in CMS:
-
3D Object files to be in .obj extension
-
Texture file in .jpg extension
-
Material for objects to be in .mtl extension
-
File size to be up to 20MB.
Please note that big-size 3D files have a better resolution in the app, yet the size noticeably influences 3D object uploading time both in the CMS and in the app. 3D files' ‘size vs uploading time' dependency is especially notable in the Mobile Guide apps.
-
Faces number should be about 250 000 if you want to use 3D objects on mobile devices or want to avoid issues with long application loading.
-
Apply logical smoothing groups to object.
-
The maximum size of one side of the object needs to be 1000 mm (other sides need to be smaller, containing the proper ratio).
-
Object orientation needs to be so that the "z" axis is up.
To prepare 3D files for uploading them to the CultureConnect CMS:
- Renaming the files.
It is important to ensure correct naming of files within the 3D model as follows:
-
- Texture file: [name].texture.jpg
- (note that in this case the file extension is the .jpg and the rest is the normal filename – the content in [name] can be random but should match across all 3D model files)
- Material file: [name].material.mtl
- Object file: [name].object.obj
- Texture file: [name].texture.jpg
How a final file naming should look
2. Editing the Material and Object files
It may be that the the txt file also needs editing in the Material and Object files
Editing the Material file:
In order to escape problems with textures loading, please check the path to textures and params in the Material file:
Ka and Kd attribute in MTL files must not be equal to 0.
Ka - is the ambient color of the material. Color definitions are in RGB where each channel's value is between 0 and 1.
Ka 1.000 1.000 1.000 # white
Similarly, the diffuse color is declared using Kd.
Kd 1.000 1.000 1.000 # white
How to edit the material file:
- Open the file in any text editor
- Clear the content of the file
- Replace with
newmtl defaultMat
Kd 1.000000 1.000000 1.000000
- It should look like this:
Editing the Object file:
- Open the file in any text editor
- Clear the marked content – leave the strings starting with v...
- Replace with:
usemtl defaultMat
- It should look like this:
Once all of this has been checked/ done you can save the files
Saving the file:
- Zip the folder with files
- Rename the folder file extension from .zip to .cc3d
- Upload file to CC CMS
NOTE:
If you want to reduce your obj file size follow the next steps:
-
Install meshlab
-
Open the obj file in the meshlab editor.
-
On the Filters tab click Remeshing, simplification, and reconstruction and choose the Quadric Edge Collapse Decimation line.
-
Set the Target number of faces in the opened window.
For example, to make a model with 760 000 faces that have a size under 30MB you need to set ~240 000 faces.
-
Export the mesh, after the editor completes reducing:
-
On the File, tab click Export Mesh As… .
-
In the opened window rename the file in the File name field.
-
Change the file type to Alias Wavefront Object (.obj) on the Files of type drop-down field.
-
Click the Save button.
To upload 3D files to the CultureConnect CMS
1. Select the Media Gallery tab on the left-side navigation menu in the CMS.
2. Select the 3D type tab.
3. Hover your cursor over the center module to see the option to Drop 3D file here or Upload from computer.
4. Choose an option to complete 3D file uploading.
When the upload is finished the 3D file is displayed in the gallery.
5. Go to the Stop Detail page you want to add the 3D file to.
6. In the Stop Media Container, choose 3d as the media type and click click the plus-button to see the option Select from media gallery.
3. Select the 3D file you've uploaded in the Choose the image pop-up window.
NOTE: you can upload the 3D file directly on the Stop detail page choosing the Upload from computer option in the Stop Media Container.