OM# Documentation

Box inputs

Box inputs allow entering arguments/attribute/parameters to OM# boxes.

These values can be set “by hand” by just clicking on the input and typing a simple value, or through a connection to another box’s output.

Note: shift + click on the input will automatically create a simple value box connected to the input.

Additional Inputs

Boxes with a small + icon at the top-left corner have hidden optional or keyword inputs. When such inputs are visible, they can be removed with the other small - button.

There exist two types of additional inputs, which correspond to different existing types of arguments in Common Lisp:

Optional

Optional inputs correspond to the keywords &optional or &rest in Common Lisp lambda-lists. They represent an fix-ordered sequence of additional arguments. Added optional inputs can be inspected and used just as other inputs.

Note: Alternative shortcuts for adding/removing optional inputs are alt + → and alt + ← , or > and <.

Keyword

Keyword inputs are additional inputs which must be 1) named and 2) set by the user beforehand. They correspond to the keyword &key in Common Lisp lambda-lists.

The list of available keywords is accessed by clicking the input. By default keywords are added in the order of the list, but they can be renamed and interchanged anytime. As compared to optional inputs, this mechanisms prevents for instance from displaying all the additional inputs when only the last one is to be used.

Once the name of the keyword input is selected, it’s value can be set either by connecting a value to it or (in some cases where the number of possible value is small and finite) via a second embedded menu:

Note: Alternative shortcuts for adding/removing keyword inputs are K and shift + K.

Input menus

Some (non-keyword) box inputs also provide a menu allowing to choose between different options. Just click on the input to pop the menu up, and select one item.