Class JRaster


  • public class JRaster
    extends java.lang.Object
    JRaster is a Java class that deals with raster data stored on the server side. It provides the capability to retrieve and manipulate the raster block data and mask data of a GeoRaster object based on a specified rowNumber, columnNumber, bandNumber, and pyramidLevel.

    A JRaster object is always associated with a JGeoRaster object, and cannot be constructed directly. When a JGeoRaster is initiated successfully, a JRaster object is created automatically, and the following method defined for JGeoRaster can be used to retrieve an instance of JRaster:

         public JRaster getRasterObject()
     

    The JRaster class provides two categories of methods. The first category is for raster data accessing based on different query conditions, for example:

         public BLOB getRasterSubsetBlob(...)
         public byte[] getRasterSubset(...)
         public BLOB getBitmapMaskSubsetBlob(...)
         public byte[] getBitmapMaskSubset(...)
         public double getCellValue(...)
         public byte getBitmapMaskValue(...)
         ...
    

    The second category is for raster data updating based on the raster block, for example:

         public void initRDT()
         public void dropAllRasterBlocks()
         public Blob initRasterBlock((...)
         public byte[] getRasterBlock(...)
         public void generateBlockMBR()
          public void storeRasterBlock(...)
         ...
     

    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      protected JRaster​(JGeoRaster georaster)
      Constructs a JRaster object with the given JGeoRaster object.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void appendRasterBlock​(byte[] data, java.sql.Blob rasterBlock)
      Stores data from byte array into a BLOB.
      void changeCellValue​(long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, double newCellValue, double[] bgValues)
      Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
      void changeCellValue​(long row, long column, java.lang.String bandNumbers, double newCellValue, double[] bgValues)
      Changes the value of raster cell in a specified point of a GeoRaster object to a single new value.
      void changeCellValue​(JGeometry window, java.lang.String layerNumbers, double newCellValue, double[] bgValues)
      Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
      void dropAllRasterBlocks()
      Drops all raster blocks of the associated GeoRaster object from raster data table in the Oracle database.
      void generateBlockMBR()
      Computes the minimum bounding rectangle (MBR) for each block in a GeoRaster object, and sets the blockMBR attribute for each raster block in the raster data table.
      byte[] getBitmapMaskSubset​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, int layerNo, java.lang.String cellDepth, java.lang.String compression, long[] outWindow)
      Returns binary mask data as a byte array for a specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      byte[] getBitmapMaskSubset​(int pyramidLevel, JGeometry window, int layerNo, java.lang.String cellDepth, java.lang.String compression, int quality, long[] outWindow)
      Returns binary mask data as a byte array for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      oracle.sql.BLOB getBitmapMaskSubsetBlob​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, int layerNo, java.lang.String cellDepth, java.lang.String compression, long[] outWindow)
      Deprecated.
      java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, int layerNo, long[] outWindow, java.lang.String storageParam)
      Returns binary mask data as a BLOB for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, int layerNo, java.lang.String cellDepth, java.lang.String compression, long[] outWindow)
      Returns binary mask data as a BLOB for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel, JGeometry window, int layerNo, long[] outWindow, java.lang.String storageParam)
      Returns binary mask data as a BLOB for the specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel, JGeometry window, int layerNo, java.lang.String cellDepth, java.lang.String compression, long[] outWindow)
      Returns binary mask data as a BLOB for the specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
      byte getBitmapMaskValue​(int layerNumber, int pyramidLevel, int rowNumber, int colNumber)
      Gets the value of a single cell from a bitmap mask.
      byte getBitmapMaskValue​(int layerNumber, int pyramidLevel, JGeometry ptGeom)
      Gets the value of a single cell from a bitmap mask.
      double getCellValue​(int pyramidLevel, int rowNumber, int colNumber, int bandNumber)
      Returns the value of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band number in its cell coordinate system and its band number.
      double getCellValue​(JGeometry ptGeom, int pyramidLevel, int layerNumber)
      Returns the value of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer number.
      java.math.BigDecimal[] getCellValues​(int pyramidLevel, int rowNumber, int colNumber, java.lang.String bandNumbers)
      Returns an array of values of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band number in its cell coordinate system and its band numbers.
      java.math.BigDecimal[] getCellValues​(JGeometry ptGeom, int pyramidLevel, java.lang.String layerNumbers)
      Returns an array of values of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer numbers.
      java.lang.Exception getLastException()
      When a method of this class returns null, this method will return an Exception that explains why null was returned.
      JGeometry getOutArea()
      Get a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object of previous getReprojectedRasterSubset or getReprojectedRasterSubsetBlob call.
      byte[] getRasterBlock​(int pyramidLevel, long bandBlockNumber, long rowBlockNumber, long columnBlockNumber, boolean isBitmapMask, boolean lock_for_write)
      Gets the byte array of a specified raster block.
      java.sql.Blob getRasterBlockLocatorJS​(int pyramidLevel, long bandBlockNumber, long rowBlockNumber, long columnBlockNumber, boolean isBitmapMask, boolean lock_for_write)
      Gets the LOB locator of a specified raster block.
      oracle.sql.BLOB getRasterData​(int pyramidLevel, java.lang.String storageParam, double[] bgValues)
      Deprecated.
      java.sql.Blob getRasterDataJS​(int pyramidLevel, java.lang.String storageParam, double[] bgValues)
      Returns a single Blob object that contains all raster data of the associated GeoRaster object at the specified pyramid level.
      byte[] getRasterSubset​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, int numBands, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, long[] outWindow, double[] bgValues)
      Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
      byte[] getRasterSubset​(int pyramidLevel, JGeometry window, java.lang.String bandNumbers, int numBands, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, long[] outWindow, double[] bgValues)
      Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
      java.sql.Blob getRasterSubset​(int pyramidLevel, JGeometry window, java.lang.String layerNumbers, long[] outWindow, java.lang.String storageParam, double[] bgValues, java.lang.String polygonClip)
      Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
      java.sql.Blob getRasterSubset​(int pyramidLevel, JGeometry window, java.lang.String layerNumbers, java.lang.String storageParam, double[] bgValues, java.lang.String polygonClip)
      Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
      oracle.sql.BLOB getRasterSubsetBlob​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, long[] outWindow, double[] bgValues)
      Deprecated.
      java.sql.Blob getRasterSubsetBlobJS​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, long[] outWindow, double[] bgValues)
      Returns binary raster data as a BLOB for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
      java.sql.Blob getRasterSubsetBlobJS​(int pyramidLevel, JGeometry window, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, long[] outWindow, double[] bgValues)
      Returns binary raster data as a BLOB for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
      java.math.BigDecimal[] getRasterSubsetDataArray​(int pyramidLevel, long[] inWindow, java.lang.String bandNumbers, java.math.BigDecimal[] outWindow, java.lang.String storageParam, double[] bgValues)
      Returns raster data as a BigDecimal array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
      java.math.BigDecimal[] getRasterSubsetDataArray​(int pyramidLevel, JGeometry inWindow, java.lang.String layerNumbers, java.math.BigDecimal[] outWindow, java.lang.String storageParam, double[] bgValues, boolean polygonClip)
      Returns raster data as a BigDecimal array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
      byte[] getReprojectedRasterSubset​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String resampleParam, java.lang.String bandNumbers, int numBands, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Reproject subset of a GeoRaster object, and returns binary raster data as a byte array, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
      byte[] getReprojectedRasterSubset​(int pyramidLevel, JGeometry window, java.lang.String resampleParam, java.lang.String bandNumbers, int numBands, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Reproject subset of a GeoRaster object, and returns binary raster data as a byte array, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
      oracle.sql.BLOB getReprojectedRasterSubsetBlob​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String resampleParam, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Deprecated.
      oracle.sql.BLOB getReprojectedRasterSubsetBlob​(int pyramidLevel, JGeometry window, java.lang.String resampleParam, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Deprecated.
      java.sql.Blob getReprojectedRasterSubsetBlobJS​(int pyramidLevel, long startRow, long startColumn, long endRow, long endColumn, java.lang.String resampleParam, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
      java.sql.Blob getReprojectedRasterSubsetBlobJS​(int pyramidLevel, JGeometry window, java.lang.String resampleParam, java.lang.String bandNumbers, java.lang.String cellDepth, java.lang.String compression, java.lang.String interleaving, int quality, int outSRID, long[] outWindow, double[] bgValues)
      Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
      oracle.sql.BLOB initRasterBlock​(int pLevel, int bandBlockNumber, int rowBlockNumber, int columnBlockNumber, JGeometry mbr)
      Inserts a new row into raster data table with specified pLevel,bandBlockNumber, rowBlockNumber, columnBlockNumber, and mbr.
      java.sql.Blob initRasterBlockJS​(int pLevel, int bandBlockNumber, int rowBlockNumber, int columnBlockNumber, JGeometry mbr)
      Inserts a new row into raster data table with specified pLevel,bandBlockNumber, rowBlockNumber, columnBlockNumber, and mbr.
      void initRDT()
      Initializes all rows in the RDT table, based on information like dimensionSize, blockSize, pyramidLevel, and so on, stored in the metadata.
      void setBitmapMask​(int layerNumber, JGeoRaster mask, java.lang.String NODATAMask)
      Attaches a bitmap mask to a GeoRaster object, or replaces or removes the current bitmap mask.
      void storeRasterBlock​(byte[] data, java.sql.Blob rasterBlock)
      Stores data from byte array into a BLOB.
      void storeRasterBlock​(javax.imageio.stream.ImageInputStream data, java.sql.Blob rasterBlock)
      Stores data from an ImageInputStream into blob.
      boolean validateBlockMBR()
      Checks the blockMBR attribute in each row of the raster data table associated with the specified GeoRaster object to see if its geometry is the actual minimum bounding rectangle (MBR) of that block.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • m_pyramidLevel

        protected int m_pyramidLevel
      • m_startRow

        protected long m_startRow
      • m_startColumn

        protected long m_startColumn
      • m_endRow

        protected long m_endRow
      • m_endColumn

        protected long m_endColumn
    • Constructor Detail

      • JRaster

        protected JRaster​(JGeoRaster georaster)
        Constructs a JRaster object with the given JGeoRaster object.
        Parameters:
        georaster - associated georaster object
    • Method Detail

      • getOutArea

        public JGeometry getOutArea()
        Get a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object of previous getReprojectedRasterSubset or getReprojectedRasterSubsetBlob call.
        Returns:
        a SDO_GEOMETRY object containing the MBR of the resulting object of previous getReprojectedRasterSubset or getReprojectedRasterSubsetBlob call.
      • getLastException

        public java.lang.Exception getLastException()
        When a method of this class returns null, this method will return an Exception that explains why null was returned.
        Returns:
        An Exception object that describes why null was returned.
      • getReprojectedRasterSubset

        public byte[] getReprojectedRasterSubset​(int pyramidLevel,
                                                 JGeometry window,
                                                 java.lang.String resampleParam,
                                                 java.lang.String bandNumbers,
                                                 int numBands,
                                                 java.lang.String cellDepth,
                                                 java.lang.String compression,
                                                 java.lang.String interleaving,
                                                 int quality,
                                                 int outSRID,
                                                 long[] outWindow,
                                                 double[] bgValues)
        Reproject subset of a GeoRaster object, and returns binary raster data as a byte array, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        numBands - number of bands specified by bandNumbers.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getReprojectedRasterSubset

        public byte[] getReprojectedRasterSubset​(int pyramidLevel,
                                                 long startRow,
                                                 long startColumn,
                                                 long endRow,
                                                 long endColumn,
                                                 java.lang.String resampleParam,
                                                 java.lang.String bandNumbers,
                                                 int numBands,
                                                 java.lang.String cellDepth,
                                                 java.lang.String compression,
                                                 java.lang.String interleaving,
                                                 int quality,
                                                 int outSRID,
                                                 long[] outWindow,
                                                 double[] bgValues)
        Reproject subset of a GeoRaster object, and returns binary raster data as a byte array, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        numBands - number of bands specified by bandNumbers.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getReprojectedRasterSubsetBlob

        @Deprecated
        public oracle.sql.BLOB getReprojectedRasterSubsetBlob​(int pyramidLevel,
                                                              JGeometry window,
                                                              java.lang.String resampleParam,
                                                              java.lang.String bandNumbers,
                                                              java.lang.String cellDepth,
                                                              java.lang.String compression,
                                                              java.lang.String interleaving,
                                                              int quality,
                                                              int outSRID,
                                                              long[] outWindow,
                                                              double[] bgValues)
        Deprecated.
        Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getReprojectedRasterSubsetBlobJS

        public java.sql.Blob getReprojectedRasterSubsetBlobJS​(int pyramidLevel,
                                                              JGeometry window,
                                                              java.lang.String resampleParam,
                                                              java.lang.String bandNumbers,
                                                              java.lang.String cellDepth,
                                                              java.lang.String compression,
                                                              java.lang.String interleaving,
                                                              int quality,
                                                              int outSRID,
                                                              long[] outWindow,
                                                              double[] bgValues)
        Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getReprojectedRasterSubsetBlob

        @Deprecated
        public oracle.sql.BLOB getReprojectedRasterSubsetBlob​(int pyramidLevel,
                                                              long startRow,
                                                              long startColumn,
                                                              long endRow,
                                                              long endColumn,
                                                              java.lang.String resampleParam,
                                                              java.lang.String bandNumbers,
                                                              java.lang.String cellDepth,
                                                              java.lang.String compression,
                                                              java.lang.String interleaving,
                                                              int quality,
                                                              int outSRID,
                                                              long[] outWindow,
                                                              double[] bgValues)
        Deprecated.
        Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getReprojectedRasterSubsetBlobJS

        public java.sql.Blob getReprojectedRasterSubsetBlobJS​(int pyramidLevel,
                                                              long startRow,
                                                              long startColumn,
                                                              long endRow,
                                                              long endColumn,
                                                              java.lang.String resampleParam,
                                                              java.lang.String bandNumbers,
                                                              java.lang.String cellDepth,
                                                              java.lang.String compression,
                                                              java.lang.String interleaving,
                                                              int quality,
                                                              int outSRID,
                                                              long[] outWindow,
                                                              double[] bgValues)
        Reproject subset of a GeoRaster object, and returns binary raster data as a Blob, based on parameters which specify a window, layers, and customized cell depth.The immediately following getOutArea() call will return a SDO_GEOMETRY object containing the MBR (minimum bounding rectangle) in the model coordinate system of the resulting object.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        resampleParam - a string containing the resampling parameters.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outSRID - target srid number
        outWindow - an SDO_NUMBER_ARRAY object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getRasterSubsetBlob

        @Deprecated
        public oracle.sql.BLOB getRasterSubsetBlob​(int pyramidLevel,
                                                   long startRow,
                                                   long startColumn,
                                                   long endRow,
                                                   long endColumn,
                                                   java.lang.String bandNumbers,
                                                   java.lang.String cellDepth,
                                                   java.lang.String compression,
                                                   java.lang.String interleaving,
                                                   int quality,
                                                   long[] outWindow,
                                                   double[] bgValues)
        Deprecated.
        Returns binary raster data as a BLOB for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data.
        See Also:
        RasterInfo
      • getRasterSubsetBlobJS

        public java.sql.Blob getRasterSubsetBlobJS​(int pyramidLevel,
                                                   long startRow,
                                                   long startColumn,
                                                   long endRow,
                                                   long endColumn,
                                                   java.lang.String bandNumbers,
                                                   java.lang.String cellDepth,
                                                   java.lang.String compression,
                                                   java.lang.String interleaving,
                                                   int quality,
                                                   long[] outWindow,
                                                   double[] bgValues)
        Returns binary raster data as a BLOB for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data.
        See Also:
        RasterInfo
      • getRasterSubsetBlobJS

        public java.sql.Blob getRasterSubsetBlobJS​(int pyramidLevel,
                                                   JGeometry window,
                                                   java.lang.String bandNumbers,
                                                   java.lang.String cellDepth,
                                                   java.lang.String compression,
                                                   java.lang.String interleaving,
                                                   int quality,
                                                   long[] outWindow,
                                                   double[] bgValues)
        Returns binary raster data as a BLOB for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level.
        window - a JGeometry object which represents the area of interest.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data.
      • getRasterSubset

        public java.sql.Blob getRasterSubset​(int pyramidLevel,
                                             JGeometry window,
                                             java.lang.String layerNumbers,
                                             java.lang.String storageParam,
                                             double[] bgValues,
                                             java.lang.String polygonClip)
        Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        layerNumbers - A string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4). If you specify a null value for this parameter, the operation or operations are performed on all layers.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Section 1.4.1. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB.
        polygonClip - The string TRUE causes the window or inWindow geometry object to be used for the subset operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the window or inWindow geometry object to be used for the subset operation.
        Returns:
        a single Blob object containing all cells of a specified pyramid level that are inside or on the boundary of polygon geometry object.
      • getRasterSubset

        public java.sql.Blob getRasterSubset​(int pyramidLevel,
                                             JGeometry window,
                                             java.lang.String layerNumbers,
                                             long[] outWindow,
                                             java.lang.String storageParam,
                                             double[] bgValues,
                                             java.lang.String polygonClip)
        Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        layerNumbers - A string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4). If you specify a null value for this parameter, the operation or operations are performed on all layers.
        outWindow - An array object identifying the coordinates of the upper-left and lower-right corners of the output window in the cell space.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Section 1.4.1. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB.
        polygonClip - The string TRUE causes the window or inWindow geometry object to be used for the subset operation; the string FALSE or a null value causes the MBR (minimum bounding rectangle) of the window or inWindow geometry object to be used for the subset operation.
        Returns:
        a single Blob object containing all cells of a specified pyramid level that are inside or on the boundary of polygon geometry object.
      • getRasterSubset

        public byte[] getRasterSubset​(int pyramidLevel,
                                      JGeometry window,
                                      java.lang.String bandNumbers,
                                      int numBands,
                                      java.lang.String cellDepth,
                                      java.lang.String compression,
                                      java.lang.String interleaving,
                                      int quality,
                                      long[] outWindow,
                                      double[] bgValues)
        Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters which specify a window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        numBands - number of bands specified by bandNumbers.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getRasterSubset

        public byte[] getRasterSubset​(int pyramidLevel,
                                      long startRow,
                                      long startColumn,
                                      long endRow,
                                      long endColumn,
                                      java.lang.String bandNumbers,
                                      int numBands,
                                      java.lang.String cellDepth,
                                      java.lang.String compression,
                                      java.lang.String interleaving,
                                      int quality,
                                      long[] outWindow,
                                      double[] bgValues)
        Returns binary raster data as a byte array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        numBands - number of bands specified by bandNumbers.
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_JPEG_F
                                   RasterInfo.COMPRESSION_DEFLATE 
        interleaving - interleaving type of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_INTERLEVING_BSQ
                                   RasterInfo.CELL_INTERLEVING_BIL
                                   RasterInfo.CELL_INTERLEVING_BIP
        quality - JPEG compression quality, which is the degree of lossiness caused by the compression. Must be an integer from 0 (lowest quality) through 100 (highest quality).
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        binary raster data stored in a byte array.
      • getRasterSubsetDataArray

        public java.math.BigDecimal[] getRasterSubsetDataArray​(int pyramidLevel,
                                                               long[] inWindow,
                                                               java.lang.String bandNumbers,
                                                               java.math.BigDecimal[] outWindow,
                                                               java.lang.String storageParam,
                                                               double[] bgValues)
                                                        throws java.lang.Exception
        Returns raster data as a BigDecimal array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        inWindow - A rectangular window from which to crop the cells. The parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed.
        bandNumbers - a string identifying the physical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3). If you specify a null value for this parameter, the operation or operations are performed on all bands.
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Storage Parameters. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        Returns:
        raster data stored in a BigDecimal array.
        Throws:
        java.lang.Exception
      • getRasterSubsetDataArray

        public java.math.BigDecimal[] getRasterSubsetDataArray​(int pyramidLevel,
                                                               JGeometry inWindow,
                                                               java.lang.String layerNumbers,
                                                               java.math.BigDecimal[] outWindow,
                                                               java.lang.String storageParam,
                                                               double[] bgValues,
                                                               boolean polygonClip)
                                                        throws java.lang.Exception
        Returns raster data as a BigDecimal array for the associated GeoRaster object, based on parameters that specify the window, layers, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        inWindow - A rectangular window from which to crop the cells. The parameter identifies the upper-left (row, column) and lower-right (row, column) coordinates of a rectangular window, and raster space is assumed.
        layerNumbers - A string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4). If you specify a null value for this parameter, the operation or operations are performed on all layers.
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Storage Parameters. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). This parameter is useful when the source has empty raster blocks and the output window intersects any empty raster blocks. If this parameter is null, any cells in the output window that are derived from an empty raster block are filled with the value 0 in the output BLOB. Note that this parameter only works in version 11 or later.
        polygonClip - TRUE causes the window or inWindow geometry object to be used for the subset operation; FALSE or a null value causes the MBR (minimum bounding rectangle) of the window or inWindow geometry object to be used for the subset operation.
        Returns:
        raster data stored in a BigDecimal array.
        Throws:
        java.lang.Exception
      • getBitmapMaskSubsetBlobJS

        public java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel,
                                                       JGeometry window,
                                                       int layerNo,
                                                       java.lang.String cellDepth,
                                                       java.lang.String compression,
                                                       long[] outWindow)
        Returns binary mask data as a BLOB for the specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        layerNo - the logical layer whose bitmap mask will be returned as a byte array
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_DEFLATE 
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        Returns:
        binary mask data.
      • getBitmapMaskSubsetBlobJS

        public java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel,
                                                       JGeometry window,
                                                       int layerNo,
                                                       long[] outWindow,
                                                       java.lang.String storageParam)
        Returns binary mask data as a BLOB for the specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        layerNo - the logical layer whose bitmap mask will be returned as a byte array
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Storage Parameters.
        Returns:
        binary mask data.
      • getBitmapMaskSubsetBlob

        @Deprecated
        public oracle.sql.BLOB getBitmapMaskSubsetBlob​(int pyramidLevel,
                                                       long startRow,
                                                       long startColumn,
                                                       long endRow,
                                                       long endColumn,
                                                       int layerNo,
                                                       java.lang.String cellDepth,
                                                       java.lang.String compression,
                                                       long[] outWindow)
        Deprecated.
        Returns binary mask data as a BLOB for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        layerNo - logical layer whose bitmap mask will be returned as a byte array
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_DEFLATE 
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        Returns:
        binary mask data.
      • getBitmapMaskSubsetBlobJS

        public java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel,
                                                       long startRow,
                                                       long startColumn,
                                                       long endRow,
                                                       long endColumn,
                                                       int layerNo,
                                                       java.lang.String cellDepth,
                                                       java.lang.String compression,
                                                       long[] outWindow)
        Returns binary mask data as a BLOB for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        layerNo - logical layer whose bitmap mask will be returned as a byte array
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_DEFLATE 
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        Returns:
        binary mask data.
      • getBitmapMaskSubsetBlobJS

        public java.sql.Blob getBitmapMaskSubsetBlobJS​(int pyramidLevel,
                                                       long startRow,
                                                       long startColumn,
                                                       long endRow,
                                                       long endColumn,
                                                       int layerNo,
                                                       long[] outWindow,
                                                       java.lang.String storageParam)
        Returns binary mask data as a BLOB for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        layerNo - logical layer whose bitmap mask will be returned as a byte array
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        storageParam - A string specifying storage parameters to be applied in creating rasterBlob. The only supported storageParam keywords supported for this procedure are celldepth, compression, interleaving, and quality; all other keywords are ignored. Storage parameters are explained in Storage Parameters.
        Returns:
        binary mask data.
      • getBitmapMaskSubset

        public byte[] getBitmapMaskSubset​(int pyramidLevel,
                                          JGeometry window,
                                          int layerNo,
                                          java.lang.String cellDepth,
                                          java.lang.String compression,
                                          int quality,
                                          long[] outWindow)
        Returns binary mask data as a byte array for specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level
        window - a JGeometry object which represents the area of interest
        layerNo - the logical layer whose bitmap mask will be returned as a byte array
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_DEFLATE 
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        Returns:
        binary mask data stored in a byte array.
      • getBitmapMaskSubset

        public byte[] getBitmapMaskSubset​(int pyramidLevel,
                                          long startRow,
                                          long startColumn,
                                          long endRow,
                                          long endColumn,
                                          int layerNo,
                                          java.lang.String cellDepth,
                                          java.lang.String compression,
                                          long[] outWindow)
        Returns binary mask data as a byte array for a specified layer of the associated GeoRaster object, based on parameters that specify the window, layer, and customized cell depth.
        Parameters:
        pyramidLevel - pyramid level.
        startRow - upper-left row coordinate, not including ULTCoordinate
        startColumn - upper-left column coordinate, not including ULTCoordinate
        endRow - lower-right row coordinate, not including ULTCoordinate
        endColumn - lower-right column coordinate, not including ULTCoordinate
        layerNo - the logical layer whose bitmap mask will be returned as a byte array
        cellDepth - cellDepth of the returned raster data; must be one of the following values:
                                   RasterInfo.CELL_DEPTH_1BIT
                                   RasterInfo.CELL_DEPTH_2BIT
                                   RasterInfo.CELL_DEPTH_4BIT
                                   RasterInfo.CELL_DEPTH_8BIT_U
                                   RasterInfo.CELL_DEPTH_8BIT_S
                                   RasterInfo.CELL_DEPTH_16BIT_U
                                   RasterInfo.CELL_DEPTH_16BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_U
                                   RasterInfo.CELL_DEPTH_32BIT_S
                                   RasterInfo.CELL_DEPTH_32BIT_REAL
                                   RasterInfo.CELL_DEPTH_64BIT_REAL  
        compression - compression type of the returned raster data; must be one of the following values:
                                   RasterInfo.COMPRESSION_NONE
                                   RasterInfo.COMPRESSION_DEFLATE 
        outWindow - a long array returning the coordinates of the upper-left and lower-right corners of the output window in the cell space. Note that the caller must pass in a long array, and the length of the array should be 4. The method getModelCoordinate(...) defined in the class SpatialReferenceInfo can be used to transform this outWindow into model space.
        Returns:
        binary mask data stored in a byte array.
      • dropAllRasterBlocks

        public void dropAllRasterBlocks()
                                 throws java.lang.Exception
        Drops all raster blocks of the associated GeoRaster object from raster data table in the Oracle database. This method is usually used by the loader to reload all GeoRaster data from outside.
        Throws:
        java.lang.Exception
      • initRasterBlock

        public oracle.sql.BLOB initRasterBlock​(int pLevel,
                                               int bandBlockNumber,
                                               int rowBlockNumber,
                                               int columnBlockNumber,
                                               JGeometry mbr)
                                        throws java.lang.Exception
        Inserts a new row into raster data table with specified pLevel,bandBlockNumber, rowBlockNumber, columnBlockNumber, and mbr. This method is usually used by the loader, and an empty blob gets returned.
        Parameters:
        pLevel - pyramid level
        bandBlockNumber - band block number
        rowBlockNumber - row block number
        columnBlockNumber - column block number
        mbr - geometry extent
        Returns:
        an empty BLOB object in the new row
        Throws:
        java.lang.Exception
      • initRasterBlockJS

        public java.sql.Blob initRasterBlockJS​(int pLevel,
                                               int bandBlockNumber,
                                               int rowBlockNumber,
                                               int columnBlockNumber,
                                               JGeometry mbr)
                                        throws java.lang.Exception
        Inserts a new row into raster data table with specified pLevel,bandBlockNumber, rowBlockNumber, columnBlockNumber, and mbr. This method is usually used by the loader, and an empty blob gets returned.
        Parameters:
        pLevel - pyramid level
        bandBlockNumber - band block number
        rowBlockNumber - row block number
        columnBlockNumber - column block number
        mbr - geometry extent
        Returns:
        an empty BLOB object in the new row
        Throws:
        java.lang.Exception
      • storeRasterBlock

        public void storeRasterBlock​(javax.imageio.stream.ImageInputStream data,
                                     java.sql.Blob rasterBlock)
                              throws java.lang.Exception
        Stores data from an ImageInputStream into blob. This method is usually used by loader.
        Parameters:
        data - ImageInputStream
        rasterBlock - blob
        Throws:
        java.lang.Exception
      • storeRasterBlock

        public void storeRasterBlock​(byte[] data,
                                     java.sql.Blob rasterBlock)
                              throws java.lang.Exception
        Stores data from byte array into a BLOB. All data stored in the byte array will be streamingly written into BLOB without any change, before writting, position of BLOB will be set to 1. This method is usually used by the loader.
        Parameters:
        data - binary array
        rasterBlock - blob
        Throws:
        java.lang.Exception
      • appendRasterBlock

        public void appendRasterBlock​(byte[] data,
                                      java.sql.Blob rasterBlock)
                               throws java.lang.Exception
        Stores data from byte array into a BLOB. All data stored in the byte array will be streamingly written into BLOB without any change, before writing, position of BLOB will be set to it's end. This method is usually used by the loader.
        Parameters:
        data - binary array
        rasterBlock - blob
        Throws:
        java.lang.Exception
      • changeCellValue

        public void changeCellValue​(long row,
                                    long column,
                                    java.lang.String bandNumbers,
                                    double newCellValue,
                                    double[] bgValues)
                             throws java.lang.Exception
        Changes the value of raster cell in a specified point of a GeoRaster object to a single new value.
        Parameters:
        row - row of the point where the values is changed to newCellValue
        column - column of the point where the values is changed to newCellValue
        bandNumbers - A string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).
        newCellValue - the new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.
        bgValues - background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
        Throws:
        java.lang.Exception
      • changeCellValue

        public void changeCellValue​(long startRow,
                                    long startColumn,
                                    long endRow,
                                    long endColumn,
                                    java.lang.String bandNumbers,
                                    double newCellValue,
                                    double[] bgValues)
                             throws java.lang.Exception
        Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
        Parameters:
        startRow - startX of the Window in which to change the values of all cells to newCellValue
        startColumn - startY of the Window in which to change the values of all cells to newCellValue
        endRow - endX of the Window in which to change the values of all cells to newCellValue
        endColumn - endY of the Window in which to change the values of all cells to newCellValue
        bandNumbers - a string identifying the physical band numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3).
        newCellValue - the new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.
        bgValues - background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
        Throws:
        java.lang.Exception
      • changeCellValue

        public void changeCellValue​(JGeometry window,
                                    java.lang.String layerNumbers,
                                    double newCellValue,
                                    double[] bgValues)
                             throws java.lang.Exception
        Changes the value of raster cells in a specified window of a GeoRaster object to a single new value.
        Parameters:
        window - window in which to change the values of all cells to newCellValue
        layerNumbers - a string identifying the logical layer numbers on which the operation is to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 2-4 for layers 2, 3, and 4).
        newCellValue - the new cell value for each cell inside the window in the specified bands or layers. The value must be in the range designated by the cellDepth value for the GeoRaster object.
        bgValues - background values for filling partially empty raster blocks. It is only useful when the source GeoRaster object has empty raster blocks and the current operation leads to partially empty raster blocks. The filling values must be valid cell values as specified by the target cell depth background values for filling sparse data.
        Throws:
        java.lang.Exception
      • getCellValue

        public double getCellValue​(JGeometry ptGeom,
                                   int pyramidLevel,
                                   int layerNumber)
                            throws java.lang.Exception
        Returns the value of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer number.
        Parameters:
        pyramidLevel - pyramid level containing the cell whose value is to be returned
        ptGeom - point geometry that identifies the cell whose value is to be returned
        layerNumber - number of the logical layer that contains the cell whose value is to be returned. (The logical layer number is the physical band number plus 1.)
        Returns:
        cellValue.
        Throws:
        java.lang.Exception
      • getCellValue

        public double getCellValue​(int pyramidLevel,
                                   int rowNumber,
                                   int colNumber,
                                   int bandNumber)
                            throws java.lang.Exception
        Returns the value of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band number in its cell coordinate system and its band number.
        Parameters:
        pyramidLevel - pyramid level containing the cell whose value is to be returned
        rowNumber - number of the row that contains the cell whose value is to be returned
        colNumber - number of the column that contains the cell whose value is to be returned
        bandNumber - number of the physical band that contains the cell whose value is to be returned
        Returns:
        cellValue.
        Throws:
        java.lang.Exception
      • getCellValues

        public java.math.BigDecimal[] getCellValues​(JGeometry ptGeom,
                                                    int pyramidLevel,
                                                    java.lang.String layerNumbers)
                                             throws java.lang.Exception
        Returns an array of values of a single cell located anywhere in the GeoRaster object by specifying a point geometry in its model coordinate system and its logical layer numbers.
        Parameters:
        pyramidLevel - pyramid level containing the cell whose value is to be returned
        ptGeom - point geometry that identifies the cell whose value is to be returned
        layerNumbers - A string identifying the logical layer numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3)
        Returns:
        cellValue. Note that this function only works in version 11.2 or later.
        Throws:
        java.lang.Exception
      • getCellValues

        public java.math.BigDecimal[] getCellValues​(int pyramidLevel,
                                                    int rowNumber,
                                                    int colNumber,
                                                    java.lang.String bandNumbers)
                                             throws java.lang.Exception
        Returns an array of values of a single cell located anywhere in the GeoRaster object by specifying its row, column, and band number in its cell coordinate system and its band numbers.
        Parameters:
        pyramidLevel - pyramid level containing the cell whose value is to be returned
        rowNumber - number of the row that contains the cell whose value is to be returned
        colNumber - number of the column that contains the cell whose value is to be returned
        bandNumbers - A string identifying the phisical band numbers on which the operation or operations are to be performed. Use commas to delimit the values, and a hyphen to indicate a range (for example, 1-3 for bands 1, 2, and 3)
        Returns:
        cellValue. Note that this function only works in version 11.2 or later.
        Throws:
        java.lang.Exception
      • generateBlockMBR

        public void generateBlockMBR()
                              throws java.lang.Exception
        Computes the minimum bounding rectangle (MBR) for each block in a GeoRaster object, and sets the blockMBR attribute for each raster block in the raster data table. This method does not change the GeoRaster object. It sets the value of the blockMBR attribute in each row of the raster data table associated with the GeoRaster object.
        Throws:
        java.lang.Exception
      • getBitmapMaskValue

        public byte getBitmapMaskValue​(int layerNumber,
                                       int pyramidLevel,
                                       int rowNumber,
                                       int colNumber)
                                throws java.lang.Exception
        Gets the value of a single cell from a bitmap mask.
        Parameters:
        layerNumber - number of the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.
        pyramidLevel - pyramid level containing the specified cell
        rowNumber - row number in cell space
        colNumber - column number in cell space
        Returns:
        the value of a single cell from a bitmap mask.
        Throws:
        java.lang.Exception
      • getBitmapMaskValue

        public byte getBitmapMaskValue​(int layerNumber,
                                       int pyramidLevel,
                                       JGeometry ptGeom)
                                throws java.lang.Exception
        Gets the value of a single cell from a bitmap mask.
        Parameters:
        layerNumber - number of the layer on which to perform the operation. A value of 0 (zero) indicates the object layer.
        pyramidLevel - pyramid level containing the specified cell
        ptGeom - point geometry in cell space or model space
        Returns:
        the value of a single cell from a bitmap mask.
        Throws:
        java.lang.Exception
      • getRasterBlockLocatorJS

        public java.sql.Blob getRasterBlockLocatorJS​(int pyramidLevel,
                                                     long bandBlockNumber,
                                                     long rowBlockNumber,
                                                     long columnBlockNumber,
                                                     boolean isBitmapMask,
                                                     boolean lock_for_write)
                                              throws java.lang.Exception
        Gets the LOB locator of a specified raster block.
        Parameters:
        pyramidLevel - pyramid level of the block
        bandBlockNumber - band number of the block
        rowBlockNumber - row number of the block
        columnBlockNumber - column number of the block
        isBitmapMask - the string TRUE specifies that a bitmap mask block will be accessed; the string FALSE specifies that a regular raster block will be accessed. If you do not specify this parameter, a regular raster block will be accessed. For an explanation of bitmap masks, see the Oracle Spatial GeoRaster Developer's Guide.
        lock_for_write - the string TRUE locks the row in the raster data table so that other users cannot lock or update that row until the current transaction ends; the string FALSE does not lock the row in the raster data table. If you do not specify this parameter, the row is not locked.
        Returns:
        the LOB locator of a specified raster block.
        Throws:
        java.lang.Exception
      • getRasterBlock

        public byte[] getRasterBlock​(int pyramidLevel,
                                     long bandBlockNumber,
                                     long rowBlockNumber,
                                     long columnBlockNumber,
                                     boolean isBitmapMask,
                                     boolean lock_for_write)
                              throws java.lang.Exception
        Gets the byte array of a specified raster block.
        Parameters:
        pyramidLevel - pyramid level of the block
        bandBlockNumber - band number of the block
        rowBlockNumber - row number of the block
        columnBlockNumber - column number of the block
        isBitmapMask - the string TRUE specifies that a bitmap mask block will be accessed; the string FALSE specifies that a regular raster block will be accessed. If you do not specify this parameter, a regular raster block will be accessed. For an explanation of bitmap masks, see the Oracle Spatial GeoRaster Developer's Guide.
        lock_for_write - the string TRUE locks the row in the raster data table so that other users cannot lock or update that row until the current transaction ends; the string FALSE does not lock the row in the raster data table. If you do not specify this parameter, the row is not locked.
        Returns:
        a byte array of a specified raster block.
        Throws:
        java.lang.Exception
      • getRasterData

        @Deprecated
        public oracle.sql.BLOB getRasterData​(int pyramidLevel,
                                             java.lang.String storageParam,
                                             double[] bgValues)
                                      throws java.lang.Exception
        Deprecated.
        Returns a single BLOB object that contains all raster data of the associated GeoRaster object at the specified pyramid level.
        Parameters:
        pyramidLevel - pyramid level for which to perform the operation
        storageParam - a string specifying storage parameters to be applied in creating rasterBlob. The only storageParam keywords supported for this method are celldepth, compression, interleaving, and quality; all other keywords are ignored. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the double array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, double[](1,5,10) fills the first band with 1, the second band with 5, and the third band with 10.
        Returns:
        a single BLOB object that contains all raster data of the associated GeoRaster object at the specified pyramid level.
        Throws:
        java.lang.Exception
      • getRasterDataJS

        public java.sql.Blob getRasterDataJS​(int pyramidLevel,
                                             java.lang.String storageParam,
                                             double[] bgValues)
                                      throws java.lang.Exception
        Returns a single Blob object that contains all raster data of the associated GeoRaster object at the specified pyramid level.
        Parameters:
        pyramidLevel - pyramid level for which to perform the operation
        storageParam - a string specifying storage parameters to be applied in creating rasterBlob. The only storageParam keywords supported for this method are celldepth, compression, interleaving, and quality; all other keywords are ignored. If storageParam is null or not specified, the cell depth, interleaving, and compression type (and compression quality, if applicable) are the same as for the input GeoRaster object.
        bgValues - background values for filling sparse data. The number of elements in the double array must be either one (same filing value used for all bands) or the band dimension size (a different filling value for each band, respectively). For example, double[](1,5,10) fills the first band with 1, the second band with 5, and the third band with 10.
        Returns:
        a single BLOB object that contains all raster data of the associated GeoRaster object at the specified pyramid level.
        Throws:
        java.lang.Exception
      • setBitmapMask

        public void setBitmapMask​(int layerNumber,
                                  JGeoRaster mask,
                                  java.lang.String NODATAMask)
                           throws java.lang.Exception
        Attaches a bitmap mask to a GeoRaster object, or replaces or removes the current bitmap mask.
        Parameters:
        layerNumber - layer with which to associate the bitmap mask. A value of 0 (zero) indicates the object layer.
        mask - the bitmap mask to be attached to the GeoRaster object. If this parameter is null, any existing bitmap mask associated with the specified layer of the GeoRaster object is removed.
        NODATAMask - Specifies false if mask is not to be interpreted as a NODATA mask, or true if mask is to be interpreted as a NODATA mask.
        Throws:
        java.lang.Exception
      • validateBlockMBR

        public boolean validateBlockMBR()
                                 throws java.lang.Exception
        Checks the blockMBR attribute in each row of the raster data table associated with the specified GeoRaster object to see if its geometry is the actual minimum bounding rectangle (MBR) of that block.
        Returns:
        the string TRUE if the blockMBR attribute is the MBR of each block, a null value if the GeoRaster object is null, an Oracle error code if the error is known, or FALSE for an unknown error.
        Throws:
        java.lang.Exception
      • initRDT

        public void initRDT()
                     throws java.lang.Exception
        Initializes all rows in the RDT table, based on information like dimensionSize, blockSize, pyramidLevel, and so on, stored in the metadata. Each rasterBlock column will be initialized as an empty blob, and then can be retrieved by the following method:

        public Blob getRasterBlockLocator(int pyramidLevel,long bandBlockNumber,long rowBlockNumber,long columnBlockNumber,boolean isBitmapMask,boolean lock_for_write) throws Exception

        Note: this method will delete all rows associated with current rasterID first.

        Throws:
        java.lang.Exception