[Table of Contents] [docx version]

Error! No text of specified style in document.

path (Shape Path)

This element specifies a creation path consisting of a series of moves, lines and curves that when combined will form a geometric shape. This element will only be utilized if a custom geometry is specified.

[Note: Since multiple paths are allowed the rules for drawing are that the path specified later in the pathLst will be drawn on top of all previous paths. end note]

[Example: Consider the following DrawingML.

<a:custGeom>
<a:pathLst>
<a:path w="2824222" h="590309">
<a:moveTo>
<a:pt x="0" y="428263"/>
</a:moveTo>
<a:lnTo>
<a:pt x="1620455" y="590309"/>
</a:lnTo>

<a:lnTo>
<a:pt x="2824222" y="173620"/>
</a:lnTo>

<a:lnTo>
<a:pt x="1562582" y="0"/>
</a:lnTo>
<a:close/>
</a:path>
</a:pathLst>
</a:custGeom>

In the above example there is specified a four sided geometric shape that has all straight sides. While we only see three lines being drawn via the lnTo element there are actually four sides because the last point of (x=1562585, y=0) is connected to the first point in the creation path via a lnTo element. end example]

Parent Elements

pathLst5.1.11.16)

 

Child Elements

Subclause

arcTo (Draw Arc To)

§5.1.11.4

close (Close Shape Path)

§5.1.11.6

cubicBezTo (Draw Cubic Bezier Curve To)

§5.1.11.7

lnTo (Draw Line To)

§5.1.11.13

moveTo (Move Path To)

§5.1.11.14

quadBezTo (Draw Quadratic Bezier Curve To)

§5.1.11.21

 

Attributes

Description

extrusionOk (3D Extrusion Allowed)

Specifies that the use of 3D extrusions are possible on this path. This allows the generating application to know whether 3D extrusion can be applied in any form. If this attribute is omitted then a value of 0, or false is assumed.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

fill (Path Fill)

Specifies how the corresponding path should be filled. If this attribute is omitted, a value of "norm" is assumed.

 

The possible values for this attribute are defined by the ST_PathFillMode simple type (§5.1.12.38).

h (Path Height)

Specifies the height, or maximum y coordinate that should be used for within the path coordinate system. This value determines the vertical placement of all points within the corresponding path as they will all be calculated using this height attribute as the max y coordinate.

 

The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§5.1.12.42).

stroke (Path Stroke)

Specifies if the corresponding path should have a path stroke shown. This is a boolean value that will effect on the outline of the path. If this attribute is omitted, a value of true is assumed.

 

The possible values for this attribute are defined by the XML Schema boolean datatype.

w (Path Width)

Specifies the width, or maximum x coordinate that should be used for within the path coordinate system. This value determines the horizontal placement of all points within the corresponding path as they will all be calculated using this width attribute as the max x coordinate.

 

The possible values for this attribute are defined by the ST_PositiveCoordinate simple type (§5.1.12.42).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Path2D">

   <choice minOccurs="0" maxOccurs="unbounded">

   <element name="close" type="CT_Path2DClose" minOccurs="1" maxOccurs="1"/>

   <element name="moveTo" type="CT_Path2DMoveTo" minOccurs="1" maxOccurs="1"/>

   <element name="lnTo" type="CT_Path2DLineTo" minOccurs="1" maxOccurs="1"/>

   <element name="arcTo" type="CT_Path2DArcTo" minOccurs="1" maxOccurs="1"/>

   <element name="quadBezTo" type="CT_Path2DQuadBezierTo" minOccurs="1" maxOccurs="1"/>

   <element name="cubicBezTo" type="CT_Path2DCubicBezierTo" minOccurs="1" maxOccurs="1"/>

   </choice>

   <attribute name="w" type="ST_PositiveCoordinate" use="optional" default="0"/>

   <attribute name="h" type="ST_PositiveCoordinate" use="optional" default="0"/>

   <attribute name="fill" type="ST_PathFillMode" use="optional" default="norm"/>

   <attribute name="stroke" type="xsd:boolean" use="optional" default="true"/>

   <attribute name="extrusionOk" type="xsd:boolean" use="optional" default="true"/>

</complexType>