1/*
2 * PWG media API definitions for CUPS.
3 *
4 * Copyright 2009-2017 by Apple Inc.
5 *
6 * These coded instructions, statements, and computer programs are the
7 * property of Apple Inc. and are protected by Federal copyright
8 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
9 * which should have been included with this file. If this file is
10 * missing or damaged, see the license at "http://www.cups.org/".
11 *
12 * This file is subject to the Apple OS-Developed Software exception.
13 */
14
15#ifndef _CUPS_PWG_H_
16# define _CUPS_PWG_H_
17
18
19/*
20 * C++ magic...
21 */
22
23# ifdef __cplusplus
24extern "C" {
25# endif /* __cplusplus */
26
27
28/*
29 * Macros...
30 */
31
32/* Convert from points to hundredths of millimeters */
33# define PWG_FROM_POINTS(n) (int)(((n) * 2540 + 36) / 72)
34/* Convert from hundredths of millimeters to points */
35# define PWG_TO_POINTS(n) ((n) * 72.0 / 2540.0)
36
37
38/*
39 * Types and structures...
40 */
41
42typedef struct pwg_map_s /**** Map element - PPD to/from PWG @exclude all@ */
43{
44 char *pwg, /* PWG media keyword */
45 *ppd; /* PPD option keyword */
46} pwg_map_t;
47
48typedef struct pwg_media_s /**** Common media size data ****/
49{
50 const char *pwg, /* PWG 5101.1 "self describing" name */
51 *legacy, /* IPP/ISO legacy name */
52 *ppd; /* Standard Adobe PPD name */
53 int width, /* Width in 2540ths */
54 length; /* Length in 2540ths */
55} pwg_media_t;
56
57typedef struct pwg_size_s /**** Size element - PPD to/from PWG @exclude all@ */
58{
59 pwg_map_t map; /* Map element */
60 int width, /* Width in 2540ths */
61 length, /* Length in 2540ths */
62 left, /* Left margin in 2540ths */
63 bottom, /* Bottom margin in 2540ths */
64 right, /* Right margin in 2540ths */
65 top; /* Top margin in 2540ths */
66} pwg_size_t;
67
68
69/*
70 * Functions...
71 */
72
73extern int pwgFormatSizeName(char *keyword, size_t keysize,
74 const char *prefix, const char *name,
75 int width, int length,
76 const char *units) _CUPS_API_1_7;
77extern int pwgInitSize(pwg_size_t *size, ipp_t *job,
78 int *margins_set) _CUPS_API_1_7;
79extern pwg_media_t *pwgMediaForLegacy(const char *legacy) _CUPS_API_1_7;
80extern pwg_media_t *pwgMediaForPPD(const char *ppd) _CUPS_API_1_7;
81extern pwg_media_t *pwgMediaForPWG(const char *pwg) _CUPS_API_1_7;
82extern pwg_media_t *pwgMediaForSize(int width, int length) _CUPS_API_1_7;
83
84# ifdef __cplusplus
85}
86# endif /* __cplusplus */
87
88#endif /* !_CUPS_PWG_H_ */
89