Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PgContrastBevelBox(), PgContrastBevelBoxCx()

Draw a beveled box with gradients and a given level of contrast

Synopsis:

int PgContrastBevelBox( PhPoint_t *ul,
                        PhPoint_t *lr,
                        PgColor_t flat_color,
                        int contrast,
                        short depth,
                        short width,
                        PgColor_t outline_color,
                        PgColor_t inline_color,
                        int flags );

int PgContrastBevelBoxCx( void *dc,
                          PhPoint_t *ul,
                          PhPoint_t *lr,
                          PgColor_t flat_color,
                          int contrast,
                          short depth,
                          short width,
                          PgColor_t outline_color,
                          PgColor_t inline_color,
                          int flags );

Arguments:

dc
PgContrastBevelBoxCx() only. A void pointer to any type of draw context. Examples of draw contexts are:
ul, lr
Pointers to PhPoint_t that define the upper left and lower right corners of the beveled box.
flat_color
A PgColor_t that defines the middle/neutral color in the bevel-gradients, and the box's fill color if you set Pg_BVB_FILL in the flags.
contrast
The contrast in the light-to-flat and flat-to-dark gradients, in the range 0 (low/no contrast) to 255 (high/max contrast).
depth
The number of isochrome lines in the light-to-flat and flat-to-dark bevel gradients. The sign of the depth controls the location of an (imaginary) light source:

Light sources for a beveled box

width
The total width of the beveled border, including outlines and inlines.
outline_color
The color of the outline rectangle.
inline_color
The color of the inline rectangle.
flags
Flags that affect the appearance of the beveled box:

Note: If you specify any of the above arguments as Pg_TRANSPARENT, the value of the argument will be converted to Pg_WHITE.

Library:

ph

Description:

These functions draw a beveled box with gradients and a given level of contrast. PgContrastBevelBox() works on the current draw context, while you can specify the draw context for PgContrastBevelBoxCx().

Returns:

0
Success.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PgColor_t, PgBevelBox*(), PgDrawGradientBevelBox*(), PhPoint_t

Gradients in the Raw Drawing and Animation chapter of the Photon Programmer's Guide