Files
rtc/tools/CreateReferenceManual.ps1
T
2026-08-03 13:48:52 +02:00

278 lines
11 KiB
PowerShell

$ErrorActionPreference = "Stop"
$outputDirectory = Join-Path $PSScriptRoot "..\docs"
$outputPath = Join-Path $outputDirectory "Rtc5MiniControl-Referenzhandbuch.pdf"
New-Item -ItemType Directory -Force -Path $outputDirectory | Out-Null
$encoding = [System.Text.Encoding]::GetEncoding(1252)
function ConvertTo-PdfString {
param([string]$Text)
$bytes = $encoding.GetBytes($Text)
$builder = [System.Text.StringBuilder]::new()
foreach ($byte in $bytes) {
if ($byte -eq 40 -or $byte -eq 41 -or $byte -eq 92) {
[void]$builder.Append("\")
[void]$builder.Append([char]$byte)
}
elseif ($byte -lt 32 -or $byte -gt 126) {
[void]$builder.Append("\")
[void]$builder.Append([Convert]::ToString($byte, 8).PadLeft(3, "0"))
}
else {
[void]$builder.Append([char]$byte)
}
}
return $builder.ToString()
}
function Add-TextLine {
param(
[System.Text.StringBuilder]$Builder,
[string]$Font,
[double]$Size,
[int]$X,
[int]$Y,
[string]$Text
)
$escaped = ConvertTo-PdfString $Text
[void]$Builder.AppendFormat([System.Globalization.CultureInfo]::InvariantCulture, "BT /{0} {1:0.##} Tf {2} {3} Td ({4}) Tj ET`n", $Font, $Size, $X, $Y, $escaped)
}
function Add-Section {
param(
[System.Text.StringBuilder]$Builder,
[ref]$Y,
[string]$Title
)
$Y.Value -= 18
Add-TextLine $Builder "F2" 12 42 $Y.Value $Title
$Y.Value -= 14
}
function Add-ParagraphLine {
param(
[System.Text.StringBuilder]$Builder,
[ref]$Y,
[string]$Text
)
Add-TextLine $Builder "F1" 9.7 42 $Y.Value $Text
$Y.Value -= 13
}
function Add-Bullet {
param(
[System.Text.StringBuilder]$Builder,
[ref]$Y,
[string]$Text
)
Add-TextLine $Builder "F1" 9.7 52 $Y.Value "- $Text"
$Y.Value -= 13
}
function Add-CodeLine {
param(
[System.Text.StringBuilder]$Builder,
[ref]$Y,
[string]$Text
)
Add-TextLine $Builder "F3" 9.5 58 $Y.Value $Text
$Y.Value -= 12
}
function Add-Header {
param(
[System.Text.StringBuilder]$Builder,
[string]$Title,
[string]$PageText
)
[void]$Builder.Append("0.08 0.18 0.27 rg 0 806 595 36 re f`n")
[void]$Builder.Append("1 1 1 rg`n")
Add-TextLine $Builder "F2" 16 42 820 $Title
Add-TextLine $Builder "F1" 9 505 820 $PageText
[void]$Builder.Append("0 0 0 rg`n")
}
function Add-Footer {
param(
[System.Text.StringBuilder]$Builder,
[string]$Text
)
[void]$Builder.Append("0.75 0.75 0.75 RG 42 38 m 553 38 l S`n")
[void]$Builder.Append("0.35 0.35 0.35 rg`n")
Add-TextLine $Builder "F1" 8 42 24 $Text
[void]$Builder.Append("0 0 0 rg`n")
}
function New-PageOneContent {
$builder = [System.Text.StringBuilder]::new()
Add-Header $builder "RTC5 Mini Control - Referenzhandbuch" "Seite 1/2"
$y = 780
Add-Section $builder ([ref]$y) "Zweck und Sicherheit"
Add-ParagraphLine $builder ([ref]$y) "Diese Kurzreferenz beschreibt Start, Einrichtung und Bedienung der WinForms-Testapp"
Add-ParagraphLine $builder ([ref]$y) "fuer SCANLAB RTC5 mit intelliSCAN III. Die Laserleistung wird extern gesetzt."
Add-Bullet $builder ([ref]$y) "Vor jedem Test Shutter, Strahlweg, Probe und Interlocks pruefen."
Add-Bullet $builder ([ref]$y) "LASERON an schaltet den RTC-LASER-Ausgang; beim ersten Klick erscheint eine Warnung."
Add-Bullet $builder ([ref]$y) "Fuer neue CSVs zuerst CSV ohne Laser oder sehr kleine Leistung verwenden."
Add-Section $builder ([ref]$y) "Programm starten"
Add-Bullet $builder ([ref]$y) "Release-EXE starten: bin\Release\net8.0-windows\Rtc5MiniControl.exe"
Add-Bullet $builder ([ref]$y) "Falls aus Visual Studio: Projekt Rtc5MiniControl oeffnen und Starten/F5 ausfuehren."
Add-Bullet $builder ([ref]$y) "Das Programm laedt gespeicherte Einstellungen automatisch aus %AppData%."
Add-Bullet $builder ([ref]$y) "Links sind Tabs fuer Grundeinstellungen, Manuell und Prozess; rechts die Vorschau."
Add-Bullet $builder ([ref]$y) "Stop / Laser aus bleibt oben in der Seitenleiste immer erreichbar."
Add-Section $builder ([ref]$y) "RTC5 einrichten"
Add-Bullet $builder ([ref]$y) "RTC-Dateien: Ordner mit RTC5DLLx64.dll, RTC5DAT.dat, RTC5RBF.rbf und RTC5OUT.out."
Add-Bullet $builder ([ref]$y) "Korrekturfile: optional eine passende SCANLAB-.ct5 Datei auswaehlen."
Add-Bullet $builder ([ref]$y) "Kalib. bits/mm: Umrechnung von mm in RTC-Koordinaten, z.B. 1000 bis 100000."
Add-Bullet $builder ([ref]$y) "Laser Mode und Laser Ctrl hex gemaess System setzen; Default ist Mode 0 und Ctrl 0x0."
Add-Bullet $builder ([ref]$y) "LASERON low-aktiv / invertiert setzen, wenn das System active-low erwartet."
Add-Bullet $builder ([ref]$y) "Verbinden druecken. Im Log muessen Seriennummer, DLL-Version und Status erscheinen."
Add-Section $builder ([ref]$y) "Manuelle Tests"
Add-Bullet $builder ([ref]$y) "Schritt mm einstellen und mit X-/X+/Y-/Y+ kleine Jump-Bewegungen ausloesen."
Add-Bullet $builder ([ref]$y) "Home 0,0 springt mit Laser aus auf den Ursprung und setzt die interne Positionsanzeige."
Add-Bullet $builder ([ref]$y) "LASERON an/aus testet den Laser-Ausgang direkt; Farben: rot = an, gruen = aus."
Add-Bullet $builder ([ref]$y) "Stop / Laser aus stoppt die Ausfuehrung und erzwingt LASERON aus."
Add-Footer $builder "RTC5 Mini Control - Kurzreferenz fuer neue Benutzer"
return $builder.ToString()
}
function New-PageTwoContent {
$builder = [System.Text.StringBuilder]::new()
Add-Header $builder "RTC5 Mini Control - Referenzhandbuch" "Seite 2/2"
$y = 780
Add-Section $builder ([ref]$y) "CSV abarbeiten"
Add-Bullet $builder ([ref]$y) "CSV-Datei auswaehlen und CSV laden druecken. Rechts erscheint die Geometrie-Vorschau."
Add-Bullet $builder ([ref]$y) "Koordinaten sind Millimeter. X,Y,Z ist erlaubt; Z wird ignoriert."
Add-Bullet $builder ([ref]$y) "Dezimalpunkt und deutsches Dezimalkomma werden akzeptiert."
Add-Bullet $builder ([ref]$y) "Fortlaufende Zeilen werden als Markierbewegung ausgefuehrt."
Add-Bullet $builder ([ref]$y) "Eine Leerzeile trennt Konturen: der naechste Punkt wird mit Laser aus angefahren."
Add-Bullet $builder ([ref]$y) "Wiederholungen bestimmt, wie oft dieselbe CSV nacheinander ausgefuehrt wird."
Add-Bullet $builder ([ref]$y) "Job abbrechen nach aktueller Wiederholung stoppt geordnet nach dem laufenden Durchlauf."
Add-Bullet $builder ([ref]$y) "Skalierung multipliziert X/Y; X-Achse und Y-Achse koennen gespiegelt werden."
Add-Bullet $builder ([ref]$y) "CSV ohne Laser faehrt alle Punkte als sichere Jump-Bewegungen ab."
Add-Bullet $builder ([ref]$y) "Geometrie-Vorschau zeichnet die CSV-Kontur nur bei aktivierter Checkbox."
Add-Bullet $builder ([ref]$y) "Fit oder Doppelklick passt ein; Ctrl+Mausrad zoomt; Ziehen verschiebt die Ansicht."
Add-Bullet $builder ([ref]$y) "Tabellenvorschau anzeigen blendet die Koordinatentabelle bei Bedarf ein."
Add-Bullet $builder ([ref]$y) "Grenzcheck prueft vor dem Start X/Y min/max und bricht bei Ausreissern ab."
Add-Bullet $builder ([ref]$y) "CSV starten beginnt die Listenverarbeitung; am Ende springt die App auf X/Y 0,0."
Add-Section $builder ([ref]$y) "Minimalbeispiel CSV"
[void]$builder.Append("0.94 0.94 0.94 rg 48 465 250 88 re f`n0 0 0 rg`n")
Add-CodeLine $builder ([ref]$y) "0,0"
Add-CodeLine $builder ([ref]$y) "1,0"
Add-CodeLine $builder ([ref]$y) "1,1"
Add-CodeLine $builder ([ref]$y) ""
Add-CodeLine $builder ([ref]$y) "2,1"
Add-CodeLine $builder ([ref]$y) "2,2"
$y -= 4
Add-ParagraphLine $builder ([ref]$y) "Interpretation: 0,0 wird angefahren, 1,0 und 1,1 werden markiert."
Add-ParagraphLine $builder ([ref]$y) "Nach der Leerzeile wird 2,1 mit Laser aus angesprungen, 2,2 wird markiert."
Add-Section $builder ([ref]$y) "Einstellungen speichern"
Add-Bullet $builder ([ref]$y) "Einstellungen speichern schreibt Pfade, Laserlogik, Kalibrierung, Speed und CSV-Optionen."
Add-Bullet $builder ([ref]$y) "Speicherort: %AppData%\Rtc5MiniControl\settings.json"
Add-Bullet $builder ([ref]$y) "Beim naechsten Start werden die Werte automatisch geladen."
Add-Section $builder ([ref]$y) "Schnelle Fehlersuche"
Add-Bullet $builder ([ref]$y) "DLL nicht gefunden: RTC-Dateien-Ordner pruefen und 64-Bit-DLL verwenden."
Add-Bullet $builder ([ref]$y) "Keine Karte: Treiber, Stromversorgung, Karte 1 und exklusiven Zugriff pruefen."
Add-Bullet $builder ([ref]$y) "Laserlogik falsch: LASERON low-aktiv / invertiert umschalten und mit Messgeraet pruefen."
Add-Bullet $builder ([ref]$y) "CSV stoppt sofort: Grenzcheck, Zahlenformat und Leerzeilen kontrollieren."
Add-Footer $builder "Stand: 2026-05-12 - zweiseitige Kurzreferenz"
return $builder.ToString()
}
function New-PdfStreamObject {
param([string]$Content)
$contentBytes = $encoding.GetBytes($Content)
$header = $encoding.GetBytes("<< /Length $($contentBytes.Length) >>`nstream`n")
$footer = $encoding.GetBytes("`nendstream")
$stream = [System.IO.MemoryStream]::new()
$stream.Write($header, 0, $header.Length)
$stream.Write($contentBytes, 0, $contentBytes.Length)
$stream.Write($footer, 0, $footer.Length)
return $stream.ToArray()
}
function New-PdfTextObject {
param([string]$Text)
return $encoding.GetBytes($Text)
}
function Write-Bytes {
param(
[System.IO.MemoryStream]$Stream,
[byte[]]$Bytes
)
$Stream.Write($Bytes, 0, $Bytes.Length)
}
function Write-Text {
param(
[System.IO.MemoryStream]$Stream,
[string]$Text
)
$bytes = $encoding.GetBytes($Text)
Write-Bytes $Stream $bytes
}
$pageOne = New-PageOneContent
$pageTwo = New-PageTwoContent
$resources = "<< /Font << /F1 5 0 R /F2 6 0 R /F3 7 0 R >> >>"
$objects = @(
(New-PdfTextObject "<< /Type /Catalog /Pages 2 0 R >>"),
(New-PdfTextObject "<< /Type /Pages /Kids [3 0 R 4 0 R] /Count 2 >>"),
(New-PdfTextObject "<< /Type /Page /Parent 2 0 R /MediaBox [0 0 595 842] /Resources $resources /Contents 8 0 R >>"),
(New-PdfTextObject "<< /Type /Page /Parent 2 0 R /MediaBox [0 0 595 842] /Resources $resources /Contents 9 0 R >>"),
(New-PdfTextObject "<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica /Encoding /WinAnsiEncoding >>"),
(New-PdfTextObject "<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding >>"),
(New-PdfTextObject "<< /Type /Font /Subtype /Type1 /BaseFont /Courier /Encoding /WinAnsiEncoding >>"),
(New-PdfStreamObject $pageOne),
(New-PdfStreamObject $pageTwo)
)
$pdf = [System.IO.MemoryStream]::new()
Write-Text $pdf "%PDF-1.4`n"
$offsets = New-Object System.Collections.Generic.List[int]
for ($index = 0; $index -lt $objects.Count; $index++) {
$objectNumber = $index + 1
$offsets.Add([int]$pdf.Position)
Write-Text $pdf "$objectNumber 0 obj`n"
Write-Bytes $pdf $objects[$index]
Write-Text $pdf "`nendobj`n"
}
$xrefOffset = [int]$pdf.Position
Write-Text $pdf "xref`n0 $($objects.Count + 1)`n"
Write-Text $pdf "0000000000 65535 f `n"
foreach ($offset in $offsets) {
Write-Text $pdf ("{0:0000000000} 00000 n `n" -f $offset)
}
Write-Text $pdf "trailer`n<< /Size $($objects.Count + 1) /Root 1 0 R >>`nstartxref`n$xrefOffset`n%%EOF`n"
[System.IO.File]::WriteAllBytes((Resolve-Path $outputDirectory).Path + "\Rtc5MiniControl-Referenzhandbuch.pdf", $pdf.ToArray())
Write-Host $outputPath