home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / translate / !Translate / !Help < prev    next >
Encoding:
Text File  |  1997-02-25  |  5.8 KB  |  155 lines
  1. Translate 1.02 (25-Feb-97)
  2.  
  3. Purpose: ArtWorks module for object translation
  4. Author:  Martin Würthner
  5. Status:  FreeWare (see [5] for details)
  6.  
  7. Welcome to a free ArtWorks module!
  8.  
  9. This module provides a tool which allows you to translate objects by
  10. specific amounts (e.g. 1cm to the right). This does not sound too
  11. spectacular, but it is a feature which was really missing from
  12. ArtWorks. Try it and you will see that it is useful.
  13.  
  14. If you are upgrading please read section 2.2.
  15.  
  16. There is a much more interesting non-commercial ArtWorks module called
  17. "Polygon" (also written by me) which is ShareWare and allows you to create
  18. and edit regular polygons and stars in ArtWorks.
  19.  
  20.  
  21. 1) Installation
  22. ---------------
  23. Copy the !Translate application inside the !ArtWorks.Auto directory.
  24. This will cause ArtWorks to load the module automatically next time
  25. it is started.
  26.  
  27. If you are not using the 'Quick start' feature of ArtWorks, then this
  28. is it already. Otherwise (this is recognized by the fact the ArtWorks
  29. only displays one icon 'Quick start' when starting up) you have to go on:
  30.  
  31. If the 'Quick start' option is selected in the ArtWorks choices window
  32. you have to perform the following steps in order for ArtWorks to recognize
  33. the new module:
  34.  
  35. * Load ArtWorks
  36. * Open the ArtWorks choices window (icon bar menu 'Choices...', then
  37.   click on the ArtWorks icon in the ArtWorks global choices window)
  38. * Deselect 'Quick start' and click on 'Save'
  39. * Quit ArtWorks
  40. * Reload ArtWorks - while loading ArtWorks shows every module it loads
  41. * Open the ArtWorks choices window
  42. * Select 'Quick start' and click on 'Save'
  43.  
  44. If you ever should want to deinstall the module, remove the !Translate
  45. directory from the !ArtWorks.Auto directory. Then, if you are using
  46. the 'Quick start' option, you must repeat the same steps above.
  47.  
  48.  
  49. 2) The Translate module
  50. -----------------------
  51.  
  52. 2.1) How it works
  53.  
  54. The Translate module displays an additional tool, the Translate tool,
  55. in the ArtWorks tool box. The tool looks like four arrows pointing
  56. to the left, the right, the top and the bottom.
  57.  
  58. When you select the tool, the info bar displays the fields 'Offset X',
  59. and 'Offset Y' and the action button 'Get Grid'. Also, it displays
  60. the standard ArtWorks 3 by 3 matrix of small buttons (with the
  61. button in the middle missing).
  62.  
  63. While the tool is selected, you may move the current selection by
  64. the amount specified in the 'Offset X' and 'Offset Y' fields by
  65. either clicking on one of the small buttons in the 3 by 3 matrix
  66. or by using the arrow keys (or Ctrl-Shift-arrow keys). The reason
  67. for allowing the arrow keys with Ctrl-Shift as well is that while
  68. the caret is in one of the writable fields, the cursor keys are
  69. used to move the caret, so you have to use Ctrl-Shift-arrow to move
  70. the selection.
  71.  
  72. The value in 'Offset X' is taken for horizontal moves, the value in
  73. 'Offset Y' is taken for vertical moves. Note that you can move the
  74. selection diagonally if you use the corresponding buttons on the
  75. 3 by 3 matrix. To change the offset values, enter a new value in
  76. any unit of measurement allowed by ArtWorks and press Return. The
  77. values are remembered even if you change the tool. Note that after
  78. you entered a new value, the caret is still in the writable field,
  79. so the cursor keys cannot be used to move the selection. Use Ctrl-
  80. Shift-cursor key instead or simply click in the main window to
  81. take the caret away from the input field.
  82.  
  83. By clicking on 'Get Grid' the current values of the grid are filled
  84. in, e.g. if your current grid is 1cm with 2 subdivisions, the offsets
  85. are both changed to 5mm. This option works independent of the 'Lock
  86. to grid' setting.
  87.  
  88. The module fully supports the Undo system of ArtWorks. The name of
  89. the operation is 'translate', so the Menu will show 'Undo translate'
  90. if your last operation was to translate an object or a selection of
  91. objects.
  92.  
  93. 2.2) Changes
  94.  
  95. ** New features of version 1.02 **
  96.  
  97. The user interface has been modified to fit in better with the rest
  98. of ArtWorks: If you press Return, both offsets are read from their
  99. fields in the info bar (as opposed to only the one in the field the
  100. caret is in as it happened with version 1.01). Pressing any other key
  101. (e.g. up/down arrow) no longer does this.
  102.  
  103. By popular demand Translate saves the currently used values in the
  104. global ArtWorks !Choices file if you choose "Save choices" from the
  105. ArtWorks info bar menu. These will then be taken as the default
  106. values next time you load ArtWorks.
  107.  
  108. German messages added.
  109.  
  110. ** New features of version 1.01 **
  111.  
  112. Version 1.00 of Translate was incompatible with the Precision Tool
  113. (available from CC) because the latter is using some codes which are
  114. in fact allocated to me. As it is improbable that there will be a fix
  115. for the Precision Tool I have applied for some new codes and modified
  116. all my modules to use these. So this module should now work as expected
  117. even if you have got Precision.
  118.  
  119.  
  120. 3) Take part in creating new ArtWorks modules!
  121. ----------------------------------------------
  122. If you have some spare time and you are wondering what to do with it:
  123. What about writing a new ArtWorks module? You will need the ArtWorks
  124. SDK first, which costs about £40, but it is worth the money. Lots of
  125. documentation and most of the source code for the standard ArtWorks
  126. modules.
  127.  
  128. This module took less than 2 days to write. So come on, try it yourself.
  129.  
  130.  
  131. 4) Contacting me:
  132. -----------------
  133. Martin Wuerthner
  134. Jahnstrasse 18
  135. 71116 Gaertringen
  136. Germany
  137.  
  138. Phone: +49-7034-928986
  139. Fax:   +49-7034-928915   (*new*)
  140.  
  141. e-mail: wuerthne@trick.informatik.uni-stuttgart.de
  142.  
  143.  
  144. 5) Copyright:
  145. -------------
  146. This ArtWorks module including all related files is Copyright 1997,
  147. by Martin Würthner and is FREEWARE.
  148. This means that you may copy it freely provided that
  149. (a) all files of this application are distributed together without
  150.     modification
  151. (b) this application is not sold for profit without my explicit written
  152.     permission
  153.  
  154. I retain the copyright on all files.
  155.