User Tools

Site Tools


thinkgeo.mapsuite.core.ecwrastersource

ThinkGeo.MapSuite.Core.EcwRasterSource

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 the ECW raster source.

Inheritance Hierarchy

Members Summary

Public Constructors

EcwRasterSource()

  • This is the constructor for the class.
Remarks
  • N/A
Parameters

EcwRasterSource(String)

  • This is the constructor for the class.
Remarks
  • This is typically the constructor you want to use for this class. It allows you to pass in the ECW file you wish to work with. Note that the ECW file is not accessed or opened until you call the open command of the class.
Parameters
  • imagePathFilename
    • Type:String
    • Description:This parameter represents the path and file name of the ECW file you want to load into the class for display.

EcwRasterSource(String,String)

  • This is the constructor for the class.
Remarks
  • It allows you to pass in the ECW file you wish to work with, as well as its corresponding world file. Note that the ECW file is not accessed or opened until you call the open command of the class.
Parameters
  • imagePathFilename
    • Type:String
    • Description:This parameter represents the path and file name of the ECW file you want to load into the class for display.
  • worldfilePathFilename
    • Type:String
    • Description:The corresponding world file name that contains the world file information.

EcwRasterSource(String,RectangleShape)

  • This is the constructor for the class.
Remarks
  • It allows you to pass in the ECW file you wish to work with and its corresponding extent. Note that the ECW file is not accessed or opened until you call the open command of the class.
Parameters
  • imagePathFilename
    • Type:String
    • Description:This parameter represents the path and file name of the ECW file you want to load into the class for display.
  • imageExtent
    • Description:The corresponding world extent, which can calculate out the world information with the help of width and height from the ECW file.

Protected Constructors

Public Methods

CloneDeep()

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

GetWorldFileText()

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

GetImageWidth()

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

GetImageHeight()

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

GetBoundingBox()

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

GetProjectionText()

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

GetImage(RectangleShape,Int32,Int32)

  • N/A
Remarks
  • N/A
Return Value
Parameters
  • canvasWidth
    • Type:Int32
    • Description:N/A
  • canvasHeight
    • Type:Int32
    • 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

GetProjectionTextCore()

  • This method returns the projection text in proj4 format.
Remarks
  • This protected virtual method is called from the concrete public method GetProjectionText.The default implementation of this core method is to load the projection information from the ECW file and return the projection information in proj4 projection string format.
Return Value
  • Type:String
  • Description:Projection text string.
Parameters

GetImageWidthCore()

  • This method returns the width of the raster image in screen coordinates.
Remarks
  • This method returns the width of the raster image in screen coordinates.
Return Value
  • Type:Int32
  • Description:This method returns the width of the raster image in screen coordinates.
Parameters

GetImageHeightCore()

  • This method returns the height of the raster image in screen coordinates.
Remarks
  • This method returns the height of the raster image in screen coordinates.
Return Value
  • Type:Int32
  • Description:This method returns the height of the raster image in screen coordinates.
Parameters

OpenCore()

  • This method opens the ImageSource so that it is initialized and ready to use.
Remarks
  • 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 method opens the ImageSource so that it is initialized and ready to use.
Remarks
  • 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 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)

  • This method returns an image based on the worldExtent and raster image width and height.
Remarks
  • This method is responsible for returning the image based on the parameters passed in.
Return Value
  • Type:GeoImage
  • Description:This method returns an image based on the worldExtent and raster image width and height.
Parameters
  • worldExtent
    • Description:This parameter represents the worldExtent you want to draw.
  • canvasWidth
    • Type:Int32
    • Description:This parameter represents the width of the raster image you want to draw.
  • canvasHeight
    • Type:Int32
    • Description:This parameter represents the height of the raster image you want to draw.

GetBoundingBoxCore()

  • This method returns the bounding box of the RasterSource.
Remarks
  • This method returns the bounding box of the RasterSource.
Return Value
  • Description:This method returns the bounding box of the RasterSource.
Parameters

OnOpeningRasterSource(OpeningRasterSourceEventArgs)

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

OnOpenedRasterSource(OpenedRasterSourceEventArgs)

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

OnClosingRasterSource(ClosingRasterSourceEventArgs)

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

OnClosedRasterSource(ClosedRasterSourceEventArgs)

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

CloneDeepCore()

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

GetWrappingImageLeft(RectangleShape,Double,Double,RectangleShape)

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

GetWrappingImageRight(RectangleShape,Double,Double,RectangleShape)

  • N/A
Remarks
  • N/A
Return Value
Parameters
  • screenWidth
    • Type:Double
    • Description:N/A
  • screenHeight
    • Type:Double
    • 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

PathFilename

This property gets or sets the file name and path of the ECW raster image you are working with.

Remarks

If you wish to change the file the class is working with, you would change it here. You cannot change the file you are working with while the class is in an open state.

Return Value
  • Type:String

Projection

N/A

Remarks

N/A

Return Value

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

IsNegative

N/A

Remarks

N/A

Return Value
  • Type:Boolean

IsGrayscale

N/A

Remarks

N/A

Return Value
  • Type:Boolean

IsOpen

N/A

Remarks

N/A

Return Value
  • Type:Boolean

HasProjectionText

N/A

Remarks

N/A

Return Value
  • Type:Boolean

Protected Properties

HasProjectionTextCore

This property returns true if the RasterSource has projection text, false if it does not.

Remarks

This protected virtual method is called from the concrete public property HasProjectionText. Thus, if you inherit RasterSource, please ensure that you override this virtual property to return the correct projection status of your raster source.We will check the HasProjectionText status before you call the GetProjectionText method. It will throw an exception if the HasProjectionText property returns false.

Return Value
  • Type:Boolean

Public Events

OpeningRasterSource N/A

Remarks

N/A

Event Arguments:OpeningRasterSourceEventArgs

OpenedRasterSource N/A

Remarks

N/A

Event Arguments:OpenedRasterSourceEventArgs

ClosingRasterSource N/A

Remarks

N/A

Event Arguments:ClosingRasterSourceEventArgs

ClosedRasterSource N/A

Remarks

N/A

Event Arguments:ClosedRasterSourceEventArgs

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