Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
visualizer:3d-sets [2025/03/07 07:31] – juliavisualizer:3d-sets [2025/03/07 08:36] (aktuell) – [Parameter der neo-code-Komponente] adminwiki
Zeile 1: Zeile 1:
 ===== 3D-Sets ===== ===== 3D-Sets =====
  
-{{INLINETOC 4}}+{{INLINETOC 3}}
  
 3D-Sets sind Code-Elemente, die anstelle von 3D-Objekten in die Szene eingefügt werden können. Sie werden verwendet, wenn komplexe zusammengesetzte Elemente, die eine Einheit bilden und wie ein einzelnes Modell reagieren sollen, gewünscht sind. 3D-Sets können Interaktionselemente, Animationen und Audio-Clips enthalten. Zudem können 3D-Sets auch mit anderen Elementen in einer Szene interagieren. 3D-Sets sind Code-Elemente, die anstelle von 3D-Objekten in die Szene eingefügt werden können. Sie werden verwendet, wenn komplexe zusammengesetzte Elemente, die eine Einheit bilden und wie ein einzelnes Modell reagieren sollen, gewünscht sind. 3D-Sets können Interaktionselemente, Animationen und Audio-Clips enthalten. Zudem können 3D-Sets auch mit anderen Elementen in einer Szene interagieren.
Zeile 23: Zeile 23:
 ==== Parameter der neo-code-Komponente ==== ==== Parameter der neo-code-Komponente ====
  
 +  - <String> ''name'': Name der neo-code-Komponents
 +  - <Boolean> ''enabled'': Aktiviert/deaktiviert die Komponente
 +  - <String> ''code'': Selektor auf den auszuführenden Code-Block (optional)
 +  - <Array> ''params'': Namen der Parameter p0-p14 in fortlaufender Reihenfolge
 +  - <String> ''p0...'': Wert des jeweiligen Parameters
 +  - <Number> ''codeRunDelay'': Verzögerung der Ausführung des Code-Blocks
 +  - <Boolean> ''updateShadowMap'': Aktiviert/deaktiviert ein Update der shadowMap nach Ausführen des Code-Blocks
 +
 +=== Parsen der Parameter-Werte ===
 +
 +Der default Parameter-Typ ist ''String''. Ein automatisiertes Parsen findet in folgenden Fällen statt:
 +  - Wert: 'true' oder 'false' -> ''Boolean''
 +  - Wert: '123.45' (einzelner nummerischer Wert) -> ''Number''
 +  - Wert: '0 1' (zwei durch Leerzeichen getrennte nummerische Werte) -> ''Vector2''
 +  - Wert: '0 1 2' (drei durch Leerzeichen getrennte nummerische Werte) -> ''Vector3''
 +  - Wert: 'val1, val2, val3' (kommasepariert Werte) oder Parameter-Name endet mit '[]' -> ''Array''
  
 ==== Syntax des editorConfig-Attributes ==== ==== Syntax des editorConfig-Attributes ====
Zeile 34: Zeile 50:
  
 Die durch editorConfigGlobal definierten Controls werden im oberen Abschnitt 'Szeneneinstellungen' des Room-Viewer-UIs angezeigt. Die editorConfig-Werte werden zu dem einzelnem Raumelement unterhalb von Raumelemente angezeigt. Die durch editorConfigGlobal definierten Controls werden im oberen Abschnitt 'Szeneneinstellungen' des Room-Viewer-UIs angezeigt. Die editorConfig-Werte werden zu dem einzelnem Raumelement unterhalb von Raumelemente angezeigt.
- 
-=== Labels === 
  
 === Attribute vs. Property === === Attribute vs. Property ===
Zeile 91: Zeile 105:
  
 Im UI wird dann ein Farbwahlelement angezeigt. Im UI wird dann ein Farbwahlelement angezeigt.
 +
 +=== Labels ===
 +Labels für UI-Elemente können nach der Property getrennt durch eine Tilde ('~') angefügt werden. Die Labels werden dabei in englisch angegeben. Findet sich im Dictionary eine Übersetzung für das Label, dann wird das Wort in die jeweilige Sprache übersetzt. Bei durch Unterstrich ('_') getrennten Wörtern werden die einzelnen Wörter getrennt übersetzt und der Unterstrich wird durch ein Leerzeichen ersetzt.
 +
 +Beispiel: ''functionName~Info:button~show''
 +  * functionName: Name der aufzurufenden Funkion
 +  * Info: Text vor dem Button
 +  * button: Typ der Definition (kann auch bool oder ein Wertebereich sein (s. u.)
 +  * show: Label-Text auf dem Button
  
 === Übersetzungen === === Übersetzungen ===
 Die Label-Namen ergeben sich, sofern sie nicht explizit angegeben sind, aus den Attribute-Namen, die in der editorConfig angegeben sind. Die Label-Namen ergeben sich, sofern sie nicht explizit angegeben sind, aus den Attribute-Namen, die in der editorConfig angegeben sind.
  
-=== Bildung von Translation-Keys ===+== Bildung von Translation-Keys ==
  
 Die Bildung der Keys folgt diesen Regeln (in den Beispielen hinter dem ':' ist der Key fett markiert): Die Bildung der Keys folgt diesen Regeln (in den Beispielen hinter dem ':' ist der Key fett markiert):
Zeile 110: Zeile 133:
 Die Prüfung erfolgt in der angegebenen Reihenfolge. D. h. die Übersetzung der Standard-Control-Labels kann nicht von Element-Übersetzungen überschrieben werden.  Die Prüfung erfolgt in der angegebenen Reihenfolge. D. h. die Übersetzung der Standard-Control-Labels kann nicht von Element-Übersetzungen überschrieben werden. 
  
-**Hinweis: Translation-Keys sind (wie bei dem benutzten ember-intl) case sensitive zu benutzen**+//Hinweis: Translation-Keys sind (wie bei dem benutzten ember-intl) case sensitive zu benutzen//
  
 Durch einen Unterstrich '_' angehängte Zeichen werden bei der Suche nach einer Übersetzung entfernt. Der Unterstrich wird durch ein Leerzeichen ersetzt. Dadurch ist es möglich, nur den ersten Teilstring zu übersetzen. Durch einen Unterstrich '_' angehängte Zeichen werden bei der Suche nach einer Übersetzung entfernt. Der Unterstrich wird durch ein Leerzeichen ersetzt. Dadurch ist es möglich, nur den ersten Teilstring zu übersetzen.
Zeile 118: Zeile 141:
   * Bed_Whiteline -> Bett Whiteline (Whiteline ist ein Produktname, der nicht übersetzt wird)   * Bed_Whiteline -> Bett Whiteline (Whiteline ist ein Produktname, der nicht übersetzt wird)
  
-=== Übersetzung von Keys ===+== Übersetzung von Keys ==
  
 Der Key wird zunächst ganz geprüft (ohne den Teil nach '_') und dann von hinten bis zum '-' gekürzt um einen neuen zu prüfenden Key zu bilden. Der Key wird zunächst ganz geprüft (ohne den Teil nach '_') und dann von hinten bis zum '-' gekürzt um einen neuen zu prüfenden Key zu bilden.
Zeile 127: Zeile 150:
   * Undsoweiter, bis der Key nicht weiter gekürzt werden kann   * Undsoweiter, bis der Key nicht weiter gekürzt werden kann
  
-**Hinweis:** Übersetzungen können aktuell im Visualizer nicht hinzugefügt werden. Es können jedoch vorhandene Schlüssel benutzt werden.+//Hinweis: Übersetzungen können aktuell im Visualizer nicht hinzugefügt werden. Es können jedoch vorhandene Schlüssel benutzt werden.//
  
 === Konfigurationsbeispiele === === Konfigurationsbeispiele ===