User Tools

Site Tools


thinkgeo.mapsuite.portablecore.rotationprojection

This is an old revision of the document!


Table of Contents

ThinkGeo.MapSuite.PortableCore.RotationProjection

<!– Class –> This projection allows you to rotate the map image base don an angle.

Remarks

This can be usefully when you are working with directional maps such as driving maps where you want the upper center of the map to be in line with the direction of the vehicle heading.

Inheritance Hierarchy

Members Summary

Public Constructors

Name Parameters DeclaringType Summary
Public MethodRotationProjection This is a constructor for the class.
Public MethodRotationProjection Double This is a constructor for the class.
Public MethodRotationProjection GeographyUnit
Public MethodRotationProjection Double, GeographyUnit

Protected Constructors

Name Parameters DeclaringType Summary

Public Methods

Name Parameters DeclaringType Summary
Public MethodCloneDeep Projection Create a copy of Projection using the deep clone process.
Public MethodClose Projection This method closes the projection and gets it ready for serialization if necessary.
Public MethodConvertToExternalProjection RectangleShape Projection This method returns a projected rectangle based on the rectangle passed in.
Public MethodConvertToExternalProjection Feature Projection This method returns a projected Feature based on the Feature passed in.
Public MethodConvertToExternalProjection Double, Double Projection This method returns a projected vertex based on the coordinates passed in.
Public MethodConvertToExternalProjection GeoImage, RectangleShape, RectangleShape Projection
Public MethodConvertToExternalProjection BaseShape Projection This method returns a projected BaseShape based on the baseShape passed in.
Public MethodConvertToExternalProjection GeoImage, RectangleShape Projection
Public MethodConvertToInternalProjection Double, Double Projection This method returns a de-projected vertex based on the coordinates passed in.
Public MethodConvertToInternalProjection BaseShape Projection This method returns a de-projected BaseShape based on the BaseShape passed in.
Public MethodConvertToInternalProjection Feature Projection This method returns a de-projected Feature based on the Feature passed in.
Public MethodConvertToInternalProjection RectangleShape Projection This method returns a de-projected rectangle based on the rectangle passed in.
Public MethodEquals Object Object
Public MethodGetExternalGeographyUnit Projection
Public MethodGetHashCode Object
Public MethodGetInternalGeographyUnit Projection
Public MethodGetType Object
Public MethodGetUpdatedExtent RectangleShape This method returns an adjusted extend based on the angle of rotation.
Public MethodOpen Projection This method opens the projection and gets it ready to use.
Public MethodToString Object

Protected Methods

Name Parameters DeclaringType Summary
Protected MethodCloneDeepCore Projection Create a copy of GeoCanvas using the deep clone process. The default implementation uses serialization.
Protected MethodCloseCore Projection This method closes the projection and gets it ready for serialization if necessary.
Protected MethodConvertToExternalProjectionCore GeoImage, RectangleShape Projection
Protected MethodConvertToExternalProjectionCore Double[], Double[] Projection(overriden) This method returns a projected vertices based on the coordinates passed in.
Protected MethodConvertToExternalProjectionCore GeoImage, RectangleShape, RectangleShape Projection
Protected MethodConvertToInternalProjectionCore Double[], Double[] Projection(overriden) This method returns a de-projected vertices based on the coordinates passed in.
Protected MethodFinalize Object
Protected MethodGetExternalGeographyUnitCore Projection
Protected MethodGetInternalGeographyUnitCore Projection(overriden)
Protected MethodMemberwiseClone Object
Protected MethodOpenCore Projection This method opens the projection and gets it ready to use.

Public Properties

Name Return DeclaringType Summary
Public PropertyAngle Double This property sets the angle of rotation.
Public PropertyCanConvertRasterToExternalProjection Boolean Projection
Public PropertyIsOpen Boolean Projection This property gets the state of the projection (whether it is opened or closed).
Public PropertyPivotCenter PointShape
Public PropertySourceUnit GeographyUnit

Protected Properties

Name Return DeclaringType Summary
Protected PropertyCanReproject Boolean Projection This property indicates whether this projection should be used.

Public Events

Name Event Arguments DeclaringType Summary

Public Constructors

RotationProjection()

This is a constructor for the class.

Overloads

This is the default constructor and will set the angle to 0 whick is north being up.

Remarks

This is the default constructor and will set the angle to 0 whick is north being up.

Parameters

Name Type Description

Go Back

RotationProjection(Double)

This is a constructor for the class.

Overloads

This constructor allows you to pass in an angle to change the rotation of the map.

Remarks

This constructor allows you to pass in an angle to change the rotation of the map.

Parameters

Name Type Description
angle Double<!– System.Double –> This parameter is the angle you want to map to rotate to.

Go Back

RotationProjection(GeographyUnit)

Parameters

Name Type Description
sourceUnit GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Go Back

RotationProjection(Double, GeographyUnit)

Parameters

Name Type Description
angle Double<!– System.Double –>
sourceUnit GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Go Back

Protected Constructors

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

Return Type Description
Projection<!– ThinkGeo.MapSuite.PortableCore.Projection –> A cloned Projection.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This method returns a projected rectangle based on the rectangle passed in.

Parameters

Name Type Description
rectangleShape RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This parameter represents the rectangle you want to project.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Feature<!– ThinkGeo.MapSuite.PortableCore.Feature –> This method returns a projected Feature for the passed-in Feature.

Parameters

Name Type Description
feature Feature<!– ThinkGeo.MapSuite.PortableCore.Feature –> This parameter is the Feature that contains a BaseShape in decimalDegreesValue to be projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Vertex<!– ThinkGeo.MapSuite.PortableCore.Vertex –> This method returns a projected vertex based on the coordinates passed in.

Parameters

Name Type Description
x Double<!– System.Double –> This parameter is the X decimalDegreesValue of the point that will be projected.
y Double<!– System.Double –> This parameter is the Y decimalDegreesValue of the point that will be projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ConvertToExternalProjection(GeoImage, RectangleShape, RectangleShape)

Return Value

Return Type Description
RasterProjectionResult<!– ThinkGeo.MapSuite.PortableCore.RasterProjectionResult –>

Parameters

Name Type Description
image GeoImage<!– ThinkGeo.MapSuite.PortableCore.GeoImage –>
imageExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>
targetExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
BaseShape<!– ThinkGeo.MapSuite.PortableCore.BaseShape –> This method returns a projected baseShape for the passed-in BaseShape.

Parameters

Name Type Description
baseShape BaseShape<!– ThinkGeo.MapSuite.PortableCore.BaseShape –> This parameter is the baseShape (in decimalDegreesValue) to be projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ConvertToExternalProjection(GeoImage, RectangleShape)

Return Value

Return Type Description
RasterProjectionResult<!– ThinkGeo.MapSuite.PortableCore.RasterProjectionResult –>

Parameters

Name Type Description
image GeoImage<!– ThinkGeo.MapSuite.PortableCore.GeoImage –>
imageExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Vertex<!– ThinkGeo.MapSuite.PortableCore.Vertex –> This method returns a de-projected vertex based on the coordinates passed in.

Parameters

Name Type Description
x Double<!– System.Double –> This parameter is the X decimalDegreesValue of the point that will be de-projected.
y Double<!– System.Double –> This parameter is the Y decimalDegreesValue of the point that will be de-projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
BaseShape<!– ThinkGeo.MapSuite.PortableCore.BaseShape –> This method returns a de-projected BaseShape for the passed in BaseShape.

Parameters

Name Type Description
baseShape BaseShape<!– ThinkGeo.MapSuite.PortableCore.BaseShape –> This parameter is the baseShape (in decimalDegreesValue) to be de-projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Feature<!– ThinkGeo.MapSuite.PortableCore.Feature –> This method returns a de-projected Feature for the passed-in Feature.

Parameters

Name Type Description
feature Feature<!– ThinkGeo.MapSuite.PortableCore.Feature –> This parameter is the Feature that contains a BaseShape in decimalDegreesValue to be de-projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This method returns a de-projected rectangle based on the rectangle passed in.

Parameters

Name Type Description
rectangleShape RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This parameter represents the rectangle you want to de-project.

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

Equals(Object)

Return Value

Return Type Description
Boolean<!– System.Boolean –>

Parameters

Name Type Description
obj Object<!– System.Object –>

<!– System.Object –> Go Back

GetExternalGeographyUnit()

Return Value

Return Type Description
GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

GetHashCode()

Return Value

Return Type Description
Int32<!– System.Int32 –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetInternalGeographyUnit()

Return Value

Return Type Description
GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

GetType()

Return Value

Return Type Description
Type<!– System.Type –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetUpdatedExtent(RectangleShape)

This method returns an adjusted extend based on the angle of rotation.

Remarks

This method returns an adjusted extend based on the angle of rotation. It is important that you update your current extent every time you adjust the angle of the projection. This will ensure the rotaion is performed properly.

Return Value

Return Type Description
RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This method returns an adjusted extend based on the angle of rotation.

Parameters

Name Type Description
worldExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –> This parameter is the world extent before the rotation.

<!– ThinkGeo.MapSuite.PortableCore.RotationProjection –> Go Back

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

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ToString()

Return Value

Return Type Description
String<!– System.String –>

Parameters

Name Type Description

<!– System.Object –> Go Back

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

Return Type Description
Projection<!– ThinkGeo.MapSuite.PortableCore.Projection –> A cloned GeoCanvas.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ConvertToExternalProjectionCore(GeoImage, RectangleShape)

Return Value

Return Type Description
RasterProjectionResult<!– ThinkGeo.MapSuite.PortableCore.RasterProjectionResult –>

Parameters

Name Type Description
image GeoImage<!– ThinkGeo.MapSuite.PortableCore.GeoImage –>
imageExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ConvertToExternalProjectionCore(Double[], Double[])

This method returns a 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

Return Type Description
Vertex[]<!– ThinkGeo.MapSuite.PortableCore.Vertexthinkgeo.mapsuite.portablecore.rotationprojection –> This method returns a projected vertices based on the coordinates passed in.

Parameters

Name Type Description
x Double[]<!– System.Doublethinkgeo.mapsuite.portablecore.rotationprojection –> This parameter is the X values of the points that will be projected.
y Double[]<!– System.Doublethinkgeo.mapsuite.portablecore.rotationprojection –> This parameter is the Y values of the points that will be projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection(overriden) –> Go Back

ConvertToExternalProjectionCore(GeoImage, RectangleShape, RectangleShape)

Return Value

Return Type Description
RasterProjectionResult<!– ThinkGeo.MapSuite.PortableCore.RasterProjectionResult –>

Parameters

Name Type Description
image GeoImage<!– ThinkGeo.MapSuite.PortableCore.GeoImage –>
imageExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>
targetExtent RectangleShape<!– ThinkGeo.MapSuite.PortableCore.RectangleShape –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

ConvertToInternalProjectionCore(Double[], Double[])

This method returns a 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 to to and from various projections.

Return Value

Return Type Description
Vertex[]<!– ThinkGeo.MapSuite.PortableCore.Vertexthinkgeo.mapsuite.portablecore.rotationprojection –> This method returns a de-projected vertices based on the coordinates passed in.

Parameters

Name Type Description
x Double[]<!– System.Doublethinkgeo.mapsuite.portablecore.rotationprojection –> This parameter is the X values of the points that will be de-projected.
y Double[]<!– System.Doublethinkgeo.mapsuite.portablecore.rotationprojection –> This parameter is the Y values of the points that will be de-projected.

<!– ThinkGeo.MapSuite.PortableCore.Projection(overriden) –> Go Back

Finalize()

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– System.Object –> Go Back

GetExternalGeographyUnitCore()

Return Value

Return Type Description
GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

GetInternalGeographyUnitCore()

Return Value

Return Type Description
GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection(overriden) –> Go Back

MemberwiseClone()

Return Value

Return Type Description
Object<!– System.Object –>

Parameters

Name Type Description

<!– System.Object –> Go Back

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

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

Public Properties

Angle

This property sets the angle of rotation.

Return Value

Return Type
Double<!– System.Double –>

<!– ThinkGeo.MapSuite.PortableCore.RotationProjection –> Go Back

CanConvertRasterToExternalProjection

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

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

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

PivotCenter

Return Value

Return Type
PointShape<!– ThinkGeo.MapSuite.PortableCore.PointShape –>

<!– ThinkGeo.MapSuite.PortableCore.RotationProjection –> Go Back

SourceUnit

Return Value

Return Type
GeographyUnit<!– ThinkGeo.MapSuite.PortableCore.GeographyUnit –>

<!– ThinkGeo.MapSuite.PortableCore.RotationProjection –> Go Back

Protected Properties

CanReproject

This property indicates whether this projection should be used.

Return Value

Return Type
Boolean<!– System.Boolean –>

<!– ThinkGeo.MapSuite.PortableCore.Projection –> Go Back

Public Events

thinkgeo.mapsuite.portablecore.rotationprojection.1440040133.txt.gz · Last modified: 2015/09/21 08:17 (external edit)