23 #define PI 3.14159265358979323846
27 #define MAXINT 2147483647
30 #include "datatypes.h"
32 undef_int i_has_format(char *frmt);
34 /* constructors and destructors */
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);
42 extern i_fcolor *i_fcolor_new(double r, double g, double b, double a);
43 extern void i_fcolor_destroy(i_fcolor *cl);
45 extern void i_rgb_to_hsvf(i_fcolor *color);
46 extern void i_hsv_to_rgbf(i_fcolor *color);
48 i_img *IIM_new(int x,int y,int ch);
49 void IIM_DESTROY(i_img *im);
50 i_img *i_img_new( void );
51 i_img *i_img_empty(i_img *im,int x,int y);
52 i_img *i_img_empty_ch(i_img *im,int x,int y,int ch);
53 void i_img_exorcise(i_img *im);
54 void i_img_destroy(i_img *im);
56 void i_img_info(i_img *im,int *info);
58 extern i_img *i_sametype(i_img *im, int xsize, int ysize);
60 i_img *i_img_pal_new(int x, int y, int ch, int maxpal);
62 /* Image feature settings */
64 void i_img_setmask (i_img *im,int ch_mask);
65 int i_img_getmask (i_img *im);
66 int i_img_getchannels(i_img *im);
70 int i_ppix(i_img *im,int x,int y,i_color *val);
71 int i_gpix(i_img *im,int x,int y,i_color *val);
72 int i_ppixf(i_img *im,int x,int y,i_color *val);
73 int i_gpixf(i_img *im,int x,int y,i_color *val);
75 #define i_ppix(im, x, y, val) (((im)->i_f_ppix)((im), (x), (y), (val)))
76 #define i_gpix(im, x, y, val) (((im)->i_f_gpix)((im), (x), (y), (val)))
77 #define i_ppixf(im, x, y, val) (((im)->i_f_ppixf)((im), (x), (y), (val)))
78 #define i_gpixf(im, x, y, val) (((im)->i_f_gpixf)((im), (x), (y), (val)))
81 int i_ppix_d(i_img *im,int x,int y,i_color *val);
82 int i_gpix_d(i_img *im,int x,int y,i_color *val);
83 int i_plin_d(i_img *im,int l, int r, int y, i_color *val);
84 int i_glin_d(i_img *im,int l, int r, int y, i_color *val);
87 #define i_plin(im, l, r, y, val) (((im)->i_f_plin)(im, l, r, y, val))
88 #define i_glin(im, l, r, y, val) (((im)->i_f_glin)(im, l, r, y, val))
89 #define i_plinf(im, l, r, y, val) (((im)->i_f_plinf)(im, l, r, y, val))
90 #define i_glinf(im, l, r, y, val) (((im)->i_f_glinf)(im, l, r, y, val))
92 #define i_gsamp(im, l, r, y, samps, chans, count) \
93 (((im)->i_f_gsamp)((im), (l), (r), (y), (samps), (chans), (count)))
94 #define i_gsampf(im, l, r, y, samps, chans, count) \
95 (((im)->i_f_gsampf)((im), (l), (r), (y), (samps), (chans), (count)))
97 #define i_findcolor(im, color, entry) \
98 (((im)->i_f_findcolor) ? ((im)->i_f_findcolor)((im), (color), (entry)) : 0)
100 #define i_gpal(im, l, r, y, vals) \
101 (((im)->i_f_gpal) ? ((im)->i_f_gpal)((im), (l), (r), (y), (vals)) : 0)
102 #define i_ppal(im, l, r, y, vals) \
103 (((im)->i_f_ppal) ? ((im)->i_f_ppal)((im), (l), (r), (y), (vals)) : 0)
104 #define i_addcolors(im, colors, count) \
105 (((im)->i_f_addcolors) ? ((im)->i_f_addcolors)((im), (colors), (count)) : -1)
106 #define i_getcolors(im, index, color, count) \
107 (((im)->i_f_getcolors) ? \
108 ((im)->i_f_getcolors)((im), (index), (color), (count)) : 0)
109 #define i_setcolors(im, index, color, count) \
110 (((im)->i_f_setcolors) ? \
111 ((im)->i_f_setcolors)((im), (index), (color), (count)) : 0)
112 #define i_colorcount(im) \
113 (((im)->i_f_colorcount) ? ((im)->i_f_colorcount)(im) : -1)
114 #define i_maxcolors(im) \
115 (((im)->i_f_maxcolors) ? ((im)->i_f_maxcolors)(im) : -1)
116 #define i_findcolor(im, color, entry) \
117 (((im)->i_f_findcolor) ? ((im)->i_f_findcolor)((im), (color), (entry)) : 0)
119 #define i_img_virtual(im) ((im)->virtual)
120 #define i_img_type(im) ((im)->type)
121 #define i_img_bits(im) ((im)->bits)
126 typedef void (*i_fill_with_color_f)
127 (struct i_fill_tag *fill, int x, int y, int width, int channels,
129 typedef void (*i_fill_with_fcolor_f)
130 (struct i_fill_tag *fill, int x, int y, int width, int channels,
132 typedef void (*i_fill_destroy_f)(struct i_fill_tag *fill);
134 typedef struct i_fill_tag
136 /* called for 8-bit/sample image (and maybe lower) */
137 /* this may be NULL, if so call fill_with_fcolor */
138 i_fill_with_color_f fill_with_color;
140 /* called for other sample sizes */
141 /* this must be non-NULL */
142 i_fill_with_fcolor_f fill_with_fcolor;
144 /* called if non-NULL to release any extra resources */
145 i_fill_destroy_f destroy;
147 /* if non-zero the caller will fill data with the original data
152 extern i_fill_t *i_new_fill_solidf(i_fcolor *c, int combine);
153 extern i_fill_t *i_new_fill_solid(i_color *c, int combine);
155 i_new_fill_hatch(i_color *fg, i_color *bg, int combine, int hatch,
156 unsigned char *cust_hatch, int dx, int dy);
158 i_new_fill_hatchf(i_fcolor *fg, i_fcolor *bg, int combine, int hatch,
159 unsigned char *cust_hatch, int dx, int dy);
160 extern void i_fill_destroy(i_fill_t *fill);
162 float i_gpix_pch(i_img *im,int x,int y,int ch);
164 /* functions for drawing primitives */
166 void i_box (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
167 void i_box_filled (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
168 void i_box_cfill(i_img *im, int x1, int y1, int x2, int y2, i_fill_t *fill);
169 void i_draw (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
170 void i_line_aa (i_img *im,int x1,int y1,int x2,int y2,i_color *val);
171 void i_arc (i_img *im,int x,int y,float rad,float d1,float d2,i_color *val);
172 void i_arc_cfill(i_img *im,int x,int y,float rad,float d1,float d2,i_fill_t *fill);
173 void i_circle_aa (i_img *im,float x, float y,float rad,i_color *val);
174 void i_copyto (i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty);
175 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);
176 void i_copy (i_img *im,i_img *src);
177 int i_rubthru (i_img *im,i_img *src,int tx,int ty);
179 undef_int i_flipxy (i_img *im, int direction);
180 extern i_img *i_rotate90(i_img *im, int degrees);
181 extern i_img *i_rotate_exact(i_img *im, double amount);
182 extern i_img *i_matrix_transform(i_img *im, int xsize, int ysize, double *matrix);
184 void i_bezier_multi(i_img *im,int l,double *x,double *y,i_color *val);
185 void i_poly_aa (i_img *im,int l,double *x,double *y,i_color *val);
187 void i_flood_fill (i_img *im,int seedx,int seedy,i_color *dcol);
189 /* image processing functions */
191 void i_gaussian (i_img *im,float stdev);
192 void i_conv (i_img *im,float *coeff,int len);
194 /* colour manipulation */
195 extern int i_convert(i_img *im, i_img *src, float *coeff, int outchan, int inchan);
196 extern void i_map(i_img *im, unsigned char (*maps)[256], unsigned int mask);
198 float i_img_diff (i_img *im1,i_img *im2);
202 undef_int i_init_fonts( void );
207 undef_int init_t1( void );
208 int i_t1_new( char *pfb, char *afm );
209 int i_t1_destroy( int font_id );
210 undef_int i_t1_cp( i_img *im, int xb, int yb, int channel, int fontnum, float points, char* str, int len, int align );
211 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 );
212 void i_t1_bbox( int fontnum, float point, char *str, int len, int cords[6] );
213 void i_t1_set_aa( int st );
214 void close_t1( void );
220 #include <freetype.h>
223 struct TT_Instancehandle_ {
224 TT_Instance instance;
225 TT_Instance_Metrics imetrics;
226 TT_Glyph_Metrics gmetrics[256];
227 TT_Glyph glyphs[256];
233 typedef struct TT_Instancehandle_ TT_Instancehandle;
235 struct TT_Fonthandle_ {
237 TT_Face_Properties properties;
238 TT_Instancehandle instanceh[TT_CHC];
242 typedef struct TT_Fonthandle_ TT_Fonthandle;
246 undef_int init_tt( void );
247 TT_Fonthandle* i_tt_new(char *fontname);
248 void i_tt_destroy( TT_Fonthandle *handle );
249 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);
250 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);
251 undef_int i_tt_bbox( TT_Fonthandle *handle, float points,char *txt,int len,int cords[6]);
254 #endif /* End of freetype headers */
258 typedef struct FT2_Fonthandle FT2_Fonthandle;
259 extern int i_ft2_init(void);
260 extern FT2_Fonthandle * i_ft2_new(char *name, int index);
261 extern void i_ft2_destroy(FT2_Fonthandle *handle);
262 extern int i_ft2_setdpi(FT2_Fonthandle *handle, int xdpi, int ydpi);
263 extern int i_ft2_getdpi(FT2_Fonthandle *handle, int *xdpi, int *ydpi);
264 extern int i_ft2_settransform(FT2_Fonthandle *handle, double *matrix);
265 extern int i_ft2_sethinting(FT2_Fonthandle *handle, int hinting);
266 extern int i_ft2_bbox(FT2_Fonthandle *handle, double cheight, double cwidth,
267 char *text, int len, int *bbox);
268 extern int i_ft2_text(FT2_Fonthandle *handle, i_img *im, int tx, int ty,
269 i_color *cl, double cheight, double cwidth,
270 char *text, int len, int align, int aa, int vlayout,
272 extern int i_ft2_cp(FT2_Fonthandle *handle, i_img *im, int tx, int ty,
273 int channel, double cheight, double cwidth,
274 char *text, int len, int align, int aa, int vlayout,
281 extern int i_wf_bbox(char *face, int size, char *text, int length, int *bbox);
282 extern int i_wf_text(char *face, i_img *im, int tx, int ty, i_color *cl,
283 int size, char *text, int len, int align, int aa);
284 extern int i_wf_cp(char *face, i_img *im, int tx, int ty, int channel,
285 int size, char *text, int len, int align, int aa);
289 /* functions for reading and writing formats */
291 /* general reader callback
292 userdata - data the user passed into the reader
293 buffer - the buffer to fill with data
294 need - the amount of data needed
295 want - the amount of space we have to store data
296 fill buffer and return the number of bytes read, 0 for eof, -1 for error
299 typedef int (*i_read_callback_t)(char *userdata, char *buffer, int need,
302 /* i_gen_reader() translates the low-level requests from whatever library
303 into buffered requests.
304 but the called function can always bypass buffering by only ever
305 reading I<need> bytes.
307 #define CBBUFSIZ 4096
310 i_read_callback_t cb;
312 char buffer[CBBUFSIZ];
317 extern int i_gen_reader(i_gen_read_data *info, char *buffer, int need);
318 extern i_gen_read_data *i_gen_read_data_new(i_read_callback_t cb, char *userdata);
319 extern void free_gen_read_data(i_gen_read_data *);
321 /* general writer callback
322 userdata - the data the user passed into the writer
323 data - the data to write
324 data_size - the number of bytes to write
325 write the data, return non-zero on success, zero on failure.
327 typedef int (*i_write_callback_t)(char *userdata, char const *data, int size);
330 i_write_callback_t cb;
332 char buffer[CBBUFSIZ];
337 extern int i_gen_writer(i_gen_write_data *info, char const *data, int size);
338 extern i_gen_write_data *i_gen_write_data_new(i_write_callback_t cb, char *userdata, int maxlength);
339 extern int free_gen_write_data(i_gen_write_data *, int flush);
341 /* transparency handling for quantized output */
342 typedef enum i_transp_tag {
343 tr_none, /* ignore any alpha channel */
344 tr_threshold, /* threshold the transparency - uses tr_threshold */
345 tr_errdiff, /* error diffusion */
346 tr_ordered /* an ordered dither */
349 /* controls how we build the colour map */
350 typedef enum i_make_colors_tag {
351 mc_none, /* user supplied colour map only */
352 mc_web_map, /* Use the 216 colour web colour map */
353 mc_addi, /* Addi's algorithm */
354 mc_mask = 0xFF /* (mask for generator) */
357 /* controls how we translate the colours */
358 typedef enum i_translate_tag {
359 pt_giflib, /* get gif lib to do it (ignores make_colours) */
360 pt_closest, /* just use the closest match within the hashbox */
361 pt_perturb, /* randomly perturb the data - uses perturb_size*/
362 pt_errdiff /* error diffusion dither - uses errdiff */
365 /* Which error diffusion map to use */
366 typedef enum i_errdiff_tag {
367 ed_floyd, /* floyd-steinberg */
368 ed_jarvis, /* Jarvis, Judice and Ninke */
369 ed_stucki, /* Stucki */
370 ed_custom, /* the map found in ed_map|width|height|orig */
371 ed_mask = 0xFF, /* mask to get the map */
372 ed_bidir = 0x100 /* change direction for each row */
375 /* which ordered dither map to use
376 currently only available for transparency
377 I don't know of a way to do ordered dither of an image against some
380 typedef enum i_ord_dith_tag
382 od_random, /* sort of random */
383 od_dot8, /* large dot */
387 od_slashline, /* / line dither */
388 od_backline, /* \ line dither */
389 od_tiny, /* small checkerbox */
390 od_custom /* custom 8x8 map */
393 typedef struct i_gif_pos_tag {
397 /* passed into i_writegif_gen() to control quantization */
398 typedef struct i_quantize_tag {
399 /* how to handle transparency */
401 /* the threshold at which to make pixels opaque */
403 i_errdiff tr_errdiff;
404 i_ord_dith tr_orddith;
405 unsigned char tr_custom[64];
407 /* how to make the colour map */
408 i_make_colors make_colors;
410 /* any existing colours
411 mc_existing is an existing colour table
412 mc_count is the number of existing colours
413 mc_size is the total size of the array that mc_existing points
414 at - this must be at least 256
420 /* how we translate the colours */
421 i_translate translate;
423 /* the error diffusion map to use if translate is mc_errdiff */
425 /* the following define the error diffusion values to use if
426 errdiff is ed_custom. ed_orig is the column on the top row that
427 represents the current
430 int ed_width, ed_height, ed_orig;
432 /* the amount of perturbation to use for translate is mc_perturb */
436 typedef struct i_gif_opts {
437 /* each image has a local color map */
440 /* images are interlaced */
443 /* time for which image is displayed
453 int user_input_count;
454 char *user_input_flags;
461 /* this is added to the color table when we make an image transparent */
464 /* image positions */
466 i_gif_pos *positions;
468 /* Netscape loop extension - number of loops */
472 extern void quant_makemap(i_quantize *quant, i_img **imgs, int count);
473 extern i_palidx *quant_translate(i_quantize *quant, i_img *img);
474 extern void quant_transparent(i_quantize *quant, i_palidx *indices, i_img *img, i_palidx trans_index);
476 extern i_img *i_img_pal_new(int x, int y, int channels, int maxpal);
477 extern i_img *i_img_pal_new_low(i_img *im, int x, int y, int channels, int maxpal);
478 extern i_img *i_img_to_pal(i_img *src, i_quantize *quant);
479 extern i_img *i_img_to_rgb(i_img *src);
480 extern i_img *i_img_masked_new(i_img *targ, i_img *mask, int x, int y,
482 extern i_img *i_img_16_new(int x, int y, int ch);
483 extern i_img *i_img_16_new_low(i_img *im, int x, int y, int ch);
487 i_readjpeg_wiol(io_glue *ig, int length, char** iptc_itext, int *itlength);
488 undef_int i_writejpeg_wiol(i_img *im, io_glue *ig, int qfactor);
489 #endif /* HAVE_LIBJPEG */
492 i_img * i_readtiff_wiol(io_glue *ig, int length);
493 undef_int i_writetiff_wiol(i_img *im, io_glue *ig);
494 undef_int i_writetiff_wiol_faxable(i_img *im, io_glue *ig, int fine);
496 #endif /* HAVE_LIBTIFF */
499 i_img *i_readpng_wiol(io_glue *ig, int length);
500 undef_int i_writepng_wiol(i_img *im, io_glue *ig);
501 #endif /* HAVE_LIBPNG */
504 i_img *i_readgif(int fd, int **colour_table, int *colours);
505 i_img *i_readgif_scalar(char *data, int length, int **colour_table, int *colours);
506 i_img *i_readgif_callback(i_read_callback_t callback, char *userdata, int **colour_table, int *colours);
507 extern i_img **i_readgif_multi(int fd, int *count);
508 extern i_img **i_readgif_multi_scalar(char *data, int length, int *count);
509 extern i_img **i_readgif_multi_callback(i_read_callback_t callback, char *userdata, int *count);
510 undef_int i_writegif(i_img *im,int fd,int colors,int pixdev,int fixedlen,i_color fixed[]);
511 undef_int i_writegifmc(i_img *im,int fd,int colors);
512 undef_int i_writegifex(i_img *im,int fd);
513 undef_int i_writegif_gen(i_quantize *quant, int fd, i_img **imgs, int count, i_gif_opts *opts);
514 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);
516 void i_qdist(i_img *im);
518 #endif /* HAVE_LIBGIF */
520 i_img * i_readraw_wiol(io_glue *ig, int x, int y, int datachannels, int storechannels, int intrl);
521 undef_int i_writeraw_wiol(i_img* im, io_glue *ig);
523 i_img * i_readpnm_wiol(io_glue *ig, int length);
524 undef_int i_writeppm_wiol(i_img *im, io_glue *ig);
526 extern int i_writebmp_wiol(i_img *im, io_glue *ig);
527 extern i_img *i_readbmp_wiol(io_glue *ig);
529 i_img * i_scaleaxis(i_img *im, float Value, int Axis);
530 i_img * i_scale_nn(i_img *im, float scx, float scy);
531 i_img * i_haar(i_img *im);
532 int i_count_colors(i_img *im,int maxc);
534 i_img * i_transform(i_img *im, int *opx,int opxl,int *opy,int opyl,double parm[],int parmlen);
537 i_img * i_transform2(int width, int height, int channels,
538 struct rm_op *ops, int ops_count,
539 double *n_regs, int n_regs_count,
540 i_color *c_regs, int c_regs_count,
541 i_img **in_imgs, int in_imgs_count);
544 void i_contrast(i_img *im, float intensity);
545 void i_hardinvert(i_img *im);
546 void i_noise(i_img *im, float amount, unsigned char type);
547 void i_bumpmap(i_img *im,i_img *bump,int channel,int light_x,int light_y,int strength);
548 void i_postlevels(i_img *im,int levels);
549 void i_mosaic(i_img *im,int size);
550 void i_watermark(i_img *im,i_img *wmark,int tx,int ty,int pixdiff);
551 void i_autolevels(i_img *im,float lsat,float usat,float skew);
552 void i_radnoise(i_img *im,int xo,int yo,float rscale,float ascale);
553 void i_turbnoise(i_img *im,float xo,float yo,float scale);
554 void i_gradgen(i_img *im, int num, int *xo, int *yo, i_color *ival, int dmeasure);
555 void i_nearest_color(i_img *im, int num, int *xo, int *yo, i_color *ival, int dmeasure);
563 } i_fountain_seg_type;
571 double start, middle, end;
573 i_fountain_seg_type type;
574 i_fountain_color color;
598 void i_fountain(i_img *im, double xa, double ya, double xb, double yb,
599 i_fountain_type type, i_fountain_repeat repeat,
600 int combine, int super_sample, double ssample_param,
601 int count, i_fountain_seg *segs);
603 i_new_fill_fount(double xa, double ya, double xb, double yb,
604 i_fountain_type type, i_fountain_repeat repeat,
605 int combine, int super_sample, double ssample_param,
606 int count, i_fountain_seg *segs);
608 /* Debug only functions */
610 void malloc_state( void );
612 /* this is sort of obsolete now */
615 undef_int (*i_has_format)(char *frmt);
616 i_color*(*ICL_set)(i_color *cl,unsigned char r,unsigned char g,unsigned char b,unsigned char a);
617 void (*ICL_info)(i_color *cl);
619 i_img*(*i_img_new)( void );
620 i_img*(*i_img_empty)(i_img *im,int x,int y);
621 i_img*(*i_img_empty_ch)(i_img *im,int x,int y,int ch);
622 void(*i_img_exorcise)(i_img *im);
624 void(*i_img_info)(i_img *im,int *info);
626 void(*i_img_setmask)(i_img *im,int ch_mask);
627 int (*i_img_getmask)(i_img *im);
629 int (*i_ppix)(i_img *im,int x,int y,i_color *val);
630 int (*i_gpix)(i_img *im,int x,int y,i_color *val);
632 void(*i_box)(i_img *im,int x1,int y1,int x2,int y2,i_color *val);
633 void(*i_draw)(i_img *im,int x1,int y1,int x2,int y2,i_color *val);
634 void(*i_arc)(i_img *im,int x,int y,float rad,float d1,float d2,i_color *val);
635 void(*i_copyto)(i_img *im,i_img *src,int x1,int y1,int x2,int y2,int tx,int ty);
636 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);
637 int(*i_rubthru)(i_img *im,i_img *src,int tx,int ty);
642 see error.c for documentation
643 the error information is currently global
650 typedef void (*i_error_cb)(int code, char const *msg);
651 typedef void (*i_failed_cb)(i_errmsg *msgs);
652 extern i_error_cb i_set_error_cb(i_error_cb);
653 extern i_failed_cb i_set_failed_cb(i_failed_cb);
654 extern void i_set_argv0(char const *);
655 extern int i_set_errors_fatal(int new_fatal);
656 extern i_errmsg *i_errors(void);
658 extern void i_push_error(int code, char const *msg);
659 extern void i_push_errorf(int code, char const *fmt, ...);
660 extern void i_push_errorvf(int code, char const *fmt, va_list);
661 extern void i_clear_error(void);
662 extern int i_failed(int code, char const *msg);
664 /* image tag processing */
665 extern void i_tags_new(i_img_tags *tags);
666 extern int i_tags_addn(i_img_tags *tags, char *name, int code, int idata);
667 extern int i_tags_add(i_img_tags *tags, char *name, int code, char *data,
668 int size, int idata);
669 extern void i_tags_destroy(i_img_tags *tags);
670 extern int i_tags_find(i_img_tags *tags, char *name, int start, int *entry);
671 extern int i_tags_findn(i_img_tags *tags, int code, int start, int *entry);
672 extern int i_tags_delete(i_img_tags *tags, int entry);
673 extern int i_tags_delbyname(i_img_tags *tags, char *name);
674 extern int i_tags_delbycode(i_img_tags *tags, int code);