<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-C519E523-E908-5185-949C-C1FAC0BAF0D9" xml:lang="en"><title>Histograms</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This document introduces you to the Histogram API of the Ecam component. </p>

<section><title>Purpose</title> <p>This document shows you the detailed description

of tutorial and how to work with it. </p> </section>

<section><title>Introduction</title> <p>A Histogram is a graph that gives

the information about the exposure of the captured frame. It gives details

about the distribution of light on a picture. </p> <p>The histogram explains

which portions of the frame are over-exposed or under-exposed and helps you

to adjust the captured frame accordingly. </p> <p>You can display the histogram

information directly on a viewfinder or analyze it using any analysis software. </p> <p><b>Setup and Configuration Requirements</b> </p> <p>The following examples

assume a camera object exists. </p> <p>The code in this tutorial

can be found in <filepath>…\os\mm\imagingandcamerafws\cameraunittest\src\ECamUnitTestPlugin\extended_functionality.cpp</filepath>. </p> </section>

<section><title>Using Histogram </title> <p>The histograms can be created

for: </p> <ul>

<li id="GUID-F84ADD35-2C3E-5FCD-9AD7-E7868874767F"><p>still image </p> </li>

<li id="GUID-24EDCC63-7DC9-5176-BDD8-CF5555358876"><p>video frames </p> </li>

<li id="GUID-8F776636-79CA-5ED6-AFD3-1BF5D878E6A5"><p>both client and direct

viewfinders. </p> </li>

</ul> </section>

</conbody><related-links>

<link href="GUID-5A5DDB8C-1E70-5B63-96F1-7ABBFA568866.dita"><linktext>Creating

Histograms</linktext></link>

<link href="GUID-7022455A-E738-574E-897E-33243482D69A.dita"><linktext>Working with

Histograms</linktext></link>

<link href="GUID-7F6A463C-2D33-5B6D-9394-DCB55FEEB5A3.dita"><linktext>Stopping

Histograms</linktext></link>