AutoCAD Map 3D 2009 Geospatial Platform Reference

AutoCAD Map 3D Geospatial Platform API

MgMultiPoint Class Reference
[MgMultiPoint]

Inherits MgAggregateGeometry.

List of all members.


Detailed Description

An MgMultiPoint is a 0 dimensional aggregate geometry whose elements are MgPoint geometries.

Remarks:
The points are not connected or ordered. An instance of this class is constructed by calling a non-static MgGeometryFactory::CreateMultiPoint() method and, once constructed, is immutable.
Example (PHP)
The following code shows the construction of an MgMultiPoint geometry. Review the MgPoint Class example code.
 // A helper class additional to those created in the
 // MgPoint example code is needed.
 $pointCollection = new MgPointCollection();

 // After each MgPoint geometry is constructed,
 // it is added to an MgPointCollection.
 $index = $pointCollection->Add($point);
 echo "A point is added to a point collection at index: $index\n";

 // construct the MgMultiPoint geometry
 $multiPoint = $geometryFactory->CreateMultiPoint($pointCollection);

 // print out the Agf Text string for the geometry
 $multiPointAgfText = $wktReaderWriter->Write($multiPoint);

 echo "AGF Text representation of MultiPoint: $multiPointAgfText\n";

Example (C#)
The CreateAMultiPointXY method calls the CreateAPointXY method. The code for the CreateAPointXY method is in the MgPoint example code.

 using OSGeo.MapGuide;

 private MgWktReaderWriter wktReaderWriter;
 private MgGeometryFactory geometryFactory;
 private MgMultiPoint mpt1121;
 private double[,] da1121 = { { 1, 1 }, { 2, 1 } };
 private String geometryAgfText;

 public MgMultiPoint CreateAMultiPointXY(double[,] multiPointData)
 {
     MgPointCollection points = new MgPointCollection();
     for (int i = 0; i < multiPointData.GetLength(0); i++)
     {
         points.Add(CreateAPointXY(multiPointData[i, 0], multiPointData[i, 1]));
     }
     return geometryFactory.CreateMultiPoint(points);
 }

 geometryFactory = new MgGeometryFactory();
 mpt1121 = CreateAMultiPointXY(da1121);

 // print out the Agf Text string for the geometry
 wktReaderWriter = new MgWktReaderWriter();
 geometryAgfText = wktReaderWriter.Write(mpt1121);
 // geometryAgfText now contains:
 // "MULTIPOINT XY ( 1 1, 2 1 )"


Public Member Functions

virtual
MgGeometricEntity
Copy ()
virtual INT32 GetCount ()
virtual INT32 GetDimension ()
 
virtual INT32 GetGeometryType ()
virtual MgPointGetPoint (INT32 index)
 
virtual bool IsClosed ()
virtual bool IsEmpty ()
 
virtual
MgGeometricEntity
Transform (MgTransform *transform)
 Returns a transformed copy of this geometric entity.