|Build-A-Board®: for Windows; The Next Generation of Onscreen Keyboards; Version 2.20 Release 5; User's Guide|
|Prev||Chapter 7. Advanced User Notes||Next|
The listing below is the Version 2.20 Release 5 default listing/settings for MYTSOFT.INI (Builder file MYTSOFT.TXT). This text file is embedded in the built .KBF file and settings are platform dependent (as documented for the platform or in the file below).
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
;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 XPosition / YPosition settings can be any supported format. If set, these automatically
;override the embedded pixel position as part of the KBF Window data structure
;Additionally, for these to be used as overrides, the Position type embedded in the
;KBF must be set to 2 - if default 1, these overrides will not be used. Internal Save Position
;and KBFEdit utility can save pixel position and clear the override.
;nn% (where nn can be 0-100) defines percentage of main display for Top/Left X/Y
;<left><center><right> for X left side, middle of screen, or X right side of display
;<top><middle><bottom> for Y top, middle of screen, or Y bottom of display
;Example: <bottom><right> or <center><middle>>.
;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 StretchToFitWidth setting will enable the use of the automatic resizing to fit width of screen
;If StretchToFitWidth=No or just blank, the stretch to fit option will be disabled
;If StretchToFitWidth=Yes or the stretch to fit option will be enabled
;If StretchToFitWidth=WinCE, then the stretch to fit option will be only enabled or Windows CE platforms
;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]