Elements

Overview

Elements are the most important entity in a board. They are the building blocks of your diagrams, each of them containing a small part of your game.

By connecting elements together with connections, you allow the player to make choices and progress through your game.

{primary} You can play-test the flow of your elements and connections on Play Mode.

Creating elements

There are 3 ways to create an element:

  • Double click on an empty area of the current board.
  • Right click on an empty area of the current board and select Create Element from the menu.
  • Drag and drop the New element icon (at the bottom left corner of the workspace) on a empty area of the current board.

Adding and formatting text

Title and content

Each element has a title (the top, coloured part) and a content area (the main black part). To edit either, simply double-click on it.

To cycle editing between title and content, press the tab key.

To exit editing mode press esc or click on an empty area of the board.

Formatting menu

Elements support rich text format in both title and content. From the formatting menu, choose bold, italics, or underline.

Format a paragraph as blockquote, to make its text stand out as a quote or a sign.

You can also embed a link to a selected piece of text.

Adding arcscript segments

Finally, you can add code segments to your element content, assigning values to variables or manipulating the text output.

Arcweave uses its own scripting language, called arcscript.

To add arcscript code inside an element click on the arcscript segment icon in the toolbar while editing the element content. To exit the block press Enter.

{primary} To mark/unmark an arcscript segment you can also use the shortcut Ctr/Cmd+Shift+C.

Selecting elements

To select an element, simply click on it.

To select multiple elements, hold Shift or Ctrl/Cmd and either:

  • Click each element consecutively.

or:

  • Click and drag to create a selection rectangle.

{primary} You can similarly select entities of any kind: connections, notes or jumpers.

Resizing elements

To resize an element, select it and drag its corners or edges to the desired size.

{primary} You can quickly auto-resize a selected element to fit to its content by double clicking on any of its corner or edge resize handles.

Deleting elements

To delete an element, you can either:

  • Select it.
  • Press Delete or Backspace.

or:

  • Right-click on it
  • Select Delete from the menu.

Changing theme

To change the color theme of an element, right click on it and select one of the available colors from the menu.

Cover image

Elements can optionally have one cover image. On Play Mode, the image is rendered above the element's text content.

As cover images, you can use your project's assets, icons from Arcweave's icon library or emebed a Youtube video. To assign a cover image from either sources:

  • Right-click on the element.
  • Select Set cover.
  • Select a tab: My Assets or Icon Library or Embed.
  • Choose an image, an icon or paste a youtube video URL.

{primary} To use your own images in a project, you must first upload them as assets.

Another way to assign a cover is to drag an image from the sidebar's assets list straight into the desired element.

To change an element's cover, select Set cover again or drag a new asset into it.

To remove an element's cover:

  • Right-click on the element.
  • Select Remove cover.

Attaching audio assets to elements

Elements can optionally have one or more attached audio assets. The audio assets play during Play Mode, upon the element's rendering, as loops or one-shots.

To attach an audio file to an element you must first upload it as an asset. To assign an uploaded audio asset to an element, drag and drop it from your assets list into the element.

Once attached, click on the asset to open its settings menu. This allows you to preview the audio file's playback, as well as assign one of the three following options regarding its play mode behaviour:

  • Play clip once: the audio assets plays once, from start to finish.
  • Loop clip indefinitely: the audio asset loops, i.e. restarts every time it reaches its end.
  • Stop playing all instances of clip: this stops the existing playback of the asset, if already happening.

{primary} To stop a looping asset, you must attach the same asset onto one of the following elements and set it to "Stop playing all instances of clip."

To move audio assets between elements, drag them from one element and drop them into another. <!---to reorder them inside an element or--->

To remove an attached audio asset, drag and drop it from the element to an empty workspace area.

{info} Removing an audio asset from an element simply removes the reference and does not delete the asset.

Attaching components to elements

You can attach components to elements. See components.