Medias

Medias represent the content displayed by Millumin layers. There is many kinds of media, such as videos, images, inputs, … And all can be found in the Library.


Library

These is where Millumin will store the sources of all medias. One file from your computer can be dragged-and-dropped into Millumin library, it will be added as a new source. Then those sources can be picked from the library to be added to a layer as a media and be displayed in the canvas. If a file is directly dragged and dropped from the computer to a layer as a media, it will also be automatically be added to the library as a source.


More information on the sources can be displayed by clicking on the hamburger button at bottom right of the library. The sources will be bigger and more info will be displayed :


Selected source can be previsualized by clicking on the i button at the bottom right of the library. A little media player will popup above the library with information on the side such as video codec, resolution, duration, and media path :


Sources in the library can be right-clicked to open a menu with more in depth controls :

  • Rename if it is allowed
  • Replace by another media of the computer
  • Reload if the file changed
  • Show in Finder if it is a file
  • Remove from the project

Please note that if a source cannot be found any more, a red cross will appear in the library to notify you about this issue :


Groups can be add to the library to help to organize the sources. Click on the + button to do so :


The group can be renamed of course. Drag-and-drop some sources inside a group to organize them :

Image

Images files can be dragged to a Millumin’s project as a media. Millumin handle all the kind of picture, with or without alpha, premultiplied or unpremultiplied.


Media properties can be edited in the properties-view.
 You can even add effects to a particular media by clicking the gear icon. More info in the dedicated article : Effects

Movie

Most of the movie codecs are handle by Millumin, see dedicated article for more info : Recommendations


Movie have a lot of properties to manage its playback :

  • speed, to obvisouly edit the speed of the movie.
  • loop mode, with 4 different modes :
  • Infinite : the movie will indefinitely loops on himself
  • Once (freeze) : the movie will play once and freeze on its last frame
  • Once (stop) : the movie will play once and stop (nothing will be displayed anymore)
  • Auto-follow : the movie will play once and when it ends, the next column will be launched
  • start point, to set the time at which the movie should start in min:sec:frame. Default value is 00:00:00.
  • end point, to set the time at which the movie should end in min:sec:frame. Default value is the full duration of the movie.
  • timecode, to bind the timeline of the movie to a timecode. More information here : Timecodes

Color-card

Color-card is a simple media that allows to display a rectangle of plain color with or without a horizontal gradient.


Color-card sources can be created from the + button at the bottom left of the library:


The color-card can be personalized by double-clicking on the source in the library:


This pop-up allow to edit :

  • type: the kind of color-card:
  • Solid: the color-card will be plain color.
  • Gradient: the color-card will be the gradient between two colors.
  • color: choose the color of the color-card. In gradient mode, the first one is for the top color and the second one is for the bottom color.

Note that all the color-card media created from the edited source in the library will be impacted by those changes.


Color-card media can be found in the properties-view.

Timeline

To know about creating and editing a timeline : Timeline


When added to a layer, a timeline will by default play its first segment. The played segment can be changed in edit-mode by clicking on the media in the dashboard:


The property of the timeline media can be edited in the properties-view:


  • custom segment: allows to override the selected segment to read:
  • (none): the default value. The timeline will play the selected segment segment in the dashboard with its loop mode.
  • a segment name: the new segment to play.
  • (whole timeline): play all the timeline as a segment.
  • loop mode: only visible if a custom segment is selected, other than (none).
  • Infinite: the segment will indefinitely loops on himself.
  • Once (freeze): the segment will play once and freeze on its last frame.
  • Once (stop): the segment will play once and stop, nothing will be displayed anymore.
  • Auto-follow: the segment will play once and when it ends the next column will be launched.
  • audio-volume: edit the audio volume of the timeline.
  • dmx-volume: if the timeline have layers or tracks that stream DMX, it adjusts the intensity of the sent data.
  • link dmx-opacity: opacity of the dmx layer of the timeline is linked to the timeline’s opacity.
  • timecode: bind the timeline to a timecode. More info about timecode here: Timecodes

Inputs

Inputs sources can find in the inputs group of the library:


This is where all the video and audio inputs device, such as camera, microphone, video capture (BlackMagic, AJA, Epiphan, …), NDI or Syphon streams, handled by Millumin will appear.


Here are the default properties for video inputs :


  • format: if the device allows it, change format of the video stream.
  • lock exposure: if the camera allows it, deactivate auto-exposure.
  • lock white-balance: if the camera allows it, deactivate auto-white-balance.
  • keep hot: ask to not close the camera or the video stream if the media is not played.

Here are the default properties for audio inputs :

  • keep hot: ask to not close the camera or the video stream if the media is not playing.
  • audio-volume: adjust the volume of the audio-device.

More info about inputs media can be found in the dedicated article : Capture

Shader

Shaders a little program executed on the graphic card to generate, compute and modify images. They are very useful to generate realtime effects.


Shader sources can be find in the shaders group of the library:


New shaders sources can be created from the + button at the bottom left of the library:


Shaders media are highly customizable:

  • size: the resolution of the shader.
  • speed: the speed of time for the shader.
  • quality: from hightest to draft, adjust the number of pixel to render to balance between quality of the rendering and performances.
  • read shader button: open a text editor to read and edit the shader code. That allows a more in depth customization of the rendering of the shader.
  • following properties…: custom properties of the shader.

More information about shaders can be found in this tutorial : Create Images and Effects with Shaders

Auto-go

The auto-go is a media that allows to launch a specific column after an amount of time. It can be find in program group of the library:


The property of the auto-go can be find in the properties-view:

  • wait: the amount of time to wait before launching the specific column.
  • after transition: if should wait the end of the current transition before launching the countdown.
  • action: choose between:
  • Launch Next Column: launch the next column.
  • Launch Previous Column: launch the previous column.
  • Launch Specific Column: launch the column specified by the index property.
  • index: if action is Launch Specific Column, specify index of the column to be launched.

Browser

A simple browser to play web content in Millumin:


It can find in the generic group of the library:


Here are its properties :

  • render size: the resolution of the browser.
  • URL: the address of the website to load.
  • Back button: ask to load the previous url.
  • Forward button: ask to load the next url, if a Back button have been pushed.
  • Reload button: ask to reload the current url.
  • transparent: render opacity if alpha pixel.
  • audio-volume: the intensity of the audio played by the browser.

Screen Capture

The screen capture media allows to capture a window from another application to display them in Millumin. It can also capture a whole display.


It can be found in the generic group of the library:


Here are its properties :

  • mode: the method of capture. Depending of it, the next properties change:
  • Window with keywords:
  • on screen only: only display the windows of the current desktop.
  • keyword for application: find the application by its name.
  • keyword for window’s title: if the application have many windows, select the window by its name.
  • Window from list:
  • on screen only: only display the windows of the current desktop.
  • window: select a window among all the windows running on the computer.
  • Whole screen:
  • display: select the display to render.
  • hide millumin: hide millumin from the rendering display.
  • framerate: the number of frame per second for the rendering of the capture.
  • show cursor: show the cursor in the capture.

Slideshow

The slideshow is a media that iterate through all the picture of one of the computer’s folders.


It can be found in the generic group of the library:


Here are its properties :

  • path: the path of the folder of the slideshow. can be edited with the Change... button.
  • sort by: how to sort the file of the slideshow:
  • Filename (ascending): by the alphabetical order of the file’s name (A to Z).
  • Filename (descending): by the alphabetical reverse order of the file’s name (Z to A).
  • Date (ascending): by the date of creation of the file, from the oldest to the newest.
  • Date (descending): by the date of creation of the file, from the newest to the oldest.
  • manual: define if the iteration should be manually triggered.
  • if true: the user choose which file and when it should be played.
  • index: the index of the current file.
  • Previous button: launch the previous file.
  • Next: launch the next file.
  • if false: the media will automatically launch the file in the specified order.
  • interval: the interval of time in second before launching the next file.
  • fade: the duration of the fade between two file in second.
  • always restart from the beginning: if should restart, after iterate through all media, or stop.

Text

The text media allows to display text in the canvas :


The text media can be dragged and dropped from a .txt file or be found in the generic group of the library :


Here are its properties :

  • Text view: where to edit the content of the text media.
  • use whole text: display all the text at once or just some lines. If false, those properties can be edited:
  • first line: the first line of the text to be displayed.
  • number of line: the number of line to displayed.
  • Previous button: display the previous lines.
  • Next button: display the next lines.
  • font: choose the text font.
  • font size: choose the font size.
  • typefaces: choose if the text should be bold, italic, underlined, or normal.
  • alignment: choose if the text should be aligned to the left, to the right or centered.
  • color: choose text color.
  • offset: translate the text in pixels.
  • line spacing: the space between two lines.
  • force size: force the media size in pixels.

PDF

PDF can be dragged to Millumin to play them in your canvas :


Here are its properties :

  • page index: the index of the current PDF page.
  • Previous button: go to the previous page.
  • Next button: go to the next page.
  • quality: quality of the PDF rendering.
  • background: if the PDF has transparency, if the PDF should have its own background or not.
  • always restart from the beginning: if the PDF should always restart at the first page when the column is launched or stay at the current page.

Script

Scripts are short program that allows to automate task on the computer. Millumin can handle them as media and execute them from the dashboard.

Script source can be create from the + button at the bottom left of the library:


More information about scripts here:

Scripts