home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / x / volume18 / bricons-1.0 / part01 / bricons.txt < prev    next >
Encoding:
Text File  |  1992-08-03  |  7.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4. BRICONS(l)        MISC. REFERENCE MANUAL PAGES         BRICONS(l)
  5.  
  6.  
  7.  
  8. NAME
  9.      bricons - quick start  up  utility  for  applications  using
  10.      text, icons and pop-up menus on an X display
  11.  
  12. SYNOPSIS
  13.      bricons  [options]
  14.      [-file] [-col] [-help] [-sensitive] [-bmdir]
  15.  
  16. DESCRIPTION
  17.      Bricons program allows the user to quickly start up applica-
  18.      tions  by  selecting the appropriate button from the display
  19.      and pressing the left mouse button.  A maximum of up to six-
  20.      teen main menu buttons can be displayed. Each main menu but-
  21.      ton can launch an application or pop-up a sub menu  contain-
  22.      ing more buttons. The buttons can be represented as a bitmap
  23.      or as text.
  24.  
  25.      Information on how the program is  to  present  each  button
  26.      (either  as a bitmap or text) and the application that is to
  27.      be executed if that  button  is  selected  is  contained  in
  28.      script  file  called .briconsrc.  This file should be stored
  29.      in the same directory as the program is executed from.
  30.  
  31.      The .briconsrc file contains a number of key words which are
  32.      used  to indicate if the button label is some text or a bit-
  33.      map and if the button is to pop-up a sub menu  or  launch  a
  34.      program.  These key words are explained below:
  35.  
  36.      The .briconsrc file should start with the keyword  %icon  or
  37.      %text  The key word %icon indicates that the button label is
  38.      a bitmap.  This should be followed by the file name contain-
  39.      ing the bitmap.  For example:
  40.  
  41.                            %icon clock.icon
  42.  
  43.      The key word %text indicates that the button label  is  some
  44.      text.   The  text can be split over three lines by using the
  45.      new line character \n.  For example:
  46.  
  47.                       %text Line1\nLine2\nLine3
  48.  
  49.      would be presented as:
  50.                                 Line1
  51.                                 Line2
  52.                                 Line3
  53.  
  54.      Once a  button  has  been  selected  it  is  prevented  from
  55.      accidentally  being  re-selected by "graying out" the button
  56.      (default action).  Sometimes however it maybe  desirable  to
  57.      allow the button to be selected more than once.  This can be
  58.      done be using the keyword %icon+ or %text+
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1   Last change: 28th March 1992                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. BRICONS(l)        MISC. REFERENCE MANUAL PAGES         BRICONS(l)
  71.  
  72.  
  73.  
  74.      The next line in the .briconsrc file should  either  contain
  75.      the key word %sub_menu or the application to be started.  If
  76.      the name of an application  is given then a check is made to
  77.      see if such an program can be executed.  If the program does
  78.      not exist or is not in the users path then an error  message
  79.      is printed and the button associated with the application is
  80.      ignored.
  81.  
  82.      If the key word %sub_menu is used then a pop-up sub menu  is
  83.      created.   Any further buttons defined in the briconsrc file
  84.      will appear in the sub menu for that button  until  the  key
  85.      word  %end_sub_menu  is found.  A maximum of ten buttons are
  86.      allowed in a single pop-up sub menu.
  87.  
  88.      Any line in the .briconsrc file starting with a #  character
  89.      is treated as a comment and will be ignored.
  90.  
  91.      This program has four default buttons labelled source, edit,
  92.      help  and  quit.   The  edit  button allows the user to edit
  93.      there icon file (default being an empty source button causes
  94.      the  program  to  distory  all  the  current  buttons  being
  95.      displayed and re-read the icon file and display the new but-
  96.      tons.
  97.  
  98. OPTIONS
  99.      bricons accepts all of  the  standard  X   Toolkit   command
  100.      line options along with the additional options listed below:
  101.  
  102.      -file
  103.           Tells the program to read  this  file  instead  of  the
  104.           default file.
  105.  
  106.      -col Indicates the number of  buttons  in  a  column  before
  107.           starting  a  new row.  The default number of columns is
  108.           15.
  109.  
  110.      -help
  111.           Tells the program the path for the help file.
  112.  
  113.      -sensitive
  114.           Toggle used for default "graying out" of selected  but-
  115.           tons.   If  set  to  TRUE  then buttons will "gray out"
  116.           unless specifically requested not to.
  117.  
  118.      -bmdir
  119.           This program will search the default  bitmap  directory
  120.           (./bitmaps)  for  any  bitmaps  that  are to be used to
  121.           represent buttons.  If you wish to add different bitmap
  122.           directories  then  use  this command line argument fol-
  123.           lowed by a colon separated list  of  path  names.   For
  124.           example  if  the  program  needs to find bitmaps in two
  125.           different directories then the following can be entered
  126.  
  127.  
  128.  
  129. Sun Release 4.1   Last change: 28th March 1992                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. BRICONS(l)        MISC. REFERENCE MANUAL PAGES         BRICONS(l)
  137.  
  138.  
  139.  
  140.           at the command line:
  141.  
  142.            bricons -bmdir /usr/local/bitmaps:/usr/mydir/bitmaps
  143.  
  144.  
  145. X DEFAULTS
  146.      The bricons program reads the .Xdefaults file  and  Xbricons
  147.      resource  file  during  startup  and  uses  the  appropriate
  148.      resource  specification  to  customise  the  appearance   or
  149.      characteristics  of  its  display.  This program understands
  150.      all of the core resource names and classes as well as:
  151.  
  152.      no_of_cols
  153.           Specifies the number of buttons in a column.
  154.  
  155.      icon_file
  156.           Specifies path name for icon file to be read.
  157.  
  158.      help_file
  159.           Specifies path name for help file.
  160.  
  161.      icon_dirs
  162.           Specifies path name for bitmap directories.
  163.  
  164.  
  165. SETTING BITMAP DIRECTORIES
  166.      This section explains how to specify bitmap file paths using
  167.      the  .Xdefaults  file.  For the quickest and simplest method
  168.      see the OPTIONS section under -bmdir.
  169.  
  170.      This program will search the default  bitmap  directory  for
  171.      any bitmaps that are to be used to represent buttons. If the
  172.      user wishes the program to search other directories for bit-
  173.      map  files  then  this  should  be  specified  in  the users
  174.      .X11defaults file.  *BitmapFilePath: should  be  added  fol-
  175.      lowed  by  colon separated path names where the bitmap files
  176.      can be found.  For example:
  177.  
  178.      *BitmapFilePath:    /usr/local/include/X11/bitmaps:/usr/mydir/bitmaps
  179.  
  180. RESOURCE FILES
  181.      The Xbricons file specifies the required resources.  To make
  182.      sure  the  program uses the resources file set the following
  183.      line in your .login:
  184.             setenv  XUSERFILESEARCHPATH ~/app_defaults/%N
  185.  
  186.      and place all all resources in the app_defaults directory.
  187.  
  188. WIDGETS
  189.      The bricons program is  a  toolkit-based  application  which
  190.      consists  of  a combination of widgets.  In order to specify
  191.      resources, it is useful to know the hierarchy of the widgets
  192.  
  193.  
  194.  
  195. Sun Release 4.1   Last change: 28th March 1992                  3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. BRICONS(l)        MISC. REFERENCE MANUAL PAGES         BRICONS(l)
  203.  
  204.  
  205.  
  206.      which compose bricons.  In the list below, indentation indi-
  207.      cates hierarchical structure.   The  widget  class  name  is
  208.      given first, followed by the widget instance name.
  209.  
  210.           Xbricons  toplevel
  211.                Form box
  212.                     Command   action[18]
  213.                     OverrideShell  popup_shell
  214.                          Form popup_layout
  215.                          Command   sub_action[10]
  216.  
  217. EXAMPLE
  218.      Below is an example of a simple .briconsrc file:
  219.  
  220.      # <-- a line starting with a '#' is a comment line
  221.      #
  222.      #       Bri's icon file
  223.      #
  224.  
  225.      # first line must have keyword %icon or %text
  226.      # to indicate if button is an icon
  227.  
  228.      %icon calculator
  229.      xcalc
  230.      %text Games\n sub\n menu
  231.      %sub_menu
  232.           %text xeyes
  233.           xeyes
  234.           %text othello
  235.           othello
  236.      %end_sub_menu
  237.  
  238.  
  239.  
  240. BUGS
  241.      After selecting the source button the  buttons  may  not  be
  242.      re-displayed  correctly.   Selecting  the  source  button  a
  243.      second time may help.
  244.  
  245. AUTHOR
  246.      Bruce R Ingram, University of Kent at Canterbury.
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 4.1   Last change: 28th March 1992                  4
  262.  
  263.  
  264.  
  265.