ControlPad-FAQ V12.9 (18.02.96) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ List has been sorted alphabetically and by module types (information has been derived from docs basing on CPInfo-Files). ============================================================================ MAIN LIBRARIES ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/LIBRARY.controlpad" ControlPad-Commands : - DEFAULTSVDRIVER=<#?.svdriver> ; Which SVDriver should be set, when ; superview-library is beeing initialized ? ; For example: "DEFAULTSVDRIVER=AGA.svdriver" - ANYDATATYPES ; if this KeyWord is set, ANY DataTypes will ; be loaded and tried to be displayed in some ; way (e.g. not only pictures, but also 8SVX ; sounds or ANIM-Files ...) ; Recognition of changes to this one does REQUIRE ; a re-initialization of the library, ; e.g. via reboot/reset or "avail flush" ; (when not accessed) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/superviewsupport.controlpad" ControlPad-Commands : - C2P= ; determines, whether chunky to planar conversion ; is managed via the appropriate OS functions ; or via internal ones. ; Due to various problems with the OS functions ; "SV" is now default. ; Be careful when using "OS" with GfxCards, ; which carelessly patched graphics.library. ============================================================================ SVOBJECTS ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/FastILBM24.controlpad" ControlPad-Commands : - BUFFERSIZE= ; how many bytes should be buffered (more = faster) ; Default is 8192, minimum is 256 - PASSTHROUGH ; do not recognize ANY pictures, so that ; they e.g. might be passed through to ; ILBM.svobject instead - DITHERMODE= ; Default is HAM6_QUICK ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/JPEG.controlpad" ControlPad-Commands : - COLORDEPTH=<8|24> ; For READING colored 24 Bit images: ; should the output be done as 8 or 24 Bit Data ? ; default is 8 Bit data. Grayscaled graphics ; will _always_ be exported as 8 Bit - FORCE_GRAY_DECODE ; For READING images: ; this switch overrides the selected depth ; for colored images and always exports them ; as 8 Bit grayscaled pictures ; default is: not set - DECODE_METHOD= ; For READING images: ; how to DECODE the 24 Bit or gray data ; default is: FAST_INTEGER - DITHERMODE= ; For READING and dithering 24 Bit images ; to 8 Bit images: ; how and whether to DITHER the 24 Bit data ; default is: DITHER_FLOYD-STEINBERG - COLOR_QUANTIZING= ; For READING and dithering 24 Bit images ; to 8 Bit images: ; whether to QUANTIZE the 24 Bit data within ; two passes ; default is: SLOW - UPSAMPLING= ; For READING and dithering 24 Bit images ; to 8 Bit images: ; whether to do fancy upsampling on the 24 Bit ; default is: ON - QUANTIZATION=<0..100> ; For WRITING 8/24 Bit images as 24 Bit JPEG: ; 0 - poor quality, big compression ; 100 - best quality, no compression ; never use such extreme values, but try ; something like 20, 50, 75 ; default is: 75) - FORCE_GRAY_ENCODE ; For WRITING images: ; this switch causes grayscales to be written ; no matter, whether the input was colored ; default is: not set - ENCODE_METHOD= ; For WRITING images: ; how to ENCODE the 24 Bit or gray data ; default is: FAST_INTEGER - OPTIMIZE= ; For WRITING 24 Bit images: ; whether to optimize the generated huffman ; code (good compression, but slow) ; default is: OFF - PROGRESSIVE= ; For WRITING 24 Bit images: ; whether to write progressive JPEG files ; default is: OFF ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/PCD.controlpad" ControlPad-Commands : - OUTPUTFORMAT= ; specifies the output resolution to be used ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/SVG.controlpad" ControlPad-Commands : - PACKMETHOD= ; if this one is specified, it is tried to ; pack the resulting file with the specified ; XPK-Packer. If this fails, the file keeps ; unpacked. ============================================================================ SVDRIVERS ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/AGA.controlpad" ControlPad-Commands : - 24BITOPERATOR= ; (case-sensitive, ".svoperator" may be added) ; e.g. "24BITOPERATOR=24BitToHAM.svoperator" ; or "24BITOPERATOR=ExtractGrayScales" ; specifies, which operation should be performed ; on 24 Bit graphics _before_ displaying them ; (if not specified, "best guess" colors will ; be used, which is really slow) - BITMAPCOPY= ; "BITMAPCOPY=RTG" prevents AGA.svdriver from ; directly copying into Bitmaps, which will ; result in a usage of more memory, but keeps it ; working. ; Default is "BITMAPCOPY=DIRECT". - SCREENINFRONT ; Put Screen to front _before_ the graphics ; has been displayed (useful with GfxCards) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/ECS.controlpad" ControlPad-Commands : - 24BITOPERATOR= ; (case-sensitive, ".svoperator" may be added) ; e.g. "24BITOPERATOR=24BitToHAM.svoperator" ; or "24BITOPERATOR=ExtractGrayScales" ; specifies, which operation should be performed ; on 24 Bit graphics _before_ displaying them ; (if not specified displaying will fail) - 8BITOPERATOR= ; (case-sensitive, ".svoperator" may be added) ; e.g. "8BITOPERATOR=ExtractGrayScales" ; specifies, which operation should be performed ; on non-ECS graphics (more than 16 Colors in ; HighRes, more than 32 Colors in LowRes, HAM8) ; (if not specified, will be tried to display) - BITMAPCOPY= ; "BITMAPCOPY=RTG" prevents ECS.svdriver from ; directly copying into Bitmaps, which will ; result in a usage of more memory, but keeps it ; working. ; Default is "BITMAPCOPY=DIRECT". - SCREENINFRONT ; Put Screen to front _before_ the graphics ; has been displayed (useful with GfxCards) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/CyberGraphics.controlpad" ControlPad-Commands : - EMUSCREENDEPTH=<16|24> ; beginning depth for opening CyberGraphics Screens ; Default is 16 Bit (which will also be tried ; when opening of a 24 Bit Screen fails) ; This does not concern colordepths < 16 Bit, ; except HAM6/8. - SMALLSCREENS ; unless this KeyWord is specified, it is not ; tried to open screens smaller than 320x240 ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/PicassoII.controlpad" ControlPad-Commands : - SMALLSCREENS ; unless this KeyWord is specified, it is not ; tried to open screens smaller than 320x240 - BLITTER ; uses the Picasso blitter to copy graphics ; into screens. Otherwise CPU is used. ; On 68000 systems you may wish to use the blitter - EMUSCREENDEPTH=<16|24> ; beginning depth for opening Picasso Screens ; Default is 24 Bit (if opening fails, it is ; also tried to open a 16 Bit Screen, then) - SCREENMODEREQUEST ; if this one is specified, the SVDriver ITSELF ; will open a ScreenMode-Requester and ask ; for an appropriate Screenmode to use ; Useful, if you always like to change modes. - AUTOSCROLLADJUST ; this keyword will force Autoscroll whenever ; it would make sense, but the Picasso Software ; would not manage it by itself (when either ; only width or height need to be autoscrolled) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/Retina.controlpad" ControlPad-Commands : - EMUSCREENDEPTH=<16|24> ; beginning depth for opening Retina Screens ; Default is 24 Bit (if opening fails, it is ; also tried to open a 16 Bit Screen, then) ============================================================================ SVOPERATORS ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/24BitToHAM.controlpad" ControlPad-Commands : - DITHERMODE=< HAM6_QUICK|HAM6_WELL |HAM8_QUICK|HAM8_WELL> ; specifies the HAM-Mode to be used and ; the resulting speed/quality ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/CallPNM24.controlpad" ControlPad-Commands : - PNMCOMMAND= ; PNM command to be called ; e.g. PNMCOMMAND=Work:NetPBM/pnm/pnmscale - PNMOPTIONS= ; Options for PNM command to be called ; e.g. PNMOPTIONS=-xscale 2.0 -yscale 2.0 ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/Crop.controlpad" ControlPad-Commands : - CROP_LEFTEDGE= ; crop from x position ; (will be adjusted, if >= source width) - CROP_TOPEDGE= ; crop from y position ; (will be adjusted, if >= source height) - CROP_WIDTH= ; crop how many x pixels from leftedge ; (will be adjusted, if too large) - CROP_HEIGHT= ; crop how many y pixels from topedge ; (will be adjusted, if too large) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/Dither24Bit.controlpad" ControlPad-Commands : - COLORDEPTH=<1..8> ; specifies the colordepth of the dithering ; output (1->2 Colors .. 8->256 Colors) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/ExtractGrayScales.controlpad" ControlPad-Commands : - COLORDEPTH=<1..8> ; specifies the colordepth of the grayscaled ; output (1->2 Colors .. 8->256 Colors) - QUICK ; uses >>2, >>1, >>3 (*0.25, *0.5, *0.125) ; instead of *0.3, *0.59, *0.11 ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/HilbertDither256.controlpad" ControlPad-Commands : - BACKGROUND= ; defines, which of the two colors will act ; as background color. Useful e.g. for printing. ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/PaletteDither.controlpad" ControlPad-Commands : - COLORDEPTH=<1..8> ; specifies the colordepth of the final, ; dithered graphics (1..8 for 2..256 colors) - PALETTEDEPTH=<1..8> ; number of colors (depth) to be taken from the ; fixed palette - the possible rest will be ; generated (if specifying more palette colors ; than available, all available will be taken) - PALETTEFILE= ; any 2..256 color graphics file, of which ; superview.library is able to extract a ; palette from (for example an IFF-ILBM file, ; but including a BMHD and - maybe empty - BODY). ; Allows to take one graphics as sample for ; the others (concerning the palette). ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/Rotate.controlpad" ControlPad-Commands : - DEGREES=<90|180|270> ; rotate by how many degrees (reverse clockwise) ? ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/RotateFree.controlpad" ControlPad-Commands : - ROTATE_ANGLE=<0..360> ; rotate by how many degrees (reverse clockwise) ? - METHOD= ; default is rotation about the middle - X_COORD= ; if METHOD=GIVENPOINT we need (X/Y) ; Default is (0/0) - Y_COORD= ; if METHOD=GIVENPOINT we need (X/Y) ; Default is (0/0) - KEEPSIZE ; if this keyword is set, it is NOT tried to ; readjust the image size and to center the ; image, so that parts, which would be out of ; range won't be cut off (which works best ; with (X/Y) pairs in the left, upper quarter) ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/Scale50.controlpad" ControlPad-Commands : - METHOD= ; scale to which size ? ---------------------------------------------------------------------------- ControlPad-Name : "ENV:superview-library/XOR.controlpad" ControlPad-Commands : - XORVALUE = <0..255> ; 0 and 255 will not be the best decision. ; Use 15 or something like this. ----------------------------------------------------------------------------