SetDialogueBackground

setDialogueBackground("bildname"); // "bildname" als Hintergrundbild anzeigen
setDialogueBackground(""); // Hintergrundbild löschen
 
setDialogueBackground("bildname", true); // "bildname" als Hintergrundbild anzeigen und Charakterportraits ausblenden

Ein Dialog hat die Möglichkeit, ein auf die Bildschirmgröße gedehntes Bild anzuzeigen. Dieses kann mittels setDialogueBackground direkt im Dialog gesetzt und verändert werden, zur Verfügung stehen die Vanilla Ressourcen-Bilder (resources.asset, zB item/alchemieset, item/araxgift oder images/magier_04) aber auch alle Bilder, die über imagedirectory per Mod eingebunden wurden. Letztere werden "lazy" geladen, d.h. bei der ersten Verwendung kann es zu einer kurzen Verzögerung bis zur Bildanzeige kommen, je nach Größe des Bildes und Zugriffsgeschwindigkeit.

Das Bild wird so auf den Bildschirm gedehnt, dass zwar das Bildverhältnis (Breite zu Höhe) konstant bleibt, damit aber keine Flächen durchscheinen, wird das Bild entsprechend des aktuellen Anzeige-Verhältnisses "mit Overscan" skaliert. Konkret bedeutet das:

• Stimmen das Bildschirmverhältnis und das Bildverhältnis überein (zB sowohl das Bild als auch die Anzeige sind 16:9), so wird das Bild vollständig dargestellt
• Ist das Bildseitenverhältnis kleiner als das Bildschirmverhältnis (Bild ist "hochformatiger" als Bildschirm), so wird das Bild in voller Breite angezeigt, obere und untere Überstände "ragen über den Bildschirm hinaus"
• Ist das Bildseitenverhältnis größer als das Bildschirmverhältnis (Bild ist "querformatiger" als Bildschirm), so wird das Bild in voller Höhe angezeigt, linke und rechte Ränder "ragen über den Bildschirm hinaus"

Die Bildnamen "fadetoblack", "fade" und "ftb" sind reserviert, sie zeigen eine Abdunkelung der aktuellen Szenerie an.

Um das Hintergrundbild im Dialog wieder zu entfernen, einfach einen leeren Namen an die Funktion übergeben.

Hinweis: Funktioniert nur, wenn gerade ein Dialog aktiv ist

Hinweis: Um eigene Bilder einzubinden, müssen diese in einem Mod im Unterordner bilder liegen und dieser muss auch in der contentinfo.xml des entsprechenden Mods eingefügt sein:

<imagedirectory name="bilder"/>