Operation/Reference Guide

G4 PanelBuilder

S of t w ar e

Last Revised: 12/09/2008

AMX 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. This license does not grant Licensee the right to create derivative works of the AMX Software. 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. AMX Dealer, Distributor, VIP or other AMX authorized entity shall not, and shall not permit any other person to, disclose, display, loan, publish, transfer (whether by sale, assignment, exchange, gift, operation of law or otherwise), license, sublicense, copy, or otherwise disseminate the AMX Software. Licensee may not reverse engineer, decompile, or disassemble the AMX Software. ACKNOWLEDGEMENT. You hereby acknowledge that you are an authorized AMX dealer, distributor, VIP or other AMX authorized entity in good standing and have the right to enter into and be bound by the terms of this Agreement. 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 UPON WRITTEN NOTICE TO LICENSEE. In the event that AMX terminates this License, the Licensee shall return or destroy all originals and copies of the AMX Software to AMX and certify in writing that all originals and copies have been returned or destroyed. PRE-RELEASE CODE. Portions of the AMX Software may, from time to time, as identified in the AMX Software, include PRERELEASE CODE and such code may not be at the level of performance, compatibility and functionality of the GA 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 (other than pre-release code) 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 LICENSEE SPECIFIC LEGAL RIGHTS. Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to Licensee 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 Licensee's 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 in accordance with AMX's current return policy. 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 LICENSEE. 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 (1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (1) and (2) of the Commercial Computer Software Restricted Rights at 48 CFR 52.227-19, as applicable. SOFTWARE AND OTHER MATERIALS FROM AMX.COM MAY BE SUBJECT TO EXPORT CONTROL. The United States Export Control laws prohibit the export of certain technical data and software to certain territories. No software from this Site may be downloaded or exported (i) into (or to a national or resident of) Cuba, Iraq, Libya, North Korea, Iran, Syria, or any other country to which the United States has embargoed goods; or (ii) anyone on the United States Treasury Department's list of Specially Designated Nationals or the U.S. Commerce Department's Table of Deny Orders. AMX does not authorize the downloading or exporting of any software or technical data from this site to any jurisdiction prohibited by the United States Export Laws.

This Agreement replaces and supersedes 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. For any questions concerning this Agreement, or to contact AMX for any reason, please write: AMX License and Warranty Department, 3000 Research Drive, Richardson, TX 75082.

Table of Contents

Table of Contents
G4 PanelBuilder Overview ..................................................................................1
Welcome to G4 PanelBuilder .................................................................................... 1 System Requirements ............................................................................................... 1 Supported AMX (G4) touch panel types: .................................................................. 1 The G4 PanelBuilder Work Area ............................................................................... 2
G4 PanelBuilder Application Interface ............................................................................ 2 File Menu ........................................................................................................................ 3 Edit Menu........................................................................................................................ 3 Project Menu................................................................................................................... 3 Toolbox Menu ................................................................................................................. 3 Diagram Menu................................................................................................................. 4 View Menu ...................................................................................................................... 4 Help Menu....................................................................................................................... 4 Diagram Area .................................................................................................................. 5 Toolbar............................................................................................................................ 5 Tasks Pane....................................................................................................................... 6 Quick Links ...................................................................................................................... 7 Toolbox ........................................................................................................................... 7 Color Schemes ................................................................................................................ 8 Status Bar........................................................................................................................ 8 Viewing Panes ................................................................................................................. 8 Changing Visual Style...................................................................................................... 8

Basic Operations ................................................................................................9

Getting Started......................................................................................................... 9
Creating A New Project .................................................................................................. 9 Adding A Toolbox Element to The Diagram ................................................................... 9 Adding Elements via The Diagram Menu ...................................................................... 10 Connecting Elements .................................................................................................... 10 Editing Diagram Element Properties via The Diagram Menu ........................................ 11 Generating A TPDesign4 Project .................................................................................. 11 Saving A Project............................................................................................................ 11 Closing A Project........................................................................................................... 12

Templates ............................................................................................................... 12
Preview A Template via Template Manager.................................................................. 12 Opening A Most Recently Used Template .................................................................... 12 Install A Template via Template Manager ..................................................................... 12 Install Templates from AMX.com .................................................................................. 12

G4 PanelBuilder

Table of Contents

Install A Template from File .......................................................................................... 13 Remove A Template from G4 PanelBuilder ................................................................... 13

Opening A Project .................................................................................................. 13 Changing Color Schemes ........................................................................................ 13 Creating A New Project from File ........................................................................... 14 Editing Project Properties....................................................................................... 14 Alternate Screen Names ......................................................................................... 14 Using Unicode Text................................................................................................. 14 Preview Diagram Element....................................................................................... 15 Preview A Toolbox Element.................................................................................... 15 Globally Remove An Element Instance ................................................................... 15 Undo, Redo And Delete.......................................................................................... 15 Create Snapshots to Clipboard............................................................................... 16 Show and Hide Grid................................................................................................ 16 Snap To Grid........................................................................................................... 16 Zoom in And out of Diagram .................................................................................. 16 Using Web Updates ................................................................................................ 16 Exiting G4 PanelBuilder .......................................................................................... 16

Creating Templates for G4 PanelBuilder ..........................................................17

Overview ................................................................................................................ 17 Creating Templates with Alternate Screen Names ................................................. 19 Creating Templates with Color Schemes ................................................................ 19
Define The Color Scheme .............................................................................................. 19 Create A Preview Image................................................................................................ 19

Template Requirements.......................................................................................... 20 Required Template Elements.................................................................................. 20 Optional Template Elements .................................................................................. 22 Rules for Navigating A Template ............................................................................ 25 Template Wide Conventions................................................................................... 25 AMX Element Naming Conventions........................................................................ 26

Program Reference ...........................................................................................27

Dialogs.................................................................................................................... 27
AMX.com Template Library dialog................................................................................ 27 Close Project dialog ...................................................................................................... 28 Color Schemes dialog.................................................................................................... 28 Diagram Preview dialog ................................................................................................ 29 Diagram Properties dialog ............................................................................................ 29 Errors And Warnings Report dialog .............................................................................. 30

ii

G4 PanelBuilder

Table of Contents

Generate TPDesign4 Project dialog .............................................................................. 30 Install Templates from File dialog ................................................................................. 31 New From File dialog.................................................................................................... 31 New Project dialog........................................................................................................ 32 Open Project dialog ...................................................................................................... 33 Project Properties dialog .............................................................................................. 33 Replace Template dialog............................................................................................... 34 Save As dialog............................................................................................................... 34 Template Manager dialog ............................................................................................. 35 Template Sample Images dialog ................................................................................... 36 Unicode Edit Window.................................................................................................... 36

Context Menus ....................................................................................................... 37

Diagram Area Context Menu ........................................................................................ 37 Toolbox Context Menu ................................................................................................. 37 View Context Menu....................................................................................................... 37

G4 PanelBuilder

iii

Table of Contents

iv

G4 PanelBuilder

G4 PanelBuilder Overview

G4 PanelBuilder Overview
Welcome to G4 PanelBuilder
With the advent of G4 PanelBuilder, AMX enables proficient G4 panel programmers to enjoy sleek touch panel designs without the need for a graphic artist. Dealers now have the choice of using AMX created panel templates or implementing their own TPDesign4 creations.

System Requirements
G4 PanelBuilder supports the following platforms: Windows 2000 (Service Pack 3 or greater) If you are installing on a Windows 2000 machine, you must have Administrator rights to install and run all required System files. Windows XP Home and Professional (Service Pack 1 or greater) Other 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 Windows-compatible CD-ROM drive. Windows-compatible mouse (or other pointing device).

Supported AMX (G4) touch panel types:

MVP-7500: 7.5" Modero ViewPoint (wireless) Touch Panel MVP-8400: 8.4" Modero ViewPoint (wireless) Touch Panel NXT/NXD-1200V: Enhanced 12" Modero Touch Panel NXT/NXD-1200VG: Enhanced 12" Modero Touch Panel (with video capabilities) NXT/NXD-1500VG: Enhanced 15" Modero Touch Panel (with video capabilities) NXT/NXD-1700VG: Enhanced 17" Modero Touch Panel (with video capabilities) NXT/NXD-CV7: 7" Modero Touch Panel (with video capabilities) NXT/NXD-CA12: 12" Modero Touch Panel NXT/NXD-CV12: 12" Modero Touch Panel (with video capabilities) NXT/NXD-CA15: 15" Modero Touch Panel NXT/NXD-CV15: 15" Modero Touch Panel (with video capabilities) NXT/NXD-CV17: 17" Modero Touch Panel (with video capabilities) NXP-TPI/4: Touch Panel Interface 4

The nomenclature " NXT" indicates the table-top (tilt) model, and "NXD" represents the wall-mount version.

G4 PanelBuilder

G4 PanelBuilder Overview

The G4 PanelBuilder Work Area

G4 PanelBuilder Application Interface
The G4 PanelBuilder Application Interface is the main view you work with when creating a new panel file (*.PB4), as you can see it is visually driven.
Instance Counter Diagram Area

Menu Bar Toolbar

Tasks Pane

Toolbox

Quick Links

Status Bar

FIG. 1 G4 PanelBuilder Application Interface

G4 PanelBuilder Application Interface

Menu Bar Toolbar Toolbox Status Bar The menu bar is the location of all functions for G4 PanelBuilder. The toolbar contains icons for the commonly used functions. All elements available within a selected template reside in the toolbox. The toolbox is only available when a template is open. In addition to giving you the current status of G4 PanelBuilder, i.e., Ready. The status bar also provides a brief description of toolbar and menu items via mouse over.

Instance Counter The instance counter tracks and displays the number of times an element is used within the current project. Diagram Area Tasks Pane The Diagram area is the graphical representation of the flow your panel file will follow. After pulling the elements from the Toolbox you can connect and develop the elements. The tasks pane is a collection of links to commonly used functions. In addition to opening projects (both new and existing), tasks pane tracks recently opened projects and templates. To access anything listed in the tasks pane, click on any of the items listed. Located within the Tasks Pane is a small sub-section quick links. These links allow you quick access to adding and managing templates within G4 PanelBuilder.

Quick Links

G4 PanelBuilder

G4 PanelBuilder Overview

File Menu
The File menu serves as a location for file management, project information and template management. File Menu
New New From File Open Close Save Save As Generate TPDesign4 Project Install Templates From AMX.com Install Templates From File Template Manager Most Recently Used List Exit Launches the New Project dialog. Launches the New From File dialog. Launches the Open Project dialog. Closes the project currently open. Saves the current project. If the project has not been previously saved it will launch the Save As dialog. Launches the Save As dialog. Launches the Generate TPDesign4 Project dialog. When an internet connection is present, connects to AMX.com and launches the AMX.com Template Library dialog. Launches the Install Templates from File dialog. Launches the Template Manager dialog. A list of most recently opened project file names. Closes the G4 PanelBuilder application.

Edit Menu
The Edit menu governs the actions within the Diagram area. Edit Menu
Undo Redo Undoes action taken in diagram area. Undo does not apply to text changes within elements. Reverses the undo action taken within the diagram area.

Delete Deletes the element currently selected in the Diagram area.

Project Menu
The Project menu is a set of features covering the project properties and related items. Project Menu
Project Properties Color Schemes Launches the Project Properties dialog. Launches the Color Schemes dialog. Project Template Sample Images Launches the Template Sample Images dialog.

Toolbox Menu
The Toolbox menu is a set of features for interacting with the Toolbox area. Toolbox Menu
Add Element To Diagram Remove All Instances From Diagram Element Preview Adds the element currently selected within the Toolbox to the Diagram area. Removes all instances of the currently selected element from the Diagram area. Launches the Templates Sample Images dialog with the currently selected element shown.

G4 PanelBuilder

G4 PanelBuilder Overview

Diagram Menu
The Diagram menu interacts directly with the Diagram area. Diagram Menu
Add Element Properties Preview Show Grid Snap To Grid Zoom Out Zoom In Zoom A complete list of available elements within your selected template. Select any element to have it placed within the Diagram area. Launches the Diagram Properties dialog. This feature views the properties of the selected element within the Diagram area. Launches the Diagram Preview dialog. Shows the grid in the Diagram area. Locks all element placements to grid lines. Decreases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. Increases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. A list of available increments to zoom into or out of the diagram area. Click on the desired magnification to implement.

Copy Snapshot To Clipboard Copies only the diagram area to your computer's clipboard.

View Menu
The View menu allows you to toggle different aspects of the G4 PanelBuilder Application Interface on and off. Additionally, you can change the appearance of the application itself. A check next to the title indicates it is visible. View Menu
Visual Style A list of visual appearances for the G4 PanelBuilder. Select one of the following: Default (Windows 2000) Office XP Office 2003

Help Menu
The Help menu contains features for updating the application and connecting with AMX for a demo on how to use G4 PanelBuilder. Help Menu
Contents AMX Training Demo Web Update Launches the G4 PanelBuilder help, Contents section. Connects to AMX.com for the online demo for using G4 PanelBuilder. Launches the AMX Web Update utility. Internet connection is necessary.

About G4 PanelBuilder Displays the about G4 PanelBuilder dialog containing information pertaining to version and copyright.

G4 PanelBuilder

G4 PanelBuilder Overview

Diagram Area
The Diagram area is the graphical representation of the flow your panel file will follow. After pulling the elements from the Toolbox you can connect and develop the elements. You can either click and drag or nudge the elements within the Diagram area. Select an element and use your arrow keys to nudge.
Exiting Node Element

Entering Node

Connection Line

FIG. 2 Diagram Area

Diagram Area
Entering Node Exiting Node Element This node receives the connection line from another element. This node connects out to another element. The building block of the panel files, i.e., Modes, Navigation, Devices, and etc.

Connection Line The graphical representation of the connection between two elements. The color of the connection line is dictated by the element it is exiting.

Toolbar
The toolbar contains icons for the commonly used functions:
New New From File Open Save Generate TPDesign4 Project Delete

Undo Redo Color Schemes Zoom Out Zoom In Copy Snapshot To Clipboard Template Manager

FIG. 3 Toolbar

G4 PanelBuilder

G4 PanelBuilder Overview

Toolbar
New New From File Open Save Launches the New Project dialog. Launches the New From File dialog. Launches the Open Project dialog. Saves the current project. If the project has not been previously saved it will launch the Save As dialog. Deletes the element currently selected in the Diagram area. Undoes action taken in diagram area. Undo does not apply to text changes within elements. Reverses the undo action taken within the diagram area. Launches the Color Schemes dialog. Decreases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. Increases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. Launches the Template Manager dialog.

Generate TPDesign4 Project Launches the Generate TPDesign4 Project dialog. Delete Undo Redo Color Schemes Zoom Out Zoom In

Copy Snapshot To Clipboard Copies only the diagram area to your computer's clipboard. Template Manager

Tasks Pane
The tasks pane is a collection of links to commonly used functions. In addition to opening projects (both new and existing), tasks pane tracks recently opened projects and templates. To access anything listed in the tasks pane, click on any of the items listed.

Recently Opened Projects Open Project

Recently Opened Templates New File New from File

FIG. 4 Tasks Pane

Tasks Pane
Recently Opened Projects Open Project Recently Opened Templates New File New from File A list of file names for recently opened existing projects. Launches the Open Project dialog. A list of file names for recently opened templates. Launches the New Project dialog. Launches the New From File dialog.

G4 PanelBuilder

G4 PanelBuilder Overview

Quick Links
Located within the Tasks Pane is a small sub-section quick of links. These links allow you quick access to adding and managing templates within G4 PanelBuilder.
AMX.com Template Library Install Template from File Open Template Manager

FIG. 5 Quick Links

Quick Links
Install Templates From AMX.com Install Templates From File Template Manager If a internet connection is available, G4 PanelBuilder connects to AMX's collection of online templates. The templates are found in AMX.com Template Library dialog. Launches the Install Templates From File dialog. Launches the Template Manager dialog.

Toolbox
All elements available within a selected template reside in the toolbox. The toolbox is only available when a template is open.

Element (i.e., Mode Element with 3 items)

Element Sections

FIG. 6 Toolbox

As you can see, the toolbox is divided into elements with specific pages contained therein. Click on the element you would like to add, i.e., Navigation, Device, etc. All available elements will be shown. When available, a thumbnail representation of the page will appear within the toolbox; otherwise a general image will be shown for the thumbnail. Mouse-over the element to get a description. Once you have found the element you would like to use, you can right-click on the thumbnail to access the toolbox context menu or drag-and-drop the element into the diagram area. Only contained within the template are represented within the toolbox. If the template does not contain a particular element, you will not see it in the toolbox.

G4 PanelBuilder

G4 PanelBuilder Overview

Color Schemes
Templates can contain multiple color palettes, allowing you to switch from one color scheme to another within one template. The current scheme is reflected in the element preview but the elements in the toolbox will remain the main color scheme. Used either with Chameleon buttons or standalone, you can use a single template that can deliver different predefined color schemes.

Status Bar
Located at the bottom of the G4 PanelBuilder Application Interface is the status bar. In addition to giving you the current status of G4 PanelBuilder, i.e., Ready. The status bar also provides a brief description of toolbar and menu items via mouse over.

Viewing Panes
The G4 PanelBuilder Application Interface is composed of panes, sections containing tools for creating a panel project. To reveal or hide different panes: Select View > (any of the panes listed; a check mark indicates the pane is in view) Toolbar, Tasks Pane, Toolbox or Status Bar.

Changing Visual Style

So, you love everything G4 PanelBuilder does for you and just could not be more impressed. Well, you would rather it fit in with the Windows 2000 theme you have. To change the appearance of G4 PanelBuilder: Select View > Visual Style and select from the following Default Office XP Office 2003

G4 PanelBuilder

Basic Operations

Basic Operations
Getting Started
Creating A New Project
The first step towards designing a new *.TP4 file is creating a new project file (*.PB4).

1. 2. 3. 4. 5.

Launch the G4 PanelBuilder application. Select File > New. This launches the New Project dialog. Type the Job Name in the corresponding field. Select the Panel Type and Resolution from the drop down menus. Select your desired template family from the thumbnails listed.

If no templates are shown you will need to load them. You can either Install A Template from File or Install Templates from AMX.com.

6. After you have clicked on your desired template, click OK. 7. Your new project is now open to the G4 PanelBuilder Application Interface. A Start element is in place
within the Diagram area. If a project is already open and you select open a new or existing project, you are prompted by the Save As dialog. The previous project will remain on screen until you are done setting up the new project.

Adding A Toolbox Element to The Diagram

Once you have a project file open you can add elements to the panel file.

1. Select the element type within the Toolbox. 2. Find the desired element, click-and-drag the element to the Diagram area.

FIG. 7 Drag a Navigation element to the Diagram area

3. Now connect the Start element to the Navigation element. Click on the Exiting node (white) on the Start
element and drag it to the other element. All possible connections are indicated by a green outline. If the connection cannot happen the outline is red. A connection line appears between the two elements.

G4 PanelBuilder

Basic Operations

FIG. 8 Drag Start node to Navigation element node

4. You can now edit the properties for the Navigation element or select another element to add to the
diagram area. An element will populate the corresponding appropriate field, when connecting. This saves you the trouble of naming element properties.

Navigation populated by Device element

FIG. 9 Drag Navigation element node to Device element node

Adding Elements via The Diagram Menu

Designing G4 PanelBuilder projects is done through graphic representation. The flow between the pages is done through the Diagram area. Connections are then made between the elements in the Diagram area. To add an element using the Diagram menu:

1. Open a project or create a new project file. 2. Select Diagram > Add Element, then select the element with the appropriate number of selections or
device for your criteria. You can either click and drag or nudge the elements within the Diagram area. Select an element and use your arrow keys to nudge.

Connecting Elements
Developing flow between pages is made possible by creating lines from one element's exiting node to another element's entering node.

1. With a template open and elements present in the diagram area, left-click and hold on the exiting node of
a desired element.

2. Drag your mouse over any part of another element. If a connection is permissible, the element highlights
in green. If the connection is not possible the element highlights in red. You have now created the flow from one page to another.

10

G4 PanelBuilder

Basic Operations

Editing Diagram Element Properties via The Diagram Menu

Once an element is in place in the Diagram area, it is necessary to name the node and place text for the corresponding buttons.

1. Select an element in the Diagram area. 2. Select Diagram > Properties to open the Diagram Properties dialog. 3. Click within the text fields to edit. You can either type the name or use the browse (...) button to edit the
Connections fields.

4. Once all fields are edited, click OK. Generating A TPDesign4 Project
After your new project has all the necessary elements, their nodes are connected and the element properties are set; you are ready to generate a .TP4 file.

1. Select File > Generate TPDesign4 Project to launch the Generate TPDesign4 Project dialog. 2. Select the location to save the file and place a check next to Open project in TPDesign4 if you want G4
PanelBuilder to launch the newly created file within TPDesign4.

3. Click Save.
When you generate a TPDesign4 project G4 PanelBuilder stores information to the .PB4 file. As a result the file will indicate being "dirty" or changed. You will need to save the .PB4 file.

Saving A Project
To save a G4 PanelBuilder project file (*.PB4):

1. 2. 3. 4.

Select File > Save. If this is the first instance of a save for your project, the Save As dialog launches. Type the File name in the field provided. Locate the directory you would like to save within. Place a check next to Package template with project file if you would like to include the .TPT file with the .PB4 file. Doing this will allow you to open the G4 PanelBuilder file on other machines running the application.

5. Click Save.
Select Save As if you would like to save your project under another name or different location.

1. 2. 3. 4.

Select File > Save As to launch the Save As dialog. Type the File name in the field provided. Locate the directory you would like to save within. Place a check next to Package template with project file if you would like to include the .TPT file with the .PB4 file. Doing this will allow you to open the G4 PanelBuilder file on other machines running the application.

5. Click Save.
When you generate a TPDesign4 project G4 PanelBuilder stores information to the .PB4 file. As a result the file will indicate being "dirty" or changed. You will need to save the .PB4 file.

G4 PanelBuilder

11

Basic Operations

Closing A Project
To exit an open project but leave G4 PanelBuilder running: Select File > Close. If you have not already saved, the Close Project dialog will prompt you. If the file save is current the file closes. When you generate a TPDesign4 project G4 PanelBuilder stores information to the .PB4 file. As a result the file will indicate being "dirty" or changed. You will need to save the .PB4 file.

Templates
Preview A Template via Template Manager
G4 PanelBuilder pages derive their look from templates (*.TPT files). Template Manager allows you access to all template files located on your computer. To preview any template located on your computer using Template Manager:

1. 2. 3. 4.

Select File > Template Manager to launch the Template Manager dialog. Double-click on the thumbnail of a template family. Select a thumbnail for one of the panel types within the family. Click on the Samples button to launch the Template Samples Images dialog.

Opening A Most Recently Used Template

The Tasks Pane is a collection of frequently used functions. This is intended to add convenience to panel design. In the Tasks Pane, under Start a new project, is a list of recently used templates. To create a new G4 PanelBuilder project using one of the templates listed, click on the link for the desired template name. A new project file opens using your selected template.

Install A Template via Template Manager

The style for your panel pages is dictated by the template (.TPT) file you are using. You can download templates from AMX.com or create your own and then load them into G4 PanelBuilder.

1. First, launch the Template Manager dialog by selecting File > Template Manager. 2. Click the Install button in the bottom left corner. 3. Select either:
From AMX.com From File

Install Templates from AMX.com

G4 PanelBuilder project files (*.PB4) derive their style from templates. In addition to making your own templates, you can download AMX created templates. To install a .TPT file from AMX.com:

1. 2. 3. 4. 5.

Select File > Template Manager to open the Template Manager dialog. In the bottom left corner of the dialog, select Install. Select From AMX.com from the drop-down list to launch the AMX.com Template Library dialog. Select a thumbnail of one of the template families. Click the Install button.

If the .TPT file already resides on your computer you will be prompted by the Replace Template dialog. Select on of the following: Yes - Confirms the replacement of the .TPT file on a panel-by-panel basis. Yes All - Confirms the replacement of all .TPT files at one time. No - Denies the replacement of the .TPT file on a panel-by-panel basis. No All - Denies the replacement of all .TPT files at one time.

12

G4 PanelBuilder

Basic Operations

Abort - Cancels the template import with no changes. If you replace a .TPT file that is referenced by a .PB4 file, it will be updated in the .PB4 file.

6. After the template has been installed, click Close. Install A Template from File
G4 PanelBuilder utilizes templates to apply appearances to panel pages. You can import your own local files as a template (.TPT) for use within G4 PanelBuilder.

1. Select File > Install Templates From File to launch the dialog. 2. Locate the .TPT file you would like to import. 3. Click Install.
Templates are identified by their job names. Regardless of file name, if the job name already exists, you are prompted by the Replace Template dialog. If you replace a .TPT file that is referenced by a .PB4 file, it will be updated in the .PB4 file.

Remove A Template from G4 PanelBuilder

Panel pages designed in G4 PanelBuilder depend on templates to dictate their style. The Template Manager allows you to preview, add and remove templates from your local directory. To remove template files (*.TPT) files:

1. 2. 3. 4.

Open the Template Manager dialog by selecting File > Template Manager. Select the thumbnail of the template to be removed. Click Remove at the bottom of the window. Confirm you have selected the appropriate template and click OK.

Opening A Project
To open a (*.PB4) file in G4 PanelBuilder:

1. Select File > Open to launch the Open Project dialog. 2. Select the file and click OK.
If a project is already open and you select open a new or existing project, you are prompted by the Save As dialog. The previous project will remain on screen until you are done setting up the new project.

Changing Color Schemes

If the template you are working with has more than one color scheme available the Color Schemes button is active in the toolbar. To change the color scheme of your project file:

1. With your project file open go to Project > Color Schemes to open the Color Schemes dialog. 2. Select the color scheme in the field and click OK.
While the color change is not reflected in the toolbox, you will see it if you select an element and go to Diagram > Preview.

G4 PanelBuilder

13

Basic Operations

Creating A New Project from File

You can change templates attributed to projects and create a new project as a result.

1. 2. 3. 4.

Select File > New From File to launch the New From File dialog. Open your desired project file (*.PB4). The next window to open is the New project dialog. Select the new template to be used with the project. Click OK.

If a project is already open and you select open a new or existing project, you are prompted by the Save As dialog. The previous project will remain on screen until you are done setting up the new project.

Editing Project Properties

You can edit some of the project's properties as well as add information specific to you, i.e., Dealer ID and Designer ID.

1. Select File > Project Properties to launch the Project Properties dialog. 2. Place your cursor within the white fields to add and edit text.
To set a password for the project:

1. Click the drop-down menu for Protection. Select either:

read-only - project can be opened; not changed. locked - project cannot be opened. Password protection extends only to TPDesign4. Projects password protected in G4 PanelBuilder can still be opened and used.

2. Type a password in the field provided. 3. Re-type the password within Confirm. 4. Click OK when all changes have been made.
Project properties differ from file properties established in TPDesign4. File properties entered in TPDesign4 are what is displayed in the Template Manager dialog.

Alternate Screen Names

G4 PanelBuilder supports alternate screen names for use with elements with longer names. Within TPDesign4, the template designer can designate abbreviated text for substitution. You can then change the on-screen text in PanelBuilder and the default text fits without the need for modification. The full name of the element is always displayed in the toolbox area.

Using Unicode Text

G4 PanelBuilder supports assigning text to template elements that differs from the element name. This means you can rename an element, and the new name will be used to populate panel titles and button names. Additionally, the new text can be set in Unicode. To assign Unicode text to a template element:

1. 2. 3. 4. 5. 6.

Select the element within the diagram area. Select Diagram > Properties to open the Diagram Properties dialog. Click on the browse button (...) to launch the Unicode Edit dialog widow. Type the Unicode within the text field and the equivalent is displayed below. Click OK to close the Unicode Edit dialog. Click OK to close the Diagram Properties dialog.

14

G4 PanelBuilder

Basic Operations

The Unicode can now only be edited via the Unicode Edit dialog. If the element name and screen name differ, both are displayed within the node. If Unicode characters are specified but the template does not support the specified font a Unicode font is used only in those instances. To set the Unicode Font:

1. Select Project > Project Properties to open the Project Properties dialog. 2. From the drop down list, select the font G4 PanelBuilder is to use in the event the Unicode character font
is not supported.

3. Click OK.

Preview Diagram Element

G4 PanelBuilder files are designed within the diagram area using graphic representation for the panel pages. It is necessary to see how the pages will look when finished. Will the text fit the selected button? To preview an element within the Diagram area:

1. Select an element in the Diagram area. 2. Select Diagram > Preview to launch the Diagram Preview dialog. This view is what the finished panel
will look like.

3. When finished click Close.

Preview A Toolbox Element

G4 PanelBuilder uses graphic representation within the Diagram area to develop panel files and express flow between pages. While the toolbox does contain thumbnails for the elements, you can view larger screenshots of each element. To preview a toolbox element:

1. Select an element in either the toolbox or Diagram area. 2. Select Toolbox > Element Preview to launch the Template Sample Images dialog. 3. Click Close when you are finished.

Globally Remove An Element Instance

G4 PanelBuilder uses the Diagram area as a graphic representation for the flow panel pages take. You create this flow by placing elements within the Diagram area and then connecting them accordingly. You can delete these elements from the work area individually or in a global fashion. To globally remove an element:

1. Select the element thumbnail to be removed within the Toolbox. 2. Select Toolbox > Remove All Instances From Diagram.

Undo, Redo And Delete

The crux of G4 PanelBuilder is the graphically driven interface of the Diagram area. You are able to move elements around within the provided area as well as connect them to develop a flow. It is possible to edit these actions via the Edit menu. The functions, undo, redo and delete do not apply to changes made to element properties. To Undo an action in the Diagram area: Select Edit > Undo. To Redo an Undo or Delete action: Select Edit > Redo. To delete an element or connection in the Diagram area:

1. Select the item in the Diagram area. 2. Select Edit > Delete.

G4 PanelBuilder

15

Basic Operations

Create Snapshots to Clipboard

Since designing panel projects in G4 PanelBuilder is a visual exercise, where you drag and link individual elements to make a flow within the Diagram area. It is necessary to be able to show the design or "snapshot" of the intended look. Once you are ready to create a snapshot to your computer's clipboard:

1. Select Diagram > Copy Snapshot To Clipboard. 2. Open a graphic program, i.e., Paint or Photoshop and paste the image into it.
Even if you zoom in or out of the Diagram area, the default, 100%, view is used in creating a snapshot to clipboard.

Show and Hide Grid

The Diagram area allows you to visually arrange your panel pages and connect them to create a flow. You can toggle a grid to snap the elements to on and off. To show the grid: Select Diagram > Show Grid. When a check is present next to this function in the Diagram menu, the elements will align incrementally and the gird is shown.

Snap To Grid
The Diagram area allows you to visually arrange your panel pages and connect them to create a flow. To have the elements snap to the grid: Select Diagram > Snap To Grid. When the check is present the elements snap to the grid. The elements align according to the grid in the Diagram area.

Zoom in And out of Diagram

When designing a G4 PanelBuilder file, you place elements within the Diagram area, set properties and create connections between the elements to establish flow. To zoom in or out of the Diagram area: Select Diagram > Zoom Out/In. This function will zoom incrementally. To select the percentage in which to zoom: Select Diagram > Zoom and then select the desired percentage. Even if you zoom in or out of the Diagram area, the default, 100%, view is used in creating a snapshot to clipboard.

Using Web Updates

Newer versions of G4 PanelBuilder can now be acquired via the internet. The Web Update utility accesses the AMX web site with the application ID and version number and searches for updates.

1. Select Help > Web Update to check for updates. 2. If updates are available for the installed version of G4 PanelBuilder they will be downloaded at this time. 3. After the download is complete Web Update will close G4 PanelBuilder and the updates will be added.
If you do not have Web Update installed, you will receive a window indicating where it can be downloaded.

Exiting G4 PanelBuilder
After you have created a new touch panel page, generated it and saved it, you are ready to close G4 PanelBuilder. Select File > Exit. If you have not already saved a currently open project, you are prompted to do so now. Confirm, deny or cancel the changes.

16

G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Overview
A template is a TPD4 file complete with pages, popups and buttons, named in a manner that G4 PanelBuilder will understand the relationship between all of the elements. Then, based on the established elements, G4 PanelBuilder customizes the TPD4 file based on the navigation flow you designed. Any number of template files (*.TPT) can be created to constitute a template family, it is suggested you create one for each resolution totaling 6. The resolutions and panel types are as follows: Panel Resolutions
Resolution 640x480 800x600 Panel Type MVP-7500 TPI4 MVP-8400 CA12 CV12 TPI4 800x480 CV7 CV10 CV10/PB 1024x768 CV15 CA15 TPI4 1280x1024 1280x768 TPI4 CV17

According to the table there are only 6 resolutions, the minimum number to make a template family, but 12 different panel types. You only need one template per resolution but you should consider instances such as the MVP-8400, where the Pixels Per Inch is higher than the CV12 and the MVP-7500's limited color depth. Both examples are situations where you might consider making specific templates for those panel types.

1. You should spend some time deciding what you want the panel to do. What navigation model are you
going to use? You know you're going to have the required template elements but are some of your menus so complex they will require sub-menus? What devices and features will the template include? Consider using some optional template elements. Careful consideration will reveal the type of navigation you will need. Things to remember: You must have a minimum of 1 Navigation element. You must have a minimum of 1 Placeholder element. You must have a main preview image ("[preview].jpg" or "[preview].png"). You cannot create a "drill-down" style of navigation with G4 PanelBuilder. Your navigation menus will always be on top of your Devices. Make sure they do not conflict with each other. Suggestion
Create a simple TPD4 file showing the desired output. Doing this gives you a starting point to begin looking at how to modify the TPD4 file to create a template.

2. You are ready to begin restructuring the elements to fit your needs. Start with the Device and Navigation
elements first and the Placeholder elements last. The key for creating your own elements naming conventions. G4 PanelBuilder looks for navigations with the name, [nav#navName]pageName.

G4 PanelBuilder

17

Creating Templates for G4 PanelBuilder

Suggestions
Start with the most complex Device element first, then make copies of it. This method allows you to modify and delete thus the pages are more likely to be similar. Also, create several different variations of Navigation and Sub-Navigations (3 items, 4 items, etc...).

3. Create the preview images for the elements. Images do not have to be full size, in fact AMX templates
utilize a 1/4 screen size to reduce the template file size. Suggestion
Mock up the interface in TPDesign4 by opening the corresponding page and display all applicable popups. Select Page > Copy Image To Clipboard. Then open the resource manager and select Paste. Now rename the new image to the appropriate element name.

4. After you have completed the template design, do a generate. A .TPT file is created and a list of errors
and warnings are displayed at this time, if applicable.

5. Repeat the design for other resolutions.

Things to remember: You can use TPD4's Save As Other Panel Type when appropriate or as a starting point. Leave the "Job Name" in the Panel Properties the same for all related TPD4 files, this is the basis of a template family. Not all resolutions have to be done at once. If necessary you can build the ones you currently need and address the other resolutions as they present themselves. Below is the workspace for TPDesign4. The pages are highlighted in the color of the element they represent.

FIG. 10 TPDesign4 Workspace

18

G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Creating Templates with Alternate Screen Names

G4 PanelBuilder supports alternate screen names for use with elements with longer names. The alternate name must be defined by the template creator. You must create an info button for the device and use this syntax: [info]alternate name For example, the device Audio Conference could have the alternate screen name of Audio Conf. displayed on the navigation button. The info button is defined as: [info]Audio Conf

Creating Templates with Color Schemes

When you create a template within TPDesign4 you can designate color palettes from which to work. Defined color palettes are Color Schemes, utilized by G4 PanelBuilder for changing color schemes.

Define The Color Scheme 1. 2. 3. 4. 5.

Within TPDesign4, select Panel > Edit Palettes to open the Edit Palettes dialog. Select Rename to edit the name of the palette. Define the colors used in the palette. Repeat steps 2 and 3 for as many color schemes you want available within the template file. Click Close.

Create A Preview Image

Before TPDesign4 will export a template file, all color schemes must have a sample image.

1. Select a panel page that best represents the color scheme used. It is suggested you use the same panel
page for all color schemes to better show the color changes.

2. With the selected panel page open and active, select Page > Create Template Preview Image to open the
Create Template Preview Image dialog.

3. 4. 5. 6.

Set Element Type to Palette. The Name must match the name you used in step 2 of Define The Color Scheme. You can set the Scale, File Format and Compression at your discretion. Click OK.

You can now export the file as a template, open and use it within G4 PanelBuilder.

G4 PanelBuilder

19

Creating Templates for G4 PanelBuilder

Template Requirements
There are a few key items required of all templates. TPD4 will not allow you to create a template without: A minimum of 1 Navigation Element. A minimum of 1 Placeholder Element. A main preview image ("[preview].jpg" or "[preview].png").

Required Template Elements

When designing a template it is important to remember the rules that govern elements and their relation with the templates. The chart below demonstrates these rules.

FIG. 11

The template must have at least one of each of the following elements: Navigation Elements - This is the main menu where most of your navigation selections are made. Consists of at least one popup but can contain multiple popups. Cannot contain any pages Only one can be displayed at a time

20

G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Navigation Element Specific Conventions

[nav#navName]pageName navName pageName [info]buttonName This text is used to populate the mouse-over element description in the toolbox. buttonName [item]buttonName The name of the Navigation as it will appear within G4 PanelBuilder. The base page name that will be used in the generated TP4 project. Only one of the pages or popups in A Navigation element can contain an Info button. The Info button contains the page flip information for displaying the Navigation element and can contain an optional icon image. This is unused and the button is deleted in the generated TP4 project. The popups in the Navigation element must contain at lest one item button that will be filled with navigation information. Item buttons are ordered within the Navigation element in order of left to right then top to bottom. This is the button name used in the generated TP4 project. Popups in a Navigation element can contain one or more Title buttons. The text will be replaced with the name given to the Navigation in the generated TP4 project. This is the button name used in the generated TP4 project.

buttonName [title]buttonName

buttonName

Placeholder Elements - This is a blank device element that allows you to represent unique items in the diagram area. Consists of one page and may have optional popups. Only one Placeholder element can be displayed at a time. Placeholder Element Specific Conventions
[placeholder#placeholderName]pageName placeholderName pageName [info]buttonName This text is used to populate the mouse-over element description in the toolbox. buttonName [title]buttonName The name of the Placeholder element as it appears in G4 PanelBuilder. The base page name used in the generated TP4 project. Only one page or popup within a Placeholder element can contain an Info button. The Info button contains the page flip information for displaying the Placeholder element and can also contain an optional icon image. This is unused and the button is deleted in the generated TP4 project. The pages and popups in a Placeholder element can contain one or more Title buttons. The text is replaced with the name given to the Placeholder element in the generated TP4 project. The button name will be used in the generated TP4 project.

buttonName

G4 PanelBuilder

21

Creating Templates for G4 PanelBuilder

Optional Template Elements

There are required elements when developing templates but G4 PanelBuilder also supports a series of optional elements that will make your templates more robust. Your templates can have any of the following: Mode Elements - This element is generally used for designating "modes" your system will work in, i.e., "Video Conference Mode" or "Presentation Mode." Additionally, Mode elements can be associated with rooms. Consists of a single page and can contain multiple popups. Only one Mode element can be displayed at a time. Mode Element Specific Conventions
[mode#modeName]pageName modeName pageName [info]buttonName This text is used to populate the mouse-over element description in the toolbox. buttonName [item]buttonName The name of the Mode as it will appear in G4 PanelBuilder. The base page name used in the generated TP4 project. Only one page in a Mode element can contain an Info button. The Info button contains the page flip information for displaying the Mode element and can also contain an optional icon image. Unused; the button is deleted in the generated TP4 project. The page in the Mode element must contain at least one Item button that contains the navigation information. Item buttons are ordered within the Mode element by left-to-right then top-to-bottom. The button name used in the generated TP4 project. Popups in a Mode element can contain one or more Title buttons, whose text is replaced with the name given to the Mode in the generated TP4 project. The button name used in the generated TP4 project.

buttonName [title]buttonName

buttonName

Sub-Navigation Elements - This element is a submenu and can occur on screen with Navigation elements. Consists of at least one popup and can contain multiple popups. Cannot contain pages. Sub-Navigation Element Specific Conventions
[subnav#navName]pageName navName pageName [info]buttonName This text is used to populate the mouseover element description in the toolbox. buttonName [item]buttonName The name of the Sub-Navigation element as it appears in G4 PanelBuilder. The base page name that is used in the generated TP4 project. Only one of the popups in a Sub-Navigation element can contain an Info button, which contains the page flip information for displaying the Sub-Navigation element and can also contain an optional icon image. Unused; the button is deleted in the generated TP4 project. Popups in the Sub-Navigation element must contain at least one Item button that will contain navigation information. Item buttons are ordered in the Navigation element left-to-right then top-to-bottom. The button name used in the generated TP4 project. The popups in a Sub-Navigation element can contain one or more Title buttons. The text within the Title buttons are replaced with the name given to the Sub-Navigation in the generated TP4 project. The button name used in the generated TP4 project.

buttonName [title]buttonName

buttonName

22

G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Splash Elements - This element is a popup that can contain an image, i.e., corporate logo. Consists of at least one popup and can contain multiple popups. Cannot contain pages. Splash Element Specific Conventions
[splash#splashName]pageName splashName pageName [info]buttonName This text is used to populate the mouseover element description in the toolbox. buttonName [title]buttonName The name of the Splash element as it appears in G4 PanelBuilder. The base page name that is used in the generated TP4 project. Only one of the popups in a Splash element can contain an Info button, which contains the page flip information for displaying the Splash element and can also contain an optional icon image. Unused; this button is deleted in the generated TP4 project. Popups in a Splash element can contain one or more Title buttons. The text within the buttons is replaced with the name given to the Splash element in the generated TP4 project. The button name used in the generated TP4 project.

buttonName

Device Elements - This element is the actual device used. For reference, consult AMX templates where we list the most commonly used devices. Consists of one page and can contain multiple popups. Only one Device element can be displayed at a time. Device Element Specific
[device#deviceName]pageName deviceName pageName [info]buttonName This text is used to populate the mouseover element description in the toolbox. buttonName [title]buttonName The name of the Device as it appears in G4 PanelBuilder. The base page name used in the generated TP4 project. Only one page or popup in a Device element can contain an Info button which contains the page flip information for displaying the Device element and can also contain an optional icon image. Unused; the button is deleted in the generated TP4 project. Pages and popups in a Device element can contain one or more Title buttons. The text within the buttons is replaced with the name given to the Device element in the generated TP4 project. The button name used in the generated TP4 project.

buttonName

G4 PanelBuilder

23

Creating Templates for G4 PanelBuilder

Feature Elements - This element resembles the Device element. However, there can only be one Feature element in a panel design, i.e., the "Clean Panel" feature. Consists of one page and can contain multiple popups. Only one Feature element can be displayed at a time. Feature Element Specific Conventions
[feature#featureName]pageName featureName pageName [info]buttonName This text is used to populate the mouseover element description in the toolbox. buttonName [title]buttonName The name of the feature as it appears in G4 PanelBuilder. The base page name that is used in the generated TP4 project. Only one page or popup in a Feature element can contain an Info button, which contains the page flip information for displaying the Feature element and can also contain an optional icon image. Unused; the button is deleted in the generated TP4 project. The pages and popups in the Feature element can contain one or more Title buttons, whose text is replaced with the name given to the Feature in the generated TP4 project. The button name that is used in the generated TP4 project.

buttonName

Sub-Feature Elements - This element represents the "universal" features that appear on many pages, i.e., "volume." Consists of at least one popup and can contain multiple popups. Cannot contain pages. Sub-Feature Element Specific Conventions
[subFeature#subFeatureName]pageName subFeatureName pageName [info]buttonName This text is used to populate the mouseover element description in the toolbox. buttonName [title]buttonName The name of the Sub-Feature element as it appears in G4 PanelBuilder. The base page name that is used in the generated TP4 project. Only one of the pages or popups in a Sub-Feature element can contain an Info button, which contains the page flip information for displaying the Sub-Feature element and can also contain an optional icon image. Unused; the button is deleted in the generated TP4 project. Popups in a Sub-Feature element can contain one or more Title buttons, whose text is replaced with the name given to the Sub-Feature element in the generated TP4 project. The button name that is used in the generated TP4 project.

buttonName

24

G4 PanelBuilder

Creating Templates for G4 PanelBuilder

Rules for Navigating A Template

In addition to the template requirements and required elements there are rules for navigating the templates and template wide conventions you need to heed. When navigating to a Device, Feature or Placeholder element from a Navigation element: Hide all popups on the page for that element. Perform the standard page flip to the page for that element. Show any popups for the element. Show any popups for the linked Sub-Feature, when applicable. Show the Navigation element that is linked to the element. Any Sub-Navigation elements that may have been currently displayed will be hidden.

When navigating to a Device, Feature or Placeholder element from a Sub-Navigation element: Hide all popups on the page for that element. Perform the standard page flip to the page for that element. Show any popups for the element. Show any popups for the linked Sub-Feature, when applicable. Show the Navigation element that is linked to the Sub-Navigation element or chain. For Sub-Navigations the user must set "Hide On Action" to No, then show the Sub-Navigation element that is linked to the element. Otherwise, the Sub-Navigation is not shown. Info buttons are optional and only have to be included within an element if the order the popup pages is shown is important, if not all popup pages should be initially shown, or if an icon is used on the corresponding Navigation or Sub-Navigation button. If the Info button is omitted, popup pages are shown in alphabetical order.

Template Wide Conventions

Text Replacement - The string "[text]" is required on the button wherever text is to be replaced in the output file. The string "[text]" allows you to prepend/post-pend text with characters. If the text on a button to be replaced does not contain '[text]" then it is unchanged. Panel Title* - A template can contain as many buttons named "[panelTitle]" as necessary, they are replaced with the "Job Name" of the panel. Preview Images - A template must contain a main preview image and can also contain a preview image for each element. The main preview image should be named '[preview].jpg" (or .png). The element previews should follow the same naming conventions as their page prefixes, i.e., "[device#DVD].jpg." There can only be one preview image per element.

G4 PanelBuilder

25

Creating Templates for G4 PanelBuilder

AMX Element Naming Conventions

AMX urges you to use the following naming convention to allow for portability between templates. Errors could occur if the elements do not match from template to template. AMX Element Naming Conventions
Device Name Audio Conference Cable Box Camera Cassette Deck CD G4 Computer Control Document Camera Door DSS DVD DVR HVAC - Dual HVAC - Single Lift Light Zone Monitor Pool Screen Security Shade Slide Projector Spa Switcher size Radio TV VCR Video Projector Volume - Dual Volume - Single Feature Name US Weather Maps Mode Names Mode X Example [device#Audio Conference] Audio Conference [device#Cable Box]Cable Box [device#Camera]Camera [device#Cassette Deck]Cassette Deck [device#CD]CD [device#Computer Control]G4CC [device#Document Camera]Document Camera [device#Door]Door [device#DSS]DSS [device#DVD]DVD [device#DVR]DVR [device#HVAC - Dual]HVAC - Dual [device#HVAC - Single]HVAC - Single [device#Lift]Lift [device#Light Zone]Light Zone [device#Monitor]Monitor [device#Pool]Pool [device#Screen]Screen [device#Security]Security [device#Shade]Shade [device#Slide Projector]Slide Projector [device#Spa]Spa [device#Switcher size]Switcher size [device#Radio]Radio [device#TV]TV [device#VCR]VCR [device#Video Projector]Video Projector [device#Volume -Dual]Volume - Dual [device#Volume - Single]Volume - Single Example [feature#US Weather Maps]US Weather Maps Example Description [mode#Mode 3]Mode 3 [mode#Mode x] x = the number of mode options Description [nav#Nav 3]Nav 3 x = the number of navigation options [nav#Nav 3]Nav 3

Navigation Names Example Nav X

26

G4 PanelBuilder

Program Reference

Program Reference
Dialogs
AMX.com Template Library dialog
G4 PanelBuilder project files (*.PB4) derive their style from templates. In addition to making your own templates, you can download AMX created templates. Browsing through online template files is done so through the AMX.com Template Library dialog.
Template Family Thumbnail Template Family Properties

Template Family Panel Types

Cancel Filter Option (Show modified) Samples Install Template Collapse All Families Expand All Families

FIG. 12 AMX.com Template Library dialog

AMX.com Template Library dialog

Template Family Thumbnail Template Family Properties A graphic representation of the panel properties. The name of the selected template family and the number of templates available. Launches the Template Sample Images dialog. Filters the online library to show only templates that differ from what you have already downloaded. Shows all available templates within each family. Closes all expanded template families. Installs the selected template family to your local directory of templates. Closes the AMX.com Template Library.

Template Family Panel Types Panels available for use within the selected family. Samples Show only new or modified templates Expand All Collapse All Install Cancel

G4 PanelBuilder

27

Program Reference

Close Project dialog

If you have made any changes to your project file, close the project and not saved, you will be prompted, The project has been modified. Do you want to save the changes? Select Yes to save and continue closing. Select No to not save the changes and close the project file. Select Cancel to leave the project file open.

Color Schemes dialog

Templates can contain multiple color palettes, allowing you to switch from one color scheme to another within one template. The current scheme is reflected in the element preview. Used either with Chameleon buttons or standalone, you can use a single template that can deliver different predefined color schemes.
Preview Image

Available Color Schemes

FIG. 13 Color Schemes dialog

Color Schemes dialog

Preview Image A sample view of the selected color scheme. are displayed here. OK Cancel Accepts the selected color scheme and closes the window. Does not apply the color scheme change and closes the window. Available Color Schemes All color schemes available for your selected template

28

G4 PanelBuilder

Program Reference

Diagram Preview dialog

The Diagram Preview dialog is a graphic preview of the selected element. The text on the buttons appear as they will in the final panel file. This is useful used in conjunction with Diagram Properties. Diagram Preview dialog
Fit Image Save Close When selected, the panel view will compress to fit within the window. Opens a file save dialog to save a .JPG version of the selected previewed image. Closes the Diagram Preview.

To Clipboard Copies the panel preview to your computer's clipboard.

Diagram Properties dialog

The Diagram Properties dialog allows you to edit some of the text aspects of the elements.
Element Name Node Name Title Connections

FIG. 14 Diagram Properties dialog

Diagram Properties dialog

Element Node Name Title The name of the element selected and the number of selections available. Click in the field to type and edit a new name that will appear on the selected node. This is the title displayed on the panel page and any corresponding buttons the title populates. To change the field with standard ASCII, type directly in the field. To edit the field using Unicode, click on the browse button to launch the Unicode edit window.

Connections The connections displays how many are available and what the displayed name is within the currently selected node. This text is what is displayed on the buttons of the selected panel page. To edit, click in the text field and either begin typing or select the browse button (...). The browse button opens a text entry field that will allow you to see the Unicode Send Command Value. Once you have input the text, click OK to return to the Diagram Properties dialog with the changes or click Cancel to return with no changes. OK Cancel Returns to the Diagram area with changes. Aborts changes and returns to the Diagram area.

G4 PanelBuilder

29

Program Reference

Errors And Warnings Report dialog

You can apply new templates (.TPT files) to preexisting G4 PanelBuilder projects (.PB4 files). The application will notify you in the event there are discrepancies.

FIG. 15 Errors And Warnings Report dialog

An error will keep the element from working while warnings work but are replaced with the element closest matching the original element. Click Close to confirm and continue to the project file.

Generate TPDesign4 Project dialog

The Generate TPDesign4 dialog is a typical Windows dialog. Browse to where you want the generated project file saved. Select Cancel to return to the application. There is one difference within this dialog. In the bottom left is a checkbox called, Open project in TPDesign4. Once the file has been generated, TPDesign4 will launch and open your newly created .TP4 file.

30

G4 PanelBuilder

Program Reference

Install Templates from File dialog

The Install Templates from File dialog is similar to the AMX.com Template Library dialog.
Template Family Properties

Template Thumbnail

Cancel Samples Filter Option (Show modified) Install Template Collapse All Families Expand All Families

FIG. 16 Install Templates from File dialog

Install Templates from File dialog

Template Family Thumbnail Template Family Properties A graphic representation of the panel properties. The name of the selected template family and the number of templates available. Launches the Template Sample Images dialog. Filters the view to show only templates that differ from what you have already available. Shows all available templates within each family. Closes all expanded template families. Installs the selected template family to your available directory of templates. Closes the Install Template from File dialog.

Template Family Panel Types Panels available for use within the selected family. Samples Show only new or modified templates Expand All Collapse All Install Cancel

New From File dialog

The New From File dialog is a typical Windows dialog. Browse to the desired G4 PanelBuilder project file (*.PB4). Select and click Open. If you do not find the file, select Cancel to return to the application.

G4 PanelBuilder

31

Program Reference

New Project dialog

With the New Project dialog you can create a new job name and establish the desired panel type and resolution. Additionally, the New Project dialog allows you to browse through available local template files and confirm if they fit selected panel types.
Panel Type Panel Resolution Job Name Panel Type Description

Template Family Thumbnail

Template Properties

FIG. 17 New Project dialog

New Project dialog

Job Name Panel Type Panel Resolution Panel Type Description Click within the text field to type the job name of the new project. A drop down list of AMX G4 panels. Click on the panel you would like to design for use. A drop down list of available resolutions for your selected panel type. A thumbnail image and name of your selected panel type.

Template Family Thumbnail Thumbnail graphics for templates that meet the criteria established in the panel type and resolution fields. If no suitable templates are available the message, No Compatible Templates For Selected Panel Type, will appear. An exclamation point will appear in the top right of a thumbnail that can be used for the panel type but was not originally designed for that use. Some images within the panel pages could require alterations. Template Properties The template properties are: Template family file name Designer - Name of the individual that created the template Description - A brief note or special interest for the selected template appears here. Revision - The version number of the selected template. Elements - A expandable selection of all elements with their number of available selections. Previews button OK button Cancel button Launches the Template Sample Images dialog. Accepts selections made and opens the project into the G4 PanelBuilder Application Interface area. Cancels opening a new project file and returns to the applications.

32

G4 PanelBuilder

Program Reference

Open Project dialog

The Open Project dialog is a typical Windows dialog. Browse to the desired G4 PanelBuilder project file (*.PB4). Select and click Open. If you do not find the file, select Cancel to return to the application.

Project Properties dialog

Project Properties is a resource for checking the template in use with panel type and resolution. This information is read-only. You can also add your own information within the Project Properties.
Template File Name Panel Type Job Name Dealer ID Purchase Order Job Comments

Panel Resolution Designer ID Sales Order

File Version

File Protection Unicode Font Password

Password Confirmation

FIG. 18 Project Properties dialog

Project Properties dialog

Read-only information: Template File Name The name of the .TPT file currently open. Panel Type Resolution Job Name Dealer ID Purchase order Job comments Protection The panel type the project is designed to fit. The resolution the project is designed to fit. Click in this field to type and edit the job name. Click in this field to type and edit the Dealer ID. (this field is not necessary to create a panel file. Click in this field to type and edit the purchase order information. (this field is not necessary to create a panel file.) Click in this field to type and edit any extra information concerning the panel file. (this field is not necessary to create a panel file.) A drop-down list containing, none, read-only and locked. None has no password security. Both read-only and locked enable the Password and Confirm fields when selected. Read-only allows for viewing the panel file while locked does not allow for viewing or editing of project files. (this field is not necessary to create a panel file.) Click in this field to type and edit the password. (this field is not necessary to create a panel file.) Click in this field to re- type the password. (this field is not necessary to create a panel file.) G4 PanelBuilder supports the use of Unicode within the templates. If Unicode characters are specified but the font utilized within the template does not support them, a replacement font is used. You designate the replacement font in this list. Click in this field to type and edit the file revision number. (this field is not necessary to create a panel file.) Click in this field to type and edit the sales order information. (this field is not necessary to create a panel file.) Click in this field to type and edit the Designer ID. (this field is not necessary to create a panel file.)

User defined information:

Password Confirm Unicode Font

File Revision Sales order Designer ID

G4 PanelBuilder

33

Program Reference

Replace Template dialog

When installing .TPT files from AMX.com G4 PanelBuilder will first check to see if the file already exists locally. The Replace Template dialog indicates the file is found. You can check the dates to see if they match or if one is older than the other.
.TPT Currently on your computer .TPT available on AMX.com

FIG. 19 Replace Template dialog

Replace Template dialog

Yes No No All Abort Confirms the replacement of the .TPT file on a panel-by-panel basis. Denies the replacement of the .TPT file on a panel-by-panel basis. Denies the replacement of all .TPT files at one time. Cancels the template import at the point abort is chosen. Any previous templates you selected Yes for are replaced regardless of the Abort selection. Yes All Confirms the replacement of all .TPT files at one time.

Save As dialog
The Save As dialog is a typical Windows dialog. Browse to where you want the project file saved. Select Cancel to return to the application. There is one difference within this dialog. In the bottom left is a checkbox called, Package templates with project file. When saving a G4 PanelBuilder project file, check this option to save the template with the project file. This embeds the .TPT file with the .PB4 file. This feature allows you to transport .PB4 files to other computers that have G4 PanelBuilder without concern for the template file (*.TPT). When loading the .PB4 file and the .TPT file isn't found, G4 PanelBuilder installs the .TPT file. When loading the .PB4 file and the .TPT file is found, G4 PanelBuilder uses the resident .TPT file. When loading the .PB4 file and the .TPT file is found but there are differences, G4 PanelBuilder will prompt you for which .TPT file to use.

34

G4 PanelBuilder

Program Reference

Template Manager dialog

The template manager allows you quick access to adding and removing templates locally.
Template File Name

Template Designer Available Panel Type Templates

Template Samples Remove Template Install Templates

Expand and Collapse Template Families

FIG. 20 Template Manager dialog

Template Manager dialog

Template file name The name of the selected template family and the number of templates available. Designer Templates Install Remove Samples Expand All Collapse All Description Revision Last Save Elements Designer of the selected template. The individual panel type templates available within the selected template family. Provides a drop down selection of From AMX.com and From File. Removes the selected template family from your local directory. Launches the Template Sample Images dialog. Shows all available templates within each family. Closes all expanded template families. A brief note or special interest for the selected template appears here. The version number of the selected template. The date the selected template was last saved. A expandable selection of all elements with their number of available selections.

When viewing an individual template within a family, more information is available:

G4 PanelBuilder

35

Program Reference

Template Sample Images dialog

When creating a new G4 PanelBuilder file (*.PB4) you need to assign a template file to it. Template Manager allows you to preview sample images before deciding which one to use. The dialog has a screen view of each page with a left-right, scroll navigation below it. Beneath the scroll navigation is: Template Sample Images dialog
< / > buttons Navigates left and right between the panel samples Fit Image Close Toggles the sample image from default resolution size to fit within the dialog. Closes the Template Sample Images dialog.

Unicode Edit Window

G4 PanelBuilder supports the use of Unicode text in place of standard ASCII text. The Unicode can only be edited through the Unicode Edit window.

Text Field

Unicode Value

FIG. 21 Unicode Edit Window

Unicode Edit Window

Text Field OK Cancel Select, type and edit within this field. Accepts the changes and returns to the properties. Closes the window without making changes. Unicode Value This field displays the Unicode equivalent of what you have entered into the Text field.

36

G4 PanelBuilder

Program Reference

Context Menus
Diagram Area Context Menu
The Diagram area context menu is a quick list of commonly used functions. To access the context menu, rightclick within the Diagram area. Diagram Area Context Menu
Add Element Properties Preview Delete Snap To Grid Zoom Out Zoom In Zoom A complete list of available elements within your selected template. Select any element to have it placed within the Diagram area. Launches the Diagram Properties dialog. This feature views the properties of the selected element within the Diagram area. Launches the Diagram Preview dialog. Deletes the element currently selected in the Diagram area. Locks all element placements to grid lines. Decreases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. Increases the magnification of the diagram area. Increments are 150%, 125%, 100%, 75% and 50% of work area. A list of available increments to zoom into or out of the diagram area. Click on the desired magnification to implement.

Copy Snapshot To Clipboard Copies only the diagram area to your computer's clipboard.

Toolbox Context Menu

Right-click on any of the elements listed within the toolbox to access the toolbox context menu. The options available within this context menu are also found in the Toolbox menu. Toolbox Context Men
Add Element To Diagram Element Sample Image Adds the selected element to the Diagram area. Launches a sample screen shot graphic of the selected element. Remove All Instances From Diagram Removes all instances of the selected element from the Diagram area.

View Context Menu

Right-click anywhere on the menu or toolbar area to access the View context menu. You can toggle different aspects of the G4 PanelBuilder Application Interface on and off. The same properties can be found in the View menu. View Context Menu
Toolbar Toolbox Status Bar A check next to this item indicates it is visible. Click to remove the toolbar. A check next to this item indicates it is visible. Click to remove the toolbox. A check next to this item indicates it is visible. Click to remove the status bar. Default (Windows 2000) Office XP Office 2003 Tasks Pane A check next to this item indicates it is visible. Click to remove the tasks pane.

Visual Style A list of visual appearances for the G4 PanelBuilder. Select one of the following:

G4 PanelBuilder

37

Program Reference

38

G4 PanelBuilder

Program Reference

G4 PanelBuilder

39

Its Your World - Take Control

3000 RESEARCH DRIVE, RICHARDSON, TX 75082 USA 800.222.0193 469.624.8000 469-624-7153 fax 800.932.6993 technical support www.amx.com

12/08

2008

AMX. All rights reserved. AMX and the AMX logo are registered trademarks of AMX. AMX reserves the right to alter specifications without notice at any time.