My-T-Soft Basic Initialization File Documentation (MYTSOFT.INI)

Listed below are settings and information for the Configuration & options for My-T-Soft Basic.

All Settings are the default Settings of My-T-Soft Basic.

[Configuration]

Info=This is MYTSOFT.TXT from Builder as Unicode.

;if PanelImage references a valid image (of form IMGnnnnn.PNG, e.g. IMG00002.PNG)

;then this image will be used at run-time as the panel background

PanelImage=

;The following 2 entries are created at build time, and are normally seen

;in the built KBF via KBFEdit (but not from the Builder)

;These entries should not be modified or removed

;ProjectName=

;GUID=

KeyboardMacroFile=

;This indicates which (if any) KMF (Keyboard Macro File) is in use to handle

;key labels and key actions.

;Note that the KBF must use the KMF abstraction entry for both Label and Action

;for this to be of use. See Build-A-Board for more details.

[Settings]

;Various global or user optional settings can go here.

;This file is embedded in the KBF, and is accessed at run-time.

;This provides another way for settings (especially user options) to travel with a KBF file.

XParallax=0

YParallax=0

;The XParallax / Y Parallax settings can be a positive or negative integer value that

;directly modify the X/Y left click/mouse button position to adjust for an external

;or system offset induced by glass thickness / positioning / etc.

;The implementation is to adjust the actual coordinate by adding the integer indicated

;here - use XParallax=0 and yParallax=0 to bypass these settings

KeyBlockTime=0

;The KeyBlockTime is a per key blockout time in milliseconds where any additional

;key press via mouse click event is ignored (blocked) The setting is per key

;but is global in nature - there is one setting for any particular key, and that key

;cannot be "clicked" during the blockout time. However, another new key press will clear

;the current blockout and start a new blockout time for the new key.

;Use KeyBlockTime=0 to bypass this setting

;KeyBlockTime=100 means 100ms key block time out

;KeyBlockTime=500 means 500ms (1/2 second) key block time out

CursorOverride=Hand

;The CursorOverride allows selection of something other than the default hand type cursor

;None = blank, no cursor

;Blank = blank, no cursor

;Dot = small dot cursor

;SmallHand = small hand cursor

;Hand = regular hand cursor

;no entry, anything else - regular hand cursor

MenuOverride=

;The MenuOverride setting will bypass the built in "Access Popup Menu" setting in the KBF

;If MenuOverride=No or just blank, MenuOverride= then the KBF setting will use

;If MenuOverride=Menu the menu will be available

;If MenuOverride=NoMenu, then the menu will not be available

MenuOffScreen=

;The MenuOffScreen setting will enable the popup menu (if available) when a portion of

;the window is moved off-screen. This allows a limited pointing device to access

;the menu

;If MenuOffScreen=No or just blank, MenuOffScreen= then no menu will be shown

;If MenuOffScreen=Yes then the menu will be shown if a portion of the keyboard is off-screen

MenuLeftHold=

;The MenuLeftHold setting will enable the popup menu (if available) when the main

;button is held for several seconds. This allows a limited pointing device to access

;the menu

;If MenuLeftHold=No or just blank, MenuLeftHold= then no menu will be shown

;If MenuLeftHold=Yes then the menu will be shown if main button is held down

;The menu will be shown when the mouse button is released. The menu will not be

;shown if the release position is more than 5 pixels away from the pressed position,

;so any movement will typically prevent the menu from being shown.

MoveOverride=

;The MoveOverride setting will bypass the built in "Allow User to Move My-T-Soft (click & drag)"

;setting in the KBF

;If MoveOverride=No or just blank, MenuOverride= then the KBF setting will use

;If MoveOverride=Move the user will be able to move the layout (click & drag to move)

;If MoveOverride=NoMove, then the layout will not be moveable

HoverEnable=

;The HoverEnable setting will enable the use of the key hover highlight option

;If HoverEnable=No or just blank, the key hover option will be disabled

;If HoverEnable=Yes or HoverEnable=Hover the key hover will be enabled

;If HoverEnable=NoHover, then the key hover option will be disabled

KeyPressEnable=

;The KeyPressEnable setting will enable the use of the key press highlight option

;If KeyPressEnable=No or just blank, the key press option will be disabled

;If KeyPressEnable=Yes or KeyPressEnable=KeyPress the key press option will be enabled

;If KeyPressEnable=NoKeyPress, then the key press option will be disabled

KeyZoom=No

KeyZoomOffset=15

KeyZoomRegionAdjust=8

KeyZoomHideZoomTimeMS=250

KeyZoomMagFactor=2

KeyZoomLocation=1

KeyZoomImage=Down

KeyZoomWideKeyRatioNoZoom=1.5

;The KeyZoom setting will use a secondary window to display a magnified (zoomed) image of

;the key being pressed. If KeyZoom=Yes, the window will be used, and the other settings

;will be referenced. If KeyZoom=No (or blank/anything but yes), the window will not be

;used, and the other settings will not be referenced.

;KeyZoomOffset=15 - this is a pixel offset used for handling the display of the window

;off the cursor - larger values means further away from the current cursor position.

;KeyZoomRegionAdjust=8 - this is a value used for the rounded rectangle region used for

;the key zoom window. If the value is negative, no region is used, and a rectangle will

;be shown. Larger values mean less area for the key, and more rounded corners.

;KeyZoomHideZoomTimeMS=450 is the setting for the timer used to automatically hide the

;zoomed image window - reasonable values range from 500-1500. Note that if the mouse cursor

;clicks or moves over the zoom window, it will instantly hide.

;KeyZoomMagFactor=2 - this is how much of a magnification factor will be used. It is an integer.

;Reasonable values are 2 or 3.

;KeyZoomLocation=1 - this setting determines which location the zoom window will be shown

;in reference to the mouse cursor / click point. Use 1 for above, 2, for below, 3 for left, 4 for right

;KeyZoomImage=Default - this setting determines which image(s) will be used for the zoom/magnified key image

;If empty, or KeyZoomImage=Active, then the current/active painted image will be used. If

;KeyZoomImage=Default, then only the base/original/Up image will be used for the zoom image

;If KeyZoomImage=Down, then the down key image will be used for the zoom image

;KeyZoomWideKeyRatioNoZoom=0 - If KeyZoomWideKeyRatioNoZoom is 0, then ALL keys will be

;treated as equal, and the zoom window will be displayed for all keys.

;If KeyZoomWideKeyRatioNoZoom is non zero, then the ratio will determine which wide keys will NOT be ;displayed.

;For example, if KeyZoomWideKeyRatioNoZoom=2, then only keys twice as wide as they are high

;will NOT be zoomed. KeyZoomWideKeyRationNoZoom=1.5 is the lowest value you should use, as lower

;values could result in no keys being displayed, even though KeyZoom=Yes

[Region]

;This is 1280 settings

;Area1=Ellipse,0,2,70,70

;Area2=Rect,0,38,1280,229

;Area3=Ellipse,1210,2,1280,70

;Area4=Rect,38,2,1242,264

;Area5=Ellipse,0,194,70,264

;Area6=Ellipse,1210,194,1280,264

;The section [Region] can have Area1 and /or Area2 entries up to Area8

;The rectangle is 0 based, and has form "Area1=Rect,[Left],[Top],[Right],[Bottom]"

;e.g. Area1=Rect,10,12,100,200

;The Ellipse shape is the ellipse that fits in the rectangle defined by

;a specified "Ellipse" and the rectange coordinates

;0 based, and has form "Area1=Ellipse,[Left],[Top],[Right],[Bottom]"

;e.g. Area1=Ellipse,10,12,100,200

;If only Area1 exists, it will be the sole region

;If the coordinates or the region fails for any reason, no region action will occur

;If Area1 and Area2 exists, they will be combined with an OR logic function,

;resulting in a "Union of the 2 combined regions" This continues up to Area8

;If the regions are not connected, there will be multiple visible regions

;If any area is invalid, no region action will occur

;General approach / suggestions

;- Establish board size in Build-A-Board

;- Decide on final shape to be shown on target system

;- Use graph paper, or visualize within Build-A-Board the coordinates for

;the final shape

;- Enter Area1 and/or Area2-Area8 as required

;- Save [Region] section in Keyboard Run-Time Settings

;- Build board

;- Test

;- To disable, remove section, or comment out entries using semi-colon

;Example - rounded rect keyboard

;[Region]

;Area1=Ellipse,0,2,70,70

;Area2=Rect,0,38,1280,229

;Area3=Ellipse,1210,2,1280,70

;Area4=Rect,38,2,1242,264

;Area5=Ellipse,0,194,70,264

;Area6=Ellipse,1210,194,1280,264

;Examples - Board is 200 x 300

;Circle

;[Region]

;Area1=Ellipse,0,0,200,200

;T shape

;[Region]

;Area1=Rect,0,0,200,100

;Area2=Rect,75,100,125,300

;Reversed L shape

;[Region]

;Area1=Rect,150,0,200,300

;Area2=Rect,0,200,200,300

[Macros]

Macro1=Example Macro[Enter]

Macro2=This is a sample sentence for Macro #2![Enter]

Macro3=[CMD:EXEC=Notepad.exe]