Products
Professional Services
Demos and Downloads
Help and Support
Products
Professional Services
Demos and Downloads
Help and Support
This is an old revision of the document!
This class represents an ellipse that is defined with a center point, a height and a width.
This constructor creates the EllipseShape.
None
This constructor creates the EllipseShape.
Using this overload will create a circle.
center
This constructor creates the EllipseShape.
Using this overload will create a circle.
centerPointFeature
This constructor creates the EllipseShape.
None
center
verticalRadius
horizontalRadius
This constructor creates the EllipseShape.
None
wellKnownText
This constructor creates the EllipseShape.
This overload will create a circle.
center
shapeUnit
This constructor creates the EllipseShape.
This overload will create a circle.
centerPointFeature
shapeUnit
This constructor creates the EllipseShape.
None
center
verticalRadius
unitOfRadius
horizontalRadius
shapeUnit
N/A
distance
quadrantSegments
bufferCapType
shapeUnit
distanceUnit
N/A
distance
shapeUnit
distanceUnit
N/A
distance
quadrantSegments
shapeUnit
distanceUnit
N/A
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
shapeSrid
returningUnit
distanceCalculationMode
N/A
N/A
Return Value
shapeProj4ProjectionParameters
returningUnit
distanceCalculationMode
N/A
N/A
Return Value
shapeSrid
returningUnit
distanceCalculationMode
N/A
N/A
Return Value
shapeProj4ProjectionParameters
returningUnit
distanceCalculationMode
N/A
N/A
Return Value
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
N/A
Return Value
targetFeature
shapeUnit
distanceUnit
N/A
N/A
Return Value
targetShape
shapeUnit
distanceUnit
N/A
N/A
N/A
N/A
Return Value
N/A
N/A
Return Value
This method returns the height of the EllipseShape in the unit specified in the returningUnit parameter.
None
Return Value
shapeUnit
returningUnit
N/A
N/A
N/A
N/A
Return Value
N/A
N/A
N/A
N/A
This method returns the tangent points of the current ellipse in relation to the target ellipse you specify.
This operation is useful for finding the corridor between two ellipses. It would be handy in a buffering type of scenario.
Return Value
targetEllipse
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
This method returns the width of the EllipseShape in the unit specified in the returningUnit parameter.
None
Return Value
shapeUnit
returningUnit
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
fromPoint
toPoint
fromUnit
toUnit
N/A
fromPoint
toPoint
fromUnit
toUnit
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
This method allows you to set the height of the EllipseShape in the unit specified in the unitOfWidth.
None
Return Value
newHeight
shapeUnit
unitOfHeight
This method allows you to set the width of the EllipseShape in the unit specified in the unitOfWidth parameter.
None
Return Value
newWidth
shapeUnit
unitOfWidth
N/A
N/A
shapeUnit
tolerance
toleranceUnit
simplificationType
This method returns the current shape as a PolygonShape.
This method is mainly used to convert a GIS non-standard shape to a GIS standard shape.
Return Value
vertexCountInQuarter
This method returns the current shape as a PolygonShape.
This method is mainly used to convert this non GIS standard shape to a GIS standard shape.
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
distance
angleInDegrees
shapeUnit
distanceUnit
N/A
N/A
Return Value
xOffsetDistance
yOffsetDistance
shapeUnit
distanceUnit
N/A
N/A
Return Value
N/A
N/A
N/A
N/A
distance
quadrantSegments
bufferCapType
shapeUnit
distanceUnit
This method returns a complete copy of the shape without any references in common.
When you override this method, you need to ensure that there are no references in common between the original and copy.
Return Value
This method returns whether the targetShape lies within the interior of the current shape.
Overriding: Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
shapeProj4ProjectionParameters
returningUnit
distanceCalculationMode
N/A
N/A
Return Value
shapeProj4ProjectionParameters
returningUnit
distanceCalculationMode
This method returns the area of the shape, which is defined as the size of the region enclosed by the figure.
You would use this method to find the area inside of a shape.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
shapeUnit
returningUnit
This method calculates the smallest RectangleShape that encompasses the entire geometry.
The GetBoundingBox method calculates the smallest RectangleShape that can encompass the entire geometry by examining each point in the geometry. Depending on the number of PointShapes and complexity of the geometry, this operation can take a significant amount of time (the larger the objects, the more time the operation will take). If the shape is a PointShape, then the bounding box's upper left and lower right points will be equal. This will create a RectangleShape with no area.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
N/A
This method returns the point of the current shape that is closest to the target shape.
This method returns point of the current shape that is closest to the target shape. It is often the case that the point returned is not a point of the object itself. An example would be a line with two points that are far apart from each other. If you set the targetShape to be a point midway between the points but a short distance away, the method would return a point that is on the line, but not one of the two points that make up the line.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
targetShape
shapeUnit
N/A
This method returns the crossing points of the current shape and the passed-in target shape.
As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.
Return Value
N/A
This method computes the distance between the current shape and the targetShape.
In this method, we compute the closest distance between two shapes. The returned unit will be in the unit of distance specified in the distanceUnit parameter.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
targetShape
shapeUnit
distanceUnit
N/A
N/A
Return Value
N/A
This method returns the perimeter of the shape, which is defined as the sum of the lengths of all its sides.
You would use this method to find the distance around the area shape. Overriding: Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
shapeUnit
returningUnit
N/A
N/A
This method returns a byte array that represents the shape in well-known binary.
This method returns a byte array that represents the shape in well known binary. Well-known binary allows you to describe geometries as a binary array. Well-known binary is useful when you want to save a geometry in an efficient format using as little space as possible. An alternative to well-known binary is well-known text, which is a textual representation of a geometry object. We also have methods that work with well-known text.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
byteOrder
vertexCountInQuarter
This method returns a byte array that represents the shape in well-known binary.
This method returns a byte array that represents the shape in well known binary. Well-known binary allows you to describe geometries as a binary array. Well-known binary is useful when you want to save a geometry in an efficient format using as little space as possible. An alternative to well-known binary is well-known text, which is a textual representation of a geometry object. We also have methods that work with well-known text.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
outerRingOrder
byteOrder
N/A
N/A
Return Value
outerRingOrder
byteOrder
vertexCountInQuarter
N/A
N/A
Return Value
This method returns the well-known text representation of this shape.
This method returns a string that represents the shape in well-known text. Well-known text allows you to describe geometries as a string of text. Well-known text is useful when you want to save a geometry in a format such as a text file, or when you simply want to cut and paste the text between other applications. An alternative to well-known text is well-known binary, which is a binary representation of a geometry object. We also have methods that work with well-known binary. Below are some samples of what well-known text might look like for various kinds of geometries.POINT(5 17)LINESTRING(4 5,10 50,25 80)POLYGON1)MULTIPOINT(3.7 9.7,4.9 11.6)MULTILINESTRING2)MULTIPOLYGON3),4))Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
This method returns the well-known text representation of this shape.
This method returns a string that represents the shape in well-known text. Well-known text allows you to describe geometries as a string of text. Well-known text is useful when you want to save a geometry in a format such as a text file, or when you simply want to cut and paste the text between other applications. An alternative to well-known text is well-known binary, which is a binary representation of a geometry object. We also have methods that work with well-known binary. Below are some samples of what well-known text might look like for various kinds of geometries.POINT(5 17)LINESTRING(4 5,10 50,25 80)POLYGON5)MULTIPOINT(3.7 9.7,4.9 11.6)MULTILINESTRING6)MULTIPOLYGON7),8))Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
vertexCountInQuarter
This method returns the well-known type for the shape.
None
Return Value
This method returns whether the current shape and the targetShape have at least one point in common.
Overriding: Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
N/A
Return Value
This method hydrates the current shape with its data from well-known binary.
This is used when you want to hydrate a shape based on well-known binary. You can create the shape and then load the well-known binary using this method.
Return Value
wellKnownBinary
This method hydrates the current shape with its data from well-known text.
None
Return Value
wellKnownText
N/A
N/A
Return Value
N/A
N/A
Return Value
N/A
This method returns a BaseShape which has been registered from its original coordinate system to another based on two anchor PointShapes.
Registering allows you to take a geometric shape generated in a planar system and attach it to the ground in a Geographic Unit.A common scenario is integrating geometric shapes from external programs (such as CAD software or a modeling system) and placing them onto a map. You may have the schematics of a building in a CAD system and the relationship between all the points of the building are in feet. You want to then take the CAD image and attach it to where it really exists on a map. You would use the register method to do this.Registering is also useful for scientific modeling, where software models things such as a plume of hazardous materials or the fallout from a volcano. The modeling software typically generates these models in a fictitious planar system. You would then use the register to take the abstract model and attach it to a map with real coordinates.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
fromPoint
toPoint
fromUnit
toUnit
This method rotates the shape a number of degrees based on a pivot point.
This method rotates the shape by a number of degrees based on a pivot point. By placing the pivot point in the center of the shape, you can acheive in-place rotation. By moving the pivot point outside of the center of the shape, you can translate the shape in a circular motion. Moving the pivot point further away from the center will make the circular area larger.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
pivotPoint
degreeAngle
This method decreases the size of the area shape by the percentage given in the percentage parameter.
Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
percentage
N/A
N/A
Return Value
This method increases the size of the area shape by the percentage given in the percentage parameter.
This method is useful when you would like to increase the size of the shape. Note that a larger percentage will scale the shape up faster, as you are applying the operation multiple times. There is also a ScaleDown method that will shrink the shape.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
percentage
N/A
N/A
N/A
Return Value
This method moves the base shape from one location to another based on a direction in degrees and distance.
This method moves the base shape from one location to another based on angleInDegrees and distance parameter. It is important to note that with this overload the distance units are based on the distanceUnit parameter. For example, if your shape is in decimal degrees and you call this method with a distanceUnit in miles, you're going to move this shape a number of miles based on the distance and the angleInDegrees. In this way, you can easily move a shape in decimal degrees five miles to the north.If you pass a distance of 0, then the operation is ignored.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
distance
angleInDegrees
shapeUnit
distanceUnit
This method moves the base shape from one location to another based on an X and Y offset distance.
This method moves the base shape from one location to another based on an X and Y offset distance. It is important to note that with this overload the X and Y offset units are based on the distanceUnit parameter. For example, if your shape is in decimal degrees and you call this method with an X offset of one and a Y offset of one, you're going to move this shape one unit of the distanceUnit in the horizontal direction and one unit of the distanceUnit in the vertical direction. In this way, you can easily move a shape in decimal degrees five miles to on the X axis and 3 miles on the Y axis.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
xOffsetDistance
yOffsetDistance
shapeUnit
distanceUnit
N/A
This method returns a ShapeValidationResult based on a series of tests.
We use this method, with the simple enumeration, internally before doing any kind of other methods on the shape. In this way, we are able to verify the integrity of the shape itself. If you wish to test things such as whether a polygon self-intersects, we invite you to call this method with the advanced ShapeValidationMode. One thing to consider is that for complex polygon shapes this operation could take some time, which is why we only run the basic, faster test. If you are dealing with polygon shapes that are suspect, we suggest you run the advanced test.Overriding:Please ensure that you validate the parameters being passed in and raise the exceptions defined above.
Return Value
validationMode
This property specifies whether the shape can be rotated.
If this property returns false and you attempt call the rotate method, it will throw a NotImplementedException.
Return Type:Boolean
This property allows you to get or set the center PointShape of the EllipseShape.
None
Return Type:PointShape
This property returns the height of the EllipseShape in the unit of the shape.
None
Return Type:Double
N/A
N/A
Return Type:String
N/A
N/A
Return Type:Object
This property returns the width of the EllipseShape in the unit of the shape.
None
Return Type:Double
8501 Wade Blvd Ste 550
Frisco, TX 75034
United States
sales@thinkgeo.com
1-785-727-4133
Online Store
- Desktop
WPF
WinForms
- Web
WebAPI HTML5/JavaScript
ASP.NET MVC
WebForms with AJAX
- Mobile
iOS
Android™
World Street
World Imagery
Routing
Geocoding
Reverse Geocoding
Elevation
Quick Start Guides
Documentation
Blogs
Discussion Forums
Customer Portal
About Us
News & Announcemets
Privacy Policy
Copyright 2003-2017 ThinkGeo LLC.
All rights reserved.