1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
// Copyright 2021 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef PRINTING_BACKEND_PRINT_BACKEND_UTILS_H_
#define PRINTING_BACKEND_PRINT_BACKEND_UTILS_H_
#include <string>
#include <string_view>
#include "base/component_export.h"
#include "printing/buildflags/buildflags.h"
#if BUILDFLAG(USE_CUPS)
#include "printing/backend/cups_printer.h"
#include "printing/backend/print_backend.h"
#endif // BUILDFLAG(USE_CUPS)
namespace gfx {
class Size;
}
namespace printing {
enum class Unit {
kInches,
kMillimeters,
};
// Parses the media name expressed by `value` into the size of the media
// in microns. Returns an empty size if `value` does not contain the display
// name nor the dimension, or if `value` contains a prefix of
// media sizes not meant for users' eyes.
COMPONENT_EXPORT(PRINT_BACKEND)
gfx::Size ParsePaperSize(std::string_view value);
#if BUILDFLAG(USE_CUPS)
// Helper functions to resolve display name, this is used on
// multiple places to encapsulate differences in CUPS implementations on
// various platforms.
COMPONENT_EXPORT(PRINT_BACKEND)
std::string GetDisplayName(const std::string& printer_name,
std::string_view info);
// Helper functions to resolve printer description, this is used on
// multiple places to encapsulate differences in CUPS implementations on
// various platforms.
COMPONENT_EXPORT(PRINT_BACKEND)
std::string_view GetPrinterDescription(std::string_view drv_info,
std::string_view info);
// Calculates a paper's printable area in microns from its size in microns and
// its four margins in PWG units.
COMPONENT_EXPORT(PRINT_BACKEND)
gfx::Rect PrintableAreaFromSizeAndPwgMargins(const gfx::Size& size_um,
int bottom_pwg,
int left_pwg,
int right_pwg,
int top_pwg);
// Calculates a paper's four margins in microns from its size and printable
// area in microns.
COMPONENT_EXPORT(PRINT_BACKEND)
void MarginsMicronsFromSizeAndPrintableArea(const gfx::Size& size_um,
const gfx::Rect& printable_area_um,
int* bottom_um,
int* left_um,
int* right_um,
int* top_um);
// Converts a margin value from microns to PWG units and returns the result. The
// value in microns must be obtained from the printer and must be convertible to
// PWG units.
COMPONENT_EXPORT(PRINT_BACKEND)
int MarginMicronsToPWG(int margin_um);
#endif // BUILDFLAG(USE_CUPS)
} // namespace printing
#endif // PRINTING_BACKEND_PRINT_BACKEND_UTILS_H_
|
