• Overview
• Pictures
  • Overview
  • Image Properties
    • Image Data
    • Tile or Stretch Image to Fill
    • Effects
  • Non-Visual Properties
  • Shape Properties
• Shapes
  • Overview
  • Non-Visual Properties
  • Visual Properties
    • Size of Bounding Box
    • Location of Bounding Box
    • Geometry
      • Preset
      • Custom
    • Shape Fill
      • Solid Fill
      • Picture Fill
      • Gradient Fill
      • Pattern Fill
      • Group Fill
    • Effects
    • Outline Style
    • 2D Transforms
    • 3-D
      • Shape Properties
      • Scene Properties
  • Styles
  • Text
    • Text Body Properties
      • Positioning and Insets
      • Fit, Wrap, Warp and 3D
      • Columns, Vertical Text and Rotation
    • Paragraphs
      • Paragraph Properties
        • Bullets and Numbering
        • Spacing, Indent and Margins
        • Alignment, Tabs, Other
      • Run Properties
    • List Properties
• Connectors
  • Non-Visual Properties
• Text
• Charts
• Diagrams
• Tables
  • Defining Structure
  • Rows, Cells, Cell Content
  • Cell Properties
    • Alignment, Margins, Direction
    • Borders and Fill
  • Table Styles and Properties
• Placement within Docs
  • Overview
  • Inline Objects
  • Floating Objects
    • Positioning
    • Text Wrapping
• Placement within Spreadsheets
  • Overview
  • Absolute Anchoring
  • One Cell Anchoring
  • Two Cell Anchoring
• Placement within Presentations

DrawingML Shapes

3D properties are specified within a container <a:sp3d> element, which is within the <a:spPr> (shape properties) element. There are three possible 3D properties--top and bottom bevels, a contour, and an extrusion--and they are specified either as a child element or as a combination of child element and attribute of <a:sp3d>. Below is a shape with a top bevel and a blur contour.

In addition to the attributes related to contour and extrusion, there are two attributes which affect the 3D properties of a shape. They are prstMaterial and z. The prstMaterial attribute specifies a preset material type, which is a combination of lighting characteristics which are intended to mimic the material. Possible values are:

• clear
• dkEdge
• flat
• legacyMatte
• legacyMetal
• legacyPlastic
• legacyWireframe
• matte
• metal
• plastic
• powder
• softEdge
• softMetal
translucentPowder

Below is the same shape shown above, except that the prstMaterial attribute has been set to powder rather than metal.

The z attribute defines the z coordinate for the 3D shape. It is a simple coordinate specified either in EMUs or as a number immediately followed by a unit identifier.

Bevels

Bottom and top bevels are specified with <a:bevelB> and <a:bevelT>, respectively. Both bevel elements are empty elements with three attributes which define the charateristics of the bevel. The prst attribute specifies the preset bevel type which defines the look of the bevel. Possible values are:

• angle
• artDeco
• circle
• convex
• coolSlant
• cross
• divot
• hardEdge
• relaxedInset
• riblet
• slope
• softRound

The h attribute specifies the height (in EMUs) of the bevel or how far above the shape it is applied. The w attribute specifies the width of the bevel, or how far into the shape it is applied. Below is a sample shape with top and bottom bevels. The bottom bevel is a coolSlant type and has a width of 13 points and a height of 10 points. The top bevel is a softRound type and has a width of 12 points and a height of 10 points.

Contours

A contour is a solid filled line that surrounds the outer edge of the shape. The color of the contour is specified as a child element <a:contourClr> of the <a:sp3d> element. The color is specified as a child element of <a:contourClr> using one of the following color options: as a preset color (<a:prstClr>), using hue, saturation and luminance (<a:hslClr>), scheme colors (<a:schemeClr>), system colors (<a:sysClr>), or as RGB percentages or hex numbers (<a:scrgbClr> or <a:srgbClr>). Note that these elements corresponding to color specification methods can also have child elements which transform the base color. So, for example, a scheme or theme color may be specified as accent6, but a luminance modulation can also be applied to that base color. Colors are not covered in detail here.

The width of the contour is specified (in EMUs) with contourW attribute on the <a:sp3d> element. Below is a shape with a 5-point contour in light blue. Note that the same effect could be achieved by setting the outline shape property. See Shape Outlines.

Extrusion

An extrusion is an artificial height applied to the shape. The color of the extrusion is specified as a child element <a:extrusionClr> of the <a:sp3d> element. The color is specified as a child element of <a:extrusionClr>, using the same color elements as the contour color. See above. The height of the extrusion is specified (in EMUs) with extrusionH attribute on the <a:sp3d> element. Below is a shape with a 20-point, red extrusion.