Imager::APIRef - Imager's C API.
i_color color; color.rgba.red = 255; color.rgba.green = 0; color.rgba.blue = 255; i_fill_t *fill = i_new_fill_...(...); # Drawing i_arc(im, 50, 50, 20, 45, 135, &color); i_arc_aa(im, 50, 50, 35, 90, 135, &color); i_arc_aa_cfill(im, 50, 50, 35, 90, 135, fill); i_arc_cfill(im, 50, 50, 35, 90, 135, fill); i_box(im, 0, 0, im->xsize-1, im->ysize-1, &color). i_box_cfill(im, 0, 0, im->xsize-1, im->ysize-1, fill); i_box_filled(im, 0, 0, im->xsize-1, im->ysize-1, &color); i_circle_aa(im, 50, 50, 45, &color); i_flood_cfill(im, 50, 50, fill); i_flood_cfill_border(im, 50, 50, fill, border); i_flood_fill(im, 50, 50, &color); i_flood_fill_border(im, 50, 50, &color, &border); # Error handling # Files i_get_image_file_limits(&width, &height, &bytes) i_i_int_check_image_file_limits(width, height, channels, sizeof(i_sample_t)) i_set_image_file_limits(500, 500, 1000000); # Fills fill = i_new_fill_fount(0, 0, 100, 100, i_ft_linear, i_ft_linear, i_fr_triangle, 0, i_fts_grid, 9, 1, segs); # Image # Image creation # Image quantization # Paletted images # Tags i_fill_destroy(fill);
Fills an arc centered at (x,y) with radius rad covering the range of angles in degrees from d1 to d2, with the color.
Antialias fills an arc centered at (x,y) with radius rad covering the range of angles in degrees from d1 to d2, with the color.
Antialias fills an arc centered at (x,y) with radius rad covering the range of angles in degrees from d1 to d2, with the fill object.
Fills an arc centered at (x,y) with radius rad covering the range of angles in degrees from d1 to d2, with the fill object.
Outlines the box from (x1,y1) to (x2,y2) inclusive with color.
Fills the box from (x1,y1) to (x2,y2) inclusive with fill.
Fills the box from (x1,y1) to (x2,y2) inclusive with color.
Antialias fills a circle centered at (x,y) for radius rad with color.
Flood fills the 4-connected region starting from the point (seedx, seedy) with fill.
Returns false if (seedx, seedy) are outside the image.
Flood fills the 4-connected region starting from the point (seedx, seedy) with fill, the fill stops when it reaches pixels of color border.
Flood fills the 4-connected region starting from the point (seedx, seedy) with color.
Flood fills the 4-connected region starting from the point (seedx, seedy) with color, fill stops when the fill reaches a pixels with color border.
Retrieves (r-l) pixels starting from (l,y) into colors.
Returns the number of pixels retrieved.
Retrieves (r-l) pixels starting from (l,y) into colors as floating point colors.
Reads palette indexes for the horizontal line (x, y) to (r-1, y) into indexes.
Returns the number of indexes read.
Always returns 0 for direct color images.
Retrieves the color of the pixel (x,y).
Returns 0 if the pixel was retrieved, or -1 if not.
Retrieves the color of the pixel (x,y) as a floating point color into fcolor.
Reads sample values from im for the horizontal line (l, y) to (r-1,y) for the channels specified by chans, an array of int with chan_count elements.
If chans is NULL then the first chan_count channels are retrieved for each pixel.
Returns the number of samples read (which should be (r-l) * chan_count)
Reads floating point sample values from im for the horizontal line (l, y) to (r-1,y) for the channels specified by chans, an array of int with chan_count elements.
Draw a line to image using bresenhams linedrawing algorithm
im - image to draw to x1 - starting x coordinate y1 - starting x coordinate x2 - starting x coordinate y2 - starting x coordinate val - color to write to image endp - endpoint flag (boolean)
Antialias draws a line from (x1,y1) to (x2, y2) in color.
The point (x2, y2) is drawn only if endp is set.
Sets (r-l) pixels starting from (l,y) using (r-l) values from colors.
Returns the number of pixels set.
Sets (r-l) pixels starting from (l,y) using (r-l) floating point colors from colors.
Writes palette indexes for the horizontal line (x, y) to (r-1, y) from indexes.
Returns the number of indexes written.
Sets the pixel at (x,y) to color.
Returns 0 if the pixel was drawn, or -1 if not.
Does no alpha blending, just copies the channels from the supplied color to the image.
Sets the pixel at (x,y) to the floating point color fcolor.
Clears the error stack.
Called by any imager function before doing any other processing.
Called by an imager function to push an error message onto the stack.
No message is pushed if the stack is full (since this means someone forgot to call i_clear_error(), or that a function that doesn't do error handling is calling function that does.).
A version of i_push_error() that does printf() like formating.
Intended for use by higher level functions, takes a varargs pointer and a format to produce the finally pushed error message.
Retrieves the file limits set by i_set_image_file_limits().
Checks the size of a file in memory against the configured image file limits.
This also range checks the values to those permitted by Imager and checks for overflows in calculating the size.
Returns non-zero if the file is within limits.
This function is intended to be called by image file read functions.
Set limits on the sizes of images read by Imager.
Setting a limit to 0 means that limit is ignored.
Negative limits result in failure.
Returns non-zero on success.
Call to destroy any fill object.
Creates a new general fill which fills with a fountain fill.
Creates a new hatched fill with the fg color used for the 1 bits in the hatch and bg for the 0 bits. If combine is non-zero alpha values will be combined.
If cust_hatch is non-NULL it should be a pointer to 8 bytes of the hash definition, with the high-bits to the left.
If cust_hatch is NULL then one of the standard hatches is used.
(dx, dy) are an offset into the hatch which can be used to unalign adjoining areas, or to align the origin of a hatch with the the side of a filled area.
Create an image based fill.
matrix is an array of 9 doubles representing a transformation matrix.
xoff and yoff are the offset into the image to start filling from.
Create a solid fill based on an 8-bit color.
If combine is non-zero then alpha values will be combined.
Create a solid fill based on a float color.
Creates a new image that is a copy of src.
Tags are not copied, only the image data.
Returns: i_img *
Copies image data from the area (x1,y1)-[x2,y2] in the source image to a rectangle the same size with it's top-left corner at (tx,ty) in the destination image.
If x1 > x2 or y1 > y2 then the corresponding co-ordinates are swapped.
(x1,y1) (x2,y2) specifies the region to copy (in the source coordinates) (tx,ty) specifies the upper left corner for the target image. pass NULL in trans for non transparent i_colors.
Destroy image and free data via exorcise.
im - Image pointer
Return image information
im - Image pointer info - pointer to array to return data
info is an array of 4 integers with the following values:
info[0] - width info[1] - height info[2] - channels info[3] - channel mask
Takes the sub image src[src_minx, src_maxx)[src_miny, src_maxy) and overlays it at (tx,ty) on the image object.
The alpha channel of each pixel in src is used to control how much the existing colour in im is replaced, if it is 255 then the colour is completely replaced, if it is 0 then the original colour is left unmodified.
Create a new 16-bit/sample image.
Returns the image on success, or NULL on failure.
Creates a new image object x pixels wide, and y pixels high with ch channels.
Creates a new double per sample image.
Creates a new paletted image of the supplied dimensions.
Returns a new image or NULL on failure.
Returns an image of the same type (sample size, channels, paletted/direct).
For paletted images the palette is copied from the source.
Returns an image of the same type (sample size).
For paletted images the equivalent direct type is returned.
Analyzes the count images in imgs according to the rules in quant to build a color map (optimal or not depending on quant->make_colors).
Quantize the image given the palette in quant.
On success returns a pointer to a memory block of img->xsize * img->ysize i_palidx entries.
On failure returns NULL.
You should call myfree() on the returned block when you're done with it.
This function will fail if the supplied palette contains no colors.
Dither the alpha channel on img into the palette indexes in data. Pixels to be transparent are replaced with trans_pixel.
The method used depends on the tr_* members of quant.
Adds colors to the image's palette.
On success returns the index of the lowest color added.
On failure returns -1.
Always fails for direct color images.
Returns the number of colors in the image's palette.
Returns -1 for direct images.
Searches the images palette for the given color.
On success sets *entry to the index of the color, and returns true.
On failure returns false.
Always fails on direct color images.
Retrieves count colors starting from index in the image's palette.
On success stores the colors into colors and returns true.
Fails if there are less than index+count colors in the image's palette.
Returns the maximum number of colors the palette can hold for the image.
Returns -1 for direct color images.
Sets count colors starting from index in the image's palette.
On sucess returns true.
The image must have at least index+count colors in it's palette for this to succeed.
Delete any tags with the given code.
Returns the number of tags deleted.
Delete any tags with the given name.
Delete a tag by index.
Returns true on success.
Destroys the given tags structure. Called by i_img_destroy().
Searchs for a tag of the given name starting from index start.
On success returns true and sets *entry.
Searchs for a tag of the given code starting from index start.
Retrieve a tag specified by name or code as color.
On success sets the i_color *value to the color and returns true.
Retrieves a tag as a floating point value.
If the tag has a string value then that is parsed as a floating point number, otherwise the integer value of the tag is used.
On success sets *value and returns true.
Retrieve a tag specified by name or code as an integer.
On success sets the int *value to the integer and returns true.
Retrieves a tag by name or code as a string.
On success copies the string to value for a max of value_size and returns true.
value_size must be at least large enough for a string representation of an integer.
The copied value is always NUL terminated.
Initialize a tags structure. Should not be used if the tags structure has been previously used.
This should be called tags member of an i_img object on creation (in i_img_*_new() functions).
To destroy the contents use i_tags_destroy()
Sets the given tag to the string data
Stores the given color as a tag with the given name and code.
Equivalent to i_tags_set_float2(tags, name, code, value, 30).
Sets the tag with the given name and code to the given floating point value.
Since tags are strings or ints, we convert the value to a string before storage at the precision specified by places.
places
Sets the given tag to the integer idata
Tony Cook <tony@imager.perl.org>
Imager, Imager::ExtUtils, Imager::Inline
To install Imager, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Imager
CPAN shell
perl -MCPAN -e shell install Imager
For more information on module installation, please visit the detailed CPAN module installation guide.