SIOX_DEFAULT_SMOOTHNESS

#define SIOX_DEFAULT_SMOOTHNESS     3

SIOX_DEFAULT_SENSITIVITY_L

#define SIOX_DEFAULT_SENSITIVITY_L  0.64

SIOX_DEFAULT_SENSITIVITY_A

#define SIOX_DEFAULT_SENSITIVITY_A  1.28

SIOX_DEFAULT_SENSITIVITY_B

#define SIOX_DEFAULT_SENSITIVITY_B  2.56

SIOX_DRB_ADD

#define SIOX_DRB_ADD                0

SIOX_DRB_SUBTRACT

#define SIOX_DRB_SUBTRACT           1

SioxState

typedef struct _SioxState SioxState;

SioxProgressFunc ()

void                (*SioxProgressFunc)                 (gpointer progress_data,
                                                         gdouble fraction);

siox_init ()

SioxState*          siox_init                           (TileManager *pixels,
                                                         const guchar *colormap,
                                                         gint offset_x,
                                                         gint offset_y,
                                                         gint x,
                                                         gint y,
                                                         gint width,
                                                         gint height);

Initializes the SIOX segmentator. Creates and returns a SioxState struct that has to be passed to all function calls of this module as it maintaines the state.

siox_foreground_extract ()

void                siox_foreground_extract             (SioxState *state,
                                                         SioxRefinementType refinement,
                                                         TileManager *mask,
                                                         gint x1,
                                                         gint y1,
                                                         gint x2,
                                                         gint y2,
                                                         gint smoothness,
                                                         const gdouble sensitivity[3],
                                                         gboolean multiblob,
                                                         SioxProgressFunc progress_callback,
                                                         gpointer progress_data);

Writes the resulting segmentation into mask. The region of interest as specified using x1, y1, x2 and y2 defines the bounding box of the background and undecided areas. No changes to the mask are done outside this rectangle.

siox_done ()

void                siox_done                           (SioxState *state);

Frees the memory assciated with the state.

siox_drb ()

void                siox_drb                            (SioxState *state,
                                                         TileManager *mask,
                                                         gint x,
                                                         gint y,
                                                         gint brush_radius,
                                                         gint brush_mode,
                                                         gfloat threshold);

drb - detail refinement brush, a brush mask for subpixel classification.

FIXME: Now it is assumed that the brush is a square. Should be able to be whatever GIMP offers. TODO: This is still an experimental method. There are more tests needed to evaluate performance of this!