imager.h

   1 #ifndef _IMAGE_H_
   2 #define _IMAGE_H_
   3
   4 #include "imconfig.h"
   5 #include "immacros.h"
   6 #include "imio.h"
   7 #include "iolayer.h"
   8 #include "stackmach.h"
   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 "imdatatypes.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        (const 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 *im_img_8_new(pIMCTX, i_img_dim x,i_img_dim y,int ch);
  51 #define i_img_empty(im, x, y) i_img_empty_ch((im), (x), (y), 3)
  52 i_img *im_img_empty_ch(pIMCTX, i_img *im,i_img_dim x,i_img_dim y,int ch);
  53 #define i_img_empty_ch(im, x, y, ch) im_img_empty_ch(aIMCTX, (im), (x), (y), (ch))
  54 void   i_img_exorcise(i_img *im);
  55 void   i_img_destroy(i_img *im);
  56 i_img *im_img_alloc(pIMCTX);
  57 void im_img_init(pIMCTX, i_img *im);
  58
  59 void   i_img_info(i_img *im,i_img_dim *info);
  60
  61 extern i_img *i_sametype(i_img *im, i_img_dim xsize, i_img_dim ysize);
  62 extern i_img *i_sametype_chans(i_img *im, i_img_dim xsize, i_img_dim ysize, int channels);
  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 i_img_dim i_img_get_width(i_img *im);
  70 i_img_dim i_img_get_height(i_img *im);
  71
  72 /* Base functions */
  73
  74 extern int (i_ppix)(i_img *im,i_img_dim x,i_img_dim y, const i_color *val);
  75 extern int (i_gpix)(i_img *im,i_img_dim x,i_img_dim y,i_color *val);
  76 extern int (i_ppixf)(i_img *im,i_img_dim x,i_img_dim y, const i_fcolor *val);
  77 extern int (i_gpixf)(i_img *im,i_img_dim x,i_img_dim y,i_fcolor *val);
  78
  79 extern i_img_dim (i_plin)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y,
  80                           const i_color *vals);
  81 extern i_img_dim (i_glin)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y,
  82                           i_color *vals);
  83 extern i_img_dim (i_plinf)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y,
  84                            const i_fcolor *vals);
  85 extern i_img_dim (i_glinf)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y,
  86                            i_fcolor *vals);
  87 extern i_img_dim (i_gsamp)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y,
  88                            i_sample_t *samp, const int *chans, int chan_count);
  89 extern i_img_dim
  90 (i_gsampf)(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_fsample_t *samp,
  91            const int *chans, int chan_count);
  92 extern i_img_dim
  93 (i_gpal)(i_img *im, i_img_dim x, i_img_dim r, i_img_dim y, i_palidx *vals);
  94 extern i_img_dim
  95 (i_ppal)(i_img *im, i_img_dim x, i_img_dim r, i_img_dim y, const i_palidx *vals);
  96 extern int (i_addcolors)(i_img *im, const i_color *colors, int count);
  97 extern int (i_getcolors)(i_img *im, int i, i_color *, int count);
  98 extern int (i_colorcount)(i_img *im);
  99 extern int (i_maxcolors)(i_img *im);
 100 extern int (i_findcolor)(i_img *im, const i_color *color, i_palidx *entry);
 101 extern int (i_setcolors)(i_img *im, int index, const i_color *colors,
 102                        int count);
 103
 104
 105 extern i_fill_t *i_new_fill_solidf(const i_fcolor *c, int combine);
 106 extern i_fill_t *i_new_fill_solid(const i_color *c, int combine);
 107 extern i_fill_t *
 108 i_new_fill_hatch(const i_color *fg, const i_color *bg, int combine, int hatch,
 109                  const unsigned char *cust_hatch, i_img_dim dx, i_img_dim dy);
 110 extern i_fill_t *
 111 i_new_fill_hatchf(const i_fcolor *fg, const i_fcolor *bg, int combine, int hatch,
 112                   const unsigned char *cust_hatch, i_img_dim dx, i_img_dim dy);
 113 extern i_fill_t *
 114 i_new_fill_image(i_img *im, const double *matrix, i_img_dim xoff, i_img_dim yoff, int combine);
 115 extern i_fill_t *i_new_fill_opacity(i_fill_t *, double alpha_mult);
 116 extern void i_fill_destroy(i_fill_t *fill);
 117
 118 float i_gpix_pch(i_img *im,i_img_dim x,i_img_dim y,int ch);
 119
 120 /* functions for drawing primitives */
 121
 122 void i_box         (i_img *im,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,const i_color *val);
 123 void i_box_filled  (i_img *im,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,const i_color *val);
 124 int i_box_filledf  (i_img *im,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,const i_fcolor *val);
 125 void i_box_cfill(i_img *im, i_img_dim x1, i_img_dim y1, i_img_dim x2, i_img_dim y2, i_fill_t *fill);
 126 void i_line        (i_img *im,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,const i_color *val, int endp);
 127 void i_line_aa     (i_img *im,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,const i_color *val, int endp);
 128 void i_arc         (i_img *im,i_img_dim x,i_img_dim y,double rad,double d1,double d2,const i_color *val);
 129 int i_arc_out(i_img *im,i_img_dim x,i_img_dim y,i_img_dim rad,double d1,double d2,const i_color *val);
 130 int i_arc_out_aa(i_img *im,i_img_dim x,i_img_dim y,i_img_dim rad,double d1,double d2,const i_color *val);
 131 void i_arc_aa         (i_img *im, double x, double y, double rad, double d1, double d2, const i_color *val);
 132 void i_arc_cfill(i_img *im,i_img_dim x,i_img_dim y,double rad,double d1,double d2,i_fill_t *fill);
 133 void i_arc_aa_cfill(i_img *im,double x,double y,double rad,double d1,double d2,i_fill_t *fill);
 134 void i_circle_aa   (i_img *im,double x, double y,double rad,const i_color *val);
 135 int i_circle_out   (i_img *im,i_img_dim x, i_img_dim y, i_img_dim rad,const i_color *val);
 136 int i_circle_out_aa   (i_img *im,i_img_dim x, i_img_dim y, i_img_dim rad,const i_color *val);
 137 void i_copyto      (i_img *im,i_img *src,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,i_img_dim tx,i_img_dim ty);
 138 void i_copyto_trans(i_img *im,i_img *src,i_img_dim x1,i_img_dim y1,i_img_dim x2,i_img_dim y2,i_img_dim tx,i_img_dim ty,const i_color *trans);
 139 i_img* i_copy        (i_img *src);
 140 int  i_rubthru     (i_img *im, i_img *src, i_img_dim tx, i_img_dim ty, i_img_dim src_minx, i_img_dim src_miny, i_img_dim src_maxx, i_img_dim src_maxy);
 141 extern int
 142 i_compose_mask(i_img *out, i_img *src, i_img *mask,
 143                i_img_dim out_left, i_img_dim out_top, i_img_dim src_left, i_img_dim src_top,
 144                i_img_dim mask_left, i_img_dim mask_top, i_img_dim width, i_img_dim height,
 145                int combine, double opacity);
 146 extern int
 147 i_compose(i_img *out, i_img *src,
 148                i_img_dim out_left, i_img_dim out_top, i_img_dim src_left, i_img_dim src_top,
 149                i_img_dim width, i_img_dim height, int combine, double opacity);
 150
 151 extern i_img *
 152 i_combine(i_img **src, const int *channels, int in_count);
 153
 154 undef_int i_flipxy (i_img *im, int direction);
 155 extern i_img *i_rotate90(i_img *im, int degrees);
 156 extern i_img *i_rotate_exact(i_img *im, double amount);
 157 extern i_img *i_rotate_exact_bg(i_img *im, double amount, const i_color *backp, const i_fcolor *fbackp);
 158 extern i_img *i_matrix_transform(i_img *im, i_img_dim xsize, i_img_dim ysize, const double *matrix);
 159 extern i_img *i_matrix_transform_bg(i_img *im, i_img_dim xsize, i_img_dim ysize, const double *matrix,  const i_color *backp, const i_fcolor *fbackp);
 160
 161 void i_bezier_multi(i_img *im,int l,const double *x,const double *y,const i_color *val);
 162 int i_poly_aa     (i_img *im,int l,const double *x,const double *y,const i_color *val);
 163 int i_poly_aa_cfill(i_img *im,int l,const double *x,const double *y,i_fill_t *fill);
 164
 165 undef_int i_flood_fill  (i_img *im,i_img_dim seedx,i_img_dim seedy, const i_color *dcol);
 166 undef_int i_flood_cfill(i_img *im, i_img_dim seedx, i_img_dim seedy, i_fill_t *fill);
 167 undef_int i_flood_fill_border  (i_img *im,i_img_dim seedx,i_img_dim seedy, const i_color *dcol, const i_color *border);
 168 undef_int i_flood_cfill_border(i_img *im, i_img_dim seedx, i_img_dim seedy, i_fill_t *fill, const i_color *border);
 169
 170
 171 /* image processing functions */
 172
 173 int i_gaussian    (i_img *im, double stdev);
 174 int i_conv        (i_img *im,const double *coeff,int len);
 175 void i_unsharp_mask(i_img *im, double stddev, double scale);
 176
 177 /* colour manipulation */
 178 extern i_img *i_convert(i_img *src, const double *coeff, int outchan, int inchan);
 179 extern void i_map(i_img *im, unsigned char (*maps)[256], unsigned int mask);
 180
 181 float i_img_diff   (i_img *im1,i_img *im2);
 182 double i_img_diffd(i_img *im1,i_img *im2);
 183 int i_img_samef(i_img *im1,i_img *im2, double epsilon, const char *what);
 184
 185 /* font routines */
 186
 187 #ifdef HAVE_LIBTT
 188
 189 extern void i_tt_start(void);
 190
 191 TT_Fonthandle* i_tt_new(const char *fontname);
 192 void i_tt_destroy( TT_Fonthandle *handle );
 193 undef_int i_tt_cp( TT_Fonthandle *handle,i_img *im,i_img_dim xb,i_img_dim yb,int channel,double points,char const* txt,size_t len,int smooth, int utf8, int align);
 194 undef_int i_tt_text( TT_Fonthandle *handle, i_img *im, i_img_dim xb, i_img_dim yb, const i_color *cl, double points, char const* txt, size_t len, int smooth, int utf8, int align);
 195 undef_int i_tt_bbox( TT_Fonthandle *handle, double points,const char *txt,size_t len,i_img_dim cords[6], int utf8);
 196 size_t i_tt_has_chars(TT_Fonthandle *handle, char const *text, size_t len, int utf8, char *out);
 197 void i_tt_dump_names(TT_Fonthandle *handle);
 198 size_t i_tt_face_name(TT_Fonthandle *handle, char *name_buf,
 199                    size_t name_buf_size);
 200 size_t i_tt_glyph_name(TT_Fonthandle *handle, unsigned long ch, char *name_buf,
 201                     size_t name_buf_size);
 202
 203 #endif  /* End of freetype headers */
 204
 205 extern void i_quant_makemap(i_quantize *quant, i_img **imgs, int count);
 206 extern i_palidx *i_quant_translate(i_quantize *quant, i_img *img);
 207 extern void i_quant_transparent(i_quantize *quant, i_palidx *indices, i_img *img, i_palidx trans_index);
 208
 209 i_img *im_img_pal_new(pIMCTX, i_img_dim x, i_img_dim y, int ch, int maxpal);
 210
 211 extern i_img *i_img_to_pal(i_img *src, i_quantize *quant);
 212 extern i_img *i_img_to_rgb(i_img *src);
 213 extern i_img *i_img_masked_new(i_img *targ, i_img *mask, i_img_dim x, i_img_dim y,
 214                                i_img_dim w, i_img_dim h);
 215 extern i_img *im_img_16_new(pIMCTX, i_img_dim x, i_img_dim y, int ch);
 216 extern i_img *i_img_to_rgb16(i_img *im);
 217 extern i_img *im_img_double_new(pIMCTX, i_img_dim x, i_img_dim y, int ch);
 218 extern i_img *i_img_to_drgb(i_img *im);
 219
 220 extern int i_img_is_monochrome(i_img *im, int *zero_is_white);
 221 extern int i_get_file_background(i_img *im, i_color *bg);
 222 extern int i_get_file_backgroundf(i_img *im, i_fcolor *bg);
 223
 224 const char * i_test_format_probe(io_glue *data, int length);
 225
 226
 227 i_img   * i_readraw_wiol(io_glue *ig, i_img_dim x, i_img_dim y, int datachannels, int storechannels, int intrl);
 228 undef_int i_writeraw_wiol(i_img* im, io_glue *ig);
 229
 230 i_img   * i_readpnm_wiol(io_glue *ig, int allow_incomplete);
 231 i_img   ** i_readpnm_multi_wiol(io_glue *ig, int *count, int allow_incomplete);
 232 undef_int i_writeppm_wiol(i_img *im, io_glue *ig);
 233
 234 extern int    i_writebmp_wiol(i_img *im, io_glue *ig);
 235 extern i_img *i_readbmp_wiol(io_glue *ig, int allow_incomplete);
 236
 237 int tga_header_verify(unsigned char headbuf[18]);
 238
 239 i_img   * i_readtga_wiol(io_glue *ig, int length);
 240 undef_int i_writetga_wiol(i_img *img, io_glue *ig, int wierdpack, int compress, char *idstring, size_t idlen);
 241
 242 i_img   * i_readrgb_wiol(io_glue *ig, int length);
 243 undef_int i_writergb_wiol(i_img *img, io_glue *ig, int wierdpack, int compress, char *idstring, size_t idlen);
 244
 245 i_img * i_scaleaxis(i_img *im, double Value, int Axis);
 246 i_img * i_scale_nn(i_img *im, double scx, double scy);
 247 i_img * i_scale_mixing(i_img *src, i_img_dim width, i_img_dim height);
 248 i_img * i_haar(i_img *im);
 249 int     i_count_colors(i_img *im,int maxc);
 250 int i_get_anonymous_color_histo(i_img *im, unsigned int **col_usage, int maxc);
 251
 252 i_img * i_transform(i_img *im, int *opx, int opxl, int *opy,int opyl,double parm[],int parmlen);
 253
 254 struct rm_op;
 255 i_img * i_transform2(i_img_dim width, i_img_dim height, int channels,
 256                      struct rm_op *ops, int ops_count,
 257                      double *n_regs, int n_regs_count,
 258                      i_color *c_regs, int c_regs_count,
 259                      i_img **in_imgs, int in_imgs_count);
 260
 261 /* filters */
 262
 263 void i_contrast(i_img *im, float intensity);
 264 void i_hardinvert(i_img *im);
 265 void i_hardinvertall(i_img *im);
 266 void i_noise(i_img *im, float amount, unsigned char type);
 267 void i_bumpmap(i_img *im,i_img *bump,int channel,i_img_dim light_x,i_img_dim light_y,i_img_dim strength);
 268 void i_bumpmap_complex(i_img *im, i_img *bump, int channel, i_img_dim tx, i_img_dim ty, double Lx, double Ly,
 269                        double Lz, float cd, float cs, float n, i_color *Ia, i_color *Il, i_color *Is);
 270 void i_postlevels(i_img *im,int levels);
 271 void i_mosaic(i_img *im,i_img_dim size);
 272 void i_watermark(i_img *im,i_img *wmark,i_img_dim tx,i_img_dim ty,int pixdiff);
 273 void i_autolevels(i_img *im,float lsat,float usat,float skew);
 274 void i_autolevels_mono(i_img *im,float lsat,float usat);
 275 void i_radnoise(i_img *im,i_img_dim xo,i_img_dim yo,double rscale,double ascale);
 276 void i_turbnoise(i_img *im,double xo,double yo,double scale);
 277 void i_gradgen(i_img *im, int num, i_img_dim *xo, i_img_dim *yo, i_color *ival, int dmeasure);
 278 int i_nearest_color(i_img *im, int num, i_img_dim *xo, i_img_dim *yo, i_color *ival, int dmeasure);
 279 i_img *i_diff_image(i_img *im, i_img *im2, double mindist);
 280 int
 281 i_fountain(i_img *im, double xa, double ya, double xb, double yb,
 282            i_fountain_type type, i_fountain_repeat repeat,
 283            int combine, int super_sample, double ssample_param,
 284            int count, i_fountain_seg *segs);
 285 extern i_fill_t *
 286 i_new_fill_fount(double xa, double ya, double xb, double yb,
 287                  i_fountain_type type, i_fountain_repeat repeat,
 288                  int combine, int super_sample, double ssample_param,
 289                  int count, i_fountain_seg *segs);
 290
 291 /* Debug only functions */
 292
 293 void malloc_state( void );
 294
 295 #include "imerror.h"
 296
 297 /* image tag processing */
 298 extern void i_tags_new(i_img_tags *tags);
 299 extern int i_tags_addn(i_img_tags *tags, char const *name, int code,
 300                        int idata);
 301 extern int i_tags_add(i_img_tags *tags, char const *name, int code,
 302                       char const *data, int size, int idata);
 303 extern int i_tags_set(i_img_tags *tags, char const *name,
 304                       char const *data, int size);
 305 extern int i_tags_setn(i_img_tags *tags, char const *name, int idata);
 306
 307 extern void i_tags_destroy(i_img_tags *tags);
 308 extern int i_tags_find(i_img_tags *tags, char const *name, int start,
 309                        int *entry);
 310 extern int i_tags_findn(i_img_tags *tags, int code, int start, int *entry);
 311 extern int i_tags_delete(i_img_tags *tags, int entry);
 312 extern int i_tags_delbyname(i_img_tags *tags, char const *name);
 313 extern int i_tags_delbycode(i_img_tags *tags, int code);
 314 extern int i_tags_get_float(i_img_tags *tags, char const *name, int code,
 315                             double *value);
 316 extern int i_tags_set_float(i_img_tags *tags, char const *name, int code,
 317                             double value);
 318 extern int i_tags_set_float2(i_img_tags *tags, char const *name, int code,
 319                             double value, int places);
 320 extern int i_tags_get_int(i_img_tags *tags, char const *name, int code,
 321                           int *value);
 322 extern int i_tags_get_string(i_img_tags *tags, char const *name, int code,
 323                              char *value, size_t value_size);
 324 extern int i_tags_get_color(i_img_tags *tags, char const *name, int code,
 325                             i_color *value);
 326 extern int i_tags_set_color(i_img_tags *tags, char const *name, int code,
 327                             i_color const *value);
 328 extern void i_tags_print(i_img_tags *tags);
 329
 330 /* image file limits */
 331 extern int
 332 im_set_image_file_limits(im_context_t ctx, i_img_dim width, i_img_dim height, size_t bytes);
 333 extern int
 334 im_get_image_file_limits(im_context_t ctx, i_img_dim *width, i_img_dim *height, size_t *bytes);
 335 extern int
 336 im_int_check_image_file_limits(im_context_t ctx, i_img_dim width, i_img_dim height, int channels, size_t sample_size);
 337
 338 /* memory allocation */
 339 void* mymalloc(size_t size);
 340 void  myfree(void *p);
 341 void* myrealloc(void *p, size_t newsize);
 342 void* mymalloc_file_line (size_t size, char* file, int line);
 343 void  myfree_file_line   (void *p, char*file, int line);
 344 void* myrealloc_file_line(void *p, size_t newsize, char* file,int line);
 345
 346 #ifdef IMAGER_DEBUG_MALLOC
 347
 348 #define mymalloc(x) (mymalloc_file_line((x), __FILE__, __LINE__))
 349 #define myrealloc(x,y) (myrealloc_file_line((x),(y), __FILE__, __LINE__))
 350 #define myfree(x) (myfree_file_line((x), __FILE__, __LINE__))
 351
 352 void  malloc_state       (void);
 353 void  bndcheck_all       (void);
 354
 355 #else
 356
 357 void  malloc_state(void);
 358
 359 #endif /* IMAGER_MALLOC_DEBUG */
 360
 361 #include "imrender.h"
 362
 363 extern void
 364 i_adapt_colors(int dest_channels, int src_channels, i_color *colors,
 365                size_t count);
 366 extern void
 367 i_adapt_fcolors(int dest_channels, int src_channels, i_fcolor *colors,
 368                size_t count);
 369
 370 extern void
 371 i_adapt_colors_bg(int dest_channels, int src_channels, i_color *colors,
 372                   size_t count, i_color const *bg);
 373 extern void
 374 i_adapt_fcolors_bg(int dest_channels, int src_channels, i_fcolor *colors,
 375                    size_t count, i_fcolor const *bg);
 376
 377 extern int
 378 i_gsamp_bg(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_sample_t *samples,
 379            int out_channels, i_color const *bg);
 380
 381 extern int
 382 i_gsampf_bg(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_fsample_t *samples,
 383            int out_channels, i_fcolor const *bg);
 384
 385 /* context object management */
 386 extern im_context_t im_context_new(void);
 387 extern void im_context_refinc(im_context_t ctx, const char *where);
 388 extern void im_context_refdec(im_context_t ctx, const char *where);
 389 extern im_context_t im_context_clone(im_context_t ctx, const char *where);
 390 extern im_slot_t im_context_slot_new(im_slot_destroy_t);
 391 extern void *im_context_slot_get(im_context_t ctx, im_slot_t slot);
 392 extern int im_context_slot_set(im_context_t ctx, im_slot_t slot, void *);
 393
 394 extern im_context_t (*im_get_context)(void);
 395
 396 /* mutex API */
 397 extern i_mutex_t i_mutex_new(void);
 398 extern void i_mutex_destroy(i_mutex_t m);
 399 extern void i_mutex_lock(i_mutex_t m);
 400 extern void i_mutex_unlock(i_mutex_t m);
 401
 402 #include "imio.h"
 403
 404 #endif