...

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 checkerboard area is called 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. 

Zoom In and Zoom Out icons in the bottom-right corner 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.

Imported media. Sections of media that overhang the canvas are 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.

Video player controls

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.

Connected displays listed with resolutions alongside

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.

Corner pinning - media transformed using the four corner handles

Outline Mode

Outline mode applies a filter to your image that makes the image mainly black with edge outlines highlighted in white.

Media with Outline mode applied

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.

Credit balance

The credit cost of an action is displayed in a small tag on the Generate and Upscale to Canvas buttons.

Credit cost tags on 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.

Enter 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.

AI Generator

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

Generate button and credit cost tag

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.

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.

Storage slots

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

Upscale to canvas button and credit cost tag

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.

Art tools

You can launch the Art Tools widget by clicking the icon on the toolbar.

Colorizer

Colorizer tool

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.

Colorizer gradient

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.

Color wheel used to select a 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.

Paint tool

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.

Color wheel used to select a new color

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.

Paint tool color slots

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.

Erase tool

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.

Reset canvas

Exporting

Export Image and Export Video on the toolbar

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

Export Video widget

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.

Scroll to Top