How To Use

In this brief tutorial, we will see how to set up a projection mapping system using DynaMapper.

1. Requirements

2. Software

   2.1. Gallery

   2.2. Editor screen & Mapping

      2.2.1. Toolbar

      2.2.2. Adding new objects and mapping

      2.2.3. Material Selection

3. Performance

1. Requirements:

1 – An iPad (iPad 2 or higher using iOS 4.2 or higher)

2 – An iPad to video connector. This one works just fine. (HDMI connectors are also good). There are multiple connectors available on the market (both HDMI, charging connector or USB and composite and charging on a single dongle), you can also use them too.

3 – Any video projector that can be connected to iPad with a connector mentioned above.

After meeting these requirements:
- Connect projector to the iPad using your connector.
- Make sure that you iPad screen is projected on your stage correctly.
- Launch DynaMapper clicking it’s comet icon.

Back To Top.
2. Software:

DynaMapper is the fastest mapping software available for the iPad. It offers tools to map any surface quickly and lets you start performing on them immediately. Having these features, it is also very easy to use. It has two main screens which are:

  1. Gallery screen: Gallery is the place where you can create new scenes or access previously created scenes. Duplicating and deleting a scene is also available.
  2. Editor / Performing screen: In these scenes you can create your mapping envorinment, or make changes on a previous one and start performing.

Let’s take a detailed look for each of the screens.

Back To Top.


2.1 Gallery:
After the splash image, the screen you see is the gallery:


Gallery Screen

Gallery Screen


  • galleryNew Creates new scene.
  • galleryDuplicate Duplicates selected scene.
  • galleryDelete Deletes selected scene. Once clicked, icon turns into: deleteConfirmation. If you click this confirmation button, selected scene will be deleted. To cancel deleting, touch somewhere else on the screen.
  • galleryInfo Opens a fast tutorial of the app.
  • In order to open a previously saved scene, double click on a scene icon.


Back To Top.



2.2 Editor Screen & Mapping:

Touching the galleryNew button from the gallery, or double clicking a previously saved scene will open the editor screen. The screen below is a sample scene from DynaMapper. Let’s take a look at it:

DynaMapper editor screen.

DynaMapper editor screen.

Back To Top.
2.2.1 Toolbar:
Before starting mapping, let’s have a quick look at the toolbar:


DynaMapper Toolbar

DynaMapper Toolbar


  • toolbarStartButton Starts performance mode. You cannot make any change on your scene during performance mode.
  • toolbarNewRectButton Adds a new rectangular object into your scene.
  • toolbarNewBezierButton Adds a new bezier object into your scene.
  • toolbarDuplicateButton Duplicates selected object.
  • toolbarMaterialDialogButton Launches material dialog for the selected object.
  • toolbarLockButton Locks/unlocks selected object. Locked objects cannot be moved or aligned, but it’s materials can changed.
  • toolbarSendBackButton Sends selected object to the back of other objects.
  • toolbarBringFrontButton Brings selected object to the front of other objects.
  • toolbarDeleteButton Deletes selected object. If you click this button once, it turns into: deleteConfirmation. If you click it again, object will be deleted. To cancel deleting the object, touch somewhere else on the screen.
  • toolbarSaveButton Saves your current scene.
  • toolbarBackToGalleryButton Returns to the gallery screen. If you click this, your scene will be automatically saved.
  • toolbarCloseToolbarButton Closes the toolbar.

Back To Top.


2.2.2 Adding new objects and mapping a surface:

In order to start mapping, you have to add mapping objects into your scene by clicking toolbarNewRectButton or toolbarNewBezierButton icons, rectangular and bezier objects respectively.

  • Rectangular objects are regular polygons, you can change their shape by dragging their control points, but they will preserve their polygonal shape. They are suitable for mapping rectangular surfaces like walls, ceilings, rectangular columns etc. You can adjust control points as shown below.
Aligning of A Rectangular Objects using Control Points

Aligning of A Rectangular Objects using Control Points

  • Bezier objects are round shaped objects. Unlike rectangular objects, they have nine control points, you can reshape them as you like. They are suitable for mapping surfaces like spheres, round columns etc.

After mapping the surfaces, next step is to add materials to your objects.


Back To Top.

2.2.3. Material Selection:

In DynaMapper, Material is the visual of the object. It can be a static image or an animating spritesheet, or just plain color. Materials have 3 properties. These are:

  1. Texture: Image of the material. Can be a single frame image, or a spritesheet.
  2. Color: Color of the material.
  3. Animation Properties: If texture of this material is an animationg spritesheet, it needs these properties in order to animate properly. These properties are row and column count of the spritesheet, FPS of the animation.

Clicking the toolbarMaterialDialogButton icon when an object is selected will open it’s material dialog.


Material Dialog

Material Dialog


  • textureButton Opens texture selection menu inside the material editor. Here you can browse through your image gallery using arrows, and assign these textures into your material by clicking their thumbnails.
  • colorButton Opens color picker menu inside the material editor. You can change your materials color using the color picker.
  • animationButton Opens animation settings menu inside the material editor. You can edit your spritesheet animation settings using this menu. Animation settings have 3 parameters. These are:
  1. FPS: Frame per seconds, the playing speed of your animation.
  2. Col: Column count of your spritesheet.
  3. Row: Row count of your spritesheet.  Let’s take this image as example:


A 6x5 spritesheet example.

A 6×5 spritesheet example.

  •  If you use Col:6, Row: 5, FPS: 8; the result will be this animation:
Example spritesheet animated

Example spritesheet animated

  •  Load From Roll: Will open iPad’s camera roll. You can select any image and add it to your texture library.


As can be seen above an object can have two types of materials which are:

  1. Default Material: The material of the object will have when you are NOT touching it. Every object can have only one default material.
  2. Action Material: Tha material of the object will have when you are touching them. Every object can have nine action objects.

While performing, touching the object with one finger will change it’s material from default to the active action material, touching with 2 fingers will change the active action material.


Back To Top.


3. Performance:
As mentioned before, clicking the toolbarStartButton on the toolbar will start performance mode. Performance is easy, all you have to do is to click the object that you want to activate. Tapping with one finger will change clicked objects default material to the active action material. Tapping with two fingers will change the active action material (For example, if your action material is material no.1, double finger tapping will change action material to no.2)


Happy mapping!


Back To Top.