====== Vega.Printers — Drucken ======
''Vega.Printers'' stellt die plattformunabhängige Druckabstraktion bereit. Eine Anwendung arbeitet mit ''TPrinter'', ''TPaperSize'' und ''TPrinterCanvas''; das Backend entscheidet, ob tatsächlich gedruckt werden kann und wohin die Ausgabe geht.
===== Grundtypen =====
^ Typ ^ Zweck ^
| ''TPrinter'' | Drucker auswählen, Dokument- und Seitengrenzen verwalten, Seiten beginnen/beenden und Ausgabe schreiben |
| ''TPaperSize'' | Standardpapier oder benutzerdefinierte Breite/Höhe verwalten |
| ''TPaperRect'' | physische Papierfläche und nutzbare Arbeitsfläche |
| ''TPrinterCanvas'' | ''TCanvas'' für eine Druckseite mit DPI, Rändern und Seitennummer |
| ''TPostScriptWriter'' | interner Writer für dateibasierte bzw. rohe Druckausgabe |
Die Einheiten werden in **Punkten** beschrieben; ''VEGA_POINTS_PER_INCH'' ist 72. Die Standardauflösung des Druckers ist ''VEGA_DEFAULT_DPI'' (150), wenn das Backend keine eigene Auflösung meldet.
===== Papier =====
var paper: TPaperSize := NewPaperSize();
paper.SetPaperName("A4");
var w: int64 := paper.Width();
var h: int64 := paper.Height();
var rect: TPaperRect := paper.PaperRect();
''SetPaperName'' liefert ''false'', wenn das Papier unbekannt ist. Für Sonderformate steht ''SetCustomSize(width, height)'' bereit. Die freien Funktionen ''PaperNameAt'', ''PaperWidthAt'', ''PaperHeightAt'' und ''PaperIndexOfName'' erlauben die Aufzählung der Standardformate.
===== Drucker und Seite =====
var p: TPrinter := NewPrinter(backend);
if (p.CanPrint()) {
p.SetTitle("Bericht");
p.PaperSize.SetPaperName("A4");
if (p.BeginDoc()) {
if (p.BeginPage()) {
p.Canvas.SetTitle("Seite 1");
p.Canvas.ClearPage();
p.Canvas.TextOut(72, 72, "Hallo Druckwelt");
p.EndPage();
}
p.EndDoc();
}
}
Für mehrere Seiten wird ''NewPage'' zwischen ''EndPage'' und ''BeginPage'' verwendet. ''Abort'' bricht einen laufenden Druck ab. ''Write'' und ''WriteText'' sind für rohe bzw. textuelle Ausgabe vorgesehen; normalerweise zeichnet man über ''TPrinterCanvas''.
===== Backend-Grenzen =====
''CanPrint()'' und ''CanRenderCopies()'' müssen vor einer UI-Aktion abgefragt werden. Ein Backend darf melden, dass kein Drucker vorhanden ist. LyxOS kann die Ausgabe als Datei bereitstellen, auch wenn kein physischer Spooler vorhanden ist. Die API darf in diesem Fall keinen Drucker vortäuschen.
Die drei Druckdialoge stehen in [[lyx_-_programmiersprache:vega:units:printdlgs|Vega.PrintDlgs]].
Letzte Aktualisierung: 2026-11-09 — neu für Vega 0.6.0.