DATASERV (kappserv) functions


LIBRARY ROUTINE

kcolor_set_attribute - set the value of a color attribute in a data object.

LIBRARY CALL

int kcolor_set_attribute(
   kobject  object,
   char    *attribute,
   kvalist)

INPUT

OUTPUT

none

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

This function is used to assign the value of a color attribute to a data object.

This color service function should be used in conjunction with other application services such as polymorphic data services and geometry data services. This function will work on data objects opened or created with either of those services.

Attributes are set by passing in the attribute name along with the value or variable containing the value to assign to the attribute.

The following example illustrates the use of the set attribute call to assign two different color attributes. The define KRGB could have been passed in directly to set the colorspace attribute.

int colorspace = KRGB; kcolor_set_attribute(object, KCOLOR_COLORSPACE, colorspace);, kcolor_set_attribute(object, KCOLOR_MAP_OPERATION, KROW_LEFT);

A complete list of color attributes can be found in Chapter 4 of Programming Services Volume II.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

Calling this function with an incorrect number of arguments in the variable argument list will not cause any compiler errors, but will often generate a segmentation fault.

MODIFICATION

none

FILES

$DATASERV/objects/library/kappserv/src/color.c

SEE ALSO

kappserv(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.