Expand/Shrink

imFileImageLoadBitmap

Definition: include pGUI.e

imImage im = imFileImageLoadBitmap(string filename, integer index=0, atom pError=NULL)
Description: Loads an image from file, but forces the image to be a bitmap. Opens, loads and closes the file.

filename: Name of the file to be loaded.
index: specifies the image number between 0 and image_count-1.
pError: pointer to allocated memory which recieves an error code.

Returns NULL on failure. Attributes from the file will be stored with the image. See also imErrorCodes.
pwa/p2js: Not supported
Notes: This wraps the C function imFileImageLoadBitmap, which IupLoadImage invokes internally (when appropriate). Use IupLoadImage to obtain an Ihandle which can be used on a control; imFileImageLoadBitmap returns an imImage, which is more suitable for image manipulation. See simple_paint.exw for an example of use.
Auxillary Functions The following routines can be used with imImage handles (see simple_paint.exw for examples of use):

integer width = im_width(imImage image)   -- (ie im_width(image) is equilvalent to image->width in C)

integer height = im_height(imImage image)   -- (ie im_height(image) is equilvalent to image->height in C)

integer depth = im_depth(imImage image)   -- (ie im_depth(image) is equilvalent to image->depth in C)

integer color_space = im_color_space(imImage image)   -- (ie im_color_space(image) is equilvalent to image->color_space in C)

atom dataptr = im_data(imImage image)   -- (ie im_data(image) is equilvalent to image->data in C)

integer {r,g,b} = im_pixel(imImage image, integer x, y)

imImageSetAttribString(imImage image, string attrib, nullable_string v)

string res = imImageGetAttribString(imImage image, string attrib) Returns "" if not found.

integer error = imFileImageSave(string filename, string fmt, imImage image)

imProcessRenderFloodFill(imImage image, integer start_x, start_y, sequence replace_color, atom tolerance)

imProcessRenderConstant(imImage image, sequence v)

imImage image = imImageDestroy(imImage image) -- (returns/sets image to NULL)

imConvertPacking(atom pSrcData, pDstData, integer width, height, src_depth, dst_depth, data_type, src_is_packed)

imImageRemoveAlpha(imImage image)

imImage res = imImageCreateBased(imImage image, integer width=-1, height=-1, color_space=-1, data_type=-1)

imConvertColorSpace(imImage src_image, imImage dst_image)

imImage image = imImageCreate(integer width, height, color_space, data_type)

imProcessResize(imImage src_image, imImage dst_image, integer order)

imImage clone = imImageClone(imImage image)

imProcessMirror(imImage src_image, imImage dst_image)

imProcessFlip(imImage src_image, imImage dst_image)

imProcessRotate180(imImage src_image, imImage dst_image)

imProcessRotate90(imImage src_image, imImage dst_image, integer dir_clockwise)

imProcessNegative(imImage src_image, imImage dst_image)

imProcessToneGamut(imImage src_image, imImage dst_image, integer op, sequence params)

atom pData = imImageGetOpenGLData(imImage image)