"Personal Paint 7 - C. Program and Environment Settings"

C.         Program and Environment Settings

Sections "1.14", "9.1" and "9.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).


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.


AUDCUE  (Audio Cues Volume - Section "9.5")

Range: 0 .. 64.


AUDERR  (Audio Errors Volume - Section "9.5")

Range: 0 .. 64.


AUDIO  (Audio Feedback - Section "9.5")

0 = No, 1 = Yes.


BARS (Tool and title Bar - Sections "9.12.1" and "9.12.2")

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


BKFTRANSP  (Brush Backfill Transparency - Section "9.14.3")

0 = No, 1 = Yes.


CAVRESIZE  (Color Average Resize - Section "9.13.3")

0 = No, 1 = Yes.


CREDUC  (Color Reduction - Section "9.7")

0 = Qualitative, 1 = Quantitative.


CREMAP  (Color remapping - Section "9.8")

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


FILREQ  (File Requester Flags - Section "9.9")

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.


FILTER  (Image Processing Filters - Section "3.1.4")

Format: FILTER = "Name", Type, <Kernel>, 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, 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.

The following notes apply to the Stereogram Filter Type.

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.


GADGETS  (Cycle Gadgets - Section "9.12.3")

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


GCLIP  (Clip Graphics - Section "9.13.2")

0 = No, 1 = Yes.


ICONS  (Workbench Icons - Section "9.10")

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



LANG  (User Interface Language - Section "9.11")

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


PATHANBSH  (Anim-Brush Default Path - Section "6.8")

PATHANBSH = "Path"


PATHBSH  (Brush Default Path - Section "5.1")

PATHBSH = "Path"


PATHSET  (Settings Requester Default Path - Section "9.1")

PATHSET = "Path"


UNDOLIM  (Multi-level Undo - Sections "3.1.10" and "9.3.2")

UNDOLIM = MaxLevels, MaxBuffer

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


VIRTMEM  (Virtual Memory Settings - Section "9.3.1")

VIRTMEM = "RAM Storage", RAM VM Enable, RAM MinFree, "Disk Storage", Disk
VM Enable, Disk MinFree

Storage: quoted storage path.

Enable: 0 = Disabled, 1 = Enabled.

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


WBCLOSE  (Emergency Closing of Workbench Screen - Sections "4.10.2" and
"9.3.3")

WBCLOSE = Permission Status

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.


WBENCH  (Workbench Screen - Section "9.15")

0 = Closed, 1 = Open.


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


ASCROLL  (Autoscroll - Section "4.5.4")

0 = No, 1 = Yes.


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.


COORD  (Coordinates - Section "9.6")

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


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.x include
files) or in "graphics/modeid.h" (3.x 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.


IMAGEH  (Image Height - Section "4.5.2")

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


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


LOCKDISP  (Lock Display Mode - Section "4.5")

LOCKDISP = Lock Activation

0 = Unlocked, 1 = Locked.


MGFYGRID  (Magnify Mode Grid - Section "3.1.8")

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


PALETTE (Palette File - Sections "8.1.1" and "9.1")

The format is: PALETTE = "File Name"

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


PATHANIM  (Animation Default Path - Section "6.1")

PATHANIM = "Path"


PATHCOL  (Color Palette Default Path - Section "8.1.1")

PATHCOL = "Path"


PATHPIC  (Picture Default Path - Section "4.1")

PATHPIC = "Path"


PATHPLAY  (Play Animation File Default Path - Section "6.3")

PATHPLAY = "Path"


PATHPS  (PostScript Output Default Path - Section "4.3.3.5")

PATHPS = "Path"


PATHSTEN  (Color Stencil Default Path - Section "8.2.1")

PATHSTEN = "Path"


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.


PRINTCOR  (Printer Color Correction - Section "4.3.2.8")

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

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)


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.


PRINTPS  (PostScript settings - Section "4.3.3")

Format: PRINTPS = Flags Dpi Lpi Spot Output AngC AngM AngY AngK UcrM UcrY
UcrK Gcr Process

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


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

TShold range: 1 .. 15.

Density range: 1 .. 7.


RTG  (Retargetable Graphics - Section "4.5.5")

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


SBOARD  (Animation Storyboard - Section "6.4")

SBOARD = ThumbnailWidth, Columns, Rows

Width: In low-resolution pixels.

Columns: Frames (thumbnail-format) per row.

Rows: Number of thumbnail rows.


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.


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.


SNAPGRID  (Grid Settings - Section "9.13.1")

SNAPGRID = XStep, YStep, XOffset, YOffset

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



C.3        Read-Only Settings

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.


REDBITS, GREENBITS, BLUEBITS

REDBITS = RedBits

GREENBITS = GreenBits

BLUEBITS = BlueBits

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


THICKX, THICKY

THICKX = HorizontalThickness

THICKY = VerticalThickness

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.