Digital

NAME

XieClonePhoto − This routine clones a photoflo using an existing photomap as its image data source, or clones a photomap using only the attributes of an existing photomap. 

C Format

photo_id = XieClonePhoto(phm_id, type)

C Argument Information

XiePhoto     photo_id;
XiePhotomap   phm_id;
unsigned long  type;

RETURN VALUES

If you clone a photomap, the routine returns the identifier of the cloned photomap in the photo_id argument. If you clone a photoflo, the routine returns the identifier of the cloned photoflo.  You can free the photo using the XieFreeResource routine. 

PARAMETERS

phm_idIf you clone a photoflo, the phm_id argument specifies the existing unbound photomap that the routine binds to the photoflo. The photomap does not have to contain image data, and you can transport client image data to the photomap prior to or during photoflo execution, or both. The photomap can also supply data to downstream processing elements in the photoflo, but is not available for any other purpose until you free the photoflo. 

If you clone a photomap, the phm_id argument specifies the unbound photomap whose attributes are copied to the new photomap. 

typeThe type argument specifies whether the cloned image is a photoflo or a photomap. Specify either the XieK_Photoflo or XieK_Photomap symbol. 

DESCRIPTION

This routine clones a photoflo using an existing photomap as its image data source, or clones a photomap using the attributes only of an existing photomap. 

XIE Events and Error Messages

Protocol Messages: X_ieCreateByReference

XIE event returned: None

XieLib errors: Returns a null if the source image is not a photomap or is a photoflo

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources