====== ThinkGeo.Core.NativeImageRasterSource ====== ===== Inheritance Hierarchy ===== *System.Object *ThinkGeo.Core.RasterSource ***ThinkGeo.Core.NativeImageRasterSource** ===== Members Summary ===== ==== Public Constructors ==== ** {{wiki:PublicMethod.gif|}} NativeImageRasterSource() ** * //This is the constructor the for the class.// == Remarks == * //None// == Parameters ==
** {{wiki:PublicMethod.gif|}} NativeImageRasterSource(String) ** * //This is the constructor the for the class.// == Remarks == * //You can specify a path and filename that does not actually exist if you use the StreamLoading event. This event only uses the PathFilename parameter as a unique string that will be passed to you in the event, so that you can determine what stream you want to pass back.// == Parameters == * //imagePathFilename// * Type:String * Description:This parameter represents the image you want to load.
** {{wiki:PublicMethod.gif|}} NativeImageRasterSource(String,String) ** * //This is the constructor the for the class.// == Remarks == * //You can specify a path and filename that does not actually exist if you use the StreamLoading event. This event only uses the PathFilename parameter as a unique string that will be passed to you in the event, so that you can determine what stream you want to pass back.// == Parameters == * //imagePathFilename// * Type:String * Description:This parameter represents the image you want to load. * //worldfilePathFilename// * Type:String * Description:This parameter represents the world file path and filename you want to load.
** {{wiki:PublicMethod.gif|}} NativeImageRasterSource(String,RectangleShape) ** * //This is the constructor the for the class.// == Remarks == * //You can specify a path and filename that does not actually exist if you use the StreamLoading event. This event only uses the PathFilename parameter as a unique string that will be passed to you in the event, so that you can determine what stream you want to pass back.// == Parameters == * //imagePathFilename// * Type:String * Description:This parameter represents the image you want to load. * //imageExtent// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:This parameter represents the extnet of the image you want to load.
==== Protected Constructors ==== ==== Public Methods ==== ** {{wiki:PublicMethod.gif|}} CloneDeep() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.RasterSource|RasterSource]] * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetWorldFileText() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:String * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetImageWidth() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Int32 * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetImageHeight() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Int32 * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetHorizontalResolution() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetVerticalResolution() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetBoundingBox() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} Open() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} Close() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} GetImage(RectangleShape,Int32,Int32) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.GeoImage|GeoImage]] * Description:N/A == Parameters == * //worldExtent// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A * //canvasWidth// * Type:Int32 * Description:N/A * //canvasHeight// * Type:Int32 * Description:N/A
** {{wiki:PublicMethod.gif|}} GetType() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Type * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} ToString() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:String * Description:N/A == Parameters ==
** {{wiki:PublicMethod.gif|}} Equals(Object) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Boolean * Description:N/A == Parameters == * //obj// * Type:Object * Description:N/A
** {{wiki:PublicMethod.gif|}} GetHashCode() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Int32 * Description:N/A == Parameters ==
===== Protected Methods ===== ** {{wiki:ProtectedMethod.gif|}} OnStreamLoading(StreamLoadingEventArgs) ** * //N/A// == Remarks == * //This method allows you to raise the StreamLoading event. Normally events are not accessible to derived classes, so we exposed a way to raise the event as necessary through this protected method.// == Return Value == * Type:Void * Description:None == Parameters == * //e// * Type:[[ThinkGeo.Core.StreamLoadingEventArgs|StreamLoadingEventArgs]] * Description:This parameter represents the event arguments you want to raise the StreamLoading event with.
** {{wiki:ProtectedMethod.gif|}} GetImageWidthCore() ** * //N/A// == Remarks == * //This method returns the width of the image in screen coordinates.// == Return Value == * Type:Int32 * Description:This method returns the width of the image in screen coordinates. == Parameters ==
** {{wiki:ProtectedMethod.gif|}} GetImageHeightCore() ** * //N/A// == Remarks == * //This method returns the height of the image in screen coordinates.// == Return Value == * Type:Int32 * Description:This method returns the height of the image in screen coordinates. == Parameters ==
** {{wiki:ProtectedMethod.gif|}} OpenCore() ** * //N/A// == 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 Image. Most methods on the Image will throw an exception if the state of the Image is not opened. When the map draws each layer, it will open the Image 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 Image. 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 Image.// == Return Value == * Type:Void * Description:None == Parameters ==
** {{wiki:ProtectedMethod.gif|}} CloseCore() ** * //N/A// == 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 Image. 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 ==
** {{wiki:ProtectedMethod.gif|}} GetImageCore(RectangleShape,Int32,Int32) ** * //N/A// == Remarks == * //This method is responsible for returning the image based on the parameters passed in.// == Return Value == * Type:[[ThinkGeo.Core.GeoImage|GeoImage]] * Description:This method returns an image based on the worldExtent, image width and image height. == Parameters == * //worldExtent// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:This parameter represents the worldExtent you want to draw. * //canvasWidth// * Type:Int32 * Description:This parameter represents the width of the image you want to draw. * //canvasHeight// * Type:Int32 * Description:This parameter represents the height of the image you want to draw.
** {{wiki:ProtectedMethod.gif|}} GetBoundingBoxCore() ** * //N/A// == Remarks == * //This method returns the bounding box of the RasterSource.// == Return Value == * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:This method returns the bounding box of the RasterSource. == Parameters ==
** {{wiki:ProtectedMethod.gif|}} OnOpeningRasterSource(OpeningRasterSourceEventArgs) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters == * //e// * Type:[[ThinkGeo.Core.OpeningRasterSourceEventArgs|OpeningRasterSourceEventArgs]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} OnChangedSourceStatus(ChangedSourceStatusEventArgs) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters == * //e// * Type:[[ThinkGeo.Core.ChangedSourceStatusEventArgs|ChangedSourceStatusEventArgs]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} OnOpenedRasterSource(OpenedRasterSourceEventArgs) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters == * //e// * Type:[[ThinkGeo.Core.OpenedRasterSourceEventArgs|OpenedRasterSourceEventArgs]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} OnClosingRasterSource(ClosingRasterSourceEventArgs) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters == * //e// * Type:[[ThinkGeo.Core.ClosingRasterSourceEventArgs|ClosingRasterSourceEventArgs]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} OnClosedRasterSource(ClosedRasterSourceEventArgs) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters == * //e// * Type:[[ThinkGeo.Core.ClosedRasterSourceEventArgs|ClosedRasterSourceEventArgs]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} CloneDeepCore() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.RasterSource|RasterSource]] * Description:N/A == Parameters ==
** {{wiki:ProtectedMethod.gif|}} GetWrappingImageLeft(RectangleShape,Double,Double,RectangleShape) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.GeoImage|GeoImage]] * Description:N/A == Parameters == * //boundingBox// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A * //screenWidth// * Type:Double * Description:N/A * //screenHeight// * Type:Double * Description:N/A * //wrappingExtent// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} GetWrappingImageRight(RectangleShape,Double,Double,RectangleShape) ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.GeoImage|GeoImage]] * Description:N/A == Parameters == * //boundingBox// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A * //screenWidth// * Type:Double * Description:N/A * //screenHeight// * Type:Double * Description:N/A * //wrappingExtent// * Type:[[ThinkGeo.Core.RectangleShape|RectangleShape]] * Description:N/A
** {{wiki:ProtectedMethod.gif|}} MemberwiseClone() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Object * Description:N/A == Parameters ==
** {{wiki:ProtectedMethod.gif|}} Finalize() ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Void * Description:N/A == Parameters ==
==== Public Properties ==== ** {{wiki:PublicProperty.gif|}} IsNegative ** * //N/A// == Remarks == * //You can set this property to show the negative of the image.// == Return Value == * Type:Boolean ** {{wiki:PublicProperty.gif|}} IsGrayscale ** * //N/A// == Remarks == * //This property allows you to show the image in grayscale.// == Return Value == * Type:Boolean ** {{wiki:PublicProperty.gif|}} FileName ** * //N/A// == Remarks == * //None// == Return Value == * Type:String ** {{wiki:PublicProperty.gif|}} FilePath ** * //N/A// == Remarks == * //None// == Return Value == * Type:String ** {{wiki:PublicProperty.gif|}} ImagePathFilename ** * //N/A// == Remarks == * //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 == * Type:String ** {{wiki:PublicProperty.gif|}} ProjectionConverter ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.ProjectionConverter|ProjectionConverter]] ** {{wiki:PublicProperty.gif|}} Projection ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:[[ThinkGeo.Core.Projection|Projection]] ** {{wiki:PublicProperty.gif|}} Transparency ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single ** {{wiki:PublicProperty.gif|}} BlueTranslation ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single ** {{wiki:PublicProperty.gif|}} RedTranslation ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single ** {{wiki:PublicProperty.gif|}} GreenTranslation ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Single ** {{wiki:PublicProperty.gif|}} ScaleFactor ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Double ** {{wiki:PublicProperty.gif|}} IsOpen ** * //N/A// == Remarks == * //N/A// == Return Value == * Type:Boolean ==== Protected Properties ==== ==== Public Events ==== ** {{wiki:PublicEvent.gif|}} StreamLoading ** * //N/A// == 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:[[ThinkGeo.Core.StreamLoadingEventArgs|StreamLoadingEventArgs]] ** {{wiki:PublicEvent.gif|}} OpeningRasterSource ** * //N/A// == Remarks == * //N/A// Event Arguments:[[ThinkGeo.Core.OpeningRasterSourceEventArgs|OpeningRasterSourceEventArgs]] ** {{wiki:PublicEvent.gif|}} OpenedRasterSource ** * //N/A// == Remarks == * //N/A// Event Arguments:[[ThinkGeo.Core.OpenedRasterSourceEventArgs|OpenedRasterSourceEventArgs]] ** {{wiki:PublicEvent.gif|}} ClosingRasterSource ** * //N/A// == Remarks == * //N/A// Event Arguments:[[ThinkGeo.Core.ClosingRasterSourceEventArgs|ClosingRasterSourceEventArgs]] ** {{wiki:PublicEvent.gif|}} ClosedRasterSource ** * //N/A// == Remarks == * //N/A// Event Arguments:[[ThinkGeo.Core.ClosedRasterSourceEventArgs|ClosedRasterSourceEventArgs]]