[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
FXCOLOR is designed for Clipper version 5.01. It has not been tested
with other versions and may or may not be compatible. It requires a VGA
system and will not install itself unless a VGA is detected. It is
designed to work with color systems. The effects on a non-color system
has not been tested.
FXCOLOR must be installed before it can be used. The command
fx_Enable() is used to install FXCOLOR. None of the commands (except
fx_IsFxOn() and fx_IsVGA() - see docs for those commands) will perform
any action and will probably return meaningless values if called while
FXCOLOR is NOT installed.
FXCOLOR must be uninstalled before exiting your application. The
command fx_Disable() is used to uninstall FXCOLOR. Although FXCOLOR
includes detection for program termination and will uninstall itself if
program termination is detected, this should not be relied upon. You
should use the fx_Disable() command.
When FXCOLOR is installed, it hooks the timer interrupt 1Ch and
interrupt 21h. These remain active until uninstalled. If your
application uses other intercept routines, you should be sure to nest
those routines. An example is below:
fx_Enable() <- FXCOLOR timer intercept is installed
OtherTimer( ON ) <- another timer intercept is installed
.... <- other application code
OtherTimer( OFF ) <- another timer intercept is uninstalled
fx_Disable() <- FXCOLOR timer intercept is uninstalled
Failure to nest intercept routines will undoubtedly cause you great
suffering.
FXCOLOR also disables the hardware blinking bit when installed and
re-enables it when uninstalled. When the hardware blinking bit is
disabled, high-intensity background colors are allowed. The Clipper
SetBlink() command performs the same function. You may use the
SetBlink() command while FXCOLOR is installed to set hardware blinking
ON or OFF. Remember though, if any high-intensity background colors are
currently displayed, they will revert to normal and the foreground text
will begin blinking.
With hardware blinking OFF, if you want to display a high-intensity
background color, you should use an asterisk "*" instead of a plus-sign
"+" for the background color in the CLIPPER color string:
"r/bg*" <- Ok
"r/bg+" <- Does not work
For FXCOLOR parameters however, you must use the plus-sign "+" to denote
high-intensity colors:
fx_Blink( "r", "bg+" ) <- Ok
fx_Blink( "r", "bg*" ) <- Does not work
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson