BuilderPlus is an extension to HTBasic that needs to share the graphics environment. This may require adjusting certain settings in order to avoid unexpected results. For example, it is recommended to use the HTBasic startup command line switch "-graphics buffering on". Otherwise, whenever a widget or dialog is moved, shrunk, or destroyed, all underlying HTBasic graphics will be erased (unless that widget or dialog has its RESTORE SCREEN attribute set).

 

Also, BuilderPlus will reinitialize a portion of the HTBasic COLOR MAP to the values specified in your CONFIG file after each of the following:

 

 

The portion converted depends on how many colors are available to HTBasic as specified with the HTBasic "-colors" command line switch, and which HTBasic pens are referenced in the logical pen portion of your CONFIG file.

 

By default, BuilderPlus uses 16 colors. If less than 256 colors are available to HTBasic, these 16 colors are mapped to pens 0-15 and pens 0-7 are set the same as the HTBasic default. If 256 colors are available, the 16 default HTBasic colors are mapped to pens 16-31.

 

If you subsequently execute any SET PEN command, that definition remains in effect until any of the five events mentioned above occur:

 

The following commands can improve the appearance of the display when running BuilderPlus GUIs.

 

 

BuilderPlus has priority over Mouse, keyboard, or touchscreen input when any widget has the current focus. You can force the input back to HTBasic by clicking on the HTBasic title bar to give it focus.

 

BuilderPlus requires access to the following support files which must be in a directory that HTBasic searches.