@DATABASE C
@(C) "Copyright © 1992-1996 Cloanto Italia srl"
@REM Cloanto Personal Paint 7 CD-ROM
@FONT topaz.font 8
@WIDTH 74

@NODE Main ChapterC "Personal Paint 7 - C. Program and Environment Settings"
@TOC Contents/Main

@{B}C.         Program and Environment Settings@{UB}

Sections @{"1.14" LINK PP7.0:Chapter01/Main 1317}, @{"9.1" LINK PP7.0:Chapter09/Main 9} and @{"9.2" LINK PP7.0:Chapter09/Main 76} 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).


@{B}C.1        Program Settings@{UB}

Program settings are global to Personal Paint. Program settings which
appear in a settings file which is loaded are applied to all
environments.


@{B}AUDCUE@{UB}  (Audio Cues Volume - Section @{"9.5" LINK PP7.0:Chapter09/Main 280})

Range: 0 .. 64.


@{B}AUDERR@{UB}  (Audio Errors Volume - Section @{"9.5" LINK PP7.0:Chapter09/Main 280})

Range: 0 .. 64.


@{B}AUDIO@{UB}  (Audio Feedback - Section @{"9.5" LINK PP7.0:Chapter09/Main 280})

0 = No, 1 = Yes.


@{B}BARS@{UB} (Tool and title Bar - Sections @{"9.12.1" LINK PP7.0:Chapter09/Main 656} and @{"9.12.2" LINK PP7.0:Chapter09/Main 664})

Range: 0.. 3 (obtained by adding 1 for Tool Bar activation and 2 for the
Title Bar).


@{B}BKFTRANSP@{UB}  (Brush Backfill Transparency - Section @{"9.14.3" LINK PP7.0:Chapter09/Main 855})

0 = No, 1 = Yes.


@{B}CAVRESIZE@{UB}  (Color Average Resize - Section @{"9.13.3" LINK PP7.0:Chapter09/Main 734})

0 = No, 1 = Yes.


@{B}CREDUC@{UB}  (Color Reduction - Section @{"9.7" LINK PP7.0:Chapter09/Main 319})

0 = Qualitative, 1 = Quantitative.


@{B}CREMAP@{UB}  (Color remapping - Section @{"9.8" LINK PP7.0:Chapter09/Main 366})

0= Simple, 1 = Pattern Dithering, 2 = Floyd-Steinberg


@{B}FILREQ@{UB}  (File Requester Flags - Section @{"9.9" LINK PP7.0:Chapter09/Main 452})

Range: 0 .. 63. The individual values must be added: 1 = Expand Path, 2 =
Directories on Top, 4 = Sort by Date, 8 = Double-Click, 16 = Confirm
Overwriting and 32 = ASL (system) file requester.


@{B}FILTER@{UB}  (Image Processing Filters - Section @{"3.1.4" LINK PP7.0:Chapter03/Main 521})

Format: @{I}FILTER = "Name", Type, <Kernel>, DivFac, Bias, BiasDX, BiasDY@{UI}

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, 6 =
Environment Transparency, 7 = Brush Transparency, 8 = Stereogram.

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.

If the Type is Convolution, Bias, BiasDeltaX and BiasDeltaY are also
considered, and should be in the range SHORTMIN .. SHORTMAX. For the Brush
Transparency type, Bias values of -1 and -2 are used to respectively
indicate "Next Brush" and "Same Brush" alpha channel modes.

@{I}The following notes apply to the Stereogram Filter Type.@{UI}

A value of DivFac (Division Factor, range SHORTMIN .. SHORTMAX) greater
than zero generates SIRDS (random dot) stereograms and indicates how many
columns are to be created. This means that the pattern of random dots will
be as wide as the image width divided by DivFac. Values of zero or less
generate SIPS stereograms, which use the current brush as a pattern.

Bias (range 1 .. 16) allows the user to make some changes which affect the
perceived quality of the stereogram. Lower quality stereograms (low Bias
values) allow for more levels of depth, but may generate defects in
certain shapes (e.g. thick vertical bars may appear thin). Higher quality
images are easier to recognize, but their "flatness" (which is relative,
because the contrast is excellent) leaves less room for different levels
of depth.

BiasDx (range SHORTMIN .. SHORTMAX) is used as a Random Seed for SIRDS in
general and for SIPS with Echo suppression. Negative values cause a
different seed to be generated automatically each time the filter begins
processing. Values >= 0 allow for exact reproduction of SIRDS, as the
patter remains constant for each single value.

BiasDy controls different other options, which are associated to its
individual bits. The range is 0 .. 3, and the values must be added: 1 =
Help Symbols (on top of image), 2 = Echo Suppression.


@{B}GADGETS@{UB}  (Cycle Gadgets - Section @{"9.12.3" LINK PP7.0:Chapter09/Main 678})

0 = Standard Cycle Gadgets, 1 = Pull-Down Cycle Gadgets, 2 = Pop-Up Cycle
Gadgets.


@{B}GCLIP@{UB}  (Clip Graphics - Section @{"9.13.2" LINK PP7.0:Chapter09/Main 723})

0 = No, 1 = Yes.


@{B}ICONS@{UB}  (Workbench Icons - Section @{"9.10" LINK PP7.0:Chapter09/Main 538})

0 = No, 1 = Default Icons, 2 = Picture Icons (Standard), 3 = Preserve
Original Icons, 4 = Picture Icons (NewIcons).



@{B}LANG@{UB}  (User Interface Language - Section @{"9.11" LINK PP7.0:Chapter09/Main 636})

00 = English     (.en)
01 = German      (.de)
02 = Italian     (.it)
03 = French      (.fr)
04 = Spanish     (.es)
05 = Dutch       (.nl)
06 = Swedish     (.sv)
07 = Danish      (.da)
08 = Norwegian   (.no)
09 = Finnish     (.fi)
10 = Portuguese  (.pt)
11 = Polish      (.pl)
12 = Hungarian   (.hu)
13 = Czech       (.cs)
14 = Slowak      (.sk)
15 = Slovenian   (.sl)
16 = Croatian    (.hr)

99 = Custom      (.custom)

0xFFFFFFFF = Locale Default


@{B}PATHANBSH@{UB}  (Anim-Brush Default Path - Section @{"6.8" LINK PP7.0:Chapter06/Main 338})

PATHANBSH = @{I}"Path"@{UI}


@{B}PATHBSH@{UB}  (Brush Default Path - Section @{"5.1" LINK PP7.0:Chapter05/Main 14})

PATHBSH = @{I}"Path"@{UI}


@{B}PATHSET@{UB}  (Settings Requester Default Path - Section @{"9.1" LINK PP7.0:Chapter09/Main 9})

PATHSET = @{I}"Path"@{UI}


@{B}UNDOLIM@{UB}  (Multi-level Undo - Sections @{"3.1.10" LINK PP7.0:Chapter03/Main 1137} and @{"9.3.2" LINK PP7.0:Chapter09/Main 192})

UNDOLIM = @{I}MaxLevels, MaxBuffer@{UI}

MaxLevels range: 1 .. SHORTMAX (number of Undo/Redo levels).

MaxBuffer range: 1 .. LONGMAX (in bytes: 1 Mbyte = 1 048 576 bytes).

MaxBuffer indicates the maximum amount of memory (including virtual
memory) which can be used to store the Undo levels (up to a maximum of
MaxLevels Undo levels).

Once the maximum is reached, the oldest levels are progressively freed to
leave room for the most recent levels.

Whatever the settings, one level of undo and redo is always guaranteed
(even if it exceeds the memory limit set by the MaxBuffer setting).


@{B}VIRTMEM@{UB}  (Virtual Memory Settings - Section @{"9.3.1" LINK PP7.0:Chapter09/Main 130})

VIRTMEM = @{I}"RAM Storage", RAM VM Enable, RAM MinFree, "Disk Storage", Disk
VM Enable, Disk MinFree@{UI}

Storage: quoted storage path.

Enable: 0 = Disabled, 1 = Enabled.

MinFree: expressed in bytes (1 Mbyte = 1 048 576 bytes).


@{B}WBCLOSE@{UB}  (Emergency Closing of Workbench Screen - Sections @{"4.10.2" LINK PP7.0:Chapter04/Main 1176} and
@{"9.3.3" LINK PP7.0:Chapter09/Main 212})

WBCLOSE = @{I}Permission Status@{UI}

0 = Not allowed, 1 = Allowed.

In case of RAM shortage, and if allowed to do so, Personal Paint may
automatically try to close the Workbench screen to free some memory.


@{B}WBENCH@{UB}  (Workbench Screen - Section @{"9.15" LINK PP7.0:Chapter09/Main 863})

0 = Closed, 1 = Open.


@{B}C.2        Environment Settings@{UB}

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).


@{B}ASCROLL@{UB}  (Autoscroll - Section @{"4.5.4" LINK PP7.0:Chapter04/Main 1027})

0 = No, 1 = Yes.


@{B}COLORS@{UB}  (Number of Colors - Section @{"4.5.3" LINK PP7.0:Chapter04/Main 1015})

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.


@{B}COORD@{UB}  (Coordinates - Section @{"9.6" LINK PP7.0:Chapter09/Main 303})

0 = None, 1 = Origin 0:0, 2 = Origin 1:1.


@{B}DISPLAY@{UB}  (Amiga DisplayID - Section @{"4.5" LINK PP7.0:Chapter04/Main 901})

This is the ID associated to the screen mode. Programmers may find the
relative assignments in "graphics/displayinfo.h" (1.@{I}x@{UI} and 2.@{I}x@{UI} @{I}include@{UI}
files) or in "graphics/modeid.h" (3.@{I}x@{UI} includes).

A value of 0xFFFFFFFF indicates to use the same screen mode as the
Workbench screen. This was designed with the program startup files in
mind. By default, Personal Paint is launched with the same screen mode as
the Workbench, which avoids monitor flickering in combination with
graphics boards.


@{B}IMAGEH@{UB}  (Image Height - Section @{"4.5.2" LINK PP7.0:Chapter04/Main 997})

This is the height of the current image (original blitter limit: 1024; ECS
and AA blitter: 32767).


@{B}IMAGEW@{UB}  (Image Width - Section @{"4.5.2" LINK PP7.0:Chapter04/Main 997})

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).


@{B}LOCKDISP@{UB}  (Lock Display Mode - Section @{"4.5" LINK PP7.0:Chapter04/Main 901})

LOCKDISP = @{I}Lock Activation@{UI}

0 = Unlocked, 1 = Locked.


@{B}MGFYGRID@{UB}  (Magnify Mode Grid - Section @{"3.1.8" LINK PP7.0:Chapter03/Main 1084})

Specifies the optional raster type: 0 = None, 1 = Lines, 2 = Dots.


@{B}PALETTE@{UB} (Palette File - Sections @{"8.1.1" LINK PP7.0:Chapter08/Main 43} and @{"9.1" LINK PP7.0:Chapter09/Main 9})

The format is: @{I}PALETTE = "File Name"@{UI}

The quoted File Name field may contain quote and backslash signs preceded
by a backslash sign ('\\').


@{B}PATHANIM@{UB}  (Animation Default Path - Section @{"6.1" LINK PP7.0:Chapter06/Main 105})

PATHANIM = @{I}"Path"@{UI}


@{B}PATHCOL@{UB}  (Color Palette Default Path - Section @{"8.1.1" LINK PP7.0:Chapter08/Main 43})

PATHCOL = @{I}"Path@{UI}"


@{B}PATHPIC@{UB}  (Picture Default Path - Section @{"4.1" LINK PP7.0:Chapter04/Main 11})

PATHPIC = @{I}"Path"@{UI}


@{B}PATHPLAY@{UB}  (Play Animation File Default Path - Section @{"6.3" LINK PP7.0:Chapter06/Main 161})

PATHPLAY = @{I}"Path"@{UI}


@{B}PATHPS@{UB}  (PostScript Output Default Path - Section @{"4.3.3.5" LINK PP7.0:Chapter04/Main 683})

PATHPS = @{I}"Path"@{UI}


@{B}PATHSTEN@{UB}  (Color Stencil Default Path - Section @{"8.2.1" LINK PP7.0:Chapter08/Main 331})

PATHSTEN = @{I}"Path"@{UI}


@{B}PRINT@{UB}  (General Printer Settings - Section @{"4.3" LINK PP7.0:Chapter04/Main 201} and subsections)

Format: @{I}PRINT = NumCopies Mode@{UI}

NumCopies may range from 1 to SHORTMAX.

Mode: System Printer = 0, Personal Paint PostScript = 1.


@{B}PRINTCOR@{UB}  (Printer Color Correction - Section @{"4.3.2.8" LINK PP7.0:Chapter04/Main 518})

PRINTCOR = @{I}GraphType, GrayBrightness, GrayContrast, GrayGamma,
CyanBrightness, CyanContrast, CyanGamma, MagentaBrightness,
MagentaContrast, MagentaGamma, YellowBrightness, YellowContrast,
YellowGamma, BlackBrightness, BlackContrast, BlackGamma, UcrM, UcrY@{UI}

GraphType: 0 = Normal Graph, 1 = Reversed Notation.

Brightness and Contrast range: -100 .. 100.

Gamma range: 1000 .. 160000 (in units/10000, i.e. 0.1 .. 16.0)

UCR range: LONGMIN .. LONGMAX (in percent/10000 - 0% = No Correction)


@{B}PRINTLAY@{UB}  (Printer Page Layout - Section @{"4.3.1" LINK PP7.0:Chapter04/Main 282})

Format: @{I}PRINTLAY = Flags MsrUnit PaperWidth PaperHeight LeftOffs TopOffs
XSizeAuto YSizeAuto XSizePercent YSizePercent XSizeUnits YSizeUnits
XSizePixels YSizePixels XSizeTimes YSizeTimes SizeType@{UI}

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.


@{B}PRINTPS@{UB}  (PostScript settings - Section @{"4.3.3" LINK PP7.0:Chapter04/Main 588})

Format: @{I}PRINTPS = Flags Dpi Lpi Spot Output AngC AngM AngY AngK UcrM UcrY
UcrK Gcr Process@{UI}

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


@{B}PRINTSYS@{UB}  (System Printer Settings - Section @{"4.3.2" LINK PP7.0:Chapter04/Main 346})

Format: @{I}PRINTSYS = Flags Dither Shade TShold Density@{UI}

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, 4 = 8-bit
Grayscale, 5 = 24-bit Color.

TShold range: 1 .. 15.

Density range: 1 .. 7.


@{B}RTG@{UB}  (Retargetable Graphics - Section @{"4.5.5" LINK PP7.0:Chapter04/Main 1040})

0 = No, 1 = Yes, 2 = Auto.


@{B}SBOARD@{UB}  (Animation Storyboard - Section @{"6.4" LINK PP7.0:Chapter06/Main 189})

SBOARD = @{I}ThumbnailWidth, Columns, Rows@{UI}

Width: In low-resolution pixels.

Columns: Frames (thumbnail-format) per row.

Rows: Number of thumbnail rows.


@{B}SCREENH@{UB}  (Screen Height - Section @{"4.5.2" LINK PP7.0:Chapter04/Main 997})

Must range from 200 to the maximum overscan height. Negative numbers
select overscan height values in the same order as in SCREENW.


@{B}SCREENW@{UB}  (Screen Width - Section @{"4.5.2" LINK PP7.0:Chapter04/Main 997})

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.


@{B}SNAPGRID@{UB}  (Grid Settings - Section @{"9.13.1" LINK PP7.0:Chapter09/Main 705})

SNAPGRID = @{I}XStep, YStep, XOffset, YOffset@{UI}

XStep YStep range: 1 .. SHORTMAX
XOffset YOffset range: 0 .. SHORTMAX



@{B}C.3        Read-Only Settings@{UB}

The following program settings are dedicated to the more technical users.
Personal Paint does not write these settings. They can only be inserted in
a file using a text editor or a word processor such as Personal Write.


@{B}REDBITS, GREENBITS, BLUEBITS@{UB}

REDBITS = @{I}RedBits@{UI}

GREENBITS = @{I}GreenBits@{UI}

BLUEBITS = @{I}BlueBits@{UI}

Range: 0 .. 8 (0 = Display Mode Default; All set to 8 = 24-bit palette)

This option forces Personal Paint to use a certain number of bits for each
color component in the color palette, regardless of the hardware being
used.

For example, to emulate the limitations of an Original Chip Set system on
an AGA computer, all three values should be set to 4. Conversely, in order
not to lose information when working with some common 12-bit or 18-bit
hardware (e.g. ECS systems, or Picasso graphics boards), all three values
should be set to 8.

Interesting image processing effects can be obtained by selecting low
values (e.g. 1 to emulate CMYK/RGBW devices).


@{B}THICKX, THICKY@{UB}

THICKX = @{I}HorizontalThickness@{UI}

THICKY = @{I}VerticalThickness@{UI}

These settings determine the horizontal and vertical thickness of most
user interface items (tools, borders, bars, etc.) A value of 0 indicates
dynamic thickness (i.e. selected by the program depending on the screen
size), 1 = single thickness, 2 = double-thickness, 3 =
quadruple-thickness, and so on. In practice, manual thickness setting
never causes objects to appear larger than they would with with the option
set to 0. Otherwise, some requesters would not fit on the screen.

Range: 0 .. 128.

@ENDNODE