home *** CD-ROM | disk | FTP | other *** search
/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK5 / WIN_01 / WRIPDM13.ZIP / WINRIP.DOC < prev    next >
Text File  |  1993-08-15  |  50KB  |  1,156 lines
  1.                             WinRIP Lite - Version 1.0.
  2.                              Demonstration Software.
  3.         
  4.  
  5.                           Copyright (c) 1993  K. Waddon
  6.                                All rights reserved.
  7.  
  8.  
  9.  
  10.  
  11.         This version of WinRIP Lite is for DEMONSTRATION purposes only. 
  12.         WinRIP Lite is commercial software NOT shareware. The author does 
  13.         not guarentee that the demostration version of WinRIP Lite is 
  14.         complete nor that it is bug free.
  15.  
  16.         This software may be reproduced and distributed at will as long 
  17.         as no charge is made for providing copies of the software apart 
  18.         from the cost of materials, i.e. diskettes.
  19.  
  20.         This software may be made available for download from any 
  21.         bulletin board system as long as it is available in a directory 
  22.         for which no charge is made for access.
  23.  
  24.         For details on how to order WinRIP Lite, see the file 
  25.         "ORDER.FRM".
  26.  
  27.  
  28.  
  29.  
  30.  
  31.         There are no warranties with respect to this documentation. The 
  32.         information contained within this document is subject to change 
  33.         without notice. WinRIP Lite can be used and/or copied only in 
  34.         accordance with the terms specified. The Author and authorised 
  35.         dealers assumes no responsibilities for errors within the 
  36.         documentation. No part of this guide may be reproduced or 
  37.         transferred in any form or by any means with the written consent 
  38.         of The Author. 
  39.  
  40.         Trademarks. 
  41.         -----------
  42.  
  43.         IBM PC, IBM XT and IBM AT are registered trademarks of 
  44.         International Business Machines Corporation. 
  45.  
  46.         
  47.         
  48.         
  49.         
  50.         INTRODUCTION 
  51.  
  52.         What Do You Need to Use WinRIP Lite? 
  53.  
  54.         In order to use WinRIP Lite, there are certain hardware and 
  55.         software requirements. 
  56.  
  57.         Hardware Requirements 
  58.  
  59.         The following system requirements are applicable when using 
  60.         WinRIP Lite: 
  61.  
  62.                 IBM PC/XT/AT or comatible computer. 
  63.  
  64.                 Colour Graphic Display (VGA), with appropriate video card. 
  65.  
  66.  
  67.  
  68.         Software Requirements 
  69.  
  70.                 Microsoft Windows 3.1 
  71.  
  72.  
  73.  
  74.         About This Manual 
  75.  
  76.         This manual is meant to be a guide to using WinRIP Lite. It will 
  77.         not explain all the features of Microsoft Windows. For 
  78.         information concerning Windows you may need to refer to the 
  79.         documentation supplied by Microsoft with your copy of Windows 
  80.         3.1. 
  81.  
  82.  
  83.  
  84.         Windows Annomalies.
  85.         -------------------
  86.  
  87.         The is one feature of provided by the RIPscrip Specification that 
  88.         is not available in WinRIP. This is user defined line styles. 
  89.         Windows does not provide a method of defining line styles apart 
  90.         from those provided as standard within Windows. The 'standard' 
  91.         line styles available with RIPaint ARE available with WinRIP.
  92.  
  93.         Flood Fill Problems.
  94.          
  95.         Some RIP images create with editors other than WinRIP can cause 
  96.         problems with flood fill. This is caused by the line termination 
  97.         method used by windows.
  98.  
  99.         Windows 'rounds' the end of a line, whereas RIPaint and other 
  100.         editors tend to 'chop' the line. Therefore some images may not 
  101.         flood fill correctly if they were not created using WinRIP.
  102.  
  103.         THIS IS ONLY A PROBLEM WITH LINES THAT ARE 3 PIXELS THICK.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.         INSTALLATION.
  111.         
  112.         Before you make use of the WinRIP Lite Demonstration Software, 
  113.         you must first install it on your system.
  114.  
  115.         Fistrly, you should create a directory on your hard disk into 
  116.         which the contents of WRIPDEMO.ZIP should be unpacked. We suggest 
  117.         for simplicities sake that you call this directory WINRIP.
  118.  
  119.         You must now create several sub-directories in the WINRIP 
  120.         directory, these are:
  121.  
  122.                                 WINRIP\RIP
  123.                                 WINRIP\ICONS
  124.                                 WINRIP\BUTTONS
  125.                                 WINRIP\PATTERNS
  126.  
  127.         These are the default directories where WinRIP will expect to 
  128.         find RIP Image, RIP Icons, Button Styles and Fill Patterns 
  129.         respectively.
  130.  
  131.         Present in the WINRIP directory you will find three Windows 
  132.         TrueType Font Files, these are:
  133.  
  134.                                 SANS.TTF
  135.                                 GOTHIC.TTF
  136.                                 TRIPLEX.TTF
  137.  
  138.         You will need to install these fonts into Windows. To do this you 
  139.         will need to use the 'Control Panel' utility (Normally found in 
  140.         the 'Main' window of the Windows Desktop. Select Fonts from the 
  141.         Control Panel and use the 'ADD' option to select and install the 
  142.         three fonts.
  143.  
  144.         Thats all that is necessary to install the Demonstration Version 
  145.         of WinRIP Lite.
  146.  
  147.         The commercial version of WinRIP Lite has an installation utility 
  148.         that will install WinRIP for you.
  149.  
  150.  
  151.         The Editing Window.
  152.         -------------------
  153.  
  154.         Before you can perform any drawing with WinRIP Lite, you need to 
  155.         have an editing window open. This can be accomplished in two 
  156.         ways, either create a new picture, in which case a blank editing 
  157.         window is opened , or load an existing picture for editing. To 
  158.         create a new RIP image select the "New Picture" option from the 
  159.         pop-up File menu. To load an existing picture, select the "Load 
  160.         Picture" option from the pop-up File menu. 
  161.  
  162.         When loading an existing RIP picture, a dialog box will be opened 
  163.         containing directory list and file list boxes. This will enable 
  164.         you to select the picture file that is to be loaded. 
  165.  
  166.         In both cases an editing window is created which will measure 640 
  167.         x 350 pixels and will be given a black background. Once the 
  168.         editing window has been created the Toolbox Window will become 
  169.         active, as will the greyed items on the pull down menus. You will 
  170.         notice however that the "Load Picture" and "New Picture" options 
  171.         on the File menu are now greyed. This is because you can only 
  172.         have one RIP image open at any one time. 
  173.  
  174.  
  175.         The Main Menu Bar.
  176.         ------------------
  177.  
  178.         The Main Menu Bar along the top of the main window, contains 
  179.         several options, each of which will be explained in this section. 
  180.  
  181.         The Edit Menu.
  182.         --------------
  183.  
  184.         There are two entries on this menu, the UNDO facility erases the 
  185.         last drawing action. Once an action is "undone" it cannot be 
  186.         reinstated. The "Redraw Image" option simply clears the edit 
  187.         window and redraws the stored picture. This is useful if you want 
  188.         to see how the picture will be drawn at the remote terminal. 
  189.  
  190.         
  191.         The Icon Menu. 
  192.         --------------
  193.  
  194.         This menu, like the Edit Menu, only has two entries. The "Icon 
  195.         Editor" option loads the Icon Editor Utility so that you can 
  196.         create new icons and edit existing ones. 
  197.  
  198.         The "Load Icon" option allows you to load an icon for pasting 
  199.         onto your picture. When this option is selected a File Open 
  200.         dialog Box will be displayed containing Files List, Directory 
  201.         List and File Type boxes. The file type box displayed beneath the 
  202.         file list box has two files types specified, *.ICN and *.ICO. The 
  203.         .ICN file type is an icon stored in RIP format, the .ICO file 
  204.         type refers to Windows Icon format. WinRIP Lite is capable of 
  205.         importing and converting Windows Icons. 
  206.  
  207.         If you decide to load a Windows Icon, a message box will be 
  208.         displayed asking you if you wish to save the Icon in RIP format. 
  209.         If you respond by clicking the "Yes" button you will be presented 
  210.         with a File Dialog Box so you can specify which directory and 
  211.         file name is to be used to save the icon. 
  212.  
  213.         A rectangle, the exact size of the icon, will be displayed near 
  214.         the top right hand corner of the edit window. This rectangle may 
  215.         be moved to the position where the icon is to be pasted by moving 
  216.         the mouse pointer (which is changed to a hand in drag mode) into 
  217.         the rectangle, holding down the left hand mouse button and 
  218.         dragging the rectangle to the required position. Once the icon is 
  219.         in the desired position you can paste it onto your picture by 
  220.         clicking the right hand mouse button. 
  221.  
  222.         
  223.         The Fill Menu. 
  224.         --------------
  225.  
  226.         The Fill menu contains five entries all relating to the Fill 
  227.         Colour, Fill Pattern and Fill Boarder Colours. 
  228.  
  229.         Fill Toggle On/Off.
  230.         ------------------- 
  231.  
  232.         This option is a checked item, this means that selecting it does 
  233.         nothing more than placing a 'tick' against it. However, what 
  234.         selecting this actually does is to cause solid shapes, i.e. 
  235.         circles, rectangles, polygons etc to be automatically filled with 
  236.         the current fill colour and pattern. 
  237.  
  238.         Fill Border Colour.
  239.         -------------------
  240.  
  241.         Selecting this option from the Fill menu causes a window to be 
  242.         displayed showing the 16 colours in the currently active palette. 
  243.         From these colours you may select one to be the current Fill 
  244.         Border. This is used by the Flood Fill Tool when flood filling an 
  245.         area of the image. The flood fill will stop at the border colour. 
  246.         Clicking "Cancel" leave the border colour selection unchanged. 
  247.  
  248.  
  249.  
  250.         Fill  Pattern & Colour. 
  251.         -----------------------
  252.  
  253.         Selecting this option from the Fill menu causes a window to be 
  254.         opened containing two sets of controls. The large set of buttons 
  255.         represent the 12 standard fill patterns that may be selected. The 
  256.         colours arranged as two rows of eight are the 16 colours of the 
  257.         currently active palette. To select a Fill Pattern simply click 
  258.         on the desired pattern. You will notice that the large rectangle 
  259.         opposite the OK and CANCEL buttons will be filled with the 
  260.         selected pattern. To select the Fill Colour simply click on the 
  261.         desired colour. Clicking on the CANCEL button will restore the 
  262.         Fill Pattern and Colour to their previous state. 
  263.  
  264.  
  265.  
  266.         Fill Pattern Editor.
  267.         --------------------
  268.  
  269.         This option calls up the Pattern Editor, which allow you to 
  270.         create your own customised fill patterns. The Pattern Editor has 
  271.         two rectangular areas displayed side by side. The left hand 
  272.         rectangle represents an 8 x 8 pixel area in which the pixel are 
  273.         greatly enlarged. The right hand rectangle is used to display the 
  274.         effects of your editing, i.e. the rectangle will be filled with 
  275.         the pattern that you create so that you can see the effects your 
  276.         fill pattern will produce. 
  277.  
  278.         Button/Mouse. 
  279.         -------------
  280.  
  281.         This menu contains one entry, Button Designer. This is dealt with 
  282.         later in a separate section so won't be gone into here. 
  283.  
  284.         Options Menu. 
  285.         -------------
  286.  
  287.         This menu, with the exception of the Object Lister, contain 
  288.         options concerned with the drawing tools. 
  289.  
  290.         Write Mode Option.
  291.         ------------------
  292.  
  293.         This calls up another pop-up menu which has two items on it, 
  294.         "Normal" and "XOR". These two drawing modes effect how objects 
  295.         are drawn on the screen. In "Normal Mode" objects are draw in the 
  296.         currently selected draw colour. In "XOR Mode" the object is drawn 
  297.         on the screen by XORing the current draw colour with the colour 
  298.         already on the screen. A "tick" will be displayed against the 
  299.         currently active mode.
  300.  
  301.  
  302.         Line Thickness Option.
  303.         ----------------------
  304.  
  305.         This allows you to select the width of lines drawn on the screen, 
  306.         this also includes the thickness of boundaries of circles, 
  307.         polygons etc. Two options are available, line thickness of 1 
  308.         pixel and line thickness of 3 pixels. 
  309.  
  310.         Bezier Curve Smoothness Option.
  311.         -------------------------------
  312.  
  313.         A Bezier Curve is made up of several straight lines, obviously 
  314.         the smoothness of the curve is determined by the number of 
  315.         straight line segments that make up the curve. This option allows 
  316.         you to specify the number of segments that should be present in 
  317.         any Bezier Curve that you draw. The default is ten line segments, 
  318.         that is, each Bezier Curve will be made up of ten straight lines. 
  319.         The higher the value specified here the smoother the curve will 
  320.         appear on the screen. 
  321.  
  322.         Note, Bezier Curves are calculated using floating point 
  323.         arithmetic, the greater the number of segments in the curve the 
  324.         slower the processing will be. 
  325.  
  326.         Object List Option.
  327.         -------------------
  328.  
  329.         Not Active.
  330.  
  331.  
  332.         Font Menu. 
  333.         ----------
  334.  
  335.         The Font Menu allows you to select a Font Typeface and font Size. 
  336.  
  337.         Font Style Option.
  338.         ------------------
  339.         
  340.         This causes another pop-up menu to be displayed listing the 
  341.         available Font Styles. Select the style of font you require from 
  342.         this list. The currently selected font will have a "tick" 
  343.         displayed next to it. 
  344.  
  345.         Font Size Options.
  346.         ------------------
  347.  
  348.         These options allow you to select the size of the current font. 
  349.         Entries consist of a series of magnification factors, 1x, 2x ... 
  350.         10x. Select the font size you require. A "tick" will be displayed 
  351.         next to the current font size. 
  352.  
  353.         Applicable Drawing Controls.
  354.         ----------------------------
  355.  
  356.         In the next section the drawing tools are discussed in detail. 
  357.         With each drawing tool there is listed the "Applicable Drawing 
  358.         Controls". These mean that these options are used with that 
  359.         particular drawing tool and effect the display. These controls 
  360.         are: 
  361.  
  362.                        The Current Drawing Colour. 
  363.                        The Current Line Pattern. 
  364.                        The Current Line Thickness. 
  365.                        The Current Fill Colour. 
  366.                        The Current Fill Pattern. 
  367.                        The Write Mode. 
  368.                        The Font Size. 
  369.  
  370.         
  371.  
  372.         The Toolbox.
  373.         ------------
  374.         
  375.         The Toolbox contains all the drawing tools  needed to create a 
  376.         "RIP" image. Note that the toolbox is inactive while there is no 
  377.         editing window open. 
  378.  
  379.         The tools, listed from left to right, top to bottom are: 
  380.  
  381.  
  382.                           Pie Slice 
  383.                           Line Draw 
  384.                           Set Pixel 
  385.                           Hollow Rectangle 
  386.                           Filled Rectangle 
  387.                           Hollow Circle 
  388.                           Filled Ellipse 
  389.                           Circular Arc 
  390.                           Elliptical Arc 
  391.                           Hollow Polygon 
  392.                           Bezier Curve 
  393.                           Mouse Region 
  394.                           Flood Fill 
  395.                           Text Input 
  396.                           Filled Rectangle 
  397.                           Create Button 
  398.  
  399.         
  400.         The block of 16 colours at the bottom of the Toolbox show the 16 
  401.         currently active drawing colours,  i.e. the current active colour 
  402.         palette. The currently active drawing colour may be changed by 
  403.         clicking on one of these colours. Each of the drawing tools 
  404.         available in the Toolbox will now be discussed in detail. 
  405.  
  406.         
  407.         Pie Slice. 
  408.         ----------
  409.  
  410.         This tool allows you to draw a pie slice,  it will be filled with 
  411.         the current fill colour and pattern. To draw the pie slice move 
  412.         the mouse pointer to the point where you require the center of 
  413.         the arc to be. Hold down the left hand mouse button and without 
  414.         releasing the left hand mouse button, move the mouse pointer to 
  415.         position where the arc is to start, then release the left hand 
  416.         mouse button.  As you move the mouse pointer out from the center 
  417.         a line will be 'rubber banded' to follow the mouse pointer, 
  418.         giving an indication of the boundary of the arc. This line will 
  419.         form the radius of the arc. Next, hold down the left hand mouse 
  420.         button again and move the mouse pointer to the position at which 
  421.         the arc is to end and release the left hand mouse button, WinRIP 
  422.         Lite will then erase the 'rubber banding' lines and draw the pie 
  423.         slice. 
  424.  
  425.  
  426.  
  427.         Applicable Drawing Controls:
  428.         Draw Colour, Line Thickness, Fill Colour, Fill Pattern.
  429.  
  430.  
  431.  
  432.         Draw a Straight Line. 
  433.         ---------------------
  434.  
  435.         This tool allows you to draw a straight line, in the current 
  436.         drawing colour and line thickness. To draw a line move the mouse 
  437.         pointer to the position at which the line is to start and click 
  438.         the left hand mouse button. Move the mouse pointer to the 
  439.         position at which the line is to end. A 'rubber banding' line 
  440.         will be drawn from the line start position to the mouse pointer 
  441.         as it is moved. When the mouse pointer is at the point at which 
  442.         you want to end the line, click the left hand mouse button. 
  443.         WinRIP Lite will then draw a permanent line from the start point 
  444.         to the end point. 
  445.  
  446.         Applicable Drawing Controls:
  447.         Draw Colour, Line Pattern, Line Thickness, Write Mode. 
  448.  
  449.         
  450.         Set Individual Pixel. 
  451.         ---------------------
  452.  
  453.         This tool sets an individual pixel to the current drawing colour. 
  454.         Move the mouse point to the position of the pixel you wish to set 
  455.         and click the left hand mouse button. 
  456.  
  457.         Applicable Drawing Controls:
  458.         Draw Colour 
  459.  
  460.  
  461.  
  462.         Rectangle.
  463.         ----------
  464.  
  465.         This tool will allow you to draw a rectangle in the current 
  466.         drawing colour and line style. Move the mouse pointer to the top 
  467.         left hand corner position where you want the rectangle to start 
  468.         and click the left hand mouse button. Now move the mouse pointer 
  469.         to the position where you require the bottom right hand corner of 
  470.         the rectangle. A rectangle will be 'rubber banded' whilst you are 
  471.         moving mouse pointer. When the mouse pointer is positioned 
  472.         correctly click the right hand mouse button and WinRIP Lite will 
  473.         erase the 'rubber banded' rectangle and redraw it permanently. 
  474.  
  475.         Applicable Drawing Controls:
  476.         Draw Colour, Line Pattern, Write Mode. 
  477.  
  478.         
  479.         Filled Rectangle. 
  480.         -----------------
  481.  
  482.         This tool draws a rectangle that is filled with the current fill 
  483.         colour and pattern. You define the rectangle in exactly the same 
  484.         way as for the RECTANGLE tool described above. Note the rectangle 
  485.         will not be drawn with a border. 
  486.  
  487.         Applicable Drawing Controls:
  488.         Fill Colour, Fill Pattern.
  489.  
  490.         
  491.         Circle.
  492.         -------
  493.  
  494.         This tool draws a circle in the current draw colour and line 
  495.         thickness. Move the mouse pointer to the point which is to be the 
  496.         center of the circle and click the left and mouse button. Move 
  497.         the cursor away from the center point and a circle will be 
  498.         'rubber banded' as you move the mouse. When the circle is the 
  499.         correct size, click the left hand mouse button to fix the circle. 
  500.  
  501.         Applicable Drawing Controls:
  502.         Draw Colour, Line Thickness.
  503.  
  504.  
  505.         Filled Ellipse. 
  506.         ---------------
  507.  
  508.         This tool draws a complete ellipse in the current drawing colour 
  509.         and fills the interior with the current fill colour and  pattern. 
  510.         The method for drawing the ellipse is the same as for the circle 
  511.         above. 
  512.  
  513.         Applicable Drawing Controls:
  514.         Draw Colour, Line Thickness, Fill Colour, Fill Pattern. 
  515.  
  516.         
  517.         Circular Arc. 
  518.         -------------
  519.  
  520.         This tool draws a circular arc in the current drawing colour and 
  521.         line thickness. To draw the arc, move the mouse pointer to the 
  522.         position which is to be the center of the arc. Hold down the left 
  523.         mouse button and move the mouse pointer to the position where you 
  524.         wish the arc to start and release mouse button. Hold down the 
  525.         left mouse button and move the mouse pointer to the position at 
  526.         which the arc is to end. Release the mouse button. The arc will 
  527.         now be drawn. 
  528.  
  529.         Applicable Drawing Controls:
  530.         Draw Colour, Line Thickness.
  531.  
  532.         
  533.         Elliptical Arc. 
  534.         ---------------
  535.         
  536.         This tool draws an elliptical arc in the current drawing colour 
  537.         and line thickness. The arc is drawn within a rectangular 
  538.         'bounding box' which would contain the entire ellipse (if one 
  539.         were being drawn). The first step in drawing the arc is to define 
  540.         the bounding box, to do this move the mouse pointer to the 
  541.         position at which the top left hand corner is to be positioned. 
  542.         Click the left hand mouse button. Next move the mouse pointer to 
  543.         the position at which the bottom right hand corner of the 
  544.         bounding box is to be positioned and click the left hand mouse 
  545.         button. The 'rubber banded' bounding box will now be erased, and 
  546.         a line will be drawn from the center point of the imaginary 
  547.         ellipse to the mouse pointer. This line may be moved and defines 
  548.         the point at which the arc will start. Hold down the left hand 
  549.         mouse button and position the mouse pointer at the point at which 
  550.         the arc is to end. Release the mouse button and the arc will be 
  551.         drawn. 
  552.  
  553.         Applicable Drawing Controls:
  554.         Drawing Colour, Line Thickness.
  555.  
  556.  
  557.  
  558.         Polygon. 
  559.         --------
  560.  
  561.         This tool will draw a multi-sided closed polygon in the current 
  562.         drawing colour, line thickness and line pattern. Move the mouse 
  563.         pointer to the position where the polygon is to start and click 
  564.         the left hand mouse button.  Repeat this procedure for each point 
  565.         in the polygon. As  you move the mouse pointer the polygon will 
  566.         be drawn in and 'rubber banding' lines will be used to connect 
  567.         the mouse pointer to the last and first  points defined. To 
  568.         terminate the polygon click the right hand mouse button. 
  569.  
  570.  
  571.  
  572.         Applicable Drawing Controls:
  573.         Drawing Colour, Line Thickness, Line Pattern.
  574.  
  575.         
  576.         Bezier Curve.
  577.         -------------
  578.  
  579.         This tool allows you to draw customisable curves. Four control 
  580.         points are used to create the path that the curve follows. Two of 
  581.         these control points define the start and end points of the curve 
  582.         and the curve will actually touch these two points. The remaining 
  583.         two point are control points which 'pull' the curve away from the 
  584.         straight line defined by the start and end points. These two 
  585.         control points need not be actually on the curve. 
  586.  
  587.         To draw a curve, move the mouse pointer to the position at which 
  588.         the curve is to start and click the left hand mouse button. A 
  589.         small square point will be drawn. In actual fact this represents 
  590.         all four control points of the curve, one on top of the other. 
  591.         The order in which WinRIP Lite considers these points to be 
  592.         stacked, from top to bottom is the end point, 2nd control point, 
  593.         1st control point, start point. 
  594.  
  595.         To define the end point of the curve, move the mouse pointer over 
  596.         the square control marker, hold down the left hand mouse button 
  597.         and drag the control point to the position at which the curve is 
  598.         to end. Release the mouse pointer. A 'rubber banding' line will 
  599.         be drawn from the start point to the end point, and the curve 
  600.         will also be drawn, which should resemble a straight line. The 
  601.         square control marker at the start point will have been erased. 
  602.  
  603.         To move the 2nd control point, move the move pointer to the start 
  604.         position of the curve (easily found because of the 'rubber 
  605.         banding' line and hold down the left hand mouse pointer. The 
  606.         square control marker will be re drawn and it may be dragged to 
  607.         the position you require. Release the mouse button. You will now 
  608.         notice that the curve has changed shape. Repeat this procedure to 
  609.         position the 1st control point. 
  610.  
  611.         Once you have separated the four control markers you may adjust 
  612.         their relative positions by positioning the mouse pointer on a 
  613.         control point and dragging it to the desired position. 
  614.  
  615.         When you are happy with the shape of the curve, click the right 
  616.         hand mouse button to erase the control markers, the rubber 
  617.         banding lines and to make the curve permanent. 
  618.  
  619.         The 'smoothness' of the curve, which is made up of n segments of 
  620.         straight lines may be set from the by pulling down the Options 
  621.         menu from the menu bar. 
  622.  
  623.         Applicable Drawing Controls:
  624.         Draw Colour, Line Pattern, Line Thickness, Write Mode.
  625.  
  626.  
  627.         Mouse Region.
  628.         -------------
  629.  
  630.         This tool allows you to define a  rectangular area on the screen 
  631.         that functions as a "HOT" mouse region. If the user clicks the 
  632.         left mouse button while the mouse pointer is within the mouse 
  633.         region then terminal will transmit a predefined text string to 
  634.         the host. The rectangle is drawn using the same procedure for 
  635.         drawing a Rectangle (defined above). When the drawing of the 
  636.         rectangle is complete a dialog box ( shown below) is displayed so 
  637.         that you may enter the text that is to be sent to the host when 
  638.         this region is clicked. 
  639.  
  640.         The text entered into the dialog box above may contain control 
  641.         characters where each control character is represented by an 
  642.         ASCII character preceded by a ^ character, i.e. a 'RETURN' 
  643.         character may be entered as ^M. 
  644.  
  645.         The two other fields in the dialog box are checkboxes and if 
  646.         checked will have the following actions if they are checked: 
  647.  
  648.             
  649.             Invert the image when this region is clicked. 
  650.             
  651.             Indicates that the region should be visibly inverted while 
  652.             the mouse button is down, offering the user visual feedback 
  653.             that the region has been clicked. 
  654.  
  655.  
  656.  
  657.             Reset all windows and clear the screen after this region is 
  658.             clicked. 
  659.  
  660.             This will physically zoom the text window to full screen size 
  661.             and clear the screen. This is useful if the text instructs 
  662.             the host to enter an area that does not support RIP Graphics. 
  663.  
  664.  
  665.         Flood Fill.
  666.         -----------
  667.  
  668.         This tool is used to flood fill a region with a specific colour 
  669.         and pattern. Move the mouse pointer to a point within the area to 
  670.         be flood filled and click the left hand mouse button. The area 
  671.         will will be upto the border colour, at which point the operation 
  672.         terminates. Fill colour, pattern and border colour are selected 
  673.         by pulling down the Fill menu on the menu bar. 
  674.  
  675.         Applicable Drawing Controls:
  676.         Fill Colour, Fill Pattern.
  677.  
  678.         
  679.         Text Entry.
  680.         -----------
  681.  
  682.         This tool allows you to enter text into your RIP image in the 
  683.         current draw colour and font. Move the mouse pointer to the 
  684.         position where the text is to be placed and click the left hand 
  685.         mouse button. The dialog box shown below will be opened so that 
  686.         you can enter the required line of text. 
  687.  
  688.         The text entry area is larger than one line of text, this is for 
  689.         future developments to WinRIP Lite. You may only enter one line 
  690.         of text at present. 
  691.  
  692.         On clicking the OK button, the dialog box will clear and a 
  693.         bounding rectangle displayed, this bounding rectangle may be 
  694.         dragged to the required position and then the right hand mouse 
  695.         button clicked to paste the text. The text is output in the 
  696.         currently selected font and size. To change the font style and 
  697.         font size use the Font option on the menu bar. 
  698.  
  699.         Applicable Drawing Controls:
  700.         Draw Colour, Write Mode.
  701.  
  702.  
  703.         Filled Polygon. 
  704.         ---------------
  705.  
  706.         This tool is identical to the Polygon tool described above with 
  707.         the exception that the interior of the polygon is filled with the 
  708.         current fill colour and pattern. 
  709.         
  710.         Applicable Drawing Controls:
  711.         Draw Colour, Line Style, Line Thickness, Fill Colour, 
  712.         Fill Pattern, Write mode. 
  713.  
  714.         
  715.         Define a Button. 
  716.         ----------------
  717.  
  718.         This tool creates a new mouse button in the style currently 
  719.         defined in the Button Designer. As the operation of this tool is 
  720.         closely linked with the Button Designer you are strongly 
  721.         recommended to read the section entitled "The Button Designer" 
  722.         prior to using this tool. 
  723.  
  724.         To create the button move the mouse pointer to the upper left 
  725.         hand corner of where the button is to be positioned and click the 
  726.         left hand mouse button. Note that this may not be the actual top 
  727.         left hand corner of the button as any bevel, recess and sunken 
  728.         effects are not taken into account at this stage. The dialog box, 
  729.         shown below will be opened so that you can specify the Button 
  730.         Label, the text to be sent to the host etc, when the button is 
  731.         clicked. 
  732.  
  733.         The button label is the text that is displayed with the button, 
  734.         exactly how this label is positioned relative to the button 
  735.         itself is dependent on settings in the button style. 
  736.  
  737.         The 'Hot' Key defines a  key on the keyboard which if pressed has 
  738.         the same effect as if the button was clicked using the mouse. 
  739.  
  740.         The text to send to the host is simply the text that the terminal 
  741.         will send to the host system when the button is clicked. 
  742.  
  743.         The 'Draw button as already selected' if checked means that the 
  744.         button will be drawn as if it had been clicked. 
  745.  
  746.         The default if <<ENTER>> is pressed, if checked, means that if 
  747.         the user presses <<ENTER>> then the text associated with this 
  748.         button is sent to the host in response. 
  749.  
  750.         Once you have clicked on the dialog box's OK button and the 
  751.         dialog box cleared from the screen, the button can be drawn.  
  752.         This is carried out in one of two ways. For a button with a 
  753.         predefined width and height, a rectangle will be drawn on the 
  754.         screen representing the button surface. This rectangle may be 
  755.         dragged to the required position and the right hand mouse button 
  756.         clicked to paste the actual button. 
  757.  
  758.         If no width and height has been specified in button style, the 
  759.         button is sized by a 'rubber banding' rectangle. Once the 
  760.         rectangle is the correct size etc. click the left hand mouse 
  761.         button to create the button. 
  762.  
  763.  
  764.         Applicable Drawing Controls:
  765.         Font Sizes.
  766.  
  767.         The Button Designer.
  768.         --------------------
  769.  
  770.         Although The Button Designer comprises only of one window, it is 
  771.         complicated and significant enough to warrant a section all to 
  772.         itself! 
  773.  
  774.         The Button Designer does not do anything visibly on the screen, 
  775.         except display the window shown overleaf, but creates an internal 
  776.         template definition for a button, which is used in conjunction 
  777.         with the Button Drawing Tool to actually create buttons. 
  778.  
  779.         Button Types.
  780.         -------------
  781.  
  782.         There are only three main types of buttons, these are Plain, Icon 
  783.         and Clipboard Buttons. The "Button Type" is selected by clicking 
  784.         one of the Radio Buttons in the Button Type box at the top left 
  785.         hand corner of the Button Designer Window. You will notice that 
  786.         only one Button Type may be selected, this is because only one of 
  787.         Button Type may be in use at any one time. 
  788.  
  789.         Plain Buttons.
  790.         -------------- 
  791.  
  792.         A plain button is exactly what it says it is, "plain". A plain 
  793.         button does not use an icon in the image of the button. The 
  794.         button is constructed as a 'coloured' box, the colour of which 
  795.         corresponds to the SURFACE colour specified in the Button 
  796.         Designer window. (See below for details of the Surface colour. 
  797.  
  798.         Special effects may also use the "Special Effects" (described 
  799.         below) to enhance the image of the button. 
  800.  
  801.         Plain buttons may be of any size, or they can be of fixed size. 
  802.  
  803.  
  804.         Clipboard Buttons.
  805.         ------------------ 
  806.  
  807.         A Clipboard Button uses the current contents of the clipboard to 
  808.         provide the button image. This means you could use an image that 
  809.         you have previously loaded into the clipboard as a button, and 
  810.         keep reusing it. This method improves transmission efficiency by 
  811.         not having to keep on transmitting an icon file name etc. 
  812.  
  813.         Icon Buttons.
  814.         ------------- 
  815.  
  816.         An Icon Button uses a specified icon for it's image. When you 
  817.         create a button using the Button Tool, you will be expected to 
  818.         provide the icon file which is to be used as the button image. 
  819.         This will be the normal file open dialog box, you may use both 
  820.         RIP format Icons and Windows Icons as the button image. The icon 
  821.         specified will determine the actual size of the button and you 
  822.         may drag it to any position you desire. The rectangular mouse 
  823.         field drawn to represent the icon for 'dragging' purposes is 
  824.         exactly the size of the icon to aid you in accurate positioning. 
  825.  
  826.         Button Labels.
  827.         -------------- 
  828.  
  829.         Every button can have an optional text label which can appear in 
  830.         one of several different locations relative to the button itself. 
  831.         It's purpose is to inform the user of the function of the button. 
  832.         The actual text of the label is not specified in the Button 
  833.         Designer but when the button is actually created. However, the 
  834.         placement of the label is specified in the Button Designer window 
  835.         by clicking one of the radio buttons in the Label Orientation 
  836.         Group. This specifies where the label is to appear relative to 
  837.         the button and may be one of the following: 
  838.  
  839.              i)   Label text positioned above the button.
  840.             ii)   Label text positioned below the button.
  841.            iii)   Label text positioned to the right of the button.
  842.             iv)   Label text positioned to the left of the button.
  843.              v)   Label text positioned centrally within the button.
  844.  
  845.  
  846.         Label Colour (Foreground). 
  847.         --------------------------
  848.  
  849.         The colour of the label text may be selected by clicking on the 
  850.         Foreground button in the Button Designer Window. This will pop-up 
  851.         a Colour Dialog box from which you can choose on of 16 colours 
  852.         from the currently active palette. The colour chosen will also be 
  853.         used to colour the 'Foreground Button' in the Button Designer 
  854.         window, so that you can see immediately the current selected 
  855.         colour.
  856.         
  857.         DropShadow Effect. 
  858.         ------------------
  859.  
  860.         You may also specify that the Dropshadow special effect is to be 
  861.         used with the label. You do this by 'checking' the Dropshadow 
  862.         Checkbox in the Button Designer Window and by specifying the 
  863.         colour of the shadow by changing the colour of the 'Background' 
  864.         button.  This effect will first write the label text using the 
  865.         Background colour, but offset 1 pixel above and to the left of 
  866.         the 'normal' label position. Next the label text is displayed 
  867.         again, this time in the 'normal' position and using the 
  868.         Foreground colour. The overall effect of this option is to give 
  869.         the impression that the label is floating just above the screen 
  870.         and is casting a shadow. 
  871.  
  872.         Text Centering Adjustment. 
  873.         --------------------------
  874.  
  875.         Where the Label Orientation has been specified as either LEFT, 
  876.         RIGHT or CENTER, the label will be centered vertically relative 
  877.         to the button so that the text does look like it's "too low" or 
  878.         "too high". 
  879.  
  880.         In some situation though, in particular with large fonts you may 
  881.         notice that text centering is not quite right. This may be more 
  882.         evident with text with descenders. 
  883.  
  884.         Note, this situation cannot occur within WinRIP Lite as the 
  885.         descenders ARE taken into account when centering the text 
  886.         vertically, as is the Internal Leading. However, you must be 
  887.         aware that programs such as RIPaint and RIPterm DO NOT take into 
  888.         account the descenders when vertically centering text. 
  889.  
  890.         The Adj Text, should therefore be 'checked' where you are using 
  891.         text for the label that has descenders to ensure that the text is 
  892.         centered correctly in RIPterm. This option has no effect within 
  893.         WinRIP Lite. 
  894.  
  895.         
  896.         Hot Key Underlining. 
  897.         --------------------
  898.  
  899.         If you have specified that this button is a "Mouse Area", then 
  900.         you have the option of underlining the hotkey in the label text 
  901.         (if the hotkey character occurs in the label). This is used to 
  902.         indicate visually to the user, what the hotkey is. 
  903.  
  904.         If the "Underline" checkbox is "checked" in the Button Designer 
  905.         window, then the first occurrence of the hotkey character is 
  906.         underlined. If the Dropshadow effect is also active the underline 
  907.         will also be dropshadowed. 
  908.  
  909.         
  910.         Special Effects. 
  911.         ----------------
  912.  
  913.         The "Bright", "Dark" and "Surface" colours are used with plain 
  914.         button styles and with the special effects. These colours 
  915.         represent the hilighted colour, the shadowed colour and the 
  916.         normal surface colour that is used with the special effects. 
  917.         Typical combinations that might be specified are WHITE, DARK-GREY 
  918.         and LIGHT-GREY respectively to give a "3D chiselled-steel" 
  919.         effect. 
  920.  
  921.         
  922.         Bevelled Buttons. 
  923.         -----------------
  924.  
  925.         You can give any button a "Bevel", this gives the impression that 
  926.         the side of your button are slanted giving a 3D impression that 
  927.         the button is raised off of the screen. 
  928.  
  929.         The size of the bevel may be specified with the "Size" field in 
  930.         the Button Designer window. This is a numeric field which may 
  931.         contain a value between 0 - 99 inclusive. This number specifies 
  932.         the actual width of the bevel (in pixels). The default width of 
  933.         the bevel is 3 pixels. 
  934.  
  935.         Bevels use all three special effects colours (BRIGHT, DARK and 
  936.         SURFACE), the Surface colour is used on the corners to give the 
  937.         impression of an edge. 
  938.  
  939.         Note, the bevel is not implemented unless the "Bevel" checkbox 
  940.         has been 'checked'. Also if the bevel effect is turned on the the 
  941.         actual size of the button will be LARGER than the rectangular 
  942.         image you see on the screen. The bevel is added onto the button 
  943.         "image". This means that if you are creating an icon button, none 
  944.         of the actual icon will be overwritten by the bevel. 
  945.  
  946.         If a bevel button is a "Mouse Area", then the size of the mouse 
  947.         area is expanded to include the bevel. 
  948.  
  949.         
  950.         Recessed Buttons. 
  951.         -----------------
  952.  
  953.         To enable the recessed effect, the "Recess" checkbox in the 
  954.         Button Designer window must be 'checked' A recessed button has a 
  955.         3D effect that makes the button look as if it has been hewn out 
  956.         from the surrounding area. When clicked a recessed button will 
  957.         not invert/halite the recess. This is because the recess appears 
  958.         to be part of the surrounding area and not the button itself. 
  959.  
  960.         The recess effects adds two pixels to each side of the button, so 
  961.         the overall result is that the button will be four pixels wider 
  962.         and taller. Also the recess has no effect on the size of the 
  963.         mouse region for a mouse button. The recess effect makes use of 
  964.         all three special effects colours, plus BLACK. 
  965.  
  966.         
  967.         Sunken Buttons. 
  968.         ---------------
  969.  
  970.         To enable the sunken effect, the "Sunken" checkbox in the Button 
  971.         Designer window must be 'checked'. The overall effect is such 
  972.         that the interior of the button looks as if it has sunk a little 
  973.         from the edges of the button. The sunken effect does not affect 
  974.         the overall size of the button or mouse region in any way. The 
  975.         effect is drawn after any icon has been pasted onto the button 
  976.         and is drawn one pixel inside the actual button image. 
  977.  
  978.         Chiselled Buttons. 
  979.         ------------------
  980.  
  981.         The chisel effect also affect the actual image of the button and 
  982.         should primarily used with plain buttons. A chisel is a 
  983.         rectangular outline drawn several pixels inside the image of the 
  984.         button. A chisel is made up of two colours (BRIGHT and DARK) and 
  985.         is two pixels thick. 
  986.  
  987.         The chiselled effect, like sunken, draw on top of the actual 
  988.         button image. 
  989.  
  990.  
  991.         Mouse Buttons and Non-Mouse Buttons.
  992.         ------------------------------------ 
  993.  
  994.         Buttons may be created in two different modes. A mouse button is 
  995.         clickable and returns a text string to the host when it is 
  996.         clicked. A non-mouse button on the other hand has no host 
  997.         command, no hotkey, cannot be inverted when clicked, in fact it 
  998.         can't even be clicked and does absolutely nothing other than 
  999.         display itself on the screen. 
  1000.  
  1001.         
  1002.         Creating a Mouse Button. 
  1003.         ------------------------
  1004.  
  1005.         To define your button as a "Clickable Mouse Button" ensure that 
  1006.         the "Mouse Area" checkbox in the Button Designer window is 
  1007.         "checked".  When the "Mouse Area" is active more effects are 
  1008.         available to you. 
  1009.  
  1010.         
  1011.         Invert Button. 
  1012.         --------------
  1013.  
  1014.         The "Invert" field in the Button Designer window is used to 
  1015.         determine if the button is to be inverted when the user clicks on 
  1016.         it. If the "Invert" option is not "checked" then nothing visibly 
  1017.         will happen to the button when the user clicks it. Plain buttons 
  1018.         and clipboard buttons simply invert the image of the button when 
  1019.         they are clicked. 
  1020.  
  1021.         Icon buttons may also be inverted in the same manner, however 
  1022.         icon buttons also have another method of inverting. 
  1023.  
  1024.         
  1025.         Inverting an Icon Button. 
  1026.         -------------------------
  1027.  
  1028.         One aspect of icon buttons that sets it apart from other buttons 
  1029.         is the fact that you can specify an icon file for the image of 
  1030.         the button (in WinRIP Lite, this may be either a RIP format icon 
  1031.         or a Windows icon). If you enable the "Hot Icon " field in the 
  1032.         Button Designer window, you are effectively specifying a 
  1033.         different method of inverting the button. Instead of simply 
  1034.         inverting the button as described above, RIPterm will attempt to 
  1035.         load a new icon file and stamp it on the button. The file name of 
  1036.         this new icon will be the same as the button icon but use a file 
  1037.         name extension of .HIC. If a hot icon file does not exist the 
  1038.         button is inverted in the normal way. 
  1039.  
  1040.         Reset Screen after button is clicked.
  1041.         -------------------------------------
  1042.         
  1043.         This option is activated by "checking" the "Reset" field in the 
  1044.         Button Designer window. It is used to clear the screen and make 
  1045.         the text window full size. This is used where clicking the button 
  1046.         would cause the user to enter a non-graphical section of the BBS. 
  1047.         Therefore allowing the user to interact with the BBS in full 
  1048.         screen text mode. 
  1049.  
  1050.  
  1051.  
  1052.         Radio Buttons, Checkboxes and Button Groups. 
  1053.         --------------------------------------------
  1054.  
  1055.         Another feature of the Button Designer is to allow the grouping 
  1056.         of button into categories. These button groups act collectively 
  1057.         to create button like Radio Buttons or Checkboxes. 
  1058.  
  1059.         Button Groups.
  1060.         --------------
  1061.  
  1062.         A group of buttons is a collection of zero or more buttons that 
  1063.         are related to each other in some way. You may have a maximum of 
  1064.         36 groups. Each group may have as many buttons as you wish to a 
  1065.         maximum of 128. 
  1066.  
  1067.         When you create a button you assign it a group number. All 
  1068.         subsequent button that a re created are automatically place in 
  1069.         this group until you change the "Group No" in the Button Designer 
  1070.         window. 
  1071.  
  1072.         
  1073.         Radio Buttons.
  1074.         -------------- 
  1075.  
  1076.         A group of Radio Buttons are quite common in computer 
  1077.         application, especially in the Windows Environment. The "Plain", 
  1078.         "Clipboard" and "User Icon" button in the Button Designer window 
  1079.         for instance are Radio Buttons. The feature of Radio Buttons that 
  1080.         makes them so useful is that only one Radio Button in the group 
  1081.         may be active at any one time. So if you turn on a particular 
  1082.         Radio Button in a group, all the others will be turned off! A 
  1083.         Radio Button is defined by 'checking' the "Radio Group" checkbox 
  1084.         in the Button Designer Window. 
  1085.  
  1086.  
  1087.         CheckBoxes. 
  1088.         -----------
  1089.  
  1090.         Checkbox groups, unlike Radio Buttons, are groups where more than 
  1091.         one button may be active at any one time. An example of this is 
  1092.         the Button Designer window, where the special effect are 
  1093.         specified by 'checking' a checkbox. 
  1094.  
  1095.         A checkbox button is defined by "checking" the "checkbox" field 
  1096.         in the Button Designer window. 
  1097.  
  1098.         
  1099.         Creating Fixed Size Plain Buttons. 
  1100.         ----------------------------------
  1101.  
  1102.         There are two fields in the Button Designer captioned "Width" and 
  1103.         "Height", you can enter the actual size of the buttons to be 
  1104.         created (in pixels). This saves having to draw the button with 
  1105.         the Button Tool. 
  1106.  
  1107.         If you set these fields to ZERO, then when you create a button 
  1108.         with the Button Tool you will have to "click and drag" to 
  1109.         dynamically size the button. 
  1110.  
  1111.         
  1112.         Auto-Clipboard Buttons. 
  1113.         -----------------------
  1114.  
  1115.         An Auto-Clipboard that will take the image of the button and 
  1116.         automatically place it onto the Clipboard for use by later button 
  1117.         commands. This saves having to draw the button again and again. 
  1118.  
  1119.         To activate the Auto-Clipboard feature "check"  the "AutoClip" 
  1120.         checkbox in the Button Designer window. 
  1121.  
  1122.         Note, You should not use Auto-Clipboard feature if the "Hot Icon" 
  1123.         facility is active. 
  1124.  
  1125.         
  1126.         Saving and Loading Button Styles. 
  1127.         ---------------------------------
  1128.  
  1129.         You may save a button style to disk so that in future you may 
  1130.         reload them instead of having to recreate them. Simply click the 
  1131.         SAVE or LOAD button in the Button Designer window . This will 
  1132.         cause the File Open dialog box to be opened where you can select 
  1133.         the file to be save to, or the file to load. 
  1134.  
  1135.  
  1136.         Default Button Style. 
  1137.         ---------------------
  1138.  
  1139.         The default button discards the current button style and 
  1140.         reinstates the default button configuration. This default 
  1141.         configuration contains the following settings: 
  1142.  
  1143.                Button Type        =    Plain 
  1144.                Bevel              =    Active 
  1145.                Bevel Size         =    3 
  1146.                Background Colour  =    BLACK 
  1147.                Bright             =    WHITE  
  1148.                Dark               =    Dark Grey 
  1149.                Surface            =    Light Grey 
  1150.                Key                =    WHITE  
  1151.                Corners            =    Light Grey 
  1152.  
  1153.  
  1154.  
  1155.  
  1156.