Tutorials   TouchMillumin   Experiments   Docs   Millumin ?


 

Tutorials






 

TouchMillumin

As Millumin supports OSC, you can use TouchOSC to control it via your iPad or your iPhone.
Please install the TouchOSC app on your device, then download one of the layouts below.
You can edit your own layout as well with the TouchOSC Editor (see OSC doc below).

   Android users : I couldn't find a way to upload a layout.
But if you succeed, it should work on your device too !

   If you need to run TouchMillumin on 2 devices, please download Multidevice


Download the layout for iPad


Download the layout for iPhone


Download the layout for iPhone (to map)



To map on iPhone, you can also use this custom layout by Benjamin Nesme.
Download this custom layout






 

Experiments

  • Developer Kit
    The Developer Kit shows you clear samples, to build your own apps.

  • KinectMask
    KinectMask allows you to create dynamic masks based on the depth.

  • MappingPresets
    MappingPresets allows you to recall and animate mappings.

  • SoundTransformer
    SoundTransformer helps you to create sound reactive installations.

  • SimpleSync
    SimpleSync allows you to synchronize several machines.

  • BigClock
    BigClock is ... a big clock, so you could see time from the moon.

  • TouchMoreOSC
    TouchMoreOSC allows you to create new OSC messages for Millumin.

  • Monomal
    With Monomal, you can use your Monome with Millumin.

  • Canon Camera support
    Plugging your Canon EOS camera, directly to Millumin via USB.







    •  

    OSC Documentation

    Here is the list of OSC messages that you can send or receive from Millumin. So you can make your own TouchOSC layout, or code an application that works with Millumin.

    Managing layer properties

    For the moment, you can use the addresses messages to manage 4 properties :
  • /millumin/layer/opacity     (the value is a float in percent)
  • /millumin/layer/xy     (the value is a couple of float)
  • /millumin/layer/rotation     (the value is a float between 0 and 360)
  • /millumin/layer/scale     (the value is a float in percent)

    • Every address ends with the index of the target layer :
  • 0 to target the selected layer
  • 1, 2, 3, ... to target the 1st, 2nd, 3rd, ... layer

    • Finally, the address in followed by the value(s) of the layer's property.
    Here are some examples :

  • To change the opacity of the selected layer to 75% :
         /millumin/layer/opacity/0 75

  • To change the opacity of the 1st layer to 40% :
         /millumin/layer/opacity/1 40

  • To change the position of the 2nd layer :
         /millumin/layer/xy/2 -200 350

  • To change the X of the 2nd layer :
         /millumin/layer/x/2 150

  • To change the Y of the 2nd layer :
         /millumin/layer/y/2 150

  • To change the rotation of the 3rd layer to 90° :
         /millumin/layer/rotation/3 90

  • To change the scale of the 4th layer to 50% :
         /millumin/layer/scale/4 50


    • Use the address /millumin/layer/addX or addY to make subtle moves. Examples :

  • To move the 2nd layer of 1 pixel right :
         /millumin/layer/addX/2 1

  • To move the 3rd layer of 1 pixel down :
         /millumin/layer/addY/3 -1


    • Selecting a layer

    You can select a layer with the OSC address /millumin/layer/select
    Examples :

  • To select the 1st layer :
         /millumin/layer/select/1 1

  • Deselect the 1st layer :
         /millumin/layer/select/1 0


    • Managing media

    You can assign a media to a layer with the OSC address /millumin/layer/media
    Please note that the address always ends with the index of the target layer.
    Examples :

  • To assign the 2nd media to the 3rd layer :
         /millumin/layer/media/2/3 1

  • To stop the 3rd layer :
         /millumin/layer/media/0/3 1


    • You can control the time position with /millumin/layer/media/time  (float from 0 to 1)
    or the speed with /millumin/layer/media/speed  (float in percent)
    Examples :

  • To set at the middle, the time position of the selected layer's media :
         /millumin/layer/media/time/0 0.5

  • To set at 50%, the speed of the selected layer's media :
         /millumin/layer/media/speed/0 50


    • When changing the layer's media, Millumin is sending a message to tell the media duration : /millumin/layer/currentMediaDuration  (float in milliseconds)
    Example :

  • The current layer has a duration of 5 seconds :
         /millumin/layer/currentMediaDuration/0 5000


    • Mapping

    To set one of the 4 map point, use the address /millumin/layer/mapPoint and a couple of float values
    Please note that the address always ends with the index of the target layer.
    Examples :

  • To set the position of the 1st map point in the 4th layer :
         /millumin/layer/mapPoint/0/4 -350 450

  • To set the position of the 4th map point in the selected layer :
         /millumin/layer/mapPoint/3/0 -310 -220


    • Use the address /millumin/layer/mapPointAddX or mapPointAddY to make subtle moves. Examples :

  • To move the 2nd map point of 1 pixel right :
         /millumin/layer/mapPointAddX/1/0 1

  • To move the 3rd map point of 1 pixel down :
         /millumin/layer/mapPointAddY/2/0 -1


    • Boards & Compositions

    When some specific events happen, Millumin send the following messages.

  • When a column is launched (the argument is the index of the column) :
         /millumin/board/columnLaunched 4

  • When a column is stopped :
         /millumin/board/columnStopped 3


  • When a cue point is reached :     
         /millumin/composition/cue "cue1"


    • Actions

    You can control the columns with the following messages :

  • To launch or stop a specific column :
         /millumin/action/launchOrStopColumn 4

  • To launch the previous or next column :
         /millumin/action/launchPrevColumn 1
         /millumin/action/launchNextColumn 1


    • You can control the composition with the following messages :

  • To play or stop the composition :
         /millumin/action/playOrStop 1

  • To start the composition :
         /millumin/action/composition/start 1

  • To stop the timeline :
         /millumin/action/composition/stop 1


    • You can stop all the media via :
         /millumin/action/stopAll 1

    You can exit or enter fullscreen via :
         /millumin/action/fullscreen 0
         /millumin/action/fullscreen 1

    You can open or save a project via :
         /millumin/action/openProject "/path/to/my/project.millu"
         /millumin/action/saveProject "/path/to/my/project.millu"

    You can quit Millumin via :
         /millumin/action/quit 1

    You can use the 'ping' message to receive several OSC messages,
    that describe the state for all the layers :
         /millumin/ping 1


    Summary

    Except for actions, suffix every address with the layer's index.
    0 is the index for the selected layer.

    Here is the list of OSC addresses available :
  • /millumin/layer/opacity
  • /millumin/layer/xy
  • /millumin/layer/x
  • /millumin/layer/y
  • /millumin/layer/rotation
  • /millumin/layer/scale
  • /millumin/layer/addX
  • /millumin/layer/addY
  • /millumin/layer/select
  • /millumin/layer/media
  • /millumin/layer/media/time
  • /millumin/layer/media/speed
  • /millumin/layer/currentMediaDuration
  • /millumin/layer/mapPoint
  • /millumin/layer/mapPointAddX
  • /millumin/layer/mapPointAddY
  • /millumin/board/columnLaunched
  • /millumin/board/columnStopped
  • /millumin/composition/cue
  • /millumin/action/launchOrStopColumn
  • /millumin/action/launchPrevColumn
  • /millumin/action/launchNextColumn
  • /millumin/action/playOrStop
  • /millumin/action/composition/start
  • /millumin/action/composition/stop
  • /millumin/action/stopAll
  • /millumin/action/fullscreen
  • /millumin/action/openProject
  • /millumin/action/saveProject
  • /millumin/action/quit
  • /millumin/ping
    •




     

    Artnet Documentation

    Here is the list of the DMX channel for Artnet, that works with Millumin.

    Global channels

  • 01     launch or stop column   (value : 0 to stop, 1-255 for column index)
  • 02     stop layer   (value : 0 for all, 1-255 to stop a specific layer)
  • 03     launch next column / playOrStop composition   (value : 1-255 to activate)
  • 04     play composition   (value : 1-255 to activate)
  • 05     stop composition   (value : 1-255 to activate)


    • Layer channels   (where X is the index of the layer)

  • X1     opacity   (value : 0-255 for 0/100%)
  • X2     x   (value : 0-255 for -1280/1270)
  • X3     y   (value : 0-255 for -1280/1270)
  • X4     scale   (value : 0-255 for 0/200%)
  • X5     rotation   (value : 0-255 for 0/360°)
  • X6     media   (value : 0 for none, 1-255 for media index)






    •  

    What's Millumin ?

    Millumin is a software to create and perform audiovisual shows.
    It helps you to integrate video in theaters, shows or mappings.

    Please visit the main website to try it !





    anomes © 2013