Main Page   Modules   Alphabetical List   Data Structures   File List   Data Fields   Globals  

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_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_tstp_read_and_compose_curves (const char *s1, const char *s2, stp_curve_compose_t comp)
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 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 stp_erprintf (const char *format,...) __attribute__((format(__printf__
void stp_asprintf (char **strp, const char *format,...) __attribute__((format(__printf__
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 stp_deprintf (unsigned long level, const char *format,...) __attribute__((format(__printf__
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)

Detailed Description

Utility functions.


Define Documentation

#define STP_DBG_CANON   0x40
 

Definition at line 110 of file util.h.

Referenced by canon_density(), canon_do_print(), canon_get_model_capabilities(), canon_inks(), canon_parameters(), canon_printhead_colors(), canon_printhead_type(), canon_size_type(), canon_source_type(), and canon_write().

#define STP_DBG_COLORFUNC   0x2
 

Definition at line 105 of file util.h.

Referenced by stp_color_register(), and stp_color_unregister().

#define STP_DBG_ESCP2   0x20
 

Definition at line 109 of file util.h.

Referenced by escp2_find_resolution().

#define STP_DBG_INK   0x4
 

Definition at line 106 of file util.h.

Referenced by set_raw_ink_type(), stp_channel_set_black_channel(), stp_channel_set_cutoff_adjustment(), stp_channel_set_density_adjustment(), stp_channel_set_ink_limit(), stp_dither_set_inks_full(), stpi_dither_finalize_ranges(), and stpi_dither_set_ranges().

#define STP_DBG_LEXMARK   0x80
 

Definition at line 111 of file util.h.

#define STP_DBG_LIST   0x800
 

Definition at line 115 of file util.h.

Referenced by stp_list_create(), stp_list_destroy(), stp_list_item_create(), stp_list_item_destroy(), and stp_list_node_free_data().

#define STP_DBG_LUT   0x1
 

Definition at line 104 of file util.h.

Referenced by setup_channel(), and stpi_compute_lut().

#define STP_DBG_MARK_FILE   0x400
 

Definition at line 114 of file util.h.

Referenced by escp2_set_remote_sequence().

#define STP_DBG_MODULE   0x1000
 

Definition at line 116 of file util.h.

Referenced by stp_module_init(), stp_module_open(), and stp_module_register().

#define STP_DBG_OLYMPUS   0x40000
 

Definition at line 122 of file util.h.

Referenced by olympus_do_print(), and olympus_get_model_capabilities().

#define STP_DBG_PAPER   0x4000
 

Definition at line 118 of file util.h.

Referenced by stp_verify_printer_params(), and stpi_paper_create().

#define STP_DBG_PATH   0x2000
 

Definition at line 117 of file util.h.

Referenced by stp_path_search(), and stpi_path_check().

#define STP_DBG_PCL   0x10
 

Definition at line 108 of file util.h.

Referenced by internal_imageable_area(), pcl_convert_media_size(), pcl_do_print(), pcl_parameters(), pcl_printfunc(), pcl_string_to_val(), pcl_val_to_string(), and pcl_val_to_text().

#define STP_DBG_PRINTERS   0x8000
 

Definition at line 119 of file util.h.

Referenced by stp_family_register(), stp_family_unregister(), and stp_initialize_printer_defaults().

#define STP_DBG_PS   0x8
 

Definition at line 107 of file util.h.

Referenced by ps_imageable_area_internal(), ps_media_size_internal(), and ps_print_internal().

#define STP_DBG_ROWS   0x200
 

Definition at line 113 of file util.h.

Referenced by finalize_row().

#define STP_DBG_VARS   0x20000
 

Definition at line 121 of file util.h.

Referenced by stp_set_default_string_parameter(), stp_set_string_parameter(), stp_set_string_parameter_n(), stp_verify_parameter(), stp_verify_printer_params(), verify_curve_param(), verify_double_param(), verify_int_param(), and verify_string_param().

#define STP_DBG_WEAVE_PARAMS   0x100
 

Definition at line 112 of file util.h.

Referenced by calculate_pass_map(), and weave_parameters_by_row().

#define STP_DBG_XML   0x10000
 

Definition at line 120 of file util.h.

Referenced by stp_curve_create_from_file(), stp_curve_create_from_stream(), stp_curve_create_from_string(), stp_printer_create_from_xmltree(), stp_sequence_create_from_xmltree(), stp_xml_dither_cache_get(), stp_xml_dither_cache_set(), stp_xml_init_defaults(), stp_xml_parse_file(), stp_xml_parse_file_named(), stp_xml_process_dither_matrix(), stp_xml_process_paper(), stpi_dither_array_create_from_file(), and stpi_xml_process_family().

#define STP_SAFE_FREE  
 

Value:

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

Definition at line 139 of file util.h.

Referenced by clear_a_channel(), free_eventone_data(), free_lut(), invalidate_auxilliary_data(), shared_ed_deinitializer(), stp_dither_set_ink_spread(), stp_vars_destroy(), stpi_channel_clear(), stpi_dither_channel_destroy(), stpi_dither_free(), stpi_dither_set_ranges(), and stpi_paper_freefunc().


Function Documentation

void stp_abort void   
 

Definition at line 613 of file print-util.c.

Referenced by add_to_row(), check_array(), check_color(), check_curve(), check_sequence(), compute_gcr_curve(), null_list(), null_printer(), null_vars(), stp_dither_init(), stp_malloc(), and stp_realloc().

void stp_asprintf char **    strp,
const char *    format,
...   
 

Definition at line 100 of file print-util.c.

void stp_catprintf char **    strp,
const char *    format,
...   
 

Definition at line 109 of file print-util.c.

void stp_deprintf unsigned long    level,
const char *    format,
...   
 

Definition at line 341 of file print-util.c.

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

Definition at line 327 of file print-util.c.

void stp_eprintf const stp_vars_t   v,
const char *    format,
...   
 

Definition at line 267 of file print-util.c.

void stp_erprintf const char *    format,
...   
 

Definition at line 293 of file print-util.c.

void stp_erputc int    ch
 

Definition at line 287 of file print-util.c.

Referenced by lexmark_do_print().

void stp_flush_debug_messages stp_vars_t   v
 

Definition at line 379 of file print-util.c.

References debug_msgbuf_t::bytes, debug_msgbuf_t::data, debug_msgbuf_t::odata, debug_msgbuf_t::ofunc, stp_eprintf(), stp_free(), stp_get_errdata(), stp_get_verified(), stp_set_errdata(), stp_set_errfunc(), and stp_set_verified().

Referenced by setup_inks(), and stpi_dither_set_ranges().

void stp_free void *    ptr
 

Definition at line 435 of file print-util.c.

References stpi_free_func.

Referenced by canon_cmd(), canon_do_print(), compdata_freefunc(), compute_a_curve_fast(), compute_a_curve_full(), compute_gcr_curve(), compute_intervals(), compute_spline_deltas(), escp2_do_print(), escp2_print_data(), escp2_print_page(), free_list_element(), free_lut(), insert_subchannel(), invalidate_auxiliary_data(), invert_curve(), invert_map(), lexmark_do_print(), olympus_do_print(), pcl_do_print(), print_debug_params(), ps_print_internal(), raw_print(), send_extra_data(), sequence_dtor(), set_long_name_cache(), set_name_cache(), set_raw_parameter(), stp_array_destroy(), stp_catprintf(), stp_curve_compose(), stp_curve_destroy(), stp_curve_resample(), stp_curve_rescale(), stp_dither_matrix_destroy(), stp_dither_matrix_shear(), stp_dither_set_inks(), stp_dither_set_inks_simple(), stp_dprintf(), stp_eprintf(), stp_flush_debug_messages(), stp_initialize_weave(), stp_list_destroy(), stp_list_item_create(), stp_list_item_destroy(), stp_list_node_free_data(), stp_printer_create_from_xmltree(), stp_sequence_destroy(), stp_sequence_set_data(), stp_sequence_set_size(), stp_vars_destroy(), stp_verify_printer_params(), stp_xml_process_paper(), stp_xmltree_create_from_curve(), stp_xmltree_create_from_sequence(), stp_zprintf(), stpi_channel_free(), stpi_destroy_weave(), stpi_destroy_weave_params(), stpi_dither_free(), stpi_dither_very_fast(), stpi_path_check(), stpi_printer_freefunc(), value_freefunc(), xml_preload_freefunc(), and xml_registry_freefunc().

unsigned long stp_get_debug_level void   
 

Definition at line 320 of file print-util.c.

References stpi_debug_level, and stpi_init_debug().

Referenced by escp2_set_remote_sequence(), stp_printer_create_from_xmltree(), and stp_xml_process_paper().

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.

Definition at line 441 of file print-util.c.

References bindtextdomain, stp_initialize_printer_defaults(), stp_module_init(), stp_module_load(), stp_xml_init_defaults(), stp_xml_preinit(), stpi_init_debug(), stpi_init_dither(), stpi_init_paper(), and stpi_init_printer().

void stp_init_debug_messages stp_vars_t   v
 

Definition at line 365 of file print-util.c.

References debug_msgbuf_t::bytes, debug_msgbuf_t::data, fill_buffer_writefunc(), debug_msgbuf_t::odata, debug_msgbuf_t::ofunc, stp_get_errdata(), stp_get_errfunc(), stp_get_verified(), stp_malloc(), stp_set_errdata(), stp_set_errfunc(), and stp_set_verified().

Referenced by setup_inks(), and stpi_dither_set_ranges().

void* stp_malloc size_t   
 

Definition at line 401 of file print-util.c.

References stp_abort(), and stp_malloc_func.

Referenced by allocate_lineactive(), allocate_linebounds(), allocate_linebuf(), allocate_linecount(), allocate_lineoff(), compute_a_curve_fast(), compute_a_curve_full(), compute_gcr_curve(), compute_linear_deltas(), compute_spline_deltas(), copy_lut(), copy_to_raw(), copyfunc(), escp2_print_data(), et_setup(), fill_buffer_writefunc(), initialize_weave_params(), insert_subchannel(), invert_curve(), invert_map(), lexmark_do_print(), make_passmap(), olympus_do_print(), pcl_do_print(), ps_print_internal(), raw_print(), send_extra_data(), set_default_raw_parameter(), set_raw_parameter(), shared_ed_initializer(), stp_allocate_component_data(), stp_channel_initialize(), stp_curve_compose(), stp_curve_resample(), stp_curve_rescale(), stp_dither_matrix_copy(), stp_dither_matrix_init(), stp_dither_matrix_init_from_dither_array(), stp_dither_matrix_init_short(), stp_dither_matrix_iterated_init(), stp_dither_matrix_shear(), stp_dither_set_ink_spread(), stp_dither_set_inks(), stp_dither_set_inks_simple(), stp_init_debug_messages(), stp_list_create(), stp_list_item_create(), stp_path_split(), stp_register_xml_parser(), stp_set_array_parameter(), stp_set_boolean_parameter(), stp_set_curve_parameter(), stp_set_default_array_parameter(), stp_set_default_boolean_parameter(), stp_set_default_curve_parameter(), stp_set_default_float_parameter(), stp_set_default_int_parameter(), stp_set_float_parameter(), stp_set_int_parameter(), stp_strdup(), stp_string_list_add_string(), stp_strndup(), stp_xml_dither_cache_set(), stp_zalloc(), stpi_color_traditional_init(), stpi_path_merge(), and value_copy().

void stp_prune_inactive_options stp_vars_t   v
 

Definition at line 1221 of file print-vars.c.

References value_t::active, value_t::name, stp_vars::params, stp_get_parameter_list(), stp_list_get_start(), stp_list_item_destroy(), stp_list_item_get_data(), stp_list_item_next(), STP_PARAMETER_DEFAULTED, stp_parameter_find(), stp_parameter_list_destroy(), stp_parameter_list_t, and STP_PARAMETER_TYPE_INVALID.

Referenced by canon_print(), escp2_job_end(), escp2_job_start(), escp2_print(), lexmark_do_print(), lexmark_print(), olympus_print(), pcl_print(), ps_print_internal(), raw_print(), and stp_verify().

void stp_put16_be unsigned short    sh,
const stp_vars_t   v
 

Definition at line 144 of file print-util.c.

References BYTE, and stp_putc().

Referenced by canon_write(), cpx00_plane_init_func(), cpx00_printer_init_func(), p300_block_init_func(), p300_printer_init_func(), p400_block_init_func(), p400_printer_init_func(), stp_send_command(), updp10_printer_end_func(), and updp10_printer_init_func().

void stp_put16_le unsigned short    sh,
const stp_vars_t   v
 

Definition at line 137 of file print-util.c.

References BYTE, and stp_putc().

Referenced by canon_cmd(), canon_write(), cpx00_plane_init_func(), cx400_printer_init_func(), and stp_send_command().

void stp_put32_be unsigned int    sh,
const stp_vars_t   v
 

Definition at line 160 of file print-util.c.

References BYTE, and stp_putc().

Referenced by stp_send_command(), and updp10_printer_init_func().

void stp_put32_le unsigned int    sh,
const stp_vars_t   v
 

Definition at line 151 of file print-util.c.

References BYTE, and stp_putc().

Referenced by cpx00_plane_init_func(), stp_send_command(), and updp10_printer_init_func().

void stp_putc int    ch,
const stp_vars_t   v
 

Definition at line 128 of file print-util.c.

References stp_get_outdata(), and stp_get_outfunc().

Referenced by canon_cmd(), canon_deinit_printer(), canon_write(), cx400_printer_init_func(), p400_printer_init_func(), pcl_do_print(), ps_ascii85(), ps_hex(), send_extra_data(), stp_put16_be(), stp_put16_le(), stp_put32_be(), stp_put32_le(), and stp_send_command().

void stp_puts const char *    s,
const stp_vars_t   v
 

Definition at line 169 of file print-util.c.

References stp_get_outdata(), and stp_get_outfunc().

Referenced by canon_init_resetPrinter(), pcl_do_print(), ps_ascii85(), ps_print_internal(), stp_send_command(), and stpi_escp2_deinit_printer().

stp_curve_t* stp_read_and_compose_curves const char *    s1,
const char *    s2,
stp_curve_compose_t    comp
 

Definition at line 524 of file print-util.c.

References stp_curve_compose(), stp_curve_compose_t, stp_curve_create_from_string(), and stp_curve_destroy().

void* stp_realloc void *    ptr,
size_t   
 

Definition at line 422 of file print-util.c.

References stp_abort(), and stpi_realloc_func.

Referenced by fill_buffer_writefunc(), insert_channel(), and stp_channel_add().

void stp_send_command const stp_vars_t   v,
const char *    command,
const char *    format,
...   
 

Definition at line 175 of file print-util.c.

References stp_put16_be(), stp_put16_le(), stp_put32_be(), stp_put32_le(), stp_putc(), and stp_puts().

Referenced by escp2_reset_printer(), escp2_set_color(), escp2_set_dot_size(), escp2_set_form_factor(), escp2_set_graphics_mode(), escp2_set_margins(), escp2_set_page_height(), escp2_set_printer_weave(), escp2_set_printhead_resolution(), escp2_set_printhead_speed(), escp2_set_remote_sequence(), escp2_set_resolution(), pcl_do_print(), print_debug_params(), print_remote_param(), send_print_command(), set_color(), set_horizontal_position(), set_vertical_position(), stpi_escp2_deinit_printer(), stpi_escp2_flush_pass(), and stpi_escp2_terminate_page().

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).

Definition at line 514 of file print-util.c.

char* stp_strdup const char *    s
 

Definition at line 500 of file print-util.c.

References stp_malloc(), stp_strlen(), and stp_strndup().

Referenced by copyfunc(), initialize_standard_vars(), set_default_raw_parameter(), set_long_name_cache(), set_name_cache(), set_raw_parameter(), stp_allocate_component_data(), stp_printer_create_from_xmltree(), stp_register_xml_parser(), stp_register_xml_preload(), stp_set_array_parameter(), stp_set_boolean_parameter(), stp_set_curve_parameter(), stp_set_default_array_parameter(), stp_set_default_boolean_parameter(), stp_set_default_curve_parameter(), stp_set_default_float_parameter(), stp_set_default_int_parameter(), stp_set_float_parameter(), stp_set_int_parameter(), stp_string_list_add_string(), stp_xml_dither_cache_set(), stp_xml_process_paper(), and value_copy().

size_t stp_strlen const char *    s
 

Definition at line 475 of file print-util.c.

Referenced by stp_strdup().

char* stp_strndup const char *    s,
int    n
 

Definition at line 481 of file print-util.c.

References stp_malloc().

Referenced by stp_strdup().

void* stp_zalloc size_t   
 

Definition at line 414 of file print-util.c.

References stp_malloc().

Referenced by allocate_channels(), allocate_lineactive(), allocate_linebounds(), allocate_linebuf(), allocate_linecount(), allocate_lineoff(), allocate_lut(), canon_cmd(), check_linebases(), escp2_do_print(), et_setup(), lexmark_do_print(), olympus_do_print(), ppd_find(), setup_column(), setup_head_offset(), stp_array_create(), stp_channel_add(), stp_channel_initialize(), stp_curve_create(), stp_dither_init(), stp_initialize_weave(), stp_printer_create_from_xmltree(), stp_sequence_copy(), stp_sequence_create(), stp_sequence_set_data(), stp_sequence_set_size(), stp_vars_create(), stp_write_weave(), stp_xml_process_paper(), stpi_dither_get_errline(), stpi_dither_set_ranges(), and stpi_dither_very_fast().

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

Definition at line 122 of file print-util.c.

References stp_get_outdata(), and stp_get_outfunc().

Referenced by canon_cmd(), canon_write(), canon_write_line(), cpx00_plane_init_func(), cpx00_printer_init_func(), cx400_printer_init_func(), escp2_reset_printer(), escp2_set_remote_sequence(), lexmark_deinit_printer(), lexmark_init_printer(), lexmark_write(), olympus_do_print(), p300_printer_init_func(), p400_block_init_func(), p400_plane_end_func(), p400_plane_init_func(), p400_printer_init_func(), paper_shift(), pcl_mode0(), pcl_mode2(), ps_ascii85(), raw_print(), send_extra_data(), stpi_escp2_deinit_printer(), stpi_escp2_flush_pass(), updp10_printer_end_func(), and updp10_printer_init_func().

void stp_zprintf const stp_vars_t   v,
const char *    format,
...   
 

Definition at line 90 of file print-util.c.


Generated on Wed May 12 20:21:38 2004 for libgimpprint API Reference by doxygen1.2.17