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 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275
|
"""
Usage documentation at: <https://py-pdf.github.io/fpdf2/PageFormatAndOrientation.html#viewer-preferences>
"""
from typing import TYPE_CHECKING, Optional
from .enums import Duplex, PageBoundaries, PageMode, TextDirection
from .syntax import Name, build_obj_dict, create_dictionary_string
if TYPE_CHECKING:
from .encryption import StandardSecurityHandler
class ViewerPreferences:
"Specifies the way the document shall be displayed on the screen"
def __init__(
self,
hide_toolbar: bool = False,
hide_menubar: bool = False,
hide_window_u_i: bool = False,
fit_window: bool = False,
center_window: bool = False,
display_doc_title: bool = False,
non_full_screen_page_mode: PageMode = PageMode.USE_NONE,
num_copies: Optional[int] = None,
print_page_range: Optional[list[int]] = None,
direction: Optional[TextDirection | str] = None,
duplex: Optional[Duplex | str] = None,
view_area: Optional[PageBoundaries | str] = None,
view_clip: Optional[PageBoundaries | str] = None,
print_area: Optional[PageBoundaries | str] = None,
print_clip: Optional[PageBoundaries | str] = None,
print_scaling: Optional[str] = None,
) -> None:
self._min_pdf_version = "1.3"
self.hide_toolbar = hide_toolbar
"""
(`bool`)
A flag specifying whether to hide the conforming reader’s tool bars when the document is active
"""
self.hide_menubar = hide_menubar
"""
(`bool`)
A flag specifying whether to hide the conforming reader’s menu bar when the document is active
"""
self.hide_window_u_i = hide_window_u_i
"""
(`bool`)
A flag specifying whether to hide user interface elements in the document’s window
(such as scroll bars and navigation controls), leaving only the document’s contents displayed
"""
self.fit_window = fit_window
"""
(`bool`)
A flag specifying whether to resize the document’s window to fit the size of the first displayed page
"""
self.center_window = center_window
"""
(`bool`)
A flag specifying whether to position the document’s window in the center of the screen
"""
self.display_doc_title = display_doc_title
"""
(`bool`)
A flag specifying whether the window’s title bar should display the document title
taken from the Title entry of the document information dictionary.
If false, the title bar should instead display the name of the PDF file containing the document.
"""
self.non_full_screen_page_mode = non_full_screen_page_mode
"""
(`fpdf.enums.PageMode`)
The document’s page mode, specifying how to display the document on exiting full-screen mode
"""
self.num_copies = num_copies
"""
(`int`)
The number of copies that shall be printed when the print dialog is opened for this file.
Values outside this range shall be ignored. Default value: as defined by the conforming reader, but typically 1
"""
self.print_page_range = print_page_range
"""
(`list[int]`)
The page numbers used to initialize the print dialog box when the file is printed.
The array shall contain an even number of integers to be interpreted in pairs,
with each pair specifying the first and last pages in a sub-range of pages to be printed.
The first page of the PDF file shall be denoted by 1.
"""
self.direction = direction
"""
(`fpdf.enums.TextDirection`)
The predominant reading order for text.
"""
self.duplex = duplex
"""
(`fpdf.enums.Duplex`)
The paper handling option that shall be used when printing the file from the print dialog.
"""
self.view_area = view_area
"""
(`fpdf.enums.PageBoundaries`)
The name of the page boundary representing the area of a page that shall be displayed when viewing the document on the screen.
Default value: CropBox.
"""
self.view_clip = view_clip
"""
(`fpdf.enums.PageBoundaries`)
The name of the page boundary to which the contents of a page shall be clipped when viewing the document on the screen.
Default value: CropBox.
"""
self.print_area = print_area
"""
(`fpdf.enums.PageBoundaries`)
The name of the page boundary representing the area of a page that shall be rendered when printing the document.
Default value: CropBox.
"""
self.print_clip = print_clip
"""
(`fpdf.enums.PageBoundaries`)
The name of the page boundary to which the contents of a page shall be clipped when printing the document.
Default value: CropBox.
"""
self.print_scaling = print_scaling
"""
The page scaling option that shall be selected when a print dialogue is displayed for this document.
Valid values are:
* `"None"`, which indicates no page scaling
* `"AppDefault"`, which indicates the interactive PDF processor’s default print scaling
If this entry is not specified or has an unrecognised value, `AppDefault` shall be used.
"""
def _set_min_pdf_version(self, version: str) -> None:
self._min_pdf_version = max(self._min_pdf_version, version)
@property
def non_full_screen_page_mode(self) -> Optional[PageMode]:
return self._non_full_screen_page_mode
@non_full_screen_page_mode.setter
def non_full_screen_page_mode(self, page_mode: Optional[PageMode | str]) -> None:
self._non_full_screen_page_mode = (
None if page_mode is None else PageMode.coerce(page_mode)
)
if self._non_full_screen_page_mode in (
PageMode.FULL_SCREEN,
PageMode.USE_ATTACHMENTS,
):
raise ValueError(
f"{self.non_full_screen_page_mode} is not a supported value for NonFullScreenPageMode"
)
@property
def num_copies(self) -> Optional[int]:
return self._num_copies
@num_copies.setter
def num_copies(self, num_copies: Optional[int]) -> None:
if num_copies is not None:
self._set_min_pdf_version("1.7")
self._num_copies = num_copies
@property
def print_page_range(self) -> Optional[list[int]]:
return self._print_page_range
@print_page_range.setter
def print_page_range(self, print_page_range: Optional[list[int]]) -> None:
if print_page_range is not None:
self._set_min_pdf_version("1.7")
self._print_page_range = print_page_range
@property
def direction(self) -> Optional[TextDirection]:
return self._direction
@direction.setter
def direction(self, direction: Optional[TextDirection | str]) -> None:
self._direction = None if direction is None else TextDirection.coerce(direction)
@property
def display_doc_title(self) -> bool:
return self._display_doc_title
@display_doc_title.setter
def display_doc_title(self, display_doc_title: bool) -> None:
if display_doc_title:
self._set_min_pdf_version("1.4")
self._display_doc_title = display_doc_title
@property
def duplex(self) -> Optional[Duplex]:
return self._duplex
@duplex.setter
def duplex(self, duplex: Optional[Duplex | str]) -> None:
if duplex is not None:
self._set_min_pdf_version("1.7")
self._duplex = None if duplex is None else Duplex.coerce(duplex)
@property
def view_area(self) -> Optional[PageBoundaries]:
return self._view_area
@view_area.setter
def view_area(self, view_area: Optional[PageBoundaries | str]) -> None:
if view_area is not None:
self._set_min_pdf_version("1.4")
self._view_area = (
None if view_area is None else PageBoundaries.coerce(view_area)
)
@property
def view_clip(self) -> Optional[PageBoundaries]:
return self._view_clip
@view_clip.setter
def view_clip(self, view_clip: Optional[PageBoundaries | str]) -> None:
if view_clip is not None:
self._set_min_pdf_version("1.4")
self._view_clip = (
None if view_clip is None else PageBoundaries.coerce(view_clip)
)
@property
def print_area(self) -> Optional[PageBoundaries]:
return self._print_area
@print_area.setter
def print_area(self, print_area: Optional[PageBoundaries | str]) -> None:
if print_area is not None:
self._set_min_pdf_version("1.4")
self._print_area = (
None if print_area is None else PageBoundaries.coerce(print_area)
)
@property
def print_clip(self) -> Optional[PageBoundaries]:
return self._print_clip
@print_clip.setter
def print_clip(self, print_clip: Optional[PageBoundaries | str]) -> None:
if print_clip is not None:
self._set_min_pdf_version("1.4")
self._print_clip = (
None if print_clip is None else PageBoundaries.coerce(print_clip)
)
@property
def print_scaling(self) -> Optional[Name]:
return self._print_scaling
@print_scaling.setter
def print_scaling(self, print_scaling: Optional[str]) -> None:
if print_scaling is None:
self._print_scaling = None
return
self._set_min_pdf_version("1.6")
if print_scaling not in ("None", "AppDefault"):
raise ValueError(f"Invalid {print_scaling=} value provided")
self._print_scaling = Name(print_scaling)
def serialize(
self,
_security_handler: Optional["StandardSecurityHandler"] = None,
_obj_id: Optional[int] = None,
) -> str:
obj_dict = build_obj_dict(
{key: getattr(self, key) for key in dir(self)},
_security_handler=_security_handler,
_obj_id=_obj_id,
)
return create_dictionary_string(obj_dict)
|