Sat Aug 17 21:51:54DT 1996
Diana Starr
README file for buttonfly.

Wed Aug 13 17:11:04 PDT 1997
David "Sprout" Anderson
README file for buttonfly (v.2)
-------------------------------------------------------------

With the release of IRIX 6.3, some significant change was 
made to the structure of the demos directory, and how buttonfly
loads and displays the default installed demos.  Following is
an excerpt from the man page which describes these changes
as they impact buttonfly.  For more details on buttonfly
and its menu files, please review the man page for buttonfly.

AUDIO
With the release of IRIX 6.3, audio was added to buttonfly.
When the buttons fly forward or back, the system will play 
corresponding audio files located in /usr/demos/Demo_Interfaces/Buttonfly.

If the middle mouse option is used to move through the buttons
without flight, the audio will not play.  The audio option
can be toggled off by running buttonfly -a.

INTEGRATION WITH WEB-BASED INTERFACE 
With the release of IRIX 6.3, we have added a web-based interface
to the demos.  Since this interface already sorts demos based 
on categories, we were able to use a perl script (mkmenu) to access 
the sorted lists of demos and create buttonfly heirarchies dynamically.  
When  buttonfly is started now, by default, it will have the categories 
from the web UI:  Features, Industries, and Hardware. 

The sub-categories which fall beneath these are viewable from
the Search page of the web-based interface.  This is accessible
from the system toolchest  Find Demos menu option, or by typing  
http://localhost/Demos from your local web browser.

Although these demos do not require the traditional structure, 
this structure is still supported, particularly since these changes
were made via scripts, not in the buttonfly source code.  

To use buttonfly for accessing demos from the web-based interface
(located in  /usr/demos/General_Demos) and demos with the traditional 
heirarchy, just install or link the traditional heirarchy into  
/usr/demos/Buttonfly.  The mkmenu script automatically adds a button 
based on the menu file located in the new directory beneath  
/usr/demos/Buttonfly. 

AUTHOR

Thant Tessman and Gavin Bell
Audio support: Diana Starr
Perl scripts: David (Sprout) Anderson

FILES
/usr/demos/Demo_Interfaces/Buttonfly/
        buttonfly               - executable 
        .menu                   - custom menu file which supports 
                                  the display of demos from the web-based 
                                  interface and any demos in 
                                   /usr/demos/Buttonfly 
        buttonfly.sh            - script to process input for buttonfly 
        Times-Italic.bw         - font file 
        sea.rgb                 - texture 
        manwsh                  - script: launches shell with man page 
        redirect                - script: redirects output of demo 
        in.aiff                 - audio for buttons flying in 
        out.aiff                - audio for buttons flying out 
        bf_menu.pl              - script: dynamically creates
                                  buttonfly menu files for demos
                                  installed in web interface
        bf_const.pl             - script: supports bf_menu.pl

 /usr/demos/buttonfly        - for convenience, this is a link to 
                                  the above buttonfly.sh script 

 /usr/demos/Buttonfly/
        buttonfly.sh            - copy of above script to process input 
        Additional Demo Trees   - Any traditionally structured buttonfly
                                  heirarchies can be installed here
        

