|My-T-Soft Basic: for Windows; Keyboards, Panels and Boards; Version 2.30 Release 4; User's Guide|
|Prev||Chapter 4. Advanced User Notes||Next|
Listed below are settings and information for the Configuration & options for My-T-Soft Basic.
Location of MYTSOFT.INI: MYTSOFT.INI is embedded within the KBF (KeyBoard File) and may be edited in IMG's Build-A-Board or via the utility KBFEDIT.exe (KeyBoard File Editor). Each KBF has its own MYTSOFT.INI, so certain operational settings are tied to the current board in use. Please contact IMG for global operational options & licensing.
All Settings are the default Settings of My-T-Soft Basic.
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
;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
;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.
;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.
;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
;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
;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
;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
;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
;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
;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
;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.
;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
;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
;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
;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
;This is 1280 settings
;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]"
;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]"
;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
;- To disable, remove section, or comment out entries using semi-colon
;Example - rounded rect keyboard
;Examples - Board is 200 x 300
;Reversed L shape
Macro2=This is a sample sentence for Macro #2![Enter]