|
VISION's INI file secrets |
Last update : 12/19/21 |
|
VISION's INI file secrets |
Last update : 12/19/21 |
This page provides a full description
of VISION's
configuration file: VISION.INI
The main reason for this page is that not all VISION's configuration tweaks are available from the graphic interface, some have to be modified directly in VISION.INI.
VISION.INI is like a regular INI file,
it is based on sections rassembling configuration for a given high
level topic; in this section we can find keys and values to change
configuration.
| [Section name] | Key name |
Accepted
format for values |
Accessible from GUI? |
Description |
| Img Priorities |
Global |
x,y,z,... |
No |
List of module types separated by commas; first values are
tried first, if an error is returned, next value is tried and so on. Values for modules are: 1: Internal modules (in VISION's prg file) 2: zView LDG modules 3: ImgView IM modules 4: zView SLB modules (unsupported at this time) Default: Global = 1,3,2 meaning that VISION's internal modules will be tried first, then ImgMod IM modules then zView LDG See section [Folders], keys zvLDG, ImgMod and zvSLB for defining path for modules |
| Folders |
Album |
Any
valid full pathname |
Yes |
Path to use to open an album (image catalog). Default: VISION's folder |
| Filters |
Path to use to look for convolution filters. Default: FILTRES folder under VISION's folder |
|||
| DSP |
Path to use to look for DSP modules (e.g. DSP accelerated
convolution filters for Falcon). Default: DSP folder under VISION's folder |
|||
| Images |
Path to use to open an image. Default: VISION's folder |
|||
| Temp |
Path to use to create temporary file for a job. Default: TEMP folder under VISION's folder |
|||
| LDV |
Path to use to look for LDV
modules. Default: LDV folder under VISION's folder |
|||
| Languages |
Path to use to look for languages for user interface. Default: FILTRES folder under VISION's folder |
|||
| zvLDG |
No |
Path to use to look for zView LDG image modules. Default: zvLDG folder under VISION's folder |
||
| ImgMod |
Path to use to look for ImgView IM (from Lonny Pursell) image
modules. Default: C:\GEMSYS\IMGMOD |
|||
| zvSLB |
Path to use to look for zView SLB (from Thorsten Otto) image
modules. Default: unsupported at this time |
|||
| LDV |
PreviewDstSize |
Any integer >= 0, multiple of
16 |
No |
Width, in pixels, of the square that will contain the preview
of the destination image for LDV preview window. May be adjusted by VISION to accomodate screen resolution and force a multiple of 16. Default: 192 |
| PreviewSrcSize |
Any integer >= 0, multiple of 16 | Width, in pixels, of the square that will contain the source
image for LDV preview window. May be adjusted by VISION to accomodate screen resolution and force a multiple of 16. If zero, source won't be displayed so only destination preview will be displayed. Default: 192 (< 4.9a3), 0 above 4.9a3 |
||
| Hide030 |
0 or 1 |
Force LDV to ignore 68030 processor availability and consider
it's
a 68000. Used for testing a 68030 aware LDV on a 68000 machine. Default: 0 |
||
| HideFPU |
0 or 1 | Force LDV to ignore Floating Point Unit processor
availability. Used for testing a FPU aware LDV on a machine without a
FPU. Default: 0 |
||
| HideDSP |
0 or 1 | Force LDV to ignore DSP processor availability. Used for
testing a DSP aware LDV on a machine without a DSP. Default: 0 |
||
| Logging |
LoggingFlags |
32bit Hexadecimal number |
No |
32bit
hexadecimal integer with following bitmask signification regarding log
level (bit set to 1 means corresponding log level is enabled): 01000000: clean log files at startup 00400000: FATAL 00100000: ERROR 00020000: WARNING 00008000: INFO 00001000: PERF (report performances) 00000200: IMG (image library) 00000100: MEM (memory allocations & tracking) 00000080: GWIN2 (internal GEM library level 2) 00000040: GWIN1 (internal GEM library level 1) 00000020: DEBUG 00000010: KEYCODE (keystrokes reported) 00000008: TMP2 (low-level debug for testing) 00000004: TMP1(low-level debug for testing) Default: 1529000 (clean logs on startup, FATAL, ERROR, WARNING, INFO, PERF) |
| LoggingFile |
Any valid full or relative filename | Location of VISION's log file Default: vision.log (generated in VISION's folder) |
||
| LoggingFlushFreq |
1 to 5 |
FlushFreq is used to avoid flushing log to disk for every log request: FlushFreq=1 -> Forces flush at every log FlushFreq=5 -> Forces flush only every 5 logs Increasing FlushFreq will improve performance but in the event of a crash, you won't probably see the last log entries Default: 1 (writes an entry for every line) |
||
| Update |
Enabled |
0 or 1 |
No |
If set to 1, VISION will check for updates at startup Default: based on Internet likehood; 1 if multi-tasking OS or StiK cookie available |
| Choice |
0 or 1 |
If 1, VISION will ask for confirmation to apply a new update, else it will proceed without confirmation Default: 1 |
||
| LastCheck |
NA |
Set by VISION to check if it should make an Internet request to check for update. Default: none, set by VISION when a check for uopdate is made. |
||
| MinCheck |
Any positve integer |
Number of seconds to elapse between 2 consecutive attempts to check for update. Default: 604800 (a week) |
||
| Updater |
wget or curl |
Defines which updater is to be used to fetch new update: - wget: simpler but only http - curl: requires TrustedCAFile (see below) but can handle https Default: wget |
||
| URL |
Valid URL for VISION update |
URL to fetch new update from: http://vision.atari.org/vupdate/staging/ : http URL for staging release http://vision2.atari.org/vupdate/staging/ : https URL for staging release Default: http://vision.atari.org/vupdate/staging/ |
||
| TrustedCAFile |
Valid filename |
Filename holding Root CA certificates (.pem format). Available at: https://curl.se/docs/caextract.html Default: cacert.pem (provided by VISION's package) |
||
| General |
ForceUseStdVDI |
0 or 1 |
No |
VISION
features automatic detection of the need to use standard VDI format.
However, this can be forced by setting this key value to 1. Default: 0 |
| UseLongFileNames |
0 or 1 | Yes |
Enable long filename management via Pdomain(1) system call. Only valid for a multi-tasking OS. If not, a value of 1 will be changed to 0 to avoid issues. Default: 0 |
|
| DitherMethod |
0, 1 or 2 |
Yes |
How to load an image which has more colors than the current screen: 0: Let VISION decide which one is the best among dither to 256 colors, grey levels or monochrome based on the screen resolution 1: Dither to monochrome 2: Grey levels Note that VISION's scripts allow 3 other values: 3: 256 colors 4: Dual Tone (force each pixel to be either set or not) 5: Fixed palette (assuming image has no more than 256 colors) Default: 0 |
|
| ColorProtection |
0, 1 or 2 |
Yes |
Defines if image palette has to be set partially or total to GEM desktop. 0: Image palette set to GEM desktop (may mess up desktop!) 1: Minimal protection to ensure texts are visible 2: Set image palette but keep GEM first 16 colors Default: 0 Notes: - Use 'TAB' key to switch between these 3 values - Only makes sense when screen is not in a Truecolor mode. |
|
| CrossMouse |
0 or 1 | Yes |
Mouse cursor will show as a cross if this value is set to 1. Adds more accuracy with tools. Default: 0 |
|
| UseGEMClipboard |
0 or 1 | Yes |
Use GEM clipboard routines for copy/cut/paste. If you intend to share clipboard with other applications, set it to 1. 0: copy/cut/paste functions are only usable for VISION (faster) 1: copy/cut/paste can be shared with other applications (slower) Default: 0 |
|
| QuitIfNoWindow |
0 or 1 | Yes |
If set to 1, VISION will exit when last window is closed. Default: 0 |
|
| InfoBar |
0 or 1 | Yes |
Displays an info bar on each image window if set to 1. For low resolutions (e.g. 320x200), can make sense to set it to 0. Default: 1 |
|
| FullScreen |
0 or 1 | Yes |
If set to 1, VISION will display in full screen after loading it. Default: 0 |
|
| DisplayToolBar |
0 or 1 | Yes |
If set to 1, VISION's
tool bar will be displayed. If you don't plan to modify an image, you
can set it to 0 to have more space available on the desktop. Default: 1 |
|
| SplashWindow |
0 or 1 | Yes |
If set to 1, VISION displays a loading image when initializing. Default: 0 |
|
| DitherAuto |
0 or 1 |
Yes |
Set by VISION based on DitherMethod. |
|
| HelpBubbles |
0 or 1 | Yes |
If set to 1, displays help bubbles while mouse stays over some labels Default: 1 |
|
| Language |
Any folder name under Languages folder |
Yes |
Specied folder has to include the following files: - VISION.RSC: VISION's resource file for "high" resolutions (>512x384) - VISIONB.RSC: VISION's resource file for low resolutions, this will limit some features - VMSG.TXT: various messages VISION could display for GUI See Language key of Folders section. |
|
| RsrcChoice |
-1, 0 or 1 |
No |
Defines which resource routines will be used to manage resource files (.RSC), mainly for color icons: -1: Let VISION decide based on AES version and features reported 0: Use Interface routines 1: Use AES routines Default: -1 |
|
| ShowIBrowser |
0 or 1 |
If set to 1, VISION's image's browser window will be displayed. If you don't plan to use it, you
can set it to 0 to have more space available on the desktop. Default: 1 |
||
| HexDumpOnError |
0 or 1 |
If set to 1, VISION will open an "image" in the hexadecimal editor in case no image module is able to load it, else an error is displayed. Default: 1 |
||
| DSP |
UseDSP |
0 or 1 |
Yes |
If available, use DSP if set to 1. Default: 1 if a Falcon machine is detected |
| HandleLock |
0, 1, 2 or 3 |
Defines what to do if access to DSP is locked: 0: Prompt user 1: Cancel the operation 2: Ignore and use CPU if possible 3: Force usage (may creash the other application having blocked the DSP) Default: 2 |
||
| Undo |
Type |
0, 1, 2 or 3 |
Yes |
Defines how to manage the UNDO buffers: 0: Use RAM 1: Use RAM only if available RAM is bigger than UseDiskIfKo 2: Use RAM unless memory first, on allocation failure, use disk 3: Always use disk |
| UseDiskIfKo |
Any positive integer |
Yes |
Number of KB that must be free to allow RAM usage for Undo buffer |
|
| UseRedo |
0 or 1 |
No |
Allow redo feature if set to 1 |
|
| NbBuffers |
0 to 99 |
Yes |
Maximum number of buffers to use for RAM |
|
| SlideShow |
DisplayProg |
0 or 1 | Yes |
Displays image loading progression as % if set to 1 Default: 1 |
| DisplayName |
0 or 1 | Yes |
Displays the name of the image together with the image if set to 1 Default: 1 |
|
| IgnoreVSS |
0 or 1 | No |
Obsolete, ignored by VISION |
|
| Transition |
0, 1 or 2 |
Yes |
Defines the transition between 2 images: 0: No transition, new image just replaces the old one (fastest) 1: Displays new image one vertical line at a time 2: Displays new image one horinzotal line at a time Default: 0 |
|
| DisplayType |
0, 1, 2 or 3 |
Yes |
Bitmask defining if zoom in/out is allowed: Bit#0 (1): Zoom in is allowed Bit#1 (2): Zoom out is allowed Default: 2 |
|
| BackGroundColor |
0 or 1 |
Yes |
Defines the background color to display the image: 0: Black 1: White Default: 0 |
|
| Cycle |
0 or 1 |
Yes |
Restarts slide-show from beginning when reaching the end if set to 1. Default: 0 |
|
| DoNotClearScreen |
0 or 1 | Yes |
Clears the screen between 2 displays if set to 0 Default: 0 |
|
| HideMouse |
0 or 1 | Yes |
Hides the mouse between 2 displays if set to 1 Default: 0 |
|
| WaitMiniSec |
Any integer greater or equal to -1 |
Yes |
Defines what event is required to move to the other picture: -1: Wait for user input (keyboard or mouse) 0: Don't wait, displays the image as soon it is loaded >0: wait for this number of seconds before displaying the next image (loading time taken into account so wait could be bigger) Default: 0 |
|
| Snapshot |
SnapKeyDirect |
Integer (scancode) |
No |
Scancode (hexadecimal) for key shortcut to make a snapshot Default: 652F (Num keypad '/') |
| SnapKeyViaConfig |
Integer (scancode) | No |
Scancode (hexadecimal) for key shortcut to invoke the configuration window Default: 662A (Num keypad '*') |
|
| SnapFlags |
0 to 7 |
Yes |
Bitmask for parameter of the configuration window: Bit#0 (1): Snapshot the whole screen Bit#1 (2): Snapshot a window to be defined with the mouse Bit#2 (4): Snapshot the mouse as well Default: 1 |
|
| Graphics |
PColor |
Color index (integer) |
Yes |
Pencil color index. Default: 1 |
| PHeight |
Integer |
Yes |
Pencil Height Default: 16 |
|
| PType |
Integer |
Yes |
Pencil Type Default: 0 (square) |
|
| RoundedSurfaces |
0 or 1 |
Yes |
Figures such as rectangles will have rounded cornes if set to 1 Default: 0 |
|
| LWidth |
Integer |
Yes |
Line Width Default: 1 |
|
| LEdKind |
0, 1 or 2 |
Yes |
Type of end kind for lines: 0: Square 1: Arrowed 2: Rounded Default: 1 |
|
| LStKind |
0, 1 or 2 | Yes |
Type of start kind for lines: 0: Square 1: Arrowed 2: Rounded Default: 1 |
|
| LColor |
Color index (integer) | Yes |
Line color index. Default: 1 |
|
| LStyle |
1 to 6 |
Yes |
Type of line: 1. Solid 2: Long dash 3: Dot 4: Dash dot 5: Dash 6: Dash2dot Default: 1 |
|
| MHeight |
Integer |
Yes |
Marker Height Default: 1 |
|
| MColor |
Color index (integer) | Yes |
Marker color index. Default: 1 |
|
| MStyle |
1 to 6 |
Yes |
Marker type: 1: Dot 2: Plus 3: Asterisk 4: Square 5: Diagonal cross 6: Diamond Default: 1 |
|
| FPerimeter |
0 or 1 |
Yes |
Draw pattern perimeter if set to 1. Default: 1 |
|
| FSindex |
Integer | Yes |
Fill pattern index, see Fill-Type pattern Default: 8 |
|
| FColor |
Color index (integer) | Yes |
Fill pattern color index. Default: 1 |
|
| FStyle |
0 to 3 |
Yes |
Fill type: 0: Hollow 1: Solid 2: Pattern 3: Hatch Default: 1 |
|
| TVDisp |
0 to 5 |
Yes |
Text vertical alignment: 0: Baseline 1: Half line 2: Ascent line 3: Bottom line 4: Descent line 5: Top line Default: 0 |
|
| THDisp |
0 to 2 |
Yes |
Horizontal alignment: 0: Left jusified 1: Centered 2: Right justified Default: 0 |
|
| TAttribute |
Integer (bitmask) |
Yes |
Text effects: Bit#0 (0x01): Thickened Bit#1 (0x02): Lighhtened Bit#2 (0x04): Skewed Bit#3 (0x08): Underlined Bit#4 (0x10): Outlined Default: 0 (Normal) |
|
| TColor |
Color index (integer) | Yes |
Text color index. Default: 1 |
|
| TFont |
Integer (font index) |
Yes |
Text font index Default: 1 |
|
| TAngle |
0 to 3600 |
Yes |
Text rotation angle in 1/10 of degrees Default: 0 |
|
| THCell |
Integer |
Yes |
Cell Height Default: given by system |
|
| TWCell |
Integer | Yes | Cell Width Default: given by system |
|
| THCar |
Integer | Yes | Character Height Default: given by system |
|
| TWCar |
Integer | Yes | Character Width Default: given by system |
|
| MaskOutside |
0 or 1 |
Yes |
Operations will affect the outside of the block if set to 1. Default: 0 |
|
| EraserForm |
1 to 8 |
Yes |
Eraser pattern Default: 0 |
|
| WriteMode |
1 to 4 |
Yes |
Writing mode for operations: 1: Replace 2: Transparent 3: XOR 4: Reverse transparent Default: 0 |
|
| Thickness |
a,b,c,d,e,f,g,h,i (9 values) |
No | Pencil thicknesses controled by Control-1 to Control-9 (used mainly for tablet devices) Default: 1,4,7,10,14,18,22,26,30 |
|
| Log |
LogFlags |
Integer |
No |
Obsolete, ignored by VISION |
| LogFile |
Ful pathname |
No |
Obsolete, ignored by VISION | |
hits since 07/31/2002