2.8 tile (Muster)

{ export | reexport } tile <Bezeichner> <tileSpec> | <variantDef> <scaleMode>

tileSpec ::= <tileBitmap> | "<Dateipfad>" | "<Grafikressource>" { scale | 
		noscale | numscale | propscale | dpiscale } { smooth }
 

tileBitmap ::= <x>, <y>,
               "<Musterzeile>"
           [ , "<Musterzeile>" ]

variantDef ::=
{
           0 :  <tileSpec> 
  [ <Nummer> :  <tileSpec> ]
}

Bei der Definition von Varianten wird empfohlen, immer eine Variante mit der Nummer 0 zu definieren, da diese als Standardvariante dient, wenn keine, eine nicht vorhandene oder eine ungültige Variante gesetzt wird. Die weiteren Nummern können beliebige natürliche Zahlen sein.

Die zu verwendende tile-Variante kann beim Start der Anwendung mit der Startoption -IDMtile gesetzt werden. Zur Laufzeit der Anwendung kann sie mit dem Attribut .tile des setup-Objekts abgefragt und gesetzt werden.

2.8.1 Internes Muster (Bitmap)

<x> und <y> stehen jeweils für die Anzahl der Pixel in horizontaler bzw. vertikaler Richtung. Breite (<x>) und Höhe (<y>) können beliebig gewählt werden.

<Musterzeile> bezeichnet eine Zeichenkette mit <x> Zeichen, in der jedes Zeichen ein Pixel des Musters repräsentiert. Es sind nur rechteckige Muster möglich, deshalb müssen genau <y> Musterzeilen mit jeweils <x> Zeichen definiert werden.

Die Musterzeilen bestehen aus den Zeichen Punkt (.) Leerzeichen ( ) und Doppelkreuz (#), die folgende Bedeutung haben:

.
(Leerzeichen)(blank)

#

Beispiel für die Definition eines internen Musters

tile TiGray 16, 16,
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ",
  "# # # # # # # # ",
  " # # # # # # # #",
  "# # # # # # # # ";

Hinweis zu Qt:

Bei der Nutzung von internen Mustern als Menü- oder Notepage-Bilder ist zu beachten, dass der scalestyle_none nicht zu einer realen 1:1 Pixeldarstellung führt wie bei einer Bilddatei üblich.

Wir raten von der Verwendung interner Muster als Fenstericon ab, da es hier zu einem fehlerhaften Zusammenspiel bei der parallelen Verwendung mit anderen Objektklassen, wie z.B. bei Menues, kommen kann.

2.8.2 Externes Muster

Bei der Definition über einen Dateinamen (inklusive Pfad) geht der IDM davon aus, dass die Definition des Musters in einer separaten Grafikdatei erfolgt. Der IDM lädt die entsprechende Datei und stellt ihren Inhalt mit den Systemfunktionen des jeweiligen Toolkits dar. Deshalb ist es plattformabhängig, welche Grafikformate angezeigt werden können.

Die folgende Tabelle zeigt, welche Grafikformate auf den einzelnen Plattformen unterstützt werden:

Tabelle 24-4: Von der tile-Ressource unterstützte Grafikformate

Die Definition über eine Grafikressource wird nur vom IDM für Windows unterstützt. Hier können die Bezeichner IDM_AppIcon und IDM_DefIcon der in den IDM-Bibliotheken definierten Ressourcen verwendet werden (siehe auch Attribut .icon in der „Attributreferenz“).

Unter Microsoft Windows können außerdem folgende Bezeichner für vordefinierte Bitmap-Ressourcen des Systems angegeben werden:

Hinweis

Bei der Spezifikation einer externen Datei wird empfohlen, den Pfad nicht absolut, sondern mit Hilfe einer Umgebungsvariablen zu definieren, z.B. "IDM_IMAGEPATH:Check.gif".

Weitere Grafikformate können mithilfe eines selbst implementierten Grafik-Handlers (GFX-Handler) verarbeitet werden (siehe Funktion DM_PictureHandler im Handbuch „C-Schnittstelle - Funktionen“).

2.8.3 Skalierung

Durch die Angabe eines scalestyle bei der Musterdefinition wird die Größe des Musters oder Bildes nach bestimmten Kriterien an den verfügbaren Platz angepasst.

Das Attribut .scalestyle bestimmt die Art der Skalierung des Musters oder Bildes.

Best Practice: Muster sollten wenn möglich bereits in der richtigen bzw. verwendeten Größe vorliegen, da jede Skalierung mit Verlusten an Schärfe oder Detailreichtum verbunden ist.

2.8.4 Smooth Scaling

Das Skalieren von Pixel-Bilder ist meist nötig um Bilder in gewünschter Größe auf der Benutzeroberfläche darzustellen oder um Bilder für die aktuelle Skalierungsstufe des Desktops aufzubereiten.

Standardmäßig benutzt der IDM für diese Skalierungs bzw. Bildtransformation den schnellsten Skalierungalgorithmus „Nächster Nachtbar“. Dieser dupliziert schon vorhandene Pixelwerte (beim Vergrößern) oder lässt Pixel weg (beim Verkleinern).

Durch die Nutzung des smooth Schlüsselwort an der tile-Ressource kann explizit für dieses Muster auf einen interpolierenden Skalierungsalgorithmus gewechselt werden. Dieser berechnet fehlende Pixel aus den Nachbarpixeln oder „verrechnet“ mehrere Pixel beim Verkleinern.

Beide Skalierungsalgorithmen haben ihren Vor- und Nachteil und sollten nach dem Bildinhalt wie auch den möglichen Skalierungsgrößen gewählt werden.

Beispiel

Für einen optimalen Bildeindruck empfiehlt es sich Bilder in mehrere Größen bzw. Skalierungsstufen bereitzustellen. Dies kann als Ressource-Variante, als HiDPI-Bildvariante über @nx-Zusatzbilder (n = 2...9) oder unter Windows als Icon-Ressource mit mehreren Bildvarianten geschehen. Alternativ empfehlen sich auch Vektorbildern im SVG-Format.

2.8.5 Dynamisch änderbare Attribute

Die änderbaren Attribute können der nachfolgenden Tabelle entnommen werden. Dabei ist zu beachten, dass sich .name einerseits sowie .width, .height und .pattern andererseits gegenseitig ausschließen, sodass get zu einer Fehlermeldung can't get value führt.

Bei varianten tile-Ressourcen wird auf die Attribute der aktuellen tile-Variante zugegriffen, die mit dem Attribut .tile des setup-Objekts abgefragt und gesetzt werden kann.

Tabelle 24-5: Änderbare Attribute der tile-Ressource

2.8.6 SVG-Support

Unter Windows und Qt unterstützt die Tile-Ressource nun auch Vektor-Bilder im Scalable Vector Graphics-Format (.svg).

2.8.6.1 Hinweise für Qt

Die Dateiendung .svg wird als SVG-Bildformat erkannt und bei der Darstellung in den diversen Objekten ein vektorbasiertes Zeichnen angewandt. Dadurch wird bei Anwendungen, die auf HiDPI-Bildschirmen dargestellt werden, eine möglichst optimale Abbildungen von Vektorbildern erzielt.

Aus Gründen der Performanz wird beim Zeichnen von Hintergrundmuster von Gruppierungsobjekten im Stil tilestyle_tiled, das pixelbasierte Stellvertreterbild verwendet.

Installationshinweis: Das Qt-Paket qt5-qtsvg muss bereits installiert sein um die entsprechende SVG-Unterstützungs-Bibliothek verfügbar zu machen und die Startfähigkeit einer IDM-Anwendung zu gewährleisten.

2.8.6.2 Hinweise für Windows

Zur Darstellung von Bildern im "Scalable Vector Graphics" (SVG) Format wird Microsoft Direct2D verwendet. Die SVG-Unterstützung von Microsoft Direct2D ist abhängig von der Microsoft Windows Version. Ab dem Windows 10 Creators Update ist die Unterstützung in eingeschränkter Form gegeben.

Es wird empfohlen, in einer Icondateien oder Iconressourcen nur Icondefinitionen mit derselben Farbtiefe zu verwenden, da nicht sichergestellt werden kann, dass bei gleicher Bildgröße das Bild mit der höheren Farbtiefe verwendet wird. Sind unterschiedliche Farbtiefen nötig, dann sollte eine 2. Icondatei oder Iconressource verwendet werden und auf den Variantenmechanismus des IDM zurückgegriffen werden.

Da Direct2D andere Skalierungsmethoden als das Windows GDI verwendet, können Muster (Bilder), die zur Anzeige skaliert werden müssen, anders aussehen als in den Vorgängerversionen des IDM. Das gilt insbesondere für Muster die als Fenstericon oder als Bilder in den Objekten treeview und notepage verwendet werden, da hier Microsoft Windows den Icondatentyp voraussetzt. Es wird empfohlen, für Fenstericon und Bilder der Objekte treeview und notepage eine Icondatei oder Icon-Ressource als Muster zu verwenden.

Die SVG-Unterstützung von Microsoft Direct2D

Die Unterstützung hängt von der Microsoft Windows-Version ab. Ab dem Windows 10 Creators Update werden die folgenden SVG-Elemente und -Attribute unterstützt:

SVG-Darstellungsattribute

- clip-path

- clip-rule

- color

- display

- fill

- fill-opacity

- fill-rule

- opacity

- overflow

- stop-color

- stop-opacity

- stroke

- stroke-dasharray

- stroke-dashoffset

- stroke-linecap

- stroke-linejoin

- stroke-miterlimit

- stroke-opacity

- stroke-width

- visibility

Unterstützte Längeneinheiten

Die Längenwerte und prozentualen Längenwerte des Benutzerbereichs sowie die absoluten Einheitenbezeichner: px, pt, pc, cm, mm und in.

Bildquellen

Das Imageelement wird nur unterstützt, wenn sein xlink:href-Attribut auf ein base64-codiertes Image festgelegt ist.

Siehe hierzu auch: https://learn.microsoft.com/en-us/windows/win32/direct2d/svg-support

Siehe auch A.06.03.a