Skip to content

API reference / Common / Engine types / ShapeModel3d

Interface: ShapeModel3d ​

A 3-D model in a graphic frame (am3d:model3d, CT_Model3D).

The raster is what a page paints: the picture of this view Office's own renderer drew and saved beside the model, so a page shows the model exactly as Office does. The rest is the scene that picture was drawn from — the model, where it stands, the camera and the lights — which a slide show draws again at every frame of a morph that turns it.

Lengths are in points (the file states EMU) and angles in degrees (the file states 60000ths), in the scene's own space: x to the right, y up, z toward the viewer.

Properties ​

PropertyDescription
model?
string
@r:embed — the model file, a binary glTF, held by its id: the importer resolves the file's rId2 and stores what it found. None for a model linked from outside the package (@r:link), or one whose relationship names nothing.
properties
ShapeProperties
am3d:spPr — the model's own shape properties, Office writing its box as the frame's at the origin.
camera
ShapeModel3dCamera
am3d:camera — where the scene is seen from.
transform
ShapeModel3dTransform
am3d:trans — how the model stands in the scene.
raster?
ShapeModel3dRaster
am3d:raster — the picture of this view and the renderer that drew it.
viewport
ShapeModel3dViewport
am3d:objViewport / am3d:winViewport — how the camera's view maps onto the frame.
ambientLight?
ShapeModel3dAmbientLight
am3d:ambientLight.
lights?
ShapeModel3dLight[]
am3d:ptLight, am3d:spotLight, am3d:dirLight and am3d:unkLight, in document order.