SetDialogueBackground: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: „Category:NLTScript Referenz <syntaxhighlight lang="javascript"> setDialogueBackground("bildname"); </syntaxhighlight> Ein Dialog hat die Möglichkeit, ein …“) |
|||
| (Eine dazwischenliegende Version von einem Benutzer wird nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
[[Category:NLTScript Referenz]] | [[Category:NLTScript Referenz]] | ||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
| − | setDialogueBackground("bildname"); | + | setDialogueBackground("bildname"); // "bildname" als Hintergrundbild anzeigen |
| + | setDialogueBackground(""); // Hintergrundbild löschen | ||
| + | |||
| + | setDialogueBackground("bildname", true); // "bildname" als Hintergrundbild anzeigen und Charakterportraits ausblenden | ||
</syntaxhighlight> | </syntaxhighlight> | ||
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. | 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. | ||
| Zeile 10: | Zeile 13: | ||
* 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" | * 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" | ||
| − | ''Hinweis'': Funktioniert nur, wenn gerade ein Dialog | + | 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 | ||
Aktuelle Version vom 9. August 2018, 22:05 Uhr
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"/>
