#include <icl/imageconversionextension.h>
class TImageConvStreamedDecode |
Public Member Functions | |
---|---|
IMPORT_C void | GetBlocks(TRequestStatus &, CImageFrame &, TInt, TInt, TInt &) |
IMPORT_C TInt | GetBufferSize(TUid, TSize &, TInt) |
IMPORT_C void | GetCapabilities(TUid, TInt, TDecodeStreamCaps &) |
IMPORT_C void | GetNextBlocks(TRequestStatus &, CImageFrame &, TInt, TInt &, TBool &) |
IMPORT_C void | GetSupportedFormatsL(RArray< TUid > &, TUid &) |
IMPORT_C void | InitFrameL(TUid, TInt, TDecodeStreamCaps::TNavigation) |
'Block' streaming extension for Image Conversion Library decoder.
IMPORT_C void | GetBlocks | ( | TRequestStatus & | aStatus, |
CImageFrame & | aFrame, | |||
TInt | aSeqPosition, | |||
TInt | aNumBlocksToGet, | |||
TInt & | aNumBlocksRead | |||
) |
Start asynchronous call to return random blocks from the stream
use CImageDecoder::Cancel() to cancel this request.
Parameter | Description |
---|---|
aStatus | request status |
aFrame | An image frame wrapper a memory buffer to hold the returned block(s) of pixel data. This can be 'uninitialised' or given specific format which must match that specified in the InitFrameL call. |
aSeqPosition | block number starting at top left 0 ... TDecodeStreamCaps::StreamSizeInBlocks() |
aNumBlocksToGet | number of blocks requested |
aNumBlocksRead | number of blocks which will be returned when the request completes |
Get the size of the memory buffer to hold the returned data.
Parameter | Description |
---|---|
aFormat | the required format |
aBlockSizeInPixels | returns the size in pixels of the block returned from the stream when aNumBlocks of minimum block size are requested. |
aNumBlocks | the number of blocks of size TDecodeStreamCaps::MinBlockSizeInPixels() to be returned by one request |
Returns: The memory buffer size in bytes to hold the requested blocks. System wide error if for example the format is not supported.
IMPORT_C void | GetCapabilities | ( | TUid | aFormat, |
TInt | aFrameNumber, | |||
TDecodeStreamCaps & | aCaps | |||
) | const |
Returns the capabilities of the codec plugin for a specific format and for a specific frame.
Parameter | Description |
---|---|
aFormat | The format. |
aFrameNumber | frame to stream |
aCaps | The capabilities for the format given. |
IMPORT_C void | GetNextBlocks | ( | TRequestStatus & | aStatus, |
CImageFrame & | aFrame, | |||
TInt | aNumBlocksToGet, | |||
TInt & | aNumBlocksRead, | |||
TBool & | aHaveMoreBlocks | |||
) |
Start asynchronous call to return blocks sequentially from the stream. Blocks are returned from the first block until the last in the stream.
use CImageDecoder::Cancel() to cancel this request.
Parameter | Description |
---|---|
aStatus | request status |
aFrame | An image frame wrapper a memory buffer to hold the returned block(s) of pixel data. This can be 'uninitialised' or given specific format which must match that specified in the InitFrameL call. |
aNumBlocksToGet | number of blocks requested |
aNumBlocksRead | number of blocks which will be returned when the request completes |
Returns a list of supported formats and the optimal format to be used.
See also: imageframeconst.h for a list of format uids.
Parameter | Description |
---|---|
aFormats | Returns an array of format uids |
aOptimalFormat | The 'best' uid to use. |
IMPORT_C void | InitFrameL | ( | TUid | aFormat, |
TInt | aFrameNumber, | |||
TDecodeStreamCaps::TNavigation | aNavigation | |||
) |
Initialise the stream.
must call InitFrameL before GetBlocks or GetNextBlocks. Failure to do so completes request with KErrNotReady
Parameter | Description |
---|---|
aFormat | the format to use |
aFrameNumber | frame to stream |
aNavigation | indication to stream of the way that the stream will be navigated. Allows codec to optimise it's behaviour. |