Digital

NAME

XieScale − This routine creates a scaled copy of a source image. 

C Format

dst_photo_id = XieScale(src_id, width, height)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id;
unsigned long  width;
unsigned long  height;

RETURN VALUES

If the source image is an unbound photomap, the routine returns the identifier of the destination image in the dst_photo_id argument. Otherwise, the routine returns the identifier of the photoflo to which the processing element is appended. You can free the image using the XieFreeResource routine. 

PARAMETERS

src_idThe src_id argument specifies the identifier of the source image. The source image can be an unbound photomap, a photoflo, a phototap, or a photomap bound to the photoflo.  If the source image is an unbound photomap, the operation is performed immediately. Otherwise, a processing element is appended to the photoflo with execution pending a call to the XieExecuteFlo routine.  The photoflo is specified explicitly if the source image is a photoflo, or implicitly if the source image is a phototap or a bound photomap. 

widthThe width argument specifies the width in pixels of the destination image. 

heightThe height argument specifies the height in scanlines of the destination image. 

DESCRIPTION

This routine creates a scaled copy of a source image. 

If the operation is performed immediately and you selected computation events using the XieSelectEvents routine, the routine adds an XieK_ComputationEvent to the X11 event queue when the routine is completed. 

XIE Events and Error Messages

Protocol Messages: X_ieScale

XIE event returned: XieK_ComputationEvent if immediate execution and computation events are selected

XieLib errors: None

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources

BadValue -- Height or width equal to 0