home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / exampleCode / README < prev   
Encoding:
Text File  |  1994-08-02  |  14.7 KB  |  254 lines
  1.  
  2.                      ~4Dgifts/toolbox/src/exampleCode README
  3.  
  4.         This subtree contains source code implementations we collected
  5.         or wrote that presents the developer with very useful and 
  6.         helpful "learning-by-example" applications. 
  7.  
  8.     `!' indicates new or updated as of version 4.2
  9.       
  10.  
  11.  
  12.        3Dmodeling : routines (and example programs) to help build solid 
  13.                     models.
  14.  
  15.        GLX        : Mixed model programs (using GL-Xlib or GL-Motif/Xt).
  16.  !                - texvol:  performs volume rendering using 2d or 3d textures
  17.                   - plus 10 other implementions/sets of examples.
  18.  
  19.        MP         : multi-processing/parallel computing examples:
  20.                     how to combine mips1 & mips2 objects into a single
  21.                     mips1/2 executable thru a jump table implementation,
  22.                     and a using a high resolution timer of the io3 board
  23.                     on an r4k-based SGI system.
  24.  
  25.        SciTex     : a paper and example code describing "Texture Mapping in
  26.                     Technical, Scientific and Engineering Visualization".
  27.  
  28.        X          : X stuff--and as big as "X" is, its a bum we don't have 
  29.                     more here than we do.....:
  30.  !                - 2 examples implementing cursors in X--one using "Font" 
  31.                     and the other "Pixmap" cursors,
  32.  !                - 2 X font examples--one working with glpyhs, the other,
  33.                     implementing scalable fonts,
  34.  !                - xshowcmap extension, useful in debugging problems dealing 
  35.                     with multiple colormaps and/or visuals,
  36.                   - Xserver contains PostScript documents on Silicon Graphics 
  37.                     X server papers:
  38.                     -- "A Fully Functional Implementation of Layered Windows"
  39.                     -- "Program X Overlay Windows"  
  40.                     -- "Going Beyond the MIT Sample Server:  The Silicon 
  41.                         Graphics X11 Server"
  42.                     -- "A Three Color Cursor for X"
  43.                     as well as accompanying sample src and a Makefile to 
  44.                     build the executables.
  45.  !                - XtAppInitwIcon:  generates multi-color icons using Xt.
  46.  
  47.        audio      : example code employing functionality in lib*audio*.a:
  48.  !                - harmonizer:  real-time audio pitch bender example program,
  49.  !                - example programs using libmidi.a illustrate basic use
  50.                     of the MIDI library,
  51.  !                - sonic:  real time audio spatialization example w/graphics,
  52.                   - aiffdoc.ps--paper on "Audio Interchange File Format 
  53.                     AIFF-C, A revision to include compressed audio data";
  54.                   - ascope--displays the left channel of data coming in 
  55.                     from an audio port;  
  56.                   - DAT examples: - dodat:  a simple DAT command interface,
  57.                                   - cdtodat:  simple CD-to-DAT copying examp,
  58.                                   - verifydat:  simple DAT checking program;
  59.                   - reverb:  simulated reverberation for real-time audio 
  60.                     input and output;
  61.                   - rock--the indigo memorial barbeque theme song rapp as 
  62.                     constructed and sung by mr. totally insane;
  63.                   - somePlayback--code to generate a bunch of oscillators,
  64.                     waveforms, change playback rate, mix, change pitch, 
  65.                     loop audio samples and send them to the speaker;  and
  66.                   - tablenet--generate a small series of waveforms and 
  67.                     write them into a 16-bit AIFF file.
  68.  
  69.        calc       : implementation of a Reverse Polish Notation calculator.
  70.  
  71.        cap        : demonstration of a technique to "cap" a clipped 
  72.                     (cut-away) solid object. 
  73.  
  74.        csg        : includes ascii-copy of a paper on and an implementation 
  75.                     of constructive solid geometry.
  76.  
  77.        fconv      : a Motif-based numeric format conversion utility for hex,
  78.                     octal and decimal equivalents.
  79.  
  80.        games      : contains source code for different graphics/audio game 
  81.                     software, including IndiZone games:
  82.  !                - vroom:  swank opengl slot car racing in the future,
  83.                   - blix:  the mighty mouse hero of indizone,
  84.                   - cycles:  solo || multiplayer (network) motorcycle game
  85.                   - gold:  synthetic fish bowl simulation,
  86.                   - oort:  vehicular combat on an asteroid,
  87.                   - sw:  (Spacewar) combat in space,
  88.                   - tagh:  variation on the children's game of tag, 
  89.                     as well as other perennial favorites:
  90.                   - buzzwordBingo:  all-time SGI hit, buzzword bingo,
  91.                   - cubetris:  a 3D IRIS GL tetris game,
  92.                   - seahaven:  Xlib C++ graphical solitare card playing game.
  93.  
  94.        i18n       : examples of internationalization and localization with 
  95.                     implementation of wide characters for string manipulation
  96.                     as well as XPG/3 and MNLS message cataloging.  Along
  97.                     with 5.1 Irix, Motif 1.2 and X11 R5, some examples also 
  98.                     require installed images of intl.sw subsystems.
  99.  
  100.        inventor   : contains inventor documents plus source examples including:
  101.  !                - Open Inventor prog using draggers for direct manipulation
  102.                     of a surface of revolution (includes its own run-time DSO),
  103.  !                - Open Inventor files demo an interactive direct manipulation
  104.                     of a Track Light,
  105.  !                - modified inventor_dev.src.sample src implements handling 
  106.                     for the Spaceball input device,
  107.  !                - sample OpenIV files demo'ing use of draggers and engines in
  108.             "self-manipulating" examples,
  109.  !                - html Inventor documentation files--FAQ + Known Bugs, Fixes,
  110.                     and Workarounds--from the Silicon Surf www.sgi.com site,
  111.                   - an easy-to-use 3D object-modeler rich in Open Inventor,
  112.                   - "How to Write an Open Inventor File Translator" PS doc,
  113.                   - hands-on lab + solutions for Open Inventor 2.0 + 38-page
  114.                     showcase document on the Open Inventor 3d Toolkit,
  115.                   - PostScript "Quick Reference Guide" on Open Inventor nodes 
  116.                     and the Inventor file format,
  117.                   - an extension of the stock SceneViewer enabling 2 or more
  118.                     people on the same net to access the same input file 
  119.                     simultaneously and immediately see each other's changes,
  120.                   - soundspheres:  Open Inventor-version of a very primitive 
  121.                     spacial audio program,
  122.                   - Open Inventor versions of two example "template" programs
  123.                     for a Walk Viewer and a Player,
  124.                   - Open Inventor-version of ivcalc, a full function infix 
  125.                     calculator with audio, textures, (i.e. the works), etc,
  126.                   - additional Inventor 1.1.2 Nodes--Audio and Highlight--plus 
  127.                     audio and Inventor Classes--Play and Record, and Inventor
  128.                     Spline,
  129.                   - DxfToIv binary+man page--convert DXF files to Inventor.
  130.                                  
  131.        irix       : new tree containing irix-based/related/relative stuff:
  132.                   - collection of docs relating to compilers, [p]make, cshell,
  133.                   - sproc/semaphore source implements raising a sub-process's
  134.                     priority to circumvent preemption,
  135.                   - scripts subtree of c-shell script utilities providing,
  136.                     if nothing else, shell programming "source" -- 11 general-
  137.                     purpose, 11 rcs-specific,
  138.                   - tools dir with irix/system -level programs:
  139.                     Lastrev:  get RCS revisions/symbols info & print to stdout
  140.                     chktime:  compares 2 file's mod. times returning {-1|0|1}
  141.                     getopt:   enhanced version of the unix system call
  142.                     gettime:  get last mod. time of file and writes to stdout
  143.                     gpasswd:  like passwd, sets the password for a group
  144.                     isIn:     returns true/false if 1st param equal to any
  145.                               other params on command line
  146.                     listWMres:  lists all resources known to window manager
  147.                     printf:   better than the IRIX 5 one because it can handle
  148.                               all the standard C types
  149.                     rcstime:  returns time of last RCS update in an RCS file
  150.                     strlen:   shell-equivalent of strlen(3C) subroutine
  151.                     unique:   returns all parameters passed on the command 
  152.                               line removing any duplicates
  153.                     vacupd:   reads/modifies data in vacation database files
  154.  !                - uucpVadmin:  now contains inst image as well as src for
  155.                     UUCP vadmin tool, allowing GUI set up of UUCP files and 
  156.                     confirmation that communication to a modem is good.
  157.  
  158.        networking : contains source code for networking example programs.
  159.  !                - "HIPPI Performance on IRIX 5.2" white paper plus two
  160.                     accompanying source programs,
  161.                   - ifaddress, prints link-level address of an Ethernet or 
  162.                     FDDI interface,
  163.                   - rpcdemo, an example RPC client and server application,
  164.  !                - short_timer, checks whether remote host responds quickly,
  165.                     avoiding long wait for a network timeout.
  166.  
  167.        opengl     : OpenGL example progs+libs+docs including:
  168.  !                - OpenGL Attribute Tester tests OpenGL functionality on 
  169.                     different platforms, with GUI to test most changeable 
  170.             OpenGL attributes,
  171.  !                - OpenGL Color Chooser Widget - libGLColorChooser.a, 
  172.                     identical to IRIS GL version found in libSgm,
  173.  !                - implementation of picking in OpenGL including features of 
  174.                     an X overlay on top of an RGBA, double- and depth- 
  175.                     buffered window,
  176.                   - three articles on "OpenGL and X", a series published in 
  177.                     the "X Journal," plus 6 accompanying program examples,
  178.  !                  include updated renderboth.c program,
  179.                   - sample progs--19 new (2 implement iris-GL-type popup menu
  180.                     functionality), 4 updated, 38 total--based solely on Xlib
  181.                     for those not inclined to go the toolkits road,
  182.                   - "debugHelper" provides a way to override DSO functions to
  183.                     trace a program's OpenGL calls without recompiling,
  184.                   - sample progs based on the Motif widget, libGLw.a, plus 2 
  185.                     new examps:
  186.                     - textfun:  poor-man's OpenGL font manager (uses libXm.so
  187.                                 only--no libGLw.a),
  188.                     - xmblur:  motion blur demo,
  189.                   - dinomometer:  synthetic modeling benchmark for OpenGL
  190.                   - tree of implementations of GLX extensions (2 so far)
  191.                   - nurbsTrim:  makes a trimmed NURBS surface in OpenGL and
  192.                     Inventor
  193.                   - opengl motif-based interference checking demo,
  194.                   - sample programs based on libtk+Xlib,
  195.                   - on-line copy of all programs discussed in "The OpenGL 
  196.                     Programming Guide," book,
  197.                   - isfast contains performance measure routines indicating if
  198.                     a given OpenGL feature is fast or not, 
  199.                   - xglinfo displays information about an X server supporting 
  200.                     the OpenGL extension, especially wrt visuals,
  201.                   - 3 PostScript files containing the OpenGL specification.
  202.  
  203.  !     smoke      : Texture Mapped `smoke' special effects implementation.
  204.  
  205.        speech     : starting to create a bonafide speech recognition subtree:
  206.                   - beta inst images of the speech_eoe & speech_dev products,
  207.                   - binary utilities to enhance one's speech run-time envm;
  208.                   - basic speech recognition example programs,
  209.                   - lackey:  a speech aware application launcher, lackey was 
  210.                     developed using the in-development version of SGI's speech 
  211.                     recognition software.  This is an introduction to using 
  212.                     the speech API and the architechture of the speech 
  213.                     software system.
  214.  
  215.        stencil    : three programs implementing drawing in the stencil 
  216.                     planes.
  217.  
  218.        stereo     : contains src for software-stereo-in-a-window ala irix 5:
  219.                   - 2 simple "boilerplate" stereo implementations contained 
  220.                     in 4 OpenGL/motif programs,
  221.                   - software-stereo-in-a-window or "SoftStereo" example code
  222.                     using libgl and libX11.
  223.  
  224.        swirl      : a texture generator program for texture maps.
  225.  
  226.        video:     : contains apps implementing functionality for digital video
  227.                     processing including:  
  228.                   - file listing software configurations for video option 
  229.                     products running 5.2 IRIX,
  230.                   - scrollmon:  creates realtime scrolling credits (from 
  231.                     either anti-aliased text or SGI rgb images) or titles 
  232.                     for video production,
  233.                   - security:  security camera for stopframe and motion
  234.                     detection,
  235.                   - seqgrab: VL sequential frame accurate capture source 
  236.                     (Galileo/VLAN),
  237.  !                - simpleVideo:  library + examples to provide the video
  238.                     programmer with a simple programmatic interface on top of 
  239.                     the video library (VL),
  240.                   - vidmap:  demos live or movie video texture-mapped to a 
  241.                     polygon.
  242.  
  243.  !!!!  viewkit:   : contains program source for viewkit-based applications:
  244.                   - VCal:  a calendar program with alarms,
  245.                   - builderExamples:  programs written using BuilderXcessory,
  246.                   - xcontact:  Address Book and/or Contact Management program.
  247.                   PLUS other viewkit stuff in the toolbox:
  248.                   ~4Dgifts/toolbox/src/apps/cmapDoctor/cmapdoctor
  249.                   ~4Dgifts/toolbox/src/apps/gvi
  250.                   ~4Dgifts/toolbox/src/exampleCode/opengl/oat
  251.                   ~4Dgifts/toolbox/src/exampleCode/video/security
  252.                   ~4Dgifts/toolbox/src/exampleCode/irix/uucpVadmin
  253.                   ~4Dgifts/toolbox/utilities/uil2VK
  254.