CMMFVideoRecordHwDevice Class Reference

Reads various counters related to processed video pictures. See the definition of TPictureCounters for a description of the counters. The counters are reset when Initialize() or this method is called, and thus they only include pictures processed since the last call.

Initializes the device, and reserves hardware resources. If direct capture is used, this method also prepares the camera API for capture by calling PrepareVideoCaptureL(). This method is asynchronous, the device will call MMMFDevVideoRecordProxy::MdvrpInitializeComplete() after initialization has completed. Video capturing and encoding can be started with Start() with a relatively low delay since the hardware has already been set up.

Retrieves the number of complexity control levels available for this hardware device. Devices can support processing the same input data with different computational complexity levels. The complexity level can affect, for example, the motion vector search range used in an encoder.

Retrieves information about the pre-processing capabilities of this hardware device.

Returns the current recording position. The position is the capture timestamp from the latest input picture, or the capture timestamp for the latest picture captured from the camera when direct capture is used.

Revert all changes since the last CommitL(), Revert() or Initialize() back to their previous settings. This only applies to methods which can be called both before AND after DevVideoPlay has been initialized.

See also: CMMFVideoEncodeHwDevice::SetOutputRectL CMMFVideoRecordHwDevice::SetPreProcessTypesL CMMFVideoRecordHwDevice::SetRotateOptionsL CMMFVideoRecordHwDevice::SetScaleOptionsL CMMFVideoRecordHwDevice::SetInputCropOptionsL CMMFVideoRecordHwDevice::SetOutputCropOptionsL CMMFVideoRecordHwDevice::SetOutputPadOptionsL CMMFVideoRecordHwDevice::SetColorEnhancementOptionsL CMMFVideoRecordHwDevice::SetFrameStabilisationOptionsL CMMFVideoRecordHwDevice::SetCustomPreProcessOptionsL CMMFVideoEncodeHwDevice::SetCodingStandardSpecificOptionsL CMMFVideoEncodeHwDevice::SetImplementationSpecificEncoderOptionsL

Pre-condition

"This method can only be called after the hwdevice has been initialized with Initialize()."

Sets the clock source to use for video timing. When video recording is synchronized with audio, the clock source is implemented by the audio playback subsystem, otherwise the clock source should get the time from the system clock.

If no clock source is set, video recording will not be synchronized, but will proceed as fast as possible, depending on input data and output buffer availability. If direct capturing is used without a clock source, the timestamps in the output data may not be valid.

Sets color enhancement pre-processing options.

Sets the complexity level to use for video processing in a hardware device. The level can be changed at any time.

Sets custom implementation-specific pre-processing options.

Sets frame stabilisation options.

Sets pre-processing options for input cropping. Input cropping is typically used for digital zooming.

Sets the hardware device input format. If both a pre-processor and an encoder are used, the pre-processor output format and the encoder input format must be the same. The input format for the first device in the system is the input format for video input data. The method has to be called for both direct capture as well as memory buffer input.

Sets pre-processing options for output cropping. Output cropping is performed after other pre-processing operations but before output padding. Output cropping and padding can be used in combination to prepare the picture size to suit the encoder, typically video encoders only support picture sizes that are multiples of 16 pixels.

Sets pre-processing options for output padding. Output padding is performed as the last pre-processing operation, and typically used to prepare the picture size to suit the encoder. The image is padded with black pixels.

Sets the pre-processing types to be used.

Sets pre-processing options for RGB to YUV color space conversion. By default, input RGB data is assumed to use the full value range ([0 255]), and the output YUV format is the hardware device output format, so typically calling this method is not necessary.

Sets pre-processing options for rotation.

Sets pre-processing options for scaling.

Sets the data source to be a camera, and sets the device to use direct capture for input.

Sets the data source to be memory buffers.

Sets pre-processing options for YUV to YUV data format conversion. By default, the hardware device input and output data formats are used. For encoder devices, the device input format and a the closest matching format supported by the encoding process are used. Typically calling this method is not necessary.

Writes an uncompressed input picture. When the picture has been used, it must be returned to the client with MMMFDevVideoRecordProxy::MdvrpReturnPicture(). This method must not be called if direct capture is used.