Crs.ProjectTo Methods

Reprojects the specified points to a new Crs.

Overload List

ProjectTo(Crs crs, PointCollection points)

public PointCollection ProjectTo (
    Crs crs,
    PointCollection points
)

Parameters

Return Value

ProjectTo(Crs crs, RectangleSet area)

public RectangleSet ProjectTo (
    Crs crs,
    RectangleSet area
)

Parameters

Return Value

ProjectTo(Crs crs, Rectangle rect)

public RectangleSet ProjectTo (
    Crs crs,
    Rectangle rect
)

Parameters

Return Value

Remarks

This method reprojects a rectangle from this (old) coordinate reference system to the new one. The result is a set of one or two rectangles that cover the original one (they are not necessarily the smallest ones that do so).

In the example above, the map uses a Crs based on a LambertConformalConicProjection projection, with a central longitude at -165°. The brown rectangle, which is defined in the same Crs, crosses the international date line without problems, since the Crs has no discontinuity there. However, when the brown rectangle is reprojected to a Crs based on LongLat, it is impossible to give the result as a single LongLat rectangle with normalized longitudes. The southwest corner would need a longitude around 172°, and the northeast corner would need a longitude around -146°, but since 172 is greater than -146, this would not be a well-formed rectangle. Instead, the result of ProjectTo will consist of two LongLat rectangles, which are shown in purple and green.

This splitting behavior is designed for the case where the original rectangle is expressed in the View.Crs, and we want to know what areas, expressed in a DataSet.Crs, that should be queried for features. (This is done automatically when Carmenta Engine updates a View, so you seldom need to call this method from an application.)

Tip

Suppose we already have some features and want to zoom to an area that covers them. In this case, the splitting behavior is not desired, and it is better to use the method View.AreaForFeature or View.AreaForFeatures.

ProjectTo(Crs crs, Point point)

public Point ProjectTo (
    Crs crs,
    Point point
)

Parameters

Return Value

ProjectTo(Crs crs, IEnumerable< Point > points)

public PointCollection ProjectTo (
    Crs crs,
    IEnumerable< Point > points
)

Parameters

Return Value

Platforms

Windows, Linux, Android

Crs::projectTo Methods

Reprojects the specified points to a new Crs.

Overload List

projectTo(const CrsPtr& crs, const PointCollectionPtr& points)

public:
PointCollectionPtr projectTo (
    const CrsPtr& crs,
    const PointCollectionPtr& points
) const

Parameters

Return Value

projectTo(const CrsPtr& crs, const Iter& pointsFirst, const Iter& pointsLast)

public:
template< class Iter >
PointCollectionPtr projectTo (
    const CrsPtr& crs,
    const Iter& pointsFirst,
    const Iter& pointsLast
)

Parameters

Return Value

projectTo(const CrsPtr& crs, const RectangleSet& area)

public:
RectangleSet projectTo (
    const CrsPtr& crs,
    const RectangleSet& area
) const

Parameters

Return Value

projectTo(const CrsPtr& crs, const Rectangle& rect)

public:
RectangleSet projectTo (
    const CrsPtr& crs,
    const Rectangle& rect
) const

Parameters

Return Value

Remarks

This method reprojects a rectangle from this (old) coordinate reference system to the new one. The result is a set of one or two rectangles that cover the original one (they are not necessarily the smallest ones that do so).

In the example above, the map uses a Crs based on a LambertConformalConicProjection projection, with a central longitude at -165°. The brown rectangle, which is defined in the same Crs, crosses the international date line without problems, since the Crs has no discontinuity there. However, when the brown rectangle is reprojected to a Crs based on LongLat, it is impossible to give the result as a single LongLat rectangle with normalized longitudes. The southwest corner would need a longitude around 172°, and the northeast corner would need a longitude around -146°, but since 172 is greater than -146, this would not be a well-formed rectangle. Instead, the result of projectTo will consist of two LongLat rectangles, which are shown in purple and green.

This splitting behavior is designed for the case where the original rectangle is expressed in the View::crs, and we want to know what areas, expressed in a DataSet::crs, that should be queried for features. (This is done automatically when Carmenta Engine updates a View, so you seldom need to call this method from an application.)

Tip

Suppose we already have some features and want to zoom to an area that covers them. In this case, the splitting behavior is not desired, and it is better to use the method View::areaForFeature or View::areaForFeatures.

projectTo(const CrsPtr& crs, const Point& point)

public:
Point projectTo (
    const CrsPtr& crs,
    const Point& point
) const

Parameters

Return Value

Platforms

Windows, Linux, Android

Crs.projectTo Methods

Reprojects the specified points to a new Crs.

Overload List

projectTo(Crs crs, PointCollection points)

public final PointCollection projectTo (
    Crs crs,
    PointCollection points
)

Parameters

Return Value

projectTo(Crs crs, RectangleSet area)

public final RectangleSet projectTo (
    Crs crs,
    RectangleSet area
)

Parameters

Return Value

projectTo(Crs crs, Rectangle rect)

public final RectangleSet projectTo (
    Crs crs,
    Rectangle rect
)

Parameters

Return Value

Remarks

This method reprojects a rectangle from this (old) coordinate reference system to the new one. The result is a set of one or two rectangles that cover the original one (they are not necessarily the smallest ones that do so).

In the example above, the map uses a Crs based on a LambertConformalConicProjection projection, with a central longitude at -165°. The brown rectangle, which is defined in the same Crs, crosses the international date line without problems, since the Crs has no discontinuity there. However, when the brown rectangle is reprojected to a Crs based on LongLat, it is impossible to give the result as a single LongLat rectangle with normalized longitudes. The southwest corner would need a longitude around 172°, and the northeast corner would need a longitude around -146°, but since 172 is greater than -146, this would not be a well-formed rectangle. Instead, the result of projectTo will consist of two LongLat rectangles, which are shown in purple and green.

This splitting behavior is designed for the case where the original rectangle is expressed in the View.crs, and we want to know what areas, expressed in a DataSet.crs, that should be queried for features. (This is done automatically when Carmenta Engine updates a View, so you seldom need to call this method from an application.)

Tip

Suppose we already have some features and want to zoom to an area that covers them. In this case, the splitting behavior is not desired, and it is better to use the method View.areaForFeature or View.areaForFeatures.

projectTo(Crs crs, Point point)

public final Point projectTo (
    Crs crs,
    Point point
)

Parameters

Return Value

projectTo(Crs crs, java.util.Collection< Point > points)

public final PointCollection projectTo (
    Crs crs,
    java.util.Collection< Point > points
)

Parameters

Return Value

Platforms

Windows, Linux, Android

Crs.projectTo Methods

Reprojects the specified points to a new Crs.

Overload List

projectTo(crs, points)

PointCollection projectTo ( crs, points )

Parameters

Return Value

projectTo(crs, area)

RectangleSet projectTo ( crs, area )

Parameters

Return Value

projectTo(crs, rect)

RectangleSet projectTo ( crs, rect )

Parameters

Return Value

Remarks

This method reprojects a rectangle from this (old) coordinate reference system to the new one. The result is a set of one or two rectangles that cover the original one (they are not necessarily the smallest ones that do so).

In the example above, the map uses a Crs based on a LambertConformalConicProjection projection, with a central longitude at -165°. The brown rectangle, which is defined in the same Crs, crosses the international date line without problems, since the Crs has no discontinuity there. However, when the brown rectangle is reprojected to a Crs based on LongLat, it is impossible to give the result as a single LongLat rectangle with normalized longitudes. The southwest corner would need a longitude around 172°, and the northeast corner would need a longitude around -146°, but since 172 is greater than -146, this would not be a well-formed rectangle. Instead, the result of projectTo will consist of two LongLat rectangles, which are shown in purple and green.

This splitting behavior is designed for the case where the original rectangle is expressed in the View.crs, and we want to know what areas, expressed in a DataSet.crs, that should be queried for features. (This is done automatically when Carmenta Engine updates a View, so you seldom need to call this method from an application.)

Tip

Suppose we already have some features and want to zoom to an area that covers them. In this case, the splitting behavior is not desired, and it is better to use the method View.areaForFeature or View.areaForFeatures.

projectTo(crs, point)

Point projectTo ( crs, point )

Parameters

Return Value

Platforms

Windows, Linux, Android