Shape3DType class
Apply 3D shape properties. When the object is serialized out as xml, its qualified name is a:sp3d.
DocumentFormat.OpenXml.OpenXmlElement
DocumentFormat.OpenXml.OpenXmlCompositeElement
DocumentFormat.OpenXml.Drawing.Shape3DType
Namespace: DocumentFormat.OpenXml.Drawing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)
[ISO/IEC 29500-1 1st Edition]
sp3d (Apply 3D shape properties)
This element defines the 3D properties associated with a particular shape in DrawingML. The 3D properties which can be applied to a shape are top and bottom bevels, a contour and an extrusion.
[Example: Consider the following example of an sp3d in DrawingML:
<a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>In this example, we see an sp3d defined which contains information defining both a top and bottom bevel, along with an extrusion and contour on the shape. The following image illustrates a shape with the applied sp3d:
end example]
Parent Elements |
|---|
bodyPr (§21.1.2.1.1); effectStyle (§20.1.4.1.11); spPr (§21.2.2.197); spPr (§21.3.2.23); spPr (§21.4.3.7); spPr (§20.1.2.2.35); spPr (§20.2.2.6); spPr (§20.5.2.30); spPr (§19.3.1.44); txPr (§21.4.5.12) |
Child Elements | Subclause |
|---|---|
bevelB (Bottom Bevel) | §20.1.5.3 |
bevelT (Top Bevel) | §20.1.5.4 |
contourClr (Contour Color) | §20.1.5.6 |
extLst (Extension List) | §20.1.2.2.15 |
extrusionClr (Extrusion Color) | §20.1.5.7 |
Attributes | Description |
|---|---|
contourW (Contour Width) | Defines the width of the contour on the shape. [Example: Consider the following example of a contourW in use within the sp3d element: <a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>In this example, we see a countourW defined as 50800. end example] The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§20.1.10.42). |
extrusionH (Extrusion Height) | Defines the height of the extrusion applied to the shape. [Example: Consider the following example of an extrusionH in use within the sp3d element: <a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>In this example, we see a extrusionH defined as 165100. end example] The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§20.1.10.42). |
prstMaterial (Preset Material Type) | Defines the preset material which is combined with the lighting properties to give the final look and feel of a shape. [Example: Consider the following example of a prstMaterial in use within the sp3d element: <a:sp3d extrusionH="165100" contourW="50800" prstMaterial="plastic">
<a:bevelT w="254000" h="254000"/>
<a:bevelB w="254000" h="254000"/>
<a:extrusionClr>
<a:srgbClr val="FF0000"/>
</a:extrusionClr>
<a:contourClr>
<a:schemeClr val="accent3"/>
</a:contourClr>
</a:sp3d>In this example, we see a prstMaterial defined as plastic. end example] The possible values for this attribute are defined by the ST_PresetMaterialType simple type (§20.1.10.50). |
z (Shape Depth) | Defines the z coordinate for the 3D shape. The possible values for this attribute are defined by the ST_Coordinate simple type (§20.1.10.16). |
[Note: The W3C XML Schema definition of this element’s content model (CT_Shape3D) is located in §A.4.1. end note]
© ISO/IEC29500: 2008.