Buildings

Contents

Introduction

The main use of GermaniumWeb is to view and manipulate buildings. You can add a building to the 3D scene by first loading a building file. After you load such a file, you can operate on parts of the building; add placemarks or lines and polygons; move the Eye around the building; and view a cross section of the scene.

A building viewed in GermaniumWeb

Loading a building file

You can load a building file using Load(). This is an asynchronous function which will load the building file in the background and inform you when it is done.

It accepts 4 parameters:

Source: buildings example

// Will be called if loading finishes successfully
function LoadOk()
{
	alert('Loading successful!');
}
 
// Will be called if loading fails
function LoadFail(errMsg, errCode)
{
	alert('Loading failed. Error code: ' + errCode + '; message: ' + errMsg);
}
 
// Load a building file
germ.Load("http://www.germanium3d.com/static/sample/generic_building/generic_building.xlcl",
	null, LoadOk, LoadFail);

Building, Block, Level (BBL)

GermaniumWeb models the 3D scene as follows:

We refer to this scene organization as the BBL (Building, Block, Level). The term BBL object refers to an object that may be a building, a block, or a level.

The BBL helps you to access the content of a building file. For example, you can tell GermaniumWeb to show only a specific level.

Levels other than the level with the BBL Id "L02" are hidden.

Source: buildings example

var building = germ.GetBuildingByIndex(0);
var block = building.GetBlockByBBLId("OFFICE");
var level = block.GetLevelByBBLId("L02");
level.HideLevelsAbove();
level.HideLevelsBelow();

You can see more examples in our Interactive Samples.

Building placement

When loading a building file, GermaniumWeb currently places building(s) into the 3D scene such that the origin of the file coincides with the origin of the native space. In a future release, the API will give you more control over the building's position.

Creating a building file

You can create your own building files using the tools provided at the Building Creator Network.

References

Retrieved from "http://www.germanium3d.com/code/BuildingConcepts"

This page has been accessed 43,075 times. This page was last modified on 28 February 2011, at 09:04.


Developers


Main

API Key Registration

Developer Guide
- Introduction
- Buildings
- Point Placemarks
- Line & Polygon      PlacemarksUpdated
- Model Placemarks New
- HTMLBoxes New
- Eye Control
- Clip Planes
- Events
- Coordinate System
- Navigation Modes
- Options

API Documentation

Examples
- Applications Gallery
- Hello Germanium
- Interactive samples

More Resources
- API Release Notes
- Developer FAQ
- "A Beginner's Guide" slides
- Training Materials
- Icon Gallery
- Sample Buildings
- BBL Tree

Report Bugs