ThinkGeo.MapSuite.Core.GdiPlusRasterSource
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 allows you to view standard .NET GDI+ image types such as BMP, TIF, JPG, and PNG.
Inheritance Hierarchy
Members Summary
Public Constructors
GdiPlusRasterSource()
Parameters
GdiPlusRasterSource(String)
Parameters
GdiPlusRasterSource(String,String)
Parameters
GdiPlusRasterSource(String,RectangleShape)
Parameters
Protected Constructors
Public Methods
CloneDeep()
Return Value
Parameters
GetWorldFileText()
Return Value
Type:String
Description:N/A
Parameters
GetImageWidth()
Return Value
Type:Int32
Description:N/A
Parameters
GetImageHeight()
Return Value
Type:Int32
Description:N/A
Parameters
GetHorizontalResolution()
Return Value
Type:Single
Description:N/A
Parameters
GetVerticalResolution()
Return Value
Type:Single
Description:N/A
Parameters
GetBoundingBox()
Return Value
Parameters
GetProjectionText()
Return Value
Type:String
Description:N/A
Parameters
Open()
Return Value
Type:Void
Description:N/A
Parameters
Close()
Return Value
Type:Void
Description:N/A
Parameters
GetImage(RectangleShape,Int32,Int32)
Return Value
Parameters
canvasWidth
Type:Int32
Description:N/A
canvasHeight
Type:Int32
Description:N/A
ToString()
Return Value
Type:String
Description:N/A
Parameters
Equals(Object)
Return Value
Type:Boolean
Description:N/A
Parameters
obj
Type:Object
Description:N/A
GetHashCode()
Return Value
Type:Int32
Description:N/A
Parameters
GetType()
Return Value
Type:Type
Description:N/A
Parameters
Protected Methods
OnStreamLoading(StreamLoadingEventArgs)
Return Value
Type:Void
Description:None
Parameters
GetImageWidthCore()
Return Value
Parameters
GetImageHeightCore()
Return Value
Parameters
OpenCore()
This protected virtual method is called from the concrete public method Open. The Open method plays an important role, as it is responsible for initializing the ImageSource. Most methods on the ImageSource will throw an exception if the state of the ImageSource is not opened. When the map draws each layer, it will open the ImageSource as one of its first steps; then, after it is finished drawing with that layer, it will close it. In this way, we are sure to release all resources used by the ImageSource. When implementing this abstract method, consider opening files for file-based sources, connecting to databases in the database-based sources and so on. You will get a chance to close these in the Close method of the ImageSource.
Return Value
Type:Void
Description:None
Parameters
CloseCore()
This protected virtual method is called from the concrete public method Close. The Close method plays an important role in the life cycle of the ImageSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called. If you override this method, it is recommended that that you take the following things into account: This method may be called multiple times, so we suggest you write the method so that that a call to a closed FeatureSource is ignored and does not generate an error. We also suggest that in the Close you free all resources that have been opened. Remember that the object will not be destroyed, but will be re-opened possibly in the near future.
Return Value
Type:Void
Description:None
Parameters
GetImageCore(RectangleShape,Int32,Int32)
Return Value
Parameters
GetBoundingBoxCore()
Return Value
Parameters
OnOpeningRasterSource(OpeningRasterSourceEventArgs)
Return Value
Type:Void
Description:N/A
Parameters
OnOpenedRasterSource(OpenedRasterSourceEventArgs)
Return Value
Type:Void
Description:N/A
Parameters
OnClosingRasterSource(ClosingRasterSourceEventArgs)
Return Value
Type:Void
Description:N/A
Parameters
OnClosedRasterSource(ClosedRasterSourceEventArgs)
Return Value
Type:Void
Description:N/A
Parameters
CloneDeepCore()
Return Value
Parameters
GetProjectionTextCore()
Return Value
Type:String
Description:N/A
Parameters
GetWrappingImageLeft(RectangleShape,Double,Double,RectangleShape)
Return Value
Parameters
screenWidth
Type:Double
Description:N/A
screenHeight
Type:Double
Description:N/A
GetWrappingImageRight(RectangleShape,Double,Double,RectangleShape)
Return Value
Parameters
screenWidth
Type:Double
Description:N/A
screenHeight
Type:Double
Description:N/A
Finalize()
Return Value
Type:Void
Description:N/A
Parameters
MemberwiseClone()
Return Value
Type:Object
Description:N/A
Parameters
Public Properties
IsNegative
This property gets and sets whether the image shows as negative (inverted colors).
You can set this property to show the negative of the image.
Return Value
IsGrayscale
This property gets and sets whether the image shows in grayscale.
This property allows you to show the image in grayscale.
Return Value
FileName
This property returns the filename part of the PathFileName.
Return Value
FilePath
This property returns the path part of the PathFileName.
Return Value
PathFilename
This property returns the path and filename of the image you want to represent.
When you specify the path and filename, it should be in the correct format as such; however, the file does not need to actually exist on the file system. This is to allow us to accept streams supplied by the developer at runtime. If you choose to provide a file that exists, we will attempt to use it. If we cannot find it, then we will raise the SteamLoading event and allow you to supply the stream. For example, you can pass in “C:\NotARealPath\File1.jpg” which does not exist on the file system. When we raise the event for you to supply a stream, we will pass to you the path and filename so you can differentiate the files.
Return Value
Projection
N/A
Return Value
Transparency
N/A
Return Value
BlueTranslation
N/A
Return Value
RedTranslation
N/A
Return Value
GreenTranslation
N/A
Return Value
IsOpen
N/A
Return Value
HasProjectionText
N/A
Return Value
Protected Properties
HasProjectionTextCore
N/A
Return Value
Public Events
StreamLoading
This event allows you to pass in your own stream to represent the image.
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
OpeningRasterSource
N/A