home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0792.lha / DragIt / DragIt.doc < prev    next >
Text File  |  1993-01-08  |  14KB  |  351 lines
  1.  
  2.  
  3.  
  4.  
  5.               ######                                ######
  6.               #######                               ######
  7.               ##    ##                                ##
  8.               ##    ## ## ###   ######   #####        ##   ######
  9.               ##    ## #######  ####### #######       ##   ######
  10.               ##    ## ###   ##      ## ##   ##       ##     ##
  11.               ##    ## ##        ###### ####### ####  ##     ##
  12.               ##    ## ##       #######  ###### ####  ##     ##
  13.               ##    ## ##       ##   ##      ##       ##     ##
  14.               #######  ##       ####### #######     ######   ##
  15.               ######   ##        ###### #######     ######   ##
  16.  
  17.  
  18.  
  19.                          DragIt 2.01 by Steve Lemieux
  20.  
  21.       ⌐ Copyright 1992, SilverBox Software, All rights reserved, Freeware
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. Introduction :
  31. --------------
  32.  
  33.    The purpose of this program is to allow you to move or size a window without
  34. using  the  drag  bar  or  the  sizing  gadget. How? Press on  the configurable
  35. qualifier,  while holding it,  press  your selected  mouse button, and move the
  36. mouse.  You'll  see the  window  border  appear, and  you'll be able to drag or
  37. size it.
  38.  
  39.    DragIt  only  works  on  2.0  operating system. It  supports the commodities
  40. exchange  standard.  It  also  supports  localization  with  locale.library and
  41. new style 2.1 (or 3.0) preference.
  42.  
  43.    This archive contains many modules. The main executable file DragIt has been
  44. optimized to be as small as possible.
  45.  
  46.  
  47.     Files found in the archive :
  48.  
  49.         Drag              : Configuration program
  50.         DragIt            : Main program
  51.         Drag.h            : C module describing the Drag.prefs file format.
  52.         Drag.doc          : English documentation
  53.         Drag.doc.franτais : French documentation
  54.         DragPref.catalog  : File to put Drag config in your own language.
  55.                             French is supplied.
  56.         DragPref.cd       : File to create your own language catalog with
  57.                             CatComp
  58.  
  59. Installation :
  60. --------------
  61.  
  62.     The  easiest  way  to  install  DragIt is to move its icon in the WBStartup
  63. drawer.
  64.  
  65.     Add  this  line to your 'Startup-Sequence' right after the IPref command to
  66. get DragIt running every time your machine boots:
  67.  
  68.         run >nil: DragIt
  69.  
  70.     You  can't  execute two DragIt at the same time, but if you try anyway, the
  71. second occurence of the program will quit automatically.
  72.  
  73.     To install  the  Drag  configuration  program,  you have to move it in your
  74. SYS:PREFS drawer.
  75.  
  76.     If  you  have  locale.library,  you  have  to  copy DragPref.catalog in the
  77. correspondent language directory. If you don't copy it, English version will be
  78. used as default. For  example,  copy  the french version of DragPref.catalog in
  79. your LOCALE:catalogs/franτais directory.
  80.  
  81. Configuration :
  82. ---------------
  83.  
  84.     The  configuration  program  allows  you  to configure DragIt. You use this
  85. program the same way you use other configuration programs.
  86.  
  87.     Configuration options available :
  88.  
  89.         Mouse button : Select  which  mouse  button you want to use to drag and
  90.                        size every window.
  91.  
  92.         Zone : Change the configuration zone of the display border.
  93.  
  94.         Drag option : Activate  the  dragging mode to be used with the selected
  95.                       qualifier.
  96.  
  97.         Size option : Activate  the  sizing  mode  to be used with the selected
  98.                       qualifier. The sizing  option  is effective in the border
  99.                       only.
  100.  
  101.         Corner option : Activate a different way to process the sizing option.
  102.  
  103.             Without corner option : Both  left-top and right-bottom borders can
  104.                                     use two-way sizing on the same axis.
  105.  
  106.  
  107.                 +------------------------------------------+
  108.                 |            Sizing zone left-up           |
  109.                 |  +------------------------------------+--+
  110.                 |  |                                    |  |
  111.                 |  |                                    |  |
  112.                 |  |            Moving zone             |  |
  113.                 |  |                                    |  |
  114.                 |  |                                    |  |
  115.                 |  |                                    |  |
  116.                 +--+------------------------------------+  |
  117.                 |           Sizing zone right-bottom       |
  118.                 +------------------------------------------+
  119.  
  120.             With corner option : The four  corners are  used to size the window
  121.                                  both ways while the center sizing zone is used
  122.                                  for parallel movement.
  123.  
  124.                 +-----+------------------------------+-----+
  125.                 |     |                              |     |
  126.                 |  +--+------------------------------+--+  |
  127.                 |  |                                    |  |
  128.                 +--+                                    +--+
  129.                 |  |             Moving zone            |  |
  130.                 |  |                                    |  |
  131.                 +--+                                    +--+
  132.                 |  |                                    |  |
  133.                 |  +--+------------------------------+--+  |
  134.                 |     |     Parallel sizing zone     |     |
  135.                 +-----+------------------------------+-----+
  136.                    ^
  137.                    |
  138.                    +---- 2-axis sizing zone
  139.  
  140.         Program priority: To change the main program (DragIt) priority. You can
  141.                           use values between  -127 and 127 but priority numbers
  142.                           between  -5 and 5  are better to avoid conflicts with
  143.                           other running tasks.
  144.  
  145.         Handler priority : To change the handler  priority.  You can use values
  146.                            between  -127 and 127  but priorities higher than 50
  147.                            are best, avoiding conflicts with intuition.library.
  148.  
  149.         Drag qualifier : Select  one  or  many keys to be activated at the same
  150.                          time than the selected mouse button to drag the window.
  151.                          The following qualifiers can be used : LSHIFT, RSHIFT,
  152.                          CONTROL,  LALT,  RALT,  LCOMMAND  and RCOMMAND. If you
  153.                          want  more  than  one key to be used, you must use the
  154.                          '|'  character  to  separate each key. You must always
  155.                          select  at  least  one qualifier except if you use the
  156.                          middle mouse  button  in  which  case you should enter
  157.                          NONE as the qualifier.
  158.  
  159.         Size qualifier : Select one or many keys to be activated  at  the  same
  160.                          time than the selected mouse button to size the window.
  161.                          You  use the qualifier the same way you use it for the
  162.                          drag qualifier. You can use the same qualifiers.
  163.  
  164.         Zone buttons : You can change the size of the sizing border by pressing
  165.                        the  mouse button over it and by moving the mouse left &
  166.                        right.  You  can  also  change  the  border  by  quickly
  167.                        clicking  on  opposite  sides  of  the  gadget to get an
  168.                        incrementation  or decrementation by one. Values between
  169.                        1  and  99 are accepted. If you press the left shift key
  170.                        while you press on a gadget every four gadgets displayed
  171.                        will change to the same value.
  172.  
  173.     Menu available :
  174.  
  175.         Project :
  176.  
  177.             Open : Loads the information from a previously saved file. When you
  178.                    choose Open, a file requester appears.
  179.  
  180.             Save As... : Allows you to specify the file where you want to save
  181.                          the currently displayed settings.
  182.  
  183.             Quit : Exits the editor.
  184.  
  185.         Edit :
  186.  
  187.             Reset to default : Returns the editor settings to the default
  188.                                settings.
  189.  
  190.             Last Saved : Returns the editor settings to the last saved settings.
  191.  
  192.             Restore : Returns the editor to the settings that were displayed
  193.                       when the editor was open.
  194.  
  195.         Settings :
  196.  
  197.             Save Icons? : Allows  you  to  choose  whether or not to save icons
  198.                           with the files saved with the Save As menu item.
  199.  
  200.     Action buttons :
  201.  
  202.         Save : This  will  activate  any changes you  made,  saving the changes
  203.                to disk  and closing the editor. The new settings will remain in
  204.                effect even if you reboot your machine.
  205.  
  206.         Use : This will temporarily  implement  any changes  made and close the
  207.               editor.  If you  reboot the Amiga, your changes will be lost, and
  208.               the previously saved settings will be used.
  209.  
  210.         Cancel : This will close the editor without using or saving any changes
  211.                  made in the window.  The settings that were in effect prior to
  212.                  opening the editor will remain in effect.
  213.  
  214.     Icon options :
  215.  
  216.         Edit : To edit preference settings included in the  file  associated to
  217.                the icon.
  218.  
  219.         Save : Saves and implements settings included in the file associated to
  220.                the icon.
  221.  
  222.         Use : Implements  settings  included in the file associated to the icon
  223.               temporarily until you reboot the Amiga.
  224.  
  225.         CreateIcons :  Allows  you  to choose whether or not to save icons with
  226.                        the files saved with the Save As menu item.
  227.  
  228.         PubScreen : To choose  a screen where you want the editor to be opened.
  229.                     The name is case sensitive.
  230.                     If  the  screen  is not found, the editor will be opened on
  231.                     the default screen, usually the workbench screen.
  232.  
  233. To remove :
  234. -----------
  235.  
  236.     If you execute DragIt in the workbench or by WBStartup,  you must remove it
  237. with commodity.
  238.  
  239.     In the  CLI, if the window where drag was started is opened, you can remove
  240. it  by  using  CTRL-C. To see if the window was closed you can use the 'Status'
  241. command to obtain the process number like this:
  242.  
  243.         break <process number> c
  244.  
  245.     Even from the CLI, you can use the commodity to remove DragIt.
  246.  
  247.     From  the  preference,  you  can  remove  the  drag  and the move option to
  248. temporarily  deactivate DragIt.  However, the memory used by DragIt will not be
  249. freed  because  DragIt  is  always running. You have the same result if you use
  250. enable/disable option from commodity exchange.
  251.  
  252. Commodity :
  253. -----------
  254.  
  255.    You can control DragIt with the program commodity exchange in the Workbench.
  256. If  you  select  in  the  listview  gadget  DragIt you can change this with the
  257. appropriate gadget :
  258.  
  259.         ENABLE  : Activate DragIt
  260.         DISABLE : Deactivate DragIt without quitting
  261.         KILL    : Deactivate DragIt and quit
  262.  
  263.     Commodity  and  preference  are  distinct. If you deactivate something, you
  264. must  reactivate  it  in  the  same  way.  For  example,  it  is  impossible to
  265. deactivate DragIt with the commodity and reactivate it with the preference.
  266.  
  267. Configuration :
  268. ---------------
  269.  
  270.     These  two  different  configurations  are used for compatibility only with
  271. older  versions  of  DragIt,  but  the  new preference program will always have
  272. priority over the older method of configuration.
  273.  
  274.  
  275.     CLI program format :
  276.  
  277.         DragIt FRAMESIZE/N,PRIORITY/N,LSHIFT/S,RSHIFT/S,CONTROL/S,LALT/S,
  278.                RALT/S,LCOMMAND/S,RCOMMAND/S
  279.  
  280.     FRAMESIZE  is  used  to  change  the  sizing border used to change the size
  281. of  a  window. If  you  don't specify a value, four pixels are used by default.
  282. If you specify 0, the sizing option will be disabled.
  283.  
  284.     PRIORITY  is  used  to  change  the  input handler priority. 125 is used by
  285. default. You can use values between  -127 and 127 but priorities higher than 50
  286. are better if you want to avoid conflicts with intuition.library.
  287.  
  288.     Qualifiers are used to activate DragIt functions with the left mouse button
  289. selected at the same time.
  290.  
  291.     You can also use many qualifiers at the same time. For example :
  292.  
  293.         DragIt lshift control
  294.  
  295.     In  this  case,  you  must  press both lshift and control with the selected
  296. mouse button to activate dragging mode.
  297.  
  298.     In a workbench icon :
  299.  
  300.     You  can  also  put these flags in the DragIt icon 'information'  using the
  301. workbench  menu.  The same functions are available but with a different syntax.
  302. You must use the '|' character to separate differents qualifiers. For example :
  303.  
  304.     framesize=6
  305.     priority=128
  306.     qualifier=lalt
  307.     qualifier=rcommand|lcommand
  308.  
  309.     If you don't specify a qualifier, CONTROL will be used as default.
  310.  
  311. Where can I reach the author? :
  312. -------------------------------
  313.  
  314. Steve Lemieux
  315. 3330 France-Prime #312
  316. Ste-Foy, Quebec, Canada
  317. G1W 4V2
  318.  
  319. BIX        : slemieux
  320. EMail      : slemieux@nyx.cs.du.edu
  321.  
  322. Version history :
  323. -----------------
  324.  
  325. Version 1.00 : - First public release.
  326.  
  327. Version 1.01 : - Bug with lores screen fixed
  328.  
  329. Version 2.00 : - CONTROL qualifier is used as default
  330.                - The mouse pointer is now stopped when the frame reaches the
  331.                  screen border
  332.                - A new sizing option
  333.                - FRAMESIZE option added
  334.                - Bug with virtual screen fixed
  335.                - Preference with workbench 2.1 preferences style added
  336.                - Locale.library support (French and english)
  337.                - Total compatibility with WB 2.1 (and 3.0). DragIt still
  338.                  works with 2.0
  339.                - Different qualifiers can be used for drag and size option
  340.                - Dimension of the sizing border can be totaly changed
  341.                - IFF type ENV:drag.prefs config file added
  342.                - Two ways to configure sizing option
  343.                - Three-button mouse supported
  344.  
  345. Version 2.01 : - Support for Workbench 3.0 new look menus
  346.                - Bug with DoublePAL/DoubleNTSC screens fixed
  347.                - Conflict with MagicMenu fixed (Thanks to Eric Gailloux)
  348.                - In older versions, a deadlock would occur if a window
  349.                  was opened or closed during moving/sizing operation
  350.                  (Thanks to Franz Schwarz)
  351.