User manual AMX TPDESIGN4 V2.5

instruction manual TPDesign4 Touch Panel Design Program (v2.5 or higher) So ftw are Software License and Warranty Agreement LICENSE GRANT. AMX grants to Licensee the non-exclusive right to use the AMX Software in the manner described in this License. The AMX Software is licensed, not sold. The AMX Software consists of generally available programming and development software, product documentation, sample applications, tools and utilities, and miscellaneous technical information. Please refer to the README.TXT file on the compact disc or download for further information regarding the components of the AMX Software. The AMX Software is subject to restrictions on distribution described in this License Agreement. YOU MAY NOT LICENSE, RENT, OR LEASE THE AMX SOFTWARE. You may not reverse engineer, decompile, or disassemble the AMX Software. INTELLECTUAL PROPERTY. The AMX Software is owned by AMX and is protected by United States copyright laws, patent laws, international treaty provisions, and/or state of Texas trade secret laws. Licensee may make copies of the AMX Software solely for backup or archival purposes. Licensee may not copy the written materials accompanying the AMX Software. TERMINATION. AMX RESERVES THE RIGHT, IN ITS SOLE DISCRETION, TO TERMINATE THIS LICENSE FOR ANY REASON AND UPON WRITTEN NOTICE TO LICENSEE. In the event that AMX terminates this License, then Licensee shall return all copies of the AMX Software to AMX and certify in writing that all copies have been destroyed. PRE-RELEASE CODE. Portions of the AMX Software may, from time to time, as identified in the AMX Software, include PRE-RELEASE CODE and such code may not be at the level of performance, compatibility and functionality of the final code. The PRE-RELEASE CODE may not operate correctly and may be substantially modified prior to final release or certain features may not be generally released. AMX is not obligated to make or support any PRE-RELEASE CODE. ALL PRE-RELEASE CODE IS PROVIDED "AS IS" WITH NO WARRANTIES. LIMITED WARRANTY. AMX warrants that the AMX Software will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days from the date of receipt. AMX DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH REGARD TO THE AMX SOFTWARE. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to you after the expiration of the ninety (90) day Limited Warranty period are not covered by any warranty or condition, express, implied or statutory. LICENSEE REMEDIES. AMX's entire liability and your exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX's Limited Warranty and which is returned to AMX. This Limited Warranty is void if failure of the AMX Software has resulted from accident, abuse, or misapplication. Any replacement AMX Software will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer. Outside the United States, these remedies may not available. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL AMX BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THIS AMX SOFTWARE, EVEN IF AMX HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES/ COUNTRIES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU. U.S. GOVERNMENT RESTRICTED RIGHTS. The AMX Software is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at 48 CFR 52.227-19, as applicable. This Agreement replaces and supercedes all previous AMX Software License Agreements and is governed by the laws of the State of Texas, and all disputes will be resolved in the courts in Collin County, Texas, USA. Should you have any questions concerning this Agreement, or if you desire to contact AMX for any reason, please write: AMX Corporation, 3000 Research Drive, Richardson, TX 75082. Table of Contents Table of Contents TPDesign4 Program Overview ................................................................................1 Supported Operating Systems ................................................................................................ 1 PC Requirements .................................................................................................................... 1 Other PC requirements ........................................................................................................... 1 Touch Panel Pages - Overview......................................................................................... 2 Supported Panel Types............................................................................................................ 2 Video Capabilities for Modero Panels ...................................................................................... 3 Video Capabilities for Enhanced Modero Panels..................................................................... 3 Supported Screen Resolutions ................................................................................................ 3 Supported Image File Types .................................................................................................... 3 True Type Font Support ........................................................................................................... 4 WebUpdate ....................................................................................................................... 4 G4 PanelBuilder ................................................................................................................ 4 G4 PanelPreview............................................................................................................... 5 TPDesign4 Work Area....................................................................................................... 5 Toolbars ............................................................................................................................ 7 Design View Windows ...................................................................................................... 7 Workspace Navigator Window .......................................................................................... 8 Workspace Navigator - Pages Tab .......................................................................................... 9 Opening pages/popup pages via the Workspace Navigator .................................................... 9 Renaming Pages via the Workspace Navigator..................................................................... 10 Edit Focus .............................................................................................................................. 10 Drag and Drop Support .......................................................................................................... 10 Workspace Navigator - Function Maps Tab........................................................................... 10 Workspace Navigator Context Menu ..................................................................................... 11 Properties Control Window.............................................................................................. 11 Properties Control Window - General Tab ............................................................................. 13 Properties Control Window - Programming Tab .................................................................... 13 Properties Control Window - States Tab................................................................................ 13 Using the Apply To All option ................................................................................................. 13 Using the Prev and Next buttons ........................................................................................... 14 State Manager Window ................................................................................................... 14 State Manager Context Menu ................................................................................................ 15 State Manager Drag-and-Drop Menu..................................................................................... 15 Transfer Status Window .................................................................................................. 16 Transfer Status Context Menu ............................................................................................... 16 TPDesign4 Touch Panel Design Program i Table of Contents Button Preview Window .................................................................................................. 16 Button Preview Context Menu................................................................................................ 17 Magnifier Window............................................................................................................ 17 Working With Dockable Windows ................................................................................... 17 Moving, Docking and Resizing Dockable Windows ............................................................... 18 Toggling the Windows............................................................................................................ 18 Status Bar ....................................................................................................................... 18 Print Preview Window ..................................................................................................... 19 Workspace Context Menu............................................................................................... 20 TPDesign4 Project Files ........................................................................................ 21 Overview ......................................................................................................................... 21 Drag & Drop .................................................................................................................... 21 Creating a New Project Using G4 PanelBuilder.............................................................. 21 Using The New Project Wizard ....................................................................................... 21 Setting Project Properties ............................................................................................... 23 Project Properties dialog - Project Information tab................................................................. 23 Project Properties dialog - Panel Setup Information tab ........................................................ 24 Project Properties dialog - Sensors tab.................................................................................. 25 Project Properties dialog - IR Emitters and Receivers tab ..................................................... 25 Applying Password Protection to Your Project File......................................................... 26 Setting a Power Up Page................................................................................................ 26 Setting an Inactive Page Flip .......................................................................................... 26 Creating a Screen Saver................................................................................................. 27 Converting TPD3 files to TPD4 ....................................................................................... 27 Using the TPD Conversion Wizard ........................................................................................ 27 Notes on converting TPD3 files to TPD4 ............................................................................... 28 Errors and Warnings Report dialog........................................................................................ 28 Project Migration (from previous versions of TPDesign4)............................................... 29 System-Generated File Names.............................................................................................. 29 Inappropriate File Name Characters ...................................................................................... 30 Edit Focus ....................................................................................................................... 30 Using Quick Input............................................................................................................ 31 Undo/Redo Support ............................................................................................................... 31 Using the Workspace Navigator...................................................................................... 32 Workspace Navigator - Pages tab ......................................................................................... 32 Opening pages/popup pages via the Workspace Navigator .................................................. 33 Renaming Pages via the Workspace Navigator..................................................................... 33 Workspace Navigator - Function Maps tab ............................................................................ 33 Cutting, Copying and Pasting.......................................................................................... 34 ii TPDesign4 Touch Panel Design Program Table of Contents Copying States to the Clipboard ............................................................................................ 34 Pasting States from the Clipboard ......................................................................................... 34 Cutting Objects....................................................................................................................... 35 Replacing States On a Page, Popup Page or Button...................................................... 35 Replacing States From the Clipboard .................................................................................... 35 Replacing States Through Drag-and-Drop............................................................................. 35 Saving the Active Project as a Different Panel Type....................................................... 36 Working With Multiple Projects........................................................................................ 36 Opening Multiple Projects Simultaneously............................................................................. 36 Copying/Pasting Across Projects ........................................................................................... 37 Copying/Pasting Pages, Popup Pages and Buttons Across Projects .................................... 37 Using the Grab and Paint Properties Tools..................................................................... 37 Property Painter dialog........................................................................................................... 38 Working With the System Page Template....................................................................... 39 Copying/Pasting Entire System Pages into a Project ............................................................ 40 Copying/Pasting System Page Elements into a Project page................................................ 40 Working with System Page Keyboards and Keypads ............................................................ 41 System Page Template Reference ........................................................................................ 42 Working With the Resource Manager ...................................................................45 Resource Manager dialog - Images tab .......................................................................... 46 Resource Manager dialog - Dynamic Images tab ........................................................... 46 Resource Manager dialog - Slots tab .............................................................................. 46 Resource Manager dialog - Sounds tab.......................................................................... 47 Editing Image and Sound Files Using External Programs .............................................. 48 To edit image files: ................................................................................................................. 48 To edit sound files: ................................................................................................................. 48 Adding an External Editing Program for Image Files ............................................................. 49 Adding an External Editing Program for Sound Files............................................................. 49 Changing the Default External Image or Sound Editor Program ........................................... 49 Working With Images ...................................................................................................... 50 Supported Image File Types .................................................................................................. 50 Importing Image Files To Your Project................................................................................... 50 Assigning Images to Slot Positions ........................................................................................ 51 Working With Dynamic Images ....................................................................................... 52 Adding Dynamic Image Files To Your Project ....................................................................... 52 Assigning Dynamic Images to Slot Positions ......................................................................... 52 Preserve Dynamic Images (Refresh only at Panel Startup)................................................... 52 Working With Dynamo Video .......................................................................................... 53 Setting Up a DynaMo Video Image........................................................................................ 53 TPDesign4 Touch Panel Design Program iii Table of Contents Motion JPEG Cameras and Servers that provide Motion JPEG streaming output ................ 54 Network Path Information....................................................................................................... 55 Bitmaps vs. Icons ............................................................................................................ 57 Working With Icons ......................................................................................................... 57 Working With Slot Assignments ...................................................................................... 58 Assigning Image and Sound Files to Slot Positions............................................................... 58 State Draw Order (Z-Order) ............................................................................................ 59 Working With Sound Files............................................................................................... 59 Importing Sound Files To Your Project .................................................................................. 59 Assigning Sound Files to Slot Positions................................................................................. 60 Exporting Image and Sound Files From Your Project To a Specified Directory .................... 60 Working With Video Fills ................................................................................................. 61 Streaming Video Fill ............................................................................................................... 61 Working With Pages and Popup Pages ............................................................... 63 Working With Pages........................................................................................................ 63 Adding a New Page to the Active Project .............................................................................. 63 Setting Page Properties ......................................................................................................... 64 Setting Page State Properties................................................................................................ 64 Adding a Fill Color to a Page ................................................................................................. 65 Adding Text to a Page............................................................................................................ 66 Adding a Bitmap to a Page .................................................................................................... 66 Adding an Icon to a Page....................................................................................................... 67 Adding Text to a Page............................................................................................................ 67 Displaying a Video Source on a Page.................................................................................... 68 Creating a Page Flip ....................................................................................................... 68 Drag & Drop To Set Page Flips.............................................................................................. 68 Page Flip Actions ................................................................................................................... 69 Copying Pages....................................................................................................................... 69 Pasting Pages ........................................................................................................................ 69 Copying States From a Page ................................................................................................. 70 Pasting States From a Page .................................................................................................. 70 Deleting Pages From a Project .............................................................................................. 70 Exporting Pages as Image Files ..................................................................................... 70 Working With Popup Pages ............................................................................................ 71 Adding a New Popup Page .................................................................................................... 72 Using the Popup Draw Tool ................................................................................................... 73 Drawing Assist Support for Popup Pages Displayed on Pages ............................................. 74 Setting Popup Page Properties.............................................................................................. 75 Setting Popup Page State Properties .................................................................................... 77 Border Styles.......................................................................................................................... 78 iv TPDesign4 Touch Panel Design Program Table of Contents Adding a Fill Color To a Popup Page..................................................................................... 78 Adding a Bitmap to a Popup Page ......................................................................................... 78 Adding an Icon to a Popup Page ........................................................................................... 79 Adding Text to a Popup Page ................................................................................................ 79 Displaying a Video Source on a Popup Page ........................................................................ 80 Replacing States On a Page, Popup Page or Button...................................................... 80 Replacing States Through Drag-and-Drop............................................................................. 81 Popup Page Groups........................................................................................................ 81 Copying Popup Pages ........................................................................................................... 82 Pasting Popup Pages............................................................................................................. 82 Show/Hide Popup Pages ....................................................................................................... 82 Select Popup Pages to Show dialog ...................................................................................... 82 Deleting Popup Pages From a Project................................................................................... 83 Printing Pages and Popup Pages ................................................................................... 83 Working With Buttons ............................................................................................85 Setting New Button Parameters ...................................................................................... 86 Editing Button Properties................................................................................................. 87 Creating New Buttons ..................................................................................................... 88 Generated Button Names ...................................................................................................... 89 Using the Drawing Assist Features ................................................................................. 90 Alignment & Sizing Tool .................................................................................................. 91 Alignment ............................................................................................................................... 91 Sizing ..................................................................................................................................... 92 Setting General Button Properties................................................................................... 93 Level Control Parameters ...................................................................................................... 96 Input Mask Characters (Text Area button only) ..................................................................... 96 Input Mask Ranges (Text Area button only)........................................................................... 97 Input Mask Operators (Text Area button only) ....................................................................... 97 Input Mask Next Field Characters (Text Area button only) .................................................... 97 Setting Button Programming Properties.......................................................................... 97 Level Functions ...................................................................................................................... 99 Setting Button State Properties ....................................................................................... 99 All States option ................................................................................................................... 102 Working With Touch Styles and Active Touch ..................................................................... 102 Adding Text to a Button........................................................................................................ 103 Changing Button Text Color................................................................................................. 103 Formatting Codes (Bargraph and Multi-Bargraph buttons only) .......................................... 103 Adding a Bitmap to a Button ................................................................................................ 104 Adding an Icon to a Button................................................................................................... 104 TPDesign4 Touch Panel Design Program v Table of Contents Changing the Button Fill Color ............................................................................................. 105 Border Styles........................................................................................................................ 105 Chameleon Buttons.............................................................................................................. 105 Displaying a Video Source on a Button................................................................................ 106 Creating a Time Button ........................................................................................................ 106 Creating a Date Button......................................................................................................... 106 Creating a Custom Slider (Multi-Bargraph Buttons)............................................................. 107 Using Touch Maps for Multi-State Bargraphs Buttons ......................................................... 108 Working With Joystick Buttons............................................................................................. 108 Working With Text Input Buttons.......................................................................................... 108 Working With Computer Control Buttons ............................................................................. 108 Working With State Properties ...................................................................................... 109 Setting State Properties ....................................................................................................... 109 Adding States To a Button ............................................................................................ 110 Duplicating an Existing State on the Button ......................................................................... 110 Adding States From the Clipboard ....................................................................................... 110 Adding States Through Drag-and-Drop ............................................................................... 111 Removing States From A Button................................................................................... 111 Deleting States..................................................................................................................... 111 Cutting States To the Clipboard ........................................................................................... 112 Changing the Order Of States On A Button .................................................................. 112 Reordering States Through the Clipboard ........................................................................... 112 Reordering States Through Drag-and-Drop......................................................................... 112 Setting the Maximum Active State For a Button .................................................................. 112 Choose Display State dialog ................................................................................................ 113 Button Preview window ........................................................................................................ 113 Working With External Controls (Pushbuttons/LEDs) ................................................... 113 Setting Global General Properties for External Pushbuttons and/or LEDs .......................... 114 Setting Global Programming Properties for External Pushbuttons and/or LEDs ................. 114 Setting Page-Specific General Properties for External Pushbuttons and/or LEDs .............. 115 Setting Page-Specific Programming Properties for External Pushbuttons and/or LEDs ..... 115 Copy/Convert External Controls Between Panels................................................................ 115 Copying/Pasting Buttons............................................................................................... 116 Paste Controls dialog ........................................................................................................... 116 Searching and Replacing Button Properties ................................................................. 117 Using Quick Input.......................................................................................................... 118 Working With Function Codes....................................................................................... 119 Show/Hide Function Codes.................................................................................................. 120 Power Assign ................................................................................................................ 120 The Power Assign dialog ..................................................................................................... 121 vi TPDesign4 Touch Panel Design Program Table of Contents Using Power Assign: 1) Clear Channels .............................................................................. 121 Using Power Assign: 2) Assign Codes................................................................................. 122 Begin Assignment At............................................................................................................ 122 Ensure Contiguous Code Assignment ................................................................................. 122 Wrap Within Port ID ............................................................................................................. 122 File Transfer Operations ......................................................................................125 Working With Communications Configurations ............................................................. 125 Saving and Recalling Communication Configurations ......................................................... 125 Editing the Settings on an Existing Communication Configuration ...................................... 125 Connecting to a NetLinx Master .................................................................................... 126 Connecting to a NetLinx Master via TCP/IP......................................................................... 126 Connecting to a NetLinx Master via Serial Port ................................................................... 126 Connecting to a NetLinx Master via Modem ........................................................................ 126 Secure NetLinx Connections......................................................................................... 127 Transferring Touch Panel Files to/from a NetLinx Master............................................. 127 Panel File Transfers via TCP/IP........................................................................................... 128 Panel File Transfers via Serial Port...................................................................................... 129 Panel File Transfers via Modem .......................................................................................... 130 Virtual NetLinx Master TCP/IP Transfers ...................................................................... 132 Configuring TPDesign4 for Virtual NetLinx Master TCP/IP Transfers.................................. 132 Powering Up and Connecting the Panel .............................................................................. 132 Configuring the Touch Panel for Virtual NetLinx Master TCP/IP Transfers ......................... 133 Transferring Files Using a Virtual NetLinx Master TCP/IP Connection ......................... 133 Sending Files To the Panel .................................................................................................. 133 Receiving Files From The Panel .......................................................................................... 133 Virtual NetLinx Master USB Transfers .......................................................................... 134 Configuring the Touch Panel for Virtual NetLinx Master USB Transfers ............................. 134 Configuring TPDesign4 for Virtual NetLinx Master USB Transfers...................................... 134 Transferring Files Using a Virtual NetLinx Master USB Connection ............................. 135 Sending Files To the Panel .................................................................................................. 135 Receiving Files From The Panel .......................................................................................... 135 Sending a Project Without Opening the File ........................................................................ 135 Transfer Status Window ................................................................................................ 135 Working With Palettes and Colors ......................................................................137 Working With Colors...................................................................................................... 137 Working with Transparent Backgrounds .............................................................................. 138 Working With Multiple Color Palettes ............................................................................ 139 Creating New Palette Entries ............................................................................................... 139 Creating Custom Palettes .................................................................................................... 140 TPDesign4 Touch Panel Design Program vii Table of Contents Renaming Palettes............................................................................................................... 140 Changing the Active Palette................................................................................................. 140 Importing Palette Files ......................................................................................................... 140 Exporting Palette Files ......................................................................................................... 141 Copying Palettes .................................................................................................................. 141 Copying Palette Entries........................................................................................................ 141 Using Custom Palettes to Enable Color Schemes in G4 PanelBuilder......................... 142 Chameleon Images ....................................................................................................... 143 Requirements for Chameleon Images ................................................................................. 143 Working With Chameleon Images........................................................................................ 144 Chameleon Images, Custom Palettes and G4 PanelBuilder ............................................... 146 Animations and Tweening ................................................................................... 147 Using the Animation Wizard.......................................................................................... 147 Animation Wizard - Select Type (Step 1 of 6) ...................................................................... 148 Animation Wizard - Create Sequence (Step 2 of 6) ............................................................. 148 Animation Wizard - Size & Position (Step 3 of 6)................................................................. 149 Animation Wizard - Assign Frames (Step 4 of 6) ................................................................. 149 Animation Wizard - Appearance (Step 5 of 6)...................................................................... 150 Animation Wizard - Finish (Step 6 of 6) ............................................................................... 150 Tweening....................................................................................................................... 150 Creating Color Transition Effects ......................................................................................... 152 Creating Animated Bitmap Effects ....................................................................................... 153 Creating Animated Text Effects ........................................................................................... 154 Tweeners sub-menu ............................................................................................................ 154 Program Preferences ........................................................................................... 157 Preferences Dialog........................................................................................................ 157 Preferences Dialog - Application tab.................................................................................... 157 Preferences Dialog - Appearance tab .................................................................................. 159 Preferences Dialog - Directories tab .................................................................................... 160 Preferences Dialog - Editor Selection tab ............................................................................ 160 Customizing the Menus and Toolbars........................................................................... 161 Adding or Removing Command Shortcuts from the Toolbars/Menus.................................. 161 Customize dialog........................................................................................................... 161 Customize dialog - Commands tab ...................................................................................... 161 Customize dialog - Toolbars tab .......................................................................................... 161 Customize dialog - Tools tab................................................................................................ 162 Customize dialog - Keyboard tab ......................................................................................... 162 Customize dialog - Menu tab ............................................................................................... 163 Customize dialog - Options tab ............................................................................................ 163 viii TPDesign4 Touch Panel Design Program Table of Contents Command Context Menu ..................................................................................................... 164 Adding Buttons To Existing Toolbars ................................................................................... 164 Removing Buttons From Existing Toolbars.......................................................................... 164 Creating a New Custom Toolbar.......................................................................................... 165 Renaming Custom Toolbars ................................................................................................ 165 Deleting Custom Toolbars.................................................................................................... 165 Adding a Shortcut To an Application In the Tools Menu ...................................................... 165 Creating a New Custom Menu ............................................................................................. 166 Adding Commands To Existing Menus ................................................................................ 166 Associating an Icon With a New Command ......................................................................... 166 Removing Commands From Existing Menus....................................................................... 167 Hotkey Shortcuts ........................................................................................................... 167 Help Keyboard dialog........................................................................................................... 167 Setting Custom Hotkeys....................................................................................................... 167 Visual Style Options ...................................................................................................... 168 Appendix A: G4 Computer Control .....................................................................169 System Requirements for G4CC................................................................................... 169 Supported Operating Systems: ............................................................................................ 169 System Requirements:......................................................................................................... 169 Setting Up G4CC........................................................................................................... 169 1: TPD4 Touch Panel File .................................................................................................... 169 2: Source Code .................................................................................................................... 170 3: G4CC (Computer Control) Configuration: ........................................................................ 170 Using configCC.exe to Configure G4CC ....................................................................... 170 Setting Programming Properties: Computer Control Buttons........................................ 171 Running the G4CC Application ..................................................................................... 172 Appendix B: G4 Panel Builder .............................................................................173 Creating a New Project Using G4 PanelBuilder ............................................................ 173 Importing G4 PanelBuilder Templates .......................................................................... 174 Creating G4 PanelBuilder Templates............................................................................ 174 Template Requirements....................................................................................................... 175 Optional Template Elements................................................................................................ 175 Rules for Navigating A Template ......................................................................................... 176 Template Wide Conventions ................................................................................................ 177 Creating Navigation Elements....................................................................................... 177 Creating Placeholder Elements..................................................................................... 179 Placeholder Element Conventions ...................................................................................... 180 Creating Preview Images .............................................................................................. 181 Alternate Screen Names for Template Elements................................................................. 181 TPDesign4 Touch Panel Design Program ix Table of Contents Element Specific Conventions ...................................................................................... 182 Navigation Element Conventions ........................................................................................ 182 Sub-Navigation Element Conventions .............................................................................. 183 Splash Element Conventions .............................................................................................. 183 Device Element Conventions .............................................................................................. 184 Feature Element Conventions ............................................................................................. 184 Sub-Feature Element Conventions ..................................................................................... 185 Appendix C: TakeNote ......................................................................................... 187 Introduction ................................................................................................................... 187 USB Stick Specifications ..................................................................................................... 187 Pre-Configuration Procedures....................................................................................... 188 Updating AMX Hardware and Software ............................................................................... 188 Developing a TPD4 project with G4CC and TakeNote Support........................................... 188 Modifying the Source Code on your Master......................................................................... 189 Configuring Computer Control ............................................................................................. 190 Running the Computer Control Application.......................................................................... 191 Running the TakeNote Application....................................................................................... 191 x TPDesign4 Touch Panel Design Program TPDesign4 Program Overview TPDesign4 Program Overview The TPDesign4 Touch Panel Design program is designed to assist you in creating a state-of-the-art touch panel interface for AMX's new G4 Level touch panels (including the Modero line and the NXP-TPI/4 Touch Panel Interface - see the Supported Panel Types section on page 2 for details). Many of the concepts for this program will be familiar to users of TPDesign3, however, this program takes giant strides ahead in terms of ease of use, speed, functionality and conformance to Windows standards (except in those rare instances when a departure from Windows standards supports customized functionality). This instruction manual contains instructions for using TPDesign4, and describes the main elements of the program. For more detailed program reference-type material (i.e. descriptions of each menu, toolbar, dialog and options), refer to the on-line help. Click the AMX.COM toolbar button on the help window to visit the WWW.AMX.COM web site. Click the TPD4 On-line Help toolbar button on the help window to launch the on-line version of the help file (recommended). Supported Operating Systems · Windows 2000® (Service Pack 3 or greater) · Windows XP® Professional (Service Pack 1 or greater) PC Requirements · Pentium 233 MHZ processor (minimum requirement); 300 MHZ or faster recommended. · 75 MB of free disk space (minimum requirement); 150 MB recommended. · 128 MB of installed memory (RAM). · Minimum (VGA) screen resolution of 800x600. Other PC requirements · Windows-compatible CD-ROM drive. · Windows-compatible mouse (or other pointing device). Note: If the scroll wheel on your Microsoft® IntelliMouse® doesn't work with TPD4, try downloading the latest IntelliMouse drivers from Microsoft. TPDesign4 Touch Panel Design Program 1 TPDesign4 Program Overview Touch Panel Pages - Overview The area of display on an AMX touch panel is called a page. Pages can be designed as a control panel. Use TPD4 to create Pages, add buttons, bargraphs, sliders, and graphics, and designate the control functions for each object. You can create up to 500 pages and 500 popup pages as needed to achieve your functional goals. Like the name suggests, popup pages are smaller pages that "pop" up in their own window, above the actual page file that is displayed on the panel. Popup pages are similar to regular pages in that they contain buttons, but are different in that you can assign a border style. Use popup pages in conjunction with regular pages to design and create an impressive and intuitive user-interface for your touch panels. When you create multiple pages, you must link them (via page flips) to be able to go from one page to another. Do this with a page-flip attribute assigned to the specific button. As a basic example, you might have a main page with a one button labeled "Audio", one labeled "Video", and any number of others. You could set the "Audio" button to cause a page flip to another page containing buttons specific to selecting a piece of audio equipment to control (i.e. several buttons labeled CD, DVD, DAT, etc). Each of these buttons could in turn cause a page flip to another page containing buttons specific to controlling the selected piece of audio equipment (i.e. Play, Pause, Stop, etc). FIG. 1 An example of a basic page flipping Supported Panel Types TPDesign4 currently supports the following AMX (G4) touch panel types: · MVP-7500: · MVP-8400: · NXD/NXT-CV7: · NXD/NXT-CV10: · NXT-CV10/PB: · NXD/NXT-1200V: 7.5" Modero ViewPoint (wireless) Touch Panel 8.4" Modero ViewPoint (wireless) Touch Panel 7" Modero Touch Panel (with video capabilities) 10" Modero Touch Panel (with video capabilities) 10" Modero Touch Panel (with video capabilities and external pushbuttons) Enhanced 12" Modero Touch Panel (with video capabilities) · NXD/NXT-1200VG: Enhanced 12" Modero Touch Panel (with video capabilities) · NXD/NXT-CA12: · NXD/NXT-CV12: 12" Modero Touch Panel 12" Modero Touch Panel (with video capabilities) · NXD/NXT-1500VG: Enhanced 15" Modero Touch Panel (with video capabilities) · NXD/NXT-CA15: · NXD/NXT-CV15: 15" Modero Touch Panel 15" Modero Touch Panel (with video capabilities) · NXD/NXT-1700VG: Enhanced 17" Modero Touch Panel (with video capabilities) · NXD/NXT-CV17: · NXP-TPI/4: 17" Modero Touch Panel (with video capabilities) Touch Panel Interface 4 2 TPDesign4 Touch Panel Design Program TPDesign4 Program Overview The nomenclature " NXT" indicates the table-top (tilt) model, and "NXD" represents the wall-mount version. Video Capabilities for Modero Panels Video Capable Modero Panels all support Composite video inputs. These include: · NXT/NXD-CV7 · NXT/NXD-CV12 · NXT/NXD-CV15 · NXT/NXD-CV17 Video Capabilities for Enhanced Modero Panels Video capable Enhanced Modero Panels all support Composite, Component/RGB and Streaming video inputs. These include: · NXT/NXD-1200VG · NXT/NXD-1500VG · NXT/NXD-1700VG Supported Screen Resolutions The application supports 24-bit RGB color at the following screen resolutions (based on Panel definition file information): · 1280x1024 · 1024x768 · 800x600 · 640x480 TPDesign4 provides scrolling if a Design View is larger than the available visible work area. Supported Image File Types TPDesign4 supports the following image file types: · BMP (Windows bitmap) · IFF (Interchange File Format) · JPG (Joint Photographic Expert Group) · PCT (Macintosh Pict) · PCX (PC (Zsoft) Paintbrush) · PNG (Portable Network Graphic) · PSD (Photoshop) · TGA (TrueVision Targa) · WMF (Windows Meta File) · EPS (Encapsulated Post Script) TPDesign4 Touch Panel Design Program 3 TPDesign4 Program Overview True Type Font Support Since G4 panels have the ability to decode and display Windows True Type Font files (TTF), TPDesign4 directly utilizes TTF files. Fonts are presented in the Properties Control window (States tab), as well as the Button Selection/Draw toolbar and the Add Page and Add Popup Page dialogs. The TTF files listed represent those TTF files installed in Windows with their available point sizes. WebUpdate The AMX WebUpdate program is a stand-alone application that communicates with the AMX website, allows a user to select from a list of available AMX Software programs to choose for updating, determines the latest version of the selected applications, returns a listing of available updates, allows a user to download the selected installation files, and upon request, launches the installation of those downloads. The WebUpdate application is not installed by TPDesign4, and must be installed separately. If not found, TPDesign4 will prompt you to download the application from www.amx.com. Select Help > Web Update to launch this application. Refer to the WebUpdate on-line help for details and instructions. G4 PanelBuilder G4 PanelBuilder is a stand-alone application (installed separately) from AMX that allows you to quickly create TPDesign4 projects for G4 touchpanels, using either pre-fabricated templates from AMX, or user-designed templates. The G4 PanelBuilder application is designed to do the bulk of the basic layout and navigational design of a touch panel design. TPD4 is required to complete the project by specifying channel mapping information, and to generally fine-tune the project as needed. The G4 PanelBuilder setup application is available for download from www.amx.com (Dealers > Tech Center > Downloadable Files). Although G4 PanelBuilder is installed separately, it is fully integrated with TPDesign4. For example, the File > New From G4 PanelBuilder option launches the G4 PanelBuilder application to allow you to create a new TP4 project. Use the set of options in the File menu to access the key functions of the G4 PanelBuilder application: Click File > New From G4 PanelBuilder to create a new TP4 panel project using G4 PanelBuilder. Click File > Import G4 PanelBuilder Template to import an existing PanelBuilder template file (*TPT) into TPDesign4 as a starting point for your panel design. Click File > Export G4 PanelBuilder Template to export the active TP4 project as a PanelBuilder Template file (*.TPT). 4 TPDesign4 Touch Panel Design Program TPDesign4 Program Overview Note that the File menu options relating to G4 PanelBuilder are disabled if G4 PanelBuilder is not installed. For details on using G4 PanelBuilder, refer to the Appendix B: G4 Panel Builder section on page 173. G4 PanelPreview G4 PanelPreview is a stand-alone application (installed separately) from AMX that allows you to preview TPDesign4 projects for G4 touchpanels. To preview your panel project, select Panel > Send To G4 PanelPreview (or click the toolbar button) to launch the G4 PanelPreview application, where you can preview the project and simulate push and release of buttons, (including multi-state and bargraph buttons) via the mouse and keyboard on your PC. The G4 PanelPreview application is available from www.amx.com, and must be installed in order to activate this menu option. Refer to the G4 PanelPreview online help file for details. TPDesign4 Work Area The TPDesign4 work area (FIG. 2) comprises several main components: Title Bar Menu Bar Toolbars Design View Windows Properties Control Window Workspace Navigator Window State Manager Window Status Bar FIG. 2 TPDesign4 Work Area TPDesign4 Touch Panel Design Program 5 TPDesign4 Program Overview In its default configuration, from top to bottom, left to right, the work area main components are: TPDesign4 Work Area Components Item · Title Bar · Menu Bar · Toolbars Description Lists the name of the active Project file. Contains the main menu options (File, Edit, Panel, Page, Button, States, Layout, View, Window, and Help). You can choose which toolbars to show in the workspace via the View > Toolbars sub-menu. Click View, then click in the checkboxes to select/de-select the listed toolbars (including custom toolbars). If a toolbar has a check next to it in the sub-menu, then it is displayed. These settings are saved, so they'll apply the next time the application is launched. · Workspace Navigator Contains two tabs: The Pages tab contains a tree structure representing all open projects, and their pages and popup pages. Use the Pages tabs to open/edit the pages / popup pages in each project. The Function Maps tab allows you to view/edit the function codes associated with each page. · Design View Windows Each Design View Window represents a Touch Panel pages or popup page. Note that a MDI tab is displayed for each opened page. Use the View > MDI Page Tabs option to toggle the MDI page tabs. When this option is enabled, a tab is displayed for each open page. The page tabs normally appear along the bottom edge of the Design View window area, but can be moved, toggled or modified via the MDI tabs context menu (right-click inside any of the tabs to open). Note: TPDesign4 will display up to a maximum of 10 page tabs. If you open more than 10 pages, the tabs automatically disappear. · Properties Control Window Contains three tabs: the General tab allows you to view/edit general (non-state oriented) button properties, the Programming tab allows you to edit program-related parameters, and the States tab allows you to view/edit button state information. · State Manager Window Displays each state of the selected button as a thumbnail image in this window. The State Manager window allows you to view/edit the various states of a selected button. Located along the bottom edge of the application window, the Status Bar can show the current XY cursor position, and (for the button the mouse is over): Channel code, Address code, Level code, button size, panel revision, Feedback and Initial page file target information. The status bar also indicates the status of your connection to the NetLinx Master. · Status Bar Refer to the online help for detailed descriptions of each menu item and toolbar button. 6 TPDesign4 Touch Panel Design Program TPDesign4 Program Overview Toolbars All toolbars in TPDesign4 are dockable, so they can be arranged within the application window. To undock any toolbar, double-click anywhere inside the toolbar (but not on a toolbar button). Doubleclick again to dock the toolbar. To move the toolbar, click and drag using the handle (the single vertical bar) at the far-left side of the toolbar. To view a brief description of each toolbar button, place the mouse cursor directly over a button, without clicking. Try placing the Main toolbar vertically, along the right side of the Workspace Navigator. This configuration is especially efficient in terms of cursor movement back and forth between the toolbar buttons and the Design View Window(s). Design View Windows FIG. 3 Example Design View Window (with function codes showing) Design View windows represent pages or popup pages in the panel file you are creating. They provide a canvas upon which you may place buttons of any size that will fit within the confines of the windows. An enforced limit of 15 Design View windows can be open at any time. If you should attempt to exceed that number, the page or popup page that is the oldest will be automatically closed. No data will be lost through this action, as only the view to the data is closed. Usually from 1 to 10 windows open at a time is the maximum number that is practical to work with. Since Design View windows represent the pages on the panel themselves, Design Views that represent pages are not resizable. Popup pages are resizable through the Properties Control by adjusting their Left, Top, Width or Height properties. Alternatively, you can set their size and dimensions manually by first enabling the Show Popup Pages option in the Page menu. This option opens the Select Popup Pages to Show dialog, where you can select the TPDesign4 Touch Panel Design Program 7 TPDesign4 Program Overview Popup Page that you want to display on the page. Once the Popup is displayed on the page, you can click and drag to resize and position it manually. Use the View > MDI Page Tabs option to toggle the page tabs. When this option is enabled, a tab is displayed for each open page. The page tabs normally appear along the bottom edge of the Design View window area, but can be moved, toggled or modified via the MDI tabs context menu (right-click inside any of the tabs). TPDesign4 will display up to a maximum of 10 page tabs. If you open more than 10 pages, the tabs automatically disappear. Right mouse click anywhere within a Design View window to open the Design View context menu. This context menu contains shortcuts to many key design tools. Select Display from the Design View context menu to access the Display sub-menu, containing options that allow you to select which state of a selected button to display in the Design View. Select Layout from the Design View context menu to access the Layout sub-menu, containing options for layout/design control (send to front/back, align, center, etc). This menu is identical to the Layout menu, accessible from the main menu bar. Workspace Navigator Window The Workspace Navigator (FIG. 4) is typically located on the left side of the screen (although you may move it anywhere you like) and is used to open the pages / popup pages in the file, and to view/ edit the function codes associated with each page. The Workspace Navigator contains two tabs: Pages Function Maps Pages tab FIG. 4 Workspace Navigator Window Function Maps tab 8 TPDesign4 Touch Panel Design Program