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.
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.
Contents Contents Contents Welcome Introduction Platforms Help Overview Help Help Support Overview User Interface Main toolbar Page Browser Page Preview Property Editor Keyboard shortcuts Notes for Macintosh users Project Files Creating a new project Opening a project Saving a project Creating Pages Page Operations Duplicate Pages Changing Page Order Removing Pages from Project Page Preview Zoom Controls Page Navigation Configuring Page Navigation Page Switchers Navigation Buttons Property Editor Using the
Unison Mosaic Touch Editor User Manual Theme Security IR Settings Frequently asked questions Is the free software a cut-down demo version? Does the Touch Editor software support the Apple Macintosh? What are the PC minimum requirements for Touch Editor? What are the minimum Macintosh requirements for Touch Editor? Are project files compatible across versions and platforms? Can I have multiple versions of Touch Editor on my computer? What are the Unison Mosaic Touch Editor file extensions? Troubleshooting I
Welcome Welcome Introduction Welcome and thank you for using version v1.0 of the Unison Mosaic Touch Editor software. This is the first public 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.
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.
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.
Unison Mosaic Touch Editor User Manual Keyboard shortcuts For ease and speed of use various keyboard keys map to application commands: F1 Ctrl + N Ctrl + O Ctrl + S Ctrl + Z Ctrl + Shift + Z OR Ctrl + Y Launch the online help. New project. Open project. Save project. Undo the last operation. 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.
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.
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.
Project Files 4) Set the page background, using either a colour, gradient or image. Some gradients are included with the application, 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.
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.
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.
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 will go to the new file. . You will be prompted to choose a new location to save to. Subsequent saves 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).
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.
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.
Creating Pages 4) 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.
Unison Mosaic Touch Editor User Manual - 18 -
Page Operations Page Operations Duplicate Pages Click on the toolbar to duplicate the current selected page. The page is added to the end of the page browser's list and its properties, such as Name and Icon, can be adjusted using the Property Editor. Changing Page Order Click the or icons to move the selected page above or below adjacent pages in the page browser. Buttons assigned to change to the Next and Previous page will use this ordering (see page navigation buttons).
Unison Mosaic Touch Editor User Manual Page Navigation Configuring Page Navigation There are two methods for managing navigation between pages for projects that contain multiple pages: l l Page Switchers Navigation Buttons These can be created from the Navigation step of the new page wizard. Page Switchers The position of a page switcher on the screen can be set along with its alignment.
Page Navigation Navigation Buttons Navigation buttons can be positioned at the top or bottom of a page. Alignment options are Start, End, Center or Spread.
Unison Mosaic Touch Editor User Manual - 22 -
Property Editor Property Editor Using the Property Editor The Property Editor displays controls associated with a selected page or item. Click the icon, where it appears, provides access to further options to customise the property or import from a file browser. Clicking the icon resets a property to its default value. Page Properties The page name (as appears in the page browser and on page switchers) can be edited and a page may be set as the default on TPC startup.
Unison Mosaic Touch Editor User Manual Button Properties After selecting a button in the page preview window, you may adjust the following properties: Caption - the text that appears on a button, defining its purpose. The caption of a control can be changed via the Set TPC Control Caption trigger action in Designer - see the Designer help for more information about TPC actions. Key - the reference for the control within triggers in Unison Mosaic Designer.
Property Editor Slider Properties Control properties for sliders are identical to the control properties for buttons. Properties specific to sliders are: Show Value - whether the value of the slider is displayed next to it. Unit - this sets whether the value should be displayed as a percentage or 8-bit value (0-255). Caption Font Size - set by default from the theme; size of the font used to display the slider caption.
Unison Mosaic Touch Editor User Manual Colour Picker Properties Control properties for colour pickers are identical to the control properties for buttons. Properties specific to colour pickers are: Font Size - set by default from the theme; size of the font used to display the colour picker caption. Text Spacing - set by default from the theme; spacing between the colour picker wheel and the caption text. Label Properties Control properties for labels are identical to the control properties for buttons.
Property Editor Keypad Properties Control properties for keypads are identical to the control properties for buttons. Codes entered into keypads can be processed by triggers in Designer - see the Designer help for more information about TPC triggers. You may set the Max Digits that may be entered into a keypad by the user at a time.
Unison Mosaic Touch Editor User Manual Uploading to a Controller Interaction with Unison Mosaic Designer To upload a .mtc project onto a TPC, save the configuration in Touch Editor, start Unison Mosaic Designer and navigate to the Network view. Select the appropriate TPC in the Network view and go to the Controller Properties tab on the right of the screen. In the Screen section, set the .mtc file as the Touch Editor project. Once a .
Theme Editor Theme Editor The theme editor facilitates the creation and editing of custom TPC themes. It allows you to add and edit background images, icons and item states. Click on the toolbar to launch the theme editor. Theme editor browser When the theme editor launches, it displays all available themes. This will include themes that come with the Touch Editor installer, as well as any themes you have created. Click to create a new theme. Use to delete a theme (user themes only).
Unison Mosaic Touch Editor User Manual Creating a new theme To create a new theme, click theme to use as a template. . Enter a name for the theme and choose where to store it. Select an existing Editing a theme The theme editor has three tabs for editing different aspects of a theme.
Theme Editor Editing item states Default Item Properties - these set default values for certain properties that will be applied to an item when it's created for the first time. These properties can usually be edited in the main property editor of Touch Editor. Item States - Select a state to edit its properties. The default state is shown with "(Default)" after its name. Double-click a state (Windows) or press the Enter key (OS X) to rename the selected state. Click to add a new state.
Unison Mosaic Touch Editor User Manual Editing background images Click to add a new background image from a file. Click theme. The image files will not be deleted. to remove the currently selected images from the You can set the orientation of images so that they are only offered as backgrounds for projects of the same orientation. If the image isn't specific to an orientation, for example if it's meant for tiling or centering on the screen, then set its orientation to 'Any'.
Theme Editor Editing icons Click to add a new icon from a file. Click files will not be deleted. to remove the currently selected icons from the theme. The image Saving changes to a theme Click Done when you've finished editing the theme and your changes will be saved to the theme file. If you're creating a new theme, the theme will now be shown in the theme browser and offered when you create a new project.
Unison Mosaic Touch Editor User Manual Project Properties Click on the toolbar to open the Project Properties dialog. Changes made in this dialog affect the current project file. Theme Select a different theme to apply to all the pages in the current project. Security Enable a lock screen for the project. With this setting enabled, it is possible to lock a TPC by setting up a Lock TPC trigger action in Unison Mosaic Designer. The TPC will show a keypad when locked.
Project Properties IR Settings The IR Settings tab provides a convenient overview of how IR Slots have been assigned to controls across the pages in the current project. Individual slot assignments may be cleared by clicking , allowing them to be assigned to different controls. All slot assignments may be cleared together by clicking Clear All.
Unison Mosaic Touch Editor User Manual - 36 -
Frequently asked questions Frequently asked questions Is the free software a cut-down demo version? No. The free Touch Editor software is the full software package. Downloads and updates can be found on our website. Does the Touch Editor software support the Apple Macintosh? Yes, from v1.0 we have full support for Intel Macs running Apple OS X 10.5 and later. Project files will be compatible, regardless of the operating system on which they are created.
Unison Mosaic Touch Editor User Manual Troubleshooting The following section lists common problems and their solutions. I have checked the FAQ and troubleshooting but I'm still stuck? Contact support, please be prepared to send in your project files.
Built-In Themes Built-In Themes Unison Mosaic Touch Editor comes with some built-in themes that you may use directly in your projects, or edit with the Theme Editor as required. Knowledge of the states in a theme for each item (e.g. buttons, sliders, etc.) is useful when using the Set TPC Control State action in Designer. Changing the state of an item will change its appearance, and this allows you to provide feedback in your interface.
Unison Mosaic Touch Editor User Manual Aurora Theme The Aurora theme is included with Touch Editor. It has the following states for items: Button States The following states are shown in the image above: l l l l l l l Silver (default) Red Green Cyan Magenta Yellow Orange The following states use the same colours as the above, but they cause the opacity of the button to vary over a period of 1 second to attract attention.
Aurora Theme The following states are shown in the image above: l l l l l l l Silver Dim Red Dim Green Dim Cyan Dim Magenta Dim Yellow Dim Orange Dim The following states are shown in the image above: l l l l l Silver Highlight Red Highlight Green Highlight Cyan Highlight Magenta Highlight - 41 -
Unison Mosaic Touch Editor User Manual l l Yellow Highlight Orange Highlight Slider States The following states are shown in the image above: l l l l l l l Silver (default) Red Green Cyan Magenta Yellow Orange The following states are shown in the image above: l l Silver Highlight Red Highlight - 42 -
Aurora Theme l l l l l Green Highlight Cyan Highlight Magenta Highlight Yellow Highlight Orange Highlight Label States The Normal state (default) is shown in the image above. The Warning Text state is shown in the image above.
Unison Mosaic Touch Editor User Manual The Warning Background state is shown in the image above.
City Theme City Theme The City theme is included with Touch Editor. It has the following states for items: Button States The following states are shown in the image above: l l l l l l l l l Sky Blue (default) Lilac Tint Pale Lavender Light Red Light Pink Soft Amber Sea Green Pale Green Silver The following states use the same colours as the above, but they cause the opacity of the button to vary over a period of 1 second to attract attention.
Unison Mosaic Touch Editor User Manual The following states are shown in the image above: l l l l l l l l l Sky Blue Dim Lilac Tint Dim Pale Lavender Dim Light Red Dim Light Pink Dim Soft Amber Dim Sea Green Dim Pale Green Dim Silver Dim Slider States The following states are shown in the image above: l l Sky Blue (default) Lilac Tint - 46 -
City Theme l l l l l l l Pale Lavender Light Red Light Pink Soft Amber Sea Green Pale Green Silver Label States The Default state is shown in the image above. The Warning Text state is shown in the image above.
Unison Mosaic Touch Editor User Manual The Warning Background state is shown in the image above.
Lite Theme Lite Theme The Lite theme is included with Touch Editor.
Unison Mosaic Touch Editor User Manual l l Red Dim Blue Dim Slider States The following states are shown in the image above: l l l l Sand (default) Olive Green Red Blue Label States The Default state is shown in the image above.
Layout File Format Layout File Format All the layouts included with Touch Editor are generated from xml files stored in the installation directory: l l On Windows, browse to the installation directory and navigate to \library\layout. On OS X, right click (or Ctrl-click) on the Touch Editor application and select Show Contents. Navigate to \library\layout. The xml schema for Touch Editor layouts is included in this directory - open the file "layout.xsd". If you have any questions, please contact support.