Adjust Handles

To allow for the adjusting UI of a shape we introduce the notion of an adjust handle. This adjust handle will be linked to adjust values that will then be used as input to the guide equations defined previously. The numerical chain described here will thus directly change the geometry of the related shape. There are two types of adjust handles that can be specified. An XY adjust handle acts in the horizontal/vertical direction and has two related guides, both a horizontal and a vertical respectively. A polar adjust handle acts in a polar manner and has two related guides as well. One guide for the radial width and the other for the radial angle. An adjust handle is specified to have an x and y coordinate as well as these adjust handles. This adjust handle can then be moved around in a generating application’s UI to adjust a pair of guides which will in turn adjust the shape being rendered.

An adjust handle can be specified by the following DrawingML.

<ahXY gdRefX="adj1" minX="-2147483647" maxX="2147483647" gdRefY="adj2"
  minY="-2147483647" maxY="2147483647">
  <pos x=”x1” y=”y1”/>
</ahXY>

Above is an XY adjust handle that has two guide references, a min and max allowed position for both the x and y coordinates as well as a position within the shape coordinate system where this adjust handle should be placed.