Adds reading capabilities for certain variants of targa, writer code has not been
[imager.git] / image.h
1 #ifndef _IMAGE_H_
2 #define _IMAGE_H_
3
4 #include "io.h"
5 #include "iolayer.h"
6 #include "log.h"
7 #include "stackmach.h"
8
9
10 #ifndef _MSC_VER
11 #include <unistd.h>
12 #endif
13 #include <string.h>
14 #include <stdio.h>
15 #include <math.h>
16 #include <stdlib.h>
17
18 #ifdef SUNOS
19 #include <strings.h>
20 #endif
21
22 #ifndef PI
23 #define PI 3.14159265358979323846
24 #endif
25
26 #ifndef MAXINT
27 #define MAXINT 2147483647
28 #endif
29
30 #include "datatypes.h"
31
32 undef_int i_has_format(char *frmt);
33
34 /* constructors and destructors */
35
36 i_color *ICL_new_internal(            unsigned char r,unsigned char g,unsigned char b,unsigned char a);
37 i_color *ICL_set_internal(i_color *cl,unsigned char r,unsigned char g,unsigned char b,unsigned char a);
38 void     ICL_info        (i_color *cl);
39 void     ICL_DESTROY     (i_color *cl);
40 void     ICL_add         (i_color *dst, i_color *src, int ch);
41
42 extern i_fcolor *i_fcolor_new(double r, double g, double b, double a);
43 extern void i_fcolor_destroy(i_fcolor *cl);
44
45 extern void i_rgb_to_hsvf(i_fcolor *color);
46 extern void i_hsv_to_rgbf(i_fcolor *color);
47 extern void i_rgb_to_hsv(i_color *color);
48 extern void i_hsv_to_rgb(i_color *color);
49
50 i_img *IIM_new(int x,int y,int ch);
51 void   IIM_DESTROY(i_img *im);
52 i_img *i_img_new( void );
53 i_img *i_img_empty(i_img *im,int x,int y);
54 i_img *i_img_empty_ch(i_img *im,int x,int y,int ch);
55 void   i_img_exorcise(i_img *im);
56 void   i_img_destroy(i_img *im);
57
58 void   i_img_info(i_img *im,int *info);
59
60 extern i_img *i_sametype(i_img *im, int xsize, int ysize);
61
62 i_img *i_img_pal_new(int x, int y, int ch, int maxpal);
63
64 /* Image feature settings */
65
66 void   i_img_setmask    (i_img *im,int ch_mask);
67 int    i_img_getmask    (i_img *im);
68 int    i_img_getchannels(i_img *im);
69
70 /* Base functions */
71
72 int i_ppix(i_img *im,int x,int y,i_color *val);
73 int i_gpix(i_img *im,int x,int y,i_color *val);
74 int i_ppixf(i_img *im,int x,int y,i_color *val);
75 int i_gpixf(i_img *im,int x,int y,i_color *val);
76
77 #define i_ppix(im, x, y, val) (((im)->i_f_ppix)((im), (x), (y), (val)))
78 #define i_gpix(im, x, y, val) (((im)->i_f_gpix)((im), (x), (y), (val)))
79 #define i_ppixf(im, x, y, val) (((im)->i_f_ppixf)((im), (x), (y), (val)))
80 #define i_gpixf(im, x, y, val) (((im)->i_f_gpixf)((im), (x), (y), (val)))
81
82 #if 0
83 int i_ppix_d(i_img *im,int x,int y,i_color *val);
84 int i_gpix_d(i_img *im,int x,int y,i_color *val);
85 int i_plin_d(i_img *im,int l, int r, int y, i_color *val);
86 int i_glin_d(i_img *im,int l, int r, int y, i_color *val);
87 #endif
88
89 #define i_plin(im, l, r, y, val) (((im)->i_f_plin)(im, l, r, y, val))
90 #define i_glin(im, l, r, y, val) (((im)->i_f_glin)(im, l, r, y, val))
91 #define i_plinf(im, l, r, y, val) (((im)->i_f_plinf)(im, l, r, y, val))
92 #define i_glinf(im, l, r, y, val) (((im)->i_f_glinf)(im, l, r, y, val))
93
94 #define i_gsamp(im, l, r, y, samps, chans, count) \
95   (((im)->i_f_gsamp)((im), (l), (r), (y), (samps), (chans), (count)))
96 #define i_gsampf(im, l, r, y, samps, chans, count) \
97   (((im)->i_f_gsampf)((im), (l), (r), (y), (samps), (chans), (count)))
98
99 #define i_findcolor(im, color, entry) \
100   (((im)->i_f_findcolor) ? ((im)->i_f_findcolor)((im), (color), (entry)) : 0)
101
102 #define i_gpal(im, l, r, y, vals) \
103   (((im)->i_f_gpal) ? ((im)->i_f_gpal)((im), (l), (r), (y), (vals)) : 0)
104 #define i_ppal(im, l, r, y, vals) \
105   (((im)->i_f_ppal) ? ((im)->i_f_ppal)((im), (l), (r), (y), (vals)) : 0)
106 #define i_addcolors(im, colors, count) \
107   (((im)->i_f_addcolors) ? ((im)->i_f_addcolors)((im), (colors), (count)) : -1)
108 #define i_getcolors(im, index, color, count) \
109   (((im)->i_f_getcolors) ? \
110    ((im)->i_f_getcolors)((im), (index), (color), (count)) : 0)
111 #define i_setcolors(im, index, color, count) \
112   (((im)->i_f_setcolors) ? \
113    ((im)->i_f_setcolors)((im), (index), (color), (count)) : 0)
114 #define i_colorcount(im) \
115   (((im)->i_f_colorcount) ? ((im)->i_f_colorcount)(im) : -1)
116 #define i_maxcolors(im) \
117   (((im)->i_f_maxcolors) ? ((im)->i_f_maxcolors)(im) : -1)
118 #define i_findcolor(im, color, entry) \
119   (((im)->i_f_findcolor) ? ((im)->i_f_findcolor)((im), (color), (entry)) : 0)
120
121 #define i_img_virtual(im) ((im)->virtual)
122 #define i_img_type(im) ((im)->type)
123 #define i_img_bits(im) ((im)->bits)
124
125 /* Generic fills */
126 struct i_fill_tag;
127
128 typedef void (*i_fill_with_color_f)
129      (struct i_fill_tag *fill, int x, int y, int width, int channels, 
130       i_color *data, i_color *work);
131 typedef void (*i_fill_with_fcolor_f)
132      (struct i_fill_tag *fill, int x, int y, int width, int channels,
133       i_fcolor *data, i_fcolor *work);
134 typedef void (*i_fill_destroy_f)(struct i_fill_tag *fill);
135 typedef void (*i_fill_combine_f)(i_color *out, i_color *in, int channels, 
136                                  int count);
137 typedef void (*i_fill_combinef_f)(i_fcolor *out, i_fcolor *in, int channels,
138                                   int count);
139
140
141 typedef struct i_fill_tag
142 {
143   /* called for 8-bit/sample image (and maybe lower) */
144   /* this may be NULL, if so call fill_with_fcolor */
145   i_fill_with_color_f fill_with_color;
146
147   /* called for other sample sizes */
148   /* this must be non-NULL */
149   i_fill_with_fcolor_f fill_with_fcolor;
150
151   /* called if non-NULL to release any extra resources */
152   i_fill_destroy_f destroy;
153
154   /* if non-zero the caller will fill data with the original data
155      from the image */
156   i_fill_combine_f combine;
157   i_fill_combinef_f combinef;
158 } i_fill_t;
159
160 typedef enum {
161   ic_none,
162   ic_normal,
163   ic_multiply,
164   ic_dissolve,
165   ic_add,
166   ic_subtract,
167   ic_diff,
168   ic_lighten,
169   ic_darken,
170   ic_hue,
171   ic_sat,
172   ic_value,
173   ic_color
174 } i_combine_t;
175
176 extern i_fill_t *i_new_fill_solidf(i_fcolor *c, int combine);
177 extern i_fill_t *i_new_fill_solid(i_color *c, int combine);
178 extern i_fill_t *
179 i_new_fill_hatch(i_color *fg, i_color *bg, int combine, int hatch, 
180                  unsigned char *cust_hatch, int dx, int dy);
181 extern i_fill_t *
182 i_new_fill_hatchf(i_fcolor *fg, i_fcolor *bg, int combine, int hatch, 
183                   unsigned char *cust_hatch, int dx, int dy);
184 extern void i_fill_destroy(i_fill_t *fill);
185
186 float i_gpix_pch(i_img *im,int x,int y,int ch);
187
188 /* functions for drawing primitives */
189
190 void i_box         (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
191 void i_box_filled  (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
192 void i_box_cfill(i_img *im, int x1, int y1, int x2, int y2, i_fill_t *fill);
193 void i_draw        (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
194 void i_line_aa     (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
195 void i_arc         (i_img *im,int x,int y,float rad,float d1,float d2,i_color *val);
196 void i_arc_cfill(i_img *im,int x,int y,float rad,float d1,float d2,i_fill_t *fill);
197 void i_circle_aa   (i_img *im,float x, float y,float rad,i_color *val);
198 void i_copyto      (i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty);
199 void i_copyto_trans(i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty,i_color *trans);
200 void i_copy        (i_img *im,i_img *src);
201 int i_rubthru     (i_img *im,i_img *src,int tx,int ty);
202
203 undef_int i_flipxy (i_img *im, int direction);
204 extern i_img *i_rotate90(i_img *im, int degrees);
205 extern i_img *i_rotate_exact(i_img *im, double amount);
206 extern i_img *i_matrix_transform(i_img *im, int xsize, int ysize, double *matrix);
207
208 void i_bezier_multi(i_img *im,int l,double *x,double *y,i_color *val);
209 void i_poly_aa     (i_img *im,int l,double *x,double *y,i_color *val);
210
211 void i_flood_fill  (i_img *im,int seedx,int seedy,i_color *dcol);
212
213 /* image processing functions */
214
215 void i_gaussian    (i_img *im,float stdev);
216 void i_conv        (i_img *im,float *coeff,int len);
217
218 /* colour manipulation */
219 extern int i_convert(i_img *im, i_img *src, float *coeff, int outchan, int inchan);
220 extern void i_map(i_img *im, unsigned char (*maps)[256], unsigned int mask);
221
222 float i_img_diff   (i_img *im1,i_img *im2);
223
224 /* font routines */
225
226 undef_int i_init_fonts( void );
227
228 #ifdef HAVE_LIBT1
229 #include <t1lib.h>
230
231 undef_int init_t1( void );
232 int       i_t1_new( char *pfb, char *afm );
233 int       i_t1_destroy( int font_id );
234 undef_int i_t1_cp( i_img *im, int xb, int yb, int channel, int fontnum, float points, char* str, int len, int align );
235 undef_int i_t1_text( i_img *im, int xb, int yb, i_color *cl, int fontnum, float points, char* str, int len, int align );
236 void      i_t1_bbox( int fontnum, float point, char *str, int len, int cords[6] );
237 void      i_t1_set_aa( int st );
238 void      close_t1( void );
239
240 #endif
241
242 #ifdef HAVE_LIBTT
243
244 #include <freetype.h>
245 #define TT_CHC 5
246
247 struct TT_Instancehandle_ {
248   TT_Instance instance;
249   TT_Instance_Metrics imetrics;
250   TT_Glyph_Metrics gmetrics[256];
251   TT_Glyph glyphs[256];
252   int smooth;
253   int ptsize;
254   int order;
255 };
256
257 typedef struct TT_Instancehandle_ TT_Instancehandle;
258
259 struct TT_Fonthandle_ {
260   TT_Face face;
261   TT_Face_Properties properties;
262   TT_Instancehandle instanceh[TT_CHC];
263   TT_CharMap char_map;
264 };
265
266 typedef struct TT_Fonthandle_ TT_Fonthandle;
267
268
269
270 undef_int init_tt( void );
271 TT_Fonthandle* i_tt_new(char *fontname);
272 void i_tt_destroy( TT_Fonthandle *handle );
273 undef_int i_tt_cp( TT_Fonthandle *handle,i_img *im,int xb,int yb,int channel,float points,char* txt,int len,int smooth);
274 undef_int i_tt_text( TT_Fonthandle *handle, i_img *im, int xb, int yb, i_color *cl, float points, char* txt, int len, int smooth);
275 undef_int i_tt_bbox( TT_Fonthandle *handle, float points,char *txt,int len,int cords[6]);
276
277
278 #endif  /* End of freetype headers */
279
280 #ifdef HAVE_FT2
281
282 typedef struct FT2_Fonthandle FT2_Fonthandle;
283 extern int i_ft2_init(void);
284 extern FT2_Fonthandle * i_ft2_new(char *name, int index);
285 extern void i_ft2_destroy(FT2_Fonthandle *handle);
286 extern int i_ft2_setdpi(FT2_Fonthandle *handle, int xdpi, int ydpi);
287 extern int i_ft2_getdpi(FT2_Fonthandle *handle, int *xdpi, int *ydpi);
288 extern int i_ft2_settransform(FT2_Fonthandle *handle, double *matrix);
289 extern int i_ft2_sethinting(FT2_Fonthandle *handle, int hinting);
290 extern int i_ft2_bbox(FT2_Fonthandle *handle, double cheight, double cwidth, 
291                       char *text, int len, int *bbox);
292 extern int i_ft2_text(FT2_Fonthandle *handle, i_img *im, int tx, int ty, 
293                       i_color *cl, double cheight, double cwidth, 
294                       char *text, int len, int align, int aa, int vlayout,
295                       int utf8);
296 extern int i_ft2_cp(FT2_Fonthandle *handle, i_img *im, int tx, int ty, 
297                     int channel, double cheight, double cwidth, 
298                     char *text, int len, int align, int aa, int vlayout, 
299                     int utf8);
300
301 #endif
302
303 #ifdef WIN32
304
305 extern int i_wf_bbox(char *face, int size, char *text, int length, int *bbox);
306 extern int i_wf_text(char *face, i_img *im, int tx, int ty, i_color *cl, 
307                      int size, char *text, int len, int align, int aa);
308 extern int i_wf_cp(char *face, i_img *im, int tx, int ty, int channel, 
309                    int size, char *text, int len, int align, int aa);
310
311 #endif
312
313 /* functions for reading and writing formats */
314
315 /* general reader callback 
316  userdata - data the user passed into the reader
317  buffer - the buffer to fill with data
318  need - the amount of data needed
319  want - the amount of space we have to store data
320  fill buffer and return the number of bytes read, 0 for eof, -1 for error
321 */
322
323 typedef int (*i_read_callback_t)(char *userdata, char *buffer, int need, 
324                                  int want);
325
326 /* i_gen_reader() translates the low-level requests from whatever library
327    into buffered requests.
328    but the called function can always bypass buffering by only ever 
329    reading I<need> bytes.
330 */
331 #define CBBUFSIZ 4096
332
333 typedef struct {
334   i_read_callback_t cb;
335   char *userdata;
336   char buffer[CBBUFSIZ];
337   int length;
338   int cpos;
339 } i_gen_read_data;
340
341 extern int  i_gen_reader(i_gen_read_data *info, char *buffer, int need);
342 extern      i_gen_read_data *i_gen_read_data_new(i_read_callback_t cb, char *userdata);
343 extern void free_gen_read_data(i_gen_read_data *);
344
345 /* general writer callback
346    userdata - the data the user passed into the writer
347    data - the data to write
348    data_size - the number of bytes to write
349    write the data, return non-zero on success, zero on failure.
350 */
351 typedef int (*i_write_callback_t)(char *userdata, char const *data, int size);
352
353 typedef struct {
354   i_write_callback_t cb;
355   char *userdata;
356   char buffer[CBBUFSIZ];
357   int maxlength;
358   int filledto;
359 } i_gen_write_data;
360
361 extern int i_gen_writer(i_gen_write_data *info, char const *data, int size);
362 extern i_gen_write_data *i_gen_write_data_new(i_write_callback_t cb, char *userdata, int maxlength);
363 extern int free_gen_write_data(i_gen_write_data *, int flush);
364
365 /* transparency handling for quantized output */
366 typedef enum i_transp_tag {
367   tr_none, /* ignore any alpha channel */
368   tr_threshold, /* threshold the transparency - uses tr_threshold */
369   tr_errdiff, /* error diffusion */
370   tr_ordered /* an ordered dither */
371 } i_transp;
372
373 /* controls how we build the colour map */
374 typedef enum i_make_colors_tag {
375   mc_none, /* user supplied colour map only */
376   mc_web_map, /* Use the 216 colour web colour map */
377   mc_addi, /* Addi's algorithm */
378   mc_mask = 0xFF /* (mask for generator) */
379 } i_make_colors;
380
381 /* controls how we translate the colours */
382 typedef enum i_translate_tag {
383   pt_giflib, /* get gif lib to do it (ignores make_colours) */
384   pt_closest, /* just use the closest match within the hashbox */
385   pt_perturb, /* randomly perturb the data - uses perturb_size*/
386   pt_errdiff /* error diffusion dither - uses errdiff */
387 } i_translate;
388
389 /* Which error diffusion map to use */
390 typedef enum i_errdiff_tag {
391   ed_floyd, /* floyd-steinberg */
392   ed_jarvis, /* Jarvis, Judice and Ninke */
393   ed_stucki, /* Stucki */
394   ed_custom, /* the map found in ed_map|width|height|orig */
395   ed_mask = 0xFF, /* mask to get the map */
396   ed_bidir = 0x100 /* change direction for each row */
397 } i_errdiff;
398
399 /* which ordered dither map to use
400    currently only available for transparency
401    I don't know of a way to do ordered dither of an image against some 
402    general palette
403  */
404 typedef enum i_ord_dith_tag
405 {
406   od_random, /* sort of random */
407   od_dot8, /* large dot */
408   od_dot4,
409   od_hline,
410   od_vline,
411   od_slashline, /* / line dither */
412   od_backline, /* \ line dither */
413   od_tiny, /* small checkerbox */
414   od_custom /* custom 8x8 map */
415 } i_ord_dith;
416
417 typedef struct i_gif_pos_tag {
418   int x, y;
419 } i_gif_pos;
420
421 /* passed into i_writegif_gen() to control quantization */
422 typedef struct i_quantize_tag {
423   /* how to handle transparency */
424   i_transp transp;
425   /* the threshold at which to make pixels opaque */
426   int tr_threshold;
427   i_errdiff tr_errdiff;
428   i_ord_dith tr_orddith;
429   unsigned char tr_custom[64];
430   
431   /* how to make the colour map */
432   i_make_colors make_colors;
433
434   /* any existing colours 
435      mc_existing is an existing colour table
436      mc_count is the number of existing colours
437      mc_size is the total size of the array that mc_existing points
438      at - this must be at least 256
439   */
440   i_color *mc_colors;
441   int mc_size;
442   int mc_count;
443
444   /* how we translate the colours */
445   i_translate translate;
446
447   /* the error diffusion map to use if translate is mc_errdiff */
448   i_errdiff errdiff;
449   /* the following define the error diffusion values to use if 
450      errdiff is ed_custom.  ed_orig is the column on the top row that
451      represents the current 
452   */
453   int *ed_map;
454   int ed_width, ed_height, ed_orig;
455
456   /* the amount of perturbation to use for translate is mc_perturb */
457   int perturb;
458 } i_quantize;
459
460 typedef struct i_gif_opts {
461   /* each image has a local color map */
462   int each_palette;
463
464   /* images are interlaced */
465   int interlace;
466
467   /* time for which image is displayed 
468    (in 1/100 seconds)
469    default: 0
470   */
471   int delay_count;
472   int *delays;
473
474   /* user input flags 
475      default: 0
476    */
477   int user_input_count;
478   char *user_input_flags;
479
480   /* disposal
481      default: 0 */
482   int disposal_count;
483   char *disposal;
484
485   /* this is added to the color table when we make an image transparent */
486   i_color tran_color;
487
488   /* image positions */
489   int position_count;
490   i_gif_pos *positions;
491
492   /* Netscape loop extension - number of loops */
493   int loop_count;
494 } i_gif_opts;
495
496 extern void quant_makemap(i_quantize *quant, i_img **imgs, int count);
497 extern i_palidx *quant_translate(i_quantize *quant, i_img *img);
498 extern void quant_transparent(i_quantize *quant, i_palidx *indices, i_img *img, i_palidx trans_index);
499
500 extern i_img *i_img_pal_new(int x, int y, int channels, int maxpal);
501 extern i_img *i_img_pal_new_low(i_img *im, int x, int y, int channels, int maxpal);
502 extern i_img *i_img_to_pal(i_img *src, i_quantize *quant);
503 extern i_img *i_img_to_rgb(i_img *src);
504 extern i_img *i_img_masked_new(i_img *targ, i_img *mask, int x, int y, 
505                                int w, int h);
506 extern i_img *i_img_16_new(int x, int y, int ch);
507 extern i_img *i_img_16_new_low(i_img *im, int x, int y, int ch);
508
509 #ifdef HAVE_LIBJPEG
510 i_img *   
511 i_readjpeg_wiol(io_glue *ig, int length, char** iptc_itext, int *itlength);
512 undef_int i_writejpeg_wiol(i_img *im, io_glue *ig, int qfactor);
513 #endif /* HAVE_LIBJPEG */
514
515 #ifdef HAVE_LIBTIFF
516 i_img   * i_readtiff_wiol(io_glue *ig, int length);
517 undef_int i_writetiff_wiol(i_img *im, io_glue *ig);
518 undef_int i_writetiff_wiol_faxable(i_img *im, io_glue *ig, int fine);
519
520 #endif /* HAVE_LIBTIFF */
521
522 #ifdef HAVE_LIBPNG
523 i_img    *i_readpng_wiol(io_glue *ig, int length);
524 undef_int i_writepng_wiol(i_img *im, io_glue *ig);
525 #endif /* HAVE_LIBPNG */
526
527 #ifdef HAVE_LIBGIF
528 i_img *i_readgif(int fd, int **colour_table, int *colours);
529 i_img *i_readgif_scalar(char *data, int length, int **colour_table, int *colours);
530 i_img *i_readgif_callback(i_read_callback_t callback, char *userdata, int **colour_table, int *colours);
531 extern i_img **i_readgif_multi(int fd, int *count);
532 extern i_img **i_readgif_multi_scalar(char *data, int length, int *count);
533 extern i_img **i_readgif_multi_callback(i_read_callback_t callback, char *userdata, int *count);
534 undef_int i_writegif(i_img *im,int fd,int colors,int pixdev,int fixedlen,i_color fixed[]);
535 undef_int i_writegifmc(i_img *im,int fd,int colors);
536 undef_int i_writegifex(i_img *im,int fd);
537 undef_int i_writegif_gen(i_quantize *quant, int fd, i_img **imgs, int count, i_gif_opts *opts);
538 undef_int i_writegif_callback(i_quantize *quant, i_write_callback_t cb, char *userdata, int maxbuffer, i_img **imgs, int count, i_gif_opts *opts);
539
540 void i_qdist(i_img *im);
541
542 #endif /* HAVE_LIBGIF */
543
544 i_img   * i_readraw_wiol(io_glue *ig, int x, int y, int datachannels, int storechannels, int intrl);
545 undef_int i_writeraw_wiol(i_img* im, io_glue *ig);
546
547 i_img   * i_readpnm_wiol(io_glue *ig, int length);
548 undef_int i_writeppm_wiol(i_img *im, io_glue *ig);
549
550 extern int    i_writebmp_wiol(i_img *im, io_glue *ig);
551 extern i_img *i_readbmp_wiol(io_glue *ig);
552
553 i_img   * i_readtga_wiol(io_glue *ig, int length);
554 undef_int i_writetga_wiol(i_img *im, io_glue *ig);
555
556 i_img * i_scaleaxis(i_img *im, float Value, int Axis);
557 i_img * i_scale_nn(i_img *im, float scx, float scy);
558 i_img * i_haar(i_img *im);
559 int     i_count_colors(i_img *im,int maxc);
560
561 i_img * i_transform(i_img *im, int *opx,int opxl,int *opy,int opyl,double parm[],int parmlen);
562
563 struct rm_op;
564 i_img * i_transform2(int width, int height, int channels,
565                      struct rm_op *ops, int ops_count, 
566                      double *n_regs, int n_regs_count, 
567                      i_color *c_regs, int c_regs_count, 
568                      i_img **in_imgs, int in_imgs_count);
569 /* filters */
570
571 void i_contrast(i_img *im, float intensity);
572 void i_hardinvert(i_img *im);
573 void i_noise(i_img *im, float amount, unsigned char type);
574 void i_bumpmap(i_img *im,i_img *bump,int channel,int light_x,int light_y,int strength);
575 void i_postlevels(i_img *im,int levels);
576 void i_mosaic(i_img *im,int size);
577 void i_watermark(i_img *im,i_img *wmark,int tx,int ty,int pixdiff);
578 void i_autolevels(i_img *im,float lsat,float usat,float skew);
579 void i_radnoise(i_img *im,int xo,int yo,float rscale,float ascale);
580 void i_turbnoise(i_img *im,float xo,float yo,float scale);
581 void i_gradgen(i_img *im, int num, int *xo, int *yo, i_color *ival, int dmeasure);
582 void i_nearest_color(i_img *im, int num, int *xo, int *yo, i_color *ival, int dmeasure);
583 typedef enum {
584   i_fst_linear,
585   i_fst_curved,
586   i_fst_sine,
587   i_fst_sphere_up,
588   i_fst_sphere_down,
589   i_fst_end
590 } i_fountain_seg_type;
591 typedef enum {
592   i_fc_direct,
593   i_fc_hue_up,
594   i_fc_hue_down,
595   i_fc_end
596 } i_fountain_color;
597 typedef struct {
598   double start, middle, end;
599   i_fcolor c[2];
600   i_fountain_seg_type type;
601   i_fountain_color color;
602 } i_fountain_seg;
603 typedef enum {
604   i_fr_none,
605   i_fr_sawtooth,
606   i_fr_triangle,
607   i_fr_saw_both,
608   i_fr_tri_both
609 } i_fountain_repeat;
610 typedef enum {
611   i_ft_linear,
612   i_ft_bilinear,
613   i_ft_radial,
614   i_ft_radial_square,
615   i_ft_revolution,
616   i_ft_conical,
617   i_ft_end
618 } i_fountain_type;
619 typedef enum {
620   i_fts_none,
621   i_fts_grid,
622   i_fts_random,
623   i_fts_circle
624 } i_ft_supersample;
625 void i_fountain(i_img *im, double xa, double ya, double xb, double yb, 
626                 i_fountain_type type, i_fountain_repeat repeat, 
627                 int combine, int super_sample, double ssample_param,
628                 int count, i_fountain_seg *segs);
629 extern i_fill_t *
630 i_new_fill_fount(double xa, double ya, double xb, double yb, 
631                  i_fountain_type type, i_fountain_repeat repeat, 
632                  int combine, int super_sample, double ssample_param, 
633                  int count, i_fountain_seg *segs);
634
635 /* Debug only functions */
636
637 void malloc_state( void );
638
639 /* this is sort of obsolete now */
640
641 typedef struct {
642   undef_int (*i_has_format)(char *frmt);
643   i_color*(*ICL_set)(i_color *cl,unsigned char r,unsigned char g,unsigned char b,unsigned char a);
644   void (*ICL_info)(i_color *cl);
645
646   i_img*(*i_img_new)( void );
647   i_img*(*i_img_empty)(i_img *im,int x,int y);
648   i_img*(*i_img_empty_ch)(i_img *im,int x,int y,int ch);
649   void(*i_img_exorcise)(i_img *im);
650
651   void(*i_img_info)(i_img *im,int *info);
652   
653   void(*i_img_setmask)(i_img *im,int ch_mask);
654   int (*i_img_getmask)(i_img *im);
655   
656   int (*i_ppix)(i_img *im,int x,int y,i_color *val);
657   int (*i_gpix)(i_img *im,int x,int y,i_color *val);
658
659   void(*i_box)(i_img *im,int x1,int y1,int x2,int y2,i_color *val);
660   void(*i_draw)(i_img *im,int x1,int y1,int x2,int y2,i_color *val);
661   void(*i_arc)(i_img *im,int x,int y,float rad,float d1,float d2,i_color *val);
662   void(*i_copyto)(i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty);
663   void(*i_copyto_trans)(i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty,i_color *trans);
664   int(*i_rubthru)(i_img *im,i_img *src,int tx,int ty);
665
666 } symbol_table_t;
667
668 /* error handling 
669    see error.c for documentation
670    the error information is currently global
671 */
672 typedef struct {
673   char *msg;
674   int code;
675 } i_errmsg;
676
677 typedef void (*i_error_cb)(int code, char const *msg);
678 typedef void (*i_failed_cb)(i_errmsg *msgs);
679 extern i_error_cb i_set_error_cb(i_error_cb);
680 extern i_failed_cb i_set_failed_cb(i_failed_cb);
681 extern void i_set_argv0(char const *);
682 extern int i_set_errors_fatal(int new_fatal);
683 extern i_errmsg *i_errors(void);
684
685 extern void i_push_error(int code, char const *msg);
686 extern void i_push_errorf(int code, char const *fmt, ...);
687 extern void i_push_errorvf(int code, char const *fmt, va_list);
688 extern void i_clear_error(void);
689 extern int i_failed(int code, char const *msg);
690
691 /* image tag processing */
692 extern void i_tags_new(i_img_tags *tags);
693 extern int i_tags_addn(i_img_tags *tags, char *name, int code, int idata);
694 extern int i_tags_add(i_img_tags *tags, char *name, int code, char *data, 
695                       int size, int idata);
696 extern void i_tags_destroy(i_img_tags *tags);
697 extern int i_tags_find(i_img_tags *tags, char *name, int start, int *entry);
698 extern int i_tags_findn(i_img_tags *tags, int code, int start, int *entry);
699 extern int i_tags_delete(i_img_tags *tags, int entry);
700 extern int i_tags_delbyname(i_img_tags *tags, char *name);
701 extern int i_tags_delbycode(i_img_tags *tags, int code);
702
703 #endif