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

PgBevelBox(), PgBevelBoxCx()

Draw a beveled box with gradients

Synopsis:

int PgBevelBox( PhPoint_t *ul,
                PhPoint_t *lr,
                PgColor_t light_color,
                PgColor_t flat_color,
                PgColor_t dark_color,
                short depth,
                short width,
                PgColor_t outline_color,
                PgColor_t inline_color,
                int flags );

int PgBevelBoxCx( void * dc,
                  PhPoint_t *ul,
                  PhPoint_t *lr,
                  PgColor_t light_color,
                  PgColor_t flat_color,
                  PgColor_t dark_color,
                  short depth,
                  short width,
                  PgColor_t outline_color,
                  PgColor_t inline_color,
                  int flags );

Arguments:

dc
PgBevelBoxCx() only. A void pointer to any type of draw context. Examples of draw contexts are:
ul, lr
Pointers to PhPoint_t structures that define the upper left and lower right corners of the beveled box.
light_color
A PgColor_t that defines the lightest color in the bevel gradient.
flat_color
The middle/neutral color in the bevel gradient, and the box's fill color.
dark_color
The darkest color in the bevel gradient.
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 width of the bevel, not 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:

Library:

ph

Description:

These functions draw a beveled box with gradients. PgBevelBox() works on the current draw context, while you can specify the draw context for PgBevelBoxCx().

The only difference between these functions and PgDrawGradientBevelBox() or PgDrawGradientBevelBoxCx() is that the latter allow separate specifications for the upper-left and the lower-right flat colors. The two flat colors are the same in these function.

Returns:

0
Success.
-1
An error occurred.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PgColor_t, PgContrastBevelBox*(), PgDrawGradientBevelBox*(), PhPoint_t

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