MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

FCam::N9::Lens Class Reference

The Lens on the Nokia N9. More...

Inheritance diagram for FCam::N9::Lens:
Inheritance graph
[legend]
Collaboration diagram for FCam::N9::Lens:
Collaboration graph
[legend]

List of all members.

Public Member Functions

void  setFocus (float, float speed)
  Set the focus of the lens in diopters.
float  getFocus () const
  Get the current focus of the lens in diopters.
float  farFocus () const
  The N9 lens focuses to infinity (zero diopters).
float  nearFocus () const
  The closest focus distance is ~6.25cm (16.0 diopters) on N9.
bool  focusChanging () const
  Is the focus currently changing?
float  minFocusSpeed () const
  The N9's lens has only one speed, which covers its entire focal range in about 1ms.
float  maxFocusSpeed () const
  The N9's lens has only one speed, which covers its entire focal range in about 1ms.
int  focusLatency () const
  if I call setFocus, how long will it take before the lens starts moving?
void  setZoom (float, float)
  The N9's lens is fixed at a focal length of 3.77mm.
float  getZoom () const
  The N9's lens is fixed at a focal length of 3.77mm.
float  minZoom () const
  The N9's lens is fixed at a focal length of 3.77mm.
float  maxZoom () const
  The N9's lens is fixed at a focal length of 3.77mm.
bool  zoomChanging () const
  The N9's lens is fixed at a focal length of 3.77mm.
float  minZoomSpeed () const
  The N9's lens is fixed at a focal length of 3.77mm.
float  maxZoomSpeed () const
  The N9's lens is fixed at a focal length of 3.77mm.
int  zoomLatency () const
  The N9's lens is fixed at a focal length of 3.77mm.
void  setAperture (float, float)
  The N9's aperture is fixed at F/2.22.
float  getAperture () const
  The N9's aperture is fixed at F/2.22.
float  wideAperture (float) const
  The N9's aperture is fixed at F/2.22.
float  narrowAperture (float) const
  The N9's aperture is fixed at F/2.22.
bool  apertureChanging () const
  The N9's aperture is fixed at F/2.22.
int  apertureLatency () const
  The N9's aperture is fixed at F/2.22.
float  minApertureSpeed () const
  The N9's aperture is fixed at F/2.22.
float  maxApertureSpeed () const
  The N9's aperture is fixed at F/2.22.
void  tagFrame (FCam::Frame)
  Tag a frame with the state of the Lens during that frame.
float  getFocus (Time t) const
  What was the focus at some time in the past? Uses linear interpolation from known lens positions.

Detailed Description

The Lens on the Nokia N9.

The N9 has a lens capable of focus at a fixed speed. However, the zoom and aperture are fixed.


Member Function Documentation

void FCam::N9::Lens::setFocus ( float  ,
float  speed  
) [virtual]

Set the focus of the lens in diopters.

See Focus for a discussion of diopters.

The second argument is the focus speed in diopters per second. Numbers less than zero (like the default), get mapped to max speed. This function initiates the change in focus and returns. It may take some time before the focus actually reaches the target position (or as close as it can get). Use FCam::Lens::focusChanging to see if the lens is still moving.

Implements FCam::Lens.

float FCam::N9::Lens::getFocus (  )  const [virtual]

Get the current focus of the lens in diopters.

Implements FCam::Lens.

float FCam::N9::Lens::minFocusSpeed (  )  const [virtual]

The N9's lens has only one speed, which covers its entire focal range in about 1ms.

You can treat it as instant for most applications.

Implements FCam::Lens.

float FCam::N9::Lens::maxFocusSpeed (  )  const [virtual]

The N9's lens has only one speed, which covers its entire focal range in about 1ms.

You can treat it as instant for most applications.

Implements FCam::Lens.

void FCam::N9::Lens::tagFrame ( FCam::Frame   )  [virtual]

Tag a frame with the state of the Lens during that frame.

See Lens::Tags

Implements FCam::Lens.

float FCam::N9::Lens::getFocus ( Time  t  )  const

What was the focus at some time in the past? Uses linear interpolation from known lens positions.


Copyright (c) 2012, Nokia Corporation and/or its subsidiary(-ies). All rights reserved. See Copyright.
MeeGo 1.2 Harmattan API