com.esri.arcgis.geodatabaseextensions
Class TerrainBlobWriter

java.lang.Object
  extended by 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.