paint_entity

SilverScreenAPI

int paint_entity ( char *path, int color )

char *path; // path name of block, object or symbol

int color; // color to use

Synopsis

#include "silver.h"

The paint_entity function draws the specified entity in the specified color.

Parameters

path is the full path name of the entity. color is the color used to draw the entity.

Return Value

paint_entity returns SS_SUCCESS (0) if the spcified block, object or symbol exists, and SS_NOTFOUND (-1) otherwise.

Comments

The maximum number of colors in the system is given by the system variable num_colors . The current maximum for num_colors is 256, and therefore the lower byte only is used for color information.

The color parameter may have the following flags or'ed into its value:

Value	Meaning
COLOR_REPAINT	the specified entity is drawn in its original color (the color parameter is ignored).
COLOR_WIDE	The specified entity is drawn in wide lines.
COLOR_INVERSE	The specified entity is drawn by xor'ing the screen with the color (and width) lines specified, and the lines drawn are saved away, where they may be xor'ed back by refresh_lines .