<doc>
	<legacy_id>1564</legacy_id>
	<name>relativePoints</name>
	<type>property</type>

	<syntax>
		<example>set the [effective] relativePoints of <i>graphic</i> to <i>vertexList</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies where the vertexes of a curve or irregular polygon graphic are located, relative to the graphic's rectangle.</summary>

	<examples>
<example>set the relativePoints of graphic "Arrows" to field "Endpoints"</example>
<example>put the effective relativePoints of graphic "myRectangle"</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="6.7">Updated for change where points are returned for objects that don't have this property</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<graphic/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<property tag="dashes">dashes Property</property>
		<property tag="endArrow">endArrow Property</property>
		<property tag="markerPoints">markerPoints Property</property>
		<property tag="points">points Property</property>
		<property tag="startArrow">startArrow Property</property>
		<property tag="editMode">editMode Property</property>
	</references>

	<description>
	<overview>Use the <b>relativePoints</b> property to find the shape of a curve or irregular polygon graphic, or to reshape the graphic.</overview>

		<parameters>
		</parameters>

	<value>The <b>relativePoints</b> of a graphic is a list of points (two integers separated by a comma), one per line.</value>
	<comments>Each point consists of the horizontal distance in pixels from the left edge of the graphic to the vertex, a comma, and the vertical distance in pixels from the top edge of the graphic to the vertex. (The points property is the same list, but measured from the top left of the stack window rather than the top left of the graphic.)<p></p><p>The first line in the list is the location of the graphic's starting point. A blank line in the relativePoints indicates that the previous and next vertexes are not connected by a line--that is, the polygon or curve is broken into two (or more) pieces.</p><p></p><p>If the style property of the graphic is not polygon or curve, the setting of its relativePoints property has no effect.</p><p></p><p><change></change><p>6.7: The effective points and effective relativePoints of a graphic return a polygonal representation of the shape even for shapes not defined by points. In particular, you can get the effective points of rectangle, round-rectangle and regular polygon graphics. (ovals are not yet supported).</comments>
	</description>
</doc>