Skip to main content

External Resource

Content List


Action External Resource Behavior

Set External Bitmap
Description

Sets ExternalResourceId and ExternalResourceManagerId properties of an associated ExternalBitmapProvider when its action is triggered.

Common Properties
Property Name Type Description
ExternalResourceId String

A unique id of an external resource to be provided.

ExternalResourceManagerId String

A unique id of an external resource manager to retrieve the external resource from.

ImageProvider ExternalBitmapProviderBehavior

External Bitmap Provider that retrieves and provides a bitmap.

Condition External Resource Behavior

Check External Resource Change
Description

Reacts on ExternalResourceEvent if and only if the ExternalResourceId and ExternalResourceManagerId of the event match the condition’s properties, triggering the associated action.

Common Properties
Property Name Type Description
ExternalResourceId String

A unique id of an external resource to be provided.

ExternalResourceManagerId String

A unique id of an external resource manager to retrieve the external resource from.

Value Processing External Resource Behavior

External Bitmap Provider
Description

Retrieves an external bitmap with ExternalResourceId from an external resource provider with ExternalResourceManagerId and provides the bitmap to an associated bitmap node.

Common Properties
Property Name Type Description
TargetNode Candera::AbstractNodePointer

The Node which is modified. If not set, then the node where the behavior is attached to, will be modified.

ExternalResourceId String

A unique id of an external resource to be provided.

ExternalResourceManagerId String

A unique id of an external resource manager to retrieve the external resource from.

Set External Bitmap

    Drag&drop a BitmapNode from the "Nodes 2D" panel of the Toolbox to the Scene Editor or the Scene Tree.

    Drag&Drop an External Bitmap Provider behavior from "External Resource > Value Processing" on Toolbox on the BitmapNode in the SceneTree.

    Drag&drop two Buttons from the "Control" panel of the Toolbox to the Scene Editor or the Scene Tree.

    Drag&Drop a Set External Bitmap behavior from "External Resource > Action" on Toolbox onto the Actions sections on the Extra scene tree of each of the ButtonNodes.

    For each of the Buttons, select the Set External Bitmap behavior. Set the "ImageProvider" property to the External Bitmap Provider attached to the BitmapNode clicking on the magnifying glass on the right of the property.

    For each of the Buttons, select the Set External Bitmap behavior. Set the "ExternalResourceId" property to a specific external resource by clicking on the magnifying glass on the right of the property.

    Run the player and click on first button (the first image is displayed), then second button (the second image is displayedpicture shows up). 

     

    Check External Resource Change


    External Bitmap Provider

      Drag&drop a BitmapNode from the "Nodes 2D" panel of the Toolbox to the Scene Editor or the Scene Tree.

      Drag&Drop an External Bitmap Provider behavior (which is a Value Processing Behavior) on the BitmapNode in the SceneTree.


      Select the External Bitmap Provider of the BitmapNode on the right side of the Scene Tree view. Set the "ExternalResourceId" property using the "Select template for item" button and select an external image from the "Chose External Images" dialog. Alternatively, the resource id can be set manually.

      The BitmapNode shows the external resource.