gstrainovic/zid / .claude/skills/pdf-view
pdf-view
VerifiedPDF-Vorschau in zid: Blättern, Zoom und Bildlauf in der Seite, Suche (Ctrl+F), Neuladen bei Dateiänderung, mupdf-Abstürze bei halb geschriebenen PDFs, E2E-Zustand. Use when touching src/ui/pdf_view.zig, pdf_nav.zig, pdf_find.zig, src/rendering/pdf_handler.zig, fz_page_text_z, PDF reload, or scripts/e2e_pdf_*.py.
Zoom und Bildlauf
- Zustand je Dokument im
PdfHandler(zoom,scroll_x/y), also gemeinsam für beide Panes eines Splits, wiecurrent_page. Zoom 1.0 = Seitenbreite; Stufenpdf_nav.zoom_levels(50–400 %). Geometrie rein inpdf_nav.geometry(unit-getestet): passt die Seite, steht sie mittig, sonst verschiebt der Bildlauf sie überchild_offsetdes Clip-Elementspdf_viewport. - Bedienung: Knöpfe −/Prozent/+ in der Leiste (Prozent setzt auf 100 %), Ctrl+Rad um die
Mausposition (
zoomAround), Ctrl+Plus/Minus/0 über die Befehlezoom_in/out/reset, die im PDF-Tab die Seite statt der Schrift zoomen. Rad ohne Ctrl scrollt in einer überstehenden Seite und blättert erst am Rand (pdf_nav.wheel); zurück landet man am Ende der vorigen Seite. Passt die Seite, blättert jede Stufe eine Seite. Shift+Rad scrollt waagrecht. - Scharf rendern: die Ansicht meldet je Frame den nötigen Maßstab (
wanted_scale, px/pt, Maximum aller Panes), die Hauptschleife rendert neu, wenn er um mehr als 10 % vonrequested_scaleabweicht oderneeds_render(Seitenwechsel) gesetzt ist. Damit richtet sich die Auflösung nach Pane-Größe und Zoom statt fest 1.5/2.0.renderPagekappt bei 16 MP bzw. 8192 px Kante; verglichen wird mit dem angeforderten, nicht dem gekappten Maßstab, sonst würde jeden Frame neu gerendert. - Seiten mit MediaBox-Ursprung ungleich (0,0) werden an die Pixmap-Ecke verschoben
(
origin_x/y); Such-Rechtecke ziehen denselben Ursprung ab.
Suche (Ctrl+F)
- Dieselbe Leiste wie Editor und Markdown-Vorschau (
find_bar.FindStateim Handler), dieselben Optionen überfind_ops.Pattern. Enter/Shift+Enter springen mit Umbruch, Escape schließt, Blättern bleibt bei offener Leiste möglich. - Text je Seite liefert
fz_page_text_z(C-Wrapper,fz_tryund Strukturblöcke rekursiv): je Zeichen Codepunkt und Box, Zeilenende als Leerzeichen, Blockende als\n, beide mit leerer Box. Die Strukturen von mupdf werden in C durchlaufen, nicht in Zig: System-mupdf (1.27) und gebündeltes (1.26.5) unterscheiden sich, der Wrapper wird je gegen den passenden Header gebaut. pdf_find.zig(rein, unit-getestet) baut daraus UTF-8 mit Byte-Anfang je Zeichen und macht aus einem Treffer-Bytebereich Rechtecke je Zeile. Gesucht wird schrittweise (~8 ms je Frame in der Hauptschleife,searchStep), der erste Treffer ab der Leseposition wird angesprungen, sobald er gefunden ist; spätere Funde ziehen nicht weg. Nach einem Reload läuft die Suche neu, ohne zu springen.- Markierung: schwebende Rechtecke am Bild (
clip_to = .to_attached_parent, passthrough), höchstens 400 je Seite; aktueller Treffer orange, übrige gelb. - E2E:
python3 scripts/e2e_pdf_zoom_find.py;pdf_stateliefert dafür zusätzlichzoom,scroll_x/y,scale,find_active,searching,hits,current,hit_page.
PDF-Vorschau: Blättern und Neuladen
-
Neu laden bei Dateiänderung:
handleExternalChangeerkennt offene PDFs (keyForPathüberopen_pdfs, auch per realpath) und reiht sie inpending_pdf_reloadsein;exportMarpPdftut das direkt. Der Main-Loop lädt erst, wenn die Datei 150 ms ruht (takeDuePdfReload, mtime): Das System-mupdf 1.27.2 (Linux linkt/lib64/libmupdf.so, nicht fancy-cats mupdf) stürzt beim Reparieren mancher halb geschriebener PDFs ab („double free“,mutool drawsegfaultet auf derselben Datei), und der Watcher meldet je Datei nur ein Ereignis pro 100 ms. Neuer Handler, Seite geklemmt, Textur ersetzt; scheitert etwas, bleibt der alte Stand.wantsFrameSoonhält den Loop wach, solange ein Reload wartet. E2Epython3 scripts/e2e_pdf_reload.py, Marp-Weg ine2e_marp_pdf.py(letzter Schritt). -
Blätter-Logik als reines Modul
src/ui/pdf_nav.zig(Tasten, Mausrad, Sättigung an den Rändern, Beschriftung). Die Ansichtsrc/ui/pdf_view.zigliefert ein Seiten-Delta, die UI setzt die Seite (PdfHandler.setPage, markiertneeds_render), die Hauptschleife rendert die Textur neu. -
Bild ab/auf und Pfeil links/rechts blättern; hoch und runter bleiben der Navigation zwischen Panes und im Explorer. Mausrad: negative Zeilen heißen nach unten, also vorwärts.
-
clay.pointerOvermeldet in dieser Ansicht nichts, deshalb hat die Leiste eine eigene Schaltfläche stattcomponents.Button: Hover und Klick rechnen gegen die Bounding-Box aus dem letzten Layout (pdf_nav.hits, Aufhellung überpdf_nav.brighten). -
Die Beschriftung liegt in einem Puffer der UI (
pdf_labels: Seite, Zoom, Trefferzahl), nicht in der Frame-Arena:beginLayoutsetzt die Arena zurück, Clay liest den Text erst beim Zeichnen. -
Zustand für E2E:
pdf_stateliest Felder imE2EContext, die der Main-Thread pro Frame setzt, weil der Server-Thread über Tabs undopen_pdfsspringende Werte liest. -
E2E:
python3 scripts/e2e_pdf_pager.py, das siebenseitige PDF erzeugtwrite_pdfnachtmp/e2e_pdf/pager.pdf. Der Test startet mit eigenem, frischemXDG_CONFIG_HOMEund übergibt das PDF als Startdatei: über eine wiederhergestellte Sitzung wechselt der aktive Tab und die Messung trifft Fremdzustand.open_fileöffnet keinen PDF-Tab, das Laden hängt am Explorer-Pfad.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |