home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / programming / libraries / svlib102u.lha / superview-lib_USR / Docs / HowToInstall.doc < prev    next >
Encoding:
Text File  |  1995-02-17  |  3.6 KB  |  106 lines
  1.  
  2.  Installation guide for experienced users
  3.  
  4.  Some quick notes on how to install the program if the InstallerScript
  5.  does not work, or if additional things have to be done
  6.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  7.  
  8.  *** Overview ***
  9.  
  10.  You do not need to install the libraries to LIBS: itself.
  11.  For example you may create an additional LIBS-Dir somewhere else
  12.  (let's say "HD1:libs") then start the Installer and after that open
  13.  a shell. Then type something like:
  14.  
  15.      Assign LIBS: HD1:LIBS ADD
  16.      Assign LIBS: SYS:LIBS REMOVE
  17.  
  18.  and install superview.library with the Installer.
  19.  After that type again
  20.  
  21.      Assign LIBS: SYS:LIBS ADD
  22.  
  23.  and add an entry like
  24.  
  25.      Assign LIBS: HD1:LIBS ADD
  26.  
  27.  to your User-Startup.
  28.  You also should place an Assign for the virtual memory path there :
  29.  
  30.      Assign VMEM: HD1:Somewhere
  31.  
  32.  
  33.  After installation, your LIBS: directory should look similar to this :
  34.  
  35.  (libs)
  36.         (svobjects)    XXX.svobject
  37.                        YYY.svobject
  38.                        ...
  39.         (svdrivers)    AAA.svdriver
  40.                        BBB.svdriver
  41.                        ...
  42.         (svoperators)  123.svoperator
  43.                        456.svoperator
  44.                        ...
  45.   superview.library
  46.   superviewsupport.library
  47.  
  48.  
  49.  Note, that is is important, that the names of the single Libraries
  50.  are exactly the same as in the original archive (case-sensitivity).
  51.  If you copy "YUVN.svobject" as "yuvn.svobject" it will no longer
  52.  be recognized by the Library.
  53.  This is because the name is also hard-coded for identification and
  54.  since the corresponding functions are case-sensitive, there's a
  55.  need for such restrictions.
  56.  
  57.  Also, some SVOBjects/SVOperators may need a (relatively) large
  58.  Stacksize, e.g. Dither24.svoperator.
  59.  When using it with only 4096 Bytes of Stack memory it'll sure crash.
  60.  Use at least 32768 Bytes with any program using the library.
  61.  
  62.  *** Details ***
  63.  
  64.  After you've performed the main installation procedure, you might
  65.  wish to do some more detailed configurations...
  66.  Usually, configuration files (ControlPads) for SVObjects, SVDrivers,
  67.  SVOperators or the library itself are placed at the location
  68.  "ENV:superview-library/".
  69.  Note, that all ControlPad-entries are currently CASE-SENSITIVE.
  70.  
  71.       Name:      LIBRARY.controlpad
  72.       Subject:   superview.library
  73.       Suggested:    DEFAULTSVDRIVER=ECS.svdriver
  74.                  or DEFAULTSVDRIVER=AGA.svdriver
  75.                  or ...
  76.       Why:       set it according to your machine's OS/chipset capabilities
  77.  
  78.       Name:      AGA.controlpad
  79.       Subject:   AGA.svdriver
  80.       Suggested: 24BITOPERATOR=24BitToHAM
  81.       Why:       dithers 24 Bit graphics to HAM6/8 (quick/well)
  82.                  (alternatively set "Dither24Bit", which can
  83.                   be used to create 2..256 Color output).
  84.  
  85.       Name:      JPEG.controlpad
  86.       Subject:   JPEG.svobject
  87.       Suggested: COLORDEPTH=8
  88.       Why:       dithers JPEG graphics to 256 Colors while reading
  89.  
  90.       Name:      SVO.controlpad
  91.       Subject:   SVO.svobject
  92.       Suggested: PACKMETHOD=NUKE
  93.       Why:       packs output with NUKE (or whatever you wish)
  94.  
  95.  Also: When selecting the appropriate SVDriver for your system,
  96.  please note, that "ECS" and "AGA" only refer to the original
  97.  Amiga chipsets and OS versions. Usually owners of an ECS Amiga
  98.  with GfxCard may - and should - use AGA.svdriver as well!
  99.  
  100.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  101.  25.01.95  This installation guide refers to superview.library V9.13.
  102.            There might be more or different things to be done in
  103.            the future!
  104.  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  105.  
  106.