Home News About Download

Main Page API Reference Globals Related Pages

Support Contribute Contact Tracker

imlib2.c File Reference

Imlib2 library. More...

Functions
EAPI void	imlib_context_set_cliprect (int x, int y, int w, int h)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI void	imlib_context_set_dither_mask (char dither_mask)
	Parameters: dither_mask  The dither mask flag.
EAPI char	imlib_context_get_dither_mask (void)
	Returns: The current dither mask flag.
EAPI void	imlib_context_set_mask_alpha_threshold (int mask_alpha_threshold)
	Parameters: mask_alpha_threshold  The mask alpha threshold.
EAPI int	imlib_context_get_mask_alpha_threshold (void)
	Returns: The current mask mask alpha threshold.
EAPI void	imlib_context_set_anti_alias (char anti_alias)
	Parameters: anti_alias  The anti alias flag.
EAPI char	imlib_context_get_anti_alias (void)
	Returns: The current anti alias flag.
EAPI void	imlib_context_set_dither (char dither)
	Parameters: dither  The dithering flag.
EAPI char	imlib_context_get_dither (void)
	Returns: The current dithering flag.
EAPI void	imlib_context_set_blend (char blend)
	Parameters: blend  The blending flag.
EAPI char	imlib_context_get_blend (void)
	Returns: The current blending flag.
EAPI void	imlib_context_set_color_modifier (Imlib_Color_Modifier color_modifier)
	Parameters: color_modifier  Current color modifier.
EAPI Imlib_Color_Modifier	imlib_context_get_color_modifier (void)
	Returns: The current color modifier.
EAPI void	imlib_context_set_operation (Imlib_Operation operation)
	Parameters: operation
EAPI Imlib_Operation	imlib_context_get_operation (void)
	Returns: The current operation mode.
EAPI void	imlib_context_set_font (Imlib_Font font)
	Parameters: font  Current font.
EAPI Imlib_Font	imlib_context_get_font (void)
	Returns: The current font.
EAPI void	imlib_context_set_direction (Imlib_Text_Direction direction)
	Parameters: direction  Text direction.
EAPI void	imlib_context_set_angle (double angle)
	Parameters: angle  Angle of the text strings.
EAPI double	imlib_context_get_angle (void)
	Returns: The current angle of the text strings.
EAPI Imlib_Text_Direction	imlib_context_get_direction (void)
	Returns: The current direction of the text.
EAPI void	imlib_context_set_color (int red, int green, int blue, int alpha)
	Parameters: red  Red channel of the current color.
EAPI void	imlib_context_get_color (int *red, int *green, int *blue, int *alpha)
	Parameters: red  Red channel of the current color.
EAPI Imlib_Color *	imlib_context_get_imlib_color (void)
	Returns: The current color.
EAPI void	imlib_context_set_color_hsva (float hue, float saturation, float value, int alpha)
	Parameters: hue  Hue channel of the current color.
EAPI void	imlib_context_get_color_hsva (float *hue, float *saturation, float *value, int *alpha)
	Parameters: hue  Hue channel of the current color.
EAPI void	imlib_context_set_color_hlsa (float hue, float lightness, float saturation, int alpha)
	Parameters: hue  Hue channel of the current color.
EAPI void	imlib_context_get_color_hlsa (float *hue, float *lightness, float *saturation, int *alpha)
	Parameters: hue  Hue channel of the current color.
EAPI void	imlib_context_set_color_cmya (int cyan, int magenta, int yellow, int alpha)
	Parameters: cyan  Cyan channel of the current color.
EAPI void	imlib_context_get_color_cmya (int *cyan, int *magenta, int *yellow, int *alpha)
	Parameters: cyan  Cyan channel of the current color.
EAPI void	imlib_context_set_color_range (Imlib_Color_Range color_range)
	Parameters: color_range  Color range.
EAPI Imlib_Color_Range	imlib_context_get_color_range (void)
	Returns: The current color range.
EAPI void	imlib_context_set_progress_function (Imlib_Progress_Function progress_function)
	Parameters: progress_function  A progress function.
EAPI Imlib_Progress_Function	imlib_context_get_progress_function (void)
	Returns: The current progress function.
EAPI void	imlib_context_set_progress_granularity (char progress_granularity)
	Parameters: progress_granularity  A char.
EAPI char	imlib_context_get_progress_granularity (void)
	Returns: The current progress granularity
EAPI void	imlib_context_set_image (Imlib_Image image)
	Parameters: image  Current image.
EAPI Imlib_Image	imlib_context_get_image (void)
	Returns: The current image.
EAPI int	imlib_get_cache_size (void)
	Returns: The current image size.
EAPI void	imlib_set_cache_size (int bytes)
	Parameters: bytes  Cache size.
EAPI int	imlib_get_color_usage (void)
	Returns: The current number of colors.
EAPI void	imlib_set_color_usage (int max)
	Parameters: max  Maximum number of colors.
EAPI void	imlib_flush_loaders (void)
	If you want Imlib2 to forcibly flush any cached loaders it has and re-load them from disk (this is useful if the program just installed a new loader and does not want to wait till Imlib2 deems it an optimal time to rescan the loaders).
EAPI Imlib_Image	imlib_load_image (const char *file)
	Parameters: file  Image file.
EAPI Imlib_Image	imlib_load_image_immediately (const char *file)
	Parameters: file  Image file.
EAPI Imlib_Image	imlib_load_image_without_cache (const char *file)
	Parameters: file  Image file.
EAPI Imlib_Image	imlib_load_image_immediately_without_cache (const char *file)
	Parameters: file  Image file.
EAPI Imlib_Image	imlib_load_image_with_error_return (const char *file, Imlib_Load_Error *error_return)
	Parameters: file  Image file.
EAPI void	imlib_free_image (void)
	Frees the image that is set as the current image in Imlib2's context.
EAPI void	imlib_free_image_and_decache (void)
	Frees the current image in Imlib2's context AND removes it from the cache.
EAPI int	imlib_image_get_width (void)
	Returns the width in pixels of the current image in Imlib2's context.
EAPI int	imlib_image_get_height (void)
	Returns the height in pixels of the current image in Imlib2's context.
EAPI const char *	imlib_image_get_filename (void)
	Returns: The current filename.
EAPI DATA32 *	imlib_image_get_data (void)
	Returns: A pointer to the image data.
EAPI DATA32 *	imlib_image_get_data_for_reading_only (void)
	Returns: A pointer to the image data.
EAPI void	imlib_image_put_back_data (DATA32 *data)
	Parameters: data  The pointer to the image data.
EAPI char	imlib_image_has_alpha (void)
	Returns: Current alpha channel flag.
EAPI void	imlib_image_set_changes_on_disk (void)
	By default Imlib2 will not check the timestamp of an image on disk and compare it with the image in its cache - this is to minimize disk activity when using the cache.
EAPI void	imlib_image_get_border (Imlib_Border *border)
	Parameters: border  The border of the image.
EAPI void	imlib_image_set_border (Imlib_Border *border)
	Parameters: border  The border of the image.
EAPI void	imlib_image_set_format (const char *format)
	Parameters: format  Format of the image.
EAPI void	imlib_image_set_irrelevant_format (char irrelevant)
	Parameters: irrelevant  Irrelevant format flag.
EAPI void	imlib_image_set_irrelevant_border (char irrelevant)
	Parameters: irrelevant  Irrelevant border flag.
EAPI void	imlib_image_set_irrelevant_alpha (char irrelevant)
	Parameters: irrelevant  Irrelevant alpha flag.
EAPI char *	imlib_image_format (void)
	Returns: Current image format.
EAPI void	imlib_image_set_has_alpha (char has_alpha)
	Parameters: has_alpha  Alpha flag.
EAPI void	imlib_blend_image_onto_image (Imlib_Image source_image, char merge_alpha, int source_x, int source_y, int source_width, int source_height, int destination_x, int destination_y, int destination_width, int destination_height)
	Parameters: source_image  The source image.
EAPI Imlib_Image	imlib_create_image (int width, int height)
	Parameters: width  The width of the image.
EAPI Imlib_Image	imlib_create_image_using_data (int width, int height, DATA32 *data)
	Parameters: width  The width of the image.
EAPI Imlib_Image	imlib_create_image_using_copied_data (int width, int height, DATA32 *data)
	Parameters: width  The width of the image.
EAPI Imlib_Image	imlib_clone_image (void)
	Returns: A valid image, otherwise NULL.
EAPI Imlib_Image	imlib_create_cropped_image (int x, int y, int width, int height)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI Imlib_Image	imlib_create_cropped_scaled_image (int source_x, int source_y, int source_width, int source_height, int destination_width, int destination_height)
	Parameters: source_x  The top left x coordinate of the source rectangle.
EAPI Imlib_Updates	imlib_updates_clone (Imlib_Updates updates)
	Parameters: updates  An updates list.
EAPI Imlib_Updates	imlib_update_append_rect (Imlib_Updates updates, int x, int y, int w, int h)
	Parameters: updates  An updates list.
EAPI Imlib_Updates	imlib_updates_merge (Imlib_Updates updates, int w, int h)
	Parameters: updates  An updates list.
EAPI Imlib_Updates	imlib_updates_merge_for_rendering (Imlib_Updates updates, int w, int h)
	Parameters: updates  An updates list.
EAPI void	imlib_updates_free (Imlib_Updates updates)
	Parameters: updates  An updates list.
EAPI Imlib_Updates	imlib_updates_get_next (Imlib_Updates updates)
	Parameters: updates  An updates list.
EAPI void	imlib_updates_get_coordinates (Imlib_Updates updates, int *x_return, int *y_return, int *width_return, int *height_return)
	Parameters: updates  An updates list.
EAPI void	imlib_updates_set_coordinates (Imlib_Updates updates, int x, int y, int width, int height)
	Parameters: updates  An updates list.
EAPI Imlib_Updates	imlib_updates_init (void)
	Returns: The initialized updates list.
EAPI Imlib_Updates	imlib_updates_append_updates (Imlib_Updates updates, Imlib_Updates appended_updates)
	Parameters: updates  An updates list.
EAPI void	imlib_image_flip_horizontal (void)
	Flips/mirrors the current image horizontally.
EAPI void	imlib_image_flip_vertical (void)
	Flips/mirrors the current image vertically.
EAPI void	imlib_image_flip_diagonal (void)
	Flips/mirrors the current image diagonally (good for quick and dirty 90 degree rotations if used before to after a horizontal or vertical flip).
EAPI void	imlib_image_orientate (int orientation)
	Parameters: orientation  The orientation.
EAPI void	imlib_image_blur (int radius)
	Parameters: radius  The radius.
EAPI void	imlib_image_sharpen (int radius)
	Parameters: radius  The radius.
EAPI void	imlib_image_tile_horizontal (void)
	Modifies an image so it will tile seamlessly horizontally if used as a tile (i.e.
EAPI void	imlib_image_tile_vertical (void)
	Modifies an image so it will tile seamlessly vertically if used as a tile (i.e.
EAPI void	imlib_image_tile (void)
	Modifies an image so it will tile seamlessly horizontally and vertically if used as a tile (i.e.
EAPI Imlib_Font	imlib_load_font (const char *font_name)
	Parameters: font_name  The font name with the size.
EAPI void	imlib_free_font (void)
	Removes the current font from any fallback chain it's in and frees it.
EAPI int	imlib_insert_font_into_fallback_chain (Imlib_Font font, Imlib_Font fallback_font)
	Parameters: font  A previously loaded font.
EAPI void	imlib_remove_font_from_fallback_chain (Imlib_Font fallback_font)
	Parameters: fallback_font  A font previously added to a fallback chain.
EAPI Imlib_Font	imlib_get_prev_font_in_fallback_chain (Imlib_Font fn)
EAPI Imlib_Font	imlib_get_next_font_in_fallback_chain (Imlib_Font fn)
EAPI void	imlib_text_draw (int x, int y, const char *text)
	Parameters: x  The x coordinate of the top left corner.
EAPI void	imlib_text_draw_with_return_metrics (int x, int y, const char *text, int *width_return, int *height_return, int *horizontal_advance_return, int *vertical_advance_return)
	Parameters: x  The x coordinate of the top left corner.
EAPI void	imlib_get_text_size (const char *text, int *width_return, int *height_return)
	Parameters: text  A string.
EAPI void	imlib_get_text_advance (const char *text, int *horizontal_advance_return, int *vertical_advance_return)
	Parameters: text  A string.
EAPI int	imlib_get_text_inset (const char *text)
	Parameters: text  A string.
EAPI void	imlib_add_path_to_font_path (const char *path)
	Parameters: path  A directory path.
EAPI void	imlib_remove_path_from_font_path (const char *path)
	Parameters: path  A directory path.
EAPI char **	imlib_list_font_path (int *number_return)
	Parameters: number_return  Number of paths in the list.
EAPI int	imlib_text_get_index_and_location (const char *text, int x, int y, int *char_x_return, int *char_y_return, int *char_width_return, int *char_height_return)
	Parameters: text  A string.
EAPI void	imlib_text_get_location_at_index (const char *text, int index, int *char_x_return, int *char_y_return, int *char_width_return, int *char_height_return)
	Parameters: text  A string.
EAPI char **	imlib_list_fonts (int *number_return)
	Parameters: number_return  Number of fonts in the list.
EAPI void	imlib_free_font_list (char **font_list, int number)
	Parameters: font_list  The font list.
EAPI int	imlib_get_font_cache_size (void)
	Returns: The font cache size.
EAPI void	imlib_set_font_cache_size (int bytes)
	Parameters: bytes  The font cache size.
EAPI void	imlib_flush_font_cache (void)
	Causes a flush of all speculatively cached fonts from the font cache.
EAPI int	imlib_get_font_ascent (void)
	Returns: The font's ascent.
EAPI int	imlib_get_font_descent (void)
	Returns: The font's descent.
EAPI int	imlib_get_maximum_font_ascent (void)
	Returns: The font's maximum ascent.
EAPI int	imlib_get_maximum_font_descent (void)
	Returns: The font's maximum descent.
EAPI Imlib_Color_Modifier	imlib_create_color_modifier (void)
	Returns: Valid handle.
EAPI void	imlib_free_color_modifier (void)
	Frees the current color modifier.
EAPI void	imlib_modify_color_modifier_gamma (double gamma_value)
	Parameters: gamma_value  Value of gamma.
EAPI void	imlib_modify_color_modifier_brightness (double brightness_value)
	Parameters: brightness_value  Value of brightness.
EAPI void	imlib_modify_color_modifier_contrast (double contrast_value)
	Parameters: contrast_value  Value of contrast.
EAPI void	imlib_set_color_modifier_tables (DATA8 *red_table, DATA8 *green_table, DATA8 *blue_table, DATA8 *alpha_table)
	Parameters: red_table  An array of DATA8.
EAPI void	imlib_get_color_modifier_tables (DATA8 *red_table, DATA8 *green_table, DATA8 *blue_table, DATA8 *alpha_table)
	Parameters: red_table,:  an array of DATA8.
EAPI void	imlib_reset_color_modifier (void)
	Resets the current color modifier to have linear mapping tables.
EAPI void	imlib_apply_color_modifier (void)
	Uses the current color modifier and modifies the current image using the mapping tables in the current color modifier.
EAPI void	imlib_apply_color_modifier_to_rectangle (int x, int y, int width, int height)
	Parameters: x  The x coordinate of the left edge of the rectangle.
EAPI Imlib_Updates	imlib_image_draw_line (int x1, int y1, int x2, int y2, char make_updates)
	Parameters: x1  The x coordinate of the first point.
EAPI void	imlib_image_draw_rectangle (int x, int y, int width, int height)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI void	imlib_image_fill_rectangle (int x, int y, int width, int height)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI void	imlib_image_copy_alpha_to_image (Imlib_Image image_source, int x, int y)
	Parameters: image_source  An image.
EAPI void	imlib_image_copy_alpha_rectangle_to_image (Imlib_Image image_source, int x, int y, int width, int height, int destination_x, int destination_y)
	Parameters: image_source  An image.
EAPI void	imlib_image_scroll_rect (int x, int y, int width, int height, int delta_x, int delta_y)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI void	imlib_image_copy_rect (int x, int y, int width, int height, int new_x, int new_y)
	Parameters: x  The top left x coordinate of the rectangle.
EAPI Imlib_Color_Range	imlib_create_color_range (void)
	Returns: valid handle.
EAPI void	imlib_free_color_range (void)
	Frees the current color range.
EAPI void	imlib_add_color_to_color_range (int distance_away)
	Parameters: distance_away  Distance from the previous color.
EAPI void	imlib_image_fill_color_range_rectangle (int x, int y, int width, int height, double angle)
	Parameters: x  The x coordinate of the left edge of the rectangle.
EAPI void	imlib_image_fill_hsva_color_range_rectangle (int x, int y, int width, int height, double angle)
	Parameters: x  The x coordinate of the left edge of the rectangle.
EAPI void	imlib_image_query_pixel (int x, int y, Imlib_Color *color_return)
	Parameters: x  The x coordinate of the pixel.
EAPI void	imlib_image_query_pixel_hsva (int x, int y, float *hue, float *saturation, float *value, int *alpha)
	Parameters: x  The x coordinate of the pixel.
EAPI void	imlib_image_query_pixel_hlsa (int x, int y, float *hue, float *lightness, float *saturation, int *alpha)
	Parameters: x  The x coordinate of the pixel.
EAPI void	imlib_image_query_pixel_cmya (int x, int y, int *cyan, int *magenta, int *yellow, int *alpha)
	Parameters: x  Tthe x coordinate of the pixel.
EAPI void	imlib_image_attach_data_value (const char *key, void *data, int value, Imlib_Internal_Data_Destructor_Function destructor_function)
	Parameters: key  A string.
EAPI void *	imlib_image_get_attached_data (const char *key)
	Parameters: key  A string.
EAPI int	imlib_image_get_attached_value (const char *key)
	Parameters: key  A string.
EAPI void	imlib_image_remove_attached_data_value (const char *key)
	Parameters: key  A string.
EAPI void	imlib_image_remove_and_free_attached_data_value (const char *key)
	Parameters: key  A string.
EAPI void	imlib_save_image (const char *filename)
	Parameters: filename  The file name.
EAPI void	imlib_save_image_with_error_return (const char *filename, Imlib_Load_Error *error_return)
	Parameters: filename  The file name.
EAPI Imlib_Image	imlib_create_rotated_image (double angle)
	Parameters: angle  An angle in radians.
EAPI void	imlib_blend_image_onto_image_at_angle (Imlib_Image source_image, char merge_alpha, int source_x, int source_y, int source_width, int source_height, int destination_x, int destination_y, int angle_x, int angle_y)
	Parameters: source_image  The image source.
EAPI void	imlib_blend_image_onto_image_skewed (Imlib_Image source_image, char merge_alpha, int source_x, int source_y, int source_width, int source_height, int destination_x, int destination_y, int h_angle_x, int h_angle_y, int v_angle_x, int v_angle_y)
	Parameters: source_image  The source image.
EAPI void	imlib_context_set_filter (Imlib_Filter filter)
	Parameters: filter  Current filter.
EAPI Imlib_Filter	imlib_context_get_filter (void)
	Returns:
EAPI ImlibPolygon	imlib_polygon_new (void)
	Returns a new polygon object with no points set.
EAPI void	imlib_polygon_add_point (ImlibPolygon poly, int x, int y)
	Parameters: poly  A polygon
EAPI void	imlib_polygon_free (ImlibPolygon poly)
	Parameters: poly  A polygon.
EAPI void	imlib_image_draw_polygon (ImlibPolygon poly, unsigned char closed)
	Parameters: poly  A polygon.
EAPI void	imlib_image_fill_polygon (ImlibPolygon poly)
	Parameters: poly  A polygon.
EAPI void	imlib_polygon_get_bounds (ImlibPolygon poly, int *px1, int *py1, int *px2, int *py2)
	Parameters: poly  A polygon.
EAPI void	imlib_image_draw_ellipse (int xc, int yc, int a, int b)
	Parameters: xc  X coordinate of the center of the ellipse.
EAPI void	imlib_image_fill_ellipse (int xc, int yc, int a, int b)
	Parameters: xc  X coordinate of the center of the ellipse.
EAPI unsigned char	imlib_polygon_contains_point (ImlibPolygon poly, int x, int y)
	Parameters: poly  A polygon

---

Detailed Description

Imlib2 library.

Brief of imlib2 library

---

Function Documentation

EAPI void imlib_add_color_to_color_range

(

int

distance_away

)

Parameters:

distance_away

Distance from the previous color.

Adds the current color to the current color range at a distance_away distance from the previous color in the range (if it's the first color in the range this is irrelevant).

EAPI void imlib_add_path_to_font_path

(

const char *

path

)

Parameters:

path

A directory path.

Adds the directory path to the end of the current list of directories to scan for fonts.

EAPI void imlib_apply_color_modifier_to_rectangle	(	int	x,
		int	y,
		int	width,
		int	height
	)

Parameters:

x

The x coordinate of the left edge of the rectangle.

Parameters:

	y	The y coordinate of the top edge of the rectangle.
	width	The width of the rectangle.
	height	The height of the rectangle.

Works the same way as imlib_apply_color_modifier() but only modifies a selected rectangle in the current image.

EAPI void imlib_blend_image_onto_image	(	Imlib_Image	source_image,
		char	merge_alpha,
		int	source_x,
		int	source_y,
		int	source_width,
		int	source_height,
		int	destination_x,
		int	destination_y,
		int	destination_width,
		int	destination_height
	)

Parameters:

source_image

The source image.

Parameters:

	merge_alpha	Alpha flag.
	source_x	X coordinate of the source image.
	source_y	Y coordinate of the source image.
	source_width	Width of the source image.
	source_height	Height of the source image.
	destination_x	X coordinate of the destination image.
	destination_y	Y coordinate of the destination image.
	destination_width	Width of the destination image.
	destination_height	Height of the destination image.

Blends the source rectangle (source_x, source_y, source_width, source_height) from source_image onto the current image at the destination (destination_x, destination_y) location scaled to the width destination_width and height destination_height. If merge_alpha is set to 1 it will also modify the destination image alpha channel, otherwise the destination alpha channel is left untouched.

EAPI void imlib_blend_image_onto_image_at_angle	(	Imlib_Image	source_image,
		char	merge_alpha,
		int	source_x,
		int	source_y,
		int	source_width,
		int	source_height,
		int	destination_x,
		int	destination_y,
		int	angle_x,
		int	angle_y
	)

Parameters:

source_image

The image source.

Parameters:

	merge_alpha	A char.
	source_x	The source x coordinate.
	source_y	The source y coordinate.
	source_width	The source width.
	source_height	The source height.
	destination_x	The destination x coordinate.
	destination_y	The destination y coordinate.
	angle_x	An angle.
	angle_y	An angle.

Works just like imlib_blend_image_onto_image_skewed() except you cannot skew an image (v_angle_x and v_angle_y are 0).

EAPI void imlib_blend_image_onto_image_skewed	(	Imlib_Image	source_image,
		char	merge_alpha,
		int	source_x,
		int	source_y,
		int	source_width,
		int	source_height,
		int	destination_x,
		int	destination_y,
		int	h_angle_x,
		int	h_angle_y,
		int	v_angle_x,
		int	v_angle_y
	)

Parameters:

source_image

The source image.

Parameters:

	merge_alpha	A char
	source_x	The source x coordinate.
	source_y	The source y coordinate.
	source_width	The source width.
	source_height	The source height.
	destination_x	The destination x coordinate.
	destination_y	The destination y coordinate.
	h_angle_x	An angle.
	h_angle_y	An angle.
	v_angle_x	An angle.
	v_angle_y	An angle.

Blends the source rectangle (source_x, source_y, source_width, source_height) from the source_image onto the current image at the destination (destination_x, destination_y) location. It will be rotated and scaled so that the upper right corner will be positioned h_angle_x pixels to the right (or left, if negative) and h_angle_y pixels down (from (destination_x, destination_y). If v_angle_x and v_angle_y are not 0, the image will also be skewed so that the lower left corner will be positioned v_angle_x pixels to the right and v_angle_y pixels down. The at_angle versions simply have the v_angle_x and v_angle_y set to 0 so the rotation doesn't get skewed, and the render_..._on_drawable ones seem obvious enough; they do the same on a drawable.

Example:

 imlib_blend_image_onto_image_skewed(..., 0, 0, 100, 0, 0, 100);

will simply scale the image to be 100x100.

 imlib_blend_image_onto_image_skewed(..., 0, 0, 0, 100, 100, 0);

will scale the image to be 100x100, and flip it diagonally.

 imlib_blend_image_onto_image_skewed(..., 100, 0, 0, 100, -100, 0);

will scale the image and rotate it 90 degrees clockwise.

 imlib_blend_image_onto_image_skewed(..., 50, 0, 50, 50, -50, 50);

will rotate the image 45 degrees clockwise, and will scale it so its corners are at (50,0)-(100,50)-(50,100)-(0,50) i.e. it fits into the 100x100 square, so it's scaled down to 70.7% (sqrt(2)/2).

 imlib_blend_image_onto_image_skewed(..., 50, 50, 100 * cos(a), 100 * sin(a), 0);

will rotate the image `a' degrees, with its upper left corner at (50,50).

EAPI Imlib_Image imlib_clone_image

(

void

)

Returns:

A valid image, otherwise NULL.

Creates an exact duplicate of the current image and returns a valid image handle on success, or NULL on failure.

EAPI double imlib_context_get_angle

(

void

)

Returns:

The current angle of the text strings.

Returns the current angle used to render text at if the direction is IMLIB_TEXT_TO_ANGLE.

EAPI char imlib_context_get_anti_alias

(

void

)

Returns:

The current anti alias flag.

Returns if Imlib2 currently will smoothly scale images. 1 means it will and 0 means it will not.

EAPI char imlib_context_get_blend

(

void

)

Returns:

The current blending flag.

Returns if Imlib2 will blend images onto a drawable whilst rendering to that drawable. 1 means yes and 0 means no.

EAPI void imlib_context_get_color	(	int *	red,
		int *	green,
		int *	blue,
		int *	alpha
	)

Parameters:

red

Red channel of the current color.

Parameters:

	green	Green channel of the current color.
	blue	Blue channel of the current color.
	alpha	Alpha channel of the current color.

Returns the current color for rendering text, rectangles and lines.

EAPI void imlib_context_get_color_cmya	(	int *	cyan,
		int *	magenta,
		int *	yellow,
		int *	alpha
	)

Parameters:

cyan

Cyan channel of the current color.

Parameters:

	magenta	Magenta channel of the current color.
	yellow	Yellow channel of the current color.
	alpha	Alpha channel of the current color.

Returns the current color for rendering text, rectangles and lines in CMYA space.

EAPI void imlib_context_get_color_hlsa	(	float *	hue,
		float *	lightness,
		float *	saturation,
		int *	alpha
	)

Parameters:

hue

Hue channel of the current color.

Parameters:

	lightness	Lightness channel of the current color.
	saturation	Saturation channel of the current color.
	alpha	Alpha channel of the current color.

Returns the current color for rendering text, rectangles and lines in HLSA space.

EAPI void imlib_context_get_color_hsva	(	float *	hue,
		float *	saturation,
		float *	value,
		int *	alpha
	)

Parameters:

hue

Hue channel of the current color.

Parameters:

	saturation	Saturation channel of the current color.
	value	Value channel of the current color.
	alpha	Alpha channel of the current color.

Returns the current color for rendering text, rectangles and lines in HSVA space.

EAPI Imlib_Color_Modifier imlib_context_get_color_modifier

(

void

)

Returns:

The current color modifier.

Returns the current color modifier being used.