Page 1
Operation/Reference Guide
G4 PanelBuilder
Software
Last Revised: 12/09/2008
Page 2
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.
Page 3
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
i
Page 4
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
Page 5
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
Page 6
Table of Contents
iv
G4 PanelBuilder
Page 7
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).
G4 PanelBuilder Overview
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
1
Page 8
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.
Menu
Bar
Toolbar
Toolbox
Status
Bar
Instance Counter
Diagram Area
Tasks
Pane
Quick
Links
FIG. 1 G4 PanelBuilder Application Interface
G4 PanelBuilder Application Interface
Menu Bar The menu bar is the location of all functions for G4 PanelBuilder.
Toolbar The toolbar contains icons for the commonly used functions.
Toolbox All elements available within a selected template reside in the toolbox. The toolbox is only
Status Bar In addition to giving you the current status of G4 PanelBuilder, i.e., Ready. The status bar
Instance Counter The instance counter tracks and displays the number of times an element is used within the
Diagram Area The Diagram area is the graphical representation of the flow your panel file will follow. After
Tasks Pane The tasks pane is a collection of links to commonly used functions. In addition to opening
Quick Links Located within the Tasks Pane is a small sub-section quick links. These links allow you
available when a template is open.
also provides a brief description of toolbar and menu items via mouse over.
current project.
pulling the elements from the Toolbox you can connect and develop the elements.
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.
quick access to adding and managing templates within G4 PanelBuilder.
2
G4 PanelBuilder
Page 9
G4 PanelBuilder Overview
File Menu
The File menu serves as a location for file management, project information and template management.
File Menu
New Launches the New Project dialog.
New From File Launches the New From File dialog.
Open Launches the Open Project dialog.
Close Closes the project currently open.
Save Saves the current project. If the project has not been previously saved it will
launch the Save As dialog.
Save As Launches the Save As dialog.
Generate TPDesign4 Project Launches the Generate TPDesign4 Project dialog.
Install Templates From
AMX.com
Install Templates From File Launches the Install Templates from File dialog.
Template Manager Launches the Template Manager dialog.
Most Recently Used List A list of most recently opened project file names.
Exit Closes the G4 PanelBuilder application.
When an internet connection is present, connects to AMX.com and launches
the AMX.com Template Library dialog.
Edit Menu
The Edit menu governs the actions within the Diagram area.
Edit Menu
Undo Undoes action taken in diagram area. Undo does not apply to text changes within elements.
Redo 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 Launches the Project Properties dialog.
Project Template Sample Images Launches the Template Sample Images dialog.
Color Schemes Launches the Color Schemes dialog.
Toolbox Menu
The Toolbox menu is a set of features for interacting with the Toolbox area.
Toolbox Menu
Add Element To Diagram Adds the element currently selected within the Toolbox to the Diagram area.
Remove All Instances From
Diagram
Element Preview Launches the Templates Sample Images dialog with the currently selected ele-
Removes all instances of the currently selected element from the Diagram
area.
ment shown.
G4 PanelBuilder
3
Page 10
G4 PanelBuilder Overview
Diagram Menu
The Diagram menu interacts directly with the Diagram area.
Diagram Menu
Add Element A complete list of available elements within your selected template. Select any
Properties Launches the Diagram Properties dialog. This feature views the properties of
Preview Launches the Diagram Preview dialog.
Show Grid Shows the grid in the Diagram area.
Snap To Grid Locks all element placements to grid lines.
Zoom Out Decreases the magnification of the diagram area. Increments are 150%, 125%,
Zoom In Increases the magnification of the diagram area. Increments are 150%, 125%,
Zoom A list of available increments to zoom into or out of the diagram area. Click on
Copy Snapshot To Clipboard Copies only the diagram area to your computer's clipboard.
View Menu
element to have it placed within the Diagram area.
the selected element within the Diagram area.
100%, 75% and 50% of work area.
100%, 75% and 50% of work area.
the desired magnification to implement.
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 Launches the G4 PanelBuilder help, Contents section.
AMX Training Demo Connects to AMX.com for the online demo for using G4 PanelBuilder.
Web Update 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.
4
G4 PanelBuilder
Page 11
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
Entering
Node
Connection Line
Element
FIG. 2 Diagram Area
Diagram Area
Entering Node This node receives the connection line from another element.
Exiting Node This node connects out to another element.
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
Toolbar
FIG. 3
G4 PanelBuilder
5
Page 12
G4 PanelBuilder Overview
Toolbar
New Launches the New Project dialog.
New From File Launches the New From File dialog.
Open Launches the Open Project dialog.
Save Saves the current project. If the project has not been previously saved it will
Generate TPDesign4 Project Launches the Generate TPDesign4 Project dialog.
Delete Deletes the element currently selected in the Diagram area.
Undo Undoes action taken in diagram area. Undo does not apply to text changes
Redo Reverses the undo action taken within the diagram area.
Color Schemes Launches the Color Schemes dialog.
Zoom Out Decreases the magnification of the diagram area. Increments are 150%, 125%,
Zoom In Increases the magnification of the diagram area. Increments are 150%, 125%,
Copy Snapshot To Clipboard Copies only the diagram area to your computer's clipboard.
Template Manager Launches the Template Manager dialog.
Tasks Pane
launch the Save As dialog.
within elements.
100%, 75% and 50% of work area.
100%, 75% and 50% of work area.
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
Tasks Pane
FIG. 4
Tasks Pane
Recently Opened Projects A list of file names for recently opened existing projects.
Open Project Launches the Open Project dialog.
Recently Opened Templates A list of file names for recently opened templates.
New File Launches the New Project dialog.
New from File Launches the New From File dialog.
6
G4 PanelBuilder
Page 13
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 Launches the Install Templates From File dialog.
Template Manager Launches the Template Manager dialog.
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.
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)
Toolbox
FIG. 6
Element Sections
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
7
Page 14
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:
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 > (any of the panes listed; a check mark indicates the pane is in view) Toolbar, Tasks
Pane, Toolbox or Status Bar.
Select View > Visual Style and select from the following
Default
Office XP®
Office 2003®
8
G4 PanelBuilder
Page 15
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. Launch the G4 PanelBuilder application.
2. Select File > New. This launches the New Project dialog.
3. Type the Job Name in the corresponding field.
4. Select the Panel Type and Resolution from the drop down menus.
5. 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.
Basic Operations
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
9
Page 16
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
10
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.
G4 PanelBuilder
Page 17
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. Select File > Save. If this is the first instance of a save for your project, the Save As dialog launches.
2. Type the File name in the field provided.
3. Locate the directory you would like to save within.
4. 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. Select File > Save As to launch the Save As dialog.
2. Type the File name in the field provided.
3. Locate the directory you would like to save within.
4. 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
Page 18
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. Select File > Template Manager to launch the Template Manager dialog.
2. Double-click on the thumbnail of a template family.
3. Select a thumbnail for one of the panel types within the family.
4. 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. Select File > Template Manager to open the Template Manager dialog.
2. In the bottom left corner of the dialog, select Install.
3. Select From AMX.com from the drop-down list to launch the AMX.com Template Library dialog.
4. Select a thumbnail of one of the template families.
5. 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:
Ye s - Confirms the replacement of the .TPT file on a panel-by-panel basis.
Yes A l l - 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
Page 19
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. Open the Template Manager dialog by selecting File > Template Manager.
2. Select the thumbnail of the template to be removed.
3. Click Remove at the bottom of the window.
4. 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
Page 20
Basic Operations
Creating A New Project from File
You can change templates attributed to projects and create a new project as a result.
1. Select File > New From File to launch the New From File dialog.
2. Open your desired project file (*.PB4).
3. The next window to open is the New project dialog. Select the new template to be used with the project.
4. 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. Select the element within the diagram area.
2. Select Diagram > Properties to open the Diagram Properties dialog.
3. Click on the browse button (...) to launch the Unicode Edit dialog widow.
4. Type the Unicode within the text field and the equivalent is displayed below.
5. Click OK to close the Unicode Edit dialog.
6. Click OK to close the Diagram Properties dialog.
14
G4 PanelBuilder
Page 21
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
Page 22
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
Page 23
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 Panel Type
640x480 MVP-7500
TPI4
800x600 MVP-8400
CA12
CV12
TPI4
800x480 CV7
CV10
CV10/PB
1024x768 CV15
CA15
TPI4
1280x1024 TPI4
1280x768 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
Page 24
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
18
TPDesign4 Workspace
G4 PanelBuilder
Page 25
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
Within TPDesign4, select Panel > Edit Palettes to open the Edit Palettes dialog.
1.
2. Select Rename to edit the name of the palette.
3. Define the colors used in the palette.
4. Repeat steps 2 and 3 for as many color schemes you want available within the template file.
5. 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. Set Element Type to Palette.
4. The Name must match the name you used in step 2 of Define The Color Scheme.
5. You can set the Scale, File Format and Compression at your discretion.
6. Click OK.
You can now export the file as a template, open and use it within G4 PanelBuilder.
G4 PanelBuilder
19
Page 26
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.
20
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
.
G4 PanelBuilder
Page 27
Creating Templates for G4 PanelBuilder
Navigation Element Specific Conventions
[nav#navName]pageName
navName The name of the Navigation as it will appear within G4 PanelBuilder.
pageName The base page name that will be used in the generated TP4 project.
[info]buttonName
This text is used to populate
the mouse-over element
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.
description in the toolbox.
buttonName This is unused and the button is deleted in the generated TP4 project.
[item]buttonName 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.
buttonName This is the button name used in the generated TP4 project.
[title]buttonName 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.
buttonName This is the button name used in the generated TP4 project.
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 The name of the Placeholder element as it appears in G4
PanelBuilder.
pageName The base page name used in the generated TP4 project.
[info]buttonName
This text is used to populate the mouse-over
element description in the toolbox.
buttonName This is unused and the button is deleted in the generated TP4
[title]buttonName The pages and popups in a Placeholder element can contain
buttonName The button name will be 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.
project.
one or more Title buttons. The text is replaced with the name
given to the Placeholder element in the generated TP4 project.
G4 PanelBuilder
21
Page 28
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 The name of the Mode as it will appear in G4 PanelBuilder.
pageName The base page name used in the generated TP4 project.
[info]buttonName
This text is used to populate the
mouse-over element description in the toolbox.
buttonName Unused; the button is deleted in the generated TP4 project.
[item]buttonName The page in the Mode element must contain at least one Item button that
buttonName The button name used in the generated TP4 project.
[title]buttonName Popups in a Mode element can contain one or more Title buttons, whose
buttonName The button 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.
contains the navigation information. Item buttons are ordered within the
Mode element by left-to-right then top-to-bottom.
text is replaced with the name given to the Mode in the generated TP4 project.
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 The name of the Sub-Navigation element as it appears in G4 PanelBuilder.
pageName The base page name that is used in the generated TP4 project.
[info]buttonName
This text is used to populate the
mouseover element description
in the toolbox.
buttonName Unused; the button is deleted in the generated TP4 project.
[item]buttonName Popups in the Sub-Navigation element must contain at least one Item button
buttonName The button name used in the generated TP4 project.
[title]buttonName The popups in a Sub-Navigation element can contain one or more Title
buttonName The button name 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.
that will contain navigation information. Item buttons are ordered in the
Navigation element left-to-right then top-to-bottom.
buttons. The text within the Title buttons are replaced with the name given to
the Sub-Navigation in the generated TP4 project.
22
G4 PanelBuilder
Page 29
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 The name of the Splash element as it appears in G4 PanelBuilder.
pageName The base page name that is used in the generated TP4 project.
[info]buttonName
This text is used to populate the
mouseover element description in
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.
the toolbox.
buttonName Unused; this button is deleted in the generated TP4 project.
[title]buttonName 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.
buttonName The button name used in the generated TP4 project.
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 The name of the Device as it appears in G4 PanelBuilder.
pageName The base page name used in the generated TP4 project.
[info]buttonName
This text is used to populate the
mouseover element description in
the toolbox.
buttonName Unused; the button is deleted in the generated TP4 project.
[title]buttonName Pages and popups in a Device element can contain one or more Title
buttonName The button 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.
buttons. The text within the buttons is replaced with the name given to the
Device element in the generated TP4 project.
G4 PanelBuilder
23
Page 30
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 The name of the feature as it appears in G4 PanelBuilder.
pageName The base page name that is used in the generated TP4 project.
[info]buttonName
This text is used to populate the
mouseover element description in
the toolbox.
buttonName Unused; the button is deleted in the generated TP4 project.
[title]buttonName The pages and popups in the Feature element can contain one or more
buttonName The button name that is used in the generated TP4 project.
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.
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.
Title buttons, whose text is replaced with the name given to the Feature
in the generated TP4 project.
Sub-Feature Element Specific Conventions
[subFeature#subFeatureName]pageName
subFeatureName The name of the Sub-Feature element as it appears in G4
PanelBuilder.
pageName The base page name that is used in the generated TP4 project.
[info]buttonName
This text is used to populate the mouseover
element description in the toolbox.
buttonName Unused; the button is deleted in the generated TP4 project.
[title]buttonName Popups in a Sub-Feature element can contain one or more Title
buttonName The button 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.
buttons, whose text is replaced with the name given to the
Sub-Feature element in the generated TP4 project.
24
G4 PanelBuilder
Page 31
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
Page 32
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 Example
Audio Conference [device#Audio Conference] Audio Conference
Cable Box [device#Cable Box]Cable Box
Camera [device#Camera]Camera
Cassette Deck [device#Cassette Deck]Cassette Deck
CD [device#CD]CD
G4 Computer Control [device#Computer Control]G4CC
Document Camera [device#Document Camera]Document Camera
Door [device#Door]Door
DSS [device#DSS]DSS
DVD [device#DVD]DVD
DVR [device#DVR]DVR
HVAC - Dual [device#HVAC - Dual]HVAC - Dual
HVAC - Single [device#HVAC - Single]HVAC - Single
Lift [device#Lift]Lift
Light Zone [device#Light Zone]Light Zone
Monitor [device#Monitor]Monitor
Pool [device#Pool]Pool
Screen [device#Screen]Screen
Security [device#Security]Security
Shade [device#Shade]Shade
Slide Projector [device#Slide Projector]Slide Projector
Spa [device#Spa]Spa
Switcher size
Radio [device#Radio]Radio
TV [device#TV]TV
VCR [device#VCR]VCR
Video Projector [device#Video Projector]Video Projector
Volume - Dual [device#Volume -Dual]Volume - Dual
Volume - Single [device#Volume - Single]Volume - Single
Feature Name Example
US Weather Maps [feature#US Weather Maps]US Weather Maps
Mode Names Example Description
Mode X [mode#Mode 3]Mode 3 [mode#Mode x] x = the number of mode
Navigation Names Example Description
Nav X [nav#Nav 3]Nav 3 [nav#Nav 3]Nav 3 x = the number of
[device#Switcher size]Switcher size
options
navigation options
26
G4 PanelBuilder
Page 33
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.
Program Reference
Template Family Thumbnail
Filter Option
(Show modified)
Samples
FIG. 12 AMX.com Template Library dialog
Collapse All Families
Expand All Families
Template Family Properties
Te mp l a t e
Family
Panel Types
Cancel
Install Template
AMX.com Template Library dialog
Template Family Thumbnail A graphic representation of the panel properties.
Template Family Properties The name of the selected template family and the number of templates
Template Family Panel Types Panels available for use within the selected family.
Samples Launches the Template Sample Images dialog.
Show only new or modified
templates
Expand All Shows all available templates within each family.
Collapse All Closes all expanded template families.
Install Installs the selected template family to your local directory of templates.
Cancel Closes the AMX.com Template Library.
available.
Filters the online library to show only templates that differ from what you have
already downloaded.
G4 PanelBuilder
27
Page 34
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 Ye s 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.
Available Color Schemes All color schemes available for your selected template
are displayed here.
OK Accepts the selected color scheme and closes the window.
Cancel Does not apply the color scheme change and closes the window.
28
G4 PanelBuilder
Page 35
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 When selected, the panel view will compress to fit within the window.
Save Opens a file save dialog to save a .JPG version of the selected previewed image.
To Clipboard Copies the panel preview to your computer's clipboard.
Close Closes the Diagram Preview.
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 The name of the element selected and the number of selections available.
Node Name Click in the field to type and edit a new name that will appear on the selected node.
Title 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 Returns to the Diagram area with changes.
Cancel Aborts changes and returns to the Diagram area.
G4 PanelBuilder
29
Page 36
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
Page 37
Install Templates from File dialog
The Install Templates from File dialog is similar to the AMX.com Template Library dialog.
Te mp l a t e
Te mp l a te
Thumbnail
Family
Properties
Cancel
Program Reference
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 A graphic representation of the panel properties.
Template Family Properties The name of the selected template family and the number of templates
available.
Template Family Panel Types Panels available for use within the selected family.
Samples Launches the Template Sample Images dialog.
Show only new or modified
templates
Filters the view to show only templates that differ from what you have already
available.
Expand All Shows all available templates within each family.
Collapse All Closes all expanded template families.
Install Installs the selected template family to your available directory of templates.
Cancel Closes the Install Template from File dialog.
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
Page 38
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
Panel Type
Job Name
Description
Template Family
Thumbnail
Te mp l a t e
Properties
FIG. 17 New Project dialog
New Project dialog
Job Name Click within the text field to type the job name of the new project.
Panel Type A drop down list of AMX G4 panels. Click on the panel you would like to design
Panel Resolution A drop down list of available resolutions for your selected panel type.
Panel Type Description 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
Template Properties The template properties are:
Previews button Launches the Template Sample Images dialog.
OK button Accepts selections made and opens the project into the G4 PanelBuilder
Cancel button Cancels opening a new project file and returns to the applications.
for use.
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 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.
Application Interface area.
32
G4 PanelBuilder
Page 39
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.
Te mp l at e
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 The panel type the project is designed to fit.
Resolution The resolution the project is designed to fit.
User defined information:
Job Name Click in this field to type and edit the job name.
Dealer ID Click in this field to type and edit the Dealer ID. (this field is not necessary to create a
panel file.
Purchase order Click in this field to type and edit the purchase order information. (this field is not
necessary to create a panel file.)
Job comments 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.)
Protection 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.)
Password Click in this field to type and edit the password. (this field is not necessary to create a
panel file.)
Confirm Click in this field to re- type the password. (this field is not necessary to create a panel
file.)
Unicode Font G4 PanelBuilder supports the use of Unicode within the templates. If Unicode charac-
ters 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.
File Revision Click in this field to type and edit the file revision number. (this field is not necessary to
create a panel file.)
Sales order Click in this field to type and edit the sales order information. (this field is not necessary
to create a panel file.)
Designer ID Click in this field to type and edit the Designer ID. (this field is not necessary to create a
panel file.)
G4 PanelBuilder
33
Page 40
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
FIG. 19 Replace Template dialog
.TPT
available on
AMX.com
Replace Template dialog
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.
Abort Cancels the template import at the point abort is chosen. Any previous templates you selected Ye s for
are replaced regardless of the Abort selection.
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
Page 41
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
Program Reference
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 Designer of the selected template.
Templates The individual panel type templates available within the selected template family.
Install Provides a drop down selection of From AMX.com and From File.
Remove Removes the selected template family from your local directory.
Samples Launches the Template Sample Images dialog.
Expand All Shows all available templates within each family.
Collapse All Closes all expanded template families.
When viewing an individual template within a family, more information is available:
Description A brief note or special interest for the selected template appears here.
Revision The version number of the selected template.
Last Save The date the selected template was last saved.
Elements A expandable selection of all elements with their number of available selections.
G4 PanelBuilder
35
Page 42
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 Toggles the sample image from default resolution size to fit within the dialog.
Close 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 Select, type and edit within this field.
Unicode Value This field displays the Unicode equivalent of what you have entered into the Text field.
OK Accepts the changes and returns to the properties.
Cancel Closes the window without making changes.
36
G4 PanelBuilder
Page 43
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 A complete list of available elements within your selected template. Select any
element to have it placed within the Diagram area.
Properties Launches the Diagram Properties dialog. This feature views the
properties of the selected element within the Diagram area.
Preview Launches the Diagram Preview dialog.
Delete Deletes the element currently selected in the Diagram area.
Snap To Grid Locks all element placements to grid lines.
Zoom Out Decreases the magnification of the diagram area. Increments are 150%, 125%,
100%, 75% and 50% of work area.
Zoom In Increases the magnification of the diagram area. Increments are 150%, 125%,
100%, 75% and 50% of work area.
Zoom 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 Adds the selected element to the Diagram area.
Remove All Instances From Diagram Removes all instances of the selected element from the Diagram area.
Element Sample Image Launches a sample screen shot graphic of the selected element.
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 A check next to this item indicates it is visible. Click to remove the toolbar.
Tasks Pane A check next to this item indicates it is visible. Click to remove the tasks pane.
Toolbox A check next to this item indicates it is visible. Click to remove the toolbox.
Status Bar A check next to this item indicates it is visible. Click to remove the status bar.
Visual Style A list of visual appearances for the G4 PanelBuilder. Select one of the following:
• Default (Windows 2000®)
•Office XP®
• Office 2003®
G4 PanelBuilder
37
Page 44
Program Reference
38
G4 PanelBuilder
Page 45
Program Reference
G4 PanelBuilder
39
Page 46
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
It’s Your World - Take Control™
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.
©
12/08
Loading...