CommandFusion Wiki

Documentation Resources

User Tools

Site Tools


Sidebar

software:gui-designer:images

This is an old revision of the document!


Images

Images are used to render a variety of image formats at specific coordinates in the user interface created with our guiDesigner software. Images can be either #Static or #Dynamic. The path of the image defines whether the image will be dynamic or static.

Image Formats

The following image formats are supported:

  • PNG (with alpha transparency - recommended format for all images)
  • JPEG
  • GIF (non-animated)
  • BMP

Static

Static images are defined at design time and always remain the same. The path of a static image is based on the Asset Folder setting in Project Properties.

Dynamic

There are two types of dynamic images supported:

  1. Images served from any web server via the HTTP protocol
  2. Images loaded from cache (any image used elsewhere in the project)

Any image path starting with

http://

will be dynamically loaded when the image comes into view (either on a Page or Subpage).
The image path can also be changed on the fly by assigning the image a Serial Join and changing the joins value to point to a new HTTP URL or to any image used within the project.
One trick commonly used is to create a Cache Page and place any images you want to use dynamically later on within this page.
Then you can change the serial join of any image in your GUI to point to any of these cached images.
For example, if you place an image “weather_01.png” on a Cache Page, you can refer to it on any of your other pages by changing an images serial join to the value 'weather_01.png'.

Refreshing Dynamic Images

To automatically refresh an image, you can set the Refresh Rate of the Image properties.
This is a value in milliseconds at which the image will constantly refresh whilst the image is in view.
Otherwise, whenever the serial join is updated to a new (or existing) value, the image will refresh.
This way you can force a refresh at any time you need. Sending the same serial value as is already associated with the serial join will still cause it to refresh.

software/gui-designer/images.1345024596.txt.gz · Last modified: 2012/08/15 09:56 by aaron