home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / GFX / Painting / PAINTDOC.DMS / in.adf / ASCII_Files / C.pp / C
Encoding:
Text File  |  1995-10-28  |  7.2 KB  |  270 lines
  1.  
  2. C.         Program and Environment Settings
  3.  
  4.    Sections 1.14, 8.1 and 8.2 explain how to save program and environment
  5. settings to a file. The format and function of the individual settings and
  6. their associated file-keywords is described here.
  7.  
  8.    All numbers may be expressed either in decimal or hexadecimal (preceded
  9. by a "0x" prefix) notation. For example, "COLORS = 16" is equivalent to
  10. "COLORS = 0x10". Each settings file may contain zero or more assignments.
  11. In case of duplicate settings (i.e. if the same keyword appears more than
  12. once in the same file), the last definition prevails. LONGMIN and LONGMAX
  13. respectively indicate the minimum and maximum 32-bit number which is
  14. handled (from several billions negative to several billions positive, i.e.
  15. 0x7FFFFFFF). Similarly, SHORTMIN = -32768 and SHORTMAX = 32767 (0x7FFF).
  16.  
  17.  
  18. C.1        Program Settings
  19.  
  20.    Program settings are global to Personal Paint. Program settings which
  21. appear in a settings file which is loaded are applied to all
  22. environments.
  23.  
  24.  
  25. FILTER  (Image Processing Filters - Section 3.1.4)
  26.  
  27. Format: @{I}FILTER = "Name", Type, <Kernel>, DivFac, Bias, BiasDX, BiasDY@{UI}
  28.  
  29. The quoted Name field may contain quote and backslash signs only if these
  30. are preceded by a backslash sign ('\').
  31.  
  32. Filter Types: 0 = Convolution, 1 = Popularity, 2 = Random, 3 = Dispersed
  33. Dithering, 4 = Clustered Dithering, 5 = Floyd-Steinberg Dithering.
  34.  
  35. Kernel: 5 blocks (rows of the convolution matrix) of 5 values each. Empty
  36. fields must be set to 0. The range for each field is SHORTMIN ..
  37. SHORTMAX.
  38.  
  39. DivFac (Division Factor) must be in the range SHORTMIN .. -1 or 1 ..
  40. SHORTMAX for Convolution and 1 .. 3 for Dispersed and Clustered Dithering;
  41. the value is ignored for the other filter types.
  42.  
  43. If the Type is Convolution, Bias, BiasDeltaX and BiasDeltaY are also
  44. considered, and should be in the range SHORTMIN .. SHORTMAX.
  45.  
  46.  
  47. AUDIO  (Audio Feedback - Section 8.4)
  48.  
  49. 0 = No, 1 = Yes.
  50.  
  51.  
  52. AUDERR  (Audio Errors Volume - Section 8.4)
  53.  
  54. Range: 0 .. 64.
  55.  
  56.  
  57. AUDCUE  (Audio Cues Volume - Section 8.4)
  58.  
  59. Range: 0 .. 64.
  60.  
  61.  
  62. CREDUC  (Color Reduction - Section 8.6)
  63.  
  64. 0 = Qualitative, 1 = Quantitative.
  65.  
  66.  
  67. CREMAP  (Color remapping - Section 8.7)
  68.  
  69. 0= Simple, 1 = Pattern Dithering, 2 = Floyd-Steinberg
  70.  
  71.  
  72. FILREQ  (File Requester Flags - Section 8.8)
  73.  
  74. Range: 0 .. 31. The individual values must be added: 1 = Expand Path, 2 =
  75. Directories on Top, 4 = Sort by Date, 8 = Double-Click and 16 = Confirm
  76. Overwriting.
  77.  
  78.  
  79. ICONS  (Workbench Icons - Section 8.9)
  80.  
  81. 0 = No, 1 = Default Icons, 2 = Picture icons.
  82.  
  83.  
  84. LANG  (User Interface Language - Section 8.10)
  85.  
  86. 0 = English, 1 = German, 2 = Italian, 99 = Custom.
  87.  
  88.  
  89. BARS (Tool and title Bar - Sections 8.11 and 8.12)
  90.  
  91. Range: 0.. 3 (obtained by adding 1 for Tool Bar activation and 2 for the
  92. Title Bar).
  93.  
  94.  
  95. GCLIP  (Clip Graphics - Section 8.13)
  96.  
  97. 0 = No, 1 = Yes.
  98.  
  99.  
  100. BKFTRANSP  (Brush Backfill Transparency - Section 8.14)
  101.  
  102. 0 = No, 1 = Yes.
  103.  
  104.  
  105. CAVRESIZE  (Color Average Resize - Section 8.15)
  106.  
  107. 0 = No, 1 = Yes.
  108.  
  109.  
  110. WBENCH  (Workbench Screen - Section 8.16)
  111.  
  112. 0 = Closed, 1 = Open.
  113.  
  114.  
  115. C.2        Environment Settings
  116.  
  117.    Environment settings are local to the environment from which the
  118. settings file is loaded (any program settings appearing in the same file
  119. are applied to all environments).
  120.  
  121.  
  122. MGFYGRID  (Magnify Mode Grid - Section 3.1.8)
  123.  
  124. Specifies the optional raster type: 0 = None, 1 = Lines, 2 = Dots.
  125.  
  126.  
  127. PRINT  (General Printer Settings - Section 4.3 and subsections)
  128.  
  129. Format: @{I}PRINT = NumCopies Mode@{UI}
  130.  
  131. NumCopies may range from 1 to SHORTMAX.
  132.  
  133. Mode: System Printer = 0, Personal Paint PostScript = 1.
  134.  
  135.  
  136. PRINTSYS  (System Printer Settings - Section 4.3.2)
  137.  
  138. Format: @{I}PRINTSYS = Flags Dither Shade TShold Density@{UI}
  139.  
  140. Flags: 1 = Integer Scaling, 2 = Negative, 4 = Smoothing, 8 = Correct Red,
  141. 16 = Correct Green, 32 = Correct Blue, 64 = Form Feed.
  142.  
  143. Dither: 0 = Ordered Dithering, 1 = Halftone Dithering, 2 =
  144. Floyd-Steinberg.
  145.  
  146. Shade: 0 = Black and White, 1 = Gray-1, 2 = Gray-2, 3 = Color
  147.  
  148. TShold range: 1 .. 15.
  149.  
  150. Density range: 1 .. 7.
  151.  
  152.  
  153. PRINTPS  (PostScript settings - Section 4.3.3)
  154.  
  155. Format: @{I}PRINTPS = Flags Dpi Lpi Spot Output AngC AngM AngY AngK UcrM UcrY
  156. UcrK Gcr Process@{UI}
  157.  
  158. Flags is the sum of the following: 1 = Negative, 2 = Mirror, 4 = EPS, 8 =
  159. Crops, 16 = Manual Feed, 32 = Compress, 64 = Cyan, 128 = Magenta, 256 =
  160. Yellow, 512 = Black.
  161.  
  162. Dpi: 0 .. SHORTMAX (0 = Device Default)
  163.  
  164. Lpi: 0 .. LONGMAX (in 1/10000s of Lpi, 0 = Device Default)
  165.  
  166. Spot: Default = 0, following = same order as Spot cycle gadget, starting
  167. from 1.
  168.  
  169. Output: 0 = System Printer, 1 = Serial Port, 2 = Parallel Port, 3 = File.
  170.  
  171. AngC, AngM, AngY, AngK range: 0 .. LONGMAX (in degrees/10000, deg > 360 =
  172. Device Default)
  173.  
  174. UcrM, UcrY, UcrK range: LONGMIN .. LONGMAX (in percent/10000 - 0% = No
  175. Correction)
  176.  
  177. GCR range: 0 .. LONGMAX (in percent/10000 - 100% = Black Unchanged)
  178.  
  179. Process: 0 = gray, 1 = color, 2 = CMY, 3 = CMYK
  180.  
  181.  
  182. PRINTLAY  (Printer Page Layout - Section 4.3.1)
  183.  
  184. Format: @{I}PRINTLAY = Flags MsrUnit PaperWidth PaperHeight LeftOffs TopOffs
  185. XSizeAuto YSizeAuto XSizePercent YSizePercent XSizeUnits YSizeUnits
  186. XSizePixels YSizePixels XSizeTimes YSizeTimes SizeType@{UI}
  187.  
  188. Flags is the sum of: 1 = Center X, 2 = Center Y, 4 = Landscape.
  189.  
  190. MsrUnit: 0 = Inch, 1 = Centimeter, 2 = PS Points
  191.  
  192. PaperWidth PaperHeight LeftOffs TopOffs: micrometers, LONGMIN .. LONGMAX.
  193.  
  194. XSizeAuto, YSizeAuto: must be 0.
  195.  
  196. XSizePercent, YSizePercent range: 0 .. 100
  197.  
  198. XSizeUnits, YSizeUnits: micrometers, 0 .. LONGMAX.
  199.  
  200. XSizePixels, YSizePixels, XSizeTimes, YSizeTimes: 0 .. SHORTMAX
  201.  
  202. SizeType: 0 = Automatic, 1 = Paper Percent, 2 = Units, 3 = Pixels, 4 =
  203. Times.
  204.  
  205.  
  206. DISPLAY  (Amiga DisplayID - Section 4.5)
  207.  
  208. This is the ID associated to the screen mode. Programmers may find the
  209. relative assignments in "graphics/displayinfo.h" (1.@{I}x@{UI} and 2.@{I}x@{UI} @{I}include@{UI}
  210. files) or in "graphics/modeid.h" (3.@{I}x@{UI} includes).
  211.  
  212.  
  213. SCREENW  (Screen Width - Section 4.5.2)
  214.  
  215. Indicates the screen width of the current environment. It must range from
  216. 320 (minimum) to the maximum system overscan width. Negative values
  217. indicate system overscan widths: -1 = No overscan, -2 = Text, -3 =
  218. Standard, -4 = Extreme and -5 = Maximum.
  219.  
  220.  
  221. SCREENH  (Screen Height - Section 4.5.2)
  222.  
  223. Must range from 200 to the maximum overscan height. Negative numbers
  224. select overscan height values in the same order as in SCREENW.
  225.  
  226.  
  227. IMAGEW  (Image Width - Section 4.5.2)
  228.  
  229. This indicates the width of the current image, and may be larger than the
  230. screen format. The maximum is defined by the Amiga blitter chip (1008
  231. pixels on original chips, 32752 on ECS and AA chips).
  232.  
  233.  
  234. IMAGEH  (Image Height - Section 4.5.2)
  235.  
  236. This is the height of the current image (original blitter limit: 1024; ECS
  237. and AA blitter: 32767).
  238.  
  239.  
  240. COLORS  (Number of Colors - Section 4.5.3)
  241.  
  242. The number of screen and image colors must be valid for the current
  243. DISPLAY setting. On Advanced Graphics Architecture systems, valid values
  244. are: 2, 4, 8, 16, 32, 64, 128 and 256.
  245.  
  246.  
  247. ASCROLL  (Autoscroll - Section 4.5.4)
  248.  
  249. 0 = No, 1 = Yes.
  250.  
  251.  
  252. RTG  (Retargetable Graphics - Section 4.5.5)
  253.  
  254. 0 = No, 1 = Yes, 2 = Auto.
  255.  
  256.  
  257. PALETTE (Palette File - Sections 7.1.1 and 8.1)
  258.  
  259. The format is: @{I}PALETTE = "File Name"@{UI}
  260.  
  261. The quoted File Name field may contain quote and backslash signs preceded
  262. by a backslash sign ('\').
  263.  
  264.  
  265. COORD  (Coordinates - Section 8.5)
  266.  
  267. 0 = None, 1 = Origin 0:0, 2 = Origin 1:1.
  268.  
  269. [Copyright (C) Cloanto (R) 1992, 1993. All Rights Reserved.]
  270.