ETC Unison Mosaic TouchEditor User Manual

Unison Mosaic Touch Editor

User Manual

v1.0

Copyright © 2010-2011 Electronic Theatre Controls, Inc..

All rights reserved.

Production information and specifications subject to change.

Part Number: 7180M1243-1.0 Rev A.

Released 2011-09.

v1.0 16-08-2011 Custom

Unison Mosaic Touch EditorUser Manual

ETC permits the reproduction of materials in this manual only for non-commercial purposes. All other rights are
reserved by ETC.

- 2 -

Contents

Contents

Contents 3
Welcome 5

Introduction 5
Platforms 5
Help Overview 5
Help Help 5
Support 5

Overview 6
User Interface 7

Main toolbar 7
Page Browser 7
Page Preview 7
Property Editor 7

Keyboard shortcuts 8

Notes for Macintosh users 8

Project Files 9

Creating a new project 9
Opening a project 14
Saving a project 14

Creating Pages 15
Page Operations 19

Duplicate Pages 19
Changing Page Order 19
Removing Pages from Project 19
Page Preview Zoom Controls 19

Page Navigation 20

Configuring Page Navigation 20
Page Switchers 20
Navigation Buttons 21

Property Editor 23

Using the Property Editor 23
Page Properties 23
Page Switcher Properties 23
Button Properties 24
Slider Properties 25
Colour Picker Properties 26
Label Properties 26
Keypad Properties 27

Uploading to a Controller 28

Interaction with Unison Mosaic Designer 28

Theme Editor 29

Theme editor browser 29
Creating a new theme 30
Editing a theme 30

Editing item states 31
Editing background images 32
Editing icons 33
Saving changes to a theme 33

Project Properties 34

- 3 -

Unison Mosaic Touch EditorUser Manual

Theme 34
Security 34
IR Settings 35

Frequently asked questions 37

Is the free software a cut-down demo version? 37
Does the Touch Editor software support the Apple Macintosh? 37
What are the PC minimum requirements for Touch Editor? 37
What are the minimum Macintosh requirements for Touch Editor? 37
Are project files compatible across versions and platforms? 37
Can I have multiple versions of Touch Editor on my computer? 37
What are the Unison Mosaic Touch Editor file extensions? 37

Troubleshooting 38

I have checked the FAQ and troubleshooting but I'm still stuck? 38

Built-In Themes 39
Aurora Theme 40

Button States 40
Slider States 42
Label States 43

City Theme 45

Button States 45
Slider States 46
Label States 47

Lite Theme 49

Button States 49
Slider States 50
Label States 50

Layout File Format 51

- 4 -

Welcome

Welcome

Introduction

Welcome and thank you for using version v1.0 of the Unison Mosaic Touch Editor software. This is the first pub­lic release of this software.

Platforms

Unison Mosaic Touch Editor is designed to run on a PC running Microsoft Windows 7, Vista or XP (SP2+) or an
Apple Mac running OS X (10.5.x or later - Intel only).

Help Overview

The Help is split into three major sections: Quick Start, Reference and Troubleshooting.

Those of you experimenting with the software for the first time should work through the Quick Start guide to famil­iarise yourself with the basics of the software. The Reference section then gives detailed descriptions of every
aspect of the software whilst the Troubleshooting section provides help to resolve any problems.

Help Help

This is the PDF version of the online Help and it is available in various formats for printing. The online version,
which has the advantage of being fully searchable, can be opened from within Touch Editor by clicking the help
button on the main toolbar.

Support

As with all successful control products, support is crucial and the team at ETC will do everything possible to
ensure that your project is a success. Please do not hesitate to contact us with your questions, bug reports and
suggestions at:

T: [phone]

E: [e-mail]

Please also visit our website to keep up to date with the latest product news and software releases: www.etcco-

nnect.com.

- 5 -

Unison Mosaic Touch EditorUser Manual

Overview

Unison Mosaic Touch Editor is a tool for designing custom user interfaces for the Unison Mosaic Tessera Panel
Controller (TPC).

The intuitive user interface makes it easy to organise multiple pages of controls, configure their behaviour and
customise their appearance.

Touch Editor comes with layouts of page controls, e.g. buttons, sliders and colour pickers, though experienced
users can create their own layouts using the xml file format. Several themes that govern the appearance of page
controls are included with Touch Editor and the built-in Theme Editor allows users to create their own.

Page navigation options include the page switcher, which has buttons to switch between pages, each showing

the icon and the name of the target page. The page switcher can be placed along any edge of a page. Alter­natively, any button can be configured to change the current page, either moving to a particular page, or moving
forwards or backwards through the page hierarchy.

If security is required for a user interface, Touch Editor allows users to set up a lock screen with a keypad for
passcode entry. Keypad controls can be added to any page via layouts for custom passcode behaviour.

Touch Editor project files (.mtc) are associated with TPCs in Pharos Designer, where triggers and actions for the
user interface controls are created. Designer combines show programming with the user interface, ready for

upload to the TPC.

- 6 -

User Interface

User Interface

The software has been designed to present a consistent graphical user interface and so it is worth familiarising
yourself with the layout of the main window before proceeding further:

Main toolbar

The buttons on the left of the main toolbar provide overall control of your Touch Editor project. Create new

projects, open existing projects and save your work using the file management buttons. Use the Undo/Redo but-

tons to step backwards and forwards through operations that affect your project. Pages can be added, copied,

moved up and down in the page browser and deleted. The zoom buttons give you control of the Page Preview.

The final buttons on the toolbar provide access to the Theme Editor, Project Properties, Preferences, Help and
information About the software.

Page Browser

The Page Browser, located at the left of the screen, displays all pages that exist within the project. Selecting a
page will display it in the Page Preview screen and allow page properties to be adjusted in the Property Editor.

Page Preview

The Page Preview area is located in the centre of the window. Any selected page will be displayed in the Page
Preview window. Selecting the page or items on the page allows individual properties to be adjusted in the Prop­erty Editor.

Property Editor

The Property Editor displays adjustable properties for any page items that are selected in the Page Preview win­dow. The page, page switchers, buttons, sliders, colour pickers and keypads all have user-configurable prop­erties.

- 7 -

Unison Mosaic Touch EditorUser Manual

Keyboard shortcuts

For ease and speed of use various keyboard keys map to application commands:

F1 Launch the online help.
Ctrl + N New project.
Ctrl + O Open project.
Ctrl + S Save project.
Ctrl + Z Undo the last operation.
Ctrl + Shift + Z OR Ctrl + Y Redo the last operation to be undone.

Notes for Macintosh users

Unison Mosaic Touch Editor makes a good deal of use of the two button mouse with right-click being used to
invoke context-sensitive menus. As the majority of Mac users have only a single button mouse they must hold
Ctrl while clicking to get this functionality. Tapping two fingers on a Mac touch pad is an alternative method,
though this may be switched off in System Preferences. Furthermore Macs have an Command key that serves
as the alternative to the Windows Ctrl key. Shift and Alt work as described for Windows.

- 8 -

Project Files

Project Files

Unison Mosaic Touch Editor projects are saved with the file extension ".mtc". Project files also contain all the
images and icons used in the project.

Creating a new project

Click or press Ctrl+N. You will be taken through a new project wizard that sets up a first page of the project.
The steps are as follows:

1) Name the project, set the project destination, decide upon the orientation of the project.

NOTE: the orientation cannot be changed once the project has been created.

2) Select a project theme. The built-in themes are documented in an appendix.

- 9 -

Unison Mosaic Touch EditorUser Manual

3) Name the first page of the project and add an icon, if appropriate. Page icons are used on page switchers. The
icons offered will be from the chosen theme, but you may click the Browse button to choose your own.

- 10 -

Project Files

4) Set the page background, using either a colour, gradient or image. Some gradients are included with the appli­cation, but a gradient editor is provided for you to create your own. The images offered will be from the chosen
theme, but you may click the Browse button to choose your own.

- 11 -

Unison Mosaic Touch EditorUser Manual

5) Select a page layout.

NOTE: the layout of a page cannot be changed once the page has been created.

- 12 -

Project Files

6) Select a navigation type for moving between pages, choosing from a page switcher or navigation buttons.

NOTE: the navigation type cannot be changed once the page has been created, although the properties of a page
switcher or navigation buttons may be adjusted later.

- 13 -

Unison Mosaic Touch EditorUser Manual

Opening a project

Click or press Ctrl+O. You will be prompted to choose an existing .mtc file to load.

Saving a project

Click or press Ctrl+S.

To save to a different file, click . You will be prompted to choose a new location to save to. Subsequent saves
will go to the new file.

To save to a different file discarding any images and icons that are not used on pages in your project, click the

arrow next to the button and select Save As (Minimal).

- 14 -

Creating Pages

Creating Pages

Click to create a new page. You will be taken through a new page wizard which contains the following steps:

1) Name the page and add an icon, if appropriate. Page icons are used on page switchers. The icons offered will
be from the chosen theme, but you may click the Browse button to choose your own.

2) Set the page background, using either a colour, gradient or image. Some gradients are included with the appli­cation, but a gradient editor is provided for you to create your own. The images offered will be from the chosen
theme, but you may click the Browse button to choose your own.

- 15 -

Unison Mosaic Touch EditorUser Manual

3) Select a page layout. Click to reload layout files.

NOTE: the layout of a page cannot be changed once the page has been created.

- 16 -