User Tools

Site Tools

Trace: • thinkgeo.mapsuite.core.gdiplusgeocanvas

Sidebar

ThinkGeo Cloud

ThinkGeo UI Controls

ThinkGeo Open Source

Help and Support

External Resources

thinkgeo.mapsuite.core.gdiplusgeocanvas

Table of Contents

ThinkGeo.MapSuite.Core.GdiPlusGeoCanvas

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 canvas that is used to draw geographic shapes with GDI+.

Inheritance Hierarchy

  • System.Object
    • ThinkGeo.MapSuite.Core.GeoCanvas
      • ThinkGeo.MapSuite.Core.GdiPlusGeoCanvas

Members Summary

Public Constructors

GdiPlusGeoCanvas()

  • This method is the default constructor for the GdiPlusGeoCanvas.
Remarks
  • None
Parameters

Protected Constructors

Public Methods

GetStreamFromGeoImage(GeoImage)

  • This method returns a stream that represents the GeoImage in TIFF format.
Remarks
  • This method allows you to get the stream out of a GeoImage. The stream is a memory stream and the bytes are in TIFF format. Once you have the stream, you can then save it to whatever format you need.
Return Value
  • Type:Stream
  • Description:This method returns a stream that represents the GeoImage in TIFF format.
Parameters
  • image
    • Type:GeoImage
    • Description:This parameter is the GeoImage you want to convert to a stream.

DrawWorldImageWithoutScaling(Bitmap,Double,Double,DrawingLevel)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:Bitmap
    • Description:The image you want to draw unscaled.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point (in world coordinates) of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point (in world coordinates) of where you want to draw the image.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.

DrawWorldImageWithoutScaling(Bitmap,Double,Double,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:Bitmap
    • Description:The image you want to draw unscaled.
  • centerXInWorld
    • Type:Double
    • Description:The X coordinate of the center point (in world coordinates) of where you want to draw the image.
  • centerYInWorld
    • Type:Double
    • Description:The Y coordinate of the center point (in world coordinates) of where you want to draw the image.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset (in pixels) for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset (in pixels) for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawScreenImageWithoutScaling(Bitmap,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:Bitmap
    • Description:The image you want to draw unscaled.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

CloneDeep()

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

Clear(GeoBrush)

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

DrawArea(Feature,GeoPen,DrawingLevel)

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

DrawArea(AreaBaseShape,GeoPen,DrawingLevel)

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

DrawArea(Feature,GeoBrush,DrawingLevel)

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

DrawArea(AreaBaseShape,GeoBrush,DrawingLevel)

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

DrawArea(Feature,GeoPen,GeoBrush,DrawingLevel)

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

DrawArea(AreaBaseShape,GeoPen,GeoBrush,DrawingLevel)

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

DrawArea(Feature,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawArea(AreaBaseShape,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawArea(IEnumerable<ScreenPointF[]>,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawLine(Feature,GeoPen,DrawingLevel)

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

DrawLine(LineBaseShape,GeoPen,DrawingLevel)

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

DrawLine(Feature,GeoPen,DrawingLevel,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
  • linePen
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawLine(LineBaseShape,GeoPen,DrawingLevel,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • linePen
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawLine(IEnumerable<ScreenPointF>,GeoPen,DrawingLevel,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoints
  • linePen
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawEllipse(Feature,Single,Single,GeoPen,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen

DrawEllipse(PointBaseShape,Single,Single,GeoPen,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen

DrawEllipse(Feature,Single,Single,GeoBrush,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerPointFeature
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • fillBrush

DrawEllipse(PointBaseShape,Single,Single,GeoBrush,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • fillBrush

DrawEllipse(Feature,Single,Single,GeoPen,GeoBrush,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen
  • fillBrush

DrawEllipse(PointBaseShape,Single,Single,GeoPen,GeoBrush,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen
  • fillBrush

DrawEllipse(Feature,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • feature
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawEllipse(PointBaseShape,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawEllipse(ScreenPointF,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • width
    • Type:Single
    • Description:N/A
  • height
    • Type:Single
    • Description:N/A
  • outlinePen
  • fillBrush
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A

DrawWorldImageWithoutScaling(GeoImage,Double,Double,DrawingLevel)

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

DrawWorldImageWithoutScaling(GeoImage,Double,Double,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInWorld
    • Type:Double
    • Description:N/A
  • centerYInWorld
    • Type:Double
    • Description:N/A
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

DrawScreenImageWithoutScaling(GeoImage,Single,Single,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInScreen
    • Type:Single
    • Description:N/A
  • centerYInScreen
    • Type:Single
    • Description:N/A
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

DrawWorldImage(GeoImage,Double,Double,Single,Single,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInWorld
    • Type:Double
    • Description:N/A
  • centerYInWorld
    • Type:Double
    • Description:N/A
  • widthInScreen
    • Type:Single
    • Description:N/A
  • heightInScreen
    • Type:Single
    • Description:N/A

DrawWorldImage(GeoImage,Double,Double,Double,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInWorld
    • Type:Double
    • Description:N/A
  • centerYInWorld
    • Type:Double
    • Description:N/A
  • imageScale
    • Type:Double
    • Description:N/A
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

DrawWorldImage(GeoImage,Double,Double,Single,Single,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInWorld
    • Type:Double
    • Description:N/A
  • centerYInWorld
    • Type:Double
    • Description:N/A
  • widthInScreen
    • Type:Single
    • Description:N/A
  • heightInScreen
    • Type:Single
    • Description:N/A
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

DrawScreenImage(GeoImage,Single,Single,Single,Single,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • centerXInScreen
    • Type:Single
    • Description:N/A
  • centerYInScreen
    • Type:Single
    • Description:N/A
  • widthInScreen
    • Type:Single
    • Description:N/A
  • heightInScreen
    • Type:Single
    • Description:N/A
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

DrawTextWithScreenCoordinate(String,GeoFont,GeoBrush,Single,Single,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • upperLeftXInScreen
    • Type:Single
    • Description:N/A
  • upperLeftYInScreen
    • Type:Single
    • Description:N/A

DrawTextWithScreenCoordinate(String,GeoFont,GeoBrush,GeoPen,Single,Single,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • haloPen
  • upperLeftXInScreen
    • Type:Single
    • Description:N/A
  • upperLeftYInScreen
    • Type:Single
    • Description:N/A

DrawTextWithWorldCoordinate(String,GeoFont,GeoBrush,Double,Double,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • upperLeftXInWorld
    • Type:Double
    • Description:N/A
  • upperLeftYInWorld
    • Type:Double
    • Description:N/A

DrawTextWithWorldCoordinate(String,GeoFont,GeoBrush,GeoPen,Double,Double,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • haloPen
  • upperLeftXInWorld
    • Type:Double
    • Description:N/A
  • upperLeftYInWorld
    • Type:Double
    • Description:N/A

DrawText(String,GeoFont,GeoBrush,IEnumerable<ScreenPointF>,DrawingLevel)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • textPathInScreen

DrawText(String,GeoFont,GeoBrush,GeoPen,IEnumerable<ScreenPointF>,DrawingLevel,Single,Single,Single)

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:N/A
  • font
  • fillBrush
  • haloPen
  • textPathInScreen
  • xOffset
    • Type:Single
    • Description:N/A
  • yOffset
    • Type:Single
    • Description:N/A
  • rotateAngle
    • Type:Single
    • Description:N/A

MeasureText(String,GeoFont)

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

BeginDrawing(Object,RectangleShape,GeographyUnit)

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

ToNativeImage(GeoImage)

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

ToGeoImage(Object)

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

EndDrawing()

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

Flush()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
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

FillBackground(GeoImage,GeoBrush)

  • This method fills the specified GeoImage with the specified GeoBrush.
Remarks
  • This method allows you to fill a GeoImage with the specific fill style of the GeoBrush you pass in. It is useful for setting backgrounds.
Return Value
  • Type:Void
  • Description:None
Parameters
  • image
    • Type:GeoImage
    • Description:This parameter is the GeoImage you want to set the background on.
  • brush
    • Type:GeoBrush
    • Description:This parameter is the GeoBrush you want to fill the background with.

ConvertGeoImageToMemoryStream(GeoImage)

  • This method converts a GeoImage to a memory stream.
Remarks
  • This method is used to get a TIFF memory stream from a GeoImage using the canvas-specific methods. If you need to get a format other than TIFF, you can use the other overload which allows you to specify the output format.
Return Value
  • Type:MemoryStream
  • Description:This method converts a GeoImage to a memory stream.
Parameters
  • image
    • Type:GeoImage
    • Description:This parameter is the GeoImage you want to convert to a stream.

ConvertGeoImageToMemoryStream(GeoImage,ImageFormat)

  • This method converts a GeoImage to a memory stream.
Remarks
  • This method allows you to save the GeoImage to any format you specify. This allows you to convert it to a PNG, or a variety of other formats, and then save it to disk.
Return Value
  • Type:MemoryStream
  • Description:The return is a memory stream with the bytes formatted according to the image format you specify.
Parameters
  • image
    • Type:GeoImage
    • Description:This parameter is the GeoImage you want to convert to a memory stream.
  • imageFormat
    • Type:ImageFormat
    • Description:This parameter is the image format you want the stream to be in.

CreateGeoImage(Int32,Int32)

  • This method returns a GeoImage based on the height and width you provide.
Remarks
  • You can use this static member to easily create a GeoCanvas.
Return Value
  • Type:GeoImage
  • Description:This method returns a GeoImage based on the height and width you provide.
Parameters
  • width
    • Type:Int32
    • Description:This parameter is the width of the GeoImage.
  • height
    • Type:Int32
    • Description:This parameter is the height of the GeoImage.

Protected Methods

DrawAreaCore(IEnumerable<ScreenPointF[]>,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • This method draws the area on the GeoCanvas.
Remarks
  • This method is used to draw on the GeoCanvas. It provides you with a number of overloads that allow you to control how things are drawn. Specify the GeoBrush to fill in an area. Specify the GeoPen to outline an area using that GeoPen. You can also call an overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when you are drawing multiple areas. This is very useful when you want to draw a drop shadow, for example. In that case, you could draw the black backdrop on the lowest level with an offset, then draw the normal shape on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF[]>
    • Description:This parameter is the area point in screen coordinates.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the area.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the GeoBrush that will be used to draw the area.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the area to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the area to be drawn.
  • penBrushDrawingOrder

DrawLineCore(IEnumerable<ScreenPointF>,GeoPen,DrawingLevel,Single,Single)

  • Draws a LineShape on the GeoCanvas.
Remarks
  • This method is used to draw a line on the GeoCanvas using the specified GeoPen.The DrawingLevel allows you to specify the level you will draw on when drawing multiple lines. This is very useful when you want to draw a road, for example. You can draw the black background on the lowest level, then draw a slightly thinner white line on a higher level. This will result in a great effect for a road.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoints
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter represents the line points in screen coordinates.
  • linePen
    • Type:GeoPen
    • Description:This parameter describes the GeoPen that will be used to draw the LineShape.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the line to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the line to be drawn.

DrawEllipseCore(ScreenPointF,Single,Single,GeoPen,GeoBrush,DrawingLevel,Single,Single,PenBrushDrawingOrder)

  • Draws the point on the GeoCanvas.
Remarks
  • This method is used to draw a point on the GeoCanvas. It provides you with a number of overloads that allow you to control how it is drawn. Specify the GeoBrush to fill in the area of the point. Specify the GeoPen to outline the point using that GeoPen. You can also call a overload that will allow you to specify both a GeoPen and a GeoBrush.The DrawingLevel allows you to specify the level you will draw on when drawing many points.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • screenPoint
    • Type:ScreenPointF
    • Description:This parameter is the point in screen coordinates.
  • width
    • Type:Single
    • Description:This parameter describes the width of the ellipse to be drawn.
  • height
    • Type:Single
    • Description:This parameter describes the height of the ellipse to be drawn.
  • outlinePen
    • Type:GeoPen
    • Description:This parameter describes the outline GeoPen that will be used to draw the point.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter describes the fill GeoBrush that will be used to draw the point.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel that the GeoPen or GeoBrush will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset of the ellipse to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset of the ellipse to be drawn.
  • penBrushDrawingOrder

DrawScreenImageWithoutScalingCore(GeoImage,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws an unscaled image on the GeoCanvas.
Remarks
  • Drawing an image unscaled is faster than using the API that scales it.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw unscaled.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawScreenImageCore(GeoImage,Single,Single,Single,Single,DrawingLevel,Single,Single,Single)

  • Draws a scaled image on the GeoCanvas.
Remarks
  • Drawing an image scaled is slower than using the API that draws it unscaled.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • image
    • Type:GeoImage
    • Description:The image you want to draw.
  • centerXInScreen
    • Type:Single
    • Description:The X coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • centerYInScreen
    • Type:Single
    • Description:The Y coordinate of the center point (in screen coordinates) of where you want to draw the image.
  • widthInScreen
    • Type:Single
    • Description:The width you want to scale the image to. This is the width at which the image will be drawn.
  • heightInScreen
    • Type:Single
    • Description:The height you want to scale the image to. This is the height at which the image will be drawn.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter determines the DrawingLevel the image will draw on.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the image to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the image to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the image to be drawn.

DrawTextCore(String,GeoFont,GeoBrush,GeoPen,IEnumerable<ScreenPointF>,DrawingLevel,Single,Single,Single)

  • This method allows you to draw text at the specified location, using the specified brush and font parameters.
Remarks
  • This method is used to draw text on the GeoCanvas.The DrawingLevel allows you to specify the level you will draw on when drawing multiple text items. This is very useful when you want to draw a drop shadow, for example. You can draw the black backdrop on the lowest level with an offset, then draw the normal text on a higher level without an offset.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • text
    • Type:String
    • Description:This parameter specifies the text you wish to draw.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font you wish to use to draw the text.
  • fillBrush
    • Type:GeoBrush
    • Description:This parameter specifies the kind of fill you want to use to draw the text.
  • haloPen
    • Type:GeoPen
    • Description:This parameter specifies the HaloPen that will be used to draw the text, when the HaloPen effect is needed.
  • textPathInScreen
    • Type:IEnumerable<ScreenPointF>
    • Description:This parameter specifies the path on which to draw the text.
  • drawingLevel
    • Type:DrawingLevel
    • Description:This parameter specifies the drawing level you wish to draw the text on. Higher levels overwrite lower levels.
  • xOffset
    • Type:Single
    • Description:This parameter determines the X offset for the text to be drawn.
  • yOffset
    • Type:Single
    • Description:This parameter determines the Y offset for the text to be drawn.
  • rotateAngle
    • Type:Single
    • Description:This parameter determines the rotation angle for the text to be drawn.

MeasureTextCore(String,GeoFont)

  • This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Remarks
  • This method is typically used for labeling, to determine whether labels overlap.
Return Value
  • Type:DrawingRectangleF
  • Description:This method returns the rectangle that contains the specified text, when that text is drawn with the specified font.
Parameters
  • text
    • Type:String
    • Description:This parameter represents the text you want to measure.
  • font
    • Type:GeoFont
    • Description:This parameter represents the font of the text you want to measure.

BeginDrawingCore(Object,RectangleShape,GeographyUnit)

  • This method begins the act of drawing on the GeoCanvas.
Remarks
  • This is the first method that needs to be called before any drawing takes place. Calling this method will set the IsDrawing property to true. When you finish drawing, you must call EndDrawing to commit the changes to the image.
Return Value
  • Type:Void
  • Description:N/A
Parameters
  • nativeImage
    • Type:Object
    • Description:This parameter represents the image you want the GeoCanvas to draw on.
  • worldExtent
    • Type:RectangleShape
    • Description:This parameter is the world extent of the canvasImage.
  • drawingMapUnit
    • Type:GeographyUnit
    • Description:This parameter is the map unit of the canvasImage.

EndDrawingCore()

  • This method ends drawing and commits the drawing on the GeoCanvas.
Remarks
  • This method should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

FlushCore()

  • This method flush drawing and commits the drawing on the GeoCanvas.
Remarks
  • This method should be called when you are finished drawing. It will commit the image changes to the image you passed in on BeginDrawing. It will also set IsDrawing to false. After you call this method it will put the GeoCanvas into an invalid state, so if you then call any drawing methods it will raise an exception.
Return Value
  • Type:Void
  • Description:N/A
Parameters

ToNativeImageCore(GeoImage)

  • This method returns a native image object from the specified GeoCanvas.
Remarks
  • It is faster to provide a native image object to the canvas for drawing. In some cases, you may not know what the native image type is. For example, for GDI+ it is a bitmap class, but in GDI it may be a handled to an HBitmap. If you are not sure how to create the native image object, you should first create a GeoImage and then call this method and it will pass back the native image object. You can then use it to get excellent drawing performance on the GeoCanvas.
Return Value
  • Type:Object
  • Description:This method returns a native image object from the specified GeoCanvas.
Parameters
  • image
    • Type:GeoImage
    • Description:This parameter is the GeoCanvas you want to convert to a native image.

ToGeoImageCore(Object)

  • This method returns a GeoImage from a native image object.
Remarks
  • This method will allows you to convert your native image object to a GeoImage. Many times, when you work with a GeoCanvas, you may not know the format of the native image. Using this method you can always convert it back to a GeoImage, which is a stream of a TIFF.
Return Value
  • Type:GeoImage
  • Description:This method returns a GeoImage from a native image object.
Parameters
  • nativeImage
    • Type:Object
    • Description:This parameter is the native image object you want to convert to a GeoImage.

DrawEvalWaterMarked(String)

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

DrawFullWaterMarked(String)

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

GetCanvasWidthCore(Object)

  • This method gets the canvas width of the specified native image object.
Remarks
  • N/A
Return Value
  • Type:Single
  • Description:The returning canvas width.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image will be used to get the canvas width.

GetCanvasHeightCore(Object)

  • This method gets the canvas height of the specified native image object.
Remarks
  • N/A
Return Value
  • Type:Single
  • Description:The returning canvas height.
Parameters
  • nativeImage
    • Type:Object
    • Description:The native image will be used to get the canvas height.

OnDrawingProgressChanged(DrawingProgressChangedEventArgs)

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

ToWorldCoordinate(DrawingRectangleF)

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

CloneDeepCore()

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

ClearCore(GeoBrush)

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

GetCanvasWidth(Object)

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

GetCanvasHeight(Object)

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

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

CompositingQuality

This property returns or sets the quality level to use during compositing.

Remarks

This property is used for GDI+ drawing. The excerpt below is from the GDI+ documentation: Compositing is done during rendering when the source pixels are combined with the destination pixels to produce the resultant pixels. The quality of compositing directly relates to the visual quality of the output and is inversely proportional to the render time. The higher the quality, the slower the render time. This is because the higher the quality level, the more surrounding pixels need to be taken into account during the composite. The linear quality setting (AssumeLinear) compromises by providing better quality than the default quality at a slightly lower speed.

Return Value
  • Type:CompositingQuality

SmoothingMode

This property returns or sets the rendering quality for this GeoCanvas.

Remarks

This property is used for GDI+ drawing. The excerpt below is from the GDI+ documentation: The smoothing mode specifies whether lines, curves, and the edges of filled areas use smoothing (also called antialiasing). One exception is that path gradient brushes do not obey the smoothing mode. Areas filled using a PathGradientBrush are rendered the same way (aliased) regardless of the SmoothingMode property.

Return Value
  • Type:SmoothingMode

HasKeyColor

This property indicates whether a GdiPlusGeoCanvas has the KeyColor or not. If it has no KeyColor, it will throw an exception when you get or set the value of KeyColors property.

Remarks

The default value is true.

Return Value
  • Type:Boolean

TextRenderingHint

This property returns or sets the rendering mode for text associated with this GeoCanvas.

Remarks

This property is used for GDI+ drawing. The excerpt below is from the GDI+ documentation: The text rendering hint specifies whether text renders with antialiasing.

Return Value
  • Type:TextRenderingHint

InterpolationMode

Gets or sets the interpolation mode associated with this System.Drawing.Graphics.

Remarks

N/A

Return Value
  • Type:InterpolationMode

ClippingArea

N/A

Remarks

N/A

Return Value

CurrentScale

N/A

Remarks

N/A

Return Value
  • Type:Double

DrawingQuality

N/A

Remarks

N/A

Return Value

MapUnit

N/A

Remarks

N/A

Return Value

Width

N/A

Remarks

N/A

Return Value
  • Type:Single

Height

N/A

Remarks

N/A

Return Value
  • Type:Single

CurrentWorldExtent

N/A

Remarks

N/A

Return Value

KeyColors

N/A

Remarks

N/A

Return Value

NativeImage

N/A

Remarks

N/A

Return Value
  • Type:Object

IsDrawing

N/A

Remarks

N/A

Return Value
  • Type:Boolean

Dpi

N/A

Remarks

N/A

Return Value
  • Type:Single

Protected Properties

HasDrawn

N/A

Remarks

N/A

Return Value
  • Type:Boolean

Public Events

DrawingProgressChanged N/A

Remarks

N/A

Event Arguments:DrawingProgressChangedEventArgs

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

Page Tools