Reference objects are referred to by other objects, parts, or links in which the Object Reference is entered as the value of an attribute. The GUI Control Type section in Chapter 1 introduces the type for class attributes and the use of Input Assistant to enter the value.
An Object Reference typed attribute identifies, within its definitions, all possible classes of reference objects. This implies that the name of the reference object entered may be ambiguous in all the reference objects derived from these possible classes. When ambiguous object name occurs, you need to enter the entire object name path rather than just the name of the object. An object name path contains the whole class path and the object name with an underscore '_' in-between. The recommended ways of creating a reference object and its reference are:
Create the reference object first, using the procedures described in the Creating Objects section. Once the reference object is created, use the Input Assistant to find the object.
If the reference object does not exist, type in an unique name for the reference object in the field of Reference Object type. The name string will be displayed in blue. Double click on it or select Open from the context menu (right click on the field) to invoke the Object Properties dialog for entering the values.
There are domain-specific classes of reference objects defined by your simulator that may or may not be selected. Here we describe them in general. Please look into your simulator's documentation for specific details.
The definition of cell and array attributes can be found in the end of the GUI Control Types section. A Collection object contains a list of cell attributes, which can be of different GUI control types. All the attributes are defined by the simulation developer; there is no intrinsic attribute defined by SansGUI.
Graphics objects are similar to Collection objects and, in addition, can be viewed in 3-dimensional scenes with Graphics Windows. A Graphics Window can be opened in two ways:
Select View Object from the right-click context menu of a Graphics object.
Click on the View Object button in the Object Properties dialog of a Graphics object.
SansGUI supports hardcopy printing, copying to windows clipboard, and exporting to bitmap (.BMP) or JPEG (.JPG) image file formats of graphic scenes in Graphics Windows. All these functions can be performed by selecting the corresponding menu items in the right-click context menu within the Graphics Windows. Please refer to Point of Attraction 5: Solid in the SansGUI Getting Started guide, the Class Graphics section of the SansGUI Reference Manual, and your simulator documentation for more operational details.
In addition, please take a look at 3D Graphics Rendering Options in the Tuning Environment Parameters section in the Customizing SansGUI Environment chapter of this manual.
A Matrix object contains three cell attributes for the specification of the matrix and an array attribute defined by the simulation developer.
Number of Columns (iCols): The number of columns in the matrix. It cannot be less than 1.
Number of Rows (iRows): The number of rows in the matrix. It cannot be less than 1.
Number of Sheets (iSheets): The number of sheets of a three dimensional matrix. When the value of this attribute is greater than 1, the matrix becomes 3-dimensional. There is a limit of 200 sheets in a matrix.
Array Attribute: This attribute is defined by the simulation developer and it specifies the data type of the matrix.
You can use the matrix Object Properties dialog to enter the matrix. The first tab in the Properties dialog shows the specification of the matrix. The Data sheets are appended to the end, depending upon the Number of Sheets value. The array attribute may have a measuring unit associated with it. You can select a preferred unit from the Specification sheet in the Properties dialog. When the unit is changed, all the data in the matrix will be recalculated.
A Table object may be row or column oriented, meaning that its table attributes are aligned along the rows or columns, respectively. A row oriented table has its attributes listed in the row headers at left and a column oriented table has its attributes listed in the column headers at top. There are two intrinsic attributes:
Table Size (iSize): The number of columns (for row oriented tables) or rows (for column oriented tables) to be allocated for the table.
Number of Sheets (iSheets): The number of sheets for multiple tables. It becomes 3-dimensional when the value is greater than 1. There is a limit of 200 sheets in a table.
There are also simulator defined attributes, which are used as table headers. The indicators, units, and data arrays associated with the attributes for data editing are similar to those of cell attributes.
SansGUI Modeling and Simulation Environment Version 1.2
Copyright © 2000-2003 ProtoDesign, Inc. All rights reserved.