@database @node main C @{" C. Program and Environment Settings " link c} @{" C.1 Program Settings " link C.1} @{" C.2 Evironment variables " link c.2} @endnode @node c C. Program and Environment Settings Sections 1.14, 8.1 and 8.2 explain how to save program and environment settings to a file. The format and function of the individual settings and their associated file-keywords is described here. All numbers may be expressed either in decimal or hexadecimal (preceded by a "0x" prefix) notation. For example, "COLORS = 16" is equivalent to "COLORS = 0x10". Each settings file may contain zero or more assignments. In case of duplicate settings (i.e. if the same keyword appears more than once in the same file), the last definition prevails. LONGMIN and LONGMAX respectively indicate the minimum and maximum 32-bit number which is handled (from several billions negative to several billions positive, i.e. 0x7FFFFFFF). Similarly, SHORTMIN = -32768 and SHORTMAX = 32767 (0x7FFF). @endnode @node C.1 C.1 Program Settings Program settings are global to Personal Paint. Program settings which appear in a settings file which is loaded are applied to all environments. FILTER (Image Processing Filters - Section 3.1.4) Format: FILTER = "Name", Type, , DivFac, Bias, BiasDX, BiasDY The quoted Name field may contain quote and backslash signs only if these are preceded by a backslash sign ('\'). Filter Types: 0 = Convolution, 1 = Popularity, 2 = Random, 3 = Dispersed Dithering, 4 = Clustered Dithering, 5 = Floyd-Steinberg Dithering. Kernel: 5 blocks (rows of the convolution matrix) of 5 values each. Empty fields must be set to 0. The range for each field is SHORTMIN .. SHORTMAX. DivFac (Division Factor) must be in the range SHORTMIN .. -1 or 1 .. SHORTMAX for Convolution and 1 .. 3 for Dispersed and Clustered Dithering; the value is ignored for the other filter types. Appendix C - Progran and Environment Settings 163 If the Type is Convolution, Bias, BiasDeltaX and BiasDeltaY are also considered, and should be in the range SHORTMIN .. SHORTMAX. AUDIO (Audio Feedback - Section 8.4) 0 = No, 1 = Yes. AUDERR (Audio Errors Volume - Section 8.4) Range: 0 .. 64. AUDCUE (Audio Cues Volume - Section 8.4) Range: 0 .. 64. CREDUC (Color Reduction - Section 8.6) 0 = Qualitative, 1 = Quantitative. CREMAP (Color remapping - Section 8.7) 0= Simple, 1 = Pattern Dithering, 2 = Floyd-Steinberg FILREQ (File Requester Flags - Section 8.8) Range: 0 .. 31. The individual values must be added: 1 = Expand Path, 2 = Directories on Top, 4 = Sort by Date, 8 = Double-Click and 16 = Confirm Overwriting. ICONS (Workbench Icons - Section 8.9) 0 = No, 1 = Default Icons, 2 = Picture icons. LANG (User Interface Language - Section 8.10) 0 = English, 1 = German, 2 = Italian, 99 = Custom. BARS (Tool and title Bar - Sections 8.11 and 8.12) Range: 0.. 3 (obtained by adding 1 for Tool Bar activation and 2 for the Title Bar). GCLIP (Clip Graphics - Section 8.13) 0 = No, 1 = Yes. Appendix C - Progran and Environment Settings 164 BKFTRANSP (Brush Backfill Transparency - Section 8.14) 0 = No, 1 = Yes. CAVRESIZE (Color Average Resize - Section 8.15) 0 = No, 1 = Yes. WBENCH (Workbench Screen - Section 8.16) 0 = Closed, 1 = Open. @endnode @node c.2 C.2 Environment Settings Environment settings are local to the environment from which the settings file is loaded (any program settings appearing in the same file are applied to all environments). MGFYGRID (Magnify Mode Grid - Section 3.1.8) Specifies the optional raster type: 0 = None, 1 = Lines, 2 = Dots. PRINT (General Printer Settings - Section 4.3 and subsections) Format: PRINT = NumCopies Mode NumCopies may range from 1 to SHORTMAX. Mode: System Printer = 0, Personal Paint PostScript = 1. PRINTSYS (System Printer Settings - Section 4.3.2) Format: PRINTSYS = Flags Dither Shade TShold Density Flags: 1 = Integer Scaling, 2 = Negative, 4 = Smoothing, 8 = Correct Red, 16 = Correct Green, 32 = Correct Blue, 64 = Form Feed. Dither: 0 = Ordered Dithering, 1 = Halftone Dithering, 2 = Floyd-Steinberg. Shade: 0 = Black and White, 1 = Gray-1, 2 = Gray-2, 3 = Color TShold range: 1 .. 15. Density range: 1 .. 7. PRINTPS (PostScript settings - Section 4.3.3) Format: PRINTPS = Flags Dpi Lpi Spot Output AngC AngM AngY AngK UcrM UcrY UcrK Gcr Process Appendix C - Progran and Environment Settings 165 Flags is the sum of the following: 1 = Negative, 2 = Mirror, 4 = EPS, 8 = Crops, 16 = Manual Feed, 32 = Compress, 64 = Cyan, 128 = Magenta, 256 = Yellow, 512 = Black. Dpi: 0 .. SHORTMAX (0 = Device Default) Lpi: 0 .. LONGMAX (in 1/10000s of Lpi, 0 = Device Default) Spot: Default = 0, following = same order as Spot cycle gadget, starting from 1. Output: 0 = System Printer, 1 = Serial Port, 2 = Parallel Port, 3 = File. AngC, AngM, AngY, AngK range: 0 .. LONGMAX (in degrees/10000, deg > 360 = Device Default) UcrM, UcrY, UcrK range: LONGMIN .. LONGMAX (in percent/10000 - 0% = No Correction) GCR range: 0 .. LONGMAX (in percent/10000 - 100% = Black Unchanged) Process: 0 = gray, 1 = color, 2 = CMY, 3 = CMYK PRINTLAY (Printer Page Layout - Section 4.3.1) Format: PRINTLAY = Flags MsrUnit PaperWidth PaperHeight LeftOffs TopOffs XSizeAuto YSizeAuto XSizePercent YSizePercent XSizeUnits YSizeUnits XSizePixels YSizePixels XSizeTimes YSizeTimes SizeType Flags is the sum of: 1 = Center X, 2 = Center Y, 4 = Landscape. MsrUnit: 0 = Inch, 1 = Centimeter, 2 = PS Points PaperWidth PaperHeight LeftOffs TopOffs: micrometers, LONGMIN .. LONGMAX. XSizeAuto, YSizeAuto: must be 0. XSizePercent, YSizePercent range: 0 .. 100 XSizeUnits, YSizeUnits: micrometers, 0 .. LONGMAX. XSizePixels, YSizePixels, XSizeTimes, YSizeTimes: 0 .. SHORTMAX SizeType: 0 = Automatic, 1 = Paper Percent, 2 = Units, 3 = Pixels, 4 = Times. DISPLAY (Amiga DisplayID - Section 4.5) This is the ID associated to the screen mode. Programmers may find the relative assignments in "graphics/displayinfo.h" (1.x and 2.xinclude files) or in "graphics/modeid.h" (3.x includes). Appendix C - Progran and Environment Settings 166 SCREENW (Screen Width - Section 4.5.2) Indicates the screen width of the current environment. It must range from 320 (minimum) to the maximum system overscan width. Negative values indicate system overscan widths: -1 = No overscan, -2 = Text, -3 = Standard, -4 = Extreme and -5 = Maximum. SCREENH (Screen Height - Section 4.5.2) Must range from 200 to the maximum overscan height. Negative numbers select overscan height values in the same order as in SCREENW. IMAGEW (Image Width - Section 4.5.2) This indicates the width of the current image, and may be larger than the screen format. The maximum is defined by the Amiga blitter chip (1008 pixels on original chips, 32752 on ECS and AA chips). IMAGEH (Image Height - Section 4.5.2) This is the height of the current image (original blitter limit: 1024; ECS and AA blitter: 32767). COLORS (Number of Colors - Section 4.5.3) The number of screen and image colors must be valid for the current DISPLAY setting. On Advanced Graphics Architecture systems, valid values are: 2, 4, 8, 16, 32, 64, 128 and 256. ASCROLL (Autoscroll - Section 4.5.4) 0 = No, 1 = Yes. RTG (Retargetable Graphics - Section 4.5.5) 0 = No, 1 = Yes, 2 = Auto. PALETTE (Palette File - Sections 7.1.1 and 8.1) The format is: PALETTE = "File Name" The quoted File Name field may contain quote and backslash signs preceded by a backslash sign ('\'). COORD (Coordinates - Section 8.5) 0 = None, 1 = Origin 0:0, 2 = Origin 1:1. [Copyright (C) Cloanto (R) 1992, 1993. All Rights Reserved.] Appendix C - Progran and Environment Settings 167 This page empty Appendix C - Progran and Environment Settings 168 @ENDNODE