HC_Show_Image
-
void
HC_Show_Image(Key key, float *x, float *y, float *z, char *format, int *width, int *height, void *data) - void HC_Show_Image(Key key, float x, float y, float z, char format, int width, int height, void data)
Returns the rectangular array of pixel data, as referenced by a key.
Show_Image() reads back the pixel values currently stored in an image. This is especially useful if the image was edited several times using Edit_Image() and you need to determine the final result. The key for the image might come from Show_Selection_Element() or Find_Contents(), or it might have been saved by your program when the image was created. Use Show_Image_Size() to determine how large the data array must be, before you actually call Show_Image.
Use Show_Partial_Image() to return the values of the pixels in just a portion of the image at a time. This is helpful if the image is very large and your program cannot (or need not) store the entire array at once. The rectangular region defined by the parameters to this function must be within the bounds of the image.
HC_Insert_Image, HC_Edit_Image, HC_Move_Image, HC_Get_Selection, HC_Begin_Contents_Search, HC_Compute_Coordinates.Parameters
key: Unique numeric identifier pointing to an image in the database.
x: The coordinates of the center of the image. Returned to caller. Passed by reference always.
y:
z:
format: A description of how data in the data array is packed. See Insert_Image. Returned to caller. Passed by reference always.
width: The number of columns in data
height: The number of rows in data
data: The pixel values currently stored in the image referenced by key, encoded according to format. Returned to caller. Passed by reference always.