<a-obj-model>

Note: This documentation is for the old 0.2.0 version of A-Frame. Check out the documentation for the current 0.5.0 version

The .OBJ model primitive displays a 3D Wavefront model. It is an entity that maps the src and mtl attributes to the obj-model component’s obj and mtl properties respectively.

Example

<a-scene>
<a-assets>
<a-asset-item id="crate-obj" src="crate.obj"></a-asset-item>
<a-asset-item id="crate-mtl" src="crate.mtl"></a-asset-item>
</a-assets>
<!-- Using the asset management system. -->
<a-obj-model src="#crate-obj" mtl="#crate-mtl"></a-obj-model>
<!-- Defining the URL inline. Not recommended but may be more comfortable. -->
<a-obj-model src="crate.obj" mtl="crate.mtl"></a-obj-model>
</a-scene>

Attribute

Note that the .OBJ model primitive inherits common mesh attributes:

Attribute Component Mapping Default Value
mtl obj-model.mtl null
src obj-model.obj null

Troubleshooting

If you don’t see your model, try scaling it down. OBJ models generally have extremely large scales in comparison to A-Frame’s scale.

Table of Contents