Visual Logic Editor, aka Puzzles

Verge3D Puzzles is a powerful yet easy-to-use tool for creating behavior scenarios. With Puzzles you can make your 3D content interactive and responsive to user actions.

If you are no coder (designer, marketer, engineer, teacher?), this tool will significantly extend your possibilities. However, even if you are a seasoned programmer, you may find it very helpful both in prototyping and in production.

Running the Editor

The Puzzles editor may be launched from the main page of the App Manager.

You can also run the editor from the application page, which in turn, is opened by clicking on the application name.

Creating Scenarios

By dragging individual puzzles from the toolbox on the right to the workspace and connecting them together, you can create various scenarios and see how they work with your 3D content right away.

Here are some resources that may help you get started:

Controls

Run

After clicking this button, your puzzles take effect. Under the hood, the Run button interprets the puzzles currently present in the work space (in all tabs) and produces JavaScript code from them. The code is then executed by the browser and thus applied to the application running in the background.

Most of the times, you can repeatedly click Run in order to immediately apply your tweaks for the puzzles. However, if you want to reset the state of your app and perform a clean run, simply use the browser's standard refresh page button instead. Once the page is refreshed, the puzzles automatically take effect. Be sure to save your changes before reloading the page otherwise they will be lost!

Save

This button saves your puzzles. Similarly to the Run operator, the Save button interprets the puzzles currently present in the work space (in all tabs) and produces JavaScript code from them. However, the code is not executed. Instead, all puzzles and the generated code are saved in the application folder for persistent storage as the files visual_logic.xml and visual_logic.js, respectively.

The Save operator requires the local development server to be running. The server is launched automatically with the first instance of 3ds Max or Blender, but if it went down for some reason, a connection error will be displayed when you try to save your puzzles:

In this case you should launch 3ds Max or Blender, or, if the program is already running, start the App Manager again.

See also Backup.

Minimize

As the editor window often obscures the application running in the background, you can use this button to hide it. It can be brought back by clicking the top left puzzle-like button.

Reset / Refresh

Use the browser's standard refresh page button to reload the editor and the application running in the background. All unsaved puzzles or changes will be removed, and all variables and scene objects properties will be reset to their initial values.

Resize

Drag the corner of the editor window to resize it.

If the draggable corner is not visible, perform right click and select Reset Editor Dimensions:

Tabs

You can reorder your puzzles in tabs to make them more manageable and responsive. To create a new tab, click on the "plus" button in the top bar, and enter the tab name in the text field.

Now you can add puzzles to the new tab. To move some puzzles from another tab, use the cut and paste shortcuts Ctrl-X / Ctrl-V. All tabs share the same namespace, so you can define procedures or variables in one tab and use them in another.

To delete a tab, click on the cross button near its name. Use this operation with caution as it cannot be undone except by restoring from a backup. All puzzles from a deleted tab will be destroyed!

There is no dedicated control for renaming tabs as of version 2.14. However, you can easily rename a tab by editing the visual_logic.xml file in your application folder.

Once renamed, your tab name will be updated after refreshing the editor.

Right Click Menu (Over a Puzzle)

The context menu can be invoked by right-clicking on a puzzle (residing in the toolbox or placed in the workspace), or on the empty workspace. The menu provides the access to a bunch of very helpful operators.

Duplicate

Creates a copy of a group of puzzles. You can also use the copy and paste shortcuts Ctrl-C / Ctrl-V to do the same.

Add Comment / Remove Comment

Adds a comment to a puzzle. The comment is represented with a question mark button by clicking on which a comment window is revealed. The comment may be saved persitently in both open and closed state.

A comment can be removed by selecting Remove Comment in the right-click menu.

Inline Inputs / External Inputs

By default, a puzzle can be in its inlined or external inputs form. This menu option switches between these forms. The difference is purely cosmetic, yet sometimes transforming puzzles can make them more readable and compact.

Collapse / Expand

A group of puzzles can be collapsed to make it more compact.

Disable / Enable

Use this menu option to skip a group of puzzles from execution.

Delete

Deletes a group of puzzles. Alternatively, use the Del key.

Save to Library

Saves a group of puzzles to the library for the purpose of reusing it later.

Help

Opens the corresponding puzzle's page from the Puzzles Reference. Available both for the toolbox...

...and for puzzles in the workspace:

You can also access the help pages from this manual's contents window (on the right).

Right Click Menu (Over the Workspace)

Undo / Redo

Reverses or repeats the most recently performed action. You can also use the shortcuts Ctrl-Z / Ctrl-Shift-Z.

Straighten Up

Repositions all the puzzles in a tab so that they form a neat line.

Collapse / Expand

Works similarly to the single group variant, except it affects all puzzles in a tab.

Delete

Works similarly to the single group variant, except it deletes all puzzles in a tab.

Reset Editor Dimensions

Resizes the editor window to better fit the screen resolution.

Backup

Every time you click the Save button, the previously saved file visual_logic.xml is copied to the folder called puzzles_backup with a time stamp added to the file name.

This allows you to restore any of the previously saved revisions of your puzzles when you need it. Simply copy a file back to the application folder root and remove the time stamp from its name. Your puzzles will be updated after refreshing the editor.

Got Questions?

Feel free to ask on the forums!