Overview

This document introduces you to the Viewfinder API.

Purpose

The Viewfinder enables you to pause and resume the direct viewfinder which is currently active and has been started using Ccamera methods.

Viewfinder Library Details

The DLLs listed below provide the viewfinder functionality and the library to which your code must link is identified below.

DLL Classes LIB Short Description

ECamAdvSettings.dll

CCamera::StartViewFinderDirectL() starts viewfinder.

CCamera::CCameraDirectViewFinder allows to use direct viewfinder.

euser.lib

ecampluginsupport.lib

These files are used by ECAM clients to provide a certain type of control over direct viewfinder.

Ecam.dll and ecamdirectviewfinder.dll

CCameraViewFinder

Camera::CCameraV2DirectViewFinder and CCamera::CCameraClientViewFinder (for starting multiple viewfinders).

euser.lib

ecampluginsupport.lib

These files are used for implementing the Viewfinder functionalities.

Architectural Relationship

This is part of the camera component.

Description

The Viewfinder acquires information about the current state of that direct viewfinder. The different possible states are active, paused and inactive. It allows you to pause and resume the direct viewfinder that is currently active and has been started using CCamera functions.

Key Viewfinder Classes

The key classes that make up the Viewfinder API are as follows:

Multiple viewfinders may run at the same time by the use of new extension classes:

  • CcameraV2DirectViewFinder: This provides the necessary framework for multiple direct viewfinder support. The direct viewfinder classes are provided as a part of Version2 direct viewfinder implementation.

  • CcameraClientViewFinder: This provides the necessary framework for multiple client viewfinder support. The client viewfinder classes are provided as a part of client viewfinder implementation.

Note: Licensees must provide a concrete implementation of MCameraViewFinder, MCameraV2DirectViewFinder and MCameraClientViewFinder.

Using Viewfinder

Clients can use the Viewfinder to:

  • Run multiple viewfinders on different displays of camera. It can be executed on TV screen with different orientation based on its topology and on LCD display.

  • Expand or reduce the view of the captured image.

  • Add region of interest specification and control.

See also

Overview of Camera Framework

The Viewfinder Tutorial