home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #3 / amigamamagazinepolishissue1998.iso / blabla / colourlock / colourlock.guide (.txt) < prev    next >
Amigaguide Document  |  1998-01-24  |  10KB  |  169 lines

  1. @database ColourLock.guide
  2. @$VER: ColourLock.guide 0.13 (30.12.97)
  3. @node main "Manual - main menu"
  4.                __________ _  _                 _  _ __________
  5.   _  _ _______/ ._______       _______._______   ._______     \_______ _  _
  6.   ._______      |      /___.___\_____ |      /___|      /___.  ___________.
  7.   |      /______|__.  /    | _______  |     /___ |     /    |__\_________ |
  8.   |     /_________ |-------'----------'----------'----------'__________   |
  9.   `----------------' -  - ------- pRESENTs ------- -  -  `-------------tF!'
  10.                                 @{b} ColourLock @{ub}
  11.                                 Version 0.13
  12.                                Date 30.12.1997
  13.                        Copyright (c) 1997 Krashan/BlaBla
  14.                            @{b}        MANUAL
  15.     Table of contents: @{ub}
  16.         1. @{" Copyrights & distribution               " link Prawa}
  17.         2. @{" Short overview                          " link Do_czego}
  18.         3. @{" Detailed description                    " link Opis}
  19.         4. @{" Requirements, technical stuff           " link Wymagania}
  20.         5. @{" Future plans                            " link Future}
  21.         6. @{" Program history                         " link History}
  22.         7. @{" Info about BlaBla                       " link BlaBla}
  23.         8. @{" Author info & greetings                 " link Rest}
  24. @endnode
  25. @node Prawa "Copyrights & distribution"
  26. This software is subject to the  @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT/main 178}.
  27. It is >@{fg shine}FREEWARE@{fg text}<, as defined in paragraph @{"4>a<" link AFD-COPYRIGHT/main 86}.
  28. For more information please read  @{"AFD-COPYRIGHT" link AFD-COPYRIGHT/main 1} (version 1.2 or higher).
  29.       @{" Copyright       " link AFD-COPYRIGHT/main 28}
  30.       @{" Distribution    " link AFD-COPYRIGHT/main 42}
  31.       @{" Disclaimer      " link AFD-COPYRIGHT/main 60}
  32.       @{" Return service  " link AFD-COPYRIGHT/main 76}
  33.       
  34. @endnode
  35. @node Do_czego "Short overview"
  36. @{b}Short overview @{ub}
  37. ColourLock purpose is to set and then lock Workbench screen colour palette.
  38. Using ColourLock You can manage easily Workbench palette if You have WB
  39. opened in more than eight colours. Palette locking frees You from many
  40. colour related problems in MagicWB, MUI or backdrop pattern. ColourLock
  41. locks given (e.g. all) Workbench colours, so any software can't change them
  42. later. ColourLock is easy to use - You can compose palette using any
  43. painitng program like DPaint or PersonalPaint, or get palette from any IFF
  44. picture (ILBM or even DR2D).
  45. @endnode
  46. @node Opis "Detailed description"
  47. @{b}How it works @{ub}
  48. ColourLock finds Workbench screen after starting, then reads a palette from
  49. given IFF ILBM (or DR2D) file, sets WB colours and locks them. Then it
  50. quits. Colours stay locked until the Amiga is rebooted. In typical use
  51. ColourLock is started from startup-sequence right after IPrefs. IPrefs locks
  52. first four and last four colours from the patette. These colours can be
  53. adjusted with Palette Preferences. IPrefs locks also colours 17, 18 and 19
  54. (if WB has more than 16 colours) for mouse pointer. Normally ColourLock
  55. doesn't touch these colours. You can make ColourLock to change them using
  56. FORCE option. If there is more colours in read palette than on WB screen,
  57. surplus palette entries will be ignored. If there is less colours in the
  58. file, remaining WB colours will stay free and unchanged. ColourLock manages
  59. palettes with non-standard colours quantity (e.g. 24 entries) if only IFF
  60. file structure is correct.
  61. @{b}Running the program 
  62. @{ub} 
  63. ColourLock is a typical Shell-only command. It doesn't work started from
  64. Workbench, so it makes no sense to add icon to it. Typically it is launched
  65. from startup-sequence. Here is command pattern and parameters description:
  66. @{fg shine}ColourLock PALETTE/A/K, REPORT/S, FORCE/S@{fg text}
  67. @{b}PALETTE@{ub} - path to file from which palette should be extracted. You must give
  68. @{b}REPORT@{ub} - this switch turns the report mode on. ColourLock prints which
  69. colours were already locked nad which have been changed.
  70. @{b}FORCE@{ub} - this switch makes ColourLock to change already locked (e.g. by 
  71. IPrefs) colours.
  72. @{u}Examples:@{uu}
  73. @{i}ColourLock PALETTE=SYS:Prefs/Presets/palette.iff 
  74. @{ui}Program gets palette from given file and changes colours.
  75. @{i}ColourLock PALETTE DH3:Graphics/Pictures/Backdrops/cindy36.ilbm FORCE 
  76. @{ui}Program gets palette from file, changes all the colours including already 
  77. locked ones.
  78. @{i}ColourLock PALETTE=RAM:test.pal REPORT >RAM:colour_list @{ui}
  79. Program reads palette, changes and locks non-locked colours. Report will be
  80. written to 'RAM:colour_list'.
  81. @{b}Installation @{ub}
  82. Due to non-standard installation process there is no Installer script in the
  83. archive. But installation is rather simple:
  84. @{fg shine}1.@{fg text} Prepare a file containing the palette. It can be a picture (e.g. an
  85. amazing WB screenshot You've just downloaded from Aminet, or Your favourite
  86. backdrop) or palette written by painting program. Place this file somewhere
  87. that it can be accessed during system bootup (e.g. somewhere on boot drive). 
  88. @{fg shine}2.@{fg text} Copy ColourLock anywhere that it will be accesible during bootup too
  89. (e.g. SYS:C).
  90. @{fg shine}3.@{fg text} Put ColourLock call in startup-sequence right after IPrefs. @{b}If monitor
  91. driver@{ub} You use for WB screen @{b}is called after IPrefs@{ub}, You should @{b}run
  92. ColourLock after it@{ub}. Or better move monitor driver call before IPrefs.
  93. This speeds Your system booting up. 
  94. @{fg shine}4.@{fg text} Reboot Your Amiga. Your palette is set and locked from now!
  95. @endnode
  96. @node Wymagania "Requirements, technical info""
  97. @{b}Requirements@{ub}
  98. ColourLock works only on Amigas with OS 3.0 or higher. However AGA chipset
  99. isn't required. Memory needed is about 10 kB (freed after colour locking).
  100. ColourLock needs also iffparse.library version 39 or higher (it is a part of
  101. Workbench software).
  102. @{b}Technical data  @{ub}
  103. Program was written in C and compiled with SAS/C 6.57 compiler. It  is  100%
  104. StyleGuide compliant. After it do its job it removes completely from memory.
  105. @endnode
  106. @node Future "Future plans"
  107. @{b}ColourLocker future@{ub}
  108. I have no ideas how to improve this program. If You have any suggestions or
  109. ideas (or of course bug reports), please @{"contact me" LINK Rest}.
  110. @endnode
  111. @node History "Historia programu"
  112. @{b}Program history @{ub}
  113. Version @{fg shine}0.1@{fg text}      13.12.1997     
  114. * First public version.
  115. Version @{fg shine}0.13@{fg text}     30.12.1997     
  116. * BUG FIXED: Missing UnlockPubScreen ()! How could I do such a silly
  117. mistake? It caused problems to IPrefs. WB screen was still locked, so IPrefs
  118. couldn't close it when screen mode, overscan or other preferences had been
  119. changed. Bug reported by Krzysztof Kurdzieko.
  120. @endnode
  121. @node BlaBla "Co to jest BlaBla?"
  122. @{b}@{b}@{fg shine}BlaBla@{ub}@{fg text} is a Polish biggest system programmers group. We make the system
  123. friendly programms. We guarantee that our programs will run on almost every
  124. machine (@{fg fill}Amiga@{fg text} of course), including future ones. All our programs are
  125. running in multitasking, and all of them are PD, Freeware, or Shareware.
  126. Our organisation has a few members (we "absorb" only good programmers),
  127. an own e-mail address and own @{b}BBS@{ub}. Our newest productions you can find in
  128. our PD library called "@{b}Polware@{ub}". Our texts, articles you can also find in
  129. our disk-mag "@{b}Izviestia@{ub}" (sorry, in Polish!).
  130. @{i}Blabla memberlist (XI'97):@{ui}
  131.         @{fg fill}Kordi/DuckRed & BlaBla@{fg text}          @{i}(Kordian Adamczyk)@{ui}
  132.         @{fg fill}Kysy/AM & 2xBla@{fg text}                 @{i}(Krzysztof Habowski)@{ui}
  133.         @{fg fill}LeMUr/BlaBla@{fg text}                    @{i}(Lukasz Prokulski)@{ui}
  134.         @{fg fill}Karol/BlaBla@{fg text}                    @{i}(Karol Bryd)@{ui}
  135.         @{fg fill}Scott/Inferno & BlaBla@{fg text}          @{i}(Marcin Ochocki)@{ui}
  136.         @{fg fill}Thufor/BlahBlah@{fg text}                 @{i}(Dariusz J.Garbowski)@{ui}
  137.         @{fg fill}Tomash/Art-B & BBla@{fg text}             @{i}(Tomasz Korolczuk)@{ui}
  138.         @{fg fill}Warhawk/SubBlaBla@{fg text}               @{i}(Przemyslaw Jez)@{ui}
  139.         @{fg fill}Krashan/BlaBla                  @{fg text}@{i}(Grzegorz Kraszewski)@{ui}        
  140.         @{ui}@{fg fill}Kaczus/subBlaBla@{fg text}                @{i}(Tomasz Kaczanowski)@{ui}
  141.         @{fg fill}Futrzak/subBlaBla@{fg text}               @{i}(Krzysztof Wolski)
  142.         @{ui}@{fg fill}X-Pert/subBlaBla                @{i}@{fg text}(Piotr Wyderski)
  143.         @{fg fill}@{ui}Bruner/subBlaBla                @{i}@{fg text}(Piotr Hoppe)
  144.         @{fg fill}@{ui}Mr.DoDo/subBlaBla               @{i}@{fg text}(Krzysztof Dolinski)
  145.         @{fg fill}@{ui}Melon/subBlaBla                 @{fg text}@{i}(Grzegorz Chmiel)
  146.         @{fg fill}@{ui}Siumot/subBlaBla                @{i}@{fg text}(Tomasz Bielinski)
  147.         @{fg fill}@{ui}Szczepan/subBlaBla              @{fg text}@{i}(Marcin Juszkiewicz)
  148.         @{fg fill}@{ui}Valar/subBlaBla                 @{fg text}@{i}(Daniel Owsianski)@{ui}
  149. @{b}@{fg shine}BlaBla@{ub}@{fg text}  group  is  well-known  in Poland, and programs signed with "Blabla"
  150. are  for  sure very good. We made many productions, we help many young
  151. programmers, we write articles to Polish edition of @{b}Amiga Magazine@{ub},
  152. @{i}we try to do all, for our beloved computer - Amiga!@{ui}
  153. @endnode
  154. @node Rest "Other informations"
  155. @{b}Contact with author @{ub}
  156. @{fg fill}Grzegorz Kraszewski (Krashan/BlaBla)
  157. Zalesie 17
  158. 16-003 Kozince
  159. POLAND@{fg text}
  160. @{fg fill}krashan@cksr.ac.bialystok.pl@{fg text} to July 1998
  161. @{b}Greetings@{ub}
  162. To all BlaBla people:
  163. LeMUr, Tomash, Kysy, Siumot, Szczepan, ScoTT, Kaczus, Kordi, Thufor, Karol,
  164. Bruner, Futrzak, Melon, Mr. DoDo, Valar, Warhawk and X-Pert.
  165. Special X-greets to Krzysztof Konopko and @{b}chiefly to Krzysztof Kurdzieko@{ub},
  166. who was going to buy a pERSONAL cRAP, but fortunately he stays with Amiga.
  167. This program was written mainly for him.
  168. @endnode
  169.