Skip to main content

Canvas

BRICKS TOOLS avatar
Written by BRICKS TOOLS
Updated over a week ago

The display area that hosts various basic Brick components. A Subspace can contain multiple Canvas screens, and its settings allow you to define the display order and switching rules of these canvases.


  • Properties Section

Property Name

Property Type

Description

Showing Timeout

ms


Milliseconds

The display time (in milliseconds) of the canvas. Used together with Next Canvas ID or Event Showing Timeout.


When a Next Canvas ID is specified, the canvas will switch to the designated canvas after the configured display duration has elapsed.

Next Canvas ID

String


Text string

The ID of the next canvas that is to be displayed following the current canvas. Used together with Showing Timeout.


Configure the behavior when a Showing Timeout is set: once the time has elapsed, the display will switch to the next Canvas specified by its ID.


  • Event Section

First Enter

Event that will be triggered when the canvas is being shown for the first time after starting the application.


An event triggered the first time the Canvas is displayed within a Subspace.

Enter

Event that will be triggered every time when the canvas is being shown.


An event triggered each time the Canvas is displayed.

Showing Timeout

Event that will be triggered when the time specified in property Showing Timeout is up.


If a Showing Timeout is set, this event is triggered after the specified time has elapsed.

Exit

Event that will be triggered when the application is about to exit the current canvas and display the next canvas.


An event triggered before the Canvas is switched to another Canvas.


  • Operation Section

    • Become Root Canvas (available when not currently the Root Canvas)
      Set the specified Canvas as the default root Canvas to be displayed.

    • Duplicate (Keep Brick References)
      Duplicate a Canvas while maintaining references to its Bricks. In this mode, the duplicated Bricks share the same IDs as those in the original Canvas. If the positions of the Bricks differ between the two Canvases, dynamic transition effects will automatically be generated when switching between them.

    • Copy
      Create an identical Canvas, but without maintaining references between the Bricks. Each Brick in the new Canvas is independent and assigned a separate ID.

    • Inspect This Canvas
      Use Inspect This Canvas to clearly visualize the event and Property Calculation relationships between Canvases.

    • Event Routing
      Displays the flow of events or calculations triggered by this Canvas, showing which Bricks or Generators are affected.

    • Parent Call
      Displays which Bricks, Generators, or Property Calculations triggered or are linked to this Canvas. This is the reverse of Event Routing: while Event Routing shows downstream effects, Parent Call shows the upstream sources.

    • Remove This Canvas (available when not currently the Root Canvas)
      Delete this Canvas. Note: This action cannot be undone.


  • Example Usage

    When an application requires multiple interfaces on the display screen, you can use different Canvases to separate and manage each interface.


Did this answer your question?