Module ria/view/style/Icon3DStyle

If any of the above does not hold true for your mesh, you can use the scale, rotation and translation parameters to make sure that the mesh is aligned to accommodate the list above.

Example: you have a 3D aircraft mesh. The aircraft is defined in millimeters and it points to the halfway point between the X and Y direction.

Aircraft mesh

If you want to align this mesh with our assumptions, you must scale by a factor of 1/1000, and rotate by 45 degrees about the Z-axis:

   var icon3DStyle = {
     meshUrl: "aircraft.gltf",
     rotation:{
       z: -45
     },
     scale:{
       x: 1/1000,
       y: 1/1000,
       z: 1/1000
     }
   };

This results in:

Aligned mesh

Once you have your mesh correctly aligned in its own local reference using rotation, scale and translation, you are ready to orient the 3D mesh in the world.

By default, the position of the mesh is parallel to the surface of the ellipsoid. The X-direction points towards the north and the Y-direction points towards the west.

Default orientation

Note: when the mesh is visualized on a cartesian view the Y-axis of the mesh points up and the X-axis points towards the right.

You can change the heading, pitch and roll of the mesh by adjusting the orientation.

Example: you want your aircraft to point to the east. You must make sure that its heading is 90 degrees, measured clockwise from the north.

   var icon3DStyle = {
     meshUrl: "aircraft.gltf",
     ...
     orientation: {
       heading: 90 //make aircraft point to the east, or 90 degree azimuth.
     }
   };

This orientation results in:

Heading to the east

In addition to heading, an orientation object allows you to specify pitch and roll. See below for the effect of those parameters on the aircraft.

Heading and pitch		Heading, pitch and roll

Note that orientation.heading is analogous to IconStyle.heading, but for 3D meshes.

since

2016.1