Layar Developer Documentation

Back to

How to Use 3D Model Converter

In this section, we will walk you through the main features of the model converter and explain how you can use Layar3D Model Converter.

Other useful material include:

Step 1: Importing Wavefront (.obj/.mtl)

After launching the Layar3D Model Converter, you first have to load the model you want to convert to Layar3D. Select "File -> Import Wavefront (.obj/.mtl)". Please see Creating the 3D objects to learn how to create a good 3D model for displaying in Layar. You can also open a .l3d file directly (Select "File ->Open").

Step 2: Inspect model

When you have loaded the model, you will see an overview of the model, including details about the number of verticex, faces, and materials. Also a list of the model dimensions is shown. The minimum Layar version shows you for which layar client version this 3D model is supported. Please NOTE that if there is Opacity value in imported .obj/.mtl files, the minimum layar client version will be automatically set to layar version 6.0 +.

Step 3: Edit materials (optional)

On the 'Materials' tab, you can:

Step 4: Add texture animation (optional)

Under the "Materials" tab, you can enable texture animation by changing the "Type" value to "animated". This will allow you to add animation frames to the texture. Please check Create texture-animated 3D models to learn how to created texture animated 3D model.

Step 5: Preview the model in 3D (optional)

To save time with testing in the Layar browser, you can use the "Preview" tab to see how the model will look in Layar. This preview window allows you to view the model from different distances and angles.

Step 6: Edit the model to fix any normal, positioning, or scaling issues (optional)

Use the edit menu to manipulate the model and to optimize it display in Layar.

Step 7: Layar3D placement on the map (optional)

Under "Placement" tab, you can place the 3D model directly on the map. A bird view of the model on the map is shown. The main functionality is:

For detailed explanation on how to use the Placement function, please check Positioning 3D Model within Layar3D Model Converter.

Step 8: Save as Layar3D (.l3d)

Select "File -> Save As..." to save your model to the Layar3D (.l3d) format. This will create a single file that contains the model including all textures. This is the file you need to refer to in your POI request response. Select "File -> Save" to update the existing Layar3D (.l3d) model.

It is also possible to save the same model for different layar version using "File -> Save for version". This is useful when you want to have your models work on various versions of layar clients. You can determine which 3d model should be returned in getPOIs response based on the "version" parameter in getPOIs request. Please NOTE that if you save the model for a specific older version, some features will be stripped from the model. For example, transparent materials might become opaque, and animated textures might be converted to a static version.