buildings

The buildings module reads C Tech’s .BLDG file and creates various 3D objects (boxes, cylinders, wedge-shapes for roofs, simple houses etc.), and provides a means for scaling the objects and/or placing the objects at user specified locations. The objects are displayed based on x, y & z coordinates supplied by the user in a .bldg file, with additional scaling option controls on the buildings user interface.

Each object is made up of 3D volumetric elements. This allows for the output of buildings to be cut or sliced to reveal a cross section through the buildings.

Ports

Direction	Name	Type	Description
Output	Output	Field	A field containing the buildings.
Output	Output Object	Renderable	A renderable object displaying the buildings.

Properties

Property	Type	Description
Import File	String	Imports an existing .bldg file.
Reload Import File	Button	Forces the module to load the import file and run.
Z Scale	Double	The vertical exaggeration. Required to assure that buildings are matched to scaled input.
Building Height Scale	Double	Vertically exaggerates the height of each building.
Building Offset	Double	Moves all buildings vertically by the set amount.
Export File	String	Exports current buildings to a .bldg file.

Default Building Settings

Property	Type	Description
Default Name	String	The default name for each new building added.
Increment Building Id	Boolean	When enabled, new buildings have an identifier greater than the value of the last building on the list.
Default Offset	Double	The vertical offset for each new building.
Default Height	Double	The height for each new building.
Default Width	Double	The width for each new building.
Default Length	Double	The length for each new building.
Default Azimuth	Double	The azimuth to align each new building to.
Default Type	Choice: Box (0), Roof Gable (1), Wedge (2), Triangle (3), Right Triangle (4), 6 Sided Cylinder (5), 8 Sided Cylinder (6), 16 Sided Cylinder (7), 32 Sided Cylinder (8), 16 Sided Tank (9), 32 Sided Tank (10), Roof Corner 1 (11), Roof Corner 2 (12), Roof Corner 3 (13), Cone (14), 1 Story Building (15), 2 Story Building (16), 1 Story House (17), 2 Story House (18)	The type for each new building.
Default Id	Integer	The identifier for each new building.
Default Color	Color	The color for new buildings.

Building Settings

Property	Type	Description
Probe Action	Choice: None, Reset Position, Add Building	Changes the building center or adds a new building at the probed location. Only available when the viewer is connected.
Outline Current Building	Boolean	Turns on or off a bounding rectangle showing the current building being edited.
Delete Current Building	Button	Removes the currently selected building from the list of buildings.
Current Building	Choice	Selects a single building to edit.
Current Building Values	Building	The values for the currently selected building (type, name, ID, offset, color, coordinates, length, width, height, azimuth).

Sample Buildings File
Sample Buildings File Below is an example buildings file. Note that the last 4 columns are optional and contain RGB color values (three numbers from zero to 1.0) and/or a building ID number that can be used for coloring. If only color values are supplied (3 numbers) the ID is automatically determined by the row number. If four numbers are provided it is assumed that the last one is the ID. If only one number is provided it is the ID.

Sample Buildings File

Below is an example buildings file. Note that the last 4 columns are optional and contain RGB color values (three numbers from zero to 1.0) and/or a building ID number that can be used for coloring. If only color values are supplied (3 numbers) the ID is automatically determined by the row number. If four numbers are provided it is assumed that the last one is the ID. If only one number is provided it is the ID.

The file below is shown in a table (with dividing lines) for clarity only. The first uncommented line is the number 16 which defines the number of rows of buildings data. The actual file is a simple ASCII file with separators of space, comma and/or tab.

EVS

Copyright (c) 1994-2008 by

C Tech Development Corporation

All Rights Reserved

# This software comprises unpublished confidential information of

# C Tech Development Corporation and may not be used, copied or made

# available to anyone, except in accordance with the license

# under which it is furnished.

C Tech 3D Building file

Building 0 is a unit box with base at z=0.0 centered at origin x,y

Building 1 is a gabled roof for the unit box

# (to make it a house) with base at z=0.0 centered at origin x,y

Building 2 is a wedge roof for the unit box

# (to make it a house) with base at z=0.0 centered at origin x,y

Building 3 is a Equilateral (or Isoseles) Triangular Building 3 side

Building 4 is a Right Triangular Building 3 side

Building 5 is a Hexagonal (6 side) cylinder

Building 6 is a Octagonal (8 side) cylinder

Building 7 is a 16 side cylinder

Building 8 is a 32 side cylinder

Building 9 is a 16 sided horiz. cylindrical tank (Height & Width equal diameter, Length is along x)

Building 10 is a 32 sided horiz. cylindrical tank (Height & Width equal diameter, Length is along x)

Building 11 is a right angle triangle, height only at right angle

Building 12 is a right angle triangle, height at non-right angle

Building 13 is a right angle triangle, height at right angle and 1 non-right angle

Lines beginning with “#” are comments

First uncommented line is number of buildings

X Y Z LengthWidthHeight Angle Bldg_Type Color and/orID

0	0	10	50	50	20	0	0	1
0	100	0	50	50	30	30	0	2
0	100	30	60	50	20	30	1	2
0	200	0	50	50	30	10	0	3
0	200	30	50	50	25	10	2	3
200	0	0	50	50	50	0	3	4
100	100	0	40	40	20	15	4	5
200	100	0	40	40	30	30	5	6
200	200	0	50	50	50	0	6	7
100	200	0	40	60	20	-45	7	8
100	0	0	50	50	40	0	8	9
300	0	0	60	20	20	-45	9	0.8	0.6	0.4	10
300	100	0	50	50	30	0	10	0.4	0.6	0.4	11
0	300	0	50	50	50	0	11	1.0	0.4	0.4	12
100	300	0	50	50	50	0	12	0.4	1.0	0.4	13
200	300	0	50	50	50	0	13	0.4	0.4	1.0	14

0	0	10	50	50	20	0	0	1
0	100	0	50	50	30	30	0	2
0	100	30	60	50	20	30	1	2
0	200	0	50	50	30	10	0	3
0	200	30	50	50	25	10	2	3
200	0	0	50	50	50	0	3	4
100	100	0	40	40	20	15	4	5
200	100	0	40	40	30	30	5	6
200	200	0	50	50	50	0	6	7
100	200	0	40	60	20	-45	7	8
100	0	0	50	50	40	0	8	9
300	0	0	60	20	20	-45	9	0.8	0.6	0.4	10
300	100	0	50	50	30	0	10	0.4	0.6	0.4	11
0	300	0	50	50	50	0	11	1.0	0.4	0.4	12
100	300	0	50	50	50	0	12	0.4	1.0	0.4	13
200	300	0	50	50	50	0	13	0.4	0.4	1.0	14

0	0	10	50	50	20	0	0	1
0	100	0	50	50	30	30	0	2
0	100	30	60	50	20	30	1	2
0	200	0	50	50	30	10	0	3
0	200	30	50	50	25	10	2	3
200	0	0	50	50	50	0	3	4
100	100	0	40	40	20	15	4	5
200	100	0	40	40	30	30	5	6
200	200	0	50	50	50	0	6	7
100	200	0	40	60	20	-45	7	8
100	0	0	50	50	40	0	8	9
300	0	0	60	20	20	-45	9	0.8	0.6	0.4	10
300	100	0	50	50	30	0	10	0.4	0.6	0.4	11
0	300	0	50	50	50	0	11	1.0	0.4	0.4	12
100	300	0	50	50	50	0	12	0.4	1.0	0.4	13
200	300	0	50	50	50	0	13	0.4	0.4	1.0	14

buildings

buildings

Ports

Properties

Subsections of buildings

Sample Buildings File

EVS

Copyright (c) 1994-2008 by

C Tech Development Corporation

All Rights Reserved

C Tech 3D Building file

Building 0 is a unit box with base at z=0.0 centered at origin x,y

Building 1 is a gabled roof for the unit box

Building 2 is a wedge roof for the unit box

Building 3 is a Equilateral (or Isoseles) Triangular Building 3 side

Building 4 is a Right Triangular Building 3 side

Building 5 is a Hexagonal (6 side) cylinder

Building 6 is a Octagonal (8 side) cylinder

Building 7 is a 16 side cylinder

Building 8 is a 32 side cylinder

Building 9 is a 16 sided horiz. cylindrical tank (Height & Width equal diameter, Length is along x)

Building 10 is a 32 sided horiz. cylindrical tank (Height & Width equal diameter, Length is along x)

Building 11 is a right angle triangle, height only at right angle

Building 12 is a right angle triangle, height at non-right angle

Building 13 is a right angle triangle, height at right angle and 1 non-right angle

Lines beginning with “#” are comments

First uncommented line is number of buildings

X Y Z LengthWidthHeight Angle Bldg_Type Color and/orID

0	0	10	50	50	20	0	0	1
0	100	0	50	50	30	30	0	2
0	100	30	60	50	20	30	1	2
0	200	0	50	50	30	10	0	3
0	200	30	50	50	25	10	2	3
200	0	0	50	50	50	0	3	4
100	100	0	40	40	20	15	4	5
200	100	0	40	40	30	30	5	6
200	200	0	50	50	50	0	6	7
100	200	0	40	60	20	-45	7	8
100	0	0	50	50	40	0	8	9
300	0	0	60	20	20	-45	9	0.8	0.6	0.4	10
300	100	0	50	50	30	0	10	0.4	0.6	0.4	11
0	300	0	50	50	50	0	11	1.0	0.4	0.4	12
100	300	0	50	50	50	0	12	0.4	1.0	0.4	13
200	300	0	50	50	50	0	13	0.4	0.4	1.0	14