Table of Contents
ThinkGeo.MapSuite.Core.GdiPlusRasterLayer
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 general image types to be drawn on the map, such as .BMP, .JPG, .PNG, etc.
Inheritance Hierarchy
- System.Object
- ThinkGeo.MapSuite.Core.Layer
- ThinkGeo.MapSuite.Core.RasterLayer
- ThinkGeo.MapSuite.Core.GdiPlusRasterLayer
Members Summary
Public Constructors
GdiPlusRasterLayer()
- This is a constructor for the class.
Remarks
- If you use this constructor, then you need to set the PathFileName property manually before using the layer.
Parameters
GdiPlusRasterLayer(String)
- This is a constructor for the class.
Remarks
- This constructor gets the layer ready to use.
Parameters
- pathFilename
- Type:String
- Description:This parameter is the path and filename of the GDI+ image file you want to use. If you want to load a Tiff(.tif or .tiff) files, please use the GeoTiffRasterLayer instead for better performance.
GdiPlusRasterLayer(String,String)
- This is a constructor for the class.
Remarks
- This constructor gets the layer ready to use.
Parameters
- pathFilename
- Type:String
- Description:This parameter is the path and filename of the GDI+ image file you want to use. If you want to load a Tiff(.tif or .tiff) files, please use the GeoTiffRasterLayer instead for better performance.
- worldfilePathFilename
- Type:String
- Description:This parameter is the world file path and filename for the GDI+ image you want to use.
GdiPlusRasterLayer(String,RectangleShape)
- This is a constructor for the class.
Remarks
- This constructor gets the layer ready to use.
Parameters
- pathFilename
- Type:String
- Description:This parameter is the path and filename of the GDI+ image file you want to use. If you want to load a Tiff(.tif or .tiff) files, please use the GeoTiffRasterLayer instead for better performance.
- imageExtent
- Type:RectangleShape
- Description:This parameter is the image extent of GDI+ image file you want to use.
Protected Constructors
Public Methods
GetProjectionText()
- N/A
Remarks
- N/A
Return Value
- Type:String
- Description:N/A
Parameters
GetHorizontalResolution()
- N/A
Remarks
- N/A
Return Value
- Type:Single
- Description:N/A
Parameters
GetVerticalResolution()
- N/A
Remarks
- N/A
Return Value
- Type:Single
- Description:N/A
Parameters
RequestDrawing()
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
RequestDrawing(RectangleShape)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- bufferTime
- Type:TimeSpan
- Description:N/A
RequestDrawing(TimeSpan,RequestDrawingBufferTimeType)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- bufferTime
- Type:TimeSpan
- Description:N/A
- bufferTimeType
- Description:N/A
RequestDrawing(RectangleShape,TimeSpan)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- extentToRefresh
- Type:RectangleShape
- Description:N/A
- bufferTime
- Type:TimeSpan
- Description:N/A
RequestDrawing(RectangleShape,TimeSpan,RequestDrawingBufferTimeType)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- extentToRefresh
- Type:RectangleShape
- Description:N/A
- bufferTime
- Type:TimeSpan
- Description:N/A
- bufferTimeType
- Description:N/A
RequestDrawing(IEnumerable<RectangleShape>,TimeSpan)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- extentsToRefresh
- Type:IEnumerable<RectangleShape>
- Description:N/A
- bufferTime
- Type:TimeSpan
- Description:N/A
RequestDrawing(IEnumerable<RectangleShape>,TimeSpan,RequestDrawingBufferTimeType)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- extentsToRefresh
- Type:IEnumerable<RectangleShape>
- Description:N/A
- bufferTime
- Type:TimeSpan
- Description:N/A
- bufferTimeType
- Description:N/A
GetThreadSafetyLevel()
- N/A
Remarks
- N/A
Return Value
- Type:ThreadSafetyLevel
- Description:N/A
Parameters
CloneDeep()
- N/A
Remarks
- N/A
Return Value
- Type:Layer
- Description:N/A
Parameters
Open()
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
Close()
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
GetBoundingBox()
- N/A
Remarks
- N/A
Return Value
- Type:RectangleShape
- Description:N/A
Parameters
Draw(GeoCanvas,Collection<SimpleCandidate>)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- canvas
- Type:GeoCanvas
- Description:N/A
- labelsInAllLayers
- Type:Collection<SimpleCandidate>
- Description:N/A
ToString()
- N/A
Remarks
- N/A
Return Value
- Type:String
- Description:N/A
Parameters
Equals(Object)
- N/A
Remarks
- N/A
Return Value
- Type:Boolean
- Description:N/A
Parameters
- obj
- Type:Object
- Description:N/A
GetHashCode()
- N/A
Remarks
- N/A
Return Value
- Type:Int32
- Description:N/A
Parameters
GetType()
- N/A
Remarks
- N/A
Return Value
- Type:Type
- Description:N/A
Parameters
Protected Methods
DrawCore(GeoCanvas,Collection<SimpleCandidate>)
- This method will draw the image from the GeoImage source based on the parameters provided.
Remarks
- The DrawCore method will be called when the layer is being drawn. It will determine if the image is within the extent and the threshold defined. If these parameters are met, it will query the RasterSource for an image and then apply the other various properties (such as transparency, etc.) on the image. Lastly, it will draw the image on the GeoImage or native image passed into the method.
Return Value
- Type:Void
- Description:None
Parameters
- canvas
- Type:GeoCanvas
- Description:This parameter is the GeoCanvas used to Draw the RasterLayer.
- labelsInAllLayers
- Type:Collection<SimpleCandidate>
- Description:This parameter is not used for ImageLayers.
GetBoundingBoxCore()
- N/A
Remarks
- N/A
Return Value
- Type:RectangleShape
- Description:N/A
Parameters
OpenCore()
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
CloseCore()
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
OnRequestedDrawing(RequestedDrawingLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- eventArgs
- Description:N/A
OnRequestingDrawing(RequestingDrawingLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
Remarks
- N/A
Return Value
- Type:ThreadSafetyLevel
- Description:N/A
Parameters
CloneDeepCore()
- N/A
Remarks
- N/A
Return Value
- Type:Layer
- Description:N/A
Parameters
DrawException(GeoCanvas,Exception)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- canvas
- Type:GeoCanvas
- Description:N/A
- e
- Type:Exception
- Description:N/A
DrawExceptionCore(GeoCanvas,Exception)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- canvas
- Type:GeoCanvas
- Description:N/A
- e
- Type:Exception
- Description:N/A
OnDrawingException(DrawingExceptionLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- e
- Description:N/A
OnDrawnException(DrawnExceptionLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- canvas
- Type:GeoCanvas
- Description:N/A
- attribution
- Type:String
- Description:N/A
OnDrawingAttribution(DrawingAttributionLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- args
- Description:N/A
OnDrawnAttribution(DrawnAttributionLayerEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
- args
- Description:N/A
OnDrawingProgressChanged(DrawingProgressChangedEventArgs)
- N/A
Remarks
- N/A
Return Value
- Type:Void
- Description:N/A
Parameters
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
HasBoundingBox
This property checks to see if a Layer has a BoundingBox or not. If it has no BoundingBox, it will throw an exception when you call the GetBoundingBox() and GetFullExtent() APIs. In GdiPlusRasterLayer, we override this API and mark it as true.
Remarks
The default implementation in the base class returns false.
Return Value
- Type:Boolean
PathFilename
This property gets and sets the path and filename of the image file you want to use.
Remarks
This should be a complete path and filename for the image file.
Return Value
- Type:String
InterpolationMode
Gets or sets the interpolation mode associated with this System.Drawing.Graphics.
Remarks
N/A
Return Value
- Type:InterpolationMode
ImageSource
N/A
Remarks
N/A
Return Value
Remarks
N/A
Return Value
Remarks
N/A
Return Value
Remarks
N/A
Return Value
- Type:Double
LowerThreshold
N/A
Remarks
N/A
Return Value
- Type:Double
HasProjectionText
N/A
Remarks
N/A
Return Value
- Type:Boolean
RequestDrawingInterval
N/A
Remarks
N/A
Return Value
- Type:TimeSpan
IsOpen
N/A
Remarks
N/A
Return Value
- Type:Boolean
DrawingTime
N/A
Remarks
N/A
Return Value
- Type:TimeSpan
Name
N/A
Remarks
N/A
Return Value
- Type:String
Attribution
N/A
Remarks
N/A
Return Value
- Type:String
IsVisible
N/A
Remarks
N/A
Return Value
- Type:Boolean
Transparency
N/A
Remarks
N/A
Return Value
- Type:Single
BlueTranslation
N/A
Remarks
N/A
Return Value
- Type:Single
RedTranslation
N/A
Remarks
N/A
Return Value
- Type:Single
GreenTranslation
N/A
Remarks
N/A
Return Value
- Type:Single
KeyColors
N/A
Remarks
N/A
Return Value
Remarks
N/A
Return Value
- Type:Boolean
IsGrayscale
N/A
Remarks
N/A
Return Value
- Type:Boolean
DrawingExceptionMode
N/A
Remarks
N/A
Return Value
- Type:DrawingExceptionMode
Protected Properties
IsOpenCore
N/A
Remarks
N/A
Return Value
- Type:Boolean
Public Events
StreamLoading
This event allows you to pass in your own stream to represent the image.
Remarks
If you wish, you can pass in your own stream to represent the image. The stream can come from a variety of places, including isolated storage, a compressed file, or an encrypted stream. When the image is finished with the stream it will dispose of it, so be sure to keep this in mind when passing the stream in. If you do not pass in an alternate stream, the class will attempt to load the file from the file system using the PathFileName property.
Event Arguments:StreamLoadingEventArgs
RequestedDrawing
N/A
Remarks
Remarks
Remarks
Remarks
Remarks
Remarks
Remarks
N/A
Event Arguments:DrawnAttributionLayerEventArgs