Anda di halaman 1dari 88

Visoprog 5

(User Manual)

V 1.0
CAUTION:

Dixell S.r.l. reserves the right to amend this manual without prior notice. The latest

! available version can be downloaded from the internet site.

Please read this manual carefully before installing and starting Visoprog and follow all the instructions
contained in it. The manual also serves as a reference guide, which is why we recommend you always
ensure it is within easy reach.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 2/88
INDEX
1. MINIMUM SYSTEM REQUIREMENTS VISOPROG...................................................................... 6
2. HOW TO INSTALL ................................................................................................................... 7
3. VISOPROG............................................................................................................................ 11
3.1 SPLASH SCREEN .............................................................................................................................11
3.2 CREATE A NEW PROJECT ................................................................................................................11
3.3 OPEN A PROJECT ...........................................................................................................................12
3.4 LAYOUT.........................................................................................................................................12
Toolbar ...................................................................................................................................................... 12
Windows ................................................................................................................................................... 13
3.4.2.1 Stage Preview Window ......................................................................................................................... 14
3.4.2.2 Variables & Vocabulary Window .......................................................................................................... 14
3.4.2.3 Layers Window. ..................................................................................................................................... 14
3.4.2.4 Object Data + Buttons (Visograph) ....................................................................................................... 15
3.4.2.5 Object Data + Remote Buttons (Visotouch). ......................................................................................... 15
3.5 Convert/import a project ...............................................................................................................16
4. PRELIMINARY OPERATIONS .................................................................................................. 17
4.1 VOCABULARY MANAGEMENT ........................................................................................................17
4.2 PROJECT TO LINK ...........................................................................................................................18
4.3 GENERAL INFORMATION ...............................................................................................................18
4.4 DEVICE SET-UP ..............................................................................................................................19
4.5 FONTS MANAGEMENT...................................................................................................................19
4.6 COMPILER .....................................................................................................................................20
5. VARIABLES, VOCABULARY, IMAGES AND STATES .................................................................. 21
5.1 VARIABLES ....................................................................................................................................21
Variables Editor ......................................................................................................................................... 21
Import Variables ....................................................................................................................................... 22
5.1.2.1 Import From Excel File .......................................................................................................................... 23
5.1.2.2 Import From ISaGRAF Project ............................................................................................................... 25
Export Variables ........................................................................................................................................ 26
System Variables ....................................................................................................................................... 28
5.1.4.1 Others ................................................................................................................................................... 29
5.2 VOCABULARY ................................................................................................................................30
Vocabulary Editor...................................................................................................................................... 30
Import Vocabulary .................................................................................................................................... 31
Export Vocabulary ..................................................................................................................................... 33
5.3 IMAGES .........................................................................................................................................34
5.4 STATES ..........................................................................................................................................35
5.5 SHOW REFERENCE .........................................................................................................................37
6. VISOGRAPH STAGE............................................................................................................... 39
6.1 STAGE PROPERTY ..........................................................................................................................39
6.2 STAGE LIST, TREEVIEW AND SEQUENCE .........................................................................................40

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 3/88
6.3 TOOLBAR ......................................................................................................................................40
6.4 ELEMENTS .....................................................................................................................................41
VarLabel .................................................................................................................................................... 41
6.4.1.1 Properties Page ..................................................................................................................................... 41
6.4.1.2 Conditions Page .................................................................................................................................... 42
DxLabel...................................................................................................................................................... 43
6.4.2.1 Properties Page ..................................................................................................................................... 43
6.4.2.2 Conditions Page .................................................................................................................................... 44
DXImage .................................................................................................................................................... 45
6.4.3.1 Properties Page ..................................................................................................................................... 45
6.4.3.2 Conditions Page .................................................................................................................................... 46
DxAnimImage ............................................................................................................................................ 46
6.4.4.1 Properties Page ..................................................................................................................................... 47
6.4.4.2 Conditions Page .................................................................................................................................... 47
DxSwitchVarLabel ..................................................................................................................................... 48
6.4.5.1 Properties Page ..................................................................................................................................... 48
6.4.5.2 Switch Sequence Page .......................................................................................................................... 49
6.4.5.3 Conditions Page .................................................................................................................................... 50
DxSwitchVarImage .................................................................................................................................... 51
6.4.6.1 Properties Page ..................................................................................................................................... 51
6.4.6.2 Switch Sequence Page .......................................................................................................................... 52
6.4.6.3 Conditions Page .................................................................................................................................... 52
6.5 KEYS..............................................................................................................................................53
6.5.1.1 Virtual Buttons ...................................................................................................................................... 54
6.5.1.2 Properties Page ..................................................................................................................................... 54

7. VISOTOUCH STAGE .............................................................................................................. 58


7.1 STAGE PROPERTY ..........................................................................................................................58
7.2 STAGE LIST, TREEVIEW AND SEQUENCE .........................................................................................59
7.3 TOOLBAR ......................................................................................................................................60
7.4 ELEMENTS .....................................................................................................................................61
TCVarLabel ................................................................................................................................................ 62
7.4.1.1 Properties Page ..................................................................................................................................... 62
7.4.1.2 Conditions Page .................................................................................................................................... 63
7.4.1.3 The Math Editor .................................................................................................................................... 64
DXTCLabel ................................................................................................................................................. 65
7.4.2.1 Properties Page ..................................................................................................................................... 65
7.4.2.2 Condition Stage Jump ........................................................................................................................... 66
7.4.2.3 Conditions Page .................................................................................................................................... 67
DXTCDateLabel.......................................................................................................................................... 68
7.4.3.1 Properties Page ..................................................................................................................................... 68
DXTCImage ................................................................................................................................................ 69
7.4.4.1 Properties Page ..................................................................................................................................... 69
7.4.4.2 Condition Stage Jump ........................................................................................................................... 70
7.4.4.3 Conditions Page .................................................................................................................................... 71
DXTCAnimImage ....................................................................................................................................... 72
7.4.5.1 Properties Page ..................................................................................................................................... 72
7.4.5.2 Conditions Page .................................................................................................................................... 73
DXTCSwitchVarLabel ................................................................................................................................. 74
7.4.6.1 Properties Page ..................................................................................................................................... 74
7.4.6.2 Switch Sequence Page .......................................................................................................................... 75
7.4.6.3 Conditions Page .................................................................................................................................... 75
DXTCSwitchVarImage................................................................................................................................ 76
7.4.7.1 Properties Page ..................................................................................................................................... 76
7.4.7.2 Switch Sequence Page .......................................................................................................................... 77
DXTCShape ................................................................................................................................................ 78
7.4.8.1 Properties Page ..................................................................................................................................... 78

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 4/88
7.4.8.2 Conditions Page .................................................................................................................................... 78
DXTCButton ............................................................................................................................................... 79
7.4.9.1 Properties Page ..................................................................................................................................... 79
7.4.9.2 Image Page ............................................................................................................................................ 80
7.4.9.3 Conditions Page .................................................................................................................................... 80
7.4.9.4 Actions Page .......................................................................................................................................... 81
7.5 REMOTE BUTTON ..........................................................................................................................84
8. COMPILING AND DOWNLOADING PROJECT .......................................................................... 86
8.1 COMPILING ...................................................................................................................................86
Visotouch Limits ........................................................................................................................................ 86
8.2 DOWNLOADING PROJECT ..............................................................................................................87

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 5/88
1. MINIMUM SYSTEM REQUIREMENTS VISOPROG
The following Windows platforms are supported:
Microsoft Windows 8 /8.1
Microsoft Windows 7
Microsoft Windows VistaTM (SP1)
The latest service packs and security updates are recommended for all platforms
Microsoft Internet Explorer 6.0 SP1 or later

Prerequisites: Internet connection to download Microchip Compiler 1.34 Setup.


Free space requirement: Approximately 100 MB of disk space is required for full product installation,
and the installer requires 50 MB additional temporary space
Intel Pentium or compatible, 1.4GHz minimum (2GHz+ recommended)
1GB RAM (2 GB recommended)
1024x768 or higher resolution monitor
Mouse or other pointing device
Color quality above 256 colors (32-bit or 16-bit is sufficient)
USB serial port

On Windows, must install as Administrator


For Windows, you must run as Administrator or be on the Administrator list to install the product.

Multiple users on one machine


The product can be installed by any licensed user with administrator privileges, and is immediately available
to all licensed users of the same machine. It is also available to any licensed users you might add later.

Installer requires additional temporary space


If the drive containing the folder specified in your TEMP environment variable is low on space, the Installer
might halt with an error message noting the shortage. If this occurs, you'll need to assign your TEMP variable
to a folder on a drive with more disk space, then rerun the installation. See Minimum System Requirements
for exact specification.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 6/88
2. HOW TO INSTALL
Insert the CD in the CD drive and click the Visoprog5.exe file to start the guided process; press Next
button:

Accept the Licence Agreement and press Next button to continue:

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 7/88
Enter User name and Company name, then press Next button to continue:

Select the path where you want to install the Wizmate; default path is C:\Programs\Dixell\Wizmate; press
Next button:

BQT

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 8/88
Press the Next button:

To finish the installation press Next button.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 9/88
To exit the installation press Finish button.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 10/88
3. VISOPROG
Visoprog5 is the new integrated development environment for programming and debugging Visograph and
Visotouch devices.
The tool helps the user in the creation of User Interface by signaling syntax errors, in addition to a whole
range of tools and features to support the development and debugging.
Visoprog 5 can also migrate applications developed for keyboards Visograph on Visotouch devices.

3.1 SPLASH SCREEN

3.2 CREATE A NEW PROJECT

To create a new program, proceed as described below:

File New Project.


Here it is possible to select both Visograph and Visotouch project.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 11/88
3.3 OPEN A PROJECT

To open a project, proceed as described below:

The projects can be opened in classical methods: Via toolbar button


or File Open Project
Select the file with postfix .vpp to open.

3.4 LAYOUT

Toolbar

(1) New project


(2) Open project
(3) Save project
(4) Project option
(5) Compile project
(6) Send project to device(*)
(7) Edit variables
(8) Edit image database
(9) Edit vocabulary
(10) Show reference
(11) Cut
(12) Copy
(13) Past
(14) Redo
(15) Undo

(*) only for visograph

Layouts button is useful for customize users workbench


layout. User can select the windows he wants to show, adjust
every window for appropriate size and position, and then click
Save active layout to save it with a specified name.
If a layout is not useful anymore, you can select it and click
Delete active layout. It is also possible to set the currently
active layout as Default.

These toolbars are related to stage design.


They will be introduced in next chapters.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 12/88
Windows

Here is an example to show the layout of the standard window. It is also possible to customize and save your
own layout by clicking the button.

(1) Stage list + TreeView + Sequence window. List all the stages and elements.
(2) Images database window.
(3) Editor window. User development area. Most of the development job is done here.
(4) Stage preview + Variables + Vocabulary window.
(5) Layers window.
(6) Object data + Remote buttons.
(7) Compiler window. Show all the information generated during compiling.
(8) Statistical information window. Show the percentage of resources used by current project

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 13/88
3.4.2.1 Stage Preview Window

In the Stage preview window, it shows the preview of selected page according to the given variables
values. Use can change the variables to simulate different display.
Click buttons can zoom in/out the view.
Click button can take a screen short of the page. It will be saved as a document in stage list and allows
exporting.

3.4.2.2 Variables & Vocabulary Window

In the Variables window, it shows all the variables and states (if activated states visualization in project
option). In the Vocabulary window, it shows all the vocabularies defined.

3.4.2.3 Layers Window.

Manage layers definition and visibility.

User can assign different sorts of elements to different layers for easy viewing. Layer has meaning only
during development; it has no meaning for real display. For example, you can create a layer named images
where to include all image elements. And then create another layer named labels where to include all label
elements.
Double click the button can hide/unhide all the elements in the layer. Double click the button can
lock/unlock the elements in the layer. Once locked, the element cant be selected by mouse.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 14/88
3.4.2.4 Object Data + Buttons (Visograph)

Show selected elements property.

Show and edit local and virtual buttons.


Besides the standard local buttons, here is also
possible to define virtual buttons.
In remote controller, write system variable 0xFFF4 =
CmdID, then the action defined in corresponding
remote button will be executed.

See par. 6.5.1.1 and 6.5.1.2.

3.4.2.5 Object Data + Remote Buttons (Visotouch).

Show selected elements property.


Show and edit remote buttons.
Besides the standard local buttons, here is also
possible to define remote buttons.
In remote controller, write system variable
SYS_VKEY = CmdID, then the action defined in
corresponding remote button will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 15/88
3.5 CONVERT/IMPORT A PROJECT

With visoprog 5 is possible to import and convert applications developed for earlier versions of the software.

File Convert/Import. Here it is possible


to convert project Visoprog 3 to Visoprog 4
and convert Visoprog 4 to Visotouch.

The conversion is irreversible, so please remember to save your original project before start conversion.

After project Visoprog 3 to Visoprog 4 conversion


completed, please follow these instructions below.
Open again the project
Import the file Voc_Converted.xls

After Visoprog 4 to Visotouch conversion completed, the layout maybe changed, you need to check and
adjust the layout again.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 16/88
4. PRELIMINARY OPERATIONS
Set the language used for the Visoprog.
From the menu bar, select language and set the desired language.

Languages Language
Select the language used for the Visoprog.

N.B. Not to be confused with the language used in the project. This option makes reference only to Visoprog
and not to the project to be downloaded into the Visotouch.

Go to the options menu and set Project options and configurations Project Project Options

4.1 VOCABULARY MANAGEMENT

In this section we define languages used in the project vocabulary. It is multiple choices.
Grey is default active language (ENGLISH) and checked in boldface is optional.

You can select one language to be active in the project editor. This only means to the Visoprog not means to
the Visotouch.
E.g. if English selected, in your Visoprog editor, you will see all elements are displayed with English
vocabulary.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 17/88
4.2 PROJECT TO LINK

Here you can select the ISaGRAF project to link. It can be used for importing variables from target ISaGRAF
project to Visoprog project.

4.3 GENERAL INFORMATION


In box Project comment, it is allowed to type in some development information (E.g. My Keyboard 2015-05-
20).
Check the Active States visualization box can enable States using.
Please refer to relevant chapter for more information about States.
In Project Version, it includes information Major Ver., Minor Ver., Release, Build.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 18/88
4.4 DEVICE SET-UP
The Device download, Visotouch Address lan and Ipro Address lan options are left for future using.
At the moment, keep the default setting.

The Baudrate option is used to define the speed of communication between the Visoprog and the keyboard.
The available baud rates are 38400 and 19200.

If checked the box Touch calibrate on startup, every time when the screen startup, it will enter in
calibration process automatically. Please click on the red points on the screen to complete the calibration,
after that the application can start to work.

4.5 FONTS MANAGEMENT

In this section there is the management of fonts used in the project. Up to 4 fonts are available.
Double click on the Fonts can enter in Fonts editor menu.
Here you can select Font, style, size, effects, and script. The color will not be respected because each
element will set its own color in the properties menu.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 19/88
4.6 COMPILER

In this section, you can select the destination for the final compiled files.
Click button , it will locate to the current project folder automatically.
Then select which languages of vocabulary you want to include in the compiled files.
E.g. if you dont check Italian, even if you had selected it in Vocabulary management menu, it will not be
included in the final compiled files.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 20/88
5. VARIABLES, VOCABULARY, IMAGES AND STATES
If start from a new project, you can add new variables, vocabulary and images in Variables editor,
Vocabulary editor and Image Database.
If start from an existing project, you should perform an export of variables, States, vocabulary and existing
images to have both an update to apply the changes, and also a security backup.

5.1 VARIABLES

Variables Editor

Open Variables editor in:


menu Project Edit variables
or use:
the Edit variables button.

Once selected, the Variables editor window will appeares:

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 21/88
The meaning of each column:
Description: Comment of the variable (only for the user information).
Name: Name of the variable.
Group: Group which the variable belongs to (only for the user information).
Address: Variable modbus register address. The most important identifying the variable.
It can be decimal number (e.g. 28672) or hexadecimal number (e.g. x7000).
Signed: Determines whether the variable is loaded with or without sign -.
0: unsigned;
1: signed.

Mask: Identifier associated to States.


Points to state index when the variable is shown as state (Flag State =1).
Decimals: Number of decimals.
0: Integer;
1: decimal;
2: cent.

Read from Excel: Determin if the variables properties are defined by Visoprog or defined by
controller (ipro).
0: by controller;
1: by Visoprog.

LimitMax: Maximum value of the variable can be set to.


LimitMin: Minimum value of the variable can be set to.
Visible: Defines whether the variable should be visible or not. 0 means visible.
Flag RD Only: Defines whether the variable can be written by keyboard or read.
0: readable and writable;
1: read only.

Flag State: 0: the variable is shown as value;


1: shown as State.
PLCRef: For annotations

After changed the variables, please click button to update changes.

Import Variables

Except define new variables one by one manually, it is also possible to import variables from excel file or
from ISaGRAF project.
Click Import button to start the importing.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 22/88
5.1.2.1 Import From Excel File

This excel file could be a file exported from another Visoprog project. If you want change or add some
variables, you can open and edit this excel file and then import the new excel file.

The format of this excel file is like below:

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 23/88
Note: The importing will delete all the previous variables. If you dont want the coverage, please export the
variables firstly.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 24/88
5.1.2.2 Import From ISaGRAF Project

Here can select whether to replace


the existing variables or not.

Select the .MDB file.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 25/88
Export Variables

You can also export in xls the entire variables library by following steps:

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 26/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 27/88
System Variables

Name Description ADR


SYS_BUZ If set SYS_BUZ=1, it will trigger the buzzer working. 0xFFFE
Set SYS_BUZ=0, it will mute the buzzer.
During the buzzer working, click anywhere on the screen also can stop the
buzzer.
SYS_LEDR Set SYS_LEDR=1, the red LED on the screen will be ON. 0xFFFE
Set SYS_LEDR=0, the red LED on the screen will be OFF.

SYS_LEDG Set SYS_LEDR=1, the green LED on the screen will be ON. 0xFFFE
Set SYS_LEDR=0, the green LED on the screen will be OFF.

SYS_LNG It is used to set the active language in vocabulary. 0xFFF8


For example, in the vocabulary it defined 2 kinds of language (0=Italian,
1=English). Set SYS_LNG=0, all the vocabularies will be shown in Italian,
Set SYS_LNG=1, all the vocabularies will be shown in English.
SYS_BKL Set the backlight. 0xFFF9

SYS_VKEY Virtual key command. Write command to SYS_VKEY, then the 0xFFF4
corresponding command defined in Remote Buttons will be executed.
SYS_VER Show firmware project version. 0xFFF6

SYS_COR Show firmware system version. 0xFFF7

STAGE_PAGES The total pages number of the stage. 0xFFF2

STAGE_PAGE Currently active page index. (The index is start from 1). 0xFFF3

STAGE_CURSOR Show the cursor position.


The position is expressed by the element index showing in Sequence
window.
SYS_CALIB Touch calibration command.
When set to 1 can start the touch screen calibration.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 28/88
ADR_VARSYS_BUZZ : Description
Contains the status of the 3 resources: Buzzer, Led1, Led2
Each resource has 4 operating statuses:
OFF (not active)
ON (active)
FLASHING
UNALTERED.
The operating statuses of the resources are mapped inside a 16-bit variable in the format below:

15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

LEDG1 LEDG0 LEDR1 LEDR0 BUZ1 BUZ0

BUZ1 BUZ0 LEDR1 LEDR0 LEDG1 LEDG0


OFF 0 0 OFF 0 0 OFF 0 0
ON 0 1 ON 0 1 ON 0 1
FLASHING 1 0 FLASHING 1 0 FLASHING 1 0
INALTERATO 1 1 INALTERATO 1 1 INALTERATO 1 1

5.1.4.1 Others

0xFFF5
A system variable is read with the keyboard start up. This variable contains the address of the first stage to
display. The value ranges from 0 to N, where N is the maximum number of Stages -1 in the interface. If N is
greater or equal to the number of stages present, then stage 0 is taken as the entry stage. If the base does
not correspond to this variable within (approximately) 90 seconds, stage 0 is taken as the default option.

PS
There is a subject line for the visibility of the pages.
Enter LABEL in the subject line. The content or location is not important because it is not displayed (we
recommend using one character to not use up too much space).
In the visibility conditions enter an expression like

PS(Var,arg1,arg2,arg3,argN)

Where Var is the variable to use in the mathematical formula, arg1 ... argN are the visibility conditions of the
pages from 0 to N, respectively.

This is the argN syntax


< NUMBER valid condition if Var has a lower NUMBER value
> NUMBER valid condition if Var has a higher NUMBER value
= NUMBER valid condition if Var is equal to NUMBER
T condition always true

NOTE: Do not insert spaces in the string.

Example:

PS($1,T,Var1=-21,T,Ar2=-123,Var3>432)

Note: In a stage there must be as many tops as pages, otherwise the switch from one page to the next will
not be carried out correctly.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 29/88
5.2 VOCABULARY

Vocabulary Editor

Open Variables editor in:


menu Project Edit Vocabulary
or use:
the Edit Vocabulary button.

In the editor, all the languages selected in Project option -> Vocabulary management will be shown.

You can add new items here. After changed the vocabulary, please click button to update changes.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 30/88
Import Vocabulary

Except define new vocabulary one by one manually, it is also possible to import vocabulary from excel file.
The format of the excel file is like below:
First row must have this structure: IDVoc Language1 Language2 . (Up to 5);
Starting from second row of the first column we insert a progressive index;
Then for each text inserted, you have to translate into the other languages you want.

Click Import button to start the importing.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 31/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 32/88
Export Vocabulary

Click Export button to start the exporting.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 33/88
5.3 IMAGES

Open Variables editor in:


menu Project Edit images database
or use:
the Edit images database button.

The B/W image has only black and white color. It will be marked with a red point. Colorful image has no red
point marked.

Add selected image to the stage

Add (*)

Replace image (**)


Delete image

Export images or database

Open database to edit images.

Move image to
Move image down

Expand window

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 34/88
Visograph
(*) The three options allow you to add an
image to the database from a
previously created file, create one
using the editor, or you can import an
entire database of images to the
project.

(**) Since the maximum number of images in the database is 256 (0-255) if the database is full and
you have to insert a new image it is possible to sotituirne an existing one with another new one.

Visotouch
(*) The four options allow you to add an
image to the database from a
previously created file, create one
using the editor, or you can import an
entire database of images to the
project.
B/W image has only black and white
color. It will be marked with a red point.
COLOR image are colorful images. It
has no red point marked.
With new image editor, you can draw a
new COLOR image.

(**) Since the maximum number of images in the database is 614 (2 MB), if the database is full and
you have to insert a new image it is possible to replace an existing one with another new one.

5.4 STATES

The States could be very useful when display a variable value as labels.
For example: Variable Unit_Status is defined as 0 means OFF, 1 means ON. Instead of show number 0 or
1 on the touch screen, it can show label OFF when Unit_Status=0, show label ON when Unit_Status=1.
In this way, we can obtain a friendlier user interface.

To use States, you must active States visualization in Project Options menu.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 35/88
States cant be edit in Visoprog, it must be edit in excel file and then imported to Visoprog. Here is an
example to show the excel file format.
Note: The maximum length of a state is 6 characters. No multi-language supported.

-Gain Index: State identification number


-Value: State-bound value

In Variables editor, click button to import variables. Then select Import States in the next window.

After importing finish, the States will be shown in the Variables area on the right side of the window.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 36/88
Then, in the Variables editor, define the variable which you want to display as states. The column Flag
State must be set to 1, and the column Mask set as the starting index (Mask must > 0).

Take the graphs above for example.


Here defined 2 variables: VAR1 (Mask = 1), VAR2 (Mask = 2).
When displaying the variables, it will search the State list, uses VAR1 + Mask value as the index to show the
corresponding strings.

VAR1 value Shown as


1 One
2 Two
3 Three
4 Four
5 Five
6 Six
7 Seven
8 Eight
9 Nine
10 Ten

VAR2 value Shown as


1 Two
2 Three
3 Four
4 Five
5 Six
6 Seven
7 Eight
8 Nine
9 Ten
10 Ten

5.5 SHOW REFERENCE

With Show reference function, it is very easy to know where each variable, vocabulary or image is used in
the whole project.
Click button can open the XReference window. Then select the concerned variable / vocabulary / image
from the list. It will list down all the stages and elements where this variable / vocabulary / image have been
used.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 37/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 38/88
6. VISOGRAPH STAGE
The internships are the various sections into which it is divided by the visoprog project.
Each stage can be composed of several pages that in turn contain objects.
Doing right in the box named List Stage opens the menu that allows you to create new stage, delete, copy,
move and import them from other projects or export them.
Add automatic stage allows you to pre-configure a new stage with the chosen objects and properties.

6.1 STAGE PROPERTY

Click Stage properties can change the background color and edit other settings.
Exit mod:
Infinite: No automatic exit from this stage (only with keys)
Timeout: After seconds jump to a target stage (timeout is multiple of 5 seconds: 1=5sec)
Compressed: (only for visograph) The check on compressed flag is used when one needs to have an
internship that can adapt to multi-page items it contains.
We as an example that in one stage needing to display at most 8 rows of items (example 8 sensors with
its values) but which, for mathematical terms, when there are only 4 of assets. Normally the stage, with
all active elements, should be composed of two pages. To prevent the stage shows the 4 Active probes
on the first page and, below, a blank page is compressed function ability. This makes it possible to
resize the stage "according to active elements it contains.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 39/88
6.2 STAGE LIST, TREEVIEW AND SEQUENCE
StageList window lists all the stages inside the project. Switch to TreeView window can show all elements
involved in current stage. Switch to Sequence window can show all activated elements in current stage. The
Sequence is the cursor moving sequence. When user presses button defined as Prev Element or Next
Element on the touch screen, he will see the cursor moves to another element. The cursor location is
marked with dash line border. To change the defined element sequence, you can use button .

6.3 TOOLBAR

Visoprog provides some toolbars for easy using. They are available on the top of Editor Window.

(1) Zoom in +
(2) Zoom out -
(3) Add new page
(4) Move page down
(5) Move page up

(1) Align left edges


(2) Align right edges
(3) Align bottoms
(4) Aliagn top edges
(5) Space equally, horizontally
(6) Space equally, virtually
(7) Align vertical centers
(8) Align horizontal centers
(9) Bring to front
(10) Send back

These buttons could be very helpful for arranging the elements to obtain a good visual sense. For example,
in the screen below, if you want to make the 3 images space equally, you can keep press Shift key on the
PC keyboard, and use mouse to select these 3 images. And then click , you will see the images are put
to right position automatically.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 40/88
6.4 ELEMENTS

Visoprog provides 9 categories of elements to display variables, strings and images. Be familiar with every
elements property can help you to select the right element for your requirement.

(1) VarLabel
(2) DxLabel
(3) DxImage
(4) DxAnimImage
(5) DxSwitchVarLabel
(6) DxSwitchVarImage
(7) Not used

VarLabel

VarLabel element is used to display a variables value. To add a VarLabel element, click on the VarLabel
button and then click on the stage editor area. Double click the element can open and edit its properties.

6.4.1.1 Properties Page

Locked on Scroll If checked, this element will display in every page of current stage
with the same position.

Disabled It is checked by default. If unchecked, means this label is enabled, it


is available for cursor locating. User can click this label and do extra

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 41/88
action such as write value to a variable.

Select Variable Select the variable to be shown from Variables list. You can type the
variable name to find the variable easily. See the graph below. The
next line is used for preview. For example, it can be written as -
10.10.
If the selected variable is defined as State in the variables editor, use
this VarLabel element can show the variable value as strings.

Font Allows selecting the font from the font list defined in the project option.

Stage preview Show element preview.

6.4.1.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Here are some examples:


OR ($Var = 0.0) OR ($Var > 0.0) OR (< 0.0 $Var) WRT ($Var = 0)
AND ($Var = 0.1) AND ($Var > 0.1) AND ($Var < 0.1) TOG ($Var)
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 42/88
DxLabel

DXLabel element is used to display a label. This label can be a normal string or string from vocabulary.
Double click the element can open and edit its properties.

6.4.2.1 Properties Page

Locked on If checked, this Label will display in every page of current stage with the same position.
Scroll
Disabled It is checked by default. If unchecked, means this label is enabled, it is available for cursor
locating. User can click this label and do extra action such as jump to another stage or write
value to a variable.

Caption Here allows typing in the string directly. It is also possible to use vocabulary.
The advantages for using vocabulary are:
It is easy for batch processing. Once the vocabulary item updated, all the referred
elements will be changed too.
Easy to manage multi-language.

Font Allows selecting the font from the font list defined in the project option.

Stage Show font preview.


preview

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 43/88
6.4.2.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Here are some examples:


OR ($Var = 0.0) OR ($Var > 0.0) OR (< 0.0 $Var) WRT ($Var = 0)
AND ($Var = 0.1) AND ($Var > 0.1) AND ($Var < 0.1) TOG ($Var)
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 44/88
DXImage

This element can be used to show a fixed image. The image could be only a black & white image. Double
click the element can open and edit its properties.

6.4.3.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is available for
cursor locating. User can click this image and do extra action such as jump to another
stage or write value to a variable.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 45/88
6.4.3.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

DxAnimImage

This element can be used to show an animated image. E.g. a blowing fan, a shaking bell. The image could
be either a black & white image or a colored image. Double click the element can open and edit its
properties.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 46/88
6.4.4.1 Properties Page

Select an image in the right window, and then click button can add it to the Image Sequence. Click
button can remove it from the Image Sequence. Then in the preview area, you will see the how will the
images animating.
Note: In the Image Sequence, the images can be all B/W images.
Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is available


for cursor locating. User can click this image and do extra action such as write value
to a variable.

6.4.4.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Here are some examples:


OR ($Var = 0,0) OR ($Var > 0,0) OR ($Var < 0,0) WRT ($Var = 0)
AND ($Var = 0,1) AND ($Var > 0,1) AND ($Var < 0,1) TOG ($Var)
Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 47/88
DxSwitchVarLabel

This element can be used to show a switchable variable or switchable vocabulary. Double click the element
can open and edit its properties.

6.4.5.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this element is enabled, it is


available for cursor locating. User can click this element and do extra action such
as write value to a variable.

Switch Mode Select the switch mode. It can be switch between variables or switch between
vocabularies.

Select Variable Select the variable for switching. Then select the variable needed. The next line
is used for preview. For example, it can be written as -10.10 or Unit ON.

Font Allows selecting the font from the font list defined in the project option.

Stage preview Show Font preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 48/88
6.4.5.2 Switch Sequence Page

This page will be shown differently depending on the switch mode, see the two graphs below:

If the switch mode is set as switch between


variables. In the right side window, it will list all
the system variables and user defined variables.
Select a variable, and click can add it to the
switch sequence. Click can remove it from
switch sequence.
For example: Min = 1, Max = 2, Value = Test2.
Means if 1 <= Test1 <= 2, this element will show
variable Test2 value.

If the switch mode is set as switch between


vocabularies. In the right side window, it will list
all the user defined vocabularies.
Select a vocabulary, and click can add it to
the switch sequence. Click can remove it
from switch sequence.
For example: Min = 1, Max = 2, Value = YES.
Means if 1 <= Test1 <= 2, this element will be
shown as YES.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 49/88
6.4.5.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 50/88
DxSwitchVarImage

This element can be used to show a switchable image. Double click the element can open and edit its
properties.

6.4.6.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the
same position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is


available for cursor locating. User can click this image and do extra action
such as write value to a variable.

Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 51/88
6.4.6.2 Switch Sequence Page

On the right side of the window, it show all the


images defined in image database.
Select an image, and click can add it to the
switch sequence. Click can remove it from
switch sequence.

6.4.6.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 52/88
6.5 KEYS

Depending on the type of keyboard could have a set of 6 or 8 keys.


The numbering goes from left to right in increasing number and each key is identified by the capital letter T
and the number on the key.

The list of buttons on the stage is selected next to the list of properties in the lower right-hand corner of the
screen.

Edit Properties button

Copy

Paste

Add

Delete

Move DOWN

Move Up

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 53/88
6.5.1.1 Virtual Buttons

There is a system variable that manages the virtual keys of Visograph. When the value of this variable is
other than 0, ensure the keyboard performs the associated keys function.
Here are the associated values:

Variable Value Visograph keys coding


0 NULL
1 T1+T6
2 T1+T6+T5
3 T1+T6+T4
4 T1+T6+T4+T5
5 T1+T6+T3
6 T1+T6+T3+T5
7 T1+T6+T3+T4
8 T1+T6+T3+T4+T5

Note: the combination of keys you want to perform must be implemented as part of the stage(s).

6.5.1.2 Properties Page

Timeout Only if user keeps press this button for the seconds written in Timeout, then the
button action will be take effect actually.

Name Button name

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 54/88
In addition to the name of the key, it can be associated with the following functions:

Jumps to stage
Press passes to the stage selected

Active input
When pressing the button activates
the selected object.

Page UP
Press passes to the previous page
of the stage.

Page DOWN
Press passes to the next stage.

Prev Element/UP Value


When pressing the button allows
you to switch between the active
elements of the stage and when the
item was enabled with the Enable
button, allows increasing the value
of the variable.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 55/88
Next Element/DOWN Value
When pressing the button allows
you to switch between the active
elements of the stage and when the
item was enabled with the Enable
button, allows you to decrement the
value of the variable.

Conditional Jump to Stage


Press passes from one stage to
another in accordance with the
conditions laid down in the
Condition Stage Jump page.
Here is possible to execute a
operation before jumping.

Set Variables
Press enables writing the value of a
variable.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 56/88
Fast increment value
Press enables increase the value of
a variable. The new value will be
applied immediately without press
Active input button to confirm.

Value decrease fast


Press enables decrease the value
of a variable. The new value will be
applied immediately without press
Active input button to confirm.

Back to previous Stage +


cursor
Press jumps to the previous stage
from which enter in the current
stage. And the cursor will keep in
the previous position.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 57/88
7. VISOTOUCH STAGE
Visoprog5 is organized as sequence of stages. Stage can be SINGLE PAGE or MULTIPLE PAGES.
When Visotouch starts, the first stage shown is the first stage defined on Visoprog5 project.
Each stage is the container for the elements (controls) that you decided to show.

When a new project is created, one stage exists by default. Right click on the stage, pop out a menu which
allows adding new stage and cut/copy stage. By click Import stage/Export stage, it is possible to
import/export a stage to/from another project. The stage is saved as .STG5 file. Click Move stage
down/Move stage up can change the stages sequence.

7.1 STAGE PROPERTY

Click Stage properties can change the background color and edit other settings.
Exit mod:
Infinite: No automatic exit from this stage (only with keys)
Timeout: After seconds jump to a target stage (timeout is multiple of 5 seconds: 1=5sec)

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 58/88
7.2 STAGE LIST, TREEVIEW AND SEQUENCE
StageList window lists all the stages inside the project. Switch to TreeView window can show all elements
involved in current stage. Switch to Sequence window can show all activated elements in current stage. The
Sequence is the cursor moving sequence. When user presses button defined as Prev Element or Next
Element on the touch screen, he will see the cursor moves to another element. The cursor location is
marked with dash line border. To change the defined element sequence, you can use button .

In Visotouch, if user put cursor on an activated element, the system variable STAGE_CURSOR will change
to the elements sequence number. This could be very useful when display some information dynamically
according to the cursor position.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 59/88
7.3 TOOLBAR

Visoprog provides some toolbars for easy using. They are available on the top of Editor Window.

(6) Zoom in +
(7) Zoom out -
(8) Add new page
(9) Move page down
(10) Move page up

(11) Align left edges


(12) Align right edges
(13) Align bottoms
(14) Aliagn top edges
(15) Space equally, horizontally
(16) Space equally, virtually
(17) Align vertical centers
(18) Align horizontal centers
(19) Bring to front
(20) Send back

These buttons could be very helpful for arranging the elements to obtain a good visual sense. For example,
in the screen below, if you want to make the 3 images space equally, you can keep press Shift key on the
PC keyboard, and use mouse to select these 3 images. And then click , you will see the images are put
to right position automatically.

Some buttons function also can be done by right click on the Stage editor area. In the menu pops out, you
can see many optional items. Click the first one Page can set the visibility of pages except the first page,
because the first page cant be hidden.
See the example below, in the Page properties, it writes: the Element visible IF AND($Test1>0,1). It means
this page only visible when variable Test1 > 0. Otherwise, this page will be hidden.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 60/88
7.4 ELEMENTS

Visoprog provides 9 categories of elements to display variables, strings and images. Be familiar with every
elements property can help you to select the right element for your requirement.

(1) TCVarLabel
(2) DXTCLabel
(3) DXTCDateLabel
(4) DxTCImage
(5) DxTCAnimImage
(6) DxTCSwitchVarlabel
(7) DxTCSwitchVarImage
(8) DxTCShape
(9) DxTCButton

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 61/88
TCVarLabel

TCVarLabel element is used to display a variables value. To add a TCVarLabel element, click on the
TCVarLabel button and then click on the stage editor area. Double click the element can open and edit its
properties.

7.4.1.1 Properties Page

Locked on Scroll If checked, this element will display in every page of current stage
with the same position.

Disabled It is checked by default. If unchecked, means this label is enabled, it


is available for cursor locating. User can click this label and do extra
action such as write value to a variable.

Alignment Select alignment type. Can be Left Justify, Right Justify or Center
Justify.

Select Variable Select the variable to be shown from Variables list. You can type the
variable name to find the variable easily. See the graph below. The
next line is used for preview. For example, it can be written as -
10.10.
If the selected variable is defined as State in the variables editor, use
this TCVarLabel element can show the variable value as strings.

Font Color & Background Color Allows setting the font color and the background color. If Disabled box
is unchecked, here can also set the Font Color pressed and
Background Color pressed. In this way, when user clicks this label, he
can see the labels color changed.

Font Allows selecting the font from the font list defined in the project option.

Stage preview Show element preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 62/88
7.4.1.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Element blink IF Here can set a logic function to make the element blinks. In case of element visible, if
the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 63/88
7.4.1.3 The Math Editor

The Math Editor is used to edit the logic function for elements visibility, blinking, etc.

Function List Here list all the functions available. Double click on one row, the function will be added to
the window above.
For example: TOG($Var) means toggle the variable value. If Var=0, after execute
TOG($Var), Var change to 1. If Var=1, after execute TOG($Var), Var change to 0.

Var List In this list, you can select the required variable to replace the $Var in the function.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 64/88
DXTCLabel

TCVarLabel element is used to display a label. This label can be a normal string or string from vocabulary.
Double click the element can open and edit its properties.

7.4.2.1 Properties Page

Locked on If checked, this Label will display in every page of current stage with the same position.
Scroll
Disabled It is checked by default. If unchecked, means this label is enabled, it is available for cursor
locating. User can click this label and do extra action such as jump to another stage or write
value to a variable.

Alignment Select alignment type. Can be Left Justify, Right Justify or Center Justify.

Caption Here allows typing in the string directly. It is also possible to use vocabulary.
The advantages for using vocabulary are:
It is easy for batch processing. Once the vocabulary item updated, all the referred
elements will be changed too.
Easy to manage multi-language.

Font Color & Allows setting the font color and the background color. If Disabled box is unchecked, here
Background can also set the Font Color pressed and Background Color pressed. In this way, when user
Color clicks this label, he can see the labels color changed.

Font Allows selecting the font from the font list defined in the project option.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 65/88
Stage Show font preview.
preview

7.4.2.2 Condition Stage Jump

This page is only visible when the Disabled box is unchecked.

Switch Variable Click to select a variable from the list to determine which stage to jump to when user
click on this Label.
On the right side, it lists all the stages in the project. Put mouse on a stage, then click
button can add this stage to the switch list. On the contrary, click button can
remove a stage from the switch list.
On the left side, it indicates the variable range for stage jumping. For example:
Min = 1, Max = 2, Value = Stage1. Means if 1 <= Test1 <= 2, it will jump to Stage1
when user click this label on the touch screen.

Jump to Stage If checked, when jumped to the appointed stage, the cursor will stay in the position
and back where it had been.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 66/88
7.4.2.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Element blink IF Here can set a logic function to make the element blinks. In case of element visible, if
the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 67/88
DXTCDateLabel

This element is very helpful for displaying the date and time. It provides 8 kinds of format. User can select
one format as he prefer. Double click the element can open and edit its properties.

7.4.3.1 Properties Page

Locked on Scroll If checked, this element will display in every page of current stage with
the same position.

Date time format Here allows selecting the date time format.

dd, mm, yyyy/yy variable Here can select the variables to show the date value.

Font Color & Background Color Allows setting the font color and the background color.

Font Allows selecting the font from the font list defined in the project option.

Stage preview Show font preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 68/88
DXTCImage

This element can be used to show a fixed image. The image could be either a black & white image or a
colored image. Double click the element can open and edit its properties.

7.4.4.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is available for
cursor locating. User can click this image and do extra action such as jump to another
stage or write value to a variable.

Black Color/White Double click on one B/W image (marked with a red point on the left top corner) in the
Color right window. The color setting boxes will change to visible.
For colored images, it is not possible to configure the Black Color and White Color.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 69/88
7.4.4.2 Condition Stage Jump

This page is only visible when the Disabled box is unchecked.

Switch Variable Click to select a variable from the list to determine which stage to jump to
when user click on this Label.
On the right side, it lists all the stages in the project. Put mouse on a stage,
then click button can add this stage to the switch list. On the contrary, click
button can remove a stage from the switch list.
On the left side, it indicates the variable range for stage jumping.
For example:
Min = 1, Max = 2, Value = Stage1. Means if 1 <= Test1 <= 2, it will jump to
Stage1 when user click this label on the touch screen.

Jump to Stage and back If checked, when jumped to the appointed stage, the cursor will stay in the
position where it had been.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 70/88
7.4.4.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

Element blink IF Here can set a logic function to make the element blinks. In case of element visible,
if the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 71/88
DXTCAnimImage

This element can be used to show an animated image. E.g. a blowing fan, a shaking bell. The image could
be either a black & white image or a colored image. Double click the element can open and edit its
properties.

7.4.5.1 Properties Page

Select an image in the right window, and then click button can add it to the Image Sequence. Click
button can remove it from the Image Sequence. Then in the preview area, you will see the how will the
images animating.
Note: In the Image Sequence, the images can be all B/W images or all colored images, not possible for
mixture.

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is available


for cursor locating. User can click this image and do extra action such as write value
to a variable.

Black Color/White The color setting boxes are only visible when B/W image (marked with a red point
Color on the left top corner) selected.
For colored images, it is not possible to configure the Black Color and White Color.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 72/88
7.4.5.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element is
not visible. This logic function can be edited with Math Editor.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 73/88
DXTCSwitchVarLabel

This element can be used to show a switchable variable or switchable vocabulary. Double click the element
can open and edit its properties.

7.4.6.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Disabled It is checked by default. If unchecked, means this element is enabled, it is


available for cursor locating. User can click this element and do extra action such
as write value to a variable.

Alignment Select alignment type. Can be Left Justify, Right Justify or Center Justify.

Switch Mode Select the switch mode. It can be switch between variables or switch between
vocabularies.

Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview. For example,
it can be written as -10.10 or Unit ON.

Font Color & Allows setting the font color and the background color. If Disabled box is
Background Color unchecked, here can also set the Font Color pressed and Background Color
pressed. In this way, when user clicks this label, he can see the labels color
changed.

Font Allows selecting the font from the font list defined in the project option.

Stage preview Show Font preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 74/88
7.4.6.2 Switch Sequence Page

This page will be shown differently depending on the switch mode, see the two graphs below:

If the switch mode is set as switch


between variables. In the right side
window, it will list all the system
variables and user defined
variables.
Select a variable, and click can
add it to the switch sequence. Click
can remove it from switch
sequence.
For example: Min = 1, Max = 2,
Value = Test2. Means if 1 <= Test1
<= 2, this element will show
variable Test2 value.

If the switch mode is set as switch


between vocabularies. In the right
side window, it will list all the user
defined vocabularies.
Select a vocabulary, and click
can add it to the switch sequence.
Click can remove it from switch
sequence.
For example: Min = 1, Max = 2,
Value = YES. Means if 1 <= Test1
<= 2, this element will be shown as
YES.

7.4.6.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

Element blink IF Here can set a logic function to make the element blinks. In case of element
visible, if the logic function is TRUE, the element blinks; if the logic function is
FALSE, the element displays as fix label.

Element Set This option exists only when the Disabled box is unchecked. When user clicks this
element, the function written here will be executed.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 75/88
DXTCSwitchVarImage

This element can be used to show a switchable image. Double click the element can open and edit its
properties.

7.4.7.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the
same position.

Disabled It is checked by default. If unchecked, means this image is enabled, it is


available for cursor locating. User can click this image and do extra action
such as write value to a variable.

Select Variable Select the variable for switching. Click button can open the Variables list.
Then select the variable needed. The next line is used for preview.

Black Color & White Color Allows setting the color of B/W (Black/White) images. It is only visible when
B/W images are selected. If using colored images, this setting has no sense.

Preview Show images preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 76/88
7.4.7.2 Switch Sequence Page

On the right side of the window, it show all the images defined in image database.
Select an image, and click can add it to the switch sequence. Click can remove it from switch
sequence.
Once a B/W image selected, all the other images in the switch sequence should also be B/W images.
Once a colored image selected, all the other images in the switch sequence should also be colored images.
No mixture is allowed.
For example: Min = 1, Max = 2, Value = 4. Means if 1 <= Test1 <= 2, this element will show the image which
ID=4.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 77/88
DXTCShape

This element can be used to show a basic shape with specified color and type. Double click the element can
open and edit its properties.

7.4.8.1 Properties Page

Locked on Scroll If checked, this image will display in every page of current stage with the same
position.

Border Color Set the color of the shape border.

Shape Color Set the color of the shape.

Background Color Set the color of the background rectangle.

Shape type Set the type of the shape. The available types are: Rectangle, Circle, Line Vertical,
Line Horizontal, Line Top Bottom, Line right left and Rectangle Rounded.

7.4.8.2 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

Element blink IF Here can set a logic function to make the element blinks. In case of element visible,
if the logic function is TRUE, the element blinks; if the logic function is FALSE, the
element displays as fix label.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 78/88
DXTCButton

When needs to place a button on the screen, you can use this element. Double click the element can open
and edit its properties.

7.4.9.1 Properties Page

Locked on Scroll If checked, this button will display in every page of current stage with the same
position.

Caption The string typed here will be shown as the caption of the button. In addition, use
vocabulary could be another option. Note: If you want to select a B/W image for this
button display, the Caption must keep empty.

Font Color Allows setting the caption font color.

Background Color Allows setting the button background color

Font Allows selecting the font from the font list defined in the project option.

Stage Preview Show images preview.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 79/88
7.4.9.2 Image Page

On the right side of this window, list all the images defined in the image database. Double click on one image
can set it display in the front of the button. Click Reset button can clean the selected image.

7.4.9.3 Conditions Page

Element visible IF Here allows setting the elements visibility according to a logic function. If the logic
function is TRUE, the element is visible; if the logic function is FALSE, the element
is not visible. This logic function can be edited with Math Editor.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 80/88
7.4.9.4 Actions Page

Beep on pressed If checked, every time press this button, it will make a beep response.

Timeout Only if user keeps press this button for the seconds written in Timeout, then the
button action will be take effect actually.

Actions Action to associate at the key

In addition to the name of the key, it can be associated with the following functions:
Jumps to stage
Press passes to the stage selected

Active input
When pressing the button activates
the selected object.

Page UP
Press passes to the previous page
of the stage.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 81/88
Page DOWN
Press passes to the next stage.

Prev Element/UP Value


When pressing the button allows
you to switch between the active
elements of the stage and when the
item was enabled with the Enable
button, allows increasing the value
of the variable.

Next Element/DOWN Value


When pressing the button allows
you to switch between the active
elements of the stage and when the
item was enabled with the Enable
button, allows you to decrement the
value of the variable.

Conditional Jump to Stage


Press passes from one stage to
another in accordance with the
conditions laid down in the
Condition Stage Jump page.
Here is possible to execute a
operation before jumping.

Set Variables
Press enables writing the value of a
variable.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 82/88
Fast increment value
Press enables increase the value of
a variable. The new value will be
applied immediately without press
Active input button to confirm.

Value decrease fast


Press enables decrease the value
of a variable. The new value will be
applied immediately without press
Active input button to confirm.

Back to previous Stage +


cursor
Press jumps to the previous stage
from which enter in the current
stage. And the cursor will keep in
the previous position.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 83/88
7.5 REMOTE BUTTON

There is a system variable SYS_VKEY at the address 0xFFF4 that manages the remote keys of Visotouch.
When the value of this variable is other than 0, ensure the keyboard performs the associated keys function.

Note: the remote key you want to perform must be implemented as part of the stage(s).

The remote key has the same functions described in 7.4.9.

CmdId SYS_VKEY value

Name Button name

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 84/88
Execute/Set before Press enables writing the value of a variable.
jump

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 85/88
8. COMPILING AND DOWNLOADING PROJECT

8.1 COMPILING

Once you have completed the necessary changes to your project, you must run a build of the latter to find
any error or inconsistencies.
Filling is via the button in the toolbar and the debug log is visible in the actions list at the bottom.

Compile project

Hotkey: F9

If the compilation is successful, you will see all green check icons on the left of the actions list, otherwise you
will see the error jotifiche. To run the fixes just double click on the error and fix the bug.
At the end an entry will give us a run down on the number of warnings/errors in the project.
See the window below, on the left side, it shows the size of compiled items, including 4 Fonts size, images
size, variables size, vocabulary size and stages size.
On the right side, it shows the percentage of space used. If the percentage reaches 100%, means the
project is overloaded, it cant display properly.

Visotouch Limits

Dimensions:

Max Font = 500 Kb


Max Images =3072 Kb
Max Variables =170 Kb
Max Vocabulary =1024 Kb
Max Stage =1024 Kb

Font (500 Kb)


Max 4 font, the dimension depends on the fonts you are using (usually the max used % is 5%)

Images (3072 Kb)


B/W 1 bit (2 colors)
Colored 8 bit(256 colors). Every image has its own palette of 256.

Variables (170 Kb)


Variables Max 3000
Visibility Max 1000
Blink Max 1000

Vocabualry (1024 Kb)


Every string can be max 100 characters, therefore a vocabulary of 1 only language with 5243 strings of 100
characters is the max. Instead if the strings are of 80 characters 6553 is the max etc.
Every character occupies 2 bytes.

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 86/88
Stage (1024 Kb)
The Viso works using pages, not stages.
If a stage has only 1 page stage and page are the same.
If a stage has e.g. 3 pages a stage is considered as 3 pages.
Etc.
A page can have max 200 elements and 300 variables.
Max 100 pages if every page has 200 elements and 300 variables.
If the number of elements per page decreases or/and if the number of variables per page decreases the
total number of page is > 100.

8.2 DOWNLOADING PROJECT

When the project is compiled, the generated files are visocor.hex and visores.hex. There are two ways to
download the project to the controller.

1) Use USB stick (Visotouch)


Copy the visocor.hex and visores.hex files to USB stick (in FAT16 format). Power on the visotouch and plug
in the USB stick on the back of the screen. Then on the screen, it will show Application update? message.
Click OK button, the updating will start. You will hear two beeps at first, and then wait for three beeps.
Three beeps mean updating finished, after this you can remove the USB stick.

2) Click send project to device button (Visograph)


You also can download to the device by pressing the appropriate button in the toolbar, and on the next
screen, enter the IP address where to download the file.

Send your project to the device.

Hotkey: F10

Important: problems sending project.


If the project is loaded into the device or do not see the status of the upload, check:
Ipro Connection
IP Address
Baud-Rate
hex file name (must not be too long)
Control the size of the project

1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 87/88
1592010430 User Manual Visoprog 5 v1.1 12.10.2016 Visoprog 5 User Manual 88/88

Anda mungkin juga menyukai