XiePointStats(3X) — Subroutines
Digital
NAME
XiePointStats − This routine returns statistical information about a particular pixel value and the surrounding values.
C Format
XiePointStats(src_id, x, y, height, width, cmpmsk, stats)
C Argument Information
XiePhoto src_id;
unsigned long x;
unsigned long y;
unsigned long height;
unsigned long width;
unsigned long cmpmsk;
XieStatsRec stats[];
RETURN VALUES
None.
PARAMETERS
src_idThe src_id argument specifies the identifier of the source image. The source image can be either constrained or unconstrained.
xThe x argument specifies the x-coordinate of the pixel around which the routine calculates statistics.
yThe y argument specifies the y-coordinate of the pixel around which the routine calculates statistics.
heightThe height argument specifies the height in pixels of the region around the target pixel over which the routine calculates statistics.
widthThe width argument specifies the width in pixels of the region around the target pixel over which the routine calculates statistics.
cmpmskThe cmpmsk argument specifies a bit mask that specifies which components of the source image the routine uses.
statsThe stats argument specifies a pointer to an array of XieStats structures that receive the statistical information. The array must contain 1 structure for each bit you set in the cmpmsk argument. The format of the XieStats record is:
typedef struct {
double value;
double minimum;
double maximum;
double mean;
double stddev;
double variance;
} XieStatsRec, ∗XieStats;
| Symbol | Operation Performed |
| value | The value of the pixel at the specified location |
| minimum | The minimum pixel value in this area |
| maximum | The maximum pixel value in this area |
| mean | The mean pixel value for this area |
| stddev | The standard deviation of the pixel distribution for this area |
| variance | The variance of the pixel distribution for this area |
DESCRIPTION
This routine returns statistical information about a particular pixel value and the surrounding values.
XIE Events and Error Messages
Protocol Messages: X_iePointStats
XIE event returned: None
XieLib errors: Reply error, BadLength
XieServer errors: BadIDChoice -- Invalid identifier
BadAlloc -- Insufficient server resources
BadValue -- The x- and y-coordinates are not within the source image