Fork me on GitHub

Generic 3D Data conversion

How to get your 3d asset in your application is one of the essential questions that every 3D runtime environment has to answer.

X3DOM uses X3D data embedded in (X)HTML pages and optional X3D-XML files reference by the embedded part. The X3D-XML files can reference further X3D-XML files and therefore build a hierarchy of asset container.


This tutorial shows how to get your data into the X(HTML) page and how to convert it to X3D-XML so it could be externally referenced.

DCC export

Usually people use some form of Digital Content Creation (DCC) tool to build the 3D models. This can be a modeling system like Maya or 3dsMax, but also a CAD-System or simulation package.

They all usually allow exporting the internal representation to some form of 3D data file. Most support X3D or VRML, some even both (e.g. blender) plus other formats. For X3DOM you should look for a X3D exporter. VRML is your second best choice. X3D is a VRML derivate and superset.


If your DCC-tool does not support X3D or VRML you are forced to utilize another tool which will introduce a extra level of conversion. Depending on your format there are usually different converters:

X3D/ data conversion

However, you should really try to avoid this step and export directly to X3D or VRML.


If you have an X3D-XML or VRML file you can easily recode your data without any data loss. There are different options but the easiest right now is properly the Avalon-Optimizer (aopt) from the InstantReality packages. You can use it online or offline to recode your data.

Online Transcoding

Offline Transcoding

Download and install the InstantPlayer system. The package includes a command line tool called aopt(.exe) which we will use for conversion. Setup your shell-environment to find and include the binary. The usually paths are:

Windows: C:\Program Files\Instant Player\bin\aopt.exe
Mac: /Applications/Instant
Linux: /opt/instantReality/bin/aopt


run "aopt -h" to get a full list of commands.

For this tutorial the most important are:

Convert VRML to X3D-XML

aopt -i foo.wrl -x foo.x3d

Convert VRML or X3D-XML to HTML

aopt -i foo.x3d -N foo.html

Convert VMRL or X3D-XML to XHTML

aopt -i foo.x3d -M foo.xhtml

Optimization and build DEF/USE reuses while converting with "-u"

aopt -i foo.x3d -u -N foo.html

Building the File Hierarchy

A hierarchy of files can be built up with Inline nodes. The advantage here is that bigger objects/ meshes do not need to be directly part of a page's source code, but can be loaded in parallel in the background.

Important: If you use <Inline url="foo.x3d" /> nodes in your content, you need a real server to run your application. This will not work locally from your disc.