(#20000) Using TCL Commands to Customize the Pixel!FX Graphical User Interface (GUI)

Mentalix Application Note #20000

Product: Pixel!ENGINE

Software Version(s): 2000

Platform(s): All Platforms

Subject: Using TCL Commands to Customize the Pixel!FX Graphical User Interface (GUI)

Revision Date: July 10, 2000

A subset of the Pixel!ENGINE functionality can be made available within the Mentalix end-user applications, such as Pixel!SCAN and Pixel!FX. If you have both an end-use product license and a Pixel!ENGINE license, you can execute a Pixel!ENGINE script during the startup of Pixel!SCAN or Pixel!FX. Most Pixel!ENGINE commands as well as a limited number of additional commands to manipulate and control GUI components are provided.

Following is a brief overview of the execTcl command line options.

The album Object

The command to create an album object is

set album1 [album new]

To access the top-level album

set album1 [album top]

The album Member Functions

album_object show - displays the album on the screen
album_object hide - removes the album from the screen
album_object raise - pops album window to the top
album_object load filename - loads an image or directory of images into the album

The work Object

The work function takes an album object and optional parameters as its arguments. The command to create a work object within a specified album is

set work1 [$album -standalone|-norulers|-nostatus| -hasexit|-noedits|-noload|-nosave]

The various options allow you to configure the work object to suit your specialized needs.

The work Member Functions

work_object show - displays the work object on the screen
work_object hide - removes the work object from the screen
work_object raise - pops the work object to the top
work_object load filename - loads a specified file into the work object
work_object getimag - returns access to the work object's associated image in the form of an image object (as documented in the Pixel!ENGINE chapter of the User Guide)
work_object redraw - forces the work object to update its display on the screen

The db Object

The command to create a db object is

set db1 [db database filename]

The db Member Functions

db_object show
db_object current
db_object next
db_object previous
db_object hide
db_object raise
db_object close
db_object iconizeall
db_object hideall
db_object selectall
db_object closeall
db_object refreshall
db_object import filename|directoryname

For additional information or assistance, please call Mentalix Technical Support at (972) 423-9377 Ext. 33.