potracelib.h

Go to the documentation of this file.

#ifndef POTRACELIB_H
#define POTRACELIB_H

/* ---------------------------------------------------------------------- */
/* tracing parameters */

/* turn policies */
#define POTRACE_TURNPOLICY_BLACK 0
#define POTRACE_TURNPOLICY_WHITE 1
#define POTRACE_TURNPOLICY_LEFT 2
#define POTRACE_TURNPOLICY_RIGHT 3
#define POTRACE_TURNPOLICY_MINORITY 4
#define POTRACE_TURNPOLICY_MAJORITY 5
#define POTRACE_TURNPOLICY_RANDOM 6

struct potrace_progress_s
{
  void (*callback) (double progress, void *privdata);
  void *data; 
  double min, max; 
  double epsilon; 
};
typedef struct potrace_progress_s potrace_progress_t;

struct potrace_param_s
{
  int turdsize; 
  int turnpolicy; 
  double alphamax; 
  int opticurve; 
  double opttolerance; 
  potrace_progress_t progress; 
};
typedef struct potrace_param_s potrace_param_t;

/* ---------------------------------------------------------------------- */
/* bitmaps */

typedef unsigned long potrace_word;

struct potrace_bitmap_s
{
  int w; 
  int h; 
  int dy; 
  potrace_word *map; 
};
typedef struct potrace_bitmap_s potrace_bitmap_t;

/* ---------------------------------------------------------------------- */
/* curves */

struct potrace_dpoint_s
{
  double x, y;
};
typedef struct potrace_dpoint_s potrace_dpoint_t;

/* segment tags */
#define POTRACE_CURVETO 1
#define POTRACE_CORNER 2

struct potrace_curve_s
{
  int n; 
  int *tag; 
    potrace_dpoint_t (*c)[3];
};
typedef struct potrace_curve_s potrace_curve_t;

struct potrace_path_s
{
  int area; 
  int sign; 
  potrace_curve_t curve; 
  struct potrace_path_s *next; 
  struct potrace_path_s *childlist; 
  struct potrace_path_s *sibling; 
  struct potrace_privpath_s *priv; 
};
typedef struct potrace_path_s potrace_path_t;

/* ---------------------------------------------------------------------- */

#define POTRACE_STATUS_OK         0
#define POTRACE_STATUS_INCOMPLETE 1

struct potrace_state_s
{
  int status;
  potrace_path_t *plist; 
  struct potrace_privstate_s *priv; 
};
typedef struct potrace_state_s potrace_state_t;

/* ---------------------------------------------------------------------- */
/* API functions */

potrace_param_t *potrace_param_default (void);

void potrace_param_free (potrace_param_t * p);

potrace_state_t *potrace_trace (const potrace_param_t * param,
                                const potrace_bitmap_t * bm);

void potrace_state_free (potrace_state_t * st);

char *potrace_version (void);

#endif /* POTRACELIB_H */