home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / dev / gui / triton / prefs / triton.doc < prev    next >
Encoding:
Text File  |  1994-07-14  |  7.0 KB  |  166 lines
  1.  
  2.                       **********************************
  3.  
  4.                           Triton Preferences Editor
  5.  
  6.                           Release 1.1
  7.  
  8.                           (c) 1993-1994 Stefan Zeiger
  9.  
  10.                       **********************************
  11.  
  12.  
  13. Contents
  14. ========
  15.  
  16. 1. Introduction
  17.  
  18. 2. Installation
  19.  
  20. 3. Using the editor
  21.  
  22. 4. Program history
  23.  
  24.  
  25. 1. Introduction
  26. ===============
  27.  
  28.     The  Triton  Preferences Editor allows you to customize the look and feel
  29. of  applications  which  are  using  the  Triton  GUI  creation  system.  The
  30. Preferences  Editor  is  shareware.  In unregistered versions only the system
  31. options  are  saved.   Registered  Triton users/developers will get a keyfile
  32. which  unlocks the editor.  See the file 'Distribution' in the main directory
  33. of this Triton distribution for more information about registering.
  34.  
  35.  
  36. 2. Installation
  37. ===============
  38.  
  39.     First  of  all, Triton requires at least OS2.04.  If you're still running
  40. 1.2 or 1.3, you have to upgrade to OS2.04 or better.
  41.  
  42.     If   you're   running   OS2.04   or  2.05  (v37),  you  have  to  install
  43. reqtools.library  (©  Nico François) in order to use the screenmode selection
  44. in  the public screen manager.  Beginning with OS2.1 (v38) the ASL screenmode
  45. requester will be used if ReqTools is not available.
  46.  
  47.     The Triton Preferences Editor can be installed by hand by simply dragging
  48. it  into the 'Prefs' drawer of your boot partition ('sys:Prefs').  Then start
  49. the  editor  and confirm that you want to install the Preferences System.  It
  50. may be removed again later by selecting 'Project/Remove' in the editor's main
  51. window's menu.
  52.  
  53.     The  preferred  method  of  installing  the  editor  is  using the Triton
  54. installation script which also installs triton.library.
  55.  
  56.  
  57. 3. Using the editor
  58. ===================
  59.  
  60.     The Triton Preferences Editor allows you to change basically two kinds of
  61. settings:
  62.  
  63.     1. Global settings for all Triton applications (e.g.  public screens).
  64.  
  65.     2. Private application settings.
  66.  
  67.     Note  that  the  listed  global  application  '««Global»»' belongs to the
  68. second  type,  too.  If an application is created, it will inherit the global
  69. application's  settings.  Thus all applications without own settings will use
  70. the global settings.  As soon as you change any setting of an application, it
  71. will  become  independant  and  will not inherit future changes of the global
  72. application.   If  you  want  to delete an application's private settings and
  73. make it use the global settings again (including inheriting future changes to
  74. them),  select the menu item 'Edit/Reset To Global'.  This system may sound a
  75. bit complicated to you, but it is quite easy to handle.
  76.  
  77.     Main window menu 'Edit':
  78.     ~~~~~~~~~~~~~~~~~~~~~~~~
  79.     This menu contains all standard items plus 'Reset to Global' (see above).
  80. All  changes  made  from  within  this  menu  do  only apply to the currently
  81. selected application.
  82.  
  83.     Main window gadgets:
  84.     ~~~~~~~~~~~~~~~~~~~~
  85.     'Save',  'Use'  and 'Cancel' should be self-explaning.  They apply to all
  86. modified settings  of all applications.  'Test' will restart  the Preferences
  87. editor using the current settings without saving anything.
  88.  
  89.     'Info'  will  give  you  all  information  available  about  the selected
  90. application.  This includes name, version, compilation date and so on.
  91.  
  92.     'Delete'  will  delete an application, i.e.  its settings and information
  93. files.   You  have to restart the application to make it appear in the Triton
  94. Preferences  Editor  again.   If  you  just  want  to delete an application's
  95. private settings, use 'Edit/Reset to Global'
  96.  
  97.     The  gadget  'System'  opens  the system window which contains all global
  98. settings.  All other gadgets open windows for private application settings.
  99.  
  100.     'Frames' window:
  101.     ~~~~~~~~~~~~~~~~
  102.     The  frames window allows you to configure the look of frames and groups.
  103. This should be mostly self-explaining.
  104.  
  105.     'Pens' window:
  106.     ~~~~~~~~~~~~~~
  107.     You  can  change  window backgrounds in this window.  For each background
  108. you may select a pattern or alternatively a pen.
  109.  
  110.     'Windows' window:
  111.     ~~~~~~~~~~~~~~~~~
  112.     This  window  contains  the  Triton  window  manager.  The list shows all
  113. windows  of  the  selected  application which have been opened since the last
  114. reboot  or  are  saved  permanently  to  'envarc:Triton'.   The  windows  are
  115. displayed  by  their  titles (if available; otherwise the ID number in square
  116. brackets).   If  you  close  a  Triton  window, Triton will remember its last
  117. dimensions  in  a  file  in  'env:Triton',  so  that  it  will  have the same
  118. dimensions  when  you  reopen  it.  If you want to keep the window dimensions
  119. permanently,  so that they are always available (unless you change them later
  120. on),  select  the  appropriate  window  and click on 'Snapshot'.  This system
  121. works  just like the window snapshotting of the Amiga Workbench.  If you want
  122. Triton  to  'forget'  a  custom  window  position  and  reposition the window
  123. according to the original positioning information (e.g.  centering the window
  124. on  the  screen  after chosing a new screen resolution), you can 'UnSnapshot'
  125. the   window.    The   gadgets  'Snapshot  all'  and  'UnSnapshot  all'  will
  126. (un)snapshot  all  windows of the currently selected application.  The gadget
  127. 'Info'  will  bring  up  a  requester  containing  some information about the
  128. currently selected window.
  129.  
  130.     'System' window:
  131.     ~~~~~~~~~~~~~~~~
  132.     The  system  window  contains  all  global  settings.  Currently only the
  133. public  screen manager is included here.  You can add, delete and edit public
  134. screens.  Double click on a screen or select 'Use' and the name of the screen
  135. will  be  copied  into  the  above string gadget.  This is the screen for the
  136. currently  selected application.  You may also type in any other screen name.
  137. When Triton opens a window, it will first look if the specified screen exists
  138. and  utilize it in this case.  Otherwise it will try to create it if an entry
  139. for  this  screen  can  be found in the screen manager.  If this doesn't work
  140. either,  Triton  will fall back onto the default public screen.  You can test
  141. how  a  screen  will look by selecting 'Test'.  The screen will be opened and
  142. can  be  closed again by closing the information window which is displayed in
  143. it.  The screen will not be made public when testing.
  144.  
  145.     Note that the screen manager settings override any specifications made by
  146. the  programmer.  Setting an application's screen to '«Program default»' will
  147. make  it  use the screen specified by the programmer.  Anyhow only public and
  148. workbench  screen  windows  can be promoted using the screen manager.  Custom
  149. screen  windows  will  always  open  on  the  custom  screen specified in the
  150. program.
  151.  
  152.  
  153. 4. Program History
  154. ==================
  155.  
  156. *****************************************************************************
  157. RELEASE 1.1 (Version 2.74)
  158.  
  159.     First release.
  160.  
  161. *****************************************************************************
  162.  
  163.                   __
  164.                __///
  165.                \\\/...if(2B|!2B) user->prefs.shakespeare=TRUE;
  166.