User Manual
Introduction
LumaMap is a projection mapping application for Windows and Mac. It is designed to make the process of video mapping quick and easy.
It offers powerful AI tools that let users create unique visuals based on a reference image and art tools to add even more creativity to their AI designs.
System Requirements
Windows OS: Windows 10 or later.
MacOS: Monterey (version 12) and Ventura (version 13). Not recommended with Sonoma (version 14).
You need an internet connection to use the AI features of the software.
Windows users are advised to install the K-Lite Codec Pack from this website.
Shortcuts
Type | Effect | Shortcut |
|---|---|---|
Navigation | Zoom In | = |
Zoom Out | – | |
Saving | Save | Ctrl/Cmd + S |
Save As | Ctrl/Cmd + Shift + S | |
Open | Ctrl/Cmd + O | |
Display | Send To Display | D (toggle) |
Disable Send To Display | Esc | |
Mapping | Outline | O (toggle) |
Whiteout | W (toggle) | |
Art Tools | Colorizer | C (toggle) |
Paint | P (toggle) | |
Erase | E (toggle) | |
Reset Canvas | Ctrl/Cmd + E | |
Disable Active Art Tool | Q |
Interface
Canvas
Upon opening the software, you will see a checkerboard. This is known as the canvas.
The canvas is automatically sized to the resolution of the currently selected display.
The detected Output Resolution is displayed beneath the canvas.
Zooming
Zooming in will make the canvas larger in the interface. Zooming out will make the canvas smaller in the interface.
You can zoom in from the menu: View>Zoom In/Zoom Out.
Or you can use the icons in the bottom right of the interface.
You can also use the shortcuts “=” (zoom in) and “-” (zoom out)
Additionally, you can hold Alt whilst using your mouse scroll wheel to zoom in and out.
Widget Controls
You can close a widget using the 
icon.
The widget can be collapsed or expanded using the 
arrow to help you manage your space in the interface.
The widget can be repositioned in the interface by clicking and dragging on the 
grab handle at the corner.
Deactivating the AI tools using the 
icon in the toolbar will automatically close the AI Generator or Art Tools widgets.
Deactivating Export Video using the 
icon in the toolbar will automatically close the Export Video widget.
Media
Import an Image or Video
Import an image or video into the application using File>Import from the menu or the 
icon on the toolbar.
Media will be scaled automatically to ensure it covers the canvas. Any parts of the media that overhang the canvas are partially grayed out.
Supported Media Formats
Images:
*.png *.jpg *.jpeg *.heic
Videos:
*.mp4 *.mov
Replace Media
You can replace whatever media is currently in your canvas with a new media file using the Replace feature.
This can be done using File>Replace from the menu or the 
icon on the toolbar.
Note: Corner pinning transformations will remain in place and be applied to the new media.
Video Player
Control playback of your video using the player controls at the bottom of the canvas. Play and pause the video and enable/disable looping.
You can also jump to times in the video by clicking on the playback bar.
Projects
Saving Your Project
You can save your project using File>Save from the menu. You can also use the shortcut Ctrl/Cmd + S.
To save an existing project with a new filename, choose File>Save As from the menu. You can also use the shortcut Ctrl/Cmd + Shift + S.
Open An Existing Project
Open an existing project with .luma file extension using File>Open from the menu. You can also use the shortcut Ctrl/Cmd + O.
Display
Set Up
LumaMap is intended to be used with a secondary, external display. This secondary display should be set up to be in external or extended mode.
If you are using Windows, read instructions on how to set up your secondary display in extended mode here.
If you are using a Mac, read instructions on how to set up your secondary display in extended mode here.
Choose Display
Choose which display you want the application to use from the menu by navigating to Output>Choose Display and selecting your chosen display from the list.
The resolution of each connected display is shown beside each display to help you identify which display is which.
The currently selected display will be marked with a tick in the list of connected displays.
Send to Display
To output your canvas to your selected display, choose Output>Send to Display from the menu.
Or use the 
icon on the toolbar.
Additionally you can use the shortcut toggle “D”.
You can disable Send to Display either by using the shortcut “D” again or “Esc”.
Mapping Tools
Corner Pinning
You can transform the media in your canvas using the handles at the four corners of your media.
Click and drag the corner handles to move them.
Outline Mode
Outline mode applies a filter to your image that makes the image mainly black with edge outlines highlighted in white.
This mode is useful when you are trying to match a projected reference image onto a physical object.
Enter Outline mode by choosing Output>Outline from the menu.
You can also enable/disable Outline mode using the toggle above the canvas in the interface.
Additionally you can use the shortcut toggle “O” to enable/disable Outline mode.
Whiteout
Whiteout outputs white pixels from your selected display (assuming Send to Display is enabled).
This mode is useful when you are checking the coverage of your projection. It is also useful for illuminating your projection surface when taking a reference photo.
Enable Whiteout by choosing Output>Whiteout from the menu.
You can also enable/disable Whiteout using the toggle above the canvas in the interface.
Additionally you can use the shortcut toggle “W” to enable/disable Whiteout.
Credits
Actions involving AI cost credits in the application. It costs credits to generate an image and to upscale an image.
The number of credits you have remaining is displayed beside the Generate button.
The credit cost of an action is displayed in a small tag on the Generate and Upscale to Canvas buttons.
The software is bundled with 1000 credits which you are free to use at your own pace. There is no daily use cap and they don’t expire.
Example credit spend:
Total Credits | AI Generation Credit Cost | Total AI Generations |
|---|---|---|
1000 | 0.2 | 5000 |
Add More Credits
If you use up the 1000 credits bundled with the app, you will need to purchase more credits with your own DreamStudio account and enter your unique API key within AI>Add Your API key.
Read instructions on how to add your own API key here.
AI Generator
Note: the AI Generator is only available with the full version of LumaMap, not LumaMap Lite.
The AI Generator widget allows you to perform an img2img (“image-to-image”) AI generation using whatever is in your canvas as an input.
You can launch the AI Generator widget by clicking the icon on the toolbar.
An internet connection is required to perform AI image generations with LumaMap.
Read more about how to get the best img2img AI generation results with LumaMap.
Prompt
Enter a text prompt describing what you would like to be depicted in your generated AI image. Try to be descriptive and capture the subject, mood and style of what you would like to see.
An example prompt would be:
“Gothic cathedral in a stormy night, with lightning illuminating the sky and rain pouring down, dramatic, atmospheric, high detail, moody”
You can read more about how to write a good quality prompt in the relevant section of that article.
Model
The name of the diffusion model being used by the generator is displayed as a text label.
Art Style
You can select the art style you want for your AI generation from the dropdown list.
Art style doesn’t impact the credit cost of an AI generation.
Prompt Strength
The Prompt Strength ranges from 0-35 and is controlled with a slider.
The Prompt Strength decides how strictly the AI generator will obey the text prompt.
Lower numbers give the generator more freedom to be creative. Higher numbers force it to follow more closely to the prompt.
Note: Prompt Strength values at the extreme ends of the slider may produce unappealing results.
Prompt Strength doesn’t impact the credit cost of an AI generation.
Image Strength
The Prompt Strength ranges from 0-35 and is controlled with a slider.
The Image Strength decides how much the AI generated image will resemble your canvas.
Lower numbers give the generator more freedom to be creative. Higher numbers force it to stick more closely to the canvas image.
When set to 100%, the generator will reproduce exactly what is in the canvas.
When set to 0, the generated image will bear no resemblance to your canvas.
Image Strength doesn’t impact the credit cost of an AI generation.
Seed
The Seed is a number that decides the initial random noise that contributes to the AI generation. The same text prompt when combined with different Seed values will produce different results.
If you like the general look of an image but want to make some small tweaks, keep the Seed value the same and adjust the text prompt.
A default Seed value of 0 will be used if no Seed value is specified.
Generate
The credit cost of an AI generation is shown in a small tag on the Generate button.
Clicking the Generate button will initiate the AI image generation process. The button will become gray and say “Generating…” while an AI generation is taking place.
Generation times will vary depending on factors like internet speed.
Preview
When you have clicked Generate and waited a short time, a preview of your AI generated image will appear in the Preview pane.
Storage Slots
Your four recent AI generations are temporarily stored in the four slots beside the preview pane. Your most recent AI generation is stored in the top slot.
Clicking a filled slot recalls that AI generation to the preview pane. Recalling an earlier generation does not have a credit cost.
Upscale to Canvas
The preview pane displays a low-resolution image. You can choose to upscale it to the resolution of your selected display and load it to your canvas.
Upscaling has a credit cost because AI is utilized to scale the image. The credit cost of the upscale is shown in a small tag on the Upscale to Canvas button.
If you no longer wish to view your AI generated image on the canvas, click Unload to remove it and reveal your original media with any corner pinning or creative art editing applied.
Art Tools
Note: Art Tools are only available with the full version of LumaMap, not LumaMap Lite.
You can launch the Art Tools widget by clicking the icon on the toolbar.
Colorizer
The colorizer allows you to replace the colors in your canvas with new colors.
Any colorizing applied to the canvas is also input into the AI generator.
New colors are specified as a gradient. Colors on the left of the gradient replace the darkest colors in your original image. Colors in the middle of the gradient replace the midtones of your original image. Colors on the right of the gradient replace the lightest colors in your canvas.
Enable the Colorizer by clicking the Colorizer icon 
or by interacting with any of the Colorizer controls. Disable it by clicking the icon again.
Colorizer can also be enabled/disabled using the shortcut toggle “C”.
You can choose from a selection of preset colorizer gradients.
You can edit the gradient by clicking and dragging the position of the knots in the gradient. This affects which range of colors in the original image is replaced by that color.
You can also double click a knot to bring up a color wheel where you can select an entirely new color.
Paint
The Paint tool allows you to paint colored pixels on your canvas using your cursor.
Any painting applied to the canvas is included in the image input to the AI generator.
Enable Paint by clicking the 
icon or by interacting with any of the Paint controls. Disable it by clicking the icon again.
Paint can also be enabled/disabled using the shortcut toggle “P”.
You can change the color of the Paint tool by double clicking the square color swatch.
Five of your recently used colors are saved in storage slots to be quickly used again by clicking on a slot. Your most recently used color is stored in the left-most slot.
The Paint tool has two parameters: Size and Opacity.
Size affects the diameter of the paint brush. You can use the slider to adjust the Size. The slider ranges from 1-500.
Opacity affects the transparency of the paint brush. You can use the slider to adjust the Opacity. The slider ranges from 0-100%.
Note: the paint tool is affected by any corner pin transformations applied to your canvas. This can lead to unexpected results if extreme transformations are in effect.
Erase
The Erase tool allows you to remove painted pixels from your canvas using your cursor.
Enable Erase by clicking the 
icon or by interacting with any of the Erase controls. Disable it by clicking the icon again.
Erase can also be enabled/disabled using the shortcut toggle “E”.
The Erase tool has two parameters: Size and Opacity.
Size affects the diameter of the eraser. You can use the slider to adjust the Size. The slider ranges from 1-500.
Opacity affects the transparency of the eraser. You can use the slider to adjust the Opacity. The slider ranges from 0-100%.
Note: the Erase tool is affected by any corner pin transformations applied to your canvas. This can lead to unexpected results if extreme transformations are in effect.
Reset Canvas
If you want to remove all painted pixels from your canvas you can use the Reset Canvas button.
You can also reset the canvas using the shortcut Cmd/Ctrl + E.
Exporting
You can export what is in your canvas. This includes any corner pinning you have applied, colorizing or painting done with the Art Tools or AI generations you have loaded to the canvas.
Your export will be the same resolution as your selected display, shown as the Output Resolution below the canvas.
Export Image
You can export your canvas as an image by choosing File>Export Image from the menu or clicking the 
icon on the toolbar.
You can set a destination and file name for your export and choose from either .png or .jpg formats.
You can also export a still image from a video in your canvas.
Export Video
You can export a video in your canvas by choosing File>Export Video from the menu or clicking the icon on the toolbar.
You can set a destination and file name for your export using the 
icon.
Use the checkbox to enable/disable audio in your export.
Once you click Export, a progress bar displays how much of the export process has been completed.
Note: You cannot use Export Video when an image is in your canvas.
Note: You cannot use Export Video when there is painting on the canvas.
