Plugin: NetBeans Tutorial Builder - Screen capture und Crop Tool
In einer internen Mailingliste hatte ich es schon angekündigt. Ich entwickle ein Plugin, damit man innerhalb von NetBeans und Platform-Anwendungen sehr einfach Tutorials erzeugen kann.
Der erste Schritt ist gemacht. Der Tutorial Builder kann nun Screenshots erzeugen und bietet eine sehr schnell zu bedienendes Crop-Tool (Ausschnitte von Screenshots).
Nach der Installation des Plugins hat man in der Statusleiste einen kleinen Fotoapparat. Per Klick gibt es ein Popup-Menü mit "Gallery" und "Screen capture". Der Menüpunkt "Screen capture" kann auch über der Printscreen-Taste ausgelöst werden (auf deutschen Tastaturlayouts: Druck S-Abf...).
Der Capture wird mit einer Sekunde verzögert ausgeführt und steht dann in der Gallery zur Verfügung. Es können beliebig viele Screenshots erzeugt werden. Diese können in der Gallery sortiert und wieder entfernt werden.
Ein besonderes Feature ist aber der Befehl Crop. Wählt man ein Bild in der Gallery aus, erscheint dieses (ggf. verkleinert) in der Vorschau. Über dem Vorschau-Bild ist eine Combobox mit allen ermittelten Clipping-Regionen des NetBeans-Fensters. Einfach mal unterschiedliche Regionen auswählen. In der Vorschau erscheint dafür ein roter Rahmen. Mit dem Mausklick auf "Crop" (rechts neben der Combobox) wird dieser Ausschnitt der Gallery neu hinzugefügt.
Für aufgeklappte Menüs bietet die Auswahl an Regionen sogar ein "nichtrechteckiges", also polygonales Clipping an, damit man keinen störenden Fensterhintergrund hat, wenn man Menüverschachtelungen darstellen will.
Die so erzeugten Screenshots können auch als PNG-Dateien gespeichert werden. Alle gewünschten Bilder markieren, den Speicherbutton in der Gallery anklicken, einen Ort festlegen und speichern. Polygonale Clippings sind in den freien Bereichen transparent.
Damit habe ich nun Meilenstein 1 erreicht.
Mit der weiteren Entwicklung werden folgende Features hinzugefügt (ohne bestimmte Reihenfolge):
- [Erledigt] Manuelle Clippings (wie in einem Grafik-Programm)
- Snapping für manuelle Clippings (auch wieder an bekannten Komponentengrenzen)
- Umbenennen von Screenshots schon in der Gallery
- [Angefangen] Mehrsprachigkeit
- Hinzufügen von Kommentaren "in" den Screenshots
- Hinzufügen von grafischen Elementen in den Screenshots
- Zu den Screenshots sollen Kommentare und Kurztexte sowie Sourcecode hinzuzufügen sein
- Kommentare mit Stilen (fett, kursiv, ...)
- Export der komponierten Gallery (mit Texten) als PDF, ODF (Writer und Presentation), HTML (damit wird es zum echten Tutorial Builder)
- Export als Java Help
- Export als NetBeans RCP Java-Help Projektteil
- [Angefangen] Ausbau von Extensionpoints, damit fremde Modulentwickler zusätzliche Funktionen (z.B. Grafikbearbeitung, Exportformate) hinzufügen können.
Und ja klar: Hier ist der Download. Und noch mein Disclaimer: BETA, nicht auf allen OS und allen NB Versionen getestet (mind. 6.7 erforderlich). Support gibt es nicht, aber ich freue mich über Feedback - auch über Fehlermeldungen. Für Mac-User eine gute Nachricht: Java-Abhängigkeit ist nun >= 1.5
So, nun hat die aktuelle Version ein Update-Center. Für Neuerungen muss man nicht mehr immer hier ungeduldig reinschauen. Wer das Update-Center von Hand eintragen will: http://www.sepix.de/fileadmin/tutorialbuilder/updates.xml
Bitte diese Update-Hinweise beachten für 1.0.3.
Bitte diese Update-Hinweise beachten für 1.0.4.
Bitte diese Update-Hinweise beachten für 1.0.5.
Beste Grüße,
Josch.
Dieser Eintrag wurde am Donnerstag, Juli 16, 2009 at 09:15 geschrieben
und ist kategorisiert unter NetBeans, Tutorial Builder.
Du kannst eine Antwort schreiben, oder einen trackback Deiner Seite hinterlassen.
Mein Profil findet sich bei
Da werden Sie geholfen:
Das deutsche NetBeans Forum
![[Valid RSS]](http://www.sepix.de/fileadmin/valid-rss.png "Validate my RSS feed")
Samstag, 18-07-09 19:00
Hi Toni!
Danke für das testen der Mac-Version. Ok, getWindows() Since: 1.6. Ich hätte es auch gegen das JDK 1.5 checken sollen...
Meinst Du es lohnt sich, das noch anzupassen? Vermutlich ja, so lange NB auf 1.5 gepinnt ist.
Was für ein Problem mit den Tastenkürzeln? In der Version 1.04 kann man es dann auch selber festlegen. Alternativ kannst Du in der Keymap Kategorie Help -> Screen capture selbst eine zusätzliche Tastenkomi hinzufügen.
Beste Grüße,
Josch.
Samstag, 18-07-09 10:02
Ich habe jetzt NB unter 1.6 laufen und Dein Tool funktioniert auch hier! Menüs konnte ich leider noch nicht testen, ich muss das mit den Tastaturkürzeln noch hinbekommen...
Viele Grüße
--Toni
Freitag, 17-07-09 16:43
So schlimm ist es mit dem Mac nun auch nicht... Es gibt 1.6 für den Mac :-) . Das ist nur ein Problem meiner settings hier. Aber nachdem NB ja generell unter 1.5 laufen soll ist es natürlich gut, wenn auch das plugin unter 1.5 läuft. Vielen Dank für Deine Bemühungen.
-Toni
Freitag, 17-07-09 16:40
Auf dem Mac läuft's leider noch nicht... Die Kamery im StatusBar wird nicht angezeigt. Klickt man an die passende Stelle, öffnet sich aber immerhin das Popup menü. Wählt man nun "Screenshot", dann gibt es folgende Fehlermeldung:
java.lang.NoSuchMethodError: java.awt.Frame.getWindows()[Ljava/awt/Window;
at org.sepix.tutorialbuilder.utils.ScreenUtils.getSubApplicationWindows(ScreenUtils.java:246)
at org.sepix.tutorialbuilder.api.impl.ScreenCaptureImpl.newInstance(ScreenCaptureImpl.java:203)
[catch[..] at org.sepix.tutorialbuilder.ui.ScreenShotAction$1$1.run(ScreenShotAction.java:45)
at java.awt.event.InvocationEvent.dispatch(InvocationEvent.java:209)
at java.awt.EventQueue.dispatchEvent(EventQueue.java:461)
at org.netbeans.core.TimableEventQueue.dispatchEvent(TimableEventQueue.java:104)
at java.awt.EventDispatchThread.pumpOneEventForHierarchy(EventDispatchThread.java:269)
at java.awt.EventDispatchThread.pumpEventsForHierarchy(EventDispatchThread.java:190)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:184)
at java.awt.EventDispatchThread.pumpEvents(EventDispatchThread.java:176)
at java.awt.EventDispatchThread.run(EventDispatchThread.java:110)
Donnerstag, 16-07-09 08:19
Moin!
Danke für das tolle Feedback. Ich muss immer wieder sehen, dass die Tools, die man selbst am nötigsten braucht, auch anderen sehr hilfreich sein können.
@Sven: Zur Lizenz. Es wird die offene Lizenz der NetBeans-Platform werden. Kommerzielle Nutzung ist frei.
Ein Recording-Tool ist bestimmt eine super Ergänzung. Ich wollte mich erstmal um die statische Tutorial-Erfassung kümmern (die man auch mal als Unterrichtsvorlage oder für Präsentationen nutzen kann).
@Toni: Ich habe nicht daran gedacht, dass der Mac wieder hinterherhinkt. Ich prüfe, ob ein Backport zu 5 möglich ist. Gerade weil ich unter Mac wissen möchte, ob das mit dem polygonen Menü-Clipping inkl. Menubar funktioniert.
Beste Grüße,
Josch.
Donnerstag, 16-07-09 07:14
Hallo Josch,
gerade rechtzeitig, da ich zur Zeit dabei bin ein Tutorial für mein neustes Projekt 'Multilingual in NetBeans' (https://multilingual.dev.java.net/) zu erstellen. Gerade die Screenshots zu generieren nimmt doch beachtlich Zeit in Anspruch...
Ich merk immer wieder, mit den richtigen Werkzeugen (z. Bsp. NetBeans oder dein tolles Plugin) macht das Programmieren immer mehr Spaß und freue mich jetzt schon auf die von dir geplanten neuen Features, wie z. Bsp. das Hinzufügen von Scourecode oder eines Kurztextes zu einem Bild.
Peter
Donnerstag, 16-07-09 00:36
Super. Jetzt fehlt nur noch das von Fabrizio angekündigte "recording tool" und niemand hat mehr eine Ausrede um nicht ein Tutorial zu erstellen.
Wie ist das mit der License? Nach Upgrade auf 6.7 könnte dies Module 1000+x werden, um schnell mal eine Präsentation im Developer Modus zu erzeugen!
Was soll ich noch mehr sagen - 1.6 ist ok für mich - mach weiter so un hoste Deinen Source Code on-line....
-Sven
Mittwoch, 15-07-09 21:26
Sieht ja extrem cool aus :-). Hast Du auch 'ne Version für Java 1.5? Dann teste ich's mal auf dem Mac...
--Toni