Manuals

Some widgets only appear when a corresponding block exists in the block network (e.g. no curve editor without at least one being.motion_player.MotionPlayer instance). The dummy being (scripts/dummy_being.py) can be used to activate all of the mentioned widgets.

from being.awakening import awake
from being.behavior import Behavior
from being.motion_player import MotionPlayer
from being.motors import DummyMotor
from being.resources import manage_resources
from being.sensors import DummySensor


with manage_resources():
    sensor = DummySensor()
    behavior = Behavior()
    motionPlayer = MotionPlayer(ndim=2)

    motionPlayer.positionOutputs[0].connect(DummyMotor(name='Motor 1').input)
    motionPlayer.positionOutputs[1].connect(DummyMotor(name='Motor 2').input)

    awake(sensor | behavior | motionPlayer)

Control Panel

The control panel shows the block diagram of the running being program. Solid lines correspond to message and dashed lines to value connections. The lines are animated and indicate if data is flowing through (moving red dots and dash animation).

The block names are defined inside the being program. By default these correspond to the block type but can be set to arbitrary names representing the installation.

With the on / off button the motors can be enabled or disabled. The home button can be used to re-home the motors. With the console button to the right some of the log messages can be shown and copied to the clipboard.

Behavior

This widget corresponds to a behavior block. It shows the 3x behavior states (I - III). Each state has its own motion repertoire, a subset of all available motion curves from the content. These define which motions get played for a given state. If a trigger occurs the behavior jumps to the state III and traverse back to state II and then I. If no motion is selected a state can also get skipped. Only one motion for state III will be played and duration inside state II can be controlled with the minimum duration slider. The active state is highlighted with a black drop shadow.

The behavior can be stopped with the play / pause button and the now playing label indicate the currently playing motion.

Editor

This widget can be used to create, edit and playback motion curves. All motion curves are listed in the left sidebar and can be renamed by double clicking the name.

Black circles are knots and red circles control points.. Both can be dragged around with the mouse. By double clicking new knots can be inserted or deleted. Multiple knots / control point can be selected and moved at the same time.

For navigation hold the shift key and move the canvas around. This can also be used to zoom in and out.

Clicking on the canvas relocates the transport. The current playback position. Playback will be resumed from this position (play / pause button or hitting the space bar).

Toolbar

Undo and redo edits. Each action on the curve is auto saved and every curve has its own editing history.

Zoom in and out. Reset viewport to see entire curve.

Motion player selection. This controls on which motion player / motor set the curve is played. Playback control, motion recording and looping.

Curve selection. Select which spline in the curve is shown. Remove and add new splines.

Snap to grid, line continuity at knot, limit curve to motor range and live preview positions on the motor when moving knots.

Actions: Scale, stretch, shift, flip and erase.

Upload or download motion curves.