com.esri.arcgis.geodatabaseextensions
Class TerrainBlobWriter

java.lang.Object
  com.esri.arcgis.geodatabaseextensions.TerrainBlobWriter

All Implemented Interfaces:

ITerrainBlobWriter, com.esri.arcgis.interop.RemoteObjRef, Serializable

public class TerrainBlobWriter
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ITerrainBlobWriter

Esri Terrain blob writer.

Description

TerrainBlobWriter is an object used to create terrain point attributes packed into binary large objects (BLOBs). These BLOBs are used to store attribution for points clustered into multipoint shapes. For each point in a multipoint you should have a corresponding value in a BLOB. Point vertex IDs are used to map from points to their corresponding values in the BLOB. Use the TerrainBlobReader to retrieve values from BLOBs made by this object.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:

Serialized Form

Constructor Summary

TerrainBlobWriter()
Constructs a TerrainBlobWriter using ArcGIS Engine.

TerrainBlobWriter(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TerrainBlobWriter theTerrainBlobWriter = (TerrainBlobWriter) obj;

Method Summary

void	addValue(Object value) Adds an attribute value to the blob.
void	beginAddingValue(int type) Initialize a new blob with the specified data type.
IMemoryBlobStream	endAddingValue() Completes writing the blob and returns a reference to the blob object.
boolean	equals(Object o) Compare this object with another
static String	getClsid() getClsid.
int	getItemCount() Returns the number of attribute values contained in the blob.
int	hashCode() the hashcode for this object

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

TerrainBlobWriter

public TerrainBlobWriter()
                  throws IOException,
                         UnknownHostException

Constructs a TerrainBlobWriter using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

TerrainBlobWriter

public TerrainBlobWriter(Object obj)
                  throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TerrainBlobWriter theTerrainBlobWriter = (TerrainBlobWriter) obj;

Construct a TerrainBlobWriter using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to TerrainBlobWriter.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

beginAddingValue

public void beginAddingValue(int type)
                      throws IOException,
                             AutomationException

Initialize a new blob with the specified data type.

Description

BeginAddingValue is used to initialize a new BLOB to one of the supported numeric types (see esriTerrainBlobDataType). All values in an individual TerrainBlob are the same type; homogeneous.

After calling BeginAddingValue you use ITerrainBlobWriter.AddValue to populate the BLOB.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:

beginAddingValue in interface ITerrainBlobWriter

Parameters:

type - A com.esri.arcgis.geodatabaseextensions.esriTerrainBlobDataType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addValue

public void addValue(Object value)
              throws IOException,
                     AutomationException

Adds an attribute value to the blob.

Description

Ideally, the variable type used for assignment should match the BLOB type (see ITerrainBlobWriter.BeginAddingValue) to ensure the value is properly maintained. Since this is not always possible (e.g., VB does not support 'char'), for flexibility the value is cast so you are not forced to use the same types. If the types don't match the value may get mangled if it's outide the BLOB type's range.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:

addValue in interface ITerrainBlobWriter

Parameters:

value - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getItemCount

public int getItemCount()
                 throws IOException,
                        AutomationException

Returns the number of attribute values contained in the blob.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:

getItemCount in interface ITerrainBlobWriter

Returns:

The pcItems

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

endAddingValue

public IMemoryBlobStream endAddingValue()
                                 throws IOException,
                                        AutomationException

Completes writing the blob and returns a reference to the blob object.

Description

EndAddingValue indicates there are no more values to be added. This completes and returns a TerrainBlob object. It can be interpreted by the TerrainBlobReader.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Specified by:

endAddingValue in interface ITerrainBlobWriter

Returns:

A reference to a com.esri.arcgis.system.IMemoryBlobStream

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.