Sofian Audry edited this page Nov 16, 2017 · 12 revisions

Currently supported commands

General rules:

  • Paint and mapping ids are numbered starting from 1.
  • On/off properties such as solo, visible and lock are set using 1 (on) or 0 (off)
  • Percentage properties such as opacity and volume are set using a real-value in the [0, 1] range.

Paints

Rename: /mapmap/paint/name ,is <id> <name>
Adjust opacity: /mapmap/paint/opacity ,if <id> <opacity>

Color paint

Adjust color (eg. "#ff0000"): /mapmap/paint/color ,is <id> <color>

Image/Video paint

Change URI (eg. "file:///path/to/clip.mov"): /mapmap/paint/uri ,is <id> <uri>
Change rate (speed) (*): /mapmap/paint/rate ,if <id> <rate>
Adjust audio volume: /mapmap/paint/volume ,if <id> <volume>
Rewind: /mapmap/paint/rewind ,i <id>

(*) 1 = same speed, 0.5 = half speed, 2 = double speed

Mappings

Rename: /mapmap/mapping/name ,is <id> <name>
Adjust opacity: /mapmap/mapping/opacity ,if <id> <opacity>
Set visibility status: /mapmap/mapping/visible ,ii <id> <visible>
Set solo status: /mapmap/mapping/solo ,ii <id> <solo>
Set lock status: /mapmap/mapping/locked ,ii <id> <locked>
Adjust depth (layer order): /mapmap/mapping/depth ,ii <id> <depth> Change associated paint: /mapmap/mapping/paintId ,if <id> <paintId> (will not work if paint is not compatible to avoid errors)

Regular expressions

Paint and mapping ids are hard to remember and manipulate. Alternatively, one can use a string pattern describing a regexp over the paint or mapping names. The regular expression follows a simple "file globbing" / wildcard syntax. It is case-sensitive.

Examples

Change opacity of paint named "movie.mov" to 0.1 (10%):
/mapmap/paint/opacity ,sf "movie.mov" 0.1

Change opacity of all paints whose name begins by "movie-" to 0.5 (50%):
/mapmap/paint/opacity ,sf "movie-*" 0.5

Rewind all .mov paints:
/mapmap/paint/rewind ,s "*.mov"

Set all mappings that begin with "mesh-" followed by a single digit to solo mode:
/mapmap/mapping/solo ,s "mesh-[0-9]" 1

Playback

Pause: /mapmap/pause
Play: /mapmap/play
Rewind/reset: /mapmap/rewind
Quit: /mapmap/quit

Suggested/debated

New

/mapmap/mapping/new ,is <paint-id> <classname>    Create new mapping of class <classname> with paint <paint-id>
OR
/mapmap/mapping/new/<type> ,is <paint-id>         Create new mapping of type <type> (mesh, triangle, or ellipse) with paint <paint-id>

/mapmap/paint/new ,s <classname>   Create new paint of class <classname>
OR
/mapmap/paint/new/media ,s <uri>   Create new media paint with <uri>

Potentially destructive

Notice that /mapmap/quit is already destructive also, so...

/mapmap/paint/delete ,i <id>       Delete paint <id> and all its mappings
/mapmap/mapping/delete ,i <id>     Delete mapping <id>
/mapmap/load ,s <filename>         Open file (might be dangerous: might break what we are doing)

Reordering

/mapmap/mapping/depth ,ii <id> <depth>   Set depth of mapping to <depth> (depths will then be reconfigured)
OR
/mapmap/mapping/move ,ii <id> <steps>    Move mapping <id> by <steps> in the layers (steps can be positive or negative)
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.