VAD -- root directory

rcom -- common rcom package files tree in VAD root direcory

adagraph -- adgraph package

AdaOpenGl -- Ada To OpenGl interfase

ased -- ased IDL

august -- august HTML editor

corba -- Corba Ada Interface spacification

csh -- Xterminal package

fve -- FVE file editor

gifs -- gifs image collection

help -- Help files in HTML format tree with subdirectories

idl -- Corba to Ada translator

image -- bitmap collection

lib -- Tcl/Tk packages

projects -- Projects directories tree

samples -- Samples directories tree

session -- Sessions history

tkpaint -- Tkpaint image editor

tutorial -- VAD tutorial files in HTML format

vad72src -- VAD sources (without common rcom tree packages)

vtkgui -- VTK GUI builder

whiteboard -- Whiteboard image processor

Linux -- Linux binaries i386

win32 -- Windows binaries and componenets

xbit -- XBit image processor

xml -- XML parser files

XmlAda -- XMLADA parser package

VAD generates and uses *.gui file in text format for abstract

widgets descriptions. This file has a simple format and may be corrected

manually. You may associate *.gui file with VAD and load it directly.

VAD project file is part of yours project and build widgets tree from Toplevel

widget. In common project directory, you may create several VAD projects.

VAD generates next files :

<project name>.adb - main ada program

<project name>init.ads - initialized gui package

<project name>init.adb

<project name>event.ads - Event handlers package

<project name>event.adb ( empty functions for events).

<project name>.tcl - TCL script for quick check or TCL oriented project.

VAD project is a part of yours application and (as a rule) it builds toplevel root

widgets tree. Application may has several vad projects.

W A R N I N G ! Old ada files saved in *.$ds and *.$db files

W A R N I N G ! You may reset Gnat enviroמment, edit , compile, link and execute

generated ada files from Gnat menu

VAD need system variable VAD_HOME

for example : SET VAD_HOME=C:\VAD - for Windows

export VAD_HOME=/home/vad - for Unix(Linux)

New project you may create by NEW dialog in existing project directory

TCL/TK is a script language and it has many difference forms to describe widgets.

For widget placing I use disp (layout) property with follow values :

noplace

place

grid

pack (default)

setwidget (for BWidgets)

and manager property for tcl script building

W A R N I N G !!! You may use Layout wizard from WIZARD menu

to build script for used layout or to build embeded window (in canvas or text)

For example for placing widget .w.b in pack layout need to write

disp :pack

manager:.w.b -side top

If you want to pack several widgets in one pack (for example 3)

look at packbuton.gui sample.

In addcreate property you may write all addition information for widget

creation.

W A R N I N G !!! You may use Properties WIZARD from WIZARD menu

to build spesific widgets options

I tried to write online help for many of used properties and simple samples.

W A R N I N G !!! You may see Help for Widget by push F1 for selected Widget

(mouse on widget icon or active Properties Inspector for widget)

If VAD can not correct error EXCEPTION, it creates ABEND.GUI file.

I recommend to save information before property/event switching

by click Add Widget/Correct Widget button

In any time you may see widgets tree from View Tree (menu VIEW).

Widgets tree available in New Widget pathname dialog. On Widget's tree you may select

widget and load Properties Inspercor for it.

HELP menu allows by internal HTML viewer ( I use HTML_LIBRARY package

from Sun) and tkhtml (if it defined in tcl)

From Settings menu you may change some VAD definitions.

If you planed work with generated TCL script, you may turn off Emulate Tcl Proc

property.

I hope VAD will be useful for Ada (and TCL) programmers and easy in work. This is

an effective way to build gui oriented system independent applications in pure ADA-95.

VAD 7.6 supports many of image formats such as

BMP, XBM, XPM, GIF (with transparency), PNG, JPEG, TIFF, ICO, PCX, PPM, PIXMAP, SGI,

RAS, RGB, TGA, SUN , WINDOW and postscript(PS).

You need to install Img1.3 package and check it to work in Tcl/Tk.

W A R N I N G !!! You may animate animated gifs

For formats difference from xbm and gif you may use jpeg image type.

By icons package you may use a huge icons collections as tcl/tk image

A simple free Image editor TKpaint (with little changing ) by Samy Zafrany

An Adasource from RAPID image generator by Martin C. Carlisle

and Patrick Maes.

Widgets Table

1. Base TCL/TK widgets

toplevel frame button radiobutton checkbutton menubutton label entry

listbox canvas message menu item scrollbox scale text panedwindow spinbox

labelframe

W A R N I N G . Item widget you may use to :

1. Create menu item;

2. Create mclitBox column;

3. Create Tree node.

2. BWidgets

Button Label Entry ListBox

ArrowButton ProgressBar MainFrame LabelFrame LabelEntry TitleFrame

Dialog ScrolledWindow PanedWindow ButtonBox NoteBook (Page) SpinBox

Tree MessageDlg ProgressDlg ScrollableFrame ScrollView PagesManager

PasswdDlg

W A R N I N G ! If you use PanedWindow (or panedwindow in tcl/tk 8.5), you need

a. Create PanedWindow;

b. Create first page for PanedWindow (Page dialog);

c. Create all widgets in this page;

d. Create second page an so on.

3. Widgets from Bryan Oakley

combobox mclistBox

4. Direct executable Tcl script

TclScript

5. table widget from Tktable Package

W A R N I N G !!! You need to install Tktable package and check it to work in Tcl/Tk

6. Graph and Barchart widgets from BLT package

W A R N I N G !!! You need to install BLT package and check it to work in Tcl/Tk and

load from TCL Packages menu

7. CScrollbar (scrollbar analog)

W A R N I N G !!! You may copy widget's properties from building widget

to new by Copy from item (from WIZRD menu)

W A R N I N G !!! You may import widgets form other project(gui file)

by Import item (from Utils s menu)

8. html widget from Tkhtml package

9. OGLwin widget from Tkogl package or Tcl3d package

10. vtkTkRenderWidget and vtkTkImageViewerWidget from VTK (Visualization Tool Kit)

11. Scrolled Widgets (text canvas listbox mclistbox tktable html)

W A R N I N G !!! Scrolled widgets are built as frame with scrollbars and widget

Widget name is automatic tailes with .swd

Scrollbars are visible if need

12. Media widget (media for Unix MplayerTcl and movie for Windows and Mac QuickTimeTcl)

13. ttk widgets ( for Tcl/Tk 8.5.x and later)

VAD 7.6 has internal tcl packages support from Packages menu.

W A R N I N G !!! After loading,tcl package can not be unloaded.

If you have instaled Oratcl package and loaded it, you may

directly work with Oracle server from Oracle menu.

S a m p l e s L i s t

snack - Snack Sound extension

blt - BLT extension

blt.gui - Tables in BLT

graph.gui - Graphs in BLT

barchart.gui - Barchart in BLT

bwidgets - BWidgets extension (full support in VAD)

pagemgr.gui - pages manager

tree.gui - tree

mclist.gui - multicolumn list

combobox.gui - combobox

scrolledwindow.gui - scrollable window

nb.gui - notebook

colorfont.gui - colours and fonts

panedwindow.gui - paned window

buttonbox.gui - button box

dragdrop.gui - drag and drop

htext.gui - hyper text

tip.gui - tip window

ttkcombo.gui - ttk combobox

adavtk - VTK (Visualization Tool Kit) support in VAD

3dstudio - vtk sample 3DStudio MAX file import

vrlm2.0 - vtk sample 3DStudio MAX file import VRLM 2.0

puzzle - vtk sphere puzzle game

polyViewer - vtk file formats viewer

volGeo - vtk multirender sample

adatkvtk - vtk sample

adavtklens - vtk sample

textmv - vtk sample

WheelMouse - vtk sample with WheelMouse events handling

ftp - ftp complex example

itcl - I[ncr]tcl package extension

oracle - Oracle support in VAD (oratcl 2.6, oratcl 2.7, oratcl 3.0 oratcl 4.x)

odbc - ODBC support in VAD (tclodbc 2.1)

animation - Animated gifs in VAD example

scrcanv - scrollable frame as window in canvas example

money - complex example

HTML_Viewer - complex example internal HTML viewer

HV - complex example HTML viewer used Tkhtml3.0 package

Dirview - complex example

Find - complex example (find files by pattern with directory recursion)

Table - complex example (binary tree and access types in Ada-95)

Tktable - complex example Tktable widget in VAD (standard and scrolled variants)

HV - complex example html widget based html viewer

Calculator - complex example

Limits - complex example ( it demonstrates cursors in different

places of window)

Hanoi - the Hanoi tower sample

Philosophers - dinning philosophers sample

Sort - the sort sample (quick sort,shell, insertion sort)

Tetris - a simple tetris game with tasks

Fiveteen - a simple Fiveteen game

SokoBan - a Sokoban game by Jeff Godfrey

tix - Tix extension

tixeditgrid - Tix extension

fg - run executable from application

Quicktimevideo - Qiuck Time Video (QuickTimeTcl in Windows or MPlayerTcl in Unix(Linux) )

Tkogl - OpenGL texture sample

Tkogl - OpenGL nurbsdemo sample

Tkogl - OpenGL gencyldemo sample

Tcl3d - OpenGL planet sample

Tcl3d - OpenGL robot sample

Mpegmovie - MPEG movie for Windows and Unix by XBit 3.4 package

Video - DDW movie for Windows by XBit 4.0 package

Mci - Load Mplayer to play media in Windows with optcl package