home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / a / arttools / !Polygon / !Help < prev    next >
Text File  |  1997-02-05  |  20KB  |  419 lines
  1. Polygon 1.14 (05-Feb-97)
  2.  
  3. Name:     ArtWorks Polygon module
  4. Purpose:  Handling regular polygon and star objects in ArtWorks
  5. Author:   Martin Würthner
  6. Requires: RISC OS 3.1 or higher, ArtWorks 1.138 or higher
  7. Status:   ShareWare (see [7] below for *new* registering details!!!)
  8.  
  9. 0) Preface
  10. ----------
  11.  
  12. Depending on whether you are upgrading from an earlier version of the module
  13. or whether you are a new user, you will be interested in different things.
  14. Make sure that in any case you read section [7] which contains the details
  15. for registering.
  16.  
  17. If you are upgrading from an earlier version of Polygon, read section 5.1 for
  18. a list of new features and changes.
  19.  
  20. Otherwise just go on reading:
  21.  
  22. Welcome to the first non-commercial ArtWorks plug-in module!
  23. ------------------------------------------------------------
  24.  
  25. This module provides a tool which allows you to create regular n-sided
  26. polygons and stars. At any time, you can simply change the position, the
  27. radius or the number of sides of any polygon object. By a single mouse-click
  28. you can also turn a polygon into a star and vice versa. This tool was inspired
  29. by CorelXARA's¹ QuickShape tool.
  30.  
  31. This module is ShareWare. You may copy it freely and give it away to anyone
  32. free of charge (see [7] below for a more detailed Copyright notice). However,
  33. if after a trial period of two weeks, you decide to keep it, you must register
  34. by sending £10 to me.
  35.  
  36. ** New ** When registering, you will also receive an exciting new ArtWorks
  37.           module, Intersect, which is reserved for registered users of
  38.           Polygon exclusively.
  39.  
  40. Quick feature list of Polygon:
  41. * creation of regular n-sided polygons and stars (n in [3..49])
  42. * numeric and interactive editing facilities for polygons and stars: change
  43.   radius, number of sides, angle etc. at any time, turn polygons into stars
  44.   and vice versa
  45. * full integration with existing ArtWorks features (fill types, transformation
  46.   tools, Make shapes, perspective, envelope etc.), i.e. polygon objects behave
  47.   exactly like other ArtWorks shapes (ellipses, rectangles, rounded
  48.   rectangles)
  49. * full support of ArtWorks undo system and EPS export and import
  50.  
  51. Do not miss my other ArtWorks modules:
  52.   Translate (FreeWare)
  53.   Intersect (available only to registered users of Polygon)
  54.   ShowXY    (FreeWare)
  55.   MadnessT  (FreeWare)
  56.  
  57. 1) Installation
  58. ---------------
  59.  
  60. Copy the !Polygon application inside the !ArtWorks.Auto directory. (Shift
  61. double-click on !ArtWorks to open it, then double-click on the 'Auto' folder.
  62. Then drag the !Polygon application to the Filer window showing
  63. <something>.!ArtWorks.Auto in its title bar). This will cause ArtWorks to
  64. load the module automatically next time it is started.
  65.  
  66. If you are not using the 'Quick start' feature of ArtWorks, then this is it
  67. already. Otherwise (this is recognized by the fact the ArtWorks only displays
  68. one icon 'Quick start' when starting up) you have to go on:
  69.  
  70. If the 'Quick start' option is selected in the ArtWorks choices window you
  71. have to perform the following steps in order for ArtWorks to recognize the
  72. new module:
  73.  
  74. * Load ArtWorks
  75. * Open the ArtWorks choices window (icon bar menu 'Choices...', then click on
  76.   the ArtWorks icon in the ArtWorks global choices window)
  77. * Deselect 'Quick start' and click on 'Save'
  78. * Quit ArtWorks
  79. * Reload ArtWorks - while loading ArtWorks shows every module it loads, this
  80.   should now include the Polygon module. If ArtWorks displays an error message
  81.   like "Due to lack of memory one or more modules could not be loaded ..."
  82.   something has gone wrong and you should check whether you have correctly
  83.   installed the module.
  84. * Open the ArtWorks choices window again
  85. * Select 'Quick start' and click on 'Save'
  86.  
  87. If you ever should want to deinstall the module, remove the !Polygon
  88. directory from the !ArtWorks.Auto directory. Then, if you are using
  89. the 'Quick start' option, you must repeat the same steps above.
  90.  
  91.  
  92. 2) The Polygon module
  93. ---------------------
  94.  
  95. The Polygon module displays an additional tool, the Polygon tool,
  96. in the ArtWorks tool box. The tool's icon is a hexagon.
  97.  
  98. 2.1) Creating polygons and stars
  99.  
  100. While the Polygon tool is selected, the info bar displays the field 'Sides',
  101. 'CentreX', 'CentreY' and an option button 'Stellated'. At the moment, the
  102. most important field is 'Sides'. In this field, you can specify the number
  103. of sides (=number of corners) the polygon is supposed to have. The fields
  104. 'CentreX', 'CentreY' and 'Radius' are empty and can only be used to edit
  105. existing polygon objects.
  106.  
  107. To create a polygon, simply click inside the document and drag the pointer
  108. away from the position of the click. The click position will become the
  109. centre of the polygon. By dragging further away from the centre, you can
  110. increase the radius of the polygon.
  111.  
  112. Note that the mouse pointer also determines the position of one of the
  113. corners of the polygon so that you can effectively rotate the polygon while
  114. dragging. If you hold down Ctrl while dragging, the angle of the polygon is
  115. constrained to the current constraint angle (which can be set in the
  116. ArtWorks choices dialogue box).
  117.  
  118. As soon as you release the mouse buttons, the polygon object is created and
  119. will be rendered as a filled shape.
  120.  
  121. 2.2) Editing polygons and stars
  122.  
  123. Objects created by the Polygon tool are not simply path objects but belong to
  124. a specific object type "polygon" (similar to the way rectangle, rounded
  125. rectangle or ellipse objects are different from path objects). This means
  126. that you can apply attributes to them (fill colour, line colour, line width,
  127. graduated or radial fill etc.), but you cannot edit single corner points. To
  128. do so, you have to convert the polygon to a path object by choosing "Make
  129. shapes" from the "Lines/Shapes" menu or by pressing Ctrl-N.
  130.  
  131. The benefit of having a special polygon object is that you can edit the
  132. properties of polygons after they have are created, e.g. you can simply select
  133. the polygon and change its number of sides by selecting the Polygon tool and
  134. entering a new value in the 'Sides' field and pressing Return (or clicking on
  135. the up/down arrows). You can also change its radius or the position of its
  136. centre by entering new values in the corresponding fields. This is very
  137. similar to the way e.g. the ellipse tool works. Also, you can always turn a
  138. polygon into a star and vice versa by selecting or deselecting the 'Stellated'
  139. option button. Of course, when you save a file containing polygons they can
  140. still be edited when you reload the file later.
  141.  
  142. 2.3) Editing using the polygon handles
  143.  
  144. A selected polygon object has got a handle at each corner point. If the
  145. object is stellated, each outer corner (i.e. the corners of the corresponding
  146. polygon) and each inner corner has got a handle. By dragging these, you can
  147. edit the polygon. Dragging the polygon corner handles (or the other corners
  148. of a star) allows you to scale and rotate the object quickly. Note that this
  149. rotates about the real centre of the polygon unlike the ArtWorks rotation tool
  150. that cannot know what the real centre of the object is.
  151.  
  152. If you hold down Ctrl while dragging one of the outer corner handles of a
  153. polygon, the polygon's angle is preserved while dragging (i.e. you change its
  154. radius only). Similarly, if you hold down Shift, the polygon's radius is
  155. preserved (i.e. it is only rotated). As these operations preserve the
  156. polygon's centre, they are to be preferred to using the standard scaling or
  157. rotation tools ArtWorks provides.
  158.  
  159. Using the inner corner handles of a stellated polygon you can change the
  160. inner radius of the star on its own. This is in contrast to dragging the outer
  161. corners of a star which changes both the outer and the inner radius (scaling
  162. the inner radius proportionally). However, if you drag the inner corners, only
  163. the inner radius is changed and the outer radius stays the same.
  164.  
  165. With Polygon 1.10 or higher you can drag the inner handles of stars to any
  166. position, not only towards the centre or away from it, so you can twist the
  167. star. If you want to preserve the degree of twisting and edit the inner radius
  168. only, hold down Ctrl while dragging the inner handle of the star. By holding
  169. down Shift while dragging, you can force the radius to remain th