!C99Shell v. 2.0 [PHP 7 Update] [25.02.2019]!
Software: Apache/2.2.16 (Debian). PHP/5.3.3-7+squeeze19 uname -a: Linux mail.tri-specialutilitydistrict.com 2.6.32-5-amd64 #1 SMP Tue May 13 16:34:35 UTC 2014 x86_64 uid=33(www-data) gid=33(www-data) groups=33(www-data) Safe-mode: OFF (not secure) /usr/share/cups/doc-root/help/ drwxr-xr-x Free 130.01 GB of 142.11 GB (91.48%) Encoder Tools Proc. FTP brute Sec. SQL PHP-code Update Feedback Self remove Logout

PPD Compiler API

Header	cups/ppdc.h
Library	-lcupsppdc
See Also	Programming: Introduction to CUPS Programming

Overview
Classes
- ppdcArray
- ppdcAttr
- ppdcCatalog
- ppdcChoice
- ppdcConstraint
- ppdcDriver
- ppdcFile
- ppdcFilter
- ppdcFont
- ppdcGroup
- ppdcInteger
- ppdcMediaSize
- ppdcMessage
- ppdcOption
- ppdcProfile
- ppdcShared
- ppdcSource
- ppdcString
- ppdcVariable
Data Types
- ppdc_cs_t
Variables
- ppdcSource
Constants

Overview

The PPD Compiler API provides access to CUPS driver information files and methods for generating and importing PPD files.

Classes

ppdcArray

// Shared Array

class ppdcArray : public ppdcShared {
  public:
    int count, alloc, current;
    ppdcShared **data;
};

Members

current: Current element
data: Elements

PPDC_NAME

void PPDC_NAME (
void add(ppdcShared *d
);

Parameters

d

first

Return the first element in the array.

ppdcShared *first (void);

Return Value

Return the next element in the array.

ppdcShared *next (void);

Return Value

remove

void remove (
ppdcShared *d
);

Parameters

d: Data element

ppdcAttr

// Attribute

class ppdcAttr : public ppdcShared {
  public:
    bool localizable;
    ppdcString *name, *selector, *text, *value;
};

Members

localizable: Should this attribute be localized?
value: Value string

ppdcAttr

void ppdcAttr (
    const char *n,
    const char *s,
    const char *t,
    const char *v,
    bool loc
);

Parameters

n: Name
s: Spec string
t: Human-readable text
v: Value
loc: Localize this attribute?

ppdcCatalog

// Translation catalog

class ppdcCatalog : public ppdcShared {
  public:
    ppdcString *filename;
    ppdcString *locale;
    ppdcArray *messages;
};

Members

filename: Name of translation file
locale: Name of locale
messages: Array of translation messages

PPDC_NAME

void PPDC_NAME (
void add_message(const char *id,
const char *string = NULL
);

Parameters

id
string

add_message

void add_message (
const char *id,
const char *string
);

Parameters

id: Message ID to add
string: Translation string

find_message

const char *find_message (
const char *id
);

Parameters

id: Message ID

Return Value

Message text

load_messages

int load_messages (
const char *f
);

Parameters

f: Message catalog file

Return Value

0 on success, -1 on failure

ppdcCatalog

void ppdcCatalog (
const char *l,
const char *f
);

Parameters

l: Locale
f: Message catalog file

save_messages

int save_messages (
const char *f
);

Parameters

f: File to save to

Return Value

0 on success, -1 on error

ppdcChoice

// Option Choice

class ppdcChoice : public ppdcShared {
public:
ppdcString *name, *text, *code;
};

Members

code: PS code of choice

ppdcChoice

void ppdcChoice (
    const char *n,
    const char *t,
    const char *c
);

Parameters

n: Name of choice
t: Text of choice
c: Code of choice

ppdcConstraint

// Constraint

class ppdcConstraint : public ppdcShared {
public:
ppdcString *option1, *choice1, *option2, *choice2;
};

Members

choice2: Second choice

ppdcConstraint

void ppdcConstraint (
    const char *o1,
    const char *c1,
    const char *o2,
    const char *c2
);

Parameters

o1: First option
c1: First choice
o2: Second option
c2: Second choice

class ppdcDriver : public ppdcShared {
  public:
    ppdcArray *copyright;
    ppdcString *custom_size_code;
    ppdcString *default_font, *default_size;
    float left_margin, bottom_margin, right_margin, top_margin, max_width, max_length, min_width, min_length;
    ppdcArray *attrs, *constraints, *filters, *fonts, *groups, *profiles, *sizes;
    int model_number, manual_copies, color_device, throughput;
    ppdcDrvType type;
    int variable_paper_size;
    ppdcString *manufacturer, *model_name, *file_name, *pc_file_name, *version;
};

Members

copyright: Copyright strings
custom_size_code: Custom page size code, if any
default_size: Default size option
min_length: Minimum length (points)
sizes: Fixed sizes
throughput: Throughput in pages per minute
type: Driver type
variable_paper_size: Support variable sizes?
version: Version number

PPDC_NAME

void PPDC_NAME (
void add_attr(ppdcAttr *a
);

Parameters

a

add_constraint

void add_constraint (
ppdcConstraint *c
);

Parameters

c

add_copyright

void add_copyright (
const char *c
);

Parameters

c

add_filter

void add_filter (
ppdcFilter *f
);

Parameters

f

add_font

void add_font (
ppdcFont *f
);

Parameters

f

add_group

void add_group (
ppdcGroup *g
);

Parameters

g

add_profile

void add_profile (
ppdcProfile *p
);

Parameters

p

add_size

void add_size (
ppdcMediaSize *m
);

Parameters

m

find_attr

ppdcAttr *find_attr (
const char *k,
const char *s
);

Parameters

k: Keyword string
s: Spec string

Return Value

Attribute or NULL

find_group

ppdcGroup *find_group (
const char *n
);

Parameters

n: Group name

Return Value

Matching group or NULL

find_option

ppdcOption *find_option (
const char *n
);

Parameters

n: Option name

Return Value

Matching option or NULL

find_option_group

ppdcOption *find_option_group (
const char *n,
ppdcGroup **mg
);

Parameters

n: Option name
mg: Matching group or NULL

Return Value

Matching option or NULL

ppdcDriver

void ppdcDriver (
ppdcDriver *d
);

Parameters

d: Printer driver template

set_custom_size_code

void set_custom_size_code (
const char *c
);

Parameters

c: CustomPageSize code

set_default_font

void set_default_font (
ppdcFont *f
);

Parameters

f: Font

set_default_size

void set_default_size (
ppdcMediaSize *m
);

Parameters

m: Media size

set_file_name

void set_file_name (
const char *f
);

Parameters

f: Filename

set_manufacturer

void set_manufacturer (
const char *m
);

Parameters

m: Model name

set_model_name

void set_model_name (
const char *m
);

Parameters

m: Model name

set_pc_file_name

void set_pc_file_name (
const char *f
);

Parameters

f: Filename

set_version

void set_version (
const char *v
);

Parameters

v: Version

write_ppd_file

int write_ppd_file (
    cups_file_t *fp,
    ppdcCatalog *catalog,
    ppdcArray *locales,
    ppdcSource *src,
    ppdcLineEnding le
);

Parameters

fp: PPD file
catalog: Message catalog
locales: Additional languages to add
src: Driver source
le: Line endings to use

Return Value

0 on success, -1 on failure

~ppdcDriver

void ~ppdcDriver (void);

ppdcFile

// File

class ppdcFile {
  public:
    const char *filename;
    cups_file_t *fp;
    int line;
};

Members

filename: Filename
fp: File pointer
line: Line in file

get

Get a character from a file.

int get (void);

Return Value

peek

int peek (void);

Return Value

Next character in file

ppdcFile

void ppdcFile (
const char *f,
cups_file_t *ffp
);

Parameters

f: File to open
ffp: File pointer to use

~ppdcFile

void ~ppdcFile (void);

ppdcFilter

// Filter Program

class ppdcFilter : public ppdcShared {
  public:
    int cost;
    ppdcString *mime_type, *program;
};

Members

cost: Relative cost of filter
program: Filter program

ppdcFilter

void ppdcFilter (
    const char *t,
    const char *p,
    int c
);

Parameters

t: MIME type
p: Filter program
c: Relative cost

~ppdcFilter

void ~ppdcFilter (void);

ppdcFont

// Shared Font

class ppdcFont : public ppdcShared {
  public:
    ppdcString *name, *encoding, *version, *charset;
    ppdcFontStatus status;
};

Members

charset: Font charset
status: Font status (ROM or Disk)

ppdcFont

void ppdcFont (
    const char *n,
    const char *e,
    const char *v,
    const char *c,
    ppdcFontStatus s
);

Parameters

n: Name of font
e: Font encoding
v: Font version
c: Font charset
s: Font status

~ppdcFont

void ~ppdcFont (void);

ppdcGroup

// Group of Options

class ppdcGroup : public ppdcShared {
  public:
    ppdcArray *options;
    ppdcString *name, *text;
};

Members

options: Options
text: Human-readable text of option

PPDC_NAME

void PPDC_NAME (
void add_option(ppdcOption *o
);

Parameters

o

find_option

Find an option in a group.

ppdcOption *find_option (
const char *n
);

Parameters

n: Name of option

Return Value

ppdcGroup

void ppdcGroup (
ppdcGroup *g
);

Parameters

g: Group template

~ppdcGroup

void ~ppdcGroup (void);

ppdcInteger

// Shared integer

class ppdcInteger : public ppdcShared {
public:
int *value;
};

Members

value: Integer value

ppdcInteger

Integer value

void ppdcInteger (
int *v
);

Parameters

v

ppdcMediaSize

// Media Size

class ppdcMediaSize : public ppdcShared {
  public:
    ppdcString *size_code, *region_code;
    ppdcString *name, *text;
    float width, length, left, bottom, right, top;
};

Members

region_code: PageRegion code, if any
text: Human-readable text
top: Top limit in points

ppdcMediaSize

void ppdcMediaSize (
    const char *n,
    const char *t,
    float w,
    float l,
    float lm,
    float bm,
    float rm,
    float tm,
    const char *sc,
    const char *rc
);

Parameters

n: Name of media size
t: Text of media size
w: Width in points
l: Length in points
lm: Left margin in points
bm: Bottom margin in points
rm: Right margin in points
tm: Top margin in points
sc: PageSize code, if any
rc: PageRegion code, if any

~ppdcMediaSize

void ~ppdcMediaSize (void);

ppdcMessage

// Translation message

class ppdcMessage : public ppdcShared {
public:
ppdcString *id, *string;
};

Members

string: Translation string

ppdcMessage

void ppdcMessage (
const char *i,
const char *s
);

Parameters

i: ID
s: Text

~ppdcMessage

void ~ppdcMessage (void);

ppdcOption

// Option

class ppdcOption : public ppdcShared {
  public:
    ppdcArray *choices;
    ppdcString *defchoice;
    float order;
    ppdcOptSection section;
    ppdcString *name, *text;
    ppdcOptType type;
};

Members

choices: Choices
defchoice: Default choice
order: Order number
section: Section for option code
text: Human-readable text of option
type: Type of option

PPDC_NAME

void PPDC_NAME (
void add_choice(ppdcChoice *c
);

Parameters

c

find_choice

ppdcChoice *find_choice (
const char *n
);

Parameters

n: Name of choice

Return Value

Choice or NULL

ppdcOption

void ppdcOption (
ppdcOption *o
);

Parameters

o: Template option

set_defchoice

void set_defchoice (
ppdcChoice *c
);

Parameters

c: Choice

~ppdcOption

void ~ppdcOption (void);

ppdcProfile

// Color Profile

class ppdcProfile : public ppdcShared {
  public:
    ppdcString *resolution, *media_type;
    float density, gamma, profile[9];
};

Members

media_type: Media type name
profile[9]: Color profile matrix

ppdcProfile

void ppdcProfile (
    const char *r,
    const char *m,
    float d,
    float g,
    const float *p
);

Parameters

r: Resolution name
m: Media type name
d: Density
g: Gamma
p: 3x3 transform matrix

~ppdcProfile

void ~ppdcProfile (void);

ppdcShared

// Shared Data Value

class ppdcShared {
private:
int use;
};

Members

use: Use count (delete when 0)

class_name

virtual const char *class_name (void);

Return Value

ppdcShared

void ppdcShared (void);

release

void release (void);

retain

void retain (void);

~ppdcShared

void ~ppdcShared (void);

ppdcSource

// Source File

class ppdcSource : public ppdcShared {
  public:
    int cond_state, *cond_current, cond_stack[101];
    static const char *driver_types[];
    ppdcString *filename;
    static ppdcArray *includes;
    ppdcArray *base_fonts, *drivers, *po_files, *sizes, *vars;
};