Chagall Reference  Templates  <F1>        12.5.93
=================================================

   The 'Templates' toolbox serves both for switching 
   between Chagall's various modes (upper part) and for 
   selecting the drawing templates along which the tools 
   can be guided (lower part).

   The various working-modes:

   Paint-mode:
   This is the one you will usually be working in. It 
   allows you to apply all of Chagall's tools
   to modify the current picture. In this mode the
   templates at the bottom of this toolbox are
   selectable.

   Mask-mode:
   This corresponds to the Paint-mode but with the 
   difference that with it one modifies the mask of the 
   current picture and not the picture itself.
   Hence all operations in the Mask-mode apply to the mask, 
   including loading, saving, printing etc. If no mask 
   exists when activating the Mask-mode then Chagall will 
   ask whether it should create a new mask, or load an 
   existing mask from disk.

   Text-mode:
   This icon hides Chagall's Text-mode. This function
   is not yet contained in the basic version, but will be 
   available in future as an add-on module.


   All templates in the 'Templates' toolbox have in
   common the fact that every tool can be led along
   any template. The available templates are:

   Freehand drawing:
   This template is virtually self-explanatory: It permits 
   free movement of the tool with the mouse.

   Rectangle:
   The Rectangle template allows one to draw a rectangle
   when the mouse button is pressed. After releasing the
   button the rectangle will hang on the mouse cursor and 
   can be positioned as desired. A click will lead the
   currently selected tool along the rectangle. If one 
   presses one of the <Shift> keys before this click or 
   clicks with the right mouse button then the function 
   will be aborted, i.e. nothing will be drawn.
   After the tool completes its work the outline rectangle
   re-appears and can either be abandoned by a right mouse
   click or used for drawing a further rectangle.
   The abandoned rectangle will re-appear if you click the
   left button while pressing <Shift> + <Control>. This 
   allows you to draw along the same rectangle with a 
   different tool.

   Circle:
   One can use this template to draw a circle while 
   pressing the mouse button. Further operation is 
   identical to that described for the rectangle.

   Bzier-curve/line:
   The Bzier-curve/line template permits the drawing of
   poly-lines or a polygon that can be made up of lines or 
   Bzier curves.
   A simple mouse click starts or ends a line. For a  
   Bzier-curve one clicks at the start point and draws a 
   tangent line to the pivot point of the curve with a 
   pressed(!) mouse button. There one releases the button, 
   and a curve appears that is anchored at its start point 
   and whose other end can be moved with the mouse. A
   further (long) click sets the end point of the curve. 
   The creation of a poly-line or polygon is completed with 
   a double click when setting the last point. You can turn 
   a set of lines into a closed figure if you press the 
   <Control> key when activating the tool later.
   Further procedure is similar to that described for the 
   rectangle, i.e. after the double click the line or 
   curve-set 'hangs' on the mouse cursor and can be 
   positioned in the window. In addition, the ends of each 
   segment (shown with a cross) or individual curve control 
   points (shown by a small dot) can be moved at this 
   stage by holding down the <Alternate> key. On releasing 
   the <Alternate> key one can move the complete Bzier 
   curve group again. This operation can be aborted with a 
   <Shift> mouse click or a press of the right mouse button.
   A further click leads the current tool along the line; 
   if carried out while pressing the <Control> key a closed 
   figure will be created, as the tool will trace out the 
   drawn lines and then join the end to the start-point. 
   (Note: This won't be shown in the construction outline).
   Once created, a curve can be re-used: proceed exactly as 
   above but at the first click in the window hold down the 
   left <Shift> key together with the <Control> key. If a 
   curve is present it will now be displayed and can be 
   used as if it had been newly created. Thus you can use 
   the same curve in several pictures.
