Changes between Version 70 and Version 71 of rfc24_progressive_data_support
- Timestamp:
- Apr 8, 2009, 5:02:47 PM (15 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
rfc24_progressive_data_support
v70 v71 67 67 2. Open 68 68 69 If the filename contained in the GDALOpenInfo object has a case insensitive URI scheme of jpip or jpips the JPIPKAKDatasetis created and initialised, otherwise NULL is returned.69 If the filename contained in the `GDALOpenInfo` object has a case insensitive URI scheme of jpip or jpips the `JPIPKAKDataset` is created and initialised, otherwise NULL is returned. 70 70 71 71 3. Initialize … … 75 75 If the connection fails, the function returns false and the Open function returns NULL indicating that opening the dataset with this driver failed. 76 76 77 If the connection is successful, then subsequent requests to the JPIP server are made to retrieve all the available metadata about the image. Metadata items are set using the GDALMajorObject->SetMetadataItemin the "JPIP" domain.77 If the connection is successful, then subsequent requests to the JPIP server are made to retrieve all the available metadata about the image. Metadata items are set using the `GDALMajorObject->SetMetadataItem` in the "JPIP" domain. 78 78 79 79 If the metadata returned from the server includes GeoJP2 UUID box, or a GMLJP2 XML box then this metadata is parsed and sets the geographic metadata of this dataset. … … 81 81 4. GDALGetMetadata 82 82 83 C API to JPIPKAKDataset->GetMetadata83 C API to `JPIPKAKDataset->GetMetadata` 84 84 85 85 5. GetMetadata … … 89 89 6. GDALEndAsyncRasterIO 90 90 91 If the asynchronous raster IO is active and not required, the C API calls JPIPKAKDataset->EndAsyncRasterIO91 If the asynchronous raster IO is active and not required, the C API calls `JPIPKAKDataset->EndAsyncRasterIO` 92 92 93 93 7. EndAsyncRasterIO … … 99 99 9. GDALBeginAsyncRasterIO 100 100 101 C API to JPIPKAKDataset->BeginAsyncRasterIO101 C API to `JPIPKAKDataset->BeginAsyncRasterIO` 102 102 103 103 10. BeginAsyncRasterIO … … 119 119 14. LockBuffer 120 120 121 Not implemented in JPIPKAKAsyncRasterIO, a lock is acquired in JPIPKAKAsyncRasterIO->GetNextUpdatedRegion121 Not implemented in `JPIPKAKAsyncRasterIO`, a lock is acquired in `JPIPKAKAsyncRasterIO->GetNextUpdatedRegion` 122 122 123 123 15. GDALGetNextUpdatedRegion … … 127 127 16. GetNextUpdatedRegion 128 128 129 The function decompresses the available data to generate an image (according to the dataset buffer type set in JPIPKAKDataset->BeginAsyncRasterIO) The window width, height (at the requested discard level) decompressed is returned in the region pointer and can be rendered by the client. The status of the rendering operation is one of GARIO_PENDING, GARIO_UPDATE, GARIO_ERROR, GARIO_COMPLETE from the GDALAsyncStatusType structure. GARIO_UPDATE, GARIO_PENDING require more reads of GetNextUpdatedRegion to get the full image data, this is the progressive rendering of JPIP. GARIO_COMPLETEindicates the window is complete.129 The function decompresses the available data to generate an image (according to the dataset buffer type set in `JPIPKAKDataset->BeginAsyncRasterIO`) The window width, height (at the requested discard level) decompressed is returned in the region pointer and can be rendered by the client. The status of the rendering operation is one of `GARIO_PENDING`, `GARIO_UPDATE`, `GARIO_ERROR`, `GARIO_COMPLETE` from the `GDALAsyncStatusType` structure. `GARIO_UPDATE`, `GARIO_PENDING` require more reads of `GetNextUpdatedRegion` to get the full image data, this is the progressive rendering of JPIP. `GARIO_COMPLETE` indicates the window is complete. 130 130 131 GDALAsyncStatusType is a structure used byGetNextUpdatedRegionto indicate whether the function should be called again when either kakadu has more data in its cache to decompress, or the server has not sent an End Of Response (EOR) message to indicate the request window is complete.131 `GDALAsyncStatusType` is a structure used by `GetNextUpdatedRegion` to indicate whether the function should be called again when either kakadu has more data in its cache to decompress, or the server has not sent an End Of Response (EOR) message to indicate the request window is complete. 132 132 133 133 The region passed into this function is passed by reference, and the caller can read this region when the result returns to find the region that has been decompressed. The image data is packed into the buffer, e.g. RGB if the region requested has 3 components. … … 139 139 18. UnlockBuffer 140 140 141 Not implemented in JPIPKAKAsyncRasterIO, a lock is acquired in JPIPKAKAsyncRasterIO->GetNextUpdatedRegion141 Not implemented in `JPIPKAKAsyncRasterIO`, a lock is acquired in `JPIPKAKAsyncRasterIO->GetNextUpdatedRegion` 142 142 143 143 19. Draw … … 155 155 24. GDALUnlockBuffer 156 156 157 #UnlockBuffer157 25. UnlockBuffer 158 158 159 #Draw159 26. Draw