com.visioglobe.VisioSample

Class VgMyGeometryManager

java.lang.Object

com.visioglobe.VisioSample.VgMyGeometryManager

public class VgMyGeometryManager
extends java.lang.Object

This class manages the dynamic geometries added to the map. It provides a centralized location for these dynamic objects, which facilitates the task of releasing them when the map is destroyed. Note: it's important to call the release() method of this class when the dynamic objects are no longer required.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	VgMyGeometryManager.LineObject
class	VgMyGeometryManager.LinkObject
class	VgMyGeometryManager.PointObject

Constructor Summary

Constructors

Constructor and Description
VgMyGeometryManager(VgMySurfaceView pSurfaceView)

Method Summary

Methods

Modifier and Type	Method and Description
void	addObjects() Adds objects to the 3d Module that are related to the current dataset
void	addObjects(java.lang.String pContext)
VgLineRefPtr	createLineObject(java.lang.String pContext, java.lang.String pLayerName, VgLineDescriptorRefPtr lLineDescr) Creates a line object
VgLinkRefPtr	createLinkObject(java.lang.String pContext, VgLinkDescriptorRefPtr pLinkDescr) Creates a Link object
VgMyGeometryManager.PointObject	createPointObject(java.lang.String pContext, java.lang.String pLayerName, VgPointDescriptorRefPtr lPointDesc, VgIGeometryCallbackRefPtr pCallback) Creates a Point object
void	deleteObjects(java.lang.String pContext) Deletes objects associated with a context Note: The objects must have been removed first, using removeObjects().
void	release() This method should be called by the activity to notify the controller that it should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.
void	removeObjects() Removes all objects Note: Will remove any callbacks associated with Point Objects.
void	removeObjects(java.lang.String pContext) Removes all objects associated with a Context Note: Will remove any callbacks associated with Point Objects.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VgMyGeometryManager

public VgMyGeometryManager(VgMySurfaceView pSurfaceView)

Method Detail

addObjects

public void addObjects()

Adds objects to the 3d Module that are related to the current dataset

addObjects

public void addObjects(java.lang.String pContext)

createLineObject

public VgLineRefPtr createLineObject(java.lang.String pContext,
                            java.lang.String pLayerName,
                            VgLineDescriptorRefPtr lLineDescr)

Creates a line object

Parameters:

pContext, - the context with which to associate the object

pLineDescr, - line descriptor.

pLayerName - Layer it is in.

Returns:

The created VgLineRefPtr object. This may be used by the calling object to further control aspects.

createPointObject

public VgMyGeometryManager.PointObject createPointObject(java.lang.String pContext,
                                                java.lang.String pLayerName,
                                                VgPointDescriptorRefPtr lPointDesc,
                                                VgIGeometryCallbackRefPtr pCallback)

Creates a Point object

Parameters:

pContext - The context with which to associate the object.

pLayerName - Layer it is in.

lPointDesc - Point descriptor.

pCallback - The callback object to be notified of events occurring on the Point object being created.

Returns:

PointObject The PointObject is returned here, because if it's desired to update the associated layer, it's important to update the layer mentioned within the PointObject and also the layer associated with the VgPoint object.

createLinkObject

public VgLinkRefPtr createLinkObject(java.lang.String pContext,
                            VgLinkDescriptorRefPtr pLinkDescr)

Creates a Link object

Parameters:

pContext - The context with which to associate the object.

pLinkDesc - The link descriptor to instantiate.

removeObjects

public void removeObjects(java.lang.String pContext)

Removes all objects associated with a Context Note: Will remove any callbacks associated with Point Objects.

Parameters:

pContext, - the context which denotes which objects to remove.

removeObjects

public void removeObjects()

Removes all objects Note: Will remove any callbacks associated with Point Objects.

deleteObjects

public void deleteObjects(java.lang.String pContext)

Deletes objects associated with a context Note: The objects must have been removed first, using removeObjects().

release

public void release()

This method should be called by the activity to notify the controller that it should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.