Als externe Bilder werden alle Bilder bezeichnet, die auf dem Dateisystem abgelegt sind und per Referenz in das Hauptdokument oder Fragment eingefügt sind. Zum Zeitpunkt des Erzeugens des Projektdokuments muss das referenzierte Bild auf dem Dateisystem vorhanden sein.
Um ein Bild zu referenzieren stehen zwei verschiedene Parametersequenzen zur Verfügung:
Parametersequenz 1: #{ImagePath:Parametername}
Diese Parametersequenz sollte für neue Projekte nicht mehr eingesetzt werden, denn sie setzt voraus, dass das Bild mit einer Auflösung von 100dpi vorliegt. Liegt das Bild in einer anderen Auflösung vor, entspricht die Ausdehnung des Bilds im Word-Dokument nicht den Erwartungen. Entspricht die Auflösung des Bilds 100dpi wird es mit einer Skalierung von 100% in das Dokument eingefügt. Der Parameter des Typs ImagePath muss einen absoluten Pfad zur Bilddatei enthalten.
Parametersequenz 2: #{ImageInfo:Parametername}
Der Parameter des Typs ImageInfo muss eine Map mit speziellen Schlüssel-Wert-Paaren enthalten:
| Schlüssel | Wert | Beschreibung |
| SourceImagePath | <absolute path> | Absoluter Pfad zur Bilddatei |
| SourceImageVerticalResolutionInDPI | Integer | Vertikale Auflösung des Bilds in DPI. Ohne diesen Parameter versucht EEC diesen Wert aus den Meta-Informationen der Bilddatei auszulesen. |
| WordDocumentPageWidthInCM | Double | Breite des Word--Dokuments in cm. Beispielsweise ist für ein DIN A4-Dokument ein Wert von 21.0 anzugeben. |
| WordDocumentPageHeightInCM | Double | Höhe des Word-Dokuments in cm. Beispielsweise ist für ein DIN A4-Dokument ein Wert von 29.7 anzugeben. |
| WordDocumentMarginLeftInCM | Double | Linker Rand in cm. |
| WordDocumentMarginRightInCM | Double | Rechter Rand in cm. |
| FitToDocumentWidth | Boolean |
Bild an die Breite des Documents anpassen. true = Bildgröße an Dokumentbreite anpassen false = Bildgröße nicht an Dokumentbreite anpassen |
| WordDocumentDestinationScaleHorizontalInPercent | Integer | Horizontale Skalierung des Bilds in Prozent. |
| WordDocumentDestinationScaleVerticalInPercent | Integer | Vertikale Skalierung des Bilds in Prozent. |
| WordDocumentDestinationRotation |
Right Left |
Drehung des Bilds um 90 Grad. Right = Drehung im Uhrzeigersinn Left = Drehung entgegen dem Uhrzeigersinn |
Hinweis:
Um die Typen ImagePath und ImageInfo nutzen zu können muss die Bibliothek Word_Customizing importiert werden. Die Bibliothek wird mit der Datei <EEC installation folder>\install\other\model\Word_Customizing.eox bereitgestellt.
Die folgende Abbildung zeigt ein Fragment mit einer Parametersequenz für ein externes Bild:
