/*
 *   libgimpprint header.
 *
 *   Copyright 1997-2000 Michael Sweet (mike@easysw.com) and
 *	Robert Krawitz (rlk@alum.mit.edu)
 *
 *   This program is free software; you can redistribute it and/or modify it
 *   under the terms of the GNU General Public License as published by the Free
 *   Software Foundation; either version 2 of the License, or (at your option)
 *   any later version.
 *
 *   This program is distributed in the hope that it will be useful, but
 *   WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 *   or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 *   for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 *
 * Revision History:
 *
 *   See ChangeLog
 */

/**
 * @file gutenprint/weave.h
 * @brief Softweave functions.
 */

/*
 * This file must include only standard C header files.  The core code must
 * compile on generic platforms that don't support glib, gimp, gtk, etc.
 */

#ifndef GUTENPRINT_WEAVE_H
#define GUTENPRINT_WEAVE_H

#ifdef __cplusplus
extern "C" {
#endif

#ifdef HAVE_CONFIG_H
#include <config.h>
#endif

#define STP_MAX_WEAVE (16)


typedef struct			/* Weave parameters for a specific row */
{
  int row;			/* Absolute row # */
  int pass;			/* Computed pass # */
  int jet;			/* Which physical nozzle we're using */
  int missingstartrows;		/* Phantom rows (nonexistent rows that */
				/* would be printed by nozzles lower than */
				/* the first nozzle we're using this pass; */
				/* with the current algorithm, always zero */
  int logicalpassstart;		/* Offset in rows (from start of image) */
				/* that the printer must be for this row */
				/* to print correctly with the specified jet */
  int physpassstart;		/* Offset in rows to the first row printed */
				/* in this pass.  Currently always equal to */
				/* logicalpassstart */
  int physpassend;		/* Offset in rows (from start of image) to */
				/* the last row that will be printed this */
				/* pass (assuming that we're printing a full */
				/* pass). */
} stp_weave_t;

typedef struct			/* Weave parameters for a specific pass */
{
  int pass;			/* Absolute pass number */
  int missingstartrows;		/* All other values the same as weave_t */
  int logicalpassstart;
  int physpassstart;
  int physpassend;
  int subpass;
} stp_pass_t;

typedef struct {		/* Offsets from the start of each line */
  int ncolors;
  unsigned long *v;		/* (really pass) */
} stp_lineoff_t;

typedef struct {		/* Is this line (really pass) active? */
  int ncolors;
  char *v;
} stp_lineactive_t;

typedef struct {		/* number of rows for a pass */
  int ncolors;
  int *v;
} stp_linecount_t;

typedef struct {		/* Base pointers for each pass */
  int ncolors;
  unsigned char **v;
} stp_linebufs_t;

typedef struct {		/* Width of data actually printed */
  int ncolors;
  int *start_pos;
  int *end_pos;
} stp_linebounds_t;

typedef enum {
  STP_WEAVE_ZIGZAG,
  STP_WEAVE_ASCENDING,
  STP_WEAVE_DESCENDING,
  STP_WEAVE_ASCENDING_2X,
  STP_WEAVE_STAGGERED,
  STP_WEAVE_ASCENDING_3X
} stp_weave_strategy_t;

typedef int stp_packfunc(stp_vars_t *v,
			 const unsigned char *line, int height,
			 unsigned char *comp_buf,
			 unsigned char **comp_ptr,
			 int *first, int *last);
typedef void stp_fillfunc(stp_vars_t *v, int row, int subpass,
			  int width, int missingstartrows, int color);
typedef void stp_flushfunc(stp_vars_t *v, int passno, int vertical_subpass);
typedef int stp_compute_linewidth_func(stp_vars_t *v, int n);

extern void stp_initialize_weave(stp_vars_t *v, int jets, int separation,
				 int oversample, int horizontal,
				 int vertical, int ncolors, int bitwidth,
				 int linewidth, int line_count,
				 int first_line, int page_height,
				 const int *head_offset,
				 stp_weave_strategy_t,
				 stp_flushfunc,
				 stp_fillfunc,
				 stp_packfunc,
				 stp_compute_linewidth_func);

extern stp_packfunc stp_pack_tiff;
extern stp_packfunc stp_pack_uncompressed;

extern stp_fillfunc stp_fill_tiff;
extern stp_fillfunc stp_fill_uncompressed;

extern stp_compute_linewidth_func stp_compute_tiff_linewidth;
extern stp_compute_linewidth_func stp_compute_uncompressed_linewidth;

extern void stp_flush_all(stp_vars_t *v);

extern void
stp_write_weave(stp_vars_t *v, unsigned char *const cols[]);

extern stp_lineoff_t *
stp_get_lineoffsets_by_pass(const stp_vars_t *v, int pass);

extern stp_lineactive_t *
stp_get_lineactive_by_pass(const stp_vars_t *v, int pass);

extern stp_linecount_t *
stp_get_linecount_by_pass(const stp_vars_t *v, int pass);

extern const stp_linebufs_t *
stp_get_linebases_by_pass(const stp_vars_t *v, int pass);

extern stp_pass_t *
stp_get_pass_by_pass(const stp_vars_t *v, int pass);

extern void
stp_weave_parameters_by_row(const stp_vars_t *v, int row,
			    int vertical_subpass, stp_weave_t *w);

#ifdef __cplusplus
  }
#endif

#endif /* GUTENPRINT_WEAVE_H */
