The INI File: 2.29 Categories in the INI File: [system]

Up: GEOS SDK TechDocs | Up | Prev: 2.28 [spool] | Next: 2.30 [text]

The system category defines system configuration and setup. Most of the keys in this category are set and maintained by the Preferences manager application. These keys, with their formats and possible values, are shown in the following sections.

autoCursorCentering

autoCursorCentering = <Boolean>

If this key is set true, the mouse cursor is re-positioned to the center of the current window whenever the pointer cursor changes and no button is down.

continueSetup

continueSetup = <Boolean>

If this key is set true, GEOS will begin by running the graphical setup program in the proper setup modes. If false, GEOS will bypass the graphical setup. After running, the graphical setup program will reset this field to false. This field overrides the execOnStartup key of the ui category.

continueSetup = true
continueSetup = false

drive

drive <letter> = <number>

This key allows you to override the drive-map initialization done by the primary filesystem driver. You can not make a driver believe a nonexistent drive exists, but you can change the presumed media or make the driver ignore a drive. More than one drive may be remapped.

The letter argument is the drive letter of the drive to be remapped. The number argument defines the new drive definition and is one of the following values:

  -1		fixed disk
   0		ignore the drive
 360		360 K 5.25-inch disk
 720		720 K 3.5-inch disk
1200		1.2 meg 5.25-inch disk
1440		1.44 meg 3.5-inch disk
2880		2.88 meg 3.5-inch disk

Some examples of drive remappings are shown below:

drive d = 0			; ignore drive D:
drive a = 360			; make GEOS think drive A: is 360K

font

font = <driver file names>

This key causes the named font driver to be loaded. If this key doesn't exist, nimbus.geo will automatically be loaded (the default driver). More than one driver may be specified on a single line or in a blob format, as shown in the examples below. (Note, though, that at current only nimbus.geo is recognized.)

font = nimbus.geo otherdrv.geo
font = { nimbus.geo
	   otherdrv.geo }

fontid

fontid = <font name>

This key specifies the default font used in the event a requested font does not exist. This font will also be used when putting up system alert boxes (such as Abort/Retry boxes). The only available default font currently is Berkeley; typically, this will be a bitmap font rather than an outline font.

fontid = berkeley

fontmenu

fontmenu = <string of numbers>

This field specifies the order of fonts which should appear in font menus presented by font control objects. This is encoded as a string of numbers, four hex digits for each font, those four digits containing the font ID of the appropriate font. Thus, if the font ID's for the URW Roman and Berkeley fonts are 0x3000 and 0x0202, respectively, then if they are to be the first fonts in the font menu, the fontmenu field would read:

fontmenu = 30000202

fontsize

fontsize = <number>

This key specifies the point size of the default font. If an application requests a font that can't be found, the default point size specified here is used with the font specified with fontid . Berkeley supports 9, 10, 12, 14, and 18, though 18 is normally too large for many applications.

fontsize = 10

fonttool

fontmenu = <string of numbers>

This field specifies the order of fonts which should appear in font pop-up list presented by font control objects. This is encoded as a string of numbers, four hex digits for each font, those four digits containing the font ID of the appropriate font. Thus, if the font ID's for the URW Roman and Berkeley fonts are 0x3000 and 0x0202, respectively, then if they are to be the first fonts in the font pop-up list, the fontool field would read:

fonttool = 30000202

fs

fs = <driver file names>

This key defines the file system drivers to be loaded. The kernel will by default attempt to load the primary IFS driver for the detected version of DOS; if it can not determine the primary IFS driver, the proper driver must be specified in the INI file under this key. Multiple file system drivers may be specified either on a single line or in blob format. The current secondary IFS drivers available are

netware.geo
Used for Novell Netware systems.
msnet.geo
Used for LANtastic and other networks that support the standard DOS device redirection calls.
cdrom.geo
Used for CD-ROM drives accessed through MSCDEX.EXE.
fs = netware.geo
fs = { msnet.geo
	 cdrom.geo }

handles

handles = <number>

This key specifies the number of handles GEOS should set as the maximum in the handle table. This should be set to something most likely 2000 or above, and it may be set in the Preferences manager application. If nothing is set in this key, the kernel will assume a default of 1000 handles.

handles = 2000

inkTimeout

inkTimeout = <number>

This key sets the number of ticks (60 ticks in a second) the system will wait after the user has stopped drawing before processing ink input. The default is nine tenths of a second, or 54.

inkTimeout = 54

maxTotalHeapSpace

maxTotalHeapSpace = <size of heap in paragraphs>

This field causes the GeodeLoad() routine to operate in transparent launch mode. The value given represents the overall size of the heap, in paragraphs, excepting system libraries that are always in memory. It should be determined on the target machine itself, by starting up, then running the TCL function "heapspace total". A common value for this field is around 31000.

memory

memory = <driver file names>

This key defines the swap drivers that should be loaded. Swap drivers allow GEOS to use memory above the conventional 640 K. The kernel attempts to determine what type of memory is available and load the appropriate swap driver. This key is settable by the user with the Preferences manager application. The four driver names recognized are

emm.geo
LIM 4.0 standard expanded memory driver. A DOS-level memory driver must be loaded (e.g. EMM.SYS), typically in CONFIG.SYS.
extmem.geo
80286 extended memory driver.
xms.geo
XMS/HIMEM.SYS driver. A DOS-level driver must also be loaded (e.g. HIMEM.SYS), typically in CONFIG.SYS.
disk.geo
Disk swap driver. This should be loaded in all cases where a disk swap file is desired.
memory = disk.geo
memory = { disk.geo
	     xms.geo }

noFontDriver

noFontDriver = <Boolean>

If true, this key tells GEOS not to load the font driver; this is useful only when it is known beforehand that outline fonts are not available; it will reduce startup time of GEOS. If the key does not exist, it defaults to false. If used improperly, this key can cause bad things to happen in the system.

noFontDriver = true
noFontDriver = false

notes

notes = <string>

This field isn't used by GEOS proper. The Debug utility will search for this field when looking for text describing a platform which the .ini file simulates.

noVidMem

noVidMem = <Boolean>

If true, this key tells GEOS not to load the vidmem driver, which is used for printing; it will reduce startup time of GEOS and should be used only if it is known beforehand that printing will not be attempted. If the key does not exist, it defaults to false. If used improperly, this key can cause bad things to happen in the system.

noVidMem = true
noVidMem = false

pda

pda = <Boolean>

This field indicates whether GEOS is running on a PDA device. Currently this field is only used by the UI to provide alternate error strings.

penBased

penBased = <Boolean>

If true, this key tells GEOS that it is running on a pen-based system and that some objects will want to receive ink or other pen input. If the key is not set, it defaults to false.

penBased = true
penBased = false

power

power = <driver file name>

This key defines the power management drivers to be loaded, if any. If no driver is specified, the kernel will try to identify whether one is needed and then load it if necessary.

power = casio.geo

serialNumber

serialNumber = <number>

This key holds a predefined serial number for use by developers. This number will be given to you by Geoworks either directly or in the package you receive containing GEOS. Normally, this number is entered by the user when GEOS first finishes its graphical setup program.

setupMode

setupMode = <number>

This key indicates the mode of the graphical setup program. This should be a number from zero to three; for full graphical setup, set it to zero. Other modes are internal in nature and should not be set.

setupMode = 0

splashColor

splashColor = <Color value>

If the splashscreen option has been turned on, this field will determine the background color of any text splash screens shown.

splashscreen

splashscreen = <Boolean>

This permits the GEOS loader to display a message on one of the five simple graphics mode screens while GEOS is loading.

splashText

splashText = <string>

If the splashscreen option has been turned on, this field will determine the text of the message to display.


Up: GEOS SDK TechDocs | Up | Prev: 2.28 [spool] | Next: 2.30 [text]