|
Original Symbian headers
Selected EUSER, Window Server, networking, graphics and device declarations
|
Specifies camera device information. More...
#include <ecam.h>
Public Types | |
| enum | TCameraOrientation { EOrientationOutwards , EOrientationInwards , EOrientationMobile , EOrientationUnknown } |
| Possible directions in which the camera may point. More... | |
| enum | TOptions { EViewFinderDirectSupported = 0x0001 , EViewFinderBitmapsSupported = 0x0002 , EImageCaptureSupported = 0x0004 , EVideoCaptureSupported = 0x0008 , EViewFinderMirrorSupported = 0x0010 , EContrastSupported = 0x0020 , EBrightnessSupported = 0x0040 , EViewFinderClippingSupported = 0x0080 , EImageClippingSupported = 0x0100 , EVideoClippingSupported = 0x0200 } |
| Various flags describing the features available for a particular implementation. More... | |
Public Attributes | |
| TVersion | iHardwareVersion |
| Version number and name of camera hardware. | |
| TVersion | iSoftwareVersion |
| Version number and name of camera software (device driver). | |
| TCameraOrientation | iOrientation |
| Orientation of this particular camera device. | |
| TUint32 | iOptionsSupported |
| Bitfield of TOptions available. | |
| TUint32 | iFlashModesSupported |
| The supported flash modes. | |
| TUint32 | iExposureModesSupported |
| The supported exposure modes. | |
| TUint32 | iWhiteBalanceModesSupported |
| The supported white balance settings. | |
| TInt | iMinZoom |
| Minimum zoom value allowed. | |
| TInt | iMaxZoom |
| Maximum zoom value allowed. | |
| TInt | iMaxDigitalZoom |
| Maximum digital zoom value allowed. | |
| TReal32 | iMinZoomFactor |
| Image size multiplier corresponding to minimum zoom value. | |
| TReal32 | iMaxZoomFactor |
| Image size multiplier corresponding to maximum zoom value. | |
| TReal32 | iMaxDigitalZoomFactor |
| Image size multiplier corresponding to maximum digital zoom value. | |
| TInt | iNumImageSizesSupported |
| Count of still image capture sizes allowed. | |
| TUint32 | iImageFormatsSupported |
| The supported still image formats. | |
| TInt | iNumVideoFrameSizesSupported |
| Count of video frame sizes allowed. | |
| TInt | iNumVideoFrameRatesSupported |
| Count of video frame rates allowed. | |
| TUint32 | iVideoFrameFormatsSupported |
| The supported video frame formats. | |
| TInt | iMaxFramesPerBufferSupported |
| Maximum number of frames per buffer that may be requested. | |
| TInt | iMaxBuffersSupported |
| Maximum number of buffers allowed. | |
Specifies camera device information.
If either zoom or digital zoom are available then the appropriate entries in this class will be set to indicate the range of values that they may take. This should be implemented such that a setting of zero corresponds to no zoom, and a step of one corresponds to the smallest increment available, in a linear fashion.
There are also zoom factors that correspond to the actual zoom factor when at minimum (non-digital only) and maximum zoom. Negative zoom values represent macro functionality.
Image capture, if supported, is simply a case of transferring the current image from the camera to the client via MCameraObserver::ImageReady(). The camera class must set the iImageFormatsSupported bitfield to indicate the formats available.
Possible directions in which the camera may point.
Various flags describing the features available for a particular implementation.
| TUint32 TCameraInfo::iExposureModesSupported |
The supported exposure modes.
This is a bitfield of CCamera::TExposure values.
| TUint32 TCameraInfo::iFlashModesSupported |
The supported flash modes.
This is a bitfield of CCamera::TFlash values.
If methods CCamera::New2L() or CCamera::NewDuplicate2L() are not used to create the CCamera object, it is assumed that the application may not be able to cope with any future additions to the enum values. So, any unrecognised enum value passed from the implementation should be filtered by ECAM Implementation. To receive unrecognised/extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() to create camera object. This is an indication to ECAM implementation. In this case, application is assumed to be prepared to receive unrecognised enum values.
| TVersion TCameraInfo::iHardwareVersion |
| TUint32 TCameraInfo::iImageFormatsSupported |
The supported still image formats.
This is a bitfield of CCamera::TFormat values.
| TInt TCameraInfo::iMaxBuffersSupported |
| TInt TCameraInfo::iMaxDigitalZoom |
Maximum digital zoom value allowed.
Must be positive, or zero if not supported.
This is the maximum value that may be passed to CCamera::SetDigitalZoomFactorL(). Digital zoom factor is assumed to be a linear scale from 0 to iMaxDigitalZoom.
| TReal32 TCameraInfo::iMaxDigitalZoomFactor |
Image size multiplier corresponding to maximum digital zoom value.
Implementation recommendation is to use 'appropriate value' for maximum digital zoom which could cover only values given by new digital zoom methods based on image format and capture mode.
Must be greater than or equal to 1.
| TInt TCameraInfo::iMaxFramesPerBufferSupported |
| TInt TCameraInfo::iMaxZoom |
Maximum zoom value allowed.
Must be positive, or zero if not supported.
This is the maximum value that may be passed to CCamera::SetZoomFactorL().
| TReal32 TCameraInfo::iMaxZoomFactor |
| TInt TCameraInfo::iMinZoom |
Minimum zoom value allowed.
Must be negative, or zero if not supported.
This is the minimum value that may be passed to CCamera::SetZoomFactorL().
| TReal32 TCameraInfo::iMinZoomFactor |
| TInt TCameraInfo::iNumImageSizesSupported |
Count of still image capture sizes allowed.
Number of different image sizes that CCamera::EnumerateCaptureSizes() will support, based on the index passed in. Index must be between 0 and iNumImageSizesSupported-1.
| TInt TCameraInfo::iNumVideoFrameRatesSupported |
Count of video frame rates allowed.
This is the number of different video frame rates that CCamera::EnumerateVideoFrameRates() will support, based on the specified index. The index must be between 0 and iNumVideoFrameRatesSupported-1.
| TInt TCameraInfo::iNumVideoFrameSizesSupported |
Count of video frame sizes allowed.
This is the number of different video frame sizes that CCamera::EnumerateVideoFrameSizes() will support, based on the specified index. The index must be between 0 and iNumVideoFrameSizesSupported-1.
| TUint32 TCameraInfo::iOptionsSupported |
| TCameraOrientation TCameraInfo::iOrientation |
| TVersion TCameraInfo::iSoftwareVersion |
| TUint32 TCameraInfo::iVideoFrameFormatsSupported |
The supported video frame formats.
This is a bitfield of video frame CCamera::TFormat values.
If methods CCamera::New2L() or CCamera::NewDuplicate2L() are not used to create the CCamera object, it is assumed that the application may not be able to cope with any future additions to the enum values. So, any unrecognised enum value passed from the implementation should be filtered by the ECAM implementation. To receive unrecognised/extra added enum values, the application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() to create the camera object. This is an indication to the ECAM implementation. In this case, the application is assumed to be prepared to receive unrecognised enum values.
| TUint32 TCameraInfo::iWhiteBalanceModesSupported |
The supported white balance settings.
This is a bitfield of of CCamera::TWhiteBalance values.
If methods CCamera::New2L() or CCamera::NewDuplicate2L() are not used to create the CCamera object, it is assumed that the application may not be able to cope with any future additions to the enum values. So, any unrecognised enum value passed from the implementation should be filtered by ECAM Implementation. To receive unrecognised/extra added enum values, application should rather use CCamera::New2L() or CCamera::NewDuplicate2L() to create camera object. This is an indication to ECAM implementation. In this case, application is assumed to be prepared to receive unrecognised enum values. Refer to CCamera::CCameraAdvancedSettings::SupportedWhiteBalanceModes() implementation