| class MHistogramBuffer |
This class is used to pass histogram data between the camera device and a client that implements MCameraObserver2.
The buffer may contain multiple histograms.
The class allows the client to access the data as a descriptor to a kernel chunk.
| Public Member Functions | |
|---|---|
| RChunk & | ChunkL() |
| TInt | ChunkOffsetL(TUint) |
| TDesC8 * | DataL(TUint) |
| TInt | ElementSizeL(TUint) |
| TUint | HandleL(TUint) |
| TInt | ImageNumberL(TUint) |
| TInt | NumOfElementsL(TUint) |
| TInt | NumOfHistograms() |
| void | Release() |
| CCamera::CCameraHistogram::THistogramType | TypeL(TUint) |
| TInt | ChunkOffsetL | ( | TUint | aIndex | ) | [pure virtual] |
use TInt MHistogramV2Buffer::ChunkOffsetL()
Returns the offset in the chunk (returned by ChunkL()) that contains the data for the histogram at a specified index within the histogram buffer.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TDesC8 * | DataL | ( | TUint | aIndex | ) | [pure virtual] |
use TDesC8* MHistogramV2Buffer::DataL()
Allows access to a given histogram in the histogram buffer via a descriptor.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TInt | ElementSizeL | ( | TUint | aIndex | ) | [pure virtual] |
use TInt MHistogramV2Buffer::ElementSize()
Returns the number of bits per histogram element value used to store the histogram data at a specified index within the histogram buffer.
The number of bits per histogram element will be decided by the ECam implementation and it may vary for each histogram within the histogram buffer.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TUint | HandleL | ( | TUint | aIndex | ) | [pure virtual] |
Only one histogram is available per buffer in MHistogramV2Buffer
Returns the handle of a particular histogram stored in the buffer.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TInt | ImageNumberL | ( | TUint | aIndex | ) | [pure virtual] |
Only one histogram is available per buffer in MHistogramV2Buffer
Returns the image number or frame index to which the histogram stored at the specified index within the buffer relates.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TInt | NumOfElementsL | ( | TUint | aIndex | ) | [pure virtual] |
use TInt MHistogramV2Buffer::NumOfElements()
Returns the number of elements in the histogram at a specified index within the histogram buffer.
This value can be used along with the element size obtained by calling ElementSizeL(), to calculate the exact size of histogram data ( element-size x number-of-elements = histogram-size ).
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
| TInt | NumOfHistograms | ( | ) | [pure virtual] |
Only one histogram is available per buffer in MHistogramV2Buffer
Returns the number of histograms contained within the buffer.
This value will not depend upon the number of images for which histograms are requested by the client, but on the number of histograms generated by the ECam implementation. In the case where the driving mode (bracket mode, video mode, etc.) returns more than one image or frame the ECam implementation may not generate histograms for every valid image or frame. This can happen, for example, if there are no changes in the histogram data or if there are performance problems.
| void | Release | ( | ) | [pure virtual] |
use void MHistogramV2Buffer::Release()
Releases the buffer. Once the client has processed the histogram data it should use this method to signal to the camera that the buffer can be deleted or re-used.
| CCamera::CCameraHistogram::THistogramType | TypeL | ( | TUint | aIndex | ) | [pure virtual] |
use CCamera::CCameraV2Histogram::THistogramType MHistogramV2Buffer::Type()
Returns the type of histogram data that is available at the specified index within the histogram buffer.
| TUint aIndex | The index of the required histogram in the buffer. This must be between 0 and (NumOfHistograms() - 1). |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.