libcapsppd-api.h

Go to the documentation of this file.

#pragma once
 
/*
 * SPDX-License-Identifier: LGPL-2.1-or-later
 *
 * (c) 2018 Juergen Borleis <projects@caps-printing.org>
 *
 * This library is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by the Free
 * Software Foundation; either version 2.1 of the License, or (at your option)
 * any later version.
 */
 
#include <stddef.h>
#include <stdbool.h>
#include <features.h>
 
#include <libcapsbase.h>
#include <libcapstable.h>
#include <libcapsppd.h>
 
__BEGIN_DECLS
 
#define LIBCAPSPPD_MAJOR 1
#define LIBCAPSPPD_MINOR 3
#define LIBCAPSPPD_MICRO 0
void caps_libppd_version_get(unsigned *major, unsigned *minor, unsigned *micro) __nonnull();
struct caps_ppd_option {
    const char *keyword; 
    const char *name; 
    const char *description; 
    const char *value; 
};
struct caps_ppd_options_table;
void caps_libppd_init(void);
struct caps_ppd_options_table *caps_ppd_options_table_create(void) __returns_nonnull;
void caps_ppd_options_table_clean_up(struct caps_ppd_options_table *pot);
int caps_ppd_options_table_file_read(struct caps_ppd_options_table *pot, const char *ppd_file_name) __nonnull();
struct caps_ppd_option *caps_ppd_option_get(const struct caps_ppd_options_table *pot, const char *keyword) __nonnull();
struct caps_ppd_option *caps_ppd_option_with_name_get(const struct caps_ppd_options_table *pot, const char *keyword, const char *name) __nonnull((1,2));
void caps_ppd_option_add(struct caps_ppd_options_table *pot, const char *keyword, const char *name, const char *description, const char *value) __nonnull((1,2));
struct caps_ppd_options_table *caps_ppd_options_table_duplicate(const struct caps_ppd_options_table *src) __nonnull() __returns_nonnull;
const struct caps_ppd_option *caps_ppd_options_table_base_get(const struct caps_ppd_options_table *pot) __nonnull();
size_t caps_ppd_options_table_element_count_get(const struct caps_ppd_options_table *pot) __nonnull();
struct caps_ppd_device_info {
    const char *manufacturer; 
    const char *product; 
    const char *model; 
    const char *nick; 
    const char *short_nick; 
};
void caps_ppd_info_generate(struct caps_ppd_options_table *db, FILE *ppd_file, const struct caps_ppd_device_info *prod_info, const struct caps_ppd_base *cpb) __nonnull((1,2,4));
int caps_ppd_paper_format_validate(const char *paper_name) __nonnull();
struct caps_rect caps_ppd_paper_format_size_get(const char *paper_name) __nonnull();
const char *caps_ppd_paper_format_name_get(const struct caps_rect *size) __nonnull();
const char *caps_ppd_paper_default_format_get(void) __returns_nonnull;
__END_DECLS