libgutenprint API Reference 5.3.5
|
The vars data type contains all the information about a print job, this includes information such as the printer model, paper size, print resolution etc. More...
Data Structures | |
struct | stp_raw_t |
Raw parameter. More... | |
struct | stp_double_bound_t |
double_bound (range) parameter. More... | |
struct | stp_int_bound_t |
int_bound (range) parameter. More... | |
struct | stp_dimension_bound_t |
dimension_bound (range) parameter. More... | |
struct | stp_parameter_t |
Parameter description. More... | |
Macros | |
#define | STP_RAW(x) |
#define | STP_RAW_STRING(x) |
#define | STP_CHANNEL_NONE ((unsigned char) -1) |
Typedefs | |
typedef struct stp_vars | stp_vars_t |
The vars opaque data type. | |
typedef void * | stp_parameter_list_t |
The parameter_list opaque data type. | |
typedef const void * | stp_const_parameter_list_t |
The constant parameter_list opaque data type. | |
typedef void(* | stp_outfunc_t) (void *data, const char *buffer, size_t bytes) |
Output function supplied by the calling application. | |
typedef void *(* | stp_copy_data_func_t) (void *) |
typedef void(* | stp_free_data_func_t) (void *) |
typedef struct stp_compdata | compdata_t |
Functions | |
void | stp_vars_print_error (const stp_vars_t *v, const char *prefix) |
Print an stp_vars_t in debugging format. | |
stp_vars_t * | stp_vars_create (void) |
Create a new vars object. | |
void | stp_vars_copy (stp_vars_t *dest, const stp_vars_t *source) |
Copy a vars object. | |
stp_vars_t * | stp_vars_create_copy (const stp_vars_t *source) |
Copy and allocate a vars object. | |
void | stp_vars_destroy (stp_vars_t *v) |
Destroy a vars object. | |
void | stp_set_driver (stp_vars_t *v, const char *val) |
Set the name of the printer driver. | |
void | stp_set_driver_n (stp_vars_t *v, const char *val, int bytes) |
Set the name of the printer driver. | |
const char * | stp_get_driver (const stp_vars_t *v) |
Get the name of the printer driver. | |
void | stp_set_color_conversion (stp_vars_t *v, const char *val) |
Set the name of the color conversion routine, if not the default. | |
void | stp_set_color_conversion_n (stp_vars_t *v, const char *val, int bytes) |
Set the name of the color conversion routine, if not the default. | |
const char * | stp_get_color_conversion (const stp_vars_t *v) |
Get the name of the color conversion routine. | |
void | stp_set_left (stp_vars_t *v, stp_dimension_t val) |
Set the left edge of the image. | |
stp_dimension_t | stp_get_left (const stp_vars_t *v) |
Get the left edge of the image. | |
void | stp_set_top (stp_vars_t *v, stp_dimension_t val) |
Set the top edge of the image. | |
stp_dimension_t | stp_get_top (const stp_vars_t *v) |
Get the top edge of the image. | |
void | stp_set_width (stp_vars_t *v, stp_dimension_t val) |
Set the width of the image. | |
stp_dimension_t | stp_get_width (const stp_vars_t *v) |
Get the width edge of the image. | |
void | stp_set_height (stp_vars_t *v, stp_dimension_t val) |
Set the height of the image. | |
stp_dimension_t | stp_get_height (const stp_vars_t *v) |
Get the height of the image. | |
void | stp_set_page_width (stp_vars_t *v, stp_dimension_t val) |
Set the page width. | |
stp_dimension_t | stp_get_page_width (const stp_vars_t *v) |
Get the page width. | |
void | stp_set_page_height (stp_vars_t *v, stp_dimension_t val) |
Set the page height. | |
stp_dimension_t | stp_get_page_height (const stp_vars_t *v) |
Get the page height. | |
void | stp_set_outfunc (stp_vars_t *v, stp_outfunc_t val) |
Set the function used to print output information. | |
stp_outfunc_t | stp_get_outfunc (const stp_vars_t *v) |
Get the function used to print output information. | |
void | stp_set_errfunc (stp_vars_t *v, stp_outfunc_t val) |
Set the function used to print error information. | |
stp_outfunc_t | stp_get_errfunc (const stp_vars_t *v) |
Get the function used to print output information. | |
void | stp_set_dbgfunc (stp_vars_t *v, stp_outfunc_t val) |
Set the function used to print diagnostic information. | |
stp_outfunc_t | stp_get_dbgfunc (const stp_vars_t *v) |
Get the function used to print output information. | |
void | stp_set_outdata (stp_vars_t *v, void *val) |
Set the output data. | |
void * | stp_get_outdata (const stp_vars_t *v) |
Get the output data. | |
void | stp_set_errdata (stp_vars_t *v, void *val) |
Set the error data. | |
void * | stp_get_errdata (const stp_vars_t *v) |
Get the error data. | |
void | stp_set_dbgdata (stp_vars_t *v, void *val) |
Set the debug output data. | |
void * | stp_get_dbgdata (const stp_vars_t *v) |
Get the debug output data. | |
void | stp_merge_printvars (stp_vars_t *user, const stp_vars_t *print) |
Merge defaults for a printer with user-chosen settings. | |
void | stp_copy_vars_from (stp_vars_t *to, const stp_vars_t *from) |
Copy settings from one vars object to another, not modifying anything unset in the source. | |
stp_parameter_list_t | stp_get_parameter_list (const stp_vars_t *v) |
List the available parameters for the currently chosen settings. | |
size_t | stp_parameter_list_count (stp_const_parameter_list_t list) |
List the number of available parameters for the currently chosen settings. | |
const stp_parameter_t * | stp_parameter_find (stp_const_parameter_list_t list, const char *name) |
Find a parameter by its name. | |
const stp_parameter_t * | stp_parameter_list_param (stp_const_parameter_list_t list, size_t item) |
Find a parameter by its index number. | |
void | stp_parameter_list_destroy (stp_parameter_list_t list) |
Destroy a parameter_list. | |
stp_parameter_list_t | stp_parameter_list_create (void) |
Create a parameter_list. | |
void | stp_parameter_list_add_param (stp_parameter_list_t list, const stp_parameter_t *item) |
Add a parameter to a parameter_list. | |
stp_parameter_list_t | stp_parameter_list_copy (stp_const_parameter_list_t list) |
Copy and allocate a parameter_list. | |
void | stp_parameter_list_append (stp_parameter_list_t list, stp_const_parameter_list_t append) |
Append one parameter_list to another. | |
void | stp_describe_parameter (const stp_vars_t *v, const char *name, stp_parameter_t *description) |
Describe a parameter in detail. | |
void | stp_parameter_description_destroy (stp_parameter_t *description) |
Destroy a parameter description. | |
const stp_parameter_t * | stp_parameter_find_in_settings (const stp_vars_t *v, const char *name) |
Find a parameter by its name from a vars object. | |
void | stp_set_string_parameter (stp_vars_t *v, const char *parameter, const char *value) |
Set a string parameter. | |
void | stp_set_string_parameter_n (stp_vars_t *v, const char *parameter, const char *value, size_t bytes) |
Set a string parameter. | |
void | stp_set_file_parameter (stp_vars_t *v, const char *parameter, const char *value) |
Set a file parameter. | |
void | stp_set_file_parameter_n (stp_vars_t *v, const char *parameter, const char *value, size_t bytes) |
Set a file parameter. | |
void | stp_set_float_parameter (stp_vars_t *v, const char *parameter, double value) |
Set a float parameter. | |
void | stp_set_int_parameter (stp_vars_t *v, const char *parameter, int value) |
Set an integer parameter. | |
void | stp_set_dimension_parameter (stp_vars_t *v, const char *parameter, stp_dimension_t value) |
Set a dimension parameter. | |
void | stp_set_boolean_parameter (stp_vars_t *v, const char *parameter, int value) |
Set a boolean parameter. | |
void | stp_set_curve_parameter (stp_vars_t *v, const char *parameter, const stp_curve_t *value) |
Set a curve parameter. | |
void | stp_set_array_parameter (stp_vars_t *v, const char *parameter, const stp_array_t *value) |
Set an array parameter. | |
void | stp_set_raw_parameter (stp_vars_t *v, const char *parameter, const void *value, size_t bytes) |
Set a raw parameter. | |
void | stp_scale_float_parameter (stp_vars_t *v, const char *parameter, double scale) |
Multiply the value of a float parameter by a scaling factor. | |
void | stp_set_default_string_parameter (stp_vars_t *v, const char *parameter, const char *value) |
Set a default string parameter. | |
void | stp_set_default_string_parameter_n (stp_vars_t *v, const char *parameter, const char *value, size_t bytes) |
Set a default string parameter. | |
void | stp_set_default_file_parameter (stp_vars_t *v, const char *parameter, const char *value) |
Set a default file parameter. | |
void | stp_set_default_file_parameter_n (stp_vars_t *v, const char *parameter, const char *value, size_t bytes) |
Set a default file parameter. | |
void | stp_set_default_float_parameter (stp_vars_t *v, const char *parameter, double value) |
Set a default float parameter. | |
void | stp_set_default_int_parameter (stp_vars_t *v, const char *parameter, int value) |
Set a default integer parameter. | |
void | stp_set_default_dimension_parameter (stp_vars_t *v, const char *parameter, stp_dimension_t value) |
Set a default dimension parameter. | |
void | stp_set_default_boolean_parameter (stp_vars_t *v, const char *parameter, int value) |
Set a default boolean parameter. | |
void | stp_set_default_curve_parameter (stp_vars_t *v, const char *parameter, const stp_curve_t *value) |
Set a default curve parameter. | |
void | stp_set_default_array_parameter (stp_vars_t *v, const char *parameter, const stp_array_t *value) |
Set a default array parameter. | |
void | stp_set_default_raw_parameter (stp_vars_t *v, const char *parameter, const void *value, size_t bytes) |
Set a default raw parameter. | |
const char * | stp_get_string_parameter (const stp_vars_t *v, const char *parameter) |
Get a string parameter. | |
const char * | stp_get_file_parameter (const stp_vars_t *v, const char *parameter) |
Get a file parameter. | |
double | stp_get_float_parameter (const stp_vars_t *v, const char *parameter) |
Get a float parameter. | |
int | stp_get_int_parameter (const stp_vars_t *v, const char *parameter) |
Get an integer parameter. | |
stp_dimension_t | stp_get_dimension_parameter (const stp_vars_t *v, const char *parameter) |
Get a dimension parameter. | |
int | stp_get_boolean_parameter (const stp_vars_t *v, const char *parameter) |
Get a boolean parameter. | |
const stp_curve_t * | stp_get_curve_parameter (const stp_vars_t *v, const char *parameter) |
Get a curve parameter. | |
const stp_array_t * | stp_get_array_parameter (const stp_vars_t *v, const char *parameter) |
Get an array parameter. | |
const stp_raw_t * | stp_get_raw_parameter (const stp_vars_t *v, const char *parameter) |
Get a raw parameter. | |
void | stp_clear_string_parameter (stp_vars_t *v, const char *parameter) |
Clear a string parameter. | |
void | stp_clear_file_parameter (stp_vars_t *v, const char *parameter) |
Clear a file parameter. | |
void | stp_clear_float_parameter (stp_vars_t *v, const char *parameter) |
Clear (remove) a float parameter. | |
void | stp_clear_int_parameter (stp_vars_t *v, const char *parameter) |
Clear (remove) an integer parameter. | |
void | stp_clear_dimension_parameter (stp_vars_t *v, const char *parameter) |
Clear (remove) a dimension parameter. | |
void | stp_clear_boolean_parameter (stp_vars_t *v, const char *parameter) |
Clear (remove) a boolean parameter. | |
void | stp_clear_curve_parameter (stp_vars_t *v, const char *parameter) |
Clear a curve parameter. | |
void | stp_clear_array_parameter (stp_vars_t *v, const char *parameter) |
Clear an array parameter. | |
void | stp_clear_raw_parameter (stp_vars_t *v, const char *parameter) |
Clear a raw parameter. | |
void | stp_clear_parameter (stp_vars_t *v, const char *parameter, stp_parameter_type_t type) |
Clear a parameter. | |
stp_string_list_t * | stp_list_string_parameters (const stp_vars_t *v) |
List all string parameters. | |
stp_string_list_t * | stp_list_file_parameters (const stp_vars_t *v) |
List all file parameters. | |
stp_string_list_t * | stp_list_float_parameters (const stp_vars_t *v) |
List all float parameters. | |
stp_string_list_t * | stp_list_int_parameters (const stp_vars_t *v) |
List all integer parameters. | |
stp_string_list_t * | stp_list_dimension_parameters (const stp_vars_t *v) |
List all dimension parameters. | |
stp_string_list_t * | stp_list_boolean_parameters (const stp_vars_t *v) |
List all boolean parameters. | |
stp_string_list_t * | stp_list_curve_parameters (const stp_vars_t *v) |
List all curve parameters. | |
stp_string_list_t * | stp_list_array_parameters (const stp_vars_t *v) |
List all array parameters. | |
stp_string_list_t * | stp_list_raw_parameters (const stp_vars_t *v) |
List all raw parameters. | |
stp_string_list_t * | stp_list_parameters (const stp_vars_t *v, stp_parameter_type_t type) |
List all parameters. | |
void | stp_set_string_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a string parameter. | |
void | stp_set_file_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a file parameter. | |
void | stp_set_float_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a float parameter. | |
void | stp_set_int_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of an integer parameter. | |
void | stp_set_dimension_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a dimension parameter. | |
void | stp_set_boolean_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a boolean parameter. | |
void | stp_set_curve_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a curveparameter. | |
void | stp_set_array_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of an array parameter. | |
void | stp_set_raw_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Set the activity of a raw parameter. | |
void | stp_set_parameter_active (stp_vars_t *v, const char *parameter, stp_parameter_activity_t active, stp_parameter_type_t type) |
Set the activity of a parameter. | |
int | stp_check_string_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a string parameter is set. | |
int | stp_check_file_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a file parameter is set. | |
int | stp_check_float_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a float parameter is set. | |
int | stp_check_int_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if an integer parameter is set. | |
int | stp_check_dimension_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a dimension parameter is set. | |
int | stp_check_boolean_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a boolean parameter is set. | |
int | stp_check_curve_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a curve parameter is set. | |
int | stp_check_array_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if an array parameter is set. | |
int | stp_check_raw_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active) |
Check if a raw parameter is set. | |
int | stp_check_parameter (const stp_vars_t *v, const char *parameter, stp_parameter_activity_t active, stp_parameter_type_t type) |
Check if a parameter is set. | |
stp_parameter_activity_t | stp_get_string_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a string parameter. | |
stp_parameter_activity_t | stp_get_file_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a file parameter. | |
stp_parameter_activity_t | stp_get_float_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a float parameter. | |
stp_parameter_activity_t | stp_get_int_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of an integer parameter. | |
stp_parameter_activity_t | stp_get_dimension_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a dimension parameter. | |
stp_parameter_activity_t | stp_get_boolean_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a boolean parameter. | |
stp_parameter_activity_t | stp_get_curve_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a curve parameter. | |
stp_parameter_activity_t | stp_get_array_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of an array parameter. | |
stp_parameter_activity_t | stp_get_raw_parameter_active (const stp_vars_t *v, const char *parameter) |
Get the activity status of a raw parameter. | |
stp_parameter_activity_t | stp_get_parameter_active (const stp_vars_t *v, const char *parameter, stp_parameter_type_t type) |
Get the activity status of a parameter. | |
void | stp_get_media_size (const stp_vars_t *v, stp_dimension_t *width, stp_dimension_t *height) |
Get the media (paper) size. | |
void | stp_get_imageable_area (const stp_vars_t *v, stp_dimension_t *left, stp_dimension_t *right, stp_dimension_t *bottom, stp_dimension_t *top) |
Get the imagable area of the page. | |
void | stp_get_maximum_imageable_area (const stp_vars_t *v, stp_dimension_t *left, stp_dimension_t *right, stp_dimension_t *bottom, stp_dimension_t *top) |
Get the maximum imagable area of the page. | |
void | stp_get_size_limit (const stp_vars_t *v, stp_dimension_t *max_width, stp_dimension_t *max_height, stp_dimension_t *min_width, stp_dimension_t *min_height) |
Get the media size limits. | |
void | stp_describe_resolution (const stp_vars_t *v, stp_resolution_t *x, stp_resolution_t *y) |
Retrieve the printing resolution of the selected resolution. | |
int | stp_verify (stp_vars_t *v) |
Verify parameters. | |
const stp_vars_t * | stp_default_settings (void) |
Get default global settings. | |
char * | stp_parameter_get_category (const stp_vars_t *v, const stp_parameter_t *desc, const char *category) |
Get the value of a specified category for the specified parameter. | |
int | stp_parameter_has_category_value (const stp_vars_t *v, const stp_parameter_t *desc, const char *category, const char *value) |
Determine whether a parameter has a category with the specified value. | |
stp_string_list_t * | stp_parameter_get_categories (const stp_vars_t *v, const stp_parameter_t *desc) |
Get the list of categories and their values for the specified parameter. | |
void | stp_allocate_component_data (stp_vars_t *v, const char *name, stp_copy_data_func_t copyfunc, stp_free_data_func_t freefunc, void *data) |
void | stp_destroy_component_data (stp_vars_t *v, const char *name) |
void * | stp_get_component_data (const stp_vars_t *v, const char *name) |
stp_parameter_verify_t | stp_verify_parameter (const stp_vars_t *v, const char *parameter, int quiet) |
int | stp_get_verified (const stp_vars_t *v) |
void | stp_set_verified (stp_vars_t *v, int value) |
void | stp_copy_options (stp_vars_t *vd, const stp_vars_t *vs) |
void | stp_fill_parameter_settings (stp_parameter_t *desc, const stp_parameter_t *param) |
The vars data type contains all the information about a print job, this includes information such as the printer model, paper size, print resolution etc.
Most of these job options are expressed as parameters which vary according to the model and other options selected.
The representation of printer settings has changed dramatically from 4.2. All (well most, anyway) settings outside of basics such as the printer model and sizing settings are now typed parameters.
#define STP_CHANNEL_NONE ((unsigned char) -1) |
#define STP_RAW | ( | x | ) |
#define STP_RAW_STRING | ( | x | ) |
typedef struct stp_compdata compdata_t |
typedef const void* stp_const_parameter_list_t |
The constant parameter_list opaque data type.
typedef void *(* stp_copy_data_func_t) (void *) |
typedef void(* stp_free_data_func_t) (void *) |
typedef void(* stp_outfunc_t) (void *data, const char *buffer, size_t bytes) |
Output function supplied by the calling application.
There are two output functions supplied by the caller, one to send output data and one to report errors.
data | a pointer to an opaque object owned by the calling application. |
buffer | the data to output. |
bytes | the size of buffer (in bytes). |
typedef void* stp_parameter_list_t |
The parameter_list opaque data type.
typedef struct stp_vars stp_vars_t |
The vars opaque data type.
Parameter activity.
Whether a parameter is currently active (i. e. whether its value should be used by the driver or not). All parameters default to being active unless explicitly "turned off".
Enumerator | |
---|---|
STP_PARAMETER_INACTIVE | Parameter is inactive (unused). |
STP_PARAMETER_DEFAULTED | Parameter is set to its default value. |
STP_PARAMETER_ACTIVE | Parameter is active (used). |
Parameter class.
What kind of setting this is, for the purpose of user interface representation.
Parameter level.
What "level" a setting is at, for UI design.
enum stp_parameter_type_t |
Parameter types.
The following types are permitted for a printer setting. Not all are currently implemented.
|
extern |
|
extern |
Check if an array parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a boolean parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a curve parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a dimension parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a file parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a float parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if an integer parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
type | the type of the parameter. |
|
extern |
Check if a raw parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Check if a string parameter is set.
v | the vars to use. |
parameter | the name of the parameter. |
active | the minimum activity status. |
|
extern |
Clear an array parameter.
The parameter is set to NULL.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear (remove) a boolean parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear a curve parameter.
The parameter is set to NULL.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear (remove) a dimension parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear a file parameter.
The parameter is set to NULL.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear (remove) a float parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear (remove) an integer parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear a parameter.
v | the vars to use. |
parameter | the name of the parameter. |
type | the type of the parameter. |
|
extern |
Clear a raw parameter.
The parameter is set to NULL.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Clear a string parameter.
The parameter is set to NULL.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
|
extern |
Copy settings from one vars object to another, not modifying anything unset in the source.
to | the destination vars. |
from | the vars to merge into user. |
|
extern |
Get default global settings.
The main use of this is to provide a usable stp_vars_t for purposes of parameter inquiry in the absence of a specific printer. This is currently used in a variety of places to get information on the standard color parameters without querying a particular printer.
|
extern |
Describe a parameter in detail.
All of the parameter fields will be populated.
v | the vars to use. |
name | the name of the parameter. |
description | a pointer to an stp_parameter_t to store the parameter description in. |
|
extern |
Retrieve the printing resolution of the selected resolution.
If the resolution is invalid, -1 will be returned in both x and y.
v | the vars to use. |
x | a pointer to a stp_resolution_t to store the horizontal resolution in. |
y | a pointer to a stp_resolution_t to store the vertical resolution in. |
|
extern |
|
extern |
|
extern |
Get an array parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of an array parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get a boolean parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a boolean parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the name of the color conversion routine.
|
extern |
|
extern |
Get a curve parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a curve parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the debug output data.
v | the vars to use. |
|
extern |
Get the function used to print output information.
v | the vars to use. |
|
extern |
Get a dimension parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a dimension parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the name of the printer driver.
|
extern |
Get the error data.
v | the vars to use. |
|
extern |
Get the function used to print output information.
v | the vars to use. |
|
extern |
Get a file parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a file parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get a float parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a float parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the height of the image.
|
extern |
Get the imagable area of the page.
Retrieve the boundaries of the printable area of the page. In combination with the media size, this can be used to determine the actual printable region, which callers can use to place the image precisely. The dimensions are relative to the top left of the physical page.
If a customizable page size is used (see stp_printer_get_media_size), the actual desired width and/or height must be filled in using stp_set_page_width and/or stp_set_page_height. If these are not filled in, the margins will be returned.
Returned values may be negative if a printer is capable of full bleed by printing beyond the physical boundaries of the page.
If the media size stored in V is invalid, the return values will be indeterminate. It is up to the user to specify legal values.
v | the vars to use. |
left | a pointer to a stp_dimension_t to store the left edge in. |
right | a pointer to a stp_dimension_t to store the right edge in. |
bottom | a pointer to a stp_dimension_t to store the bottom edge in. |
top | a pointer to a stp_dimension_t to store the top edge in. |
|
extern |
Get an integer parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of an integer parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the left edge of the image.
|
extern |
Get the maximum imagable area of the page.
Retrieve the maximum (regardless of settings other than page sise) boundaries of the printable area of the page. In combination with the media size, this can be used to determine the actual printable region, which callers can use to place the image precisely. The dimensions are relative to the top left of the physical page.
If a customizable page size is used (see stp_printer_get_media_size), the actual desired width and/or height must be filled in using stp_set_page_width and/or stp_set_page_height. If these are not filled in, the margins will be returned.
Returned values may be negative if a printer is capable of full bleed by printing beyond the physical boundaries of the page.
If the media size stored in V is invalid, the return values will be indeterminate. It is up to the user to specify legal values.
v | the vars to use. |
left | a pointer to a stp_dimension_t to store the left edge in. |
right | a pointer to a stp_dimension_t to store the right edge in. |
bottom | a pointer to a stp_dimension_t to store the bottom edge in. |
top | a pointer to a stp_dimension_t to store the top edge in. |
|
extern |
Get the media (paper) size.
Retrieve the media size of the media type set in V, expressed in units of 1/72". If the media size is invalid, width and height will be set to -1. Values of 0 for width or height indicate that the dimension is variable, so that custom page sizes or roll paper can be used. In this case, the size limit should be used to determine maximum and minimum values permitted.
v | the vars to use. |
width | a pointer to an stp_dimension_t to store the media width in. |
height | a pointer to an stp_dimension_t to store the media height in. |
|
extern |
Get the output data.
v | the vars to use. |
|
extern |
Get the function used to print output information.
v | the vars to use. |
|
extern |
Get the page height.
|
extern |
Get the page width.
|
extern |
Get the activity status of a parameter.
v | the vars to use. |
parameter | the name of the parameter. |
type | the type of the parameter. |
|
extern |
List the available parameters for the currently chosen settings.
This does not fill in the bounds and defaults; it merely provides a list of settings. To fill in detailed information for a setting, use stp_describe_parameter.
v | the vars to use. |
|
extern |
Get a raw parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a raw parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the media size limits.
Retrieve the minimum and maximum size limits for custom media sizes with the current printer settings.
v | the vars to use. |
max_width | a pointer to a stp_dimension_t to store the maximum width in. |
max_height | a pointer to a stp_dimension_t to store the maximum height in. |
min_width | a pointer to a stp_dimension_t to store the minimum width in. |
min_height | a pointer to a stp_dimension_t to store the minimum height in. |
|
extern |
Get a string parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the activity status of a string parameter.
v | the vars to use. |
parameter | the name of the parameter. |
|
extern |
Get the top edge of the image.
|
extern |
|
extern |
Get the width edge of the image.
|
extern |
List all array parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all boolean parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all curve parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all dimension parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all file parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all float parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all integer parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all parameters.
The return value must be freed after use.
v | the vars to use. |
type | the type of the parameter. |
|
extern |
List all raw parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
List all string parameters.
The return value must be freed after use.
v | the vars to use. |
|
extern |
Merge defaults for a printer with user-chosen settings.
user | the destination vars. |
the vars to merge into user. |
|
extern |
Destroy a parameter description.
This must be called even if the stp_parameter_t was not allocated with malloc, since some members are dynamically allocated.
description | the parameter description to destroy. |
|
extern |
Find a parameter by its name.
list | the parameter_list to use. |
name | the name of the parameter. |
|
extern |
Find a parameter by its name from a vars object.
v | the vars to use. |
name | the name of the parameter. |
|
extern |
Get the list of categories and their values for the specified parameter.
v | the vars to use. |
desc | the parameter description to use (must already be described) |
|
extern |
Get the value of a specified category for the specified parameter.
v | the vars to use. |
desc | the parameter description to use (must already be described) |
category | the name of the category to search for. |
|
extern |
Determine whether a parameter has a category with the specified value.
If a null value is passed in, return whether the parameter has the category at all. Return -1 if any other error condition (null vars, desc, or category).
v | the vars to use. |
desc | the parameter description to use (must already be described) |
category | the name of the category to search for. |
value | the value of the category to search for. |
|
extern |
Add a parameter to a parameter_list.
list | the parameter_list to use. |
item | the parameter to add. |
|
extern |
Append one parameter_list to another.
list | the destination list (to append to). |
append | the list of parameters to append. Each item that does not already exist in list will be appended. |
|
extern |
Copy and allocate a parameter_list.
A new parameter_list will be created, and then the contents of source will be copied into it.
list | the source parameter_list. |
|
extern |
List the number of available parameters for the currently chosen settings.
list | the parameter_list to use. |
|
extern |
Create a parameter_list.
|
extern |
Destroy a parameter_list.
It is an error to destroy the parameter_list more than once.
list | the parameter_list to destroy. |
|
extern |
Find a parameter by its index number.
list | the parameter_list to use. |
item | the index number of the parameter (must not be greater than stp_parameter_list_count - 1). |
|
extern |
Multiply the value of a float parameter by a scaling factor.
v | the vars to use. |
parameter | the name of the parameter. |
scale | the factor to multiply the value by. |
|
extern |
Set an array parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of an array parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set a boolean parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a boolean parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set the name of the color conversion routine, if not the default.
v | the vars to use. |
val | the name to set. |
|
extern |
Set the name of the color conversion routine, if not the default.
v | the vars to use. |
val | the name to set. |
bytes | the length of val (in bytes). |
|
extern |
Set a curve parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a curveparameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set the debug output data.
v | the vars to use. |
val | the debug data. This will typically be a file descriptor, but it is entirely up to the caller exactly what type this might be. |
|
extern |
Set the function used to print diagnostic information.
These must be supplied by the caller. dbgdata is passed as an arguments to dbgfunc; typically it will be a file descriptor.
v | the vars to use. |
val | the value to set. |
|
extern |
Set a default array parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default boolean parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default curve parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default dimension parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default file parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default file parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set (must not contain NUL). |
bytes | the length of value (in bytes). |
|
extern |
Set a default float parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default integer parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default raw parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
bytes | the length of value (in bytes). |
|
extern |
Set a default string parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set a default string parameter.
The value is set if the parameter is not already set. This avoids having to check if the parameter is set prior to setting it, if you do not want to override the existing value.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set (must not contain NUL). |
bytes | the length of value (in bytes). |
|
extern |
Set a dimension parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a dimension parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set the name of the printer driver.
v | the vars to use. |
val | the name to set. |
|
extern |
Set the name of the printer driver.
v | the vars to use. |
val | the name to set. |
bytes | the length of val (in bytes). |
|
extern |
Set the error data.
v | the vars to use. |
val | the error data. This will typically be a file descriptor, but it is entirely up to the caller exactly what type this might be. |
|
extern |
Set the function used to print error information.
These must be supplied by the caller. errdata is passed as an arguments to errfunc; typically it will be a file descriptor.
v | the vars to use. |
val | the value to set. |
|
extern |
Set a file parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a file parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set a file parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set (must not contain NUL). |
bytes | the length of value (in bytes). |
|
extern |
Set a float parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a float parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set the height of the image.
v | the vars to use. |
val | the value to set. |
|
extern |
Set an integer parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of an integer parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set the left edge of the image.
v | the vars to use. |
val | the value to set. |
|
extern |
Set the output data.
v | the vars to use. |
val | the output data. This will typically be a file descriptor, but it is entirely up to the caller exactly what type this might be. |
|
extern |
Set the function used to print output information.
These must be supplied by the caller. outdata is passed as an arguments to outfunc; typically it will be a file descriptor.
v | the vars to use. |
val | the value to set. |
|
extern |
Set the page height.
v | the vars to use. |
val | the value to set. |
|
extern |
Set the page width.
v | the vars to use. |
val | the value to set. |
|
extern |
Set the activity of a parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
type | the type of the parameter. |
|
extern |
Set a raw parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
bytes | the length of value (in bytes). |
|
extern |
Set the activity of a raw parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set a string parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set. |
|
extern |
Set the activity of a string parameter.
v | the vars to use. |
parameter | the name of the parameter. |
active | the activity status to set (should be set to STP_PARAMETER_ACTIVE or STP_PARAMETER_INACTIVE). |
|
extern |
Set a string parameter.
v | the vars to use. |
parameter | the name of the parameter. |
value | the value to set (must not contain NUL). |
bytes | the length of value (in bytes). |
|
extern |
Set the top edge of the image.
v | the vars to use. |
val | the value to set. |
|
extern |
|
extern |
Set the width of the image.
v | the vars to use. |
val | the value to set. |
|
extern |
Copy a vars object.
Both dest and source must be valid vars objects previously created with stp_vars_create().
dest | the destination vars. |
source | the source vars. |
|
extern |
Create a new vars object.
|
extern |
Copy and allocate a vars object.
source must be a valid vars object previously created with stp_vars_create().
source | the source vars. |
|
extern |
Destroy a vars object.
It is an error to destroy the vars more than once.
v | the vars to destroy. |
|
extern |
Print an stp_vars_t in debugging format.
v | stp_vars_t to dump |
prefix | Prefix to prepend to each line (null pointer gives empty prefix) |
|
extern |
Verify parameters.
Verify that the parameters selected are consistent with those allowed by the driver. This must be called prior to printing; failure to do so will result in printing failing.
v | the vars to use. |
|
extern |