Digital

NAME

XieCreatePhoto − This routine creates a photoflo or photomap using the specified image attributes. 

C Format

photo = XieCreatePhoto(dpy, type, width, height, cmp_map, cmp_cnt,
               cmp_lvl, pxl_pol, pxl_ratio, pxl_prog, scn_prog)

C Argument Information

XiePhotomap   photomap;
Display     ∗dpy;
unsigned char  type;
unsigned long  width;
unsigned long  height;
unsigned char  cmp_map;
unsigned char  cmp_cnt;
unsigned char  ∗cmp_lvl;
unsigned char  pxl_pol;
double      pxl_ratio;
unsigned char  pxl_prog;
unsigned char  scn_prog;

RETURN VALUES

The routine returns the identifier of the newly created photomap or photoflo. You can free the photo using the XieFreeResource routine. 

PARAMETERS

dpyThe dpy argument specifies the X11 display identifier returned by the X11 XOpenDisplay routine. 

typeThe type argument specifies the type of image you want to create. You can specify the symbols XieK_Photoflo and XieK_Photomap. 

widthThe width argument specifies the image width in pixels. 

heightThe height argument specifies the image height in scanlines. 

cmp_mapThe cmp_map argument specifies the image component mapping. 

cmp_cntThe cmp_cnt argument specifies the number of components in the image. 

cmp_lvlThe cmp_lvl argument specifies the address of an array containing the number of levels per component in the image.  The length of the array must be at least equal to the value specified by the symbol XieK_MaxComponents. 

pxl_polThe pxl_pol argument specifies the image pixel brightness polarity. 

pxl_ratioThe pxl_ratio argument specifies the image pixel aspect ratio. 

pxl_progThe pxl_prog argument specifies the image pixel progression. 

scn_progThe scn_prog argument specifies the image scanline progression. 

DESCRIPTION

This routine creates a photoflo or photomap using the specified image attributes. 

If you specify that the routine create a photoflo, the routine attaches an ephemeral phototap to the photoflo. If you want to directly access this phototap, use the XieTapFlo routine to assign an identifier to the phototap. 

XIE Events and Error Messages

Protocol Messages: X_ieCreateByValue

XIE event returned: None

XieLib errors: None

XieServer errors: BadAlloc -- Insufficient server resources

BadIDChoice -- Invalid identifier

BadValue -- Height or width is 0