home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / s / super_view / superviewv5.51reg.lha / SuperViewEL / SuperViewLibrary / Docs / ControlPads next >
Text File  |  1996-07-27  |  25KB  |  414 lines
  1.  
  2.   ControlPad-FAQ V13.3 (18.7.96)
  3.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4.  
  5.   List has been sorted alphabetically and by module types
  6.   (information has been derived from docs basing on CPInfo-Files).
  7.  
  8.   ============================================================================
  9.   MAIN LIBRARIES
  10.   ----------------------------------------------------------------------------
  11.   ControlPad-Name     : "ENV:SuperView-Library/LIBRARY.controlpad"
  12.   ControlPad-Commands : - DEFAULTSVDRIVER=<#?.svdriver>
  13.                           ; Which SVDriver should be set, when
  14.                           ; SuperView-Library is beeing initialized ?
  15.                           ; For example: "DEFAULTSVDRIVER=AGA.svdriver"
  16.                         - ANYDATATYPES
  17.                           ; if this KeyWord is set, ANY DataTypes will
  18.                           ; be loaded and tried to be displayed in some
  19.                           ; way (e.g. not only pictures, but also 8SVX
  20.                           ; sounds or ANIM-Files ...)
  21.                           ; This changes are recognized each time, when
  22.                           ; a new handle for loading a file is being
  23.                           ; initialized - but may be superseded by specific
  24.                           ; program's settings internally.
  25.   ----------------------------------------------------------------------------
  26.   ControlPad-Name     : "ENV:SuperView-Library/superviewsupport.controlpad"
  27.   ControlPad-Commands : - C2P=<OS|SV>
  28.                           ; determines, whether chunky to planar conversion
  29.                           ; is managed via the appropriate OS functions
  30.                           ; or via internal ones.
  31.                           ; Due to various problems with the OS functions
  32.                           ; "SV" is now default.
  33.                           ; Be careful when using "OS" with GfxCards,
  34.                           ; which carelessly patched graphics.library.
  35.   ============================================================================
  36.   SVOBJECTS
  37.   ----------------------------------------------------------------------------
  38.   ControlPad-Name     : "ENV:SuperView-Library/AmiFIG.controlpad"
  39.   ControlPad-Commands : - AMIFIG_PATH=<fig2dev command path plus name>
  40.                           ; how fig2dev is to be called
  41.                           ; e.g. AMIFIG_PATH=Work:AmiFIG/fig2dev
  42.                           ; default is: fig2dev
  43.                         - STATUS=<ENABLED|DISABLED>
  44.                           ; allows to disable this module - for example
  45.                           ; to be able to use an other, program-specific
  46.                           ; import-module for the same file format
  47.   ----------------------------------------------------------------------------
  48.   ControlPad-Name     : "ENV:SuperView-Library/EPS.controlpad"
  49.   ControlPad-Commands : - EXTRACTMODE=<HEADER|PS>
  50.                           ; Determines, whether the preview image or
  51.                           ; the Postscript (TM) part should be extracted,
  52.                           ; while parsing the Postscript (TM) part requires
  53.                           ; a working Ghostscript installation with
  54.                           ; GhostScript.svobject being correctly configured
  55.                           ; default is: HEADER
  56.                         - SAVE_ROTATE=<ON|OFF>
  57.                           ; by default, the picture seems to be rotated
  58.                           ; with Postscript (TM) output of this module.
  59.                           ; Enabling SAVE_ROTATE will again re-rotate it to
  60.                           ; the original position.
  61.                           ; default is: OFF
  62.                         - SAVE_CENTER=<ON|OFF>
  63.                           ; centers the images on the page with the
  64.                           ; desired size of SAVE_WIDTH x SAVE_HEIGHT (or not)
  65.                           ; default is: ON
  66.                         - SAVE_RLE=<ON|OFF>
  67.                           ; allows to apply RLE compression to the
  68.                           ; PS output
  69.                           ; default is: OFF
  70.                         - SAVE_DPI=<value>
  71.                           ; DPI value to use for the output
  72.                           ; default is: 300
  73.                         - SAVE_WIDTH=<value>
  74.                           ; Width of the PS page
  75.                           ; default is: 612
  76.                         - SAVE_HEIGHT=<value>
  77.                           ; Width of the PS page
  78.                           ; default is: 762
  79.   ----------------------------------------------------------------------------
  80.   ControlPad-Name     : "ENV:SuperView-Library/FastILBM24.controlpad"
  81.   ControlPad-Commands : - BUFFERSIZE=<Size in Bytes>
  82.                           ; how many bytes should be buffered
  83.                             (more = faster)
  84.                           ; Default is 8192, minimum is 256
  85.                         - PASSTHROUGH
  86.                           ; do not recognize ANY pictures, so that
  87.                           ; they e.g. might be passed through to
  88.                           ; ILBM.svobject instead
  89.                         - DITHERMODE=<HAM6_QUICK|HAM8_QUICK>
  90.                           ; Default is HAM6_QUICK
  91.   ----------------------------------------------------------------------------
  92.   ControlPad-Name     : "ENV:SuperView-Library/GhostScript.controlpad"
  93.   ControlPad-Commands : - GS_PATH=<gs command path plus name>
  94.                           ; how GhostScript is to be called
  95.                           ; e.g. GS_PATH=Ghostscript:gs000
  96.                           ; default is: gs000
  97.                         - OUTPUTMODE=<PNG256|PNG24BIT>
  98.                           ; Output file format to be used
  99.                           ; (-sDEVICE parameter of GhostScript's gs).
  100.                           ; Only PNG supported yet.
  101.                           ; default is: PNG256
  102.                         - DPI=<value>
  103.                           ; DPI value to use for the converted output
  104.                           ; (-r parameter of GhostScript's gs)
  105.                           ; default is: 72
  106.                         - STATUS=<ENABLED|DISABLED>
  107.                           ; allows to disable this module - for example
  108.                           ; to be able to use an other, program-specific
  109.                           ; import-module for the same file format
  110.   ----------------------------------------------------------------------------
  111.   ControlPad-Name     : "ENV:SuperView-Library/GIF.controlpad"
  112.   ControlPad-Commands : - GIF89A_TRANSPARENT_COLOR=<0..255>
  113.                           ; Default color to be enabled and set
  114.                           ; (graphics control extension block)
  115.                           ; Default: (not active)
  116.   ----------------------------------------------------------------------------
  117.   ControlPad-Name     : "ENV:SuperView-Library/GPlot.controlpad"
  118.   ControlPad-Commands : - GPLOT_PATH=<gplot command path plus name>
  119.                           ; how gplot is to be called
  120.                           ; e.g. GPLOT_PATH=Work:GPlot/GPlot
  121.                           ; default is: GPlot
  122.                         - STATUS=<ENABLED|DISABLED>
  123.                           ; allows to disable this module - for example
  124.                           ; to be able to use an other, program-specific
  125.                           ; import-module for the same file format
  126.   ----------------------------------------------------------------------------
  127.   ControlPad-Name     : "ENV:SuperView-Library/ILBM.controlpad"
  128.   ControlPad-Commands : - ANIM_BODIES
  129.                           ; if set, ANIM files' ILBM-BODY chunks
  130.                           ; (first frame) will be extracted when
  131.                           ; such a file is encountered. Otherwise
  132.                           ; ANIM.datatype may do that task later.
  133.   ----------------------------------------------------------------------------
  134.   ControlPad-Name     : "ENV:SuperView-Library/JPEG.controlpad"
  135.   ControlPad-Commands :   ;
  136.                           ; STANDARD settings
  137.                           ; *****************
  138.                         - COLORDEPTH=<8|24>
  139.                           ; For READING colored 24 bit images:
  140.                           ; should the output be done as 8 or 24 bit Data ?
  141.                           ; default is 8 Bit data. Grayscaled graphics
  142.                           ; will _always_ be exported as 8 Bit
  143.                         - QUANTIZATION=<0..100>
  144.                           ; For WRITING 8/24 bit images as 24 bit JPEG:
  145.                           ; 0   - poor quality, big compression
  146.                           ; 100 - best quality, no compression
  147.                           ; never use such extreme values, but try
  148.                           ; something like 20, 50, 75
  149.                           ; default is: 75)
  150.                           ;
  151.                           ; ADVANCED settings
  152.                           ; *****************
  153.                         - FORCE_GRAY_DECODE
  154.                           ; For READING images:
  155.                           ; this switch overrides the selected depth
  156.                           ; for colored images and always exports them
  157.                           ; as 8 Bit grayscaled pictures
  158.                           ; default is: not set
  159.                         - DECODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  160.                                          FLOATING_POINT|FASTEST_INTEGER>
  161.                           ; For READING images:
  162.                           ; how to DECODE the 24 bit or gray data
  163.                           ; default is: FAST_INTEGER
  164.                         - DITHERMODE=<DITHER_FLOYD-STEINBERG|
  165.                                       NO_DITHERING|DITHER_ORDERED>
  166.                           ; For READING and dithering 24 bit images
  167.                           ; to 8 Bit images:
  168.                           ; how and whether to DITHER the 24 bit data
  169.                           ; default is: DITHER_FLOYD-STEINBERG
  170.                         - COLOR_QUANTIZING=<FAST|SLOW>
  171.                           ; For READING and dithering 24 bit images
  172.                           ; to 8 Bit images:
  173.                           ; whether to QUANTIZE the 24 bit data within
  174.                           ; two passes
  175.                           ; default is: SLOW
  176.                         - UPSAMPLING=<ON|OFF>
  177.                           ; For READING and dithering 24 bit images
  178.                           ; to 8 Bit images:
  179.                           ; whether to do fancy upsampling on the 24 bit
  180.                           ; default is: ON
  181.                         - FORCE_GRAY_ENCODE
  182.                           ; For WRITING images:
  183.                           ; this switch causes grayscales to be written
  184.                           ; no matter, whether the input was colored
  185.                           ; default is: not set
  186.                         - ENCODE_METHOD=<FAST_INTEGER|SLOW_INTEGER|
  187.                                          FLOATING_POINT|FASTEST_INTEGER>
  188.                           ; For WRITING images:
  189.                           ; how to ENCODE the 24 bit or gray data
  190.                           ; default is: FAST_INTEGER
  191.                         - OPTIMIZE=<ON|OFF>
  192.                           ; For WRITING 24 bit images:
  193.                           ; whether to optimize the generated huffman
  194.                           ; code (good compression, but slow)
  195.                           ; default is: OFF
  196.                         - PROGRESSIVE=<ON|OFF>
  197.                           ; For WRITING 24 bit images:
  198.                           ; whether to write progressive JPEG files
  199.                           ; default is: OFF
  200.   ----------------------------------------------------------------------------
  201.   ControlPad-Name     : "ENV:SuperView-Library/Limbo.controlpad"
  202.   ControlPad-Commands : - LIMBO_PATH=<Limbo command path plus name>
  203.                           ; how Limbo is to be called
  204.                           ; e.g. LIMBO_PATH=Work:Limbo/Limbo.68030.881
  205.                           ; default is: Limbo.68000
  206.                         - STATUS=<ENABLED|DISABLED>
  207.                           ; allows to disable this module - for example
  208.                           ; to be able to use an other, program-specific
  209.                           ; import-module for the same file format
  210.   ----------------------------------------------------------------------------
  211.   ControlPad-Name     : "ENV:SuperView-Library/PCD.controlpad"
  212.   ControlPad-Commands : - OUTPUTFORMAT=<BASE/16 | BASE/4 | BASE >
  213.                           ; specifies the output resolution to be used
  214.   ----------------------------------------------------------------------------
  215.   ControlPad-Name     : "ENV:SuperView-Library/PNM.controlpad"
  216.   ControlPad-Commands : - SUPPRESS_HEADER
  217.                           ; setting this keyword will suppres
  218.                           ; wriring the PNM header for P5/P6
  219.                           ; files, which actually will generate
  220.                           ; a RAW data file, which cannot be loaded
  221.                           ; with superview.library again, but may be
  222.                           ; used for different purposes
  223.                           ; Default: (not set)
  224.   ----------------------------------------------------------------------------
  225.   ControlPad-Name     : "ENV:SuperView-Library/SVG.controlpad"
  226.   ControlPad-Commands : - PACKMETHOD=<xxxx>
  227.                           ; if this one is specified, it is tried to
  228.                           ; pack the resulting file with the specified
  229.                           ; XPK-Packer. If this fails, the file keeps
  230.                           ; unpacked.
  231.   ============================================================================
  232.   SVDRIVERS
  233.   ----------------------------------------------------------------------------
  234.   ControlPad-Name     : "ENV:SuperView-Library/AGA.controlpad"
  235.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  236.                           ; (case-sensitive, ".svoperator" may be added)
  237.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  238.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  239.                           ; specifies, which operation should be performed
  240.                           ; on 24 bit graphics _before_ displaying them
  241.                           ; (if not specified, "best guess" colors will
  242.                           ;  be used, which is really slow)
  243.                         - BITMAPCOPY=<DIRECT|RTG>
  244.                           ; "BITMAPCOPY=RTG" prevents AGA.svdriver from
  245.                           ; directly copying into Bitmaps, which will
  246.                           ; result in a usage of more memory, but keeps it
  247.                           ; working.
  248.                           ; Default is "BITMAPCOPY=DIRECT".
  249.                         - SCREENINFRONT
  250.                           ; Put Screen to front _before_ the graphics
  251.                           ; has been displayed (useful with GfxCards)
  252.   ----------------------------------------------------------------------------
  253.   ControlPad-Name     : "ENV:SuperView-Library/ECS.controlpad"
  254.   ControlPad-Commands : - 24BITOPERATOR=<OperatorName>
  255.                           ; (case-sensitive, ".svoperator" may be added)
  256.                           ; e.g. "24BITOPERATOR=24BitToHAM.svoperator"
  257.                           ; or   "24BITOPERATOR=ExtractGrayScales"
  258.                           ; specifies, which operation should be performed
  259.                           ; on 24 bit graphics _before_ displaying them
  260.                           ; (if not specified displaying will fail)
  261.                         - 8BITOPERATOR=<OperatorName>
  262.                           ; (case-sensitive, ".svoperator" may be added)
  263.                           ; e.g. "8BITOPERATOR=ExtractGrayScales"
  264.                           ; specifies, which operation should be performed
  265.                           ; on non-ECS graphics (more than 16 Colors in
  266.                           ; HighRes, more than 32 Colors in LowRes, HAM8)
  267.                           ; (if not specified, will be tried to display)
  268.                         - BITMAPCOPY=<DIRECT|RTG>
  269.                           ; "BITMAPCOPY=RTG" prevents ECS.svdriver from
  270.                           ; directly copying into Bitmaps, which will
  271.                           ; result in a usage of more memory, but keeps it
  272.                           ; working.
  273.                           ; Default is "BITMAPCOPY=DIRECT".
  274.                         - SCREENINFRONT
  275.                           ; Put Screen to front _before_ the graphics
  276.                           ; has been displayed (useful with GfxCards)
  277.   ----------------------------------------------------------------------------
  278.   ControlPad-Name     : "ENV:SuperView-Library/CyberGraphics.controlpad"
  279.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  280.                           ; beginning depth for opening CyberGraphics Screens
  281.                           ; Default is 16 Bit (which will also be tried
  282.                           ; when opening of a 24 bit Screen fails)
  283.                           ; This does not concern colordepths < 16 Bit,
  284.                           ; except HAM6/8.
  285.                         - SMALLSCREENS
  286.                           ; unless this KeyWord is specified, it is not
  287.                           ; tried to open screens smaller than 320x240
  288.   ----------------------------------------------------------------------------
  289.   ControlPad-Name     : "ENV:SuperView-Library/PicassoII.controlpad"
  290.   ControlPad-Commands : - SMALLSCREENS
  291.                           ; unless this KeyWord is specified, it is not
  292.                           ; tried to open screens smaller than 320x240
  293.                         - BLITTER
  294.                           ; uses the Picasso blitter to copy graphics
  295.                           ; into screens. Otherwise CPU is used.
  296.                           ; On 68000 systems you may wish to use the blitter
  297.                         - EMUSCREENDEPTH=<16|24>
  298.                           ; beginning depth for opening Picasso Screens
  299.                           ; Default is 24 bit (if opening fails, it is
  300.                           ; also tried to open a 16 Bit Screen, then)
  301.                         - SCREENMODEREQUEST
  302.                           ; if this one is specified, the SVDriver ITSELF
  303.                           ; will open a ScreenMode-Requester and ask
  304.                           ; for an appropriate Screenmode to use
  305.                           ; Useful, if you always like to change modes.
  306.                         - AUTOSCROLLADJUST
  307.                           ; this keyword will force Autoscroll whenever
  308.                           ; it would make sense, but the Picasso Software
  309.                           ; would not manage it by itself (when either
  310.                           ; only width or height need to be autoscrolled)
  311.   ----------------------------------------------------------------------------
  312.   ControlPad-Name     : "ENV:SuperView-Library/Retina.controlpad"
  313.   ControlPad-Commands : - EMUSCREENDEPTH=<16|24>
  314.                           ; beginning depth for opening Retina Screens
  315.                           ; Default is 24 bit (if opening fails, it is
  316.                           ; also tried to open a 16 Bit Screen, then)
  317.   ============================================================================
  318.   SVOPERATORS
  319.   ----------------------------------------------------------------------------
  320.   ControlPad-Name     : "ENV:SuperView-Library/24BitToHAM.controlpad"
  321.   ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL
  322.                                       |HAM8_QUICK|HAM8_WELL>
  323.                           ; specifies the HAM-Mode to be used and
  324.                           ; the resulting speed/quality
  325.   ----------------------------------------------------------------------------
  326.   ControlPad-Name     : "ENV:SuperView-Library/CallPNM24.controlpad"
  327.   ControlPad-Commands : - PNMCOMMAND=<PBM command path and name>
  328.                           ; PNM command to be called
  329.                           ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale
  330.                         - PNMOPTIONS=<Options>
  331.                           ; Options for PNM command to be called
  332.                           ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0
  333.   ----------------------------------------------------------------------------
  334.   ControlPad-Name     : "ENV:SuperView-Library/Crop.controlpad"
  335.   ControlPad-Commands : - CROP_LEFTEDGE=<Value>
  336.                           ; crop from x position
  337.                           ; (will be adjusted, if >= source width)
  338.                         - CROP_TOPEDGE=<Value>
  339.                           ; crop from y position
  340.                           ; (will be adjusted, if >= source height)
  341.                         - CROP_WIDTH=<Value>
  342.                           ; crop how many x pixels from leftedge
  343.                           ; (will be adjusted, if too large)
  344.                         - CROP_HEIGHT=<Value>
  345.                           ; crop how many y pixels from topedge
  346.                           ; (will be adjusted, if too large)
  347.   ----------------------------------------------------------------------------
  348.   ControlPad-Name     : "ENV:SuperView-Library/Dither24Bit.controlpad"
  349.   ControlPad-Commands : - COLORDEPTH=<1..8>
  350.                           ; specifies the colordepth of the dithering
  351.                           ; output (1->2 Colors .. 8->256 Colors)
  352.   ----------------------------------------------------------------------------
  353.   ControlPad-Name     : "ENV:SuperView-Library/ExtractGrayScales.controlpad"
  354.   ControlPad-Commands : - COLORDEPTH=<1..8>
  355.                           ; specifies the colordepth of the grayscaled
  356.                           ; output (1->2 Colors .. 8->256 Colors)
  357.                         - QUICK
  358.                           ; uses >>2, >>1, >>3 (*0.25, *0.5, *0.125)
  359.                           ; instead of *0.3, *0.59, *0.11
  360.   ----------------------------------------------------------------------------
  361.   ControlPad-Name     : "ENV:SuperView-Library/HilbertDither256.controlpad"
  362.   ControlPad-Commands : - BACKGROUND=<BLACK|WHITE>
  363.                           ; defines, which of the two colors will act
  364.                           ; as background color. Useful e.g. for printing.
  365.   ----------------------------------------------------------------------------
  366.   ControlPad-Name     : "ENV:SuperView-Library/PaletteDither.controlpad"
  367.   ControlPad-Commands : - COLORDEPTH=<1..8>
  368.                           ; specifies the colordepth of the final,
  369.                           ; dithered graphics (1..8 for 2..256 colors)
  370.                         - PALETTEDEPTH=<1..8>
  371.                           ; number of colors (depth) to be taken from the
  372.                           ; fixed palette - the possible rest will be
  373.                           ; generated (if specifying more palette colors
  374.                           ; than available, all available will be taken)
  375.                         - PALETTEFILE=<palette graphics filename>
  376.                           ; any 2..256 color graphics file, of which
  377.                           ; superview.library is able to extract a
  378.                           ; palette from (for example an IFF-ILBM file,
  379.                           ; but including a BMHD and - maybe empty - BODY).
  380.                           ; Allows to take one graphics as sample for
  381.                           ; the others (concerning the palette).
  382.   ----------------------------------------------------------------------------
  383.   ControlPad-Name     : "ENV:SuperView-Library/Rotate.controlpad"
  384.   ControlPad-Commands : - DEGREES=<90|180|270>
  385.                           ; rotate by how many degrees (reverse clockwise) ?
  386.   ----------------------------------------------------------------------------
  387.   ControlPad-Name     : "ENV:SuperView-Library/RotateFree.controlpad"
  388.   ControlPad-Commands : - ROTATE_ANGLE=<0..360>
  389.                           ; rotate by how many degrees (reverse clockwise) ?
  390.                         - METHOD=<MIDDLE|GIVENPOINT>
  391.                           ; default is rotation about the middle
  392.                         - X_COORD=<Value>
  393.                           ; if METHOD=GIVENPOINT we need (X/Y)
  394.                           ; Default is (0/0)
  395.                         - Y_COORD=<Value>
  396.                           ; if METHOD=GIVENPOINT we need (X/Y)
  397.                           ; Default is (0/0)
  398.                         - KEEPSIZE
  399.                           ; if this keyword is set, it is NOT tried to
  400.                           ; readjust the image size and to center the
  401.                           ; image, so that parts, which would be out of
  402.                           ; range won't be cut off (which works best
  403.                           ; with (X/Y) pairs in the left, upper quarter)
  404.   ----------------------------------------------------------------------------
  405.   ControlPad-Name     : "ENV:SuperView-Library/Scale50.controlpad"
  406.   ControlPad-Commands : - METHOD=<HALF|DOUBLE>
  407.                           ; scale to which size ?
  408.   ----------------------------------------------------------------------------
  409.   ControlPad-Name     : "ENV:SuperView-Library/XOR.controlpad"
  410.   ControlPad-Commands : - XORVALUE = <0..255>
  411.                           ; 0 and 255 will not be the best decision ;-)
  412.                           ; Use 15 or something like this.
  413.   ----------------------------------------------------------------------------
  414.