Fonterweiterungen hinzufügen

In Folgendem soll erläutert werden, wie sie Fonts zu Jaspersoft Studio hinzufügen und eine eigene Fonterweiterung erstellen. Das Einbinden von Fontextensions ist notwendig, um systemübergreifend dasselbe Erscheinungsbild der erzeugten PDF zu gewährleisten.

JasperReports Font Extension

Bevor auf die Erstellung eigener Font Extensions eingegangen wird, sei darauf hingewiesen, dass Nuclos Versionen >= 4.50 mit einer vorinstallierten JasperReports Font Extension ausgeliefert wird. Nachfolgende Fonts können sie bereits verwenden, um ein einheitliches Reportaussehen zu erhalten, ohne eine eigene Fonterweiterung zu erstellen:

• DejaVu Sans
• DejaVu SansMono
• DejaVu Serif

Beispieldateien

Damit sie dem Tutorial folgen können, stellen wir Ihnen an dieser Stelle, die nach GPL v3 lizenzierte Schriftart, FreeSans mit der passenden Extension zur Verfügung:

• Font files:
  • FreeSans.ttf
  • FreeSansOblique.ttf
  • FreeSansBold.ttf
  • FreeSansBoldOblique.ttf

• Extension: nuclos-fonts-1.0.jar

Font in Jaspersoft Studio hinzufügen (ggf. "Als Administrator ausführen")

Eine Schriftart wird in Jaspersoft Studio unter "Preferences" → "Jaspersoft Studio" → "Fonts" hinzugefügt:

Der Family Name, welcher hier angegeben wird, dient später zum Zugriff auf genau diesen Font. Wählen sie in den Tabs "Normal", "Bold", "Italic" und "Bold Italic" jeweils die entsprechende Fontdatei aus. Sobald sie auf Finnish drücken, steht der Font in den Properties zur Auswahl:

Eine eigene Extension erzeugen

Extensions sind Archive mit der Dateiendung .jar, als Vorlage für eine Fontextension kann die hier bereit gestellte nuclos-fonts-1.0.jar verwendet werden.

Um eine Schriftart zur Extension hinzuzufügen sind folgende Schritte notwendig.

1. (optional) einen neuen Unterordner im Verzeichnis org/nuclos/fonts/ anlegen
2. die zu verwendenden .ttf files für die gewünschten  Schriftstile einer Fontfamile unter org/nuclos/fonts/ bzw. dem neuen Unterverzeichnis ablegen
3. die fonts.xml ergänzen

Dazu siehe beispielhaft den Eintrag für FreeSans:

<bean id="nuclosSansSerif" class="net.sf.jasperreports.engine.fonts.SimpleFontFamily">
		<property name="name" value="Nuclos Sans Serif"/>
		<property name="normal" value="org/nuclos/fonts/basic/FreeSans.ttf"/>
		<property name="bold" value="org/nuclos/fonts/basic/FreeSansBold.ttf"/>
		<property name="italic" value="org/nuclos/fonts/basic/FreeSansOblique.ttf"/>
		<property name="boldItalic" value="org/nuclos/fonts/basic/FreeSansBoldOblique.ttf"/>
		<property name="pdfEncoding" value="Identity-H"/>
		<property name="pdfEmbedded" value="true"/>
	</bean>

Extension einbinden

Die Extension wird regulär als Server-Extension zum gewünschten Nuclet hinzugefügt.