admin
45b8ddd483
Printing. An app that wanted to print had nothing in ltk to ask the user where and how, nor to reach a printer. `ltk::print` (`src/print/`) is a dialog built as `FileChooser` is: the app holds a `PrintDialog`, puts its `view()` in its own and hands its `PrintDialogMsg`s to `update()`, which returns a `PrintEvent`; `wrap` makes the app's message of the dialog's, so the printer list reaches it through the app's `ChannelSender`. It offers the destination, the printers CUPS knows with their state and "Save as PDF", the number of copies, all pages or a range such as `1-3, 5, 8-`, the paper (A4, Letter, Legal, A3, A5), the orientation, the margins, the scale, two-sided printing, colour and background graphics, the copies, sides and colour only for a printer. `PrintOptions` holds what was chosen and survives between dialogs, `parse_pages` and `format_pages` read and write the ranges. On a desktop the dialog is a card with ltk's `dialog()`, the preview on the left and the settings on the right; `compact()` makes it a whole page for a phone. `.printer( name )` and `.save_as_pdf()` choose where it starts. The preview. With `.preview( true )` the dialog asks the app for one with `PrintEvent::Preview( options )` whenever a setting that moves the pages changes, and shows what the app hands back to `PrintDialogMsg::previewed`, a `Preview` of some pages as RGBA with the document's total, one page at a time with buttons to move between them, greyed when colour is off. While one is being rendered a new request waits and is sent only if the layout changed meanwhile, so turning the scale quickly does not stack renders; until the first arrives the sheet's box shows "Preparing the preview…", kept to the sheet's width so it does not push the settings aside. CUPS. `print/cups.rs` loads `libcups.so.2` with `dlopen` at first use, so ltk neither links against it nor needs its headers, and a system without CUPS only loses its printers. It uses the destinations API, which also lists the network's driverless printers that have no queue: `printers()` with the default first, `print( printer, title, options, pdf )` sending the PDF as one job with `copies`, `media` as a PWG name, `sides` and `print-color-mode`, `jobs()`, `cancel()` and `set_default()`, which writes the user's `lpoptions`. `ltk::print::send`, `list_printers`, `jobs`, `cancel_job` and `set_default` run them on a thread and answer through the app's sender; `ltk::print::blocking` exposes them as they are, for code that has its own thread, such as a portal backend. `print/none.rs` stands in on Windows, Android and the browser, where only saving as PDF is offered. The portal. An app in a Flatpak cannot reach the CUPS socket. When `/.flatpak-info` exists, the dialog shows nothing of its own: it calls `org.freedesktop.portal.Print.PreparePrint` with the options as GTK's print settings and page setup, and the portal's own dialog answers; `Destination::Portal` then carries its token, and `send` passes the PDF to `Print` through a memfd. The Response signal is subscribed to on the request's path before the call, so a quick answer is not missed. `print/gtk.rs` translates `PrintOptions` to and from GTK's keys (`n-copies`, `page-ranges` counted from zero, `duplex`, `use-color`, `scale` in percent, the paper by its PWG name and size in millimetres), which a portal backend uses for the other direction. zbus 4, the one accesskit_unix already brings, joins the `wayland` feature for it. The dialog's strings are in ltk's seven locales. `file_chooser::view::icon` is shared with the dialog. Windows. The `windows` feature runs `ltk::run` in a Win32 window on Windows 10 1703 or later, with Windows's own frame, drawn through ANGLE's EGL and OpenGL ES when `libEGL.dll` and `libGLESv2.dll` sit beside the executable and in software through GDI otherwise (`src/platform/windows/`). It sizes the window by `App::window_size_hint` at the display's DPI and follows per-monitor DPI changes at fractional scales and the accessibility text size; it takes the mouse, the wheel, touch through `WM_POINTER`, and keys with Windows's repeat, dead keys and AltGr; it has the system clipboard, the cursor's shape, full screen, and moves and resizes begun from the app's own chrome, and keeps drawing while the window is moved or resized. Themes, fonts, keyboard layouts and MIME globs come from `ltk\` beside the executable, which `ltk::resource_dir` returns there by default; the font fallback chain and the monospace face are Windows's own, the system face stays the embedded Sora, and the file chooser offers each drive's root. A Win32 message loop cannot wait on calloop, so the runtime's timers and channels go through the queue the web backend already used: `build.rs` sets `cfg( queued_sources )` for both, and `AppData::dispatch_sources` moves from the web backend to `event_loop/sources.rs`. `Canvas::present_to` presents a GPU frame stretched over a window that a fractional scale left a pixel off it, and `EglContext::new_windows` and `create_native_surface` give ANGLE's display and an `HWND`'s surface. `App::save_state` is saved into `%LOCALAPPDATA%\<app_id>\` every 30 seconds, on exit and when the user's session ends, and restored as on Wayland: the part of the Wayland session runtime that does not speak the protocol, deciding why the app starts and handing it its bytes, is now `session_state::bootstrap`, which both backends call, with the file modes and the check for a running instance done each platform's way. `RunError::Window` reports a window Windows refused. `make windows-deps` and `make windows-check` typecheck the backend from Debian, compiling std from `rust-src`. `docs/windows.md` describes building, what ships beside the executable and what the backend does. ltk::dirs. `home`, `data_home`, `config_home`, `cache_home` and `state_home`: XDG's on Linux, with their usual fallbacks under the home folder, and on Windows `USERPROFILE`, `APPDATA` for data and settings and `LOCALAPPDATA` for the cache and state, an `XDG_*` variable that is set winning everywhere. An app finds its files there instead of reading `HOME` and the XDG variables itself, which on Windows are unset; ltk's own lookups of themes, keyboard layouts, MIME globs, the file chooser's folders and the session state now go through it, and `state_dir` takes the base it is given, its tests with it. Docs. The links to `WidgetId` in the crate's, `types`' and `App`'s documentation name the struct, since the `const fn` of the same name made them ambiguous to rustdoc. `README.md` names the other backends and `CHANGELOG.md` records the Windows backend and `ltk::dirs`. Not done. The print dialog has no CHANGELOG entry nor a page in `docs/widgets.md`. Under the portal there is no preview, since the portal's dialog gets the document only at the end. The desktop card's settings column does not scroll, so with a list open in a low window it may not fit. Tests cover the page ranges and the translation to GTK's keys, not the dialog, CUPS or the portal. On Windows there are no overlays, secondary surfaces or subsurfaces, no preedit for the input method and no accessibility.
107 lines
3.0 KiB
YAML
107 lines
3.0 KiB
YAML
date_picker:
|
|
month_1: "January"
|
|
month_2: "February"
|
|
month_3: "March"
|
|
month_4: "April"
|
|
month_5: "May"
|
|
month_6: "June"
|
|
month_7: "July"
|
|
month_8: "August"
|
|
month_9: "September"
|
|
month_10: "October"
|
|
month_11: "November"
|
|
month_12: "December"
|
|
dow_short_0: "S"
|
|
dow_short_1: "M"
|
|
dow_short_2: "T"
|
|
dow_short_3: "W"
|
|
dow_short_4: "T"
|
|
dow_short_5: "F"
|
|
dow_short_6: "S"
|
|
|
|
context_menu:
|
|
copy: "Copy"
|
|
cut: "Cut"
|
|
paste: "Paste"
|
|
delete: "Delete"
|
|
|
|
file_chooser:
|
|
open: "Open"
|
|
save: "Save as"
|
|
places: "Places"
|
|
up: "Up"
|
|
new_folder: "New folder"
|
|
cancel: "Cancel"
|
|
close: "Close"
|
|
mount: "Add a folder…"
|
|
empty: "This folder is empty"
|
|
name: "File name"
|
|
save_button: "Save"
|
|
folder_name: "Folder name"
|
|
create: "Create"
|
|
replace_question: "“%{name}” already exists. Replace it?"
|
|
keep: "Keep"
|
|
replace: "Replace"
|
|
home: "Home"
|
|
desktop: "Desktop"
|
|
documents: "Documents"
|
|
downloads: "Downloads"
|
|
music: "Music"
|
|
pictures: "Pictures"
|
|
videos: "Videos"
|
|
root: "Computer"
|
|
folder: "Folder"
|
|
not_found: "It is not there any more"
|
|
denied: "You are not allowed to open it"
|
|
exists: "There is already one with that name"
|
|
unsupported: "Not available here"
|
|
sort: "Sort"
|
|
sort_name: "Name"
|
|
sort_accessed: "Last access"
|
|
sort_size: "Size"
|
|
ascending: "Ascending"
|
|
descending: "Descending"
|
|
print:
|
|
title: "Print"
|
|
cancel: "Cancel"
|
|
print: "Print"
|
|
save: "Save"
|
|
destination: "Destination"
|
|
pdf: "Save as PDF"
|
|
searching: "Looking for printers…"
|
|
copies: "Copies"
|
|
pages: "Pages"
|
|
all_pages: "All"
|
|
some_pages: "Custom"
|
|
pages_hint: "For example 1-3, 5"
|
|
pages_bad: "Write page numbers and ranges separated by commas, such as 1-3, 5."
|
|
paper: "Paper"
|
|
orientation: "Orientation"
|
|
portrait: "Portrait"
|
|
landscape: "Landscape"
|
|
margins: "Margins"
|
|
margins_default: "Default"
|
|
margins_narrow: "Narrow"
|
|
margins_wide: "Wide"
|
|
margins_none: "None"
|
|
scale: "Scale"
|
|
sides: "Two-sided"
|
|
one_side: "Off"
|
|
long_edge: "Long edge"
|
|
short_edge: "Short edge"
|
|
color: "Colour"
|
|
backgrounds: "Background graphics"
|
|
preparing: "Preparing the preview…"
|
|
page_of: "Page %{page} of %{count}"
|
|
total: "%{count} in the document"
|
|
previous: "Previous page"
|
|
next: "Next page"
|
|
less: "Less"
|
|
more: "More"
|
|
ready: "Ready"
|
|
busy: "Printing"
|
|
stopped: "Stopped"
|
|
rejecting: "Not accepting jobs"
|
|
no_cups: "Printing is not available on this system."
|
|
failed: "The printer did not take the job."
|