Behavior element behavior adding a renderable Panel widget.

This behavior is useful for models with a complex dynamic texture where the content of the texture is provided by a Panel widget. Multiple other behaviors can add their content Widget to the Panel separating logic for reuse. Using ECBehaviorRenderablePanel instead of ECBehaviorRenderableCanvas allows to use the full power of the GUI ToolKit including using Gui Themes to create complex content easily.

The default layout for the Panel is StackLayout]. The default gui theme is “/shareddata/guithemes/modern/modern.guitheme.xml”. The default Panel designer selector is “RenderablePanel”.

To use this behavior add an ECBehaviorDynamicSkin to the element class before adding this behavior. Create ECBehaviorRenderablePanel behavior and set the dynamic skin and designer selector and GuiTheme for the Panel. Now you can add other behaviors targeting the ECBehaviorRenderablePanel to add Widget resources to.

The Panel is created with a default size of 512×512 . You can change the size using the element property to fit the texture requirements.

See also:

• Dynamic Content using Renderables
• Gui Themes
• IGDE Skin Editor

Multiple instances of ECBehaviorRenderablePanel can be added to affect individual dynamic skin textures. Use the behavior identifier to tell them apart.

Element class properties have the prefix renderablePanel. or renderablePanel(id). if id is not empty.

Name of the renderable in the component skin to modify.

• Full name: renderablePanel.renderable or renderablePanel(id).renderable
• Type: string
• Default Value: empty string
• Example (*.deeclass):

  <string name='renderablePanel.renderable'>monitor content</string>

Size of panel in pixels.

• Full name: renderablePanel.size or renderablePanel(id).size
• Type: point
• Default value: (512, 512)
• Example (*.deeclass):

  <point name='renderablePanel.size' x='1024' y='512'/>

Path to gui theme to load. If the same gui theme is used in multiple elements it is loaded only once and shared.

• Full name: renderablePanel.guiTheme or renderablePanel(id).guiTheme
• Type: string
• Default value: /shareddata/guithemes/modern/modern.guitheme.xml
• File Pattern: *.guitheme.xml
• Example (*.deeclass):

  <string name='renderablePanel.guiTheme'>/content/ui/ingame.guitheme.xml</string>

Name of designer selector to use from gui theme specified in guiTheme property for panel widget. Allows to define multiple panels in one gui theme potentially sharing definitions.

• Full name: renderablePanel.designerSelector or renderablePanel(id).designerSelector
• Type: string
• Default Value: RenderablePanel
• Example (*.deeclass):

  <string name='renderablePanel.designerSelector'>RenderablePanel.CockpitMonitor.Center</string>

• ECBehaviorDynamicSkin

This behavior does not support optional behaviors.

This behavior does not required element class to be persistable (setPersistable).

ECBehaviorRenderablePanel.

Since DragonScript Module Version 1.3

• Create displays and monitors showing dynamic content like a digital wall clock or a train station time table. The element has one renderable used (typically emissivity to show the content. For each dynamic content to show add behavior providing the content.
• Generate textures with randomized content during game loading. Same as previous use case but content typically is static.
• Create dynamic skin content which is difficult to create using skin properties only. This can be individual moving and changing content like advertize board or shop signs.

class ExampleElementClass extends BehaviorElementClass
   public var ECBehaviorComponent component
   public var ECBehaviorCollider collider
   public var ECBehaviorDynamicSkin dynamicSkin
   public var ECBehaviorRenderablePanel renderablePanel
   
   public func new() super("ExampleElement")
     // add required behaviors component and collider
     component = ECBehaviorComponent.new(this)
     collider = ECBehaviorCollider.new(this, component)
     
     // add dynamic skin to modify component
     dynamicSkin = ECBehaviorDynamicSkin.new(this, component)
     
     // create renderable panel. the skin has to use a renderable named "board".
     // the panel has a size of 512x256 and uses gui theme loaded from "adboard.guitheme.xml".
     // the panel uses by default a stack layout hence all widgets added fill the
     // entire panel space and are layered ontop of each other. any behavior can
     // change the layout used for the panel if required
     renderablePanel = ECBehaviorRenderablePanel.new(this, dynamicSkin)
     renderablePanel.getRenderable().setValue("board")
     renderablePanel.getSize().setPoint(Point.new(512, 256))
     renderablePanel.getGuiTheme().setPath("/content/ui/adboard.guitheme.xml")

     // here you could now add behaviors adding content to the renderable.
     // the simply have to create (during their init(StubElement) call) one or more widgets
     // adding them to the renderable. using behavior makes this a reusable process
     //
     // MyContentBehavior.new(this, renderablePanel)
   end
   
   // another way is adding widgets yourself. this can be useful for prototyping
   // and situations where you have a simple gui widget
   protected func Element createElement()
     var BehaviorElement element = super.createElement()
     var Panel panel = renderablePanel.instance(element).getPanel()
     
     // add some content to it, for example a label which we can design using
     // the design selector "Label.AdEatMorePears"
     panel.addWidget(Label.new("Eat more Pears", "Label.AdEatMorePears"))
     
     // you could also add a panel with composed content inside. this is
     // usually the way to go as you can add content with your desited layout.
     // this example adds two labels against the top and bottom edge with an
     // image stretched between them. each can be designed using a respective
     // designer selector like adding borders, changing background, changing
     // padding, font and color
     panel.addWidget(Panel.new(BorderLayout.new(5), block Panel p
       p.addWidget(Label.new("Top-Side", "Label.TopSide"), BorderLayout.Area.top)
       p.addWidget(DisplayImage.new("/content/adEatMorePears.png", RepeatMode.stretch, "Image.AdEatMorePears"), BorderLayout.Area.content)
       p.addWidget(Label.new("Bottom-Side", "Label.BottomSide"), BorderLayout.Area.bottom)
     end))
     
     return element
   end
end

Using element class supporting adding behaviors the behavior can be added like this:

<?xml version='1.0' encoding='UTF-8'?>
<elementClass name='MyClass' class='GenericBehaviorElement'>
  <behavior type='ECBehaviorComponent'/>
  <behavior type='ECBehaviorCollider'/>
  <behavior type='ECBehaviorDynamicSkin'/>
 
  <behavior type='ECBehaviorRenderablePanel'>
    <!-- set element properties. omit property prefix if used inside behavior tag -->
    <string name='.name'>Color 1</string>
  </behavior>
 
  <!-- for adding multiple behaviors use unique identifiers -->
  <behavior type='ECBehaviorRenderablePanel' id='second'/>
</elementClass>

• DEExamples Repository