User Tools

Site Tools


thinkgeo.mapsuite.core.projection

ThinkGeo.MapSuite.Core.Projection

Note: The page was created before Map Suite 10. Map Suite 10.0 organized many classes into new namespaces and assemblies as well as had a few minor breaks in compatibility. The majority of previously built code should work without modification assuming the new namespaces are added. For guidance on upgrading your existing code, please check out MapSuite 10 Upgrade Guide.

This class represents a projection that you wish to apply to a FeatureSource.

Inheritance Hierarchy

Members Summary

Public Constructors

Protected Constructors

Projection()

  • This method is the default protected constructor.
Remarks
  • None
Parameters

Public Methods

CloneDeep()

  • Create a copy of Projection using the deep clone process.
Remarks
  • The difference between deep clone and shallow clone is as follows: In shallow cloning, only the object is copied; the objects within it are not. By contrast, deep cloning copies the cloned object as well as all the objects within.
Return Value
  • Description:A cloned Projection.
Parameters

Open()

  • This method opens the projection and gets it ready to use.
Remarks
  • This method opens the projection and gets it ready to use. 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
  • Type:Void
  • Description:None
Parameters

ConvertToExternalProjection(GeoImage,RectangleShape)

  • N/A
Remarks
  • N/A
Return Value
Parameters

ConvertToExternalProjection(GeoImage,RectangleShape,RectangleShape)

  • N/A
Remarks
  • N/A
Return Value
Parameters

Close()

  • This method closes the projection and gets it ready for serialization if necessary.
Remarks
  • This method closes the projection and gets it ready for serialization if necessary. 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
  • Type:Void
  • Description:None
Parameters

ConvertToExternalProjection(Double,Double)

  • This method returns a projected vertex based on the coordinates passed in.
Remarks
  • This method returns a projected vertex based on the coordinates passed in. 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
  • Type:Vertex
  • Description:This method returns a projected vertex based on the coordinates passed in.
Parameters
  • x
    • Type:Double
    • Description:This parameter is the X decimalDegreesValue of the point that will be projected.
  • y
    • Type:Double
    • Description:This parameter is the Y decimalDegreesValue of the point that will be projected.

ConvertToExternalProjection(BaseShape)

  • This method returns a projected BaseShape based on the baseShape passed in.
Remarks
  • This method returns a projected baseShape based on the BaseShape passed in. 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
  • Type:BaseShape
  • Description:This method returns a projected baseShape for the passed-in BaseShape.
Parameters
  • baseShape
    • Type:BaseShape
    • Description:This parameter is the baseShape (in decimalDegreesValue) to be projected.

ConvertToExternalProjection(Feature)

  • This method returns a projected Feature based on the Feature passed in.
Remarks
  • This method returns a projected Feature based on the Feature passed in. 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
  • Type:Feature
  • Description:This method returns a projected Feature for the passed-in Feature.
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the Feature that contains a BaseShape in decimalDegreesValue to be projected.

ConvertToExternalProjection(RectangleShape)

  • This method returns a projected rectangle based on the rectangle passed in.
Remarks
  • This method returns a projected rectangle based on the rectangle passed in.
Return Value
  • Description:This method returns a projected rectangle based on the rectangle passed in.
Parameters
  • rectangleShape
    • Description:This parameter represents the rectangle you want to project.

ConvertToExternalProjection(IEnumerable<Vertex>)

  • This method returns projected vertices based on the coordinates passed in.
Remarks
  • This method returns a projected vertex based on the coordinates passed in. You will need to override this method for the Projection class. Typically, you can call the projection utility library that has interfaces for dozens of different types of projections.
Return Value
  • Type:Vertex[]
  • Description:This method returns projected vertices based on the coordinates passed in.
Parameters
  • vertices
    • Type:IEnumerable<Vertex>
    • Description:This parameter is the vertices that will be projected.

ConvertToInternalProjection(Double,Double)

  • This method returns a de-projected vertex based on the coordinates passed in.
Remarks
  • This method returns a de-projected vertex based on the coordinates passed in. 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
  • Type:Vertex
  • Description:This method returns a de-projected vertex based on the coordinates passed in.
Parameters
  • x
    • Type:Double
    • Description:This parameter is the X decimalDegreesValue of the point that will be de-projected.
  • y
    • Type:Double
    • Description:This parameter is the Y decimalDegreesValue of the point that will be de-projected.

ConvertToInternalProjection(BaseShape)

  • This method returns a de-projected BaseShape based on the BaseShape passed in.
Remarks
  • This method returns a de-projected BaseShape based on the BaseShape passed in. 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
  • Type:BaseShape
  • Description:This method returns a de-projected BaseShape for the passed in BaseShape.
Parameters
  • baseShape
    • Type:BaseShape
    • Description:This parameter is the baseShape (in decimalDegreesValue) to be de-projected.

ConvertToInternalProjection(Feature)

  • This method returns a de-projected Feature based on the Feature passed in.
Remarks
  • This method returns a de-projected Feature based on the Feature passed in. 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
  • Type:Feature
  • Description:This method returns a de-projected Feature for the passed-in Feature.
Parameters
  • feature
    • Type:Feature
    • Description:This parameter is the Feature that contains a BaseShape in decimalDegreesValue to be de-projected.

ConvertToInternalProjection(IEnumerable<Vertex>)

  • This method returns de-projected vertices based on the coordinates passed in.
Remarks
  • This method returns a de-projected vertex based on the coordinates passed in. The de-projection is important because, inside of the FeatureSource, you will in many cases go to and from various projections.
Return Value
  • Type:Vertex[]
  • Description:This method returns de-projected vertices based on the coordinates passed in.
Parameters
  • vertices
    • Type:IEnumerable<Vertex>
    • Description:This parameter is the vertices that will be de-projected.

ConvertToInternalProjection(RectangleShape)

  • This method returns a de-projected rectangle based on the rectangle passed in.
Remarks
  • This method returns a de-projected rectangle based on the rectangle passed in.
Return Value
  • Description:This method returns a de-projected rectangle based on the rectangle passed in.
Parameters
  • rectangleShape
    • Description:This parameter represents the rectangle you want to de-project.

GetInternalGeographyUnit()

  • N/A
Remarks
  • N/A
Return Value
Parameters

GetExternalGeographyUnit()

  • N/A
Remarks
  • N/A
Return Value
Parameters

ToString()

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters

Equals(Object)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Boolean
  • Description:N/A
Parameters
  • obj
    • Type:Object
    • Description:N/A

GetHashCode()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Int32
  • Description:N/A
Parameters

GetType()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Type
  • Description:N/A
Parameters

Protected Methods

CloneDeepCore()

  • Create a copy of GeoCanvas using the deep clone process. The default implementation uses serialization.
Remarks
  • The difference between deep clone and shallow clone is as follows: In shallow cloning, only the object is copied; the objects within it are not. By contrast, deep cloning copies the cloned object as well as all the objects within.
Return Value
Parameters

ConvertToExternalProjectionCore(GeoImage,RectangleShape)

  • N/A
Remarks
  • N/A
Return Value
Parameters

ConvertToExternalProjectionCore(GeoImage,RectangleShape,RectangleShape)

  • N/A
Remarks
  • N/A
Return Value
Parameters

OpenCore()

  • This method opens the projection and gets it ready to use.
Remarks
  • As this is the core version of the Open method, it is intended to be overridden in an inherited version of the class. When overriding, you will be responsible for getting the projection classes' state ready for doing projections.
Return Value
  • Type:Void
  • Description:None
Parameters

CloseCore()

  • This method closes the projection and gets it ready for serialization if necessary.
Remarks
  • As this is the core version of the Close method, it is intended to be overridden in an inherited version of the class. When overriding, you will be responsible freeing any state you have maintained and getting the class ready for serialization if necessary. Note that the object may be opened again, so you want to make sure you can open and close the object multiple times without any ill effects.
Return Value
  • Type:Void
  • Description:None
Parameters

UpdateToExternalProjection(Feature)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature

ConvertToExternalProjectionCore(Double[],Double[])

  • This method returns projected vertices based on the coordinates passed in.
Remarks
  • This method returns a projected vertex based on the coordinates passed in. You will need to override this method for the Projection class. Typically, you can call the projection utility library that has interfaces for dozens of different types of projections.
Return Value
  • Type:Vertex[]
  • Description:This method returns projected vertices based on the coordinates passed in.
Parameters
  • xArray
    • Type:Double[]
    • Description:N/A
  • yArray
    • Type:Double[]
    • Description:N/A

ConvertToInternalProjectionCore(Double[],Double[])

  • This method returns de-projected vertices based on the coordinates passed in.
Remarks
  • This method returns a de-projected vertex based on the coordinates passed in. You will need to override this method for the Projection class. Typically, you can call the projection utility library that has interfaces for dozens of different types of projections. The de-projection is important because, inside of the FeatureSource, you will in many cases go to and from various projections.
Return Value
  • Type:Vertex[]
  • Description:This method returns de-projected vertices based on the coordinates passed in.
Parameters
  • xArray
    • Type:Double[]
    • Description:N/A
  • yArray
    • Type:Double[]
    • Description:N/A

UpdateToInternalProjection(Feature)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature

GetInternalGeographyUnitCore()

  • N/A
Remarks
  • N/A
Return Value
Parameters

GetExternalGeographyUnitCore()

  • N/A
Remarks
  • N/A
Return Value
Parameters

Finalize()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters

MemberwiseClone()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Object
  • Description:N/A
Parameters

Public Properties

IsOpen

This property gets the state of the projection (whether it is opened or closed).

Remarks

This method will reflect whether the projection is opened or closed. It is set in the concrete methods Open and Close, so if you inherit from this class and override OpenCore or CloseCore, you will not need to be concerned with setting this property.

Return Value
  • Type:Boolean

CanConvertRasterToExternalProjection

N/A

Remarks

N/A

Return Value
  • Type:Boolean

Protected Properties

CanReproject

This property indicates whether this projection should be used.

Remarks

N/A

Return Value
  • Type:Boolean

Public Events

thinkgeo.mapsuite.core.projection.txt · Last modified: 2017/03/16 21:59 (external edit)