2.1.1803 Part 4 Section 19.1.2.14, path (Shape Path)

For additional notes that apply to this portion of the standard, please see the notes for pict, §14.2.2.2(a); pict, §14.5.1(a); background, §17.2.1(a); arc, §19.1.2.1(gggg); group, §19.1.2.7(a).

a.   The standard does not define the coordinate space for the pen positions.

In Office, the coordinate space for pen movements is defined by the shape's coordinate space rectangle, as given by the coordsize and coordorigin attributes.

b.   The standard does not define units for the angle parameters for ellipses defined using the ae property of the v attribute.

Office uses units of 1/65536 of a degree for the angle parameters for ellipses defined using the ae property of the v attribute.

c.   The standard defines the properties for the v attribute.

Office uses additional commands to indicate desired application behavior when the object is edited by the user.  An application that does not understand these commands may ignore, rewrite or remove them.

The following commands describe the desired application behavior for all points that follow the command during operations that move the object’s points or associated line segments.  These behaviors apply to vertices in the path (end points, not associated control points) depending on whether the associated line segment is a line or a curve.

Command

Name

Parameters

Description

Vertex behavior

Line segment type

Ha

AutoLine

0

auto

Line

Hb

AutoCurve

0

auto

curve

Hc

CornerLine

0

corner

line

Hd

CornerCurve

0

corner

curve

He

SmoothLine

0

smooth

line

Hf

SmoothCurve

0

smooth

curve

Hg

SymmetricLine

0

symmetric

line

Hh

SymmetricCurve

0

symmetric

curve

Hi

Freeform

0

freeform

any

The line segment type defines whether the command applies to points which are adjacent to lines or to points adjacent to curves.  The vertex behavior specifies how the two line segments on either side of a point should behave as the point is moved.

Vertex behavior

Curve control points should be calculated automatically

Control points should be equidistant from vertex

Control points should be co-linear with vertex

Control points should be visible to the user

Auto

Yes

N/A

N/A

No

Symmetric

No

Yes

Yes

Yes

Smooth

No

No

Yes

Yes

Corner

No

No

No

Yes

Freeform

No

No

No

Yes

The auto vertex behavior is effectively the default behavior as it requires the application to provide the control points for the curve.  The freeform vertex behavior is effectively user-defined as the application does not calculate control points.

d.   The standard indicates that the last four values of the at property of the v attribute are radial vectors.

In Office, the last four values of the at property of the v attribute are points that define radial vectors with origins at the center of the bounding box.

e.   The standard does not fully explain how the qb property of the v attribute is used.

Office requires that the qb property of the v attribute have a closed path. If the path is not closed, a new subpath shall exist after qb.

f.   The standard indicates how the limo attribute is used.

Office does not support the limo attribute.

g.   The standard indicates how the textboxrect attribute is used.

The following describes the Office requirements for this attribute:

Only one textbox is created for each shape. The rectangles defined by this attribute are used with text layout options to define the position of the textbox inside the shape.

If 4, 5 or more than 6 rectangles are defined, Office defaults to the shape’s bounding box.

If the shape has no adjust handles, the rectangle chosen depends on the layout defined by the layout-flow property of the style attribute:

Layout-flow

Number of

Rectangles

Chosen Rectangle

Horizontal or Vertical

1

#1

Horizontal

2

#1

Vertical

2

#2

Horizontal or Vertical

3

#1

Horizontal

6

#1

Vertical

6

#4

If the shape has adjust handles, the position of the textbox takes into account one or more rectangles defined here, the layout of the text and the position and range of the adjust handles. Office uses this data to choose a textbox position that conflicts least with the shape’s path.

If more than one adjust handle is defined, only the first one is used. However, Office requires that the first handle defined in the file for the shape reference the first two values of the adj attribute of the shape.

[Note: For more information about adjust handles, see the handles element ("[ISO/IEC-29500-4] §19.1.2.9; handles (Set of Handles)") and the adj attribute, such as on the shape element ("[ISO/IEC-29500-4] §19.1.2.19; shape (Shape Definition)"). For more information about text layout, see the text layout properties in the style attribute of the textbox element ("[ISO/IEC-29500-4] §19.1.2.22; textbox (Text Box)"). end note]

h.   The standard does not restrict the number of instances of the path element.

Office allows at most only one instance of the path element in each place where it can be used.