Ein OpenOffice.org-Makro zum Abspeichern aller Grafiken in einem Textdokument. Inhalt. Abbildungen

Transkript

1 Ein OpenOffice.org-Makro zum Abspeichern aller Grafiken in einem Textdokument Autor: Tilman Kranz Datum: Zusammenfassung: Es soll eine Routine (Makro) für das Textverarbeitungsprogramm OpenOffice.org Writer programmiert werden, die alle Pixel-Grafiken in einem geladenen Textverarbeitungsdokument abspeichert. Inhalt 1 Entwicklung Aufgabenstellung Feststellung der unterstützten Software Feststellung der unterstützen Formate Testverfahren Implementation Übersicht Die Iterator-Routine Die Export-Routine... 4 Quellenverzeichnis... 5 Literatur... 5 Webseiten... 5 Abbildungen A.1 Ablaufplan des Makros...3 Listings L.1 Iterator-Routine...3 L.2 Export-Routine...4

2 1 Entwicklung 1.1 Aufgabenstellung Es soll eine Routine (Makro) für das Textverarbeitungsprogramm OpenOffice.org Writer programmiert werden, die alle Pixel-Grafiken in einem derzeit geladenen Textverarbeitungsdokument abspeichert. Der Pfad für das Speichern ist fest vorgegeben. Alle Bilder sollen in das Verzeichnis /home/tilman/test/ abgespeichert werden. Dieser Pfadname kann im Programmtext kodiert werden. Als Dateinamen für die exportierten Bilddateien werden die in der Textverarbeitung zugewiesenen Bezeichner der entsprechenden Abbildungen verwendet. Das Abspeichern der Grafiken soll im JPEG-Format erfolgen. 1.2 Feststellung der unterstützten Software Als scriptfähige Textverarbeitung soll das Programm Writer aus dem Projekt OpenOffice.org (im Folgenden kurz OOo ) zum Einsatz kommen. Das Makro wird in der in OOo eingebauten Entwicklungsumgebung BASIC-IDE erstellt. Die Weitergabe des Makros ( Deployment ) an Kunden ist nicht Aufgabenstellung der Makroprogrammierung. 1.3 Feststellung der unterstützen Formate Als Eingabeformat sollen alle Textverarbeitungs-Formate unterstützt werden, die von OOo unterstüzt werden, und in denen Grafiken in Dokumente eingebettet werden können, also z.b. Open Document Format, MS Word 97, 2003 usw Testverfahren Die Listings in diesem Dokument wurden mit Version OOo Version erstellt und getestet. Das Makro wird mit einigen einfachen Testdokumenten im ODF-Format auf korrektes Funktionieren getestet. Seite 2 von 5

3 2 Implementation 2.1 Übersicht Als Programmiersprache wurde OOo-BASIC verwendet, da BASIC-Macros am einfachsten in eine Installation von OOo integriert werden können. Der Programmierer benötigt für BASIC-Macros keine zusätzlichen Werkzeuge oder Bibliotheken zum Erstellen oder Ausführen. Die folgenden Programmlistings sind die Implementation der geforderten Exportierfunktion. Zuerst wird eine Routine iterategraphics() definiert, die auf einem derzeit geöffneten und vom Anwender fokussierten Textverarbeitungsdokument in OpenOffice.org Writer alle Grafikobjekte iteriert. Dann wird eine Routine savegraphic() definiert, die von iterategraphics () für jede gefundene Grafik aufgerufen wird und diese unter einem gegebenen Namen abspeichert. E nein S weitere Bilder? ja Speichere nächstes Bild. A.1 Ablaufplan des Makros. 2.2 Die Iterator-Routine Die Routine iterategraphics() wird vom Benutzer aufgerufen und kann z.b. mit einem Icon in einer Symbolleiste der GUI verknüpft werden. Das Makro hat keine Parameter, der Export-Pfad p ist hart codiert. Der Iterator-Algorithmus entspricht dem in [URL1], Abschnitt , Seite 195f. und Listing 7.55 vorgeschlagenen Verfahren (vergleiche auch [PIT2004], Seite 111ff.). sub iterategraphics dim i as integer dim g as object dim p as string p="/home/tilman/test" for i=0 to ThisComponent.Drawpage.getCount()-1 g = ThisComponent.Drawpage.getByIndex(i) savegraphic(g.graphic,converttourl(p&"/"&g.name&".jpg") next i end sub L. 1 Iterator-Routine Seite 3 von 5

4 2.3 Die Export-Routine Die Routine savegraphic() implementiert eines der drei in [URL2] vorgeschlagenen Verfahren zum Abspeichern eingebetteter Grafiken. Die Variable p referenziert die Instanz eines OOo-Dienstes vom Typ GraphicProvider. Der PropertyValue a weist diesen Dienst beim Aufruf der Methode storegraphic() an, das übergebene Objekt im Format ( MimeType ) image/jpeg an die übergebene URL zu speichern. Diese Prozedur ist nicht typsicher, da sie nicht darauf testet, dass es sich bei in_obj um ein Objekt von einem für storegraphic() geeigneten Typ handelt. Es wird vom Aufrufer erwartet, dass er dies sicherstellt. Der Aufruf mit einem Objekt inkompatiblen Typs führt zu einem Laufzeitfehler bzw. undefiniertem Verhalten der Prozedur. ' Speichere spezifische Graphik arg1. ' Speicherort ist URL arg2. sub savegraphic(in_obj, out_url) dim p as object dim a(1) as new com.sun.star.beans.propertyvalue ' FIXME: 1 Provider-Instanz pro Aufruf von iterategraphics() p = createunoservice("com.sun.star.graphic.graphicprovider") a(0).name = "MimeType" a(0).value = "image/jpeg" a(1).name = "URL" a(1).value = out_url p.storegraphic(in_obj,a) end sub L. 2 Export-Routine Seite 4 von 5

5 Quellenverzeichnis Literatur 1 [PIT2004] Andrew Pitonyak. OpenOffice.org Macros Explained. 2004, Hentzenwerke Publishing. Webseiten 2 [URL1] [URL2] Andrew Pitonyak. Useful Macro Information For OpenOffice. OooForum.org (Webforum), Fernand. 3 ways to export Graphics. 1 )Die Literaturangaben in diesem Dokument sind fiktiv. Diese Literatur wurde nicht tasächlich verwendet. 2 ) Hyperlinks sind vom Stand am 11. Februar Seite 5 von 5