AMX Corporation warrants its products to be free of defects in material and workmanship under normal use for three
(3) years from the date of purchase from AMX Corporation, with the following exceptions:
•Electroluminescent and LCD Control Panels are warranted for three (3) years, except for the display and touch
overlay components that are warranted for a period of one (1) year.
•Disk drive mechanisms, pan/tilt heads, power supplies, and MX Series products are warranted for a period of one
(1) year.
•AMX Lighting products are guaranteed to switch on and off any load that is properly connected to our lighting
products, as long as the AMX Lighting products are under warranty. AMX Corporation does guarantee the
control of dimmable loads that are properly connected to our lighting products. The dimming performance or
quality cannot be guaranteed due to the random combinations of dimmers, lamps and ballasts or transformers.
•Unless otherwise specified, OEM and custom products are warranted for a period of one (1) year.
•AMX Software is warranted for a period of ninety (90) days.
•Batteries and incandescent lamps are not covered under the warranty.
This warranty extends only to products purchased directly from AMX Corporation or an Authorized AMX Dealer.
All products returned to AMX require a Return Material Authorization (RMA) number. The RMA number is
obtained from the AMX RMA Department. The RMA number must be clearly marked on the outside of each box.
The RMA is valid for a 30-day period. After the 30-day period the RMA will be cancelled. Any shipments received
not consistent with the RMA, or after the RMA is cancelled, will be refused. AMX is not responsible for products
returned without a valid RMA number.
AMX Corporation is not liable for any damages caused by its products or for the failure of its products to perform.
This includes any lost profits, lost savings, incidental damages, or consequential damages. AMX Corporation is not
liable for any claim made by a third party or by an AMX Dealer for a third party.
This limitation of liability applies whether damages are sought, or a claim is made, under this warranty or as a tort
claim (including negligence and strict product liability), a contract claim, or any other claim. This limitation of
liability cannot be waived or amended by any person. This limitation of liability will be effective even if AMX Corporation or an authorized representative of AMX Corporation has been advised of the possibility of any such damages.
This limitation of liability, however, will not apply to claims for personal injury.
Some states do not allow a limitation of how long an implied warranty last. Some states do not allow the limitation or
exclusion of incidental or consequential damages for consumer products. In such states, the limitation or exclusion of
the Limited Warranty may not apply. This Limited Warranty gives the owner specific legal rights. The owner may
also have other rights that vary from state to state. The owner is advised to consult applicable state laws for full
determination of rights.
EXCEPT AS EXPRESSLY SET FORTH IN THIS WARRANTY, AMX CORPORATION MAKES NO
OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. AMX CORPORATION
EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED IN THIS LIMITED WARRANTY. ANY
IMPLIED WARRANTIES THAT MAY BE IMPOSED BY LAW ARE LIMITED TO THE TERMS OF THIS
LIMITED WARRANTY.
Software License and Warranty Agreement
LICENSE GRANT.
AMX grants to Licensee the non-exclusive right to use the AMX Software in the manner described in this License. The AMX Software
is licensed, not sold. The AMX Software consists of generally available programming and development software, product
documentation, sample applications, tools and utilities, and miscellaneous technical information. Please refer to the README.TXT
file on the compact disc or download for further information regarding the components of the AMX Software. The AMX Software is
subject to restrictions on distribution described in this License Agreement. YOU MAY NOT LICENSE, RENT, OR LEASE THE AMX
SOFTWARE. You may not reverse engineer, decompile, or disassemble the AMX Software.
INTELLECTUAL PROPERTY.
The AMX Software is owned by AMX and is protected by United States copyright laws, patent laws, international treaty provisions,
and/or state of Texas trade secret laws. Licensee may make copies of the AMX Software solely for backup or archival purposes.
Licensee may not copy the written materials accompanying the AMX Software.
TERMINATION. AMX RESERVES THE RIGHT, IN ITS SOLE DISCRETION, TO TERMINATE THIS LICENSE FOR
ANY REASON AND UPON WRITTEN NOTICE TO LICENSEE.
In the event that AMX terminates this License, 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 PRE-RELEASE CODE and such
code may not be at the level of performance, compatibility and functionality of the final code. The PRE-RELEASE CODE may not
operate correctly and may be substantially modified prior to final release or certain features may not be generally released. AMX is
not obligated to make or support any PRE-RELEASE CODE. ALL PRE-RELEASE CODE IS PROVIDED "AS IS" WITH NO
WARRANTIES.
LIMITED WARRANTY.
AMX warrants that the AMX Software will perform substantially in accordance with the accompanying written materials for a period of
ninety (90) days from the date of receipt. AMX DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, WITH REGARD TO THE AMX SOFTWARE. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS.
Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to
you after the expiration of the ninety (90) day Limited Warranty period are not covered by any warranty or condition, express, implied
or statutory.
LICENSEE REMEDIES.
AMX's entire liability and your exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX's
Limited Warranty and which is returned to AMX. This Limited Warranty is void if failure of the AMX Software has resulted from
accident, abuse, or misapplication. Any replacement AMX Software will be warranted for the remainder of the original warranty period
or thirty (30) days, whichever is longer. Outside the United States, these remedies may not available.
NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL AMX BE LIABLE FOR ANY DAMAGES
WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR
INABILITY TO USE THIS AMX SOFTWARE, EVEN IF AMX HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
BECAUSE SOME STATES/COUNTRIES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR
CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU.
U.S. GOVERNMENT RESTRICTED RIGHTS. The AMX Software is provided with RESTRICTED RIGHTS. Use, duplication, or
disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and
Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software
Restricted Rights at 48 CFR 52.227-19, as applicable.
This Agreement replaces and supercedes all previous AMX Software License Agreements and is governed by the laws
of the State of Texas, and all disputes will be resolved in the courts in Collin County, Texas, USA. Should you have any
questions concerning this Agreement, or if you desire to contact AMX for any reason, please write: AMX Corporation,
PictureFrame allows for the management of images displayed on G4 panels. Images located on a
local server or the internet are displayed on panels, made possible with dynamic images.
Key functionality of PictureFrame includes:
Overview
HTTP Local Server - The server acts as an HTTP host where it receives requests from
the panels, determines which album and picture to use, resizes the picture and streams it
back to the panels.
Album Management - Album information is stored in an XML file that is loaded with
PictureFrame. Images can be added/removed, enabled/disabled and moved to associated
albums. Panels are then tied to albums via their device and port/code numbers. The album
arrangement allows different panels to access specific albums or individual buttons on the
same panel.
Image Interface - The image interface displays the albums and their associated images
and panels. Images can be viewed by either thumbnail or detail list. Additionally, there is
the ability to stop, start and pause the HTTP server.
Image serving is controlled by the parameters sent from the panel to PictureFrame. The HTTP
server listens on its port and when an argument is made, parses the arguments to determine how to
proceed. The Device is used to determine which album the request is for and uses the default album
if no match is made. PictureFrame then determines the time allowance for each image in the album
and sizes each image according to width and height parameters. If no parameters are present the
image's height and width are used. A temporary file is created from the resized image and is sent to
the panels. PictureFrame will continue to send the temporary files to the panels until the application
is shutdown.
This does not apply to Internet Images, these images are fetched each time they are
served.
ictureFrame
1
Overview
Supported Platforms
PictureFrame operates on:
Windows 98® SE (with at least 48 MB of installed memory).
Windows NT 4.0® Workstation (service pack 6A or greater, with at least 64 MB of
installed memory).
Windows 2000® (service pack 3 or greater) Professional (running on a Pentium 233
MHZ processor (minimum requirement); 300 MHZ or faster recommended, with at least
96 MB of installed memory).
If you are installing on a Windows NT or Window 2000 machine, you must have
Administrator rights to install and run all required System files.
Windows XP® Professional (service pack 1 or greater, running on a Pentium 233 MHZ
processor (minimum requirement); 300 MHZ or faster recommended, at least 96 MB of
installed memory).
Other PC requirements:
Windows-compatible CD-ROM drive.
Windows-compatible mouse (or other pointing device).
The PictureFrame Work Area
Random Order Check Box
Menu Bar
Tool Bar
Album
Information
Window
Album Drop
Down List
Images
for Album:
Window
Panel
Management
Window
Web Server
Status
Move Image Up/Move Image Down
FIG. 1 The PictureFrame Work Area
Default Album Check Box
Default Image Duration Field
Minimize
Button
Image
Interface
Window
HTTP
Server
Status
Window
Menu Bar
Click on any of the main menu items to open the associated drop down menu. The menu bar
consists of File, Server, Albums, Images, Panel Links, View and Help.
2
PictureFrame
Overview
Tool Bar
The tool bar is a collection of commonly used PictureFrame functions.
Album Information Window
The Selected Album drop down list is a collection of created albums associated with
PictureFrame.
When checked, Default Album designates the album selected in the Album Drop Down
List as default.
Enabling Random Order will serve images, in the selected album, in a random manner.
Default Image Duration is the amount of time each image within the album will display at
the panels by default. PictureFrame default is 30 seconds.
Minimize accepts the changes and closes the work area, but does not exit PictureFrame.
Based on what the server is currently doing, Web Server Status will read Web Server is RUNNING,
...STOPPED or ...PAU SE D.
The PictureFrame work area divides up into main windows:
Images for Album: window - All images associated with the album that appears in the
Album Drop Down List. The up and down arrows move a selected image up or down
within the list.
Panel Management window - All panels associated with the album that appears in the
Album Drop Down List.
Image Interface window - A preview of images selected in the Album Management
window.
HTTP Server Status window - Displays the sever's current status and port location.
Album Information Window - Quick album management.
Album Information Window
The Album Information window offers quick management of albums.
A drop down list of all albums within PictureFrame.
A check in the box next to Default Album will make the currently selected album the
default.
A check in the box next to Random Order will make the currently selected album serve
the images in a random order.
The length of time each image will display appears in the field under Default Image
Duration. Changing the time in this field will change the default for the album.
ictureFrame
3
Overview
Images for Album: Window
Once an album is selected from the drop down list, associated images are displayed in the Images
for Album: window.
Images can be viewed by either thumbnail or detail. This feature is toggled in the View
menu.
The up/down arrows move images up or down the service order.
Image Status
Local Image, enabled for serving
Local Image, disabled from serving
Local Image, could not find
Internet Image, enabled for serving
Internet Image, disabled for serving
Panel Management Window
All panels associated with the album that appears in the Album Drop Down List are located in the
Panel Management window.
Right-click within the Panel Management window to access the panel context menu.
Image Interface Window
The Image Interface window provides an enlarged view of images selected in the Album
Management window.
HTTP Server Status Window
The status of the HTTP server is indicated as following:
Green - The server is runnnig.
Ye ll ow - The server is paused.
Red - The server is stopped.
Additionally, the port location for PictureFrame can be changed with the drop down list. Choose
from 80, 83, 130 (default), 140 and 1318.
The status of the HTTP server is also shown in the Web Server status.
Web Server Status
PictureFrame displays the current HTTP server status in the lower left hand side of the work area.
The comments are:
Web Server is RUNNING
Web Serve r i s PAUS E D
Web Server is STOPPED
4
PictureFrame
Overview
The Menu Bar
File Menu
The File menu contains options relating to management of file changes and exiting PictureFrame.
The options in this menu include:
Save Albums - saves album data to XML file.
Exit - exits PictureFrame application.
Server Menu
The Server menu contains options relating to HTTP server options.
Start Server - starts HTTP server if it is not already running.
Pause Server - pauses HTTP server and continues with the next image upon restart.
Stop Server - stops HTTP server, restarts with first image in albums.
Albums Menu
The Albums menu contains options relating to album management and:
Add Album - adds a new album to the application.
Remove Album - removes selected album from PictureFrame.
Set As Default Album - sets current album as new default album.
Toggle Random Order - when selected, serves the images to the panels in a random
WebUpdate - when installed, launches WebUpdate utility.
Tool Ba r
The tool bar is a collection of commonly used functions within PictureFrame.
PictureFrame Tool Bar
Saves changes made to albums, images and panel links.
Stops HTTP server, restarts with first image in albums.
Starts HTTP server if it is not already running.
Pauses HTTP server and continues with the next image upon restart.
Adds a new album via the Add Album Dialog.
Removes the entire album from PictureFrame.
Adds a local image via the Open Image Dialog.
Adds a URL image via the Internet Image Dialog.
Removes an image from the selected album.
Adds a panel link to an album via the Panel Link Entry Dialog.
Removes a panel link from the selected album.
6
PictureFrame
Basic Operations
Image Management
Adding A Local Image
Images located on a local drive can be added to an album for service to a panel.
1. Go to Images > Add Local Image to open the Open Image Dialog.
2. Navigate to and select the desired image file.
3. Click Open.
Adding An Internet Image
Images located on the internet can be pulled through PictureFrame and displayed at the panels.
1. Select the album from the drop down menu.
2. Go to Images > Add Internet Image to open the Internet Image Dialog.
3. Type or paste the URL into the field.
Basic Operations
4. Click OK.
Removing An Image
Selected images can be removed from a selected album:
1. Select the album from the drop down list.
2. Select the image to be removed. Hold down the Ctrl key to select multiple images from an
album.
3. Go to Images > Remove Image(s).
Enabling An Image
Images that have been disabled (reside in an album but are not served to a panel) must be enabled to
display on a panel.
1. Select the album from the drop down list.
2. Select the disabled image within the album.
3. Go to Images > Enable Image(s).
Disabling An Image
To cease a particular image from serving to a panel it must be disabled.
1. Select the album from the drop down list.
ictureFrame
2. Select the image within the album.
3. Go to Images > Disable Image(s).
7
Basic Operations
Moving Images
PictureFrame displays images in a linear fashion by default. The images can be moved up or down
the display list.
To move an image up by one (1):
1. Select the album from the drop down list.
2. Select the image within the Images for Album: window.
3. Go to Images > Move Up.
To move an image down by one (1):
1. Select the album from the drop down list.
2. Select the image within the Images for Album: window.
3. Go to Images > Move Down.
Changing Image Durations
The duration each image displays can be set either individually or all images within an album can
be set to the default time.
To set individual durations:
1. Select the album from the drop down list.
2. Select the image within the album.
3. Go to Images > Image Properties to open the Image Properties Dialog.
4. Set the time, in seconds or minutes, within the Time Duration field.
Click OK.
To reset all images to the default duration:
1. Select the album from the drop down list.
2. Select the image within the album.
3. Go to Images > Reset All Image Durations to open the Reset Image Dialog.
4. Click Ye s.
Getting Image Properties
Image properties can be altered and changed individually. To change the file location, image file or
file duration the image properties must be edited:
1. Select the album containing the desired image from the drop down list.
2. Select the image within the Album Management window.
3. Go to Images > Image Properties to open the Image Properties Dialog.
4. Select and change any or all fields, i.e. Location, Image File or Duration.
5. Click OK.
The Duration field is in seconds or minutes (range = 5 to 1800 seconds).
8
PictureFrame
Basic Operations
Panel Management
PictureFrame has two different formats for resolving Panel Links to albums:
Device:System
This option allows for any button on the panel to use that link. Device:System is a more
general option and is sufficient if there is only one dynamic image on the page.
Device:Port:System:Code
This option allows for more specific linking and is the correct way of handling multiple
dynamic buttons on the same page.
In order of request handling, the request built in TPD4 is parsed and put into a key string. An
example if the request arguments were:
device=10001&system=1&port=5&code=100
The key string would be 10001:5:1:100 and PictureFrame would try to find a Panel Link that
matches it. If no Panel Link was found, PictureFrame then drops back to try a link that matches the
device and system, in this example, 10001:1. If a link is still not found, PictureFrame will serve an
image from the Default Album.
Adding A Panel Link
Images are served from PictureFrame to a panel via a panel link. To link an album to a selected
panel:
1. Select the album from the drop down list.
2. Go to Panel Links > Add Panel Link to open the Panel Link Entry Dialog.
3. Enter the Device number in the corresponding field. If certain buttons on a panel are intended
to have specific images it is necessary to provide port and code number for a more specific
Panel Link.
The Panel Link must either be Device:System or Device:Port:System:Code.
4. Click OK.
Device:Port:System (D:P:S)
A device is any hardware component that can be connected to the NetLinx bus. Each device must
be assigned a unique number to locate that device on the bus. The Axcess language allows physical
device numbers in the range 0-255. The NetLinx language allows numbers in the range 0-32767.
Device 0 refers to the master; numbers above 32767 are reserved for internal use.
NetLinx requires a Device:Port:System (D:P:S) specification where Axcess expected only a device
number. This D:P:S triplet can be expressed as series of constants, variables separated by colons, or
as a DEV structure, to explicitly represent a device number, port and system.
ictureFrame
Here’s the syntax:
DEVICE:PORT:SYSTEM
where:
Device: 16-bit integer representing the device number
9
Basic Operations
Port: 16-bit integer representing the port number (in the range 1 through the number of ports on the
device)
System: 16-bit integer representing the system number (0 = this system) that the device belongs to.
For example, 128:1:0 represents the first port on device 128 on this system.
DEV structure example:
STRUCTURE DEV
{
INTEGER Number // device number
INTEGER Port // port on device
INTEGER System // system device belongs to}
In Axcess, Master Source Code files are always mapped to the Master Controller
(device = 0), and cannot be mapped to any other device. This does not apply to
NetLinx Master Source Code files.
Removing A Panel Link
Images are served from PictureFrame to a panel via a panel link. To remove the panel link from a
selected album:
1. Select the album from the drop down list.
2. Select the panel in the Panel Management window.
3. Go to Panel Links > Remove Panel Link(s).
Enabling A Panel Link
If a panel link has been established but is currently disabled, it must be enabled to resume serving
images to the panel.
1. Select the album from the drop down list.
2. Select the disabled panel within the Panel Management window.
3. Go to Panel Links > Enable Panel Link(s).
Disabling A Panel Link
Disabling a panel link stops PictureFrame's service of images to a selected panel without removing
the link completely.
1. Select the album from the drop down list.
2. Select the enabled panel within the Panel Management window.
3. Go to Panel Links > Disable Panel Link(s).
10
PictureFrame
Basic Operations
Album Management
Adding A New Album
New albums can be added to PictureFrame:
1. Go to Albums > Add Album to open the Add Album Dialog.
2. Type the album's name in the Album Name field.
3. Set the default image duration (in seconds or minutes) in the Image Duration field. (range = 5
to 1800 seconds)
4. Click OK.
To make the album the default, check the Default Album option.
Removing An Album
Albums can be removed from PictureFrame:
1. Select the album from the drop down list.
2. Go to Albums > Remove Album.
Changing Default Image Duration
The amount of time (in seconds or minutes) each image is displays is located in the Default Image
Duration field. To change the default time:
1. Select the album from the drop down list.
2. Go to Albums > Change Default Image Duration to open the Change Default Duration
Dialog.
3. Confirm the correct album is listed in the Album Name field.
4. Enter then new time value in the Default Image Duration field.
5. Click OK.
Setting A Default Album
An album can be set as the default image server.
1. Select an album from the drop down list.
2. Go to Albums > Set As Default Album.
Toggling Random Order
PictureFrame will serve the images in either a linear fashion from top to bottom (by default) or in
random order. To toggle random order:
1. Select the album from the drop down list.
ictureFrame
2. Go to Albums > Toggle Random Order.
11
Basic Operations
Server Management
Using The HTTP Server
PictureFrame can stop, pause and resume serving images to the panels via the HTTP server.
To Stop the server, select:
Server > Stop Server.
To Pause the server, select:
Server > Pause Server.
To Start the server, select:
Server > Start Server.
Changing Views
The Album Management window toggles between a detail list and a thumbnail view of the images
within the albums. Select View and either Details or Thumbnails.
Creating A Dynamic Image for Use in PictureFrame
There are a few basic steps when creating a dynamic image for use with PictureFrame.
Enter any name for the Name field but it is suggested to use names that make sense when
buttons are used.
The Protocol must be set to HTTP.
The Host can be either the IP Address of machine or the machine name.
The Host must have the “:PORT” attached to it. PictureFrame operates on a different
port than the standard port 80 used by HTTP servers. The default port is 130 but that
can be changed, as long as the PictureFrame server and the dynamic images are
using the same port.
No Path is needed.
For the File, any name should be acceptable (use something that makes sense, or
default.htm), the arguments are what is important. PictureFrame accepts the following
arguments:
device, port, code, width, height and system
These arguments can be parameterized so that the panel and/or button can identify itself.
Move Up - sort the selected image up the ordered list.
Move Down - sort the selected image down the ordered list.
Reset All Image Durations - resets all image durations for the album.
Switch Views - toggles the album between details and thumbnails view..
Image Properties - opens the Image Properties Dialog.
Panel Context Menu
Right-click within the Panel Management window to open the menu.
Add Panel Link - adds panel link to the selected album via the Panel Link Entry Dialog.
Remove Panel Link - removes selected panel link from the album.
Enable Panel Link - enables link from panel to album.
Disable Panel Link - disables link from panel to album.
ictureFrame
17
AMX reserves the right to alter specifications without notice at any time.
ARGENTI NA • AUST RALIA • BELGIUM • BRAZIL • CANADA • CHINA • ENGLAN D • FRANC E • GERMA NY • GRE ECE • HO NG KONG • INDIA • I NDONES IA • ITALY • JAPAN
LEBANON • MALAYSIA • MEXICO • NETHERLANDS • NEW ZEALAND • PHILIPPINES • PORTUGAL • RUSSIA • SINGAPORE • SPAIN • SWITZERLAND • THAILAND • TURKEY • USA
ATLANTA • BOSTON • CHICAG O • CLEVELAND • DAL LAS • DENVER • INDIANAPOLIS • LOS ANGELES • MINNEAPOLIS • PHILADELPHIA • PHOENIX • PORTLAND • SPOKANE • TAMPA
3000 RESEARCH DRIVE, RICHARDSON, TX 75082 USA • 800.222.0913 • 469.624.8000 • 469-624-7153 fax • 800.932.6993 technical support • www.amx.com
2004 AMX Corporation. All rights reserved. AMX, the AMX logo, the building icon, the home icon, and the light bulb icon are all trademarks of AMX Corporation.