XieSetOpDefaults(3X) — Subroutines
Digital
NAME
XieSetOpDefaults − This routine sets the current constraint model defaults on the server.
C Format
XieSetOpDefaults(dpy, model, levels)
C Argument Information
Display ∗dpy;
int model;
unsigned long levels[];
RETURN VALUES
None.
PARAMETERS
dpyThe dpy argument specifies the X11 display identifier returned by the XOpenDisplay routine.
modelThe model argument specifies the desired default constraint model.
| Symbol | Operation Performed |
| XieK_HardClip | Apply hard clip model |
| XieK_ClipScale | Apply clip scale model |
| XieK_HardScale | Apply hard scale model |
levelsThe levels argument specifies an array of quantization level numbers routines use when constraining each component of an image. The array length must be at least equal to XieK_MaxComponents.
DESCRIPTION
This routine sets the current constraint model defaults on the server. The constraint models supported by XIE are as follows:
•Hard Clip
•Clip Scale
•Hard Scale
In describing the constraint models, the floor is the smallest value allowed after the data is constrained. For XIE, the floor is always 0. The ceiling is the largest positive integer value allowed after the data is constrained to the specified number of levels.
In the Hard Clip model, data is constrained in the following steps:
1All values less than 0 are set to 0
2All values greater than the ceiling are set to the ceiling
3All values are rounded to the nearest integer
In the Clip Scale model, data is constrained in the following steps:
1All values less than 0 are set to 0
2All values greater than the ceiling are set to the ceiling
3All values are offset so that the smallest value is set to 0 and then scaled so the largest value is set to the ceiling
4Values are rounded to the nearest integer
In the Hard Scale model, data is constrained in the following steps:
1All values are offset so that the smallest value is set to 0 and scaled so the largest value is set to the ceiling
2Values are rounded to the nearest integer
XIE Events and Error Messages
Protocol Messages: X_ieSetOpDefaults
XIE event returned: None
XieLib errors: None
XieServer errors: BadValue -- Invalid constraint model or levels less than or equal to 0