Fiche technique

Interface usager

  • Créer des sources média (vidéo ou images).
  • Créer des projections (mappings): un mapping consiste en une façon de projeter une source à l'aide d'une forme (eg. triangle, ellipse, meshes)
  • Créer des sources couleur (pouvant être utilisés comme masques).
  • Éditer des mappings.
  • Éditer des layers (ordre, visibilité, solo, verrouiller).
  • Enregistrer/charger le projet (format XML).
  • Support OpenSoundControl (OSC) en entrée.
  • Éditeur de propriétés (opacité, vitesse, volume, etc).

Codecs et formats supportés


  • OGG
  • Quicktime (MOV)
  • AVI
  • Matroska (MKV)
  • etc.

Codecs recommendés

  • Apple ProRes
  • Motion-JPEG
  • OGG Theora
  • MPEG4
  • H.264


  • GIF (supporte les GIFs animés)
  • PNG (supporte la transparence)
  • SVG
  • JPEG

Systèmes d'opération supportés

  • Apple OS X 10.9.2 et plus récent.
  • Ubuntu GNU/Linux 12.04 et plus récent.
  • Fedora GNU/Linux 19 et plus récent.
  • Windows 7 et plus récent.

Configuration matérielle recommendée

  • Processeur dual-core 1.0 GHz ou plus
  • Au moins 1 Gb de RAM.
  • Carte vidéo avec accélération 3D, support OpenGL 2.0 support et au moins 64 Mb de VRAM.

Using the OSC interface

You can control MapMap via a set of OSC messages. OpenSoundControl allows users to send messages to control audio and video software. These messages are transmitted via UDP/IP. This allows one to control multi-projector shows with little efforts. MapMap listens for incoming OSC messages on the default port 12345.


How to use MapMap to create to do video mapping

Launching the application

On Apple OS X, open the application by either double-clicking on its icon in the Finder, or by clicking on its icon in the Dock. To display more information about the errors that might occur, launch MapMap from the command line. To do so, open the Terminal application, that is located in /Applications/Utilities, type this: /Applications/mapmap.app/Contents/MacOS/MapMap, and hit the Return key.

On Debian or Ubuntu GNU/Linux, find its icon in the application menu and activate it. You can also run it via the command-line by typing "mapmap".

Paints and mappings

A paint is some materials to be drawn. Currently supported paint types are color paint and media paint.

A mapping is a shape in the output window on which to display some paint. Currently supported shapes are: quads and circles. When quads have a dimension of two by two (2x2) vertices, they are actuals quads. When they have more than 2x2 vertices, they are called meshes. A mesh is a grid of vertices that allow more flexible mapping.

The elements of the user interface

The application has a main window and an output window. The main window includes the toolbar, input viewport, the output viewport, the list of paints, the list of mappings and the property inspector.

Make the output window fullscreen before starting to do video mapping on an actual object. This is necessary so that the pixel positions match the actual location of the pixels drawn by the projector. One should also make sure to use the native resolution of the projector, for best results, if any.

Note that there are handles that are drawn on the mappings in the output window, to ease editing. For a show, one will most probably want to disable them. Uncheck the "View > Display canvas controls" menu item to do so.

Create a media paint

Choose File > Import media source file... or click on the button in the toolbar. Choose a media file using the dialog.

A simple sample clip can be found here: http://download.blender.org/durian/trailer/

Create a mapping

First, select the desired paint for the mapping in the paint list. To create a quad, click on the "Choose Quad/Mesh" button in the toolbar. Move around the vertices of the quad by click and dragging near them. The closest vertex should be dragged. You can also use the number boxes in the property inspector to move the vertices.

To make a mesh from a quad, change its dimension using its width and height mumber boxes.

Creating a triangle is very similar to creating a quad. Move around its vertices with the mouse.

To create a circle do the same as for a quad or a triangle. Changing its size, orientation and position is a bit tricky, though. Play around by drag and dragging the vertices of the blue shape that is in the input and output viewports.

Create a color paint

Color paints can be used as black masks and must be created the same way as a media paint, but it's a color dialog instead.

Destroy a mapping

Mapping can be destroyed simply by selecting it in the mapping list, and then choosing the "Edit > Delete" menu item.

Destroy a paint

Paints can be destroyed simply by selecting it in the paint list, and then choosing the "Edit > Delete" menu item. Since all the mappings that use that paint will also be delete, a dialog will ask you for confirmation.

Save the project to a file

To save the current project, choose "File > Save as..." and then choose a file name. The extension file is ".mmp", but the file format is simply XML, a very common one.

Load a project from a file

To load a project from a file, choose "File > Open...".

Switch Language


Site Web: sourcelibre.net.