home *** CD-ROM | disk | FTP | other *** search
/ The CDPD Public Domain Collection for CDTV 3 / CDPDIII.bin / pd / utilities / misc / scale / scale.doc < prev    next >
Text File  |  1993-04-06  |  5KB  |  137 lines
  1.  
  2.  
  3.                 Scale by Erik Wistrand (Tuesday 28/09/92 19:32:10)
  4.  
  5.  
  6.     Scale is a small magnify program which supports scaling from 10 % to 
  7. 1000 % in both horizontal and vertical directions. It will jump to any frontmost
  8. screen (including non-public screens) and supports multiple options.
  9.  
  10. !!! Scale requires DOS 2.0 (and wants WB 2.1)!!!
  11.  
  12. 1. How to start Scale:
  13.  
  14.     Scale will open on the frontmost screen, so to start Scale on a custom
  15. screen, move this screen to the front, then drag it down to allow you to see
  16. Workbench and Scale's icon. Then start Scale by doubleclicking. Scale should
  17. now open on the custom screen.
  18.     If you want Scale to open on Workbench, just keep Workbench frontmost.
  19.  
  20. IMPORTANT!
  21.  
  22.     If Scale opens on a custom, non-public screen, remember to quit Scale
  23. BEFORE you quit the program which opened the screen. Otherwise I can't
  24. guarantee anything... (Most likely the screen will remain open and you 
  25. can't close it. A system crash is also possible.) 
  26. Do NOT except this brutal screen invasion to be totally problemfree with
  27. respect to screen updates and so on.
  28.  
  29.  
  30. 2. How to use Scale's window
  31.  
  32.     The window shows a magnified (or shrunk) view of the same screen as
  33. Scale has opened on. It's has standard gadgets for resize, move, front/back
  34. and close. Yes, the Close gadget exits Scale. Scale will magnify (shrink) the
  35. portion of the screen around the mouse pointer, unless otherwise told.
  36.  
  37. 3. The menus
  38.  
  39.     The Scale window has some menus, namely:
  40.  
  41.     <Preferences>           -   Opens a window with some options. See below
  42.     <Preset factors>
  43.         <100 %>             -   Sets both X and Y factors to 1
  44.         <200 %>             -     "   "   "  "      "     "  2
  45.         ...
  46.         <25 %>              -     "   "   "  "      "     "  0.25
  47.  
  48.     <Window>
  49.         <Freeze position>   -   Don't follow the mouse any more
  50.         <Snap to corner>    -   Magnify (shrink) to upper left corner of
  51.                                 window when possible.
  52.         <Open prefs on WB>  -   Open preferences window on Workbench.
  53.     <Quit>                  -   quit Scale
  54.  
  55.  
  56. 4. The Keys.
  57.  
  58.     Scale supports some keyboard commands, except for the menu shortcuts.
  59.  
  60.  
  61.     Arrow up:       Y factor is incresed by 5 %.
  62.     Arrow down:     Y factor is decresed by 5 %.
  63.     Arrow right:    X factor is incresed by 5 %.
  64.     Arrow left:     X factor is incresed by 5 %.
  65.     A:              Scaling is activated/deactivated
  66.     Q:              Quit
  67.     Help:           The preferences window is opened
  68.  
  69. 5. The preferences window.
  70.  
  71.     This window opens on workbench by default and contains some gadgets:
  72.  
  73.     Y factor        - Slider which sets vertical scale factor
  74.     X factor        - Slider which sets horizontal scale factor
  75.     WakeUp/sec      - Slider which sets how often Scale will redraw it's window 
  76.                       when it's window is not selected. If 0, Scale will not
  77.                       wake up at all.
  78.     WakeUp          - Cycle between
  79.                         always      -   Scale will redraw at every wakeup.
  80.                         movement    -   Scale will only redraw when the mouse
  81.                                         is moved.
  82.     Recalc          - Set if you want to the scale factors to change when
  83.                       the window is resized, so that an equal amount always
  84.                       is shown. Both X and Y factors must be free.
  85.     Rescale         - If checked, the scale window will be rescaled when you 
  86.                       move the X and Y sliders.
  87.     Active          - Must be set if Scale should update it's window.
  88.     
  89.     X, Y free       - The X and Y factors can be set indepently.
  90.     X free          - The Y factor will always equal the X factor.
  91.     Y free          - The X factor will always equal the Y factor.
  92.  
  93.     OK              - Exits preferences.
  94.     Show            - Rescales window.
  95.     Cancel          - Exits preferences, but restores X and Y factors.
  96.  
  97. 6. Localization
  98.  
  99.     Scale is fully localized under WB 2.1
  100.     Scale uses the scale.catalog file which should be in either 
  101.  
  102.     PROGDIR:Catalogs/languageName           or
  103.     LOCALE:Catalogs/languageName
  104.  
  105.     where languageName is the name of the language you're using.
  106.  
  107.     Scale's builtin language is english, and I've created a .catalog file
  108.     for swedish.
  109.  
  110.     The .ct and .cd files for catalog creation should follow this program
  111.     and can be used to create a new catalog for any language. If you do this, 
  112.     please send me the new catalogs! 
  113.  
  114. 7. Bugs
  115.  
  116.     If the X factor is set to 1.00 and the Y factor is not 1.00,
  117. the scaling will be incorrect.
  118. This could be a bug in graphics.library v37 (the BitMapScale() function)!!
  119. On the other hand, it could just as well be some sloppy programming from me...
  120.  
  121.  
  122. 8. Distribution
  123.  
  124.     This program and source is placed in the public domain in all respects,
  125. as long as this document and the swedish scale.catalog file follows the
  126. executable.
  127.  
  128. 9. Contacts
  129.  
  130.     If you want to ask me anything, thank me, send me some nice program or 
  131. just discuss something interesting, write to:
  132.  
  133.     Erik Wistrand                  E-mail:     manh-9@math.chalmers.se
  134.     Cedergatan 6
  135.     S-421 74 V. FRÖLUNDA
  136.     SWEDEN
  137.