dragengine:modules:dragonscript:behavior_skinswitcher
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| dragengine:modules:dragonscript:behavior_skinswitcher [2024/03/14 16:51] – dragonlord | dragengine:modules:dragonscript:behavior_skinswitcher [2025/03/13 17:13] (current) – dragonlord | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| {{tag> | {{tag> | ||
| <WRAP youarehere> | <WRAP youarehere> | ||
| - | [[: | + | [[: |
| </ | </ | ||
| Line 23: | Line 23: | ||
| ====== Instance Counts ====== | ====== Instance Counts ====== | ||
| - | Multiple instances of **ECBehaviorSkinSwitcher** can be used for example to switch skins of multiple component textures. | + | Multiple instances of '' |
| - | < | + | |
| - | class MyElement extends BehaviorElementClass | + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | + | ||
| - | | + | |
| - | component = ECBehaviorComponent.new(this) | + | |
| - | collider = ECBehaviorCollider.new(this, | + | |
| - | animated = ECBehaviorTwoStateAnimated.new(this, | + | |
| - | + | ||
| - | skinSwitcher = ECBehaviorSkinSwitcher.new(this, | + | |
| - | skinSwitcher.getTexture().setValue(" | + | |
| - | skinSwitcher.getSkins().add("/ | + | |
| - | skinSwitcher.getSkins().add("/ | + | |
| - | skinSwitcher.listen(animated) | + | |
| - | + | ||
| - | // Add a second skin switcher affecting a different texture. This example attaches | + | |
| - | // to the same animated | + | |
| - | subSkinSwitcher = ECBehaviorSkinSwitcher.new(this, | + | |
| - | subSkinSwitcher.getTexture().setValue(" | + | |
| - | subSkinSwitcher.getSkins().add("/ | + | |
| - | subSkinSwitcher.getSkins().add("/ | + | |
| - | subSkinSwitcher.listen(animated) | + | |
| - | end | + | |
| - | end | + | |
| - | </ | + | |
| ====== Element Class Properties ====== | ====== Element Class Properties ====== | ||
| - | Element class properties have the prefix | + | Element class properties have the prefix |
| ===== texture ===== | ===== texture ===== | ||
| Name of texture in component to switch skin. If empty string switch skin of component itself. | Name of texture in component to switch skin. If empty string switch skin of component itself. | ||
| - | * Full name: "skinSwitcher.texture" | + | * Full name: '' |
| * Type: string | * Type: string | ||
| - | * Default Value: | + | * Default Value: empty string |
| * Example (*.deeclass): | * Example (*.deeclass): | ||
| ===== skins ===== | ===== skins ===== | ||
| - | List of skins (for example *.deskin) | + | List of skins to cycle through. At least one skin is required to be defined for this property to be valid. |
| - | * Full name: "skinSwitcher.skins" | + | * Full name: '' |
| * Type: List of string | * Type: List of string | ||
| * Default value: empty list | * Default value: empty list | ||
| - | * Example (*.deeclass): | + | |
| + | | ||
| < | < | ||
| < | < | ||
| Line 77: | Line 49: | ||
| ===== clamp ===== | ===== clamp ===== | ||
| If the skin index reaches either end of the list it wraps around to the other end (from last to first and vice versa). If clamp is true wrapping around is disabled keeping the index at the last respectively first index. | If the skin index reaches either end of the list it wraps around to the other end (from last to first and vice versa). If clamp is true wrapping around is disabled keeping the index at the last respectively first index. | ||
| - | * Full name: "skinSwitcher.clamp" | + | * Full name: '' |
| * Type: boolean | * Type: boolean | ||
| - | * Default value: false | + | * Default value: |
| * Example (*.deeclass): | * Example (*.deeclass): | ||
| ===== activeSkin ===== | ===== activeSkin ===== | ||
| Index of first skin from //skins// property to show. Index has to be in the range from 0 to // | Index of first skin from //skins// property to show. Index has to be in the range from 0 to // | ||
| - | * Full name: "skinSwitcher.activeSkin" | + | * Full name: '' |
| * Type: integer | * Type: integer | ||
| - | * Default Value: 0 | + | * Default Value: |
| * Example (*.deeclass): | * Example (*.deeclass): | ||
| ====== Required Behaviors ====== | ====== Required Behaviors ====== | ||
| + | |||
| * [[behavior_component|ECBehaviorComponent]] | * [[behavior_component|ECBehaviorComponent]] | ||
| Line 98: | Line 71: | ||
| ====== Persistency ====== | ====== Persistency ====== | ||
| - | This behavior does support element class to be persistable (setPersistable). Saves the active skin index. | + | This behavior does support element class to be persistable (setPersistable). |
| ====== API Documentation ====== | ====== API Documentation ====== | ||
| Line 104: | Line 77: | ||
| # | # | ||
| - | Since DragonScript Module Version | + | Since DragonScript Module Version |
| ====== Use Cases ====== | ====== Use Cases ====== | ||
| Line 152: | Line 125: | ||
| end | end | ||
| </ | </ | ||
| + | |||
| + | ====== Behavior Factory ====== | ||
| + | |||
| + | Using element class supporting adding behaviors the behavior can be added like this: | ||
| + | <code xml> | ||
| + | <?xml version=' | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | < | ||
| + | | ||
| + | < | ||
| + | <!-- optional: use component with id instead of empty string --> | ||
| + | <string name=' | ||
| + | | ||
| + | <!-- set element properties. omit property prefix if used inside behavior tag --> | ||
| + | <string name=' | ||
| + | </ | ||
| + | | ||
| + | <!-- for adding multiple behaviors use unique identifiers --> | ||
| + | < | ||
| + | </ | ||
| + | </ | ||
| + | |||
| + | ====== Live Examples ====== | ||
| + | |||
| + | * [[https:// | ||
| + | |||
dragengine/modules/dragonscript/behavior_skinswitcher.1710435075.txt.gz · Last modified: 2024/03/14 16:51 by dragonlord
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
