home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / d / draw / !Draw1 / !help < prev    next >
Encoding:
Text File  |  1990-10-18  |  45.5 KB  |  964 lines

  1.  
  2.  
  3.                          ARC DRAW 1½ - USER NOTES
  4.  
  5.  
  6.  
  7. Introduction
  8.  
  9. These notes describe the main features of ArcDraw 1½ - all the options are 
  10. described,  although  it is assumed that the reader is familiar  with  the 
  11. original version of ArcDraw.   Note that files produced by ArcDraw 1½  are 
  12. fully  compatible with the original and other programs using  Draw  files, 
  13. although  obviously  the  background feature will  not  be  recognised  by 
  14. others.
  15.  
  16.  
  17.  
  18. Running
  19.  
  20. Before running, the latest versions of the shared C library (CLib) and the 
  21. floating point emulator (FPE) must be loaded.  Employees and associates of 
  22. Computer Concepts  (who  seem to object to writing applications  in  high-
  23. level languages) may as well stop reading now.
  24.  
  25. Double-click on the application icon,  or a saved Draw file, in the normal 
  26. way.   If AD1½ is not yet running,  it will be loaded and the drawing will 
  27. appear in a new window.   If it is,  the drawing will be loaded into a new 
  28. window.   In both cases,  unless the option to not do so has been  set,  a 
  29. tool window will also appear for each document window.
  30.  
  31. To  create a new blank document,  click Select on the icon bar  icon  once 
  32. AD1½ has been loaded.
  33.  
  34. To load a Draw file from the filer or saved from another application, drag 
  35. it to the icon bar icon.
  36.  
  37. A settings file is loaded when the application is run up.   This  contains 
  38. such information as the display colours,  preference settings (see below), 
  39. default page size and grid settings and default text and path styles.   If 
  40. a  message appears complaining that this file is not present,  use one  of 
  41. the default save options to create the file.
  42.  
  43.  
  44.  
  45. Merging and saving
  46.  
  47. To merge a drawing with another,  load the first and then drag the  second 
  48. into  the  drawing window;   the two drawings will be  combined.   If  the 
  49. appropriate  option  has been set,  the bottom left corner of  the  loaded 
  50. drawing will be placed at the pointer position where the mouse button  was 
  51. released.   If it is not set, the bottom left corners of the drawings will 
  52. be aligned without regard to the pointer position.
  53.  
  54. To create a sprite object,  drag a sprite file into a drawing window;  the 
  55. object  will  appear at the pointer position at its  true  size.   If  the 
  56. sprite file contains more than one sprite, the first one will be used.
  57.  
  58. To create a text area object, drag a text file into a drawing window;  the 
  59. object  will be created with the text columns set to standard  sizes.   If 
  60. the  file does not have a standard header,  one will be supplied.   If  an 
  61. existing text area object is selected when a text file is loaded, the text 
  62. in that area will be replaced by the contents of the file without changing 
  63. its size or position.
  64.  
  65. The following options appear on the Save menu.   All but one of them  lead 
  66. to 'Save as' windows which are used in the normal way:
  67.  
  68.   Drawing               Saves the complete drawing as a Draw file.
  69.  
  70.   Selection             Saves  the selected objects as a Draw  file,  plus 
  71.                         the   drawing  header  and  font  information   if 
  72.                         required.   Only available in Select mode when  at 
  73.                         least one object is selected.
  74.  
  75.   Sprites               Saves  the  selected  objects as  a  sprite  file.  
  76.                         Select  mode  must again be active,  and  all  the 
  77.                         selected objects must be sprites.
  78.  
  79.   Text area             Saves the text contained in the selected area as a 
  80.                         text  file.   A  single text area object  must  be 
  81.                         selected.   If the text did not have the  standard 
  82.                         header when it was loaded,  it will be saved  with 
  83.                         it.
  84.  
  85.   Ascii                 Saves the selected objects in dump  format.   This 
  86.                         may not be available in released versions;   it is 
  87.                         intended   for  future  interfacing   with   other 
  88.                         programs.
  89.  
  90.   Defaults              Saves  the current preference  settings,  and  the 
  91.                         current drawing's settings and default styles,  as 
  92.                         the permanent default.   This default will be used 
  93.                         for any new drawings created, and will be saved on 
  94.                         disc so that it can be used next time AD1½ is  run 
  95.                         up.
  96.  
  97.  
  98.  
  99. Preferences
  100.  
  101. Selecting  the  "Preferences"  option from the icon  bar  menu  opens  the 
  102. setting  window.   The display colours for various items  are  shown;   to 
  103. change them, step through the palette colours using the up or down arrows.  
  104. The other options available are:
  105.  
  106.   Auto paper size       When  set,  the  paper size is  automatically  set 
  107.                         (based  on  the  drawing  dimensions)  whenever  a 
  108.                         drawing is loaded.   If this is not set, the paper 
  109.                         size will be taken from the default settings.
  110.  
  111.   Show tools            When set,  the tool window is automatically opened 
  112.                         when a drawing window is opened.
  113.  
  114.   Merge at pointer      When  set,  and  a Draw file is  dragged  into  an 
  115.                         existing drawing window to merge the two drawings, 
  116.                         place the loaded drawing at the pointer  position.  
  117.                         If this is not set, the bottom left corners of the 
  118.                         drawings will be aligned.
  119.  
  120.   Quit after printing   Set this if it is required to unload AD1½ after it 
  121.                         has  been loaded at the printer driver's  request, 
  122.                         when a Draw file is dragged onto the printer icon.  
  123.                         If this option is not set,  it will remain  loaded 
  124.                         after  printing has finished.   If this option  is 
  125.                         set,  the application will unload itself after one 
  126.                         copy has been printed.  Note that this option only 
  127.                         has effect when it is saved as the default...
  128.  
  129.   Confirm delete many   If this is set,  a Yes/No confirm box will pop  up 
  130.                         every time more than one object, or a group, is to 
  131.                         be deleted.   The objects will only be deleted  if 
  132.                         Yes is chosen.
  133.  
  134.   Interactive help      If  this is set (which only has effect when it  is 
  135.                         saved  as the default),  interactive help will  be 
  136.                         enabled   (if  the  !Help  application   is   also 
  137.                         running).   If this option is not set, interactive 
  138.                         help is not available but loading time and  memory 
  139.                         usage will be reduced.
  140.  
  141. To  implement  the  settings,  click OK;   these will  persist  until  the 
  142. application is quit.   If any colours have been changed,  the display will 
  143. be redrawn.   To save the options permanently,  click Save;   the  default 
  144. drawing  style  will remain as before.   To save a drawing  style  as  the 
  145. default along with the preferences,  use "Save/Settings" from the document 
  146. menu as described above.
  147.  
  148.  
  149.  
  150. The toolbox
  151.  
  152. The  toolbox contains various icons to select the  drawing  mode,  display 
  153. controls and a message display.  From left to right, the tool icons are:
  154.  
  155.   Create line/curve     These four tools create paths of that type, in the 
  156.                         same  way as the original Draw did.   They can  be 
  157.                         clicked when idle,  to set the type of the initial 
  158.                         segment,  or  while drawing to change the  current 
  159.                         segment  to  that type.   The two  'closed'  tools 
  160.                         insert  extra line segments,  of the same type  as 
  161.                         that  last  placed,  when  a path  or  subpath  is 
  162.                         completed.
  163.  
  164.   Move                  Inserts an invisible move into a path,  starting a 
  165.                         new subpath.   Can only be used when path entry is 
  166.                         already in progress,  and the previous segment was 
  167.                         not a move.
  168.  
  169.   Ellipse               Creates  an ellipse or circle.   Click  Select  to 
  170.                         mark the centre,  then Select again to define  the 
  171.                         size.
  172.  
  173.   Box                   Creates  a rectangle or square.   Click Select  to 
  174.                         mark  one corner,  then Select again to  mark  the 
  175.                         diagonally opposite corner.
  176.  
  177.   Polygon               Creates a regular polygon.  Click Select to define 
  178.                         the centre,  then drag out the circle on which the 
  179.                         corners will be placed (the circumcircle for those 
  180.                         of you who like big words).  Click Select again to 
  181.                         define  the size.   The number of sides is set  by 
  182.                         the option on the "Create" menu.
  183.  
  184.   Text                  Creates a text object.   Click Select to  position 
  185.                         the  caret,  then type.   The text can  be  edited 
  186.                         during  entry,  using  the same keys as  for  text 
  187.                         editing.  Press Return to terminate entry;  unless 
  188.                         the font being used is the system font,  the caret 
  189.                         will  be  moved down ready for the  next  line  of 
  190.                         text.   The  line  spacing can be  set  using  the 
  191.                         "Leading" option on the "Text Style" menu.
  192.  
  193.   Edit                  Enters edit mode,  for changing existing paths  or 
  194.                         text.
  195.  
  196.   Select                Enters select mode.
  197.  
  198.   Abandon               Abandons an operation in progress.
  199.  
  200. The other control buttons in the tool window are:
  201.  
  202.   Ortho                 When selected,  pointer movement is restricted  to 
  203.                         90°  or  45° movement (rectangular  grid)  or  30° 
  204.                         movement  (isometric grid) while  dragging.   This 
  205.                         can be used,  for example, to force the ellipse or 
  206.                         box tools to create a square or circle.   It  will 
  207.                         also   force  the  path  create  modes   to   draw 
  208.                         horizontal  or  vertical lines,  and  Select  mode 
  209.                         dragging to also be constrained.
  210.  
  211.                         When not selected, the pointer moves freely.
  212.  
  213.   Zoom                  When  selected,   displays  at  the  preset   zoom 
  214.                         setting;   when not, at actual size.  Click Adjust 
  215.                         to  pop  up  the zoom setting box  (this  is  also 
  216.                         available from the "Settings/Zoom" menu).
  217.  
  218. The message display shows various (hopefully) helpful messages.
  219.  
  220.  
  221.  
  222. Select mode
  223.  
  224. Select  mode  is fairly similar to the original.   Click  Select  over  an 
  225. object to select it;  double-click Select over a selected object to find a 
  226. deeper  one.   Click Adjust to add an object to,  or remove it  from,  the 
  227. selection.   Click  Select over a blank area of the diagram to  clear  the 
  228. selection.   Starting over a blank area,  drag Select to enclose a box  of 
  229. objects and select them all;   drag Adjust to enclose a box of objects and 
  230. add them to or remove them from the selection.
  231.  
  232. Each selected object will appear with four 'handles',  one on each corner:  
  233. to move that corner,  drag the handle with Select.   Drag any handle  with 
  234. Adjust to rotate the object about its centre;   drag with Select over  the 
  235. body of an object to move it.
  236.  
  237. Note that the sensitive area of an object extends a distance on each  side 
  238. equivalent  to  the size of a 'handle'.   This avoids a problem  with  the 
  239. original where it was very difficult to select or move objects  consisting 
  240. of a horizontal or vertical thin line.
  241.  
  242. See the later sections for Select and Arrange menu options.
  243.  
  244.  
  245.  
  246. Edit mode
  247.  
  248. Edit  mode is used to change existing paths or text.   Enter Edit mode  by 
  249. clicking on the toolbox icon,  then select an object by clicking Select on 
  250. it.  To start editing, click Adjust over the object, or over an unselected 
  251. object to select and then edit that.  Double-click Select to find a deeper 
  252. object.
  253.  
  254. If  the object over which Adjust is clicked is a text  object,  the  caret 
  255. will appear.   Text can now be typed and amended;   the following  control 
  256. keys can be used:
  257.  
  258.   Left,Right            Move the caret.
  259.  
  260.   Ctrl-Left             Move to the beginning of the text.
  261.  
  262.   Ctrl-Right            Move to the end of the text.
  263.  
  264.   Backspace or Delete   Delete the character to the left of the caret.
  265.  
  266.   Copy                  Delete the character to the right of the caret.
  267.  
  268.   Return                Finish editing and update the text object with the 
  269.                         changes made.
  270.  
  271.   Escape                Abandon text editing and do not change the text.
  272.  
  273. Note that 'System Font' text cannot be edited on screen;  it will be shown 
  274. in a dialogue box.  The standard Wimp editing keys can be used.
  275.  
  276. If the object over which Adjust was clicked is a path,  it will be redrawn 
  277. in  thin  lines  with a marker over each point and  a  different  coloured 
  278. marker over curve control points.   The initial position for a new subpath 
  279. is shown as an open circle, other points as a filled square.
  280.  
  281. To select a point,  click Adjust over it;   it and its associated  segment 
  282. (if  there is one) will be highlighted.   The Edit menu options  apply  to 
  283. this  point  and segment.   Drag Adjust over the point,  or over  a  curve 
  284. control point, to change its position.
  285.  
  286. To finish path editing and update the original object,  click Select.   To 
  287. restore the original object without changing it,  click Abandon or any  of 
  288. the toolbox icons.
  289.  
  290. See the later section for Edit menu options.
  291.  
  292.  
  293.  
  294. Create Path mode
  295.  
  296. Select a toolbox icon to start path creation,  then click Select to  place 
  297. the initial point.   Move the line or curve as required,  and click Select 
  298. to place points.  The segment type (line, curve or move) can be changed by 
  299. clicking  on the appropriate toolbox icon;   no more than  one  successive 
  300. move  can be created at a time,  and the path cannot start or end  with  a 
  301. move.  Double-click Select to place the final point.  If one of the closed 
  302. path  tools is chosen,  an additional segment will be placed to close  the 
  303. subpath  when  the path is finished or a new subpath is  started  (with  a 
  304. move).  Click Adjust to remove the last-entered point.
  305.  
  306. When  curves  are  being drawn,  their control points  will  be  initially 
  307. aligned so that the transitions are smooth.
  308.  
  309.  
  310.  
  311. Misc menu
  312.  
  313. Options that don't fit in anywhere else.
  314.  
  315.   File                  Opens a dialogue box giving information about  the 
  316.                         document currently being edited.
  317.  
  318.   Print                 Opens the Print dialogue box, allowing the drawing 
  319.                         to  be  printed  via  a  RiscOS  printer   driver.  
  320.                         Specify  the  number of copies,  ensure  that  the 
  321.                         printer is online and click OK to start printing.
  322.  
  323.   Set bgn'd             Only  available  when  in  Select  mode  and  some 
  324.                         objects are selected.   Moves the selected objects 
  325.                         to  the  back,  and  marks  them  as  unselectable 
  326.                         background;   their position or appearance  cannot 
  327.                         be changed until they are unmarked.   This feature 
  328.                         is  intended for such things as sheet  borders  or 
  329.                         drawing grids,  which are used as a backdrop to  a 
  330.                         drawing on top.
  331.  
  332.                         If some background objects exist already,  the new 
  333.                         objects will be added to that background.
  334.  
  335.                         The  objects that are in background are  saved  in 
  336.                         the drawing file, and will remain so when the file 
  337.                         is loaded again.   However,  if the file is edited 
  338.                         using the original Draw,  this information will be 
  339.                         lost.
  340.  
  341.   Clear bgn'd           Only available when a background is set;   unmarks 
  342.                         all   the  background  objects  and   makes   them 
  343.                         selectable again.
  344.  
  345.  
  346.  
  347. Settings menu
  348.  
  349. These options set operating or display parameters.
  350.  
  351.   Page size             Allows the paper size to be set.   Click on the up 
  352.                         or down arrows to choose from a range of  standard 
  353.                         sizes.  Choose "Portrait" for paper this way up:
  354.  
  355.                                         ÍÊÊÊÊÄ
  356.                                         Â    Â
  357.                                         Â    Â
  358.                                         Â    Â
  359.                                         ÅÊÊÊÊÌ
  360.  
  361.                         or "Landscape" for this way up:
  362.  
  363.                                       ÍÊÊÊÊÊÊÊÊÊÄ
  364.                                       Â         Â
  365.                                       Â         Â
  366.                                       ÅÊÊÊÊÊÊÊÊÊÌ
  367.  
  368.                         Select  the "As printer" option to take the  paper 
  369.                         size  from  the currently loaded  printer  driver;  
  370.                         this  option  is  obviously not  available  if  no 
  371.                         driver is loaded.   If the printer driver size  is 
  372.                         being used, choose "Show limits" to show the paper 
  373.                         margins on the drawing.
  374.  
  375.                         The  paper dimensions are shown in  the  currently 
  376.                         selected units.
  377.  
  378.   Units                 Select "Inches" or "Centimetres" from the menu  as 
  379.                         required.   All  user measurements are  shown  and 
  380.                         input in these units.
  381.  
  382.   Grid                  Sets the screen and lock grids.   In this  version 
  383.                         of Draw,  the grid that drawing is constrained  to 
  384.                         can  be finer (or coarser!) than the grid that  is 
  385.                         shown  on screen.   This gets around  the  problem 
  386.                         that a grid giving the required drawing resolution 
  387.                         cluttered  up the screen and took a long  time  to 
  388.                         redraw at low magnifications in the original.
  389.  
  390.                         The  screen grid setting sets the spacing  of  the 
  391.                         visible dots, in user units.
  392.  
  393.                         The  lock  grid setting specifies how  much  finer 
  394.                         than  the  screen  grid the  lock  grid  is.   For 
  395.                         example,  if the screen grid is set to '1'  (inch) 
  396.                         and the lock grid multiplier to '5', then the lock 
  397.                         grid will be at 0·2" spacing and all drawing  will 
  398.                         be confined to this.
  399.  
  400.                         Choose  the "Show screen grid" option to show  the 
  401.                         screen grid points in the drawing window.  If this 
  402.                         is set, "Auto adjust" can be chosen to coarsen the 
  403.                         grid  at low magnifications,  so that it does  not 
  404.                         overwhelm  the  drawing  or take a  long  time  to 
  405.                         redraw;  note that this affects the screen display 
  406.                         only.
  407.  
  408.                         Choose the "Snap to lock grid" option to constrain 
  409.                         all pointer movements to the lock grid.  When this 
  410.                         is not set, the pointer moves freely.
  411.  
  412.                         Select "Rectangular" or "Isometric" to use a  grid 
  413.                         of that type.  This setting also affects the angle 
  414.                         that  movement  is constrained to  when  Ortho  is 
  415.                         selected.
  416.  
  417.   Zoom                  Standard  'Magnifier' box for setting  the  preset 
  418.                         magnification  that  will be used  when  the  Zoom 
  419.                         button  in the toolbox is selected (this can  also 
  420.                         be opened by clicking Adjust over the button).
  421.  
  422.   Show tools            Choose this to display the toolbox window for that 
  423.                         drawing.  The option is ticked when the toolbox is 
  424.                         open;  to remove the toolbox, use its close icon.
  425.  
  426.   Show XY               Choose  this  to display the position  window  for 
  427.                         that document, showing the position of the pointer 
  428.                         in user coordinates.   (0,0) is at the bottom left 
  429.                         corner of the paper.   To remove the display,  use 
  430.                         the  window's close icon;   the option  is  ticked 
  431.                         when the position display is on.
  432.  
  433.  
  434. Create menu
  435.  
  436. This menu mostly duplicates the toolbox icons.
  437.  
  438.   Line                  Creates a line segment.
  439.  
  440.   Curve                 Creates a curve segment.
  441.  
  442.   Move                  Starts a new subpath.
  443.  
  444.   Auto-close            When  ticked,  closes  subpaths when the  path  is 
  445.                         finished or a new subpath is started.
  446.  
  447.   Box                   Creates a rectangle.
  448.  
  449.   Ellipse               Creates an ellipse.
  450.  
  451.   Text                  Creates a text object.
  452.  
  453.   Polygon               Creates  a regular polygon.   Enter  the  required 
  454.                         number of sides in the entry box leading from this 
  455.                         option.
  456.  
  457.  
  458.  
  459. Select menu
  460.  
  461. Apart from the first,  these options are available when in Select mode and 
  462. an appropriate object or combination of objects is selected.
  463.  
  464.   Select all            Selects  all selectable (i.e.  non-background  and 
  465.                         not font table) objects in the drawing.
  466.  
  467.   Clear                 Unselects the current selection.
  468.  
  469.   Copy                  Makes  a copy of the  selected  objects,  slightly 
  470.                         offset  from the originals.   The  copied  objects 
  471.                         remain at the same 'depth' as the source  objects, 
  472.                         in contrast to the original where they were  added 
  473.                         at the front of the drawing.
  474.  
  475.   Delete                Irretrievably  deletes the selected  objects  from 
  476.                         the drawing.
  477.  
  478.   Front                 Moves  the  selected objects to the front  of  the 
  479.                         drawing,  obscuring any non-selected objects  that 
  480.                         they overlap.
  481.  
  482.   Back                  Moves  the  selected objects to the  back  of  the 
  483.                         drawing, going behind any non-selected objects but 
  484.                         in front of the background if one is set.
  485.  
  486.   Group                 Combines all the selected objects into a group.
  487.  
  488.   Ungroup               Dissolves  the  selected group.   A  single  group 
  489.                         object must be selected;  it reverts to individual 
  490.                         objects.
  491.  
  492.  
  493.  
  494. Arrange menu
  495.  
  496. These options manipulate the selected objects in Select or Edit modes.
  497.  
  498.   Rotate/Skew           Leads to a dual-function dialogue box for entry of 
  499.                         the  required  angle.   "Rotate" rotates  all  the 
  500.                         selected  objects about the centres of  their  own 
  501.                         bounding boxes.  Specify the angle in degrees, and 
  502.                         select "Clockwise" or "Anticlockwise" as required.
  503.  
  504.                         "Skew"   displaces  each  point  of   the   object 
  505.                         horizontally,  a distance depending on the  height 
  506.                         above  or  below the object's centre  (so  squares 
  507.                         turn into parallelograms, etc.).  The limit on the 
  508.                         angle  in this case is ±85° (think about  tangents 
  509.                         of  large  angles  if  you  want  to  know   why):  
  510.                         "Clockwise"  displaces points above the centre  to 
  511.                         the  right and ones below the centre to the  left, 
  512.                         while "Anticlockwise" does the reverse.
  513.  
  514.   Reverse X             Mirrors the selected objects left-to-right.
  515.  
  516.   Reverse Y             Mirrors the selected objects top-to-bottom.
  517.  
  518. Only path objects (and groups containing them) can be rotated,  skewed  or 
  519. mirrored.
  520.  
  521.   Snap to grid          Aligns the selected objects to the lock grid.  For 
  522.                         sprite or text objects,  the bottom left corner is 
  523.                         aligned.  For path objects, each point in the path 
  524.                         is  aligned  to the grid.   This  option  is  only 
  525.                         available whether or not grid lock is enabled.
  526.  
  527.   Alignment             Leads  to  a dialogue box  with  three  functions.  
  528.                         With "Align" selected, the specified point on each 
  529.                         object  is  aligned  to  the  same  point  on  the 
  530.                         leftmost (for horizontal alignment) or lowest (for 
  531.                         vertical   alignment)  object;    both  types   of 
  532.                         alignment can be performed at the same time.
  533.  
  534.                         With "Distribute" selected,  the objects are moved 
  535.                         so  that  the specified points are  spaced  evenly 
  536.                         between same points on the leftmost and  rightmost 
  537.                         (for  horizontal  distribute) or the  highest  and 
  538.                         lowest (for vertical distribute) objects.
  539.  
  540.                         With "Space out" selected,  the objects are  moved 
  541.                         so that the space between the objects is constant, 
  542.                         rather  than the reference points on  the  objects 
  543.                         being spaced equally.   There must be enough  room 
  544.                         between the two extreme objects to fit in all  the 
  545.                         others without overlapping.
  546.  
  547.                         Note  that  Distribute  and  Space out  are   only 
  548.                         available  if three or more objects are  selected.  
  549.                         Horizontal  and vertical distribution  or  spacing 
  550.                         can  be  selected  at  the  same  time,   although 
  551.                         sometimes the results are not quite what would  be 
  552.                         expected.
  553.  
  554.   Scaling               Leads to a dialogue box applying various kinds  of 
  555.                         scaling.   The default is "Magnify":   all  object 
  556.                         dimensions, text point size and line width are all 
  557.                         scaled  by  the entered  factor.   With  "Magnify" 
  558.                         deselected,  "X scale", "Y scale" and "Line width" 
  559.                         can be selected independently;   "X scale" and  "Y 
  560.                         scale"  apply to dimensions and text  point  size, 
  561.                         while "Line width" applies to path outlines.
  562.  
  563.                         The scaling is applied about the object's centre.
  564.  
  565.   Size/Position         Allows the size and positioning of a single object 
  566.                         to be altered.  At most one each of the horizontal 
  567.                         and  vertical  position  and size  fields  can  be 
  568.                         selected and altered.   Changing the left,  right, 
  569.                         top or bottom position moves the object;  changing 
  570.                         width  or  height  scales  the  object  about  its 
  571.                         centre.
  572.  
  573.  
  574.  
  575. Edit menu
  576.  
  577. These options are available when in path edit mode,  and a point has  been 
  578. selected (highlighted).  If the point chosen is the first point in a path, 
  579. only "Coordinate" is available.
  580.  
  581.   Move                  Changes  the current line segment to  a  move,  if 
  582.                         possible.
  583.  
  584.   Line                  Changes the current segment to a line.
  585.  
  586.   Curve                 Changes  the  current  segment  to  a   (initially 
  587.                         straight) curve.
  588.  
  589.   Open                  Makes the current subpath open.  If it was closed, 
  590.                         the  subpath  is opened and the last  point  moved 
  591.                         away from the first.
  592.  
  593.   Closed                Makes the current subpath closed;   the last point 
  594.                         is moved to coincide with the first point.
  595.  
  596.   Insert point          The current segment is replaced with two,  each of 
  597.                         the same type (line or curve) as the original.
  598.  
  599.   Delete point          The  current  segment  is  deleted,  and  the  two 
  600.                         adjacent segments moved to close the gap.
  601.  
  602.   Coordinate            Leads  to a dialogue box allowing the  coordinates 
  603.                         of the current point to be changed.
  604.  
  605.   Straighten            Straightens  the current curve segment  (but  does 
  606.                         not change it into a line).
  607.  
  608.   Smooth joins          Aligns  the  control points of the  current  curve 
  609.                         segment  so that the transitions at the start  and 
  610.                         end points are smooth.
  611.  
  612.   Horizontal            Moves the end point of the current segment so that 
  613.                         the line becomes horizontal.   For a  curve,  this 
  614.                         moves  the end point but leaves the curve  control 
  615.                         points  in the same relation to the curve as  they 
  616.                         were originally.
  617.  
  618.   Vertical              Moves the end point of the current segment so that 
  619.                         the line becomes vertical.
  620.  
  621.  
  622.  
  623. Text Style menu
  624.  
  625. The Text Style menu has two functions.   In Select or Edit modes,  it sets 
  626. the style for the selected text objects or columns.   In text create mode, 
  627. it  sets  the default style that will be used for new text  objects  (only 
  628. when text entry is not in progress).
  629.  
  630.   Font name             Selects  the  font  family to  be  used  for  text 
  631.                         objects.   Unless  you have  some  unusually-named 
  632.                         fonts,  only  the family name (first component  of 
  633.                         the name) will appear on this menu.  See later for 
  634.                         more information on fonts.
  635.  
  636.   Font style            Sets the font enhancement.  Only those options for 
  637.                         which  fonts are available in the  current  family 
  638.                         can be selected.   Not available for 'System Font' 
  639.                         text.
  640.  
  641.   Size/Height           Sets the size of the text,  in points (1/72 inch).  
  642.                         If  "Same as size" is selected,  the  size  chosen 
  643.                         will be used for both width and height and can  be 
  644.                         specified by choosing a preset size or entering it 
  645.                         in the box.   If "Height other" is  selected,  the 
  646.                         width can be set as above while the height can  be 
  647.                         set independently by entering that in its box.
  648.  
  649.   Text colour           Sets  the  foreground colour to be  used  for  the 
  650.                         text;   the 'inside' of the characters is normally 
  651.                         displayed  using  this  colour.   If  the  current 
  652.                         palette  allows,  the  text will  be  anti-aliased 
  653.                         using  a number of steps between this  colour  and 
  654.                         the  text  background  colour.   Text  colour  and 
  655.                         background  colour apply to text areas as well  as 
  656.                         text objects.
  657.  
  658.   Background            Sets the text background colour.  This is normally 
  659.                         white,  but  can  be varied to control  the  anti-
  660.                         aliasing effect.
  661.  
  662.   Leading               Only  available  when the default  text  style  is 
  663.                         being  set;   controls the amount that  the  caret 
  664.                         will  be  moved  down when Return  is  pressed  to 
  665.                         terminate a text object,  ready for the next  one.  
  666.                         This is set in points.
  667.  
  668.  
  669.  
  670. Path Style menu
  671.  
  672. The Path Style menu also has two functions.   In Select or Edit modes,  it 
  673. sets  the style for the selected path objects.   In path create  mode,  it 
  674. sets the default style that will be used for new path objects (this can be 
  675. done while path creation is in progress).
  676.  
  677.   Line colour           Sets  the  colour that will be used to  draw  path 
  678.                         outlines.
  679.  
  680.   Fill colour           Sets  the  colour that will be used  to  fill  the 
  681.                         insides  of  paths  (what  is  considered  to   be 
  682.                         'inside'  is  controlled  by  the   "Winding rule" 
  683.                         option).
  684.  
  685.   Line width            Sets  the width to be used when drawing  outlines, 
  686.                         measured  in points.   Select a  preset  size,  or 
  687.                         enter  the  width  in  the  box.    If  "Thin"  is 
  688.                         selected,  the  thinnest line that the  screen  or 
  689.                         printer is capable of displaying will be used.
  690.  
  691.   Line pattern          Sets  the  line  style to be  used  for  outlines;  
  692.                         either solid or one of four preset dash patterns.
  693.  
  694.   Caps/Joins            Sets  the way in which the ends of open paths  and 
  695.                         line joins are displayed.   The join, starting cap 
  696.                         and ending cap can all be set independently.  Note 
  697.                         that  the  triangle cap width and are  entered  in 
  698.                         multiples of half the line width (i.e.  twice  the 
  699.                         value that the original would require):   this  is 
  700.                         to allow finer control over the width and length.
  701.  
  702.   Winding rule          Controls what is considered to be the 'inside'  of 
  703.                         a path when filling.  See the original Draw manual 
  704.                         for an explanation.
  705.  
  706.  
  707.  
  708. Special menu
  709.  
  710. These options are available in Select and Edit modes,  when an appropriate 
  711. object is selected.
  712.  
  713.   Stroke path           Replaces  the currently selected path with  a  new 
  714.                         one obtained by 'outlining' the outline.   This is 
  715.                         a  bit difficult to explain,  but the  outcome  is 
  716.                         that  filling  the resulting path gives  the  same 
  717.                         appearance as outlining the original path.   Thick 
  718.                         lines  are  therefore converted into  boxes  (with 
  719.                         caps,  arrowheads,  etc.  included).   Filling the 
  720.                         result  with "None" and outlining it in  a  colour 
  721.                         gives  a  new path following the  outline  of  the 
  722.                         original.
  723.  
  724.                         The  best way of finding out what this does is  to 
  725.                         try it.   The results are sometimes not what would 
  726.                         be expected,  due to the peculiarities of the Draw 
  727.                         module.   The  result  is  also  affected  by  the 
  728.                         selected winding rule.
  729.  
  730.   Text to path          Converts the selected text object into a group  of 
  731.                         paths (one for each  character).   Initially,  the 
  732.                         appearance does not change, but the object can now 
  733.                         be  rotated or reversed and the path style  rather 
  734.                         than  the text style applies.   This may not  give 
  735.                         very  good results for small font  sizes,  and  is 
  736.                         only  available  for fonts which  are  defined  as 
  737.                         outlines.
  738.  
  739.   Resize sprite         Resets the bounding box of a sprite object so that 
  740.                         the sprite appears at actual size (i.e.  the  size 
  741.                         that it was set to when it was first loaded).
  742.  
  743.  
  744.  
  745. Keystroke equivalents
  746.  
  747. Any  mouse action in a window causes it to grab the input focus from  then 
  748. on.   The following keystrokes apply to that window,  except when text  is 
  749. being entered or edited:
  750.  
  751.   Control-A             Select all selectable objects
  752.   Control-B             Move selected objects to the back
  753.   Control-C             Copy the selected objects
  754.   Control-F             Move selected objects to the front
  755.   Control-G             Form selected objects into a group
  756.   Control-J             Pop up the "Alignment" dialogue box
  757.   Control-R             Pop up the "Rotate/Skew" dialogue box
  758.   Control-S             Pop up the "Scaling" dialogue box
  759.   Control-U             Ungroup the selected group
  760.   Control-X             Delete the selected objects
  761.   Control-Z             Clear the selection
  762.  
  763.   Print                 Pop up the "Print" dialogue box
  764.  
  765.   f3                    Pop up the "Save drawing" dialogue box
  766.  
  767.   Up,Down,Left,Right    When dragging,  move the pointer by one pixel  (if 
  768.                         grid  lock is off) or one grid step (if grid  lock 
  769.                         is on)
  770.  
  771.   Escape                Abandon an operation in progress
  772.  
  773.  
  774.  
  775. Font Handling
  776.  
  777. AD1½  tries to handle fonts as intelligently as possible.   There are  two 
  778. menus associated with this,  "Font name" and "Font style".   Normally, the 
  779. name menu lists the font family name (the first component of the pathname) 
  780. while the style menu gives the valid styles for that selected family.  The 
  781. following weights are understood:
  782.  
  783.         .Light                          Lighter than normal
  784.         .Book                           Slightly lighter than normal
  785.         .Medium  .Standard              Standard weight
  786.         .Bold                           Darker than normal
  787.         .Heavy                          Much darker than normal
  788.  
  789. and the following slopes:
  790.  
  791.         .Normal  .Roman                 Upright
  792.         .Italic  .Oblique               Slanted
  793.  
  794. which should cover most of the fonts in common use (if a font has only one 
  795. component in its name, standard weight and upright is assumed).  If a font 
  796. is  installed  on the system with an style attribute which is  not  known, 
  797. then  that  attribute will appear on the name menu as a  separate  family.  
  798. For  example,  if  the fonts 'Oxford.Demi'  and  'Oxford.Demi.Italic'  are 
  799. installed (where 'Demi' is not a recognised weight),  they will appear  on 
  800. the name menu as "Oxford-Demi" with "Normal" weight and slopes of  "Roman" 
  801. and "Italic" on the style menu.
  802.  
  803. There  is  a limit of 100 fonts which can be used  (however,  unlike  some 
  804. programs  I  could  name,  AD1½ should not crash if  more  than  this  are 
  805. installed  -  only the first 100 will be used).   If this  limit,  or  the 
  806. styles  which are known about,  causes problems then let me know and  I'll 
  807. change it for the next version.
  808.  
  809.  
  810.  
  811. Bugs, Features and Cautions
  812.  
  813. The  following are the dropoffs,  bugs and omissions that I know about  in 
  814. the current version:
  815.  
  816.   1.    The  little-known  facility  in  the  original  to  directly  copy 
  817.         selected objects between drawings (by using the "Select/Copy" menu 
  818.         option) is not supported.  More than one document at a time can be 
  819.         in Select mode.
  820.  
  821.   2.    Line  pattern  changes are not applied to path objects  which  are 
  822.         members of groups.
  823.  
  824.   3.    Printing of large 'System Font' text (does anybody?) can be a  few 
  825.         pixels out sometimes.   This text,  or sprites,  can sometimes  go 
  826.         very  wrong under certain combinations of screen modes  and  print 
  827.         resolution (I suspect that this is a bug in Acorn's C library).
  828.  
  829.   4.    AD1½ cannot load DXF files in the way that the original version of 
  830.         Draw could.   Use the original to convert DXF files, if you really 
  831.         want to.
  832.  
  833.   5.    The only major facility missing which was present in the  original 
  834.         is the "New view" option to open two windows on the same  drawing. 
  835.         Sorry about this,  but by the time I got around to thinking  about 
  836.         implementing this the fundamental program structure didn't  permit 
  837.         it  to be implemented (too many extensive changes were  required).  
  838.         Anyway,  I never have enough room on my screen for one  view,  let 
  839.         alone two, and switching magnification is much more convenient...
  840.  
  841.   6.    Sometimes  the  pointer shape is not set or reset  correctly  when 
  842.         entering or leaving a window.   If this happens, force a redraw of 
  843.         the screen by pressing f12,  then Return.   There are a number  of 
  844.         anomalies  in  RiscOS's handling of pointer leaving  and  entering 
  845.         events,  which  is  why  the shape change  does  not  always  work 
  846.         properly.
  847.  
  848.   7.    If a drawing with background objects is merged with  another,  the 
  849.         background objects in the merged one lose their background status.
  850.  
  851. Unforeseen   errors   are  sometimes  reported  as   "Internal error"   or 
  852. "Fatal error" and a message.   If you get one of these,  let me know  what 
  853. happened  (in the case of "Fatal" and your masterpiece being  lost,  after 
  854. you've  counted to ten and calmed down) with as much information  on  what 
  855. happened as possible, namely:
  856.  
  857.         Machine type, OS version and memory available
  858.         Version of AD1½ and Shared C Library being used
  859.         Type of monitor and screen mode being used
  860.         What was being done at the time
  861.         Error message or other symptoms
  862.         Whether interactive help was in use
  863.         Is the problem repeatable?
  864.         Is the problem confined to just one drawing?
  865.         Any unusual modules which may be installed (e.g. screen savers)
  866.         If the problem relates to text, details of fonts installed
  867.  
  868.  
  869.  
  870. Finally...
  871.  
  872. I  hope  you like using and are satisfied with AD1½.   If  so,  tell  your 
  873. friends.   If  not,  or  if you have any suggestions for  improvements  or 
  874. suggestions,  please contact me;   I will try to fix bugs and  incorporate 
  875. reasonable ideas in forthcoming versions.
  876.  
  877.  
  878. Standard  boring Copyright Notice:   All program code and the contents  of 
  879. the  supporting files are copyright © myself (Jonathan Marten)  1990.   No 
  880. rights are taken or implied over any drawings or other works which may  be 
  881. produced using this application.
  882.  
  883. ArcDraw 1½  is  "Shareware".   You are free to give  this  application  to 
  884. anyone  you please via any medium,  provided it is delivered with all  the 
  885. supplied files,  unaltered.  If you wish to post it on your bulletin board 
  886. or  include it in your shareware library then that is fine.   You may  not 
  887. sell this application,  except that shareware libraries may make a nominal 
  888. charge to cover disc duplication and postage.
  889.  
  890. You have permission to use any part or the whole application in a  project 
  891. you intend to place in the public domain,  as long as I am fully credited.  
  892. If  you  wish  to  use  this application as part  of  a  system  or  other 
  893. application  that is for sale (for however much and for whatever  reasons) 
  894. or  released as copyright material then my express permission  in  writing 
  895. must be obtained.   I maintain copyright on all the material supplied  and 
  896. reserve the right to amend these conditions in cases of misuse.
  897.  
  898. A great many hours of work have gone into the development and  maintenance 
  899. of this application,  and I would like to keep supporting it.   Although I 
  900. have supplied the application free,  donations will be gratefully received 
  901. (amount  at your discretion).   If you send a blank disc as well,  I  will 
  902. return  it  with any useful PD or my own software that I  may  have  lying 
  903. around.   If you do send something,  you will be notified of any  upgrades 
  904. available (or I will send you the upgrade,  if and when available,  if you 
  905. supply a blank disc for that).
  906.  
  907.  
  908. Disclaimer:   Apart  from  using  their excellent C  compiler  and  RiscOS 
  909. library,  this  application has no connection with Acorn.   Any  confusion 
  910. caused by the use of the term "Draw" or similar is regretted.
  911.  
  912. This software is supplied "as is";   no warranty,  express or implied,  of 
  913. the  merchantability  of this software or its fitness for  any  particular 
  914. purpose is given.   In no circumstances shall any provider or  distributor 
  915. of  this  software  be liable for any damage,  loss  of  profits,  or  any 
  916. indirect or consequential loss arising out of the use of this software  or 
  917. inability to use this software.
  918.  
  919.  
  920. Background:   I  decided to develop this application after  using  Acorn's 
  921. original  Draw  for quite a number of drawings and finding  some  problems 
  922. with  it (none of them serious,  but quite a few of them  annoying).   The 
  923. hardware and software that I used was as follows:
  924.  
  925.         Original '440 with 20Mb hard disc
  926.         Acorn C release 3 compiler, debugger and RiscOS library
  927.         My version of Make (available on NCS Careware disc #1)
  928.         An expanded version of MicroEmacs (originally from David Pilling)
  929.         Some of David Pilling's C Tools (notably 'ctags')
  930.         'Old Faithful' BBC B with Lancaster Kermit, for remote debugging
  931.         Various other tools such as Paint and FormEd
  932.  
  933. Most of the operations have the 'look and feel' of the original Draw,  and 
  934. this was indeed where most of the inspiration came from.  The 'Distribute' 
  935. and  'Space out' facilities and the four-way object handles were  inspired 
  936. by  Macintosh Draw II.   The 'Text to path' facility was inspired by  (but 
  937. not copied from) Data Store's FontFX application, which is recommended for 
  938. achieving even more exotic font effects.   The grid options and appearance 
  939. were copied from Racal-Redac's Visula system.  The font name/style system, 
  940. the background facility, polygon create and the "Skew" option was entirely 
  941. my own work (honest!).  The name is in anticipation of a version 2 of Draw 
  942. being produced by Acorn in the future...
  943.  
  944.  
  945. I can be contacted by or at:
  946.  
  947.         Snail-Mail:     11 Carmarthen Close
  948.                         Farnborough
  949.                         Hampshire
  950.                         GU14 8TJ
  951.  
  952.         Phone:          (0252) 542431 (at reasonable hours)
  953.  
  954.         Email:          jmarten@compulink.co.uk
  955.                         jmarten@cix.UUCP
  956.                         ...!ukc!slxsys!cix!jmarten
  957.  
  958.         Arcade BBS:     387
  959.  
  960.  
  961. Jonathan Marten
  962. July 1990
  963.  
  964.