Initialer Import
This commit is contained in:
@@ -0,0 +1,277 @@
|
||||
$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
|
||||
Reference in New Issue
Block a user