DECOUPLEID(5ICD)

NAME
DecoupleId - decouple a user specified Id from a color from the CACD colormap

SYNOPSIS

DecoupleId (Id)
int Id;
DecoupleIds (Ids, n)
int Ids[];
int n;

PARAMETERS

Id(s)
    a user specified Id of something that is coupled to a color.

n   specifies the number of Ids.

DESCRIPTION
These functions delete the specified Id's from the internal table. The Id's should no longer be referenced.

DIAGNOSTICS
If the call to DecoupleId() is successful 1 is returned. If DecoupleId() fails 0 will be returned and cacdcmaperrno will be set to one of the following values:

NOINIT
    the CACD colormap library was not initialized.

BADID
    a specified Id did not exist.

SEE ALSO
InitCacdCmap(5ICD) CoupleIdToColor(5ICD) CoupleIdToRGB(5ICD) GetAffectedIds(5ICD)

NOTE
For optimal memory usage in the internal table, a set of Id's should be a consecutive set of integers starting at zero.