root/src/lib/Imlib2.h

/* [<][>][^][v][top][bottom][index][help] */

INCLUDED FROM


#ifndef __IMLIB_API_H
# define __IMLIB_API_H 1

# ifdef EAPI
# undef EAPI
# endif
# ifdef WIN32
#  ifdef BUILDING_DLL
#   define EAPI __declspec(dllexport)
#  else
#   define EAPI __declspec(dllimport)
#  endif
# else
#  ifdef __GNUC__
#   if __GNUC__ >= 4
#    define EAPI __attribute__ ((visibility("default")))
#   else
#    define EAPI
#   endif
#  else
#   define EAPI
#  endif
# endif

# ifndef X_DISPLAY_MISSING
#  include <X11/Xlib.h>
# endif

/* Data types to use */
# ifndef DATA64
#  define DATA64 unsigned long long
#  define DATA32 unsigned int
#  define DATA16 unsigned short
#  define DATA8  unsigned char
# endif

/* opaque data types */
typedef void *Imlib_Context;
typedef void *Imlib_Image;
typedef void *Imlib_Color_Modifier;
typedef void *Imlib_Updates;
typedef void *Imlib_Font;
typedef void *Imlib_Color_Range;
typedef void *Imlib_Filter;
typedef struct _imlib_border Imlib_Border;
typedef struct _imlib_color Imlib_Color;
typedef void *ImlibPolygon;

/* blending operations */
enum _imlib_operation
{
   IMLIB_OP_COPY,
   IMLIB_OP_ADD,
   IMLIB_OP_SUBTRACT,
   IMLIB_OP_RESHADE
};

enum _imlib_text_direction
{
   IMLIB_TEXT_TO_RIGHT = 0,
   IMLIB_TEXT_TO_LEFT = 1,
   IMLIB_TEXT_TO_DOWN = 2,
   IMLIB_TEXT_TO_UP = 3,
   IMLIB_TEXT_TO_ANGLE = 4
};

enum _imlib_load_error
{
   IMLIB_LOAD_ERROR_NONE,
   IMLIB_LOAD_ERROR_FILE_DOES_NOT_EXIST,
   IMLIB_LOAD_ERROR_FILE_IS_DIRECTORY,
   IMLIB_LOAD_ERROR_PERMISSION_DENIED_TO_READ,
   IMLIB_LOAD_ERROR_NO_LOADER_FOR_FILE_FORMAT,
   IMLIB_LOAD_ERROR_PATH_TOO_LONG,
   IMLIB_LOAD_ERROR_PATH_COMPONENT_NON_EXISTANT,
   IMLIB_LOAD_ERROR_PATH_COMPONENT_NOT_DIRECTORY,
   IMLIB_LOAD_ERROR_PATH_POINTS_OUTSIDE_ADDRESS_SPACE,
   IMLIB_LOAD_ERROR_TOO_MANY_SYMBOLIC_LINKS,
   IMLIB_LOAD_ERROR_OUT_OF_MEMORY,
   IMLIB_LOAD_ERROR_OUT_OF_FILE_DESCRIPTORS,
   IMLIB_LOAD_ERROR_PERMISSION_DENIED_TO_WRITE,
   IMLIB_LOAD_ERROR_OUT_OF_DISK_SPACE,
   IMLIB_LOAD_ERROR_UNKNOWN
};

/* Encodings known to Imlib2 (so far) */
enum _imlib_TTF_encoding
{
   IMLIB_TTF_ENCODING_ISO_8859_1,
   IMLIB_TTF_ENCODING_ISO_8859_2,
   IMLIB_TTF_ENCODING_ISO_8859_3,
   IMLIB_TTF_ENCODING_ISO_8859_4,
   IMLIB_TTF_ENCODING_ISO_8859_5
};

typedef enum _imlib_operation Imlib_Operation;
typedef enum _imlib_load_error Imlib_Load_Error;
typedef enum _imlib_load_error ImlibLoadError;
typedef enum _imlib_text_direction Imlib_Text_Direction;
typedef enum _imlib_TTF_encoding Imlib_TTF_Encoding;

struct _imlib_border
{
   int left, right, top, bottom;
};

struct _imlib_color
{
   int alpha, red, green, blue;
};

/* Progressive loading callbacks */
typedef int (*Imlib_Progress_Function) (Imlib_Image im, char percent,
                                        int update_x, int update_y,
                                        int update_w, int update_h);
typedef void (*Imlib_Data_Destructor_Function) (Imlib_Image im, void *data);

# ifdef __cplusplus
extern "C"
{
# endif

/* context handling */
   EAPI Imlib_Context imlib_context_new(void);
   EAPI void imlib_context_free(Imlib_Context context);

   EAPI void imlib_context_push(Imlib_Context context);
   EAPI void imlib_context_pop(void);
   EAPI Imlib_Context imlib_context_get(void);

/* context setting */
# ifndef X_DISPLAY_MISSING
   EAPI void imlib_context_set_display(Display * display);
   EAPI void imlib_context_disconnect_display(void);
   EAPI void imlib_context_set_visual(Visual * visual);
   EAPI void imlib_context_set_colormap(Colormap colormap);
   EAPI void imlib_context_set_drawable(Drawable drawable);
   EAPI void imlib_context_set_mask(Pixmap mask);
# endif
   EAPI void imlib_context_set_dither_mask(char dither_mask);
   EAPI void imlib_context_set_mask_alpha_threshold(int mask_alpha_threshold);
   EAPI void imlib_context_set_anti_alias(char anti_alias);
   EAPI void imlib_context_set_dither(char dither);
   EAPI void imlib_context_set_blend(char blend);
   EAPI void imlib_context_set_color_modifier(Imlib_Color_Modifier color_modifier);
   EAPI void imlib_context_set_operation(Imlib_Operation operation);
   EAPI void imlib_context_set_font(Imlib_Font font);
   EAPI void imlib_context_set_direction(Imlib_Text_Direction direction);
   EAPI void imlib_context_set_angle(double angle);
   EAPI void imlib_context_set_color(int red, int green, int blue, int alpha);
   EAPI void imlib_context_set_color_hsva(float hue, float saturation, float value, int alpha);
   EAPI void imlib_context_set_color_hlsa(float hue, float lightness, float saturation, int alpha);
   EAPI void imlib_context_set_color_cmya(int cyan, int magenta, int yellow, int alpha);
   EAPI void imlib_context_set_color_range(Imlib_Color_Range color_range);
   EAPI void imlib_context_set_progress_function(Imlib_Progress_Function
                                                 progress_function);
   EAPI void imlib_context_set_progress_granularity(char progress_granularity);
   EAPI void imlib_context_set_image(Imlib_Image image);
   EAPI void imlib_context_set_cliprect(int x, int y, int w, int h);
   EAPI void imlib_context_set_TTF_encoding(Imlib_TTF_Encoding encoding);

/* context getting */
# ifndef X_DISPLAY_MISSING
   EAPI Display *imlib_context_get_display(void);
   EAPI Visual *imlib_context_get_visual(void);
   EAPI Colormap imlib_context_get_colormap(void);
   EAPI Drawable imlib_context_get_drawable(void);
   EAPI Pixmap imlib_context_get_mask(void);
# endif
   EAPI char imlib_context_get_dither_mask(void);
   EAPI char imlib_context_get_anti_alias(void);
   EAPI int imlib_context_get_mask_alpha_threshold(void);
   EAPI char imlib_context_get_dither(void);
   EAPI char imlib_context_get_blend(void);
   EAPI Imlib_Color_Modifier imlib_context_get_color_modifier(void);
   EAPI Imlib_Operation imlib_context_get_operation(void);
   EAPI Imlib_Font imlib_context_get_font(void);
   EAPI double imlib_context_get_angle(void);
   EAPI Imlib_Text_Direction imlib_context_get_direction(void);
   EAPI void imlib_context_get_color(int *red, int *green, int *blue, int *alpha);
   EAPI void imlib_context_get_color_hsva(float *hue, float *saturation, float *value, int *alpha);
   EAPI void imlib_context_get_color_hlsa(float *hue, float *lightness, float *saturation, int *alpha);
   EAPI void imlib_context_get_color_cmya(int *cyan, int *magenta, int *yellow, int *alpha);
   EAPI Imlib_Color *imlib_context_get_imlib_color(void);
   EAPI Imlib_Color_Range imlib_context_get_color_range(void);
   EAPI Imlib_Progress_Function imlib_context_get_progress_function(void);
   EAPI char imlib_context_get_progress_granularity(void);
   EAPI Imlib_Image imlib_context_get_image(void);
   EAPI void imlib_context_get_cliprect(int *x, int *y, int *w, int *h);
   EAPI Imlib_TTF_Encoding imlib_context_get_TTF_encoding(void);

   EAPI int imlib_get_cache_size(void);
   EAPI void imlib_set_cache_size(int bytes);
   EAPI int imlib_get_color_usage(void);
   EAPI void imlib_set_color_usage(int max);
   EAPI void imlib_flush_loaders(void);
# ifndef X_DISPLAY_MISSING
   EAPI int imlib_get_visual_depth(Display * display, Visual * visual);
   EAPI Visual *imlib_get_best_visual(Display * display, int screen,
                                      int *depth_return);
# endif

   EAPI Imlib_Image imlib_load_image(const char *file);
   EAPI Imlib_Image imlib_load_image_immediately(const char *file);
   EAPI Imlib_Image imlib_load_image_without_cache(const char *file);
   EAPI Imlib_Image imlib_load_image_immediately_without_cache(const char *file);
   EAPI Imlib_Image imlib_load_image_with_error_return(const char *file,
                                                       Imlib_Load_Error *
                                                       error_return);
   EAPI void imlib_free_image(void);
   EAPI void imlib_free_image_and_decache(void);

/* query/modify image parameters */
   EAPI int imlib_image_get_width(void);
   EAPI int imlib_image_get_height(void);
   EAPI const char *imlib_image_get_filename(void);
   EAPI DATA32 *imlib_image_get_data(void);
   EAPI DATA32 *imlib_image_get_data_for_reading_only(void);
   EAPI void imlib_image_put_back_data(DATA32 * data);
   EAPI char imlib_image_has_alpha(void);
   EAPI void imlib_image_set_changes_on_disk(void);
   EAPI void imlib_image_get_border(Imlib_Border * border);
   EAPI void imlib_image_set_border(Imlib_Border * border);
   EAPI void imlib_image_set_format(const char *format);
   EAPI void imlib_image_set_irrelevant_format(char irrelevant);
   EAPI void imlib_image_set_irrelevant_border(char irrelevant);
   EAPI void imlib_image_set_irrelevant_alpha(char irrelevant);
   EAPI char *imlib_image_format(void);
   EAPI void imlib_image_set_has_alpha(char has_alpha);
   EAPI void imlib_image_query_pixel(int x, int y, Imlib_Color * color_return);
   EAPI void imlib_image_query_pixel_hsva(int x, int y, float *hue, float *saturation, float *value, int *alpha);
   EAPI void imlib_image_query_pixel_hlsa(int x, int y, float *hue, float *lightness, float *saturation, int *alpha);
   EAPI void imlib_image_query_pixel_cmya(int x, int y, int *cyan, int *magenta, int *yellow, int *alpha);

/* rendering functions */
# ifndef X_DISPLAY_MISSING
   EAPI void imlib_render_pixmaps_for_whole_image(Pixmap * pixmap_return,
                                                  Pixmap * mask_return);
   EAPI void imlib_render_pixmaps_for_whole_image_at_size(Pixmap * pixmap_return,
                                                          Pixmap * mask_return,
                                                          int width, int height);
   EAPI void imlib_free_pixmap_and_mask(Pixmap pixmap);
   EAPI void imlib_render_image_on_drawable(int x, int y);
   EAPI void imlib_render_image_on_drawable_at_size(int x, int y, int width,
                                                    int height);
   EAPI void imlib_render_image_part_on_drawable_at_size(int source_x,
                                                         int source_y,
                                                         int source_width,
                                                         int source_height, int x,
                                                         int y, int width,
                                                         int height);
   EAPI DATA32 imlib_render_get_pixel_color(void);
# endif
   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);

/* creation functions */
   EAPI Imlib_Image imlib_create_image(int width, int height);
   EAPI Imlib_Image imlib_create_image_using_data(int width, int height,
                                                  DATA32 * data);
   EAPI Imlib_Image imlib_create_image_using_copied_data(int width, int height,
                                                         DATA32 * data);
# ifndef X_DISPLAY_MISSING
   EAPI Imlib_Image imlib_create_image_from_drawable(Pixmap mask, int x, int y,
                                                     int width, int height,
                                                     char need_to_grab_x);
   EAPI Imlib_Image imlib_create_image_from_ximage(XImage *image, XImage *mask, int x, int y,
                                                     int width, int height,
                                                     char need_to_grab_x);
   EAPI Imlib_Image imlib_create_scaled_image_from_drawable(Pixmap mask,
                                                            int source_x,
                                                            int source_y,
                                                            int source_width,
                                                            int source_height,
                                                            int destination_width,
                                                            int destination_height,
                                                            char need_to_grab_x,
                                                            char
                                                            get_mask_from_shape);
   EAPI char imlib_copy_drawable_to_image(Pixmap mask, int x, int y, int width,
                                          int height, int destination_x,
                                          int destination_y, char need_to_grab_x);
# endif
   EAPI Imlib_Image imlib_clone_image(void);
   EAPI Imlib_Image imlib_create_cropped_image(int x, int y, int width,
                                               int height);
   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);

/* imlib updates. lists of rectangles for storing required update draws */
   EAPI Imlib_Updates imlib_updates_clone(Imlib_Updates updates);
   EAPI Imlib_Updates imlib_update_append_rect(Imlib_Updates updates, int x, int y,
                                               int w, int h);
   EAPI Imlib_Updates imlib_updates_merge(Imlib_Updates updates, int w, int h);
   EAPI Imlib_Updates imlib_updates_merge_for_rendering(Imlib_Updates updates,
                                                        int w, int h);
   EAPI void imlib_updates_free(Imlib_Updates updates);
   EAPI Imlib_Updates imlib_updates_get_next(Imlib_Updates updates);
   EAPI void imlib_updates_get_coordinates(Imlib_Updates updates, int *x_return,
                                           int *y_return, int *width_return,
                                           int *height_return);
   EAPI void imlib_updates_set_coordinates(Imlib_Updates updates, int x, int y,
                                           int width, int height);
   EAPI void imlib_render_image_updates_on_drawable(Imlib_Updates updates, int x,
                                                    int y);
   EAPI Imlib_Updates imlib_updates_init(void);
   EAPI Imlib_Updates imlib_updates_append_updates(Imlib_Updates updates,
                                                   Imlib_Updates appended_updates);

/* image modification */
   EAPI void imlib_image_flip_horizontal(void);
   EAPI void imlib_image_flip_vertical(void);
   EAPI void imlib_image_flip_diagonal(void);
   EAPI void imlib_image_orientate(int orientation);
   EAPI void imlib_image_blur(int radius);
   EAPI void imlib_image_sharpen(int radius);
   EAPI void imlib_image_tile_horizontal(void);
   EAPI void imlib_image_tile_vertical(void);
   EAPI void imlib_image_tile(void);

/* fonts and text */
   EAPI Imlib_Font imlib_load_font(const char *font_name);
   EAPI void imlib_free_font(void);
   /* NB! The four functions below are deprecated. */
   EAPI int imlib_insert_font_into_fallback_chain(Imlib_Font font, Imlib_Font fallback_font);
   EAPI void imlib_remove_font_from_fallback_chain(Imlib_Font fallback_font);
   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);
   /* NB! The four functions above are deprecated. */
   EAPI void imlib_text_draw(int x, int y, const char *text);
   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);
   EAPI void imlib_get_text_size(const char *text, int *width_return,
                                 int *height_return);
   EAPI void imlib_get_text_advance(const char *text, 
                               int *horizontal_advance_return,
                               int *vertical_advance_return);
   EAPI int imlib_get_text_inset(const char *text);
   EAPI void imlib_add_path_to_font_path(const char *path);
   EAPI void imlib_remove_path_from_font_path(const char *path);
   EAPI char **imlib_list_font_path(int *number_return);
   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);
   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);
   EAPI char **imlib_list_fonts(int *number_return);
   EAPI void imlib_free_font_list(char **font_list, int number);
   EAPI int imlib_get_font_cache_size(void);
   EAPI void imlib_set_font_cache_size(int bytes);
   EAPI void imlib_flush_font_cache(void);
   EAPI int imlib_get_font_ascent(void);
   EAPI int imlib_get_font_descent(void);
   EAPI int imlib_get_maximum_font_ascent(void);
   EAPI int imlib_get_maximum_font_descent(void);

/* color modifiers */
   EAPI Imlib_Color_Modifier imlib_create_color_modifier(void);
   EAPI void imlib_free_color_modifier(void);
   EAPI void imlib_modify_color_modifier_gamma(double gamma_value);
   EAPI void imlib_modify_color_modifier_brightness(double brightness_value);
   EAPI void imlib_modify_color_modifier_contrast(double contrast_value);
   EAPI void imlib_set_color_modifier_tables(DATA8 * red_table,
                                             DATA8 * green_table,
                                             DATA8 * blue_table,
                                             DATA8 * alpha_table);
   EAPI void imlib_get_color_modifier_tables(DATA8 * red_table,
                                             DATA8 * green_table,
                                             DATA8 * blue_table,
                                             DATA8 * alpha_table);
   EAPI void imlib_reset_color_modifier(void);
   EAPI void imlib_apply_color_modifier(void);
   EAPI void imlib_apply_color_modifier_to_rectangle(int x, int y, int width,
                                                     int height);

/* drawing on images */
   EAPI Imlib_Updates imlib_image_draw_pixel(int x, int y, char make_updates);
   EAPI Imlib_Updates imlib_image_draw_line(int x1, int y1, int x2, int y2,
                                            char make_updates);
   EAPI void imlib_image_draw_rectangle(int x, int y, int width, int height);
   EAPI void imlib_image_fill_rectangle(int x, int y, int width, int height);
   EAPI void imlib_image_copy_alpha_to_image(Imlib_Image image_source, int x,
                                             int y);
   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);
   EAPI void imlib_image_scroll_rect(int x, int y, int width, int height,
                                     int delta_x, int delta_y);
   EAPI void imlib_image_copy_rect(int x, int y, int width, int height, int new_x,
                                   int new_y);

/* polygons */
   EAPI ImlibPolygon imlib_polygon_new(void);
   EAPI void imlib_polygon_free(ImlibPolygon poly);
   EAPI void imlib_polygon_add_point(ImlibPolygon poly, int x, int y);
   EAPI void imlib_image_draw_polygon(ImlibPolygon poly, unsigned char closed);
   EAPI void imlib_image_fill_polygon(ImlibPolygon poly);
   EAPI void imlib_polygon_get_bounds(ImlibPolygon poly, int *px1, int *py1,
                                      int *px2, int *py2);
   EAPI unsigned char imlib_polygon_contains_point(ImlibPolygon poly, int x,
                                                   int y);

/* ellipses */
   EAPI void imlib_image_draw_ellipse(int xc, int yc, int a, int b);
   EAPI void imlib_image_fill_ellipse(int xc, int yc, int a, int b);

/* color ranges */
   EAPI Imlib_Color_Range imlib_create_color_range(void);
   EAPI void imlib_free_color_range(void);
   EAPI void imlib_add_color_to_color_range(int distance_away);
   EAPI void imlib_image_fill_color_range_rectangle(int x, int y, int width,
                                                    int height, double angle);
   EAPI void imlib_image_fill_hsva_color_range_rectangle(int x, int y, int width,
                                                         int height, double angle);

/* image data */
   EAPI void imlib_image_attach_data_value(const char *key, void *data, int value,
                                           Imlib_Data_Destructor_Function
                                           destructor_function);
   EAPI void *imlib_image_get_attached_data(const char *key);
   EAPI int imlib_image_get_attached_value(const char *key);
   EAPI void imlib_image_remove_attached_data_value(const char *key);
   EAPI void imlib_image_remove_and_free_attached_data_value(const char *key);

/* saving */
   EAPI void imlib_save_image(const char *filename);
   EAPI void imlib_save_image_with_error_return(const char *filename,
                                                Imlib_Load_Error * error_return);

/* FIXME: */
/* need to add arbitrary rotation routines */

/* rotation/skewing */
   EAPI Imlib_Image imlib_create_rotated_image(double angle);

/* rotation from buffer to context (without copying)*/
   EAPI void imlib_rotate_image_from_buffer(double angle, 
                                       Imlib_Image source_image);

   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);
   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);
# ifndef X_DISPLAY_MISSING
   EAPI void imlib_render_image_on_drawable_skewed(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);
   EAPI void imlib_render_image_on_drawable_at_angle(int source_x, int source_y,
                                                     int source_width,
                                                     int source_height,
                                                     int destination_x,
                                                     int destination_y,
                                                     int angle_x, int angle_y);
# endif

/* image filters */
   EAPI void imlib_image_filter(void);
   EAPI Imlib_Filter imlib_create_filter(int initsize);
   EAPI void imlib_context_set_filter(Imlib_Filter filter);
   EAPI Imlib_Filter imlib_context_get_filter(void);
   EAPI void imlib_free_filter(void);
   EAPI void imlib_filter_set(int xoff, int yoff, int a, int r, int g, int b);
   EAPI void imlib_filter_set_alpha(int xoff, int yoff, int a, int r, int g,
                                    int b);
   EAPI void imlib_filter_set_red(int xoff, int yoff, int a, int r, int g, int b);
   EAPI void imlib_filter_set_green(int xoff, int yoff, int a, int r, int g,
                                    int b);
   EAPI void imlib_filter_set_blue(int xoff, int yoff, int a, int r, int g, int b);
   EAPI void imlib_filter_constants(int a, int r, int g, int b);
   EAPI void imlib_filter_divisors(int a, int r, int g, int b);

   EAPI void imlib_apply_filter(char *script, ...);

   EAPI void imlib_image_clear(void);
   EAPI void imlib_image_clear_color(int r, int g, int b, int a);

# ifdef __cplusplus
}
# endif

#endif

/* [<][>][^][v][top][bottom][index][help] */