MadMapper for Mac: The Complete Guide to Professional Projection Mapping Software

MadMapper is a highly acclaimed professional real-time video projection mapping and lighting control software for the Mac platform. It is renowned for its intuitive interface, powerful geometric distortion capabilities, and seamless integration with a variety of media servers and hardware, making it a core tool for visual artists, stage designers, and live event producers. This article will provide an in-depth analysis of its interface, workflow, and core operating techniques.

I. Detailed Explanation of the Core Interface and Workspace

The main interface of MadMapper is designed to be compact and efficient, primarily divided into the following core areas:

• Top Menu Bar and Toolbar: Contains global functions such as file operations, editing, view, and mapping. The toolbar provides buttons for quickly creating surfaces, adding media, switching view modes, and more.
• Left “Media Library” Panel: Used to manage all imported media files (images, videos, Syphon inputs, etc.) and DMX devices. You can preview, rename, and organize media assets here.
• Central “3D Preview View”: The core workspace of the software, displaying projection canvases, created mapping surfaces, and applied media content in a 3D spatial format. You can directly move, rotate, scale, and edit the vertices of surfaces here.
• Right “Property Inspector” Panel: This is a dynamic area whose content changes based on the currently selected object (surface, media, layer, etc.). You can adjust geometric transformations, blend modes, color correction, effect parameters, and output settings here.
• Bottom “Output Window” and “Layer Timeline”: The “Output Window” displays the final rendered output, i.e., the signal actually sent to the projector. The “Layer Timeline” is used to control media playback, sequence animations, and the blending and transitions between multiple layers.

II. Complete Workflow: From Creation to Export

The following is the standard workflow for completing a projection mapping project from scratch.

1. Create and Set Up a Project

Step 1: Create a New Project After launching the software, create a blank project via the menu bar File → New or the shortcut Cmd + N.

Step 2: Configure Output Click the “Output Settings” icon in the top toolbar (or menu MadMapper → Preferences → Output) to configure one or more virtual screens for your graphics card (for fullscreen projection output). Make sure the output resolution matches your projector.

2. Create Mapping Surfaces

Step 3: Add a Surface Select a surface type in the toolbar (such as Quad, Grid, Cylinder, 3D Model). The most commonly used are “Quad” and “Grid”. Click the corresponding icon in the toolbar, then drag in the central 3D preview viewport to draw.

Step 4: Adjust Surface Geometry Select the surface, and under the “Geometry” tab in the “Inspector” on the right side:

• Use the “Transform” controls to precisely adjust position, size, and rotation.
• For mesh surfaces, increase the number of “Subdivisions” to achieve finer deformation capabilities.
• Enter “Edit Vertices” mode: select a surface and press the E key, or click the “Edit” button on the properties panel. You can then drag the individual control points of the surface to precisely match them to the contours of the physical projection object.

3. Add and Assign Media Content

Step 5: Import Media Drag media files (video/images) to the “Media Library” panel on the left, or use the menu File → Import Media.... For live inputs, click the “+” button below the Media Library to add “Syphon Input” or “Blackmagic Device”.

Step 6: Drag Media onto a Surface Drag a media item from the Media Library directly onto the target surface in the 3D preview view. Release the mouse, and the media content will automatically map onto that surface.

Step 7: Adjust Media Properties Select the surface with the assigned media. In the “Content” or “Texture” tab of the “Inspector” on the right, you can adjust the media’s scale, position, blend mode, and opacity, and apply a rich set of real-time effects (such as color adjustment, blur, slide effects, etc.).

4. Advanced Editing and Mixing

Step 8: Using the Layer Timeline A single surface can stack multiple media layers. In the “Layer Timeline” area at the bottom, click “+” to add a new layer to the currently selected surface. Here you can control each layer’s play/pause, looping, in/out points, and create simple fade-in/fade-out or sequence animations.

Step 9: Multi-Surface Management and Blending In the 3D preview view, you can create multiple surfaces for complex mapping. Using the “Blend” option in the “Inspector” on the right, you can adjust the blend modes between surfaces (such as Add, Multiply), used to handle light blending in overlapping projection areas.

5. Preview and Final Export/Performance

Step 10: Fullscreen Output Preview Click the “Fullscreen” button in the upper right corner of the “Output Window” at the bottom, or use the shortcut Cmd + F, to send the output content to the configured virtual screen (i.e., projector). This is a key step to check the actual mapping effect.

Step 11: Save Project Regularly use Cmd + S to save your .mad project file, which records all surfaces, media, and settings.

Step 12: Performance Mode and Control During a performance, you can use the “Snapshot” feature to save different scene states. Create snapshots by clicking the “+” sign in the toolbar, then switch between snapshots using a MIDI controller, OSC, or keyboard shortcuts (which need to be assigned in preferences) to achieve real-time live changes.

III. Advanced Tips for Common Features

• Auto Calibration: For flat surfaces, you can use the “Auto Calibration” feature in the “Calibration” tab. Use a projector to project a test grid, then capture it with a camera. The software will automatically calculate and create a matching surface, greatly improving calibration efficiency.
• Vertex Snapping: In Edit Vertex mode (press E), hold the Cmd key and drag a vertex to precisely snap it to a vertex or edge of another surface, making it easy to create seamless stitching.
• Multi-Selection and Grouping: Hold the Shift key and click multiple surfaces to select them simultaneously, then right-click and choose “Group” to move, scale, or apply effects to them together.
• Using Masks: In the “Content” properties of a surface, enable the “Mask” option to import a black-and-white image or use another surface as a mask, achieving non-rectangular content display.
• DMX Control Integration: MadMapper has built-in Art-Net and sACN support. You can add DMX devices in the “Media Library” and create control points to map any parameter of a surface (such as color, position, blend value) to DMX channels for unified control from a lighting console.

IV. Common Issues and Solutions

V. Summary of Mac Shortcuts