Not what you're looking for?
Head back to the guide overview on the getting started page.
¶ Setting up the surface
During the initial startup wizard, you picked one or more device providers to use. These device providers have initialised in the background and made any devices they detected available to Artemis.
Missing devices? Check out the troubleshooting guide!
Now it's time to prepare your surface by giving these devices their own position. The surface contains a 2D representation of where all your devices are located in a physical space, like your desk or even entire room.
When you first open the surface editor you'll notice Artemis already made an effort to lay your devices out for you. You can use this as a starting point.
Now all you need to do is move devices around to match up with their real location as closely as possible. This is done by dragging them around like icons on a desktop, you can even select multiple devices at once by dragging a selection.
Artemis uses this information for its spatial awareness, allowing effects to realistically move across multiple devices.
The box around the surface is the maximum size, on a render scale of 100% this is 4096x4096mm our roughly 160 inches.
If you ever need more you can increase it by decreasing the render size.
¶ Advanced usage
To help you match your virtual surface as closely to the real life situation as possible, there are a few extra options you can use.
If you right-click a device a menu will open.
- Clicking Identify will make the device blink white a few times, that way you can tell the difference between similar devices.
- Bring to Front and the other 3 options allow you to put certain devices on top of eachother, like RAM on a mainboard.
- Identify input is used to teach Artemis which keys presses/mouse clicks belong to which device. This is irrelevant if you only have one mouse and keyboard.
- View properties will bring up an options menu where you can precisely control the position in milimeters, change the scale and rotation of a device and apply color calibration.
Click and drag to select multiple devices at once (like in Windows explorer)
Hold shift to move devices on a 1 cm grid to easily align them
Hold ctrl to move devices on top of each other (overlapping LEDs is not recommended)
To move around the surface hold down middle mouse button and drag.
Overlapping LEDs will cause light to bleed from one LED into another.
¶ Color calibration
Some devices, especially across different manufacturers, may have slightly different color toning. Because of this, it is possible to apply color calibration to each induvidual device. That way you can adjust the colors of different devices until they closely match eachother.
In order to do this, right-click a device and select View properties, a dialog showing the device properties will open.
On the right side you can use the sliders to adjust the red, green and blue values of the device. To try your calibration out with different colors, check Show preview and select a color in the color picker.
The changes you make will be shown straight away and clicking Apply will save them.
With the surface set up you are ready to start exploring the rest of Artemis.
A good next stop is the modules page or head over to the guide overview on the getting started page.