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 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.