Imlib2 1.10.0
Imlib2.h
Go to the documentation of this file.
1#ifndef __IMLIB_API_H
2#define __IMLIB_API_H 1
6#define IMLIB2_VERSION_MAJOR 1
7#define IMLIB2_VERSION_MINOR 10
8#define IMLIB2_VERSION_MICRO 0
9
10#define IMLIB2_VERSION_(maj, min, mic) (10000 * (maj) + 100 * (min) + (mic))
11#define IMLIB2_VERSION IMLIB2_VERSION_(IMLIB2_VERSION_MAJOR, IMLIB2_VERSION_MINOR, IMLIB2_VERSION_MICRO)
12
13#ifdef EAPI
14#undef EAPI
15#endif
16#ifdef WIN32
17#ifdef BUILDING_DLL
18#define EAPI __declspec(dllexport)
19#else
20#define EAPI __declspec(dllimport)
21#endif
22#else
23#ifdef __GNUC__
24#if __GNUC__ >= 4
25#define EAPI __attribute__ ((visibility("default")))
26#else
27#define EAPI
28#endif
29#else
30#define EAPI
31#endif
32#endif
33
34#ifndef IMLIB2_DEPRECATED
35#ifdef __GNUC__
36#define IMLIB2_DEPRECATED __attribute__((deprecated))
37#else
38#define IMLIB2_DEPRECATED
39#endif
40#endif
41
42#include <stddef.h>
43#include <stdint.h>
44#ifndef X_DISPLAY_MISSING
45#include <X11/Xlib.h>
46#endif
47
48/* opaque data types */
49typedef void *Imlib_Context;
50typedef void *Imlib_Image;
51typedef void *Imlib_Color_Modifier;
52typedef void *Imlib_Updates;
53typedef void *Imlib_Font;
54typedef void *Imlib_Color_Range;
55typedef void *Imlib_Filter;
56typedef void *ImlibPolygon;
57
58/* blending operations */
59typedef enum {
60 IMLIB_OP_COPY,
61 IMLIB_OP_ADD,
62 IMLIB_OP_SUBTRACT,
63 IMLIB_OP_RESHADE
64} Imlib_Operation;
65
66typedef enum {
67 IMLIB_TEXT_TO_RIGHT = 0,
68 IMLIB_TEXT_TO_LEFT = 1,
69 IMLIB_TEXT_TO_DOWN = 2,
70 IMLIB_TEXT_TO_UP = 3,
71 IMLIB_TEXT_TO_ANGLE = 4
72} Imlib_Text_Direction;
73
74#define IMLIB_ERR_INTERNAL -1 /* Internal error (should not happen) */
75#define IMLIB_ERR_NO_LOADER -2 /* No loader for file format */
76#define IMLIB_ERR_NO_SAVER -3 /* No saver for file format */
77#define IMLIB_ERR_BAD_IMAGE -4 /* Invalid image file */
78#define IMLIB_ERR_BAD_FRAME -5 /* Requested frame not in image */
79
80typedef struct {
81 int left, right, top, bottom;
82} Imlib_Border;
83
84typedef struct {
85 int alpha, red, green, blue;
86} Imlib_Color;
87
88/* Progressive loading callback */
89typedef int (*Imlib_Progress_Function)(Imlib_Image im, char percent,
90 int update_x, int update_y,
91 int update_w, int update_h);
92
93/* Custom attached data destructor callback */
94typedef void (*Imlib_Data_Destructor_Function)(Imlib_Image im,
95 void *data);
96
97/* Custom image data memory management function */
98typedef void *(*Imlib_Image_Data_Memory_Function)(void *, size_t size);
99
100/* *INDENT-OFF* */
101#ifdef __cplusplus
102extern "C" {
103#endif
104/* *INDENT-ON* */
105
107EAPI int imlib_version(void);
108
109/*--------------------------------
110 * Context handling
111 */
112
114EAPI Imlib_Context imlib_context_new(void);
115
117EAPI void imlib_context_free(Imlib_Context context);
118
120EAPI void imlib_context_push(Imlib_Context context);
121
123EAPI void imlib_context_pop(void);
124
126EAPI Imlib_Context imlib_context_get(void);
127
128/*--------------------------------
129 * Context operations
130 */
131
132#ifndef X_DISPLAY_MISSING
146EAPI void imlib_context_set_display(Display * display);
147
153EAPI Display *imlib_context_get_display(void);
154
162
171EAPI void imlib_context_set_visual(Visual * visual);
172
178EAPI Visual *imlib_context_get_visual(void);
179
189EAPI void imlib_context_set_colormap(Colormap colormap);
190
196EAPI Colormap imlib_context_get_colormap(void);
197
205EAPI void imlib_context_set_drawable(Drawable drawable);
206
212EAPI Drawable imlib_context_get_drawable(void);
213
222EAPI void imlib_context_set_mask(Pixmap mask);
223
229EAPI Pixmap imlib_context_get_mask(void);
230
241EAPI void imlib_context_set_dither_mask(char dither_mask);
242
249
261 mask_alpha_threshold);
262
269
270#endif /* X_DISPLAY_MISSING */
271
283EAPI void imlib_context_set_anti_alias(char anti_alias);
284
291
306EAPI void imlib_context_set_dither(char dither);
307
314
323EAPI void imlib_context_set_blend(char blend);
324
331
347EAPI void imlib_context_set_color_modifier(Imlib_Color_Modifier
348 color_modifier);
349
355EAPI Imlib_Color_Modifier imlib_context_get_color_modifier(void);
356
375EAPI void imlib_context_set_operation(Imlib_Operation operation);
376
382EAPI Imlib_Operation imlib_context_get_operation(void);
383
391EAPI void imlib_context_set_font(Imlib_Font font);
392
398EAPI Imlib_Font imlib_context_get_font(void);
399
412EAPI void imlib_context_set_direction(Imlib_Text_Direction direction);
413
419EAPI Imlib_Text_Direction imlib_context_get_direction(void);
420
430EAPI void imlib_context_set_angle(double angle);
431
439EAPI double imlib_context_get_angle(void);
440
454EAPI void imlib_context_set_color(int red, int green, int blue,
455 int alpha);
456
465EAPI void imlib_context_get_color(int *red, int *green, int *blue,
466 int *alpha);
467
480EAPI void imlib_context_set_color_hsva(float hue, float saturation,
481 float value, int alpha);
482
491EAPI void imlib_context_get_color_hsva(float *hue, float *saturation,
492 float *value, int *alpha);
493
506EAPI void imlib_context_set_color_hlsa(float hue, float lightness,
507 float saturation, int alpha);
508
517EAPI void imlib_context_get_color_hlsa(float *hue, float *lightness,
518 float *saturation, int *alpha);
519
531EAPI void imlib_context_set_color_cmya(int cyan, int magenta,
532 int yellow, int alpha);
533
542EAPI void imlib_context_get_color_cmya(int *cyan, int *magenta,
543 int *yellow, int *alpha);
544
552EAPI Imlib_Color *imlib_context_get_imlib_color(void);
553
559EAPI void imlib_context_set_color_range(Imlib_Color_Range
560 color_range);
561
567EAPI Imlib_Color_Range imlib_context_get_color_range(void);
568
575 (Imlib_Image_Data_Memory_Function memory_function);
576
582EAPI Imlib_Image_Data_Memory_Function
584
593EAPI void imlib_context_set_progress_function(Imlib_Progress_Function
594 progress_function);
595
601EAPI Imlib_Progress_Function imlib_context_get_progress_function(void);
602
615 progress_granularity);
616
623
629EAPI void imlib_context_set_image(Imlib_Image image);
630
636EAPI Imlib_Image imlib_context_get_image(void);
637
646EAPI void imlib_context_set_cliprect(int x, int y, int w, int h);
647
656EAPI void imlib_context_get_cliprect(int *x, int *y, int *w, int *h);
657
665EAPI int imlib_get_cache_used(void);
666
674EAPI int imlib_get_cache_size(void);
675
687EAPI void imlib_set_cache_size(int bytes);
688
689#ifndef X_DISPLAY_MISSING
698
706EAPI void imlib_set_color_usage(int max);
707
714EAPI int imlib_get_visual_depth(Display * display, Visual * visual);
715
727EAPI Visual *imlib_get_best_visual(Display * display, int screen,
728 int *depth_return);
729#endif /* X_DISPLAY_MISSING */
730
739EAPI void imlib_flush_loaders(void);
740
752EAPI int imlib_get_error(void);
753
763EAPI Imlib_Image imlib_load_image(const char *file);
764
775EAPI Imlib_Image imlib_load_image_immediately(const char *file);
776
784EAPI Imlib_Image imlib_load_image_without_cache(const char *file);
785
794 *file);
795
812EAPI Imlib_Image imlib_load_image_with_errno_return(const char *file,
813 int *error_return);
814
830EAPI Imlib_Image imlib_load_image_fd(int fd, const char *file);
831
845EAPI Imlib_Image imlib_load_image_mem(const char *file,
846 const void *data, size_t size);
847
851EAPI void imlib_free_image(void);
852
857
858/*--------------------------------
859 * Query/modify image parameters
860 */
861
866
871
884EAPI const char *imlib_image_get_filename(void);
885
904EAPI uint32_t *imlib_image_get_data(void);
905
918
926EAPI void imlib_image_put_back_data(uint32_t * data);
927
936EAPI char imlib_image_has_alpha(void);
937
950
961EAPI void imlib_image_get_border(Imlib_Border * border);
962
968EAPI void imlib_image_set_border(Imlib_Border * border);
969
979EAPI void imlib_image_set_format(const char *format);
980
990EAPI void imlib_image_set_irrelevant_format(char irrelevant);
991
999EAPI char *imlib_image_format(void);
1000
1008EAPI void imlib_image_set_has_alpha(char has_alpha);
1009
1020EAPI void imlib_image_query_pixel(int x, int y,
1021 Imlib_Color * color_return);
1022
1033EAPI void imlib_image_query_pixel_hsva(int x, int y,
1034 float *hue, float *saturation,
1035 float *value, int *alpha);
1036
1047EAPI void imlib_image_query_pixel_hlsa(int x, int y,
1048 float *hue, float *lightness,
1049 float *saturation, int *alpha);
1050
1061EAPI void imlib_image_query_pixel_cmya(int x, int y,
1062 int *cyan, int *magenta,
1063 int *yellow, int *alpha);
1064
1065/*--------------------------------
1066 * Rendering functions
1067 */
1068
1069#ifndef X_DISPLAY_MISSING
1080EAPI void imlib_render_pixmaps_for_whole_image(Pixmap * pixmap_return,
1081 Pixmap * mask_return);
1082
1098 pixmap_return,
1099 Pixmap *
1100 mask_return,
1101 int width,
1102 int height);
1103
1112EAPI void imlib_free_pixmap_and_mask(Pixmap pixmap);
1113
1123EAPI void imlib_render_image_on_drawable(int x, int y);
1124
1138 int width,
1139 int height);
1140
1158 int source_y,
1159 int
1160 source_width, int
1161 source_height,
1162 int x, int y,
1163 int width,
1164 int height);
1165
1170
1171#endif /* X_DISPLAY_MISSING */
1172
1194EAPI void imlib_blend_image_onto_image(Imlib_Image source_image,
1195 char merge_alpha,
1196 int source_x, int source_y,
1197 int source_width,
1198 int source_height,
1199 int destination_x,
1200 int destination_y,
1201 int destination_width,
1202 int destination_height);
1203
1204/*--------------------------------
1205 * Image creation functions
1206 */
1207
1221EAPI Imlib_Image imlib_create_image(int width, int height);
1222
1230EAPI Imlib_Image imlib_clone_image(void);
1231
1245EAPI Imlib_Image imlib_create_cropped_image(int x, int y, int width,
1246 int height);
1247
1264EAPI Imlib_Image imlib_create_cropped_scaled_image(int source_x,
1265 int source_y,
1266 int source_width,
1267 int source_height,
1268 int destination_width,
1269 int destination_height);
1270
1291EAPI Imlib_Image imlib_create_image_using_data(int width, int height,
1292 uint32_t * data);
1293
1312 (int width, int height, uint32_t * data,
1313 Imlib_Image_Data_Memory_Function func);
1314
1329EAPI Imlib_Image imlib_create_image_using_copied_data(int width, int height,
1330 uint32_t * data);
1331
1332#ifndef X_DISPLAY_MISSING
1355EAPI Imlib_Image imlib_create_image_from_drawable(Pixmap mask,
1356 int x, int y,
1357 int width, int height,
1358 char need_to_grab_x);
1359
1373EAPI Imlib_Image imlib_create_image_from_ximage(XImage * image,
1374 XImage * mask,
1375 int x, int y,
1376 int width, int height,
1377 char need_to_grab_x);
1378
1406EAPI Imlib_Image imlib_create_scaled_image_from_drawable(Pixmap mask,
1407 int source_x,
1408 int source_y,
1409 int source_width,
1410 int
1411 source_height, int
1412 destination_width, int
1413 destination_height, char
1414 need_to_grab_x, char
1415 get_mask_from_shape);
1416
1441EAPI char imlib_copy_drawable_to_image(Pixmap mask, int x, int y,
1442 int width, int height,
1443 int destination_x,
1444 int destination_y,
1445 char need_to_grab_x);
1446
1453
1460
1473
1480
1487
1500
1501#endif /* X_DISPLAY_MISSING */
1502
1503/*--------------------------------
1504 * Updates - lists of rectangles for storing required update draws
1505 */
1506
1516EAPI Imlib_Updates imlib_updates_clone(Imlib_Updates updates);
1517
1534EAPI Imlib_Updates imlib_update_append_rect(Imlib_Updates updates,
1535 int x, int y, int w, int h);
1536
1552EAPI Imlib_Updates imlib_updates_merge(Imlib_Updates updates, int w, int h);
1553
1567EAPI Imlib_Updates imlib_updates_merge_for_rendering(Imlib_Updates updates,
1568 int w, int h);
1569
1575EAPI void imlib_updates_free(Imlib_Updates updates);
1576
1584EAPI Imlib_Updates imlib_updates_get_next(Imlib_Updates updates);
1585
1595EAPI void imlib_updates_get_coordinates(Imlib_Updates updates,
1596 int *x_return,
1597 int *y_return,
1598 int *width_return,
1599 int *height_return);
1600
1610EAPI void imlib_updates_set_coordinates(Imlib_Updates updates,
1611 int x, int y,
1612 int width, int height);
1613
1614#ifdef BUILD_X11
1626EAPI void imlib_render_image_updates_on_drawable(Imlib_Updates
1627 updates,
1628 int x, int y);
1629#endif
1630
1639EAPI Imlib_Updates imlib_updates_init(void);
1640
1652EAPI Imlib_Updates imlib_updates_append_updates(Imlib_Updates updates,
1653 Imlib_Updates
1654 appended_updates);
1655
1656/*--------------------------------
1657 * Image modification
1658 */
1659
1664
1669
1677
1688EAPI void imlib_image_orientate(int orientation);
1689
1698EAPI void imlib_image_blur(int radius);
1699
1707EAPI void imlib_image_sharpen(int radius);
1708
1716
1724
1732EAPI void imlib_image_tile(void);
1733
1745EAPI void imlib_image_copy_alpha_to_image(Imlib_Image image_source,
1746 int x, int y);
1747
1764 image_source,
1765 int x, int y,
1766 int width,
1767 int height,
1768 int destination_x,
1769 int
1770 destination_y);
1771
1785EAPI void imlib_image_scroll_rect(int x, int y, int width, int height,
1786 int delta_x, int delta_y);
1787
1802EAPI void imlib_image_copy_rect(int x, int y, int width, int height,
1803 int new_x, int new_y);
1804
1805/*--------------------------------
1806 * Fonts and text
1807 */
1808
1822EAPI Imlib_Font imlib_load_font(const char *font_name);
1823
1827EAPI void imlib_free_font(void);
1828
1847 Imlib_Font
1848 fallback_font);
1849
1858 fallback_font);
1859
1861EAPI Imlib_Font imlib_get_prev_font_in_fallback_chain(Imlib_Font fn);
1862
1864EAPI Imlib_Font imlib_get_next_font_in_fallback_chain(Imlib_Font fn);
1865
1877EAPI void imlib_text_draw(int x, int y, const char *text);
1878
1898 const char *text,
1899 int *width_return,
1900 int *height_return, int
1901 *horizontal_advance_return, int
1902 *vertical_advance_return);
1903
1914EAPI void imlib_get_text_size(const char *text,
1915 int *width_return, int *height_return);
1916
1930EAPI void imlib_get_text_advance(const char *text,
1931 int *horizontal_advance_return,
1932 int *vertical_advance_return);
1933
1944EAPI int imlib_get_text_inset(const char *text);
1945
1954EAPI void imlib_add_path_to_font_path(const char *path);
1955
1963EAPI void imlib_remove_path_from_font_path(const char *path);
1964
1979EAPI char **imlib_list_font_path(int *number_return);
1980
2001EAPI int imlib_text_get_index_and_location(const char *text,
2002 int x, int y,
2003 int *char_x_return,
2004 int *char_y_return,
2005 int *char_width_return,
2006 int *char_height_return);
2007
2021EAPI void imlib_text_get_location_at_index(const char *text,
2022 int index,
2023 int *char_x_return,
2024 int *char_y_return,
2025 int *char_width_return,
2026 int *char_height_return);
2027
2035EAPI char **imlib_list_fonts(int *number_return);
2036
2043EAPI void imlib_free_font_list(char **font_list, int number);
2044
2051
2062EAPI void imlib_set_font_cache_size(int bytes);
2063
2068
2075
2082
2089
2096
2097/*--------------------------------
2098 * Color modifiers
2099 */
2100
2109EAPI Imlib_Color_Modifier imlib_create_color_modifier(void);
2110
2115
2127EAPI void imlib_modify_color_modifier_gamma(double gamma_value);
2128
2142 brightness_value);
2143
2155 contrast_value);
2156
2171EAPI void imlib_set_color_modifier_tables(uint8_t * red_table,
2172 uint8_t * green_table,
2173 uint8_t * blue_table,
2174 uint8_t * alpha_table);
2175
2188EAPI void imlib_get_color_modifier_tables(uint8_t * red_table,
2189 uint8_t * green_table,
2190 uint8_t * blue_table,
2191 uint8_t * alpha_table);
2192
2199
2206
2219 int width,
2220 int height);
2221
2222/*--------------------------------
2223 * Drawing on images
2224 */
2225
2240EAPI Imlib_Updates imlib_image_draw_pixel(int x, int y, char make_updates);
2241
2258EAPI Imlib_Updates imlib_image_draw_line(int x1, int y1, int x2, int y2,
2259 char make_updates);
2260
2274EAPI void imlib_image_draw_rectangle(int x, int y,
2275 int width, int height);
2276
2289EAPI void imlib_image_fill_rectangle(int x, int y,
2290 int width, int height);
2291
2292/*--------------------------------
2293 * Polygons
2294 */
2295
2301EAPI ImlibPolygon imlib_polygon_new(void);
2302
2308EAPI void imlib_polygon_free(ImlibPolygon poly);
2309
2321EAPI void imlib_polygon_add_point(ImlibPolygon poly, int x, int y);
2322
2334EAPI void imlib_image_draw_polygon(ImlibPolygon poly,
2335 unsigned char closed);
2336
2345EAPI void imlib_image_fill_polygon(ImlibPolygon poly);
2346
2360EAPI void imlib_polygon_get_bounds(ImlibPolygon poly,
2361 int *px1, int *py1,
2362 int *px2, int *py2);
2363
2376EAPI unsigned char imlib_polygon_contains_point(ImlibPolygon poly,
2377 int x, int y);
2378
2379/*--------------------------------
2380 * Ellipses
2381 */
2382
2397EAPI void imlib_image_draw_ellipse(int xc, int yc, int a, int b);
2398
2414EAPI void imlib_image_fill_ellipse(int xc, int yc, int a, int b);
2415
2416/*--------------------------------
2417 * Color ranges
2418 */
2419
2425EAPI Imlib_Color_Range imlib_create_color_range(void);
2426
2431
2441EAPI void imlib_add_color_to_color_range(int distance_away);
2442
2458 int width,
2459 int height,
2460 double angle);
2461
2479 int width,
2480 int height,
2481 double
2482 angle);
2483
2484/*--------------------------------
2485 * Image data attachment
2486 */
2487
2501EAPI void imlib_image_attach_data_value(const char *key,
2502 void *data, int value,
2503 Imlib_Data_Destructor_Function
2504 destructor_function);
2505
2516EAPI void *imlib_image_get_attached_data(const char *key);
2517
2528EAPI int imlib_image_get_attached_value(const char *key);
2529
2539
2550 *key);
2551
2552/*--------------------------------
2553 * Image saving
2554 */
2555
2564EAPI void imlib_save_image(const char *filename);
2565
2579EAPI void imlib_save_image_with_errno_return(const char *filename,
2580 int *error_return);
2581
2582/*--------------------------------
2583 * Image rotation/skewing
2584 */
2585
2595EAPI Imlib_Image imlib_create_rotated_image(double angle);
2596
2605EAPI void imlib_rotate_image_from_buffer(double angle,
2606 Imlib_Image source_image);
2607
2626 source_image,
2627 char merge_alpha,
2628 int source_x,
2629 int source_y,
2630 int source_width,
2631 int source_height,
2632 int destination_x,
2633 int destination_y,
2634 int angle_x,
2635 int angle_y);
2636
2693 source_image,
2694 char merge_alpha,
2695 int source_x,
2696 int source_y,
2697 int source_width,
2698 int source_height,
2699 int destination_x,
2700 int destination_y,
2701 int h_angle_x,
2702 int h_angle_y,
2703 int v_angle_x,
2704 int v_angle_y);
2705
2706#ifndef X_DISPLAY_MISSING
2726 int source_y,
2727 int source_width,
2728 int source_height,
2729 int destination_x,
2730 int destination_y,
2731 int h_angle_x,
2732 int h_angle_y,
2733 int v_angle_x,
2734 int v_angle_y);
2735
2752 int source_y,
2753 int source_width,
2754 int source_height,
2755 int destination_x,
2756 int destination_y,
2757 int angle_x,
2758 int angle_y);
2759
2760#endif /* X_DISPLAY_MISSING */
2761
2762/*--------------------------------
2763 * Image filters
2764 */
2765
2769EAPI void imlib_image_filter(void);
2770
2774EAPI Imlib_Filter imlib_create_filter(int initsize);
2775
2783EAPI void imlib_context_set_filter(Imlib_Filter filter);
2784
2790EAPI Imlib_Filter imlib_context_get_filter(void);
2791
2795EAPI void imlib_free_filter(void);
2796
2797EAPI void imlib_filter_set(int xoff, int yoff,
2798 int a, int r, int g, int b);
2799EAPI void imlib_filter_set_alpha(int xoff, int yoff,
2800 int a, int r, int g, int b);
2801EAPI void imlib_filter_set_red(int xoff, int yoff,
2802 int a, int r, int g, int b);
2803EAPI void imlib_filter_set_green(int xoff, int yoff,
2804 int a, int r, int g, int b);
2805EAPI void imlib_filter_set_blue(int xoff, int yoff,
2806 int a, int r, int g, int b);
2807EAPI void imlib_filter_constants(int a, int r, int g, int b);
2808EAPI void imlib_filter_divisors(int a, int r, int g, int b);
2809
2810EAPI void imlib_apply_filter(const char *script, ...);
2811
2817EAPI void imlib_image_clear(void);
2818
2822EAPI void imlib_image_clear_color(int r, int g, int b, int a);
2823
2824/*--------------------------------
2825 * Multiframe image loading
2826 */
2827
2828typedef struct {
2829 int frame_count; /* Number of frames in image */
2830 int frame_num; /* Current frame (1..frame_count) */
2831 int canvas_w, canvas_h; /* Canvas size */
2832 int frame_x, frame_y; /* Frame origin */
2833 int frame_w, frame_h; /* Frame size */
2834 int frame_flags; /* Frame info flags */
2835 int frame_delay; /* Frame delay (ms) */
2836 int loop_count; /* Number of animation loops */
2837} Imlib_Frame_Info;
2838
2839/* frame info flags */
2840#define IMLIB_IMAGE_ANIMATED (1 << 0) /* Frames are an animated sequence */
2841#define IMLIB_FRAME_BLEND (1 << 1) /* Blend current onto previous frame */
2842#define IMLIB_FRAME_DISPOSE_CLEAR (1 << 2) /* Clear before rendering next frame */
2843#define IMLIB_FRAME_DISPOSE_PREV (1 << 3) /* Revert before rendering next frame */
2844
2858EAPI Imlib_Image imlib_load_image_frame(const char *file, int frame);
2859
2876EAPI Imlib_Image imlib_load_image_frame_mem(const char *file, int frame,
2877 const void *data, size_t size);
2878
2884EAPI void imlib_image_get_frame_info(Imlib_Frame_Info * info);
2885
2896EAPI const char *imlib_strerror(int err);
2897
2898/*--------------------------------
2899 * Deprecated functionality
2900 */
2901
2902/* Old data types, no longer used by imlib2, likely to be removed */
2903#ifndef DATA64
2904#define DATA64 uint64_t
2905#define DATA32 uint32_t
2906#define DATA16 uint16_t
2907#define DATA8 uint8_t
2908#endif
2909
2910/* *INDENT-OFF* */
2911
2912typedef enum {
2913 IMLIB_LOAD_ERROR_NONE,
2914 IMLIB_LOAD_ERROR_FILE_DOES_NOT_EXIST,
2915 IMLIB_LOAD_ERROR_FILE_IS_DIRECTORY,
2916 IMLIB_LOAD_ERROR_PERMISSION_DENIED_TO_READ,
2917 IMLIB_LOAD_ERROR_NO_LOADER_FOR_FILE_FORMAT,
2918 IMLIB_LOAD_ERROR_PATH_TOO_LONG,
2919 IMLIB_LOAD_ERROR_PATH_COMPONENT_NON_EXISTANT,
2920 IMLIB_LOAD_ERROR_PATH_COMPONENT_NOT_DIRECTORY,
2921 IMLIB_LOAD_ERROR_PATH_POINTS_OUTSIDE_ADDRESS_SPACE,
2922 IMLIB_LOAD_ERROR_TOO_MANY_SYMBOLIC_LINKS,
2923 IMLIB_LOAD_ERROR_OUT_OF_MEMORY,
2924 IMLIB_LOAD_ERROR_OUT_OF_FILE_DESCRIPTORS,
2925 IMLIB_LOAD_ERROR_PERMISSION_DENIED_TO_WRITE,
2926 IMLIB_LOAD_ERROR_OUT_OF_DISK_SPACE,
2927 IMLIB_LOAD_ERROR_UNKNOWN,
2928 IMLIB_LOAD_ERROR_IMAGE_READ,
2929 IMLIB_LOAD_ERROR_IMAGE_FRAME
2930} Imlib_Load_Error;
2931
2946/* IMLIB2_DEPRECATED */
2947EAPI Imlib_Image imlib_load_image_with_error_return(const char *file,
2948 Imlib_Load_Error *
2949 error_return);
2950
2962/* IMLIB2_DEPRECATED */
2963EAPI void imlib_save_image_with_error_return(const char *filename,
2964 Imlib_Load_Error *
2965 error_return);
2966
2969IMLIB2_DEPRECATED
2970EAPI void imlib_image_set_irrelevant_border(char irrelevant);
2971
2974IMLIB2_DEPRECATED
2975EAPI void imlib_image_set_irrelevant_alpha(char irrelevant);
2976
2977/* Encodings known to Imlib2 (so far) */
2978typedef enum {
2979 IMLIB_TTF_ENCODING_ISO_8859_1,
2980 IMLIB_TTF_ENCODING_ISO_8859_2,
2981 IMLIB_TTF_ENCODING_ISO_8859_3,
2982 IMLIB_TTF_ENCODING_ISO_8859_4,
2983 IMLIB_TTF_ENCODING_ISO_8859_5
2984} Imlib_TTF_Encoding;
2985
2988IMLIB2_DEPRECATED
2989EAPI void imlib_context_set_TTF_encoding(Imlib_TTF_Encoding encoding);
2990
2993IMLIB2_DEPRECATED
2994EAPI Imlib_TTF_Encoding imlib_context_get_TTF_encoding(void);
2995
2996#ifdef __cplusplus
2997}
2998#endif
2999/* *INDENT-ON* */
3000#endif
EAPI void imlib_image_query_pixel(int x, int y, Imlib_Color *color_return)
EAPI Imlib_Color_Modifier imlib_create_color_modifier(void)
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)
EAPI void imlib_image_copy_alpha_to_image(Imlib_Image image_source, int x, int y)
IMLIB2_DEPRECATED EAPI Imlib_TTF_Encoding imlib_context_get_TTF_encoding(void)
EAPI void imlib_add_color_to_color_range(int distance_away)
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)
EAPI void imlib_image_put_back_data(uint32_t *data)
EAPI void imlib_image_query_pixel_hlsa(int x, int y, float *hue, float *lightness, float *saturation, int *alpha)
EAPI void imlib_updates_get_coordinates(Imlib_Updates updates, int *x_return, int *y_return, int *width_return, int *height_return)
EAPI void imlib_image_tile(void)
EAPI void imlib_context_push(Imlib_Context context)
EAPI void imlib_image_query_pixel_hsva(int x, int y, float *hue, float *saturation, float *value, int *alpha)
EAPI void imlib_updates_set_coordinates(Imlib_Updates updates, int x, int y, int width, int height)
EAPI ImlibPolygon imlib_polygon_new(void)
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 int imlib_get_ximage_cache_count_used(void)
EAPI void imlib_context_set_cliprect(int x, int y, int w, int h)
EAPI Visual * imlib_get_best_visual(Display *display, int screen, int *depth_return)
EAPI Imlib_Operation imlib_context_get_operation(void)
EAPI void imlib_render_image_on_drawable(int x, int y)
EAPI Imlib_Updates imlib_updates_merge_for_rendering(Imlib_Updates updates, int w, int h)
EAPI void imlib_image_flip_horizontal(void)
EAPI void imlib_free_font(void)
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 char * imlib_image_format(void)
EAPI Imlib_Image imlib_load_image(const char *file)
EAPI void imlib_context_set_mask_alpha_threshold(int mask_alpha_threshold)
EAPI int imlib_get_maximum_font_descent(void)
EAPI void imlib_free_pixmap_and_mask(Pixmap pixmap)
EAPI void imlib_image_set_border(Imlib_Border *border)
EAPI void imlib_context_set_color(int red, int green, int blue, int alpha)
EAPI void imlib_image_scroll_rect(int x, int y, int width, int height, int delta_x, int delta_y)
EAPI int imlib_get_error(void)
EAPI double imlib_context_get_angle(void)
EAPI Imlib_Updates imlib_update_append_rect(Imlib_Updates updates, int x, int y, int w, int h)
EAPI int imlib_get_color_usage(void)
EAPI Imlib_Image imlib_load_image_immediately(const char *file)
EAPI char imlib_image_has_alpha(void)
EAPI void imlib_context_set_mask(Pixmap mask)
EAPI void imlib_context_free(Imlib_Context context)
EAPI void imlib_image_flip_vertical(void)
EAPI void imlib_apply_color_modifier_to_rectangle(int x, int y, int width, int height)
EAPI void imlib_context_set_dither_mask(char dither_mask)
EAPI void imlib_image_draw_ellipse(int xc, int yc, int a, int b)
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 int imlib_get_ximage_cache_count_max(void)
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 void imlib_flush_font_cache(void)
EAPI void imlib_modify_color_modifier_brightness(double brightness_value)
EAPI int imlib_get_font_cache_size(void)
EAPI void imlib_context_set_color_cmya(int cyan, int magenta, int yellow, int alpha)
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)
EAPI Imlib_Color_Modifier imlib_context_get_color_modifier(void)
EAPI void imlib_image_clear_color(int r, int g, int b, int a)
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)
EAPI Imlib_Image imlib_create_image_using_data(int width, int height, uint32_t *data)
EAPI void imlib_free_image_and_decache(void)
EAPI uint32_t imlib_render_get_pixel_color(void)
EAPI const char * imlib_strerror(int err)
EAPI char imlib_context_get_dither(void)
EAPI void imlib_image_fill_polygon(ImlibPolygon poly)
EAPI int imlib_get_ximage_cache_size_max(void)
EAPI Imlib_Image imlib_load_image_frame_mem(const char *file, int frame, const void *data, size_t size)
EAPI int imlib_image_get_attached_value(const char *key)
EAPI void imlib_context_get_color_hlsa(float *hue, float *lightness, float *saturation, int *alpha)
EAPI char imlib_context_get_blend(void)
EAPI void imlib_set_cache_size(int bytes)
EAPI void imlib_get_color_modifier_tables(uint8_t *red_table, uint8_t *green_table, uint8_t *blue_table, uint8_t *alpha_table)
EAPI void imlib_context_set_color_range(Imlib_Color_Range color_range)
EAPI Imlib_Context imlib_context_get(void)
EAPI void imlib_context_set_drawable(Drawable drawable)
EAPI int imlib_context_get_mask_alpha_threshold(void)
EAPI Imlib_Image imlib_create_image_using_data_and_memory_function(int width, int height, uint32_t *data, Imlib_Image_Data_Memory_Function func)
EAPI int imlib_get_ximage_cache_size_used(void)
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 Imlib_Image imlib_create_image_from_drawable(Pixmap mask, int x, int y, int width, int height, char need_to_grab_x)
EAPI void imlib_image_blur(int radius)
EAPI Imlib_Image imlib_load_image_mem(const char *file, const void *data, size_t size)
EAPI void imlib_save_image(const char *filename)
EAPI Imlib_Image imlib_load_image_immediately_without_cache(const char *file)
EAPI Imlib_Color_Range imlib_create_color_range(void)
EAPI Imlib_Progress_Function imlib_context_get_progress_function(void)
EAPI void imlib_apply_color_modifier(void)
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)
EAPI uint32_t * imlib_image_get_data_for_reading_only(void)
EAPI Imlib_Updates imlib_image_draw_line(int x1, int y1, int x2, int y2, char make_updates)
EAPI void imlib_context_disconnect_display(void)
EAPI Imlib_Updates imlib_updates_append_updates(Imlib_Updates updates, Imlib_Updates appended_updates)
EAPI void imlib_remove_path_from_font_path(const char *path)
EAPI Imlib_Font imlib_get_prev_font_in_fallback_chain(Imlib_Font fn)
EAPI int imlib_get_text_inset(const char *text)
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 void imlib_context_set_progress_granularity(char progress_granularity)
EAPI Imlib_Updates imlib_updates_merge(Imlib_Updates updates, int w, int h)
EAPI Imlib_Image imlib_create_image_using_copied_data(int width, int height, uint32_t *data)
EAPI void imlib_image_draw_rectangle(int x, int y, int width, int height)
EAPI void imlib_context_set_operation(Imlib_Operation operation)
EAPI void imlib_get_text_size(const char *text, int *width_return, int *height_return)
EAPI void imlib_context_set_color_modifier(Imlib_Color_Modifier color_modifier)
EAPI void imlib_image_set_changes_on_disk(void)
EAPI void imlib_render_pixmaps_for_whole_image(Pixmap *pixmap_return, Pixmap *mask_return)
EAPI Imlib_Context imlib_context_new(void)
EAPI void imlib_context_get_color_cmya(int *cyan, int *magenta, int *yellow, int *alpha)
EAPI char imlib_context_get_anti_alias(void)
EAPI Imlib_Updates imlib_updates_clone(Imlib_Updates updates)
EAPI Imlib_Image imlib_load_image_without_cache(const char *file)
IMLIB2_DEPRECATED EAPI void imlib_context_set_TTF_encoding(Imlib_TTF_Encoding encoding)
EAPI Imlib_Color * imlib_context_get_imlib_color(void)
EAPI Imlib_Updates imlib_updates_init(void)
EAPI Imlib_Filter imlib_context_get_filter(void)
EAPI void imlib_image_get_frame_info(Imlib_Frame_Info *info)
EAPI void imlib_flush_loaders(void)
EAPI void imlib_image_fill_color_range_rectangle(int x, int y, int width, int height, double angle)
EAPI int imlib_image_get_height(void)
EAPI void imlib_image_set_has_alpha(char has_alpha)
EAPI char ** imlib_list_fonts(int *number_return)
EAPI Imlib_Image imlib_create_rotated_image(double angle)
IMLIB2_DEPRECATED EAPI void imlib_image_set_irrelevant_border(char irrelevant)
EAPI Pixmap imlib_context_get_mask(void)
EAPI Drawable imlib_context_get_drawable(void)
EAPI void imlib_context_set_angle(double angle)
EAPI Imlib_Font imlib_context_get_font(void)
EAPI void imlib_context_set_blend(char blend)
EAPI void imlib_image_filter(void)
EAPI Imlib_Color_Range imlib_context_get_color_range(void)
EAPI void imlib_context_set_dither(char dither)
EAPI void imlib_set_ximage_cache_size_max(int bytes)
EAPI void imlib_context_get_cliprect(int *x, int *y, int *w, int *h)
EAPI void imlib_image_remove_attached_data_value(const char *key)
EAPI void imlib_image_tile_horizontal(void)
EAPI void imlib_free_image(void)
EAPI void imlib_context_set_progress_function(Imlib_Progress_Function progress_function)
EAPI Imlib_Font imlib_load_font(const char *font_name)
EAPI Imlib_Image imlib_create_cropped_image(int x, int y, int width, int height)
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 void imlib_context_pop(void)
EAPI void imlib_image_fill_ellipse(int xc, int yc, int a, int b)
EAPI void imlib_context_set_visual(Visual *visual)
EAPI void imlib_free_font_list(char **font_list, int number)
EAPI void imlib_image_get_border(Imlib_Border *border)
EAPI void imlib_image_draw_polygon(ImlibPolygon poly, unsigned char closed)
EAPI Imlib_Image imlib_create_image(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)
EAPI int imlib_get_font_descent(void)
EAPI char imlib_context_get_dither_mask(void)
EAPI Imlib_Filter imlib_create_filter(int initsize)
EAPI void imlib_context_set_display(Display *display)
EAPI void imlib_context_set_color_hlsa(float hue, float lightness, float saturation, int alpha)
EAPI Imlib_Font imlib_get_next_font_in_fallback_chain(Imlib_Font fn)
EAPI void imlib_context_set_anti_alias(char anti_alias)
EAPI void imlib_context_set_filter(Imlib_Filter filter)
EAPI void imlib_image_tile_vertical(void)
EAPI Colormap imlib_context_get_colormap(void)
EAPI int imlib_get_visual_depth(Display *display, Visual *visual)
EAPI void imlib_image_fill_hsva_color_range_rectangle(int x, int y, int width, int height, double angle)
EAPI Imlib_Updates imlib_updates_get_next(Imlib_Updates updates)
EAPI Imlib_Image imlib_load_image_with_errno_return(const char *file, int *error_return)
EAPI Imlib_Image imlib_context_get_image(void)
EAPI uint32_t * imlib_image_get_data(void)
EAPI void imlib_image_set_irrelevant_format(char irrelevant)
EAPI void imlib_context_set_colormap(Colormap colormap)
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_image_flip_diagonal(void)
EAPI void imlib_set_font_cache_size(int bytes)
EAPI Imlib_Image imlib_clone_image(void)
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_add_path_to_font_path(const char *path)
EAPI void imlib_image_orientate(int orientation)
EAPI void imlib_updates_free(Imlib_Updates updates)
EAPI void imlib_set_color_usage(int max)
EAPI void imlib_image_copy_rect(int x, int y, int width, int height, int new_x, int new_y)
EAPI void imlib_reset_color_modifier(void)
EAPI void imlib_render_image_on_drawable_at_size(int x, int y, int width, int height)
EAPI void imlib_polygon_add_point(ImlibPolygon poly, int x, int y)
EAPI Imlib_Image imlib_load_image_fd(int fd, const char *file)
EAPI void imlib_text_draw(int x, int y, const char *text)
EAPI Imlib_Updates imlib_image_draw_pixel(int x, int y, char make_updates)
EAPI int imlib_get_font_ascent(void)
EAPI int imlib_insert_font_into_fallback_chain(Imlib_Font font, Imlib_Font fallback_font)
EAPI void imlib_context_set_direction(Imlib_Text_Direction direction)
EAPI void imlib_remove_font_from_fallback_chain(Imlib_Font fallback_font)
IMLIB2_DEPRECATED EAPI void imlib_image_set_irrelevant_alpha(char irrelevant)
EAPI void imlib_free_color_modifier(void)
EAPI char ** imlib_list_font_path(int *number_return)
EAPI void imlib_context_get_color_hsva(float *hue, float *saturation, float *value, int *alpha)
EAPI Display * imlib_context_get_display(void)
EAPI void imlib_save_image_with_errno_return(const char *filename, int *error_return)
EAPI void imlib_image_clear(void)
EAPI const char * imlib_image_get_filename(void)
EAPI char imlib_context_get_progress_granularity(void)
EAPI Imlib_Image imlib_load_image_frame(const char *file, int frame)
EAPI int imlib_get_cache_used(void)
EAPI void imlib_get_text_advance(const char *text, int *horizontal_advance_return, int *vertical_advance_return)
EAPI void imlib_free_filter(void)
EAPI int imlib_version(void)
EAPI void imlib_context_set_image_data_memory_function(Imlib_Image_Data_Memory_Function memory_function)
EAPI Imlib_Text_Direction imlib_context_get_direction(void)
EAPI void imlib_context_set_color_hsva(float hue, float saturation, float value, int alpha)
EAPI Imlib_Image_Data_Memory_Function imlib_context_get_image_data_memory_function(void)
EAPI void imlib_modify_color_modifier_gamma(double gamma_value)
EAPI void imlib_image_fill_rectangle(int x, int y, int width, int height)
EAPI void imlib_polygon_free(ImlibPolygon poly)
EAPI void imlib_context_set_font(Imlib_Font font)
EAPI void imlib_set_ximage_cache_count_max(int count)
EAPI int imlib_get_maximum_font_ascent(void)
EAPI void imlib_image_attach_data_value(const char *key, void *data, int value, Imlib_Data_Destructor_Function destructor_function)
EAPI void imlib_render_pixmaps_for_whole_image_at_size(Pixmap *pixmap_return, Pixmap *mask_return, int width, int height)
EAPI int imlib_get_cache_size(void)
EAPI void imlib_context_set_image(Imlib_Image image)
EAPI void imlib_modify_color_modifier_contrast(double contrast_value)
EAPI void imlib_set_color_modifier_tables(uint8_t *red_table, uint8_t *green_table, uint8_t *blue_table, uint8_t *alpha_table)
EAPI void imlib_rotate_image_from_buffer(double angle, Imlib_Image source_image)
EAPI void imlib_save_image_with_error_return(const char *filename, Imlib_Load_Error *error_return)
EAPI void imlib_image_set_format(const char *format)
EAPI void imlib_free_color_range(void)
EAPI Visual * imlib_context_get_visual(void)
EAPI void imlib_image_sharpen(int radius)
EAPI void imlib_context_get_color(int *red, int *green, int *blue, int *alpha)
EAPI Imlib_Image imlib_load_image_with_error_return(const char *file, Imlib_Load_Error *error_return)
EAPI int imlib_image_get_width(void)
EAPI void * imlib_image_get_attached_data(const char *key)
EAPI void imlib_image_query_pixel_cmya(int x, int y, int *cyan, int *magenta, int *yellow, int *alpha)
EAPI void imlib_image_remove_and_free_attached_data_value(const char *key)