User Tools

Site Tools


thinkgeo.mapsuite.core.rastersource

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
thinkgeo.mapsuite.core.rastersource [2015/09/21 01:09]
admin
thinkgeo.mapsuite.core.rastersource [2017/03/16 21:59] (current)
Line 1: Line 1:
 ====== ThinkGeo.MapSuite.Core.RasterSource ====== ====== ThinkGeo.MapSuite.Core.RasterSource ======
 +
 +{{section>​upgrade_map_suite_to_10.0}}
 +
 The abstract class from which all raster sources inherit. Raster sources represent raster data that can be integrated into Map Suite. The abstract class from which all raster sources inherit. Raster sources represent raster data that can be integrated into Map Suite.
 ===== Inheritance Hierarchy ===== ===== Inheritance Hierarchy =====
   *System.Object   *System.Object
     ***ThinkGeo.MapSuite.Core.RasterSource**     ***ThinkGeo.MapSuite.Core.RasterSource**
-      *[[ThinkGeo.MapSuite.Core.GdiPlusRasterSource]] 
-      *[[ThinkGeo.MapSuite.Core.GeoTiffRasterSource]] 
       *[[ThinkGeo.MapSuite.Core.KmlRasterSource]]       *[[ThinkGeo.MapSuite.Core.KmlRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.NoaaRadarRasterSource]]
       *[[ThinkGeo.MapSuite.Core.ManagedGeoTiffRasterSource]]       *[[ThinkGeo.MapSuite.Core.ManagedGeoTiffRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.UnmanagedGeoTiffRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.GeoTiffRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.EcwRasterSource]]
       *[[ThinkGeo.MapSuite.Core.TiledWmsRasterSource]]       *[[ThinkGeo.MapSuite.Core.TiledWmsRasterSource]]
       *[[ThinkGeo.MapSuite.Core.WmsRasterSource]]       *[[ThinkGeo.MapSuite.Core.WmsRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.GdiPlusRasterSource]]
 +      *[[ThinkGeo.MapSuite.Core.MrSidRasterSource]]
 ===== Members Summary ===== ===== Members Summary =====
 ==== Public Constructors ==== ==== Public Constructors ====
Line 15: Line 22:
 ** {{wiki:​ProtectedMethod.gif|}} RasterSource() ** ** {{wiki:​ProtectedMethod.gif|}} RasterSource() **
  
-This is the default new constructor for the RasterSource.+  * //This is the default new constructor for the RasterSource.//
 == Remarks == == Remarks ==
-None+  * //None//
 == Parameters == == Parameters ==
 <div newline></​div>​ <div newline></​div>​
Line 23: Line 30:
 ** {{wiki:​PublicMethod.gif|}} CloneDeep() ** ** {{wiki:​PublicMethod.gif|}} CloneDeep() **
  
-Create a copy of RasterSource using the deep clone process.+  * //Create a copy of RasterSource using the deep clone process.//
 == Remarks == == Remarks ==
-The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.+  * //The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.//
  
 == Return Value == == Return Value ==
Line 35: Line 42:
 ** {{wiki:​PublicMethod.gif|}} GetWorldFileText() ** ** {{wiki:​PublicMethod.gif|}} GetWorldFileText() **
  
-This method returns a string that represents the image'​s world file.+  * //This method returns a string that represents the image'​s world file.//
 == Remarks == == Remarks ==
-This method wraps the Core version of this method and returns a string that represents the image'​s world file. The world file is a file type that can accompany image files. It contains information about the image'​s position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method wraps the Core version of this method and returns a string that represents the image'​s world file. The world file is a file type that can accompany image files. It contains information about the image'​s position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 47: Line 54:
 ** {{wiki:​PublicMethod.gif|}} GetImageWidth() ** ** {{wiki:​PublicMethod.gif|}} GetImageWidth() **
  
-This method returns the width of the image in screen coordinates.+  * //This method returns the width of the image in screen coordinates.//
 == Remarks == == Remarks ==
-This method returns the width of the image in screen coordinates. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method returns the width of the image in screen coordinates. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 59: Line 66:
 ** {{wiki:​PublicMethod.gif|}} GetImageHeight() ** ** {{wiki:​PublicMethod.gif|}} GetImageHeight() **
  
-This method returns the height of the image in screen coordinates.+  * //This method returns the height of the image in screen coordinates.//
 == Remarks == == Remarks ==
-This method returns the height of the image in screen coordinates. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method returns the height of the image in screen coordinates. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 71: Line 78:
 ** {{wiki:​PublicMethod.gif|}} GetHorizontalResolution() ** ** {{wiki:​PublicMethod.gif|}} GetHorizontalResolution() **
  
-This method returns the horizontal resolution of the image.+  * //This method returns the horizontal resolution of the image.//
 == Remarks == == Remarks ==
-This method returns the horizontal resolution of the image. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method returns the horizontal resolution of the image. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 83: Line 90:
 ** {{wiki:​PublicMethod.gif|}} GetVerticalResolution() ** ** {{wiki:​PublicMethod.gif|}} GetVerticalResolution() **
  
-This method returns the vertical resolution of the image.+  * //This method returns the vertical resolution of the image.//
 == Remarks == == Remarks ==
-This method returns the vertical resolution of the image. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method returns the vertical resolution of the image. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 95: Line 102:
 ** {{wiki:​PublicMethod.gif|}} GetBoundingBox() ** ** {{wiki:​PublicMethod.gif|}} GetBoundingBox() **
  
-This method returns the bounding box of the RasterSource.+  * //This method returns the bounding box of the RasterSource.//
 == Remarks == == Remarks ==
-This method returns the bounding box of the RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method returns the bounding box of the RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 107: Line 114:
 ** {{wiki:​PublicMethod.gif|}} GetProjectionText() ** ** {{wiki:​PublicMethod.gif|}} GetProjectionText() **
  
-This method returns the projection text in proj4 format.+  * //This method returns the projection text in proj4 format.//
 == Remarks == == Remarks ==
-None+  * //None//
  
 == Return Value == == Return Value ==
Line 119: Line 126:
 ** {{wiki:​PublicMethod.gif|}} Open() ** ** {{wiki:​PublicMethod.gif|}} Open() **
  
-This method opens the RasterSource so that it is initialized and ready to use.+  * //This method opens the RasterSource so that it is initialized and ready to use.//
 == Remarks == == Remarks ==
-This method is the concrete wrapper for the abstract method OpenCore. The Open method plays an important role, as it is responsible for initializing the RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource 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 RasterSource. When implementing the 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 RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method is the concrete wrapper for the abstract method OpenCore. The Open method plays an important role, as it is responsible for initializing the RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource 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 RasterSource. When implementing the 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 RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 131: Line 138:
 ** {{wiki:​PublicMethod.gif|}} Close() ** ** {{wiki:​PublicMethod.gif|}} Close() **
  
-This method closes the RasterSource and releases any resources it was using.+  * //This method closes the RasterSource and releases any resources it was using.//
 == Remarks == == Remarks ==
-This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RasterSource. 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 the Core version of 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 RasterSource 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. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method is the concrete wrapper for the abstract method CloseCore. The Close method plays an important role in the life cycle of the RasterSource. 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 the Core version of 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 RasterSource 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. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 143: Line 150:
 ** {{wiki:​PublicMethod.gif|}} GetImage(RectangleShape,​Int32,​Int32) ** ** {{wiki:​PublicMethod.gif|}} GetImage(RectangleShape,​Int32,​Int32) **
  
-This method returns an image based on the worldExtent and image width and height.+  * //This method returns an image based on the worldExtent and image width and height.//
 == Remarks == == Remarks ==
-This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating your own RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.+  * //This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating your own RasterSource. As this is a concrete public method that wraps a Core method, we reserve the right to add events and other logic to pre- or post-process data returned by the Core version of the method. In this way, we leave our framework open on our end, but also allow you the developer to extend our logic to suit your needs. If you have questions about this, please contact our support team as we would be happy to work with you on extending our framework.//
  
 == Return Value == == Return Value ==
Line 167: Line 174:
 ** {{wiki:​PublicMethod.gif|}} ToString() ** ** {{wiki:​PublicMethod.gif|}} ToString() **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
Line 179: Line 186:
 ** {{wiki:​PublicMethod.gif|}} Equals(Object) ** ** {{wiki:​PublicMethod.gif|}} Equals(Object) **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
Line 195: Line 202:
 ** {{wiki:​PublicMethod.gif|}} GetHashCode() ** ** {{wiki:​PublicMethod.gif|}} GetHashCode() **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
Line 207: Line 214:
 ** {{wiki:​PublicMethod.gif|}} GetType() ** ** {{wiki:​PublicMethod.gif|}} GetType() **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
Line 219: Line 226:
 ** {{wiki:​PublicMethod.gif|}}{{wiki:​Static.gif|}} GenerateWorldFileText(RectangleShape,​Int32,​Int32) ** ** {{wiki:​PublicMethod.gif|}}{{wiki:​Static.gif|}} GenerateWorldFileText(RectangleShape,​Int32,​Int32) **
  
-This method returns a string that represents the image'​s world file based on the parameters passed in.+  * //This method returns a string that represents the image'​s world file based on the parameters passed in.//
 == Remarks == == Remarks ==
-This method returns a string that represents the image'​s world file. The world file is a file type that can accompany image files. It contains information about the image'​s position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally.+  * //This method returns a string that represents the image'​s world file. The world file is a file type that can accompany image files. It contains information about the image'​s position, resolution and other spatial-related items. It is common to have this kind of file associated with generic image types such as JPG, BMP, and normal TIFF because they do not have a mechanism to store this data internally. Modern GIS image types such as JPEG2000, ECW, and MrSid typically have this information stored internally. We provide this method in the event that you want to create your own world file from any image that either already has one or has its data stored internally.//
  
 == Return Value == == Return Value ==
Line 244: Line 251:
 ** {{wiki:​ProtectedMethod.gif|}} OnOpeningRasterSource(OpeningRasterSourceEventArgs) ** ** {{wiki:​ProtectedMethod.gif|}} OnOpeningRasterSource(OpeningRasterSourceEventArgs) **
  
-This method allows you to raise the OpeningRasterSource event from a derived class.+  * //This method allows you to raise the OpeningRasterSource event from a derived class.//
 == Remarks == == Remarks ==
-You can call this method from a derived class to enable it to raise the OpeningRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called before the opening of the RasterSource. Technically,​ this event is called after the calling of the Open method on the RasterSource,​ but before the protected OpenCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.+  * //You can call this method from a derived class to enable it to raise the OpeningRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called before the opening of the RasterSource. Technically,​ this event is called after the calling of the Open method on the RasterSource,​ but before the protected OpenCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.//
  
 == Return Value == == Return Value ==
Line 260: Line 267:
 ** {{wiki:​ProtectedMethod.gif|}} OnOpenedRasterSource(OpenedRasterSourceEventArgs) ** ** {{wiki:​ProtectedMethod.gif|}} OnOpenedRasterSource(OpenedRasterSourceEventArgs) **
  
-This method allows you to raise the OpenedRasterSource event from a derived class.+  * //This method allows you to raise the OpenedRasterSource event from a derived class.//
 == Remarks == == Remarks ==
-You can call this method from a derived class to enable it to raise the OpenedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called after the opening of the RasterSource. Technically,​ this event is called after the calling of the Open method on the RasterSource and after the protected OpenCore method is called. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.+  * //You can call this method from a derived class to enable it to raise the OpenedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called after the opening of the RasterSource. Technically,​ this event is called after the calling of the Open method on the RasterSource and after the protected OpenCore method is called. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.//
  
 == Return Value == == Return Value ==
Line 276: Line 283:
 ** {{wiki:​ProtectedMethod.gif|}} OnClosingRasterSource(ClosingRasterSourceEventArgs) ** ** {{wiki:​ProtectedMethod.gif|}} OnClosingRasterSource(ClosingRasterSourceEventArgs) **
  
-This method allows you to raise the ClosingRasterSource event from a derived class.+  * //This method allows you to raise the ClosingRasterSource event from a derived class.//
 == Remarks == == Remarks ==
-You can call this method from a derived class to enable it to raise the ClosingRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called before the closing of the RasterSource. Technically,​ this event is called after the calling of the Close method on the RasterSource,​ but before the protected CloseCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.+  * //You can call this method from a derived class to enable it to raise the ClosingRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called before the closing of the RasterSource. Technically,​ this event is called after the calling of the Close method on the RasterSource,​ but before the protected CloseCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.//
  
 == Return Value == == Return Value ==
Line 292: Line 299:
 ** {{wiki:​ProtectedMethod.gif|}} OnClosedRasterSource(ClosedRasterSourceEventArgs) ** ** {{wiki:​ProtectedMethod.gif|}} OnClosedRasterSource(ClosedRasterSourceEventArgs) **
  
-This method allows you to raise the ClosedRasterSource event from a derived class.+  * //This method allows you to raise the ClosedRasterSource event from a derived class.//
 == Remarks == == Remarks ==
-You can call this method from a derived class to enable it to raise the ClosedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called after the closing of the RasterSource. Technically,​ this event is called after the calling of the Close method on the RasterSource and after the protected CloseCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.+  * //You can call this method from a derived class to enable it to raise the ClosedRasterSource event. This may be useful if you plan to extend the RasterSource and you need access to the event. Details on the event: This event is called after the closing of the RasterSource. Technically,​ this event is called after the calling of the Close method on the RasterSource and after the protected CloseCore method. It is typical that the RasterSource may be opened and closed may times during the life cycle of your application. The type of control the MapEngine is embedded in will dictate how often this happens. For example, in the case of the Web Edition, each time a RasterSource is in the Ajax or Post Back part of the page cycle, it will close the RasterSource before returning back to the client. This is to conserve resources, as the web is a connection-less environment. In the case of the Desktop Edition, we can keep the RasterSource open, knowing that we can maintain a persistent connection.//
  
 == Return Value == == Return Value ==
Line 308: Line 315:
 ** {{wiki:​ProtectedMethod.gif|}} CloneDeepCore() ** ** {{wiki:​ProtectedMethod.gif|}} CloneDeepCore() **
  
-Create a copy of RasterSource using the deep clone process. The default implementation uses serialization.+  * //Create a copy of RasterSource using the deep clone process. The default implementation uses serialization.//
 == Remarks == == Remarks ==
-The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.+  * //The difference between deep clone and shallow clone is: when shallow cloned, only the object is copied, but the contained objects are not; while in deep clone it does copy the cloned object as well as all the objects within.//
  
 == Return Value == == Return Value ==
Line 320: Line 327:
 ** {{wiki:​ProtectedMethod.gif|}} GetImageWidthCore() ** ** {{wiki:​ProtectedMethod.gif|}} GetImageWidthCore() **
  
-This method returns the width of the image in screen coordinates.+  * //This method returns the width of the image in screen coordinates.//
 == Remarks == == Remarks ==
-This abstract method is called from the concrete method GetImageWidth. You need to override it if you inherit from the RasterSource to return the width of your image. It returns the width of the image in screen coordinates.+  * //This abstract method is called from the concrete method GetImageWidth. You need to override it if you inherit from the RasterSource to return the width of your image. It returns the width of the image in screen coordinates.//
  
 == Return Value == == Return Value ==
Line 332: Line 339:
 ** {{wiki:​ProtectedMethod.gif|}} GetImageHeightCore() ** ** {{wiki:​ProtectedMethod.gif|}} GetImageHeightCore() **
  
-This method returns the height of the image in screen coordinates.+  * //This method returns the height of the image in screen coordinates.//
 == Remarks == == Remarks ==
-This abstract method is called from the concrete method GetImageHeight. You need to override it if you inherit from the RasterSource to return the height of your image. It returns the height of the image in screen coordinates.+  * //This abstract method is called from the concrete method GetImageHeight. You need to override it if you inherit from the RasterSource to return the height of your image. It returns the height of the image in screen coordinates.//
  
 == Return Value == == Return Value ==
Line 344: Line 351:
 ** {{wiki:​ProtectedMethod.gif|}} GetBoundingBoxCore() ** ** {{wiki:​ProtectedMethod.gif|}} GetBoundingBoxCore() **
  
-This method returns the bounding box of the RasterSource.+  * //This method returns the bounding box of the RasterSource.//
 == Remarks == == Remarks ==
-This method returns the bounding box of the RasterSource.+  * //This method returns the bounding box of the RasterSource.//
  
 == Return Value == == Return Value ==
Line 356: Line 363:
 ** {{wiki:​ProtectedMethod.gif|}} GetProjectionTextCore() ** ** {{wiki:​ProtectedMethod.gif|}} GetProjectionTextCore() **
  
-This method returns the projection text in proj4 format.+  * //This method returns the projection text in proj4 format.//
 == Remarks == == Remarks ==
-This protected virtual method is called from the concrete public method GetProjectionText.The default implementation of this core method is to throw an exception. So you need to overwrite this method to return the RasterSource projection text.+  * //This protected virtual method is called from the concrete public method GetProjectionText.The default implementation of this core method is to throw an exception. So you need to overwrite this method to return the RasterSource projection text.//
  
 == Return Value == == Return Value ==
Line 368: Line 375:
 ** {{wiki:​ProtectedMethod.gif|}} OpenCore() ** ** {{wiki:​ProtectedMethod.gif|}} OpenCore() **
  
-This method opens the RasterSource so that it is initialized and ready to use.+  * //This method opens the RasterSource so that it is initialized and ready to use.//
 == Remarks == == 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 RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource 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 RasterSource. 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 RasterSource.+  * //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 RasterSource. Most methods on the RasterSource will throw an exception if the state of the RasterSource is not opened. When the map draws each layer, it will open the RasterSource 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 RasterSource. 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 RasterSource.//
  
 == Return Value == == Return Value ==
Line 380: Line 387:
 ** {{wiki:​ProtectedMethod.gif|}} CloseCore() ** ** {{wiki:​ProtectedMethod.gif|}} CloseCore() **
  
-This method opens the RasterSource so that it is initialized and ready to use.+  * //This method opens the RasterSource so that it is initialized and ready to use.//
 == Remarks == == 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 RasterSource. 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 RasterSource 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.+  * //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 RasterSource. 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 RasterSource 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 == == Return Value ==
Line 389: Line 396:
  
 == Parameters == == Parameters ==
 +<div newline></​div>​
 +** {{wiki:​ProtectedMethod.gif|}} GetWrappingImageLeft(RectangleShape,​Double,​Double,​RectangleShape) **
 +
 +  * //N/A//
 +== Remarks ==
 +  * //N/A//
 +
 +== Return Value ==
 +  * Type:​[[ThinkGeo.MapSuite.Core.GeoImage|GeoImage]]
 +  * Description:​N/​A
 +
 +== Parameters ==
 +  * //​boundingBox//​
 +    * Type:​[[ThinkGeo.MapSuite.Core.RectangleShape|RectangleShape]]
 +    * Description:​N/​A
 +
 +  * //​screenWidth//​
 +    * Type:Double
 +    * Description:​N/​A
 +
 +  * //​screenHeight//​
 +    * Type:Double
 +    * Description:​N/​A
 +
 +  * //​wrappingExtent//​
 +    * Type:​[[ThinkGeo.MapSuite.Core.RectangleShape|RectangleShape]]
 +    * Description:​N/​A
 +
 +<div newline></​div>​
 +** {{wiki:​ProtectedMethod.gif|}} GetWrappingImageRight(RectangleShape,​Double,​Double,​RectangleShape) **
 +
 +  * //N/A//
 +== Remarks ==
 +  * //N/A//
 +
 +== Return Value ==
 +  * Type:​[[ThinkGeo.MapSuite.Core.GeoImage|GeoImage]]
 +  * Description:​N/​A
 +
 +== Parameters ==
 +  * //​boundingBox//​
 +    * Type:​[[ThinkGeo.MapSuite.Core.RectangleShape|RectangleShape]]
 +    * Description:​N/​A
 +
 +  * //​screenWidth//​
 +    * Type:Double
 +    * Description:​N/​A
 +
 +  * //​screenHeight//​
 +    * Type:Double
 +    * Description:​N/​A
 +
 +  * //​wrappingExtent//​
 +    * Type:​[[ThinkGeo.MapSuite.Core.RectangleShape|RectangleShape]]
 +    * Description:​N/​A
 +
 <div newline></​div>​ <div newline></​div>​
 ** {{wiki:​ProtectedMethod.gif|}} GetImageCore(RectangleShape,​Int32,​Int32) ** ** {{wiki:​ProtectedMethod.gif|}} GetImageCore(RectangleShape,​Int32,​Int32) **
  
-This method returns an image based on the worldExtent and image width and height.+  * //This method returns an image based on the worldExtent and image width and height.//
 == Remarks == == Remarks ==
-This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating our own RasterSource.+  * //This method is responsible for returning the image based on the parameters passed in. As the core version of this method is abstract, you will need to override it when creating our own RasterSource.//
  
 == Return Value == == Return Value ==
Line 416: Line 479:
 ** {{wiki:​ProtectedMethod.gif|}} Finalize() ** ** {{wiki:​ProtectedMethod.gif|}} Finalize() **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
Line 428: Line 491:
 ** {{wiki:​ProtectedMethod.gif|}} MemberwiseClone() ** ** {{wiki:​ProtectedMethod.gif|}} MemberwiseClone() **
  
-N/A+  * //N/A//
 == Remarks == == Remarks ==
-N/A+  * //N/A//
  
 == Return Value == == Return Value ==
thinkgeo.mapsuite.core.rastersource.1442797753.txt.gz · Last modified: 2015/09/21 01:09 by admin