Workspace for Script Applications

Many of the concepts presented in these notes are accompanied by examples that you can try. Depending on the example, you will need either a script application or a standard application to work within. Instructions are provided here for preparing a script application. These instructions assume that you have a typical VTScada installation, located on your hard drive at C:\VTScada. If not, adjust the file path as required.

To create a standard application for use with some examples, refer to Workspace for Expressions

Create a Script Application

1. In the VTScada Application Manager, start the Add Application Wizard.
2. Select the Advanced option and click Next.
3. Ensure that Create New is selected and click Next.
4. Name the application. (Script 1 is suggested.)
5. Use the drop-down type selector to select Script Application, then click Next.
6. Deselect the Start Application Now check box before clicking Finish.
   For each example, you will need to edit code before running the application.

Your application will be created. Most examples will ask you to use a text editor to modify the file AppRoot.SRC, which can be found at C:\VTScada\Script1, assuming that Script 1 is the name that you gave this application.

The default window background color is black. Black is also the default color of text in several user-interface tools that you might display in that window. Therefore, you might want to change the window color to gray1 VTScada supports three different methods of specifying a color. Although uncommon, you can refer to Windows system colors to make your graphics match Windows dialogs. There is a color palette of 255 shades, each of which can be specified by number. And, you can use RGB values, where the transparency and the color are set using four pairs of hexadecimal values, always written within quotation marks and angle brackets.. Do so by modifying the Window call as follows:

The 7 comes from the VTScada Color Palette, which dates from a time when only the most expensive graphics cards supported a full 256 colors. While you are likely to use "alpha-RGB" colors in most situations, the palette remains a useful tool.

When making changes to a script application, you must stop, recompile, and then restart the application each time to see the changes. In a standard VTScada application, you may or may not need to restart the application, but you will always need to import file changes. When a restart is necessary, you will be prompted.

Write Code

1. Using a text editor, open the file AppRoot.SRC within the application folder. (C:\VTScada\Script1\AppRoot.SRC)
2. Modify the code to add a ZText function at line 38:
   
   Note that this is being added within the Main state of the Graphics sub-module.

Main [
   ZTEXT(100, 100,"Hello World!", 0, 0);
]

3. Change the title from "User Application" to "Greeting Application".
   
   Part of the exercise is to identify the line where this change is to be made.

4. Use the Import File Changes in the VAM to recompile the application and then start it.

Take a minute to learn a bit about how VTScada displays text and graphics. Continuing in the same application, change the statement as follows.

 

5. Delete the ZText statement and replace it with a ZBar statement as follows:

ZBar(100,200,150,50, "<FF0000FF>" { Blue });

6. Stop the application, "Import File Changes", then restart.
7. Change the color of the bar to green.
   
8. Draw a second rectangle so that the two together make a plus sign +.
   (Hint: This is just a matter of changing the four coordinates.)
9. Remove the second rectangle and draw a ZBox that will create a red border around the first rectangle.