====== GuideOS Bildschirmfoto-Editor ======

===== Übersicht =====

Der **GuideOS Bildschirmfoto-Editor** ist ein Python/GTK3-basiertes Screenshot-Tool mit integriertem Editor für den Cinnamon Desktop.


===== Zweck =====

Das Tool ermöglicht das Erstellen von Screenshots mit präziser Bereichsauswahl und bietet einen integrierten Editor zum Annotieren der Bilder. Besonders geeignet für Dokumentationen, Support, Tutorials und technische Anleitungen. Unterstützt Multi-Monitor-Setups und Wayland-Fallback.

===== Hauptfunktionen =====

<WRAP round info 60%>
  * **Screenshot-Aufnahme**: Bereichsauswahl mit Live-Größenanzeige
  * **Multi-Monitor**: Automatische Erkennung aller angeschlossenen Bildschirme
  * **Annotations-Werkzeuge**: Linien, Rechtecke, Kreise, Pfeile, Text, Marker
  * **Lupe**: Vergrößert Details für präzise Markierungen
  * **Undo/Redo**: Schritte rückgängig machen oder wiederholen
  * **Zoom-Funktion**: Bild vergrößern/verkleinern mit Strg + Mausrad
  * **Zwischenablage**: Bild direkt in die Zwischenablage kopieren
  * **PNG-Export**: Speichern mit Zeitstempel-Dateinamen
  * **Request-Modus**: JSON-basierte Ausgabe für Automatisierung
</WRAP>


===== Bedienung =====

{{ :guideos-bildschirmfoto-.png?300|}}
==== Programm starten ====


''guideos-screenshot-editor''


Oder aus dem Anwendungsmenü starten.

==== Screenshot erstellen ====

  - Programm startet mit Hauptfenster
  - **"Anklicken, um einen Bereich auszuwählen"** Button klicken
  - Bildschirm wird blau-transparent überlagert
  - Mit Maus Bereich aufziehen (Drag & Drop)
  - **Live-Anzeige** zeigt Größe in Pixel (z.B. "1920 × 1080")
  - Bei Multi-Monitor: Monitor-Nummer wird angezeigt (z.B. "Monitor 2")
  - **Enter** oder **Space** drücken zum Bestätigen
  - **ESC** zum Abbrechen

==== Editor-Werkzeuge ====

Nach der Bereichsauswahl öffnet sich der Editor mit folgenden Werkzeugen:

^ Werkzeug ^ Symbol ^ Funktion ^ Verwendung ^
| **Linie** | {{:linie.png?24}} | Gerade Linien zeichnen | Klicken und ziehen |
| **Rechteck** | {{:quadrat.png?24}} | Rechtecke zeichnen | Klicken und ziehen |
| **Kreis** | {{:kreis.png?24}} | Ellipsen/Kreise zeichnen | Klicken und ziehen |
| **Pfeil** | {{:pfeil.png?24}} | Pfeile mit Spitze | Klicken und ziehen |
| **Text** | {{:text.png?24}} | Text hinzufügen | Klicken → Text eingeben |
| **Marker** | {{:marker.png?24}} | Halbtransparent markieren | Klicken und ziehen |
| **Lupe** | {{:lupe.png?24}} | Details vergrößern | Über Bereich bewegen |

==== Einstellungen ====

In der Werkzeugleiste verfügbar:

  * **Farbwahl**: Klick auf Farb-Button öffnet Farbauswahl
  * **Liniendicke**: Dropdown mit 1-10 Pixel (Standard: 3 px)
  * **Textgröße**: Dropdown mit 12-48 Punkt (Standard: 24 pt)
  * **Vergrößerung**: Lupe mit 1.5× bis 5× (Standard: 2.0×)
  * **Undo**: {{:zurueck.png?24}} Letzten Schritt rückgängig
  * **Redo**: {{:vor.png?24}} Schritt wiederholen

==== Zoom-Funktion ====

  * **Strg + Mausrad hoch**: Hineinzoomen
  * **Strg + Mausrad runter**: Herauszoomen
  * Zoom-Level wird im Fenstertitel angezeigt (z.B. "150%")
  * Bereich: 10% bis 1000%

==== Speichern und Export ====

  * **Speichern-Button**: Öffnet Dateidialog, speichert als PNG
    * Vorgeschlagener Name: ''screenshot_YYYYMMDD_HHMMSS.png''
    * Nur PNG-Format unterstützt
  * **Zwischenablage-Button**: Kopiert Bild direkt in Zwischenablage
    * Kann dann in andere Programme eingefügt werden (Strg+V)
  * **Beenden-Button**: Schließt Programm komplett
    * Warnung bei ungespeicherten Änderungen

===== Tastenkürzel =====

^ Taste ^ Funktion ^
| **ESC** | Bereichsauswahl abbrechen |
| **Enter** / **Space** | Auswahl bestätigen |
| **Strg + Mausrad** | Zoom im Editor |

===== Wichtige Hinweise =====

<WRAP round info 70%>
  * **Multi-Monitor**: Bei mehreren Bildschirmen automatische Monitor-Erkennung
  * **Marker-Tool**: Erzeugt halbtransparente Markierungen (40% Deckkraft)
  * **Lupe**: Zeigt vergrößerten Bereich - wird nicht als Annotation gespeichert
  * **Wayland**: Automatischer Fallback bei Problemen mit Wayland-Compositor
  * **Zoom**: Beeinflusst nur die Anzeige, nicht die gespeicherte Bildgröße
  * **Zwischenablage**: Bild enthält alle Annotationen
  * **Beenden-Button**: Schließt Programm vollständig (nicht nur Editor-Fenster)
</WRAP>


===== Funktionsweise =====

==== Multi-Monitor-Unterstützung ====

Das Tool erkennt automatisch alle angeschlossenen Monitore:
  * Berechnet Gesamtfläche über alle Monitore
  * Zeigt Monitor-Nummer während der Auswahl
  * Berücksichtigt Monitor-Offsets (z.B. bei versetzten Bildschirmen)
  * Funktioniert mit erweiterten und gespiegelten Displays

==== Wayland-Fallback ====

Bei Problemen mit Wayland:
  * Automatischer Fallback auf alternative Screenshot-Methode
  * Erfasst zunächst gesamten Bildschirm
  * Extrahiert dann ausgewählten Bereich

==== Marker-Werkzeug ====

Der Marker ist speziell für Texthervorhebungen:
  * 3× breitere Linie als normale Linien
  * 40% Deckkraft für "Textmarker-Effekt"
  * Verwendete Farbe wird halbtransparent dargestellt

===== Installation =====

<block round box 70%>
<code bash>
# Abhängigkeiten werden mit installiert
sudo apt install guideos-screenshot-editor
</code>
</block>


===== Benötigte Icons =====

Das Tool sucht Icons in ''/usr/share/pixmaps/'':

^ Icon-Datei ^ Werkzeug ^
| ''Linie.png'' | Linien-Tool |
| ''Quadrat.png'' / ''Rechteck.png'' | Rechteck-Tool |
| ''Kreis.png'' | Kreis-Tool |
| ''Pfeil.png'' | Pfeil-Tool |
| ''Text.png'' / ''T.png'' / ''A.png'' | Text-Tool |
| ''Marker.png'' | Marker-Tool |
| ''Lupe.png'' | Lupen-Tool |
| ''zurueck.png'' / ''undo.png'' | Undo-Button |
| ''vor.png'' / ''redo.png'' | Redo-Button |

Falls Icons fehlen, verwendet das Tool System-Fallback-Icons.

===== Anwendungsbeispiele =====

<block round box 70%>
  * **Tutorials**: Screenshots mit Pfeilen und Text-Anmerkungen
  * **Bug-Reports**: Fehler markieren und beschreiben
  * **Dokumentation**: Benutzeroberflächen annotieren
  * **Support**: Probleme visuell erklären
  * **Präsentationen**: Screenshots mit Hervorhebungen
  * **Anleitungen**: Schritt-für-Schritt mit nummerierten Markierungen
</block>



===== Lizenz =====


| **Autor** | evilware666 |
| **Lizenz** | MIT |