paint_primitive

SilverScreenAPI

int paint_primitive ( char *path, int id, int color )

char *path; // path to object containing primitive

int id; // ID number of primitive

int color; // color to use

Synopsis

#include "silver.h"

The paint_primitive function draws the specified primitive in the specified color. The primitive is designated by path , which is the name of the object that contains the primitive, and id , which is the ID number of the primitive primitive.

Parameters

path is a null-terminated string containing the full path name of the object containing the primitive. id is the ID number of the primitive in the object at path.color is the color used to draw the primitive.

Value	Meaning
COLOR_REPAINT	the specified primitive is drawn in its original color (the color parameter is ignored).
COLOR_WIDE	The specified primitive is drawn in wide lines.
COLOR_INVERSE	The specified primitive 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 .

Return Value

paint_primitive returns SS_SUCCESS (0) if the spcified primitive exists, and SS_NOTFOUND (-1) otherwise.

Comments

See the comment for paint_entity for a description of permissible color values.