VisualDCT Graphical Data Reference
Project:	VisualDCT
Classification:	User's Manual
Identification:	CSL-MAN-02-xxxxxx
Copyright © 2002 by Cosylab Ltd. All Rights Reserved.

Document History

Revision	Date	Author	Section	Modification
0.9	2002-10-19	Matej Sekoranja
			all	Created.
1.0	2003-07-18	Matej Sekoranja
			all	Added hierarchy related data.

Scope

This document specifies how VisualDCT stores its visual data about graphics layout.

Confidentiality

This document is classified as a public document. Redistribution and use, with or without modification, are permitted provided that:

1. the copyright notice is retained
2. a reference to the original document is made in case of modifications
3. this document may not be distributed for profit except as explicitly permitted by valid licenses.

Audience

The audience of this document are all developers of EPICS tools wishing to create visual VisualDCT EPICS databases.

References

ID	Author	Reference	Revision	Date	Publisher
1	Matej Sekoranja	VisualDCT Project		2002	Cosylab, Ltd.
2	Matej Sekoranja	VisualDCT latest build	2.3.1237	2002	Cosylab, Ltd.

Table of Contents

How to Read this Document

This document's meta-information (authors, revision history, table of contents, ...) can be found above. What follows below is the body of the document. The body is composed of several sections, which may be further composed of subsections.

Typographical styles are used to denote entities of different kinds. For a full list of entities and their respective typographic conventions, please refer to the Styles section of the XML Documentation document.

When viewing the document in a non-printed form, it is possible to submit comments regarding a given section to the document's owner. This is achieved by clicking the mail icon next to the section title. For this to work, your mail must be configured to properly handle the mailto URLs.

VisualDCT creates and maintains only one file, the record instance database (.db or .vdb) file, and does not have any additional graphical information file avoiding any possible consistency problems when having multiple files, all necessary visual composition data is stored as comments at the end of the DB file.
All visual VisualDCT data begin with #! prefix.

• color - RGB value representing the color (bits 24-31 are alpha, 16-23 are red, 8-15 are green, 0-7 are blue).
• boolean types - false if 0, true otherwise.

				  
			#! Record("recordname", xpos, ypos, color, rotated, "description")
				

Listing 1: Record visual data

				  
			#! Group("groupname", xpos, ypos, color, "description")
				

Listing 2: Group visual data

				  
			#! Field("fieldname", color, rotated, "description")
				

Listing 3: Field visual data

				  
			#! Visibility("fieldname", visibility)
			
			visibility:
				0 - NON_DEFAULT_VISIBLE
				1 - ALWAYS_VISIBLE
				2 - NEVER_VISIBLE

Listing 4: Visibility visual data

				  
			#! Link("fieldname", inLinkID)
				

Listing 5: Link visual data

				  
			#! Connector("inLinkID", outLinkID, xpos, ypos, color, "description")
				

Listing 6: Connector visual data

				  
			#! TemplateInstance("id", x, y, color, "desc")
				

Listing 7: Template visual data

				  
			#! TemplateField("template instance id", "fieldName", color, isRight, visibility)
				

Listing 8: Template field visual data

				  
			#! ConstantPort(portname, inLinkID, xpos, ypos, color, defaultVisibility)
			#! InputPort(portname, inLinkID, xpos, ypos, color, defaultVisibility)
			#! OutputPort(portname, inLinkID, xpos, ypos, color, defaultVisibility)
				

Listing 9: Ports field visual data

				  
			#! InputMacro(macroname, description, xpos, ypos, color, defaultVisibility, textPositionNorth)
			#! OutputMacro(macroname, description, xpos, ypos, color, defaultVisibility, textPositionNorth)
				

Listing 10: Macros field visual data

				  
			#! Line(id, xpos, ypos, xpos2, ypos2, dashed, startArrow, endArrow, color, parentBorderID)
				

Listing 11: Line/Arrow visual data

				  
			#! Box(id, xpos, ypos, xpos2, ypos2, dashed, color, parentBorderID)
				

Listing 12: Box visual data

				  
			#! TextBox(id, xpos, ypos, xpos2, ypos2, border, fontFamilyName, fontSize, fontStyle, color, "text", parentBorderID)
				

Listing 13: TextBox visual data

				  
			#! DBDSTART
			#! DBD("DBD filename1")
			...
			#! DBD("DBD filenameN")
			#! DBDEND
				

Listing 14: DBD Info Block visual data

				  
			// skip one line
			#! SKIP
			
			// skip n lines
 			#! SKIP(number of lines)
				

Listing 15: Skip visual data

				  
			#! View(xoffset, yoffset, scale)
				

Listing 16: Workspace view

This document will probably change in it the future.