home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / gfx / show / superview-lib / docs / controlpads < prev    next >
Encoding:
Text File  |  1995-05-28  |  12.0 KB  |  201 lines
  1.  
  2.   ControlPad-FAQ V11.7 (23.5.95)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.   List has been sorted alphabetically and by module types.
  6.  
  7.   ============================================================================
  8.   MAIN LIBRARIES
  9.   ----------------------------------------------------------------------------
  10.   ControlPad-Name     : "ENV:superview-library/LIBRARY.controlpad"
  11.   ControlPad-Commands : - ANYDATATYPES
  12.                           ; if this KeyWord is set, ANY DataTypes will
  13.                           ; be loaded and tried to be displayed in some
  14.                           ; way (e.g. not only pictures, but also 8SVX
  15.                           ; sounds or ANIM-Files ...)
  16.                         - DEFAULTSVDRIVER=<#?.svdriver>
  17.                           ; Define, which SVDriver should be used
  18.                           ; by default.
  19.                           ; E.g. "DEFAULTSVDRIVER=AGA.svdriver"
  20.   ----------------------------------------------------------------------------
  21.   ControlPad-Name     : "ENV:superview-library/superviewsupport.controlpad"
  22.   ControlPad-Commands : - C2P=<OS|SV>
  23.                           ; determines, whether chunky to planar conversion
  24.                           ; is managed via the appropriate OS functions
  25.                           ; or via internal ones.
  26.                           ; Due to various problems with the OS functions
  27.                           ; "SV" is now default.
  28.                           ; Be careful when using "OS" with GfxCards,
  29.                           ; which careless patched graphics.library.
  30.   ============================================================================
  31.   SVOBJECTS
  32.   ----------------------------------------------------------------------------
  33.   ControlPad-Name     : "ENV:superview-library/FastILBM24.controlpad"
  34.   ControlPad-Commands : - BUFFERSIZE=<Size in Bytes>
  35.                           ; how many bytes should be buffered
  36.                             (more = faster)
  37.                           ; Default is 8192, minimum is 256
  38.                         - PASSTHROUGH
  39.                           ; do not recognize ANY pictures, so that
  40.                           ; they e.g. might be passed through to
  41.                           ; ILBM.svobject instead
  42.                         - DITHERMODE=<HAM6_QUICK|HAM8_QUICK>
  43.                           ; Default is HAM6_QUICK
  44.   ----------------------------------------------------------------------------
  45.   ControlPad-Name     : "ENV:superview-library/JPEG.controlpad"
  46.   ControlPad-Commands : - COLORDEPTH = <8/24>
  47.                           ; should the output be done as 8 or 24 Bit Data ?
  48.                           ; default is 8 Bit data
  49.                         - QUANTIZATION = <0..100>
  50.                           ; 0   - no quality, big compression
  51.                           ; 100 - best quality, no compression
  52.                           ; never use these values, but try something
  53.                           ; like 20, 50, 75 (default: 75)
  54.                         - AVAILMEM = <Bytes>
  55.                           ; specify this if you want to prevent your
  56.                           ; memory lists to be checked with AvailMem()
  57.                           ; (useful sometimes, since AvailMem() also
  58.                           ;  does a validity check)
  59.   ----------------------------------------------------------------------------
  60.   ControlPad-Name     : "ENV:superview-library/PCD.controlpad"
  61.   ControlPad-Commands : - OUTPUTFORMAT=<BASE/16 | BASE/4 | BASE >
  62.                           ; specifies the output resolution to be used
  63.   ----------------------------------------------------------------------------
  64.   ControlPad-Name     : "ENV:superview-library/SVO.controlpad"
  65.   ControlPad-Commands : - PACKMETHOD=<xxxx>
  66.                           ; if this one is specified, it is tried to
  67.                           ; pack the resulting file with the specified
  68.                           ; XPK-Packer. If this fails, the file keeps
  69.                           ; unpacked.
  70.   ============================================================================
  71.   SVDRIVERS
  72.   ----------------------------------------------------------------------------
  73.   ControlPad-Name     : "ENV:superview-library/AGA.controlpad"
  74.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  75.                           ; (case-sensitive, ".svoperator" may be added)
  76.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  77.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  78.                           ; specifies, which operation should be performed
  79.                           ; on 24 Bit graphics _before_ displaying them
  80.                           ; (if not specified, "best guess" colors will
  81.                           ;  be used, which is really slow)
  82.                         - BITMAPCOPY=<DIRECT|RTG>
  83.                           ; "BITMAPCOPY=RTG" prevents AGA.svdriver from
  84.                           ; directly copying into Bitmaps, which will
  85.                           ; result in a usage of more memory, but keeps it
  86.                           ; working.
  87.                           ; Default is "BITMAPCOPY=DIRECT".
  88.   ----------------------------------------------------------------------------
  89.   ControlPad-Name     : "ENV:superview-library/ECS.controlpad"
  90.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  91.                           ; (case-sensitive, ".svoperator" may be added)
  92.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  93.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  94.                           ; specifies, which operation should be performed
  95.                           ; on 24 Bit graphics _before_ displaying them
  96.                           ; (if not specified displaying will fail)
  97.                         - BITMAPCOPY=<DIRECT|RTG>
  98.                           ; "BITMAPCOPY=RTG" prevents ECS.svdriver from
  99.                           ; directly copying into Bitmaps, which will
  100.                           ; result in a usage of more memory, but keeps it
  101.                           ; working.
  102.                           ; Default is "BITMAPCOPY=DIRECT".
  103.   ----------------------------------------------------------------------------
  104.   ControlPad-Name     : "ENV:superview-library/CyberGraphics.controlpad"
  105.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  106.                           ; beginning depth for opening CyberGraphics Screens
  107.                           ; Default is 16 Bit (which will also be tried
  108.                           ; when opening of a 24 Bit Screen fails)
  109.                           ; This does not concern colordepths < 16 Bit,
  110.                           ; except HAM6/8.
  111.                         - SMALLSCREENS
  112.                           ; unless this KeyWord is specified, it is not
  113.                           ; tried to open screens smaller than 320x240
  114.   ----------------------------------------------------------------------------
  115.   ControlPad-Name     : "ENV:superview-library/Retina.controlpad"
  116.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  117.                           ; beginning depth for opening Retina Screens
  118.                           ; Default is 24 Bit (if opening fails, it is
  119.                           ; also tried to open a 16 Bit Screen, then)
  120.                         - AUTOSCROLL=<ON|OFF>
  121.                           ; Disables any Autoscroll features, which
  122.                           ; results in STD_WIDTH for any Retina Screens
  123.                           ; Default is ON.
  124.                         - MAX_AUTOSCROLL_WIDTH=<Width>
  125.                           ; If the picture is wider than this value,
  126.                           ; we don't try to use autoscroll any longer.
  127.                           ; You should set this value, if your
  128.                           ; Retina has not much on-board RAM.
  129.                           ; Default is: (no restrictions)
  130.                         - MAX_AUTOSCROLL_HEIGHT=<Height>
  131.                           ; If the picture is higher than this value,
  132.                           ; we don't try to use autoscroll any longer.
  133.                           ; You should set this value, if your
  134.                           ; Retina has not much on-board RAM.
  135.                           ; Default is: (no restrictions)
  136.                         - PASSTHROUGH_MODES
  137.                           ; If Retina should ever support own
  138.                           ; ScreenMode definitions like "Retina:...",
  139.                           ; you should enable this switch.
  140.                           ; Default: (NOT SET !)
  141.   ============================================================================
  142.   SVOPERATORS
  143.   ----------------------------------------------------------------------------
  144.   ControlPad-Name     : "ENV:superview-library/24BitToHAM.controlpad"
  145.   ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL
  146.                                       |HAM8_QUICK|HAM8_WELL>
  147.                           ; specifies the HAM-Mode to be used and
  148.                           ; the resulting speed/quality
  149.   ----------------------------------------------------------------------------
  150.   ControlPad-Name     : "ENV:superview-library/CallPNM24.controlpad"
  151.   ControlPad-Commands : - PNMCOMMAND=<PBM command path and name>
  152.                           ; PNM command to be called
  153.                           ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale
  154.                         - PNMOPTIONS=<Options>
  155.                           ; Options for PNM command to be called
  156.                           ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0
  157.   ----------------------------------------------------------------------------
  158.   ControlPad-Name     : "ENV:superview-library/Crop.controlpad"
  159.   ControlPad-Commands : - CROP_LEFTEDGE=<Value>
  160.                           ; crop from x position
  161.                           ; (will be adjusted, if >= source width)
  162.                         - CROP_TOPEDGE=<Value>
  163.                           ; crop from y position
  164.                           ; (will be adjusted, if >= source height)
  165.                         - CROP_WIDTH=<Value>
  166.                           ; crop how many x pixels from leftedge
  167.                           ; (will be adjusted, if too large)
  168.                         - CROP_HEIGHT=<Value>
  169.                           ; crop how many y pixels from topedge
  170.                           ; (will be adjusted, if too large)
  171.   ----------------------------------------------------------------------------
  172.   ControlPad-Name     : "ENV:superview-library/Dither24Bit.controlpad"
  173.   ControlPad-Commands : - COLORDEPTH=<1..8>
  174.                           ; specifies the colordepth of the dithering
  175.                           ; output (1->2 Colors .. 8->256 Colors)
  176.   ----------------------------------------------------------------------------
  177.   ControlPad-Name     : "ENV:superview-library/ExtractGrayScales.controlpad"
  178.   ControlPad-Commands : - COLORDEPTH=<1..8>
  179.                           ; specifies the colordepth of the grayscaled
  180.                           ; output (1->2 Colors .. 8->256 Colors)
  181.   ----------------------------------------------------------------------------
  182.   ControlPad-Name     : "ENV:superview-library/HilbertDither256.controlpad"
  183.   ControlPad-Commands : - BACKGROUND=<BLACK|WHITE>
  184.                           ; defines, which of the two colors will act
  185.                           ; as background color. Useful e.g. for printing.
  186.   ----------------------------------------------------------------------------
  187.   ControlPad-Name     : "ENV:superview-library/Rotate.controlpad"
  188.   ControlPad-Commands : - DEGREES=<90|180|270>
  189.                           ; rotate by how many degrees (reverse clockwise) ?
  190.   ----------------------------------------------------------------------------
  191.   ControlPad-Name     : "ENV:superview-library/Scale50.controlpad"
  192.   ControlPad-Commands : - METHOD=<HALF|DOUBLE>
  193.                           ; scale to which size ?
  194.   ----------------------------------------------------------------------------
  195.   ControlPad-Name     : "ENV:superview-library/XOR.controlpad"
  196.   ControlPad-Commands : - XORVALUE = <0..255>
  197.                           ; 0 and 255 will not be the best decision.
  198.                           ; Use 15 or something like this.
  199.   ----------------------------------------------------------------------------
  200.  
  201.