The image data structure definition.
Colors: the copies of color.mli
val extension : format -> stringFunctions for filename extensions
returns the corresponding extension "gif", "bmp" etc. for given format
val guess_format : string -> formatreturns the image format guessed from the file extension of a given file name
val guess_extension : string -> formattype info = Info.info = | Info_DPI of floatdot per inch
*)| Info_BigEndian| Info_LittleEndianendianness of image file
*)| Info_ColorModel of colormodelcolor model of image file
*)| Info_Depth of intImage bit depth
*)| Info_CorruptedFor corrupted PNG files
*)Infos attached to bitmaps
val dpi : info list -> float optionInfo query
Image file header
file_format filename reads the header of image file filename and returns its format and some useful information found in the header (ex. width, height). file_format does not read image contents, but just quickly returns file header information.
file_format does not depend on any external libraries
val load_progress : load_option list -> (float -> unit) optionOption queries
val load_resolution : load_option list -> (float * float) optionval save_progress : save_option list -> (float -> unit) optionval save_interlace : save_option list -> boolval save_quality : save_option list -> int optiontype format_methods = {check_header : string -> header;load : (string -> load_option list -> t) option;save : (string -> save_option list -> t -> unit) option;load_sequence : (string -> load_option list -> sequence) option;save_sequence : (string -> save_option list -> sequence -> unit) option;}val add_methods : format -> format_methods -> unitIf you write new drivers for some image format, use this function to register their loading/saving functions into the libaray
val load : string -> load_option list -> tload filename options read the header of an image file filename, loads the image by calling corresponding loading method, and returns it. If the file format is not supported by the library, a Wrong_file_type exception will be raised. You can specify loading options in options such as progressive meter function.
val save : string -> format option -> save_option list -> t -> unitsave filename formatopt options image saves image into a file filename. The image format can be specified by formatopt. If formatopt is Some format, then format is used. If it is None, then the image format is guessed from filename. You can specify some saving parameters options. Some options are specific to some image formats and do not work with the others.
val load_sequence : string -> load_option list -> sequenceval save_sequence :
string ->
format option ->
save_option list ->
sequence ->
unitval size : t -> int * intReturns size (width and height) of image
val destroy : t -> unitFree the image. If you turn on image swapping (see bitmap.mli), you can call this function explicitly to tell the library that this image is no longer used. (This is not required, though.)
sub dst x y width height returns sub-bitmap of dst, at (x, y) - (x + width - 1, y + height - 1).
blit src sx sy dst dx dy width height copies the rectangle region of src at (sx, sy) - (sx + width - 1, sy + height - 1) to dst, at (dx, dy) - (dx + width - 1, dy + height - 1).
val blocks : t -> int * int