1/*
2 * PWG media API definitions for CUPS.
3 *
4 * Copyright 2009-2013 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 */
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 */
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