# util

Utility functions. More...

## Defines

#define | STP_DBG_LUT 0x1
#define | STP_DBG_COLORFUNC 0x2
#define | STP_DBG_INK 0x4
#define | STP_DBG_PS 0x8
#define | STP_DBG_PCL 0x10
#define | STP_DBG_ESCP2 0x20
#define | STP_DBG_CANON 0x40
#define | STP_DBG_LEXMARK 0x80
#define | STP_DBG_WEAVE_PARAMS 0x100
#define | STP_DBG_ROWS 0x200
#define | STP_DBG_MARK_FILE 0x400
#define | STP_DBG_LIST 0x800
#define | STP_DBG_MODULE 0x1000
#define | STP_DBG_PATH 0x2000
#define | STP_DBG_PAPER 0x4000
#define | STP_DBG_PRINTERS 0x8000
#define | STP_DBG_XML 0x10000
#define | STP_DBG_VARS 0x20000
#define | STP_DBG_OLYMPUS 0x40000
#define | STP_DBG_CURVE 0x80000
#define | STP_DBG_CURVE_ERRORS 0x100000
#define | STP_SAFE_FREE(x)

## Functions

int | stp_init (void)
| Initialise libgimpprint.
const char * | stp_set_output_codeset (const char *codeset)
| Set the output encoding.
stp_curve_t * | stp_read_and_compose_curves (const char *s1, const char *s2, stp_curve_compose_t comp, size_t piecewise_point_count)
void | stp_abort (void)
void | stp_prune_inactive_options (stp_vars_t *v)
void | stp_zprintf (const stp_vars_t *v, const char *format,...) __attribute__((format(__printf__
void void | stp_zfwrite (const char *buf, size_t bytes, size_t nitems, const stp_vars_t *v)
void | stp_putc (int ch, const stp_vars_t *v)
void | stp_put16_le (unsigned short sh, const stp_vars_t *v)
void | stp_put16_be (unsigned short sh, const stp_vars_t *v)
void | stp_put32_le (unsigned int sh, const stp_vars_t *v)
void | stp_put32_be (unsigned int sh, const stp_vars_t *v)
void | stp_puts (const char *s, const stp_vars_t *v)
void | stp_send_command (const stp_vars_t *v, const char *command, const char *format,...)
void | stp_erputc (int ch)
void | stp_eprintf (const stp_vars_t *v, const char *format,...) __attribute__((format(__printf__
void void | stp_erprintf (const char *format,...) __attribute__((format(__printf__
void void void | stp_asprintf (char **strp, const char *format,...) __attribute__((format(__printf__
void void void void | stp_catprintf (char **strp, const char *format,...) __attribute__((format(__printf__
unsigned long | stp_get_debug_level (void)
void | stp_dprintf (unsigned long level, const stp_vars_t *v, const char *format,...) __attribute__((format(__printf__
void void | stp_deprintf (unsigned long level, const char *format,...) __attribute__((format(__printf__
void void void | stp_init_debug_messages (stp_vars_t *v)
void | stp_flush_debug_messages (stp_vars_t *v)
void * | stp_malloc (size_t)
void * | stp_zalloc (size_t)
void * | stp_realloc (void *ptr, size_t)
void | stp_free (void *ptr)
size_t | stp_strlen (const char *s)
char * | stp_strndup (const char *s, int n)
char * | stp_strdup (const char *s)
const char * | stp_get_version (void)
| Get the library version string (x.y.z).
const char * | stp_get_release_version (void)
| Get the library release version string (x.y).

## Detailed Description

Utility functions.

## Define Documentation

#define STP_DBG_CANON 0x40

#define STP_DBG_COLORFUNC 0x2

#define STP_DBG_CURVE 0x80000

#define STP_DBG_CURVE_ERRORS 0x100000

#define STP_DBG_ESCP2 0x20

#define STP_DBG_INK 0x4

#define STP_DBG_LEXMARK 0x80

#define STP_DBG_LIST 0x800

#define STP_DBG_LUT 0x1

#define STP_DBG_MARK_FILE 0x400

#define STP_DBG_MODULE 0x1000

#define STP_DBG_OLYMPUS 0x40000

#define STP_DBG_PAPER 0x4000

#define STP_DBG_PATH 0x2000

#define STP_DBG_PCL 0x10

#define STP_DBG_PRINTERS 0x8000

#define STP_DBG_PS 0x8

#define STP_DBG_ROWS 0x200

#define STP_DBG_VARS 0x20000

#define STP_DBG_WEAVE_PARAMS 0x100

#define STP_DBG_XML 0x10000

#define STP_SAFE_FREE | ( | x |  | ) |

Value:

    do                                              \
    {                                               \
      if ((x))                                      \
        stp_free((char *)(x));                      \
      ((x)) = NULL;                                 \
    } while (0)

## Function Documentation

void stp_abort | ( | void |  | ) |

void void void stp_asprintf | ( | char ** | strp,
|  | const char * | format,
|  |  | ...
| ) |

void void void void stp_catprintf | ( | char ** | strp,
|  | const char * | format,
|  |  | ...
| ) |

void void stp_deprintf | ( | unsigned long | level,
|  | const char * | format,
|  |  | ...
| ) |

void stp_dprintf | ( | unsigned long | level,
|  | const stp_vars_t * | v,
|  | const char * | format,
|  |  | ...
| ) |

void stp_eprintf | ( | const stp_vars_t * | v,
|  | const char * | format,
|  |  | ...
| ) |

void void stp_erprintf | ( | const char * | format,
|  |  | ...
| ) |

void stp_erputc | ( | int | ch | ) |

void stp_flush_debug_messages | ( | stp_vars_t * | v | ) |

void stp_free | ( | void * | ptr | ) |

unsigned long stp_get_debug_level | ( | void |  | ) |

const char* stp_get_release_version | ( | void |  | ) |

Get the library release version string (x.y).

Returns:
  a pointer to the release name of the package, which must not be modified or freed.

const char* stp_get_version | ( | void |  | ) |

Get the library version string (x.y.z).

Returns:
  a pointer to the version name of the package, which must not be modified or freed.

int stp_init | ( | void |  | ) |

Initialise libgimpprint.

This function must be called prior to any other use of the library. It is responsible for loading modules and XML data and initialising internal data structures.

Returns:
  0 on success, 1 on failure.

void void void stp_init_debug_messages | ( | stp_vars_t * | v | ) |

void* stp_malloc | ( | size_t |  | ) |

void stp_prune_inactive_options | ( | stp_vars_t * | v | ) |

void stp_put16_be | ( | unsigned short | sh,
|  | const stp_vars_t * | v
| ) |

void stp_put16_le | ( | unsigned short | sh,
|  | const stp_vars_t * | v
| ) |

void stp_put32_be | ( | unsigned int | sh,
|  | const stp_vars_t * | v
| ) |

void stp_put32_le | ( | unsigned int | sh,
|  | const stp_vars_t * | v
| ) |

void stp_putc | ( | int | ch,
|  | const stp_vars_t * | v
| ) |

void stp_puts | ( | const char * | s,
|  | const stp_vars_t * | v
| ) |

stp_curve_t* stp_read_and_compose_curves | ( | const char * | s1,
|  | const char * | s2,
|  | stp_curve_compose_t | comp,
|  | size_t | piecewise_point_count
| ) |

void* stp_realloc | ( | void * | ptr,
|  | size_t |
| ) |

void stp_send_command | ( | const stp_vars_t * | v,
|  | const char * | command,
|  | const char * | format,
|  |  | ...
| ) |

const char* stp_set_output_codeset | ( | const char * | codeset | ) |

Set the output encoding.

This function sets the encoding that all strings translated by gettext are output in. It is a wrapper around the gettext bind_textdomain_codeset() function.

Parameters:

  | codeset | the standard name of the encoding, which must be usable with iconv_open(). For example, "US-ASCII" or "UTF-8". If NULL, the currently-selected codeset will be returned (or NULL if no codeset has been selected yet).

Returns:
  a string containing the selected codeset, or NULL on failure (errno is set accordingly).

char* stp_strdup | ( | const char * | s | ) |

size_t stp_strlen | ( | const char * | s | ) |

char* stp_strndup | ( | const char * | s,
|  | int | n
| ) |

void* stp_zalloc | ( | size_t |  | ) |

void void stp_zfwrite | ( | const char * | buf,
|  | size_t | bytes,
|  | size_t | nitems,
|  | const stp_vars_t * | v
| ) |

void stp_zprintf | ( | const stp_vars_t * | v,
|  | const char * | format,
|  |  | ...
| ) |