User Tools

Site Tools

Trace:

Sidebar

Products

Professional Services

Demos and Downloads

Help and Support

thinkgeo.mapsuite.silverlightcore.extenthelper

This is an old revision of the document!

Table of Contents

ThinkGeo.MapSuite.SilverlightCore.ExtentHelper

This static class exposes a number of helpful methods when dealing with extents.

Inheritance Hierarchy

  • System.Object
    • ThinkGeo.MapSuite.SilverlightCore.ExtentHelper

Members Summary

Public Constructors

Protected Constructors

Public Methods

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

GetDrawingExtent(RectangleShape,Double,Double)

  • This method returns an adjusted extent based on the ratio of the screen width and height.
Remarks
  • This function is used because the extent to draw must be the rame ratio as the screen width and height. If they are not, then the image drawn will be stretched or compressed. We always adjust the extent upwards to ensure that no matter how we adjust it, the original extent will fit within the new extent. This ensures that everything you wanted to see in the first extent is visible and maybe a bit more.
Return Value
  • Type:RectangleShape
  • Description:This method returns an adjusted extent based on the ratio of the screen width and height.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to adjust for drawing.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

CenterAt(RectangleShape,PointShape,Double,Double)

  • This is a static function that allows you to pass in a world rectangle, a world point to center on, and a height and width in screen units. The function will center the rectangle based on the point, then adjust the rectangle's ratio based on the height and width in screen coordinates.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns an adjusted extent centered on a point.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the current extent you want to center.
  • worldPoint
    • Type:PointShape
    • Description:This parameter is the world point you want to center on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

CenterAt(RectangleShape,Feature,Double,Double)

  • This is a static function that allows you to pass in a world rectangle, a world point to center on, and a height and width in screen units. The function will center the rectangle based on the point, then adjust the rectangle's ratio based on the height and width in screen coordinates.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns an adjusted extent centered on a point.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the current extent you want to center.
  • centerFeature
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

CenterAt(RectangleShape,Double,Double,Double,Double)

  • This method returns an adjusted extent centered on a point.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns an adjusted extent centered on a point.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the current extent you want to center.
  • screenX
    • Type:Double
    • Description:This parameter is the X coordinate on the screen to center on.
  • screenY
    • Type:Double
    • Description:This parameter is the Y coordinate on the screen to center on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

GetScreenDistanceBetweenTwoWorldPoints(RectangleShape,PointShape,PointShape,Double,Double)

  • This method returns the number of pixels between two world points.
Remarks
  • None
Return Value
  • Type:Double
  • Description:This method returns the number of pixels between two world points.
Parameters
  • worldExtent
  • worldPoint1
    • Type:PointShape
    • Description:This parameter is the first point – the one you want to measure from.
  • worldPoint2
    • Type:PointShape
    • Description:This parameter is the second point – the one you want to measure to.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

GetScreenDistanceBetweenTwoWorldPoints(RectangleShape,Feature,Feature,Double,Double)

  • This method returns the number of pixels between two features.
Remarks
  • None
Return Value
  • Type:Double
  • Description:This method returns the number of pixels between two features.
Parameters
  • worldExtent
  • worldPointFeature1
    • Type:Feature
    • Description:This parameter is the first feature – the one you want to measure from.
  • worldPointFeature2
    • Type:Feature
    • Description:This parameter is the second feature – the one you want to measure to.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

GetWorldDistanceBetweenTwoScreenPoints(RectangleShape,Point,Point,Double,Double,GeographyUnit,DistanceUnit)

  • This method returns the distance in world units between two screen points.
Remarks
  • None
Return Value
  • Type:Double
  • Description:This method returns the distance in world units between two screen points.
Parameters
  • worldExtent
  • screenPoint1
    • Type:Point
    • Description:This is the screen point you want to measure from.
  • screenPoint2
    • Type:Point
    • Description:This is the screen point you want to measure to.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This is the geographic unit of the world extent rectangle.
  • distanceUnit
    • Type:DistanceUnit
    • Description:This is the geographic unit you want the result to show in.

GetWorldDistanceBetweenTwoScreenPoints(RectangleShape,Double,Double,Double,Double,Double,Double,GeographyUnit,DistanceUnit)

  • This method returns the distance in world units between two screen points.
Remarks
  • N/A
Return Value
  • Type:Double
  • Description:N/A
Parameters
  • worldExtent
  • screenPoint1X
    • Type:Double
    • Description:This parameter is the X of the point you want to measure from.
  • screenPoint1Y
    • Type:Double
    • Description:This parameter is the Y of the point you want to measure from.
  • screenPoint2X
    • Type:Double
    • Description:This parameter is the X of the point you want to measure to.
  • screenPoint2Y
    • Type:Double
    • Description:This parameter is the Y of the point you want to measure to.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This is the geographic unit of the world extent you passed in.
  • distanceUnit
    • Type:DistanceUnit
    • Description:This is the geographic unit you want the result to show in.

GetScale(RectangleShape,Double,GeographyUnit)

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

GetScale(RectangleShape,Double,GeographyUnit,Single)

  • This method returns the current scale.
Remarks
  • None
Return Value
  • Type:Double
  • Description:This method returns the current scale.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to find the scale for.
  • screenWidth
    • Type:Double
    • Description:This parameter is the screen width.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This parameter is the unit of the world extent.
  • dpi
    • Type:Single
    • Description:N/A

GetBoundingBoxOfItems(IEnumerable<BaseShape>)

  • This API gets the BoundingBox of a group of BaseShapes.
Remarks
  • N/A
Return Value
  • Type:RectangleShape
  • Description:The BoundingBox that contains all of the shapes you passed in.
Parameters
  • shapes
    • Type:IEnumerable<BaseShape>
    • Description:The target group of BaseShapes to get the BoundingBox for.

GetBoundingBoxOfItems(IEnumerable<Feature>)

  • This API gets the BoundingBox of a group of Features.
Remarks
  • N/A
Return Value
  • Type:RectangleShape
  • Description:The BoundingBox that contains all the features you passed in.
Parameters
  • features
    • Type:IEnumerable<Feature>
    • Description:The target group of Features to get the BoundingBox for.

ZoomIn(RectangleShape,Int32)

  • This method returns a new extent that is zoomed in by the percentage provided.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a new extent that is zoomed in by the percentage provided.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to zoom to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom in.

ZoomIntoCenter(RectangleShape,Int32,PointShape,Double,Double)

  • This method returns an extent that is centered and zoomed in.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterwards.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed in.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent that you want centered and zoomed to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom in.
  • worldPoint
    • Type:PointShape
    • Description:This parameter is the world point you want the extent to be centered on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width in screen coordinates.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height in screen coordinates.

ZoomIntoCenter(RectangleShape,Int32,Feature,Double,Double)

  • This method returns an extent that is centered and zoomed.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterwards.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed in.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent that you want centered and zoomed to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom in.
  • centerFeature
    • Type:Feature
    • Description:This parameter is the feature you want the extent to be centered on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width in screen coordinates.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height in screen coordinates.

ZoomIntoCenter(RectangleShape,Int32,Double,Double,Double,Double)

  • This method returns an extent that is centered and zoomed in.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterwards.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed in.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to center and zoom to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom in.
  • screenX
    • Type:Double
    • Description:This parameter is the screen X you want to center on.
  • screenY
    • Type:Double
    • Description:This parameter is the screen Y you want to center on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ZoomOut(RectangleShape,Int32)

  • This method returns a new extent that is zoomed out by the percentage provided.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a new extent that is zoomed out by the percentage provided.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to zoom out to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom out.

ZoomOutToCenter(RectangleShape,Int32,PointShape,Double,Double)

  • This method returns an extent that is centered and zoomed out.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterwards.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed out.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to center and zoom out to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom out.
  • worldPoint
    • Type:PointShape
    • Description:This parameter is the world point you want the extent to be centered on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ZoomOutToCenter(RectangleShape,Int32,Feature,Double,Double)

  • This method returns an extent that is centered and zoomed out.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterwards.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed out.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to center and zoom out to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom out.
  • centerFeature
    • Type:Feature
    • Description:This parameter is the feature you want the extent to be centered on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ZoomOutToCenter(RectangleShape,Int32,Double,Double,Double,Double)

  • This method returns an extent that is centered and zoomed out.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to call GetDrawingExtent afterward.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is centered and zoomed out.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to center and zoom out to.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to zoom out.
  • screenX
    • Type:Double
    • Description:This parameter is the screen X you want to center on.
  • screenY
    • Type:Double
    • Description:This parameter is the screen Y you want to center on.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

Pan(RectangleShape,PanDirection,Int32)

  • This method returns a panned extent.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a panned extent.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to pan.
  • direction
    • Type:PanDirection
    • Description:This parameter is the direction in which you want to pan.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to pan.

Pan(RectangleShape,Double,Int32)

  • This method returns a panned extent.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a panned extent.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want to pan.
  • degree
    • Type:Double
    • Description:This parameter is the degree you want to pan.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage by which you want to pan.

ToScreenCoordinate(RectangleShape,Double,Double,Double,Double)

  • This method returns screen coordinates from world coordinates.
Remarks
  • None
Return Value
  • Type:Point
  • Description:This method returns screen coordinates from world coordinates.
Parameters
  • worldExtent
  • worldX
    • Type:Double
    • Description:This parameter is the world X you want converted to screen points.
  • worldY
    • Type:Double
    • Description:This parameter is the world Y you want converted to screen points.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ToScreenCoordinate(RectangleShape,PointShape,Double,Double)

  • This method returns screen coordinates from world coordinates.
Remarks
  • None
Return Value
  • Type:Point
  • Description:This method returns screen coordinates from world coordinates.
Parameters
  • worldExtent
  • worldPoint
    • Type:PointShape
    • Description:This parameter is the world point you want converted to a screen point.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ToScreenCoordinate(RectangleShape,Feature,Double,Double)

  • This method returns screen coordinates from world coordinates.
Remarks
  • None
Return Value
  • Type:Point
  • Description:This method returns screen coordinates from world coordinates.
Parameters
  • worldExtent
  • worldPointFeature
    • Type:Feature
    • Description:This parameter is the feature you want converted to a screen point.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ToWorldCoordinate(RectangleShape,Double,Double,Double,Double)

  • This method returns world coordinates from screen coordinates.
Remarks
  • None
Return Value
  • Type:PointShape
  • Description:This method returns world coordinates from screen coordinates.
Parameters
  • worldExtent
  • screenX
    • Type:Double
    • Description:This parameter is the X of the point you want converted to world coordinates.
  • screenY
    • Type:Double
    • Description:This parameter is the Y of the point you want converted to world coordinates.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

ToWorldCoordinate(RectangleShape,Point,Double,Double)

  • This method returns world coordinates from screen coordinates.
Remarks
  • None
Return Value
  • Type:PointShape
  • Description:This method returns world coordinates from screen coordinates.
Parameters
  • worldExtent
  • screenPoint
    • Type:Point
    • Description:This parameter is the screen point you want converted to a world point.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width of the screen.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height of the screen.

SnapToZoomLevel(RectangleShape,GeographyUnit,Double,Double,ZoomLevelSet)

  • This method returns an extent that is snapped to a zoom level in the provided zoom level set.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is snapped to a zoom level in the provided zoom level set.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want snapped.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This parameter is the geographic unit of the world extent parameter.
  • screenWidth
    • Type:Double
    • Description:This parameter is the screen width.
  • screenHeight
    • Type:Double
    • Description:This parameter is the screen height.
  • zoomLevelSet
    • Type:ZoomLevelSet
    • Description:This parameter is the set of zoom levels you want to snap to.

ZoomToScale(Double,RectangleShape,GeographyUnit,Double,Double)

  • This method returns a extent that has been zoomed into a certain scale.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a extent that has been zoomed into a certain scale.
Parameters
  • targetScale
    • Type:Double
    • Description:This parameter is the scale you want to zoom into.
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want zoomed into the scale.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This parameter is the geographic unit of the world extent parameter.
  • screenWidth
    • Type:Double
    • Description:This parameter is the screen width.
  • screenHeight
    • Type:Double
    • Description:This parameter is the screen height.

ZoomToScale(Double,RectangleShape,GeographyUnit,Double,Double,Point)

  • This method returns a extent that has been zoomed into a certain scale.
Remarks
  • None
Return Value
  • Type:RectangleShape
  • Description:This method returns a extent that has been zoomed into a certain scale.
Parameters
  • targetScale
    • Type:Double
    • Description:This parameter is the scale you want to zoom into.
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent you want zoomed into the scale.
  • worldExtentUnit
    • Type:GeographyUnit
    • Description:This parameter is the geographic unit of the world extent parameter.
  • screenWidth
    • Type:Double
    • Description:This parameter is the screen width.
  • screenHeight
    • Type:Double
    • Description:This parameter is the screen height.
  • offsetScreenPoint
    • Type:Point
    • Description:This parameter is the offsetScreenPoint.

ZoomIntoOffsetPoint(RectangleShape,Double,Double,Point,Int32)

  • This method returns an extent that is keeping the offsetScreenPoint constant and zoomed.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to afterward call GetDrawingExtent.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is keeping the offsetScreenPoint constant and zoomed.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent that you want centered and zoomed.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width in screen coordinates.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height in screen coordinates.
  • offsetScreenPoint
    • Type:Point
    • Description:This parameter is the screen point you want to keep it constant.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage you want to zoom.

ZoomOutToOffsetPoint(RectangleShape,Double,Double,Point,Int32)

  • This method returns an extent that is keeping the offsetScreenPoint constant and zoomed.
Remarks
  • The resulting rectangle will already be adjusted for the ratio of the screen. You do not need to afterward call GetDrawingExtent.
Return Value
  • Type:RectangleShape
  • Description:This method returns an extent that is keeping the offsetScreenPoint constant and zoomed.
Parameters
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent that you want centered and zoomed.
  • screenWidth
    • Type:Double
    • Description:This parameter is the width in screen coordinates.
  • screenHeight
    • Type:Double
    • Description:This parameter is the height in screen coordinates.
  • offsetScreenPoint
    • Type:Point
    • Description:This parameter is the screen point you want to keep it constant.
  • percentage
    • Type:Int32
    • Description:This parameter is the percentage you want to zoom.

Protected Methods

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

Protected Properties

Public Events

thinkgeo.mapsuite.silverlightcore.extenthelper.1442911354.txt.gz · Last modified: 2015/09/22 08:42 by admin

Page Tools