ArcObjects Library Reference (Geometry)  

esriMultiPatchRingType Constants

MultiPatch Ring Types.

Constant Value Description
esriMultiPatchInvalidRing 1 Invalid Ring.
esriMultiPatchUndefinedRing 2 Ring type has not been defined.
esriMultiPatchFirstRing 4 The beginning FirstRing in a FirstRing/Ring sequence.
esriMultiPatchRing 8 A following Ring in a FirstRing/Ring sequence or a beginning Ring in a solo Ring group.
esriMultiPatchOuterRing 16 The beginning OuterRing in an OuterRing/InnerRing sequence.
esriMultiPatchInnerRing 32 A following InnerRing in an OuterRing/InnerRing sequence.
esriMultiPatchBeginningRingMask 28 A mask of valid beginning rings (OuterRings, FirstRings, and solo Rings).
esriMultiPatchFollowingRingMask 40 A mask of valid following rings (InnerRings and Rings).
esriMultiPatchProblemCaseRingMask 3 A mask of problematic rings (UndefinedRings and InvalidRings).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.
[C#]

private static object _missing = Type.Missing;

public static IGeometry GetMultiPatchGeometry()

{

  const int XRange = 16;

  const int YRange = 16;

  const int InteriorRingCount = 25;

  const double HoleRange = 0.5;

  //RingGroup: Square Lying In XY Plane With Single Exterior Ring

   //And Multiple Interior Rings



  IGeometryCollection multiPatchGeometryCollection = new MultiPatchClass();

  IMultiPatch multiPatch =multiPatchGeometryCollection as IMultiPatch;



  //Exterior Ring

  IPointCollection exteriorRingPointCollection = new RingClass();



  exteriorRingPointCollection.AddPoint(ConstructPoint3D(0.5 * (XRange + 2),-0.5 * (YRange + 2), 0),ref _missing, ref _missing);

  exteriorRingPointCollection.AddPoint(ConstructPoint3D(-0.5 * (XRange + 2), -0.5 * (YRange + 2), 0), ref _missing, ref _missing);

  exteriorRingPointCollection.AddPoint(ConstructPoint3D(-0.5 * (XRange + 2), 0.5 * (YRange + 2),0), ref _missing, ref _missing);

  exteriorRingPointCollection.AddPoint(ConstructPoint3D(0.5 * (XRange + 2),0.5 * (YRange + 2), 0), ref _missing, ref _missing);



  IRing exteriorRing = exteriorRingPointCollection as IRing;

  exteriorRing.Close();



  multiPatchGeometryCollection.AddGeometry(exteriorRing as IGeometry, ref _missing, ref _missing);

  multiPatch.PutRingType(exteriorRing,esriMultiPatchRingType.esriMultiPatchOuterRing);



  //Interior Rings

  Random random = new Random();



  for (int i = 0; i < InteriorRingCount; i++)

  {

    double interiorRingOriginX = XRange * (random.NextDouble() - 0.5);

    double interiorRingOriginY = YRange * (random.NextDouble() - 0.5);



    IPointCollection interiorRingPointCollection = new RingClass();

    interiorRingPointCollection.AddPoint(ConstructPoint3D(interiorRingOriginX - 0.5 * HoleRange, interiorRingOriginY - 0.5 * HoleRange, 0), ref _missing, ref _missing);

    interiorRingPointCollection.AddPoint(ConstructPoint3D(interiorRingOriginX + 0.5 * HoleRange, interiorRingOriginY - 0.5 * HoleRange, 0), ref _missing, ref _missing);

    interiorRingPointCollection.AddPoint(ConstructPoint3D(interiorRingOriginX + 0.5 * HoleRange, interiorRingOriginY + 0.5 * HoleRange, 0), ref _missing, ref _missing);

    interiorRingPointCollection.AddPoint(ConstructPoint3D(interiorRingOriginX - 0.5 * HoleRange,interiorRingOriginY + 0.5 * HoleRange, 0), ref _missing, ref _missing);



    IRing interiorRing = interiorRingPointCollection as IRing;

    interiorRing.Close();



    multiPatchGeometryCollection.AddGeometry(interiorRing as IGeometry,ref _missing, ref _missing);



    multiPatch.PutRingType(interiorRing, esriMultiPatchRingType.esriMultiPatchInnerRing);

  }



  return multiPatchGeometryCollection as IGeometry;

}



public static IPoint ConstructPoint3D(double x, double y, double z)

{

  IPoint point = ConstructPoint2D(x, y);

  point.Z = z;



  return point;

}



public static IPoint ConstructPoint2D(double x, double y)

{

  IPoint point = new PointClass();

  point.PutCoords(x, y);



  return point;

}

.NET Samples

3D multipatch examples (Code Files: CompositeExamples RingGroupExamples) |