diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-0B24B36D-F4C5-508A-A65B-18E4E4C45C37.dita --- a/Symbian3/SDK/Source/GUID-0B24B36D-F4C5-508A-A65B-18E4E4C45C37.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-0B24B36D-F4C5-508A-A65B-18E4E4C45C37.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,30 +1,95 @@ - - - - - -Overview

This document introduces you to the Snapshot API.

Purpose

This API allows the client to request snapshot data in a specified image format for both still images and video. The client can specify the properties of the snapshot, such as size, background colour and position to be used. For example, details about whether the snapshot has been scaled.

Snapshot API Library Details

The DLL that provides the functionality and the library to which your code must link is identified below.

DLL LIB Short Description

ecamsnapshot.dll

euser.lib

ecampluginsupport.lib

ecamhistogram.lib

These files are used for implementing the Snapshot APIs.

Architectural Relationship

This is part of the camera component.

Description

The client application using this API should provide McameraObserver2 interface to be signalled, with event KuidECamEventCameraSnapshot, when snapshot data is available to be retrieved from the Ecam server. The client can then retrieve the snapshot data from the server.

Key Snapshot API Classes

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

  • CCamera::CCameraSnapshot

    This class allows a client to request snapshot data in a specified image format for both still images and video.

    • CCameraSnapshot::SupportedFormats()

      Gets a list of the camera formats for which the server supports snapshots.

    • CCamera::CCameraSnapshot::PrepareSnapshotL() -

      Selects snapshot parameters. The following example shows how to do this:

      // Gets the list of supported formats for snapshots -TUint suppFormats = snap->SupportedFormats(); - -CCamera::TFormat format = CCamera::EFormatJpeg; -if(suppFormats & format) - { - // Sets the properties of the snapshot data including - // background colour and the position of the snapshot - TSize sShotSize(90,50); - TRgb bgrndColor(100,100,100); - TBool aspectRatio = ETrue; - TPoint orgPos(2,2); - - snap->PrepareSnapshotL(format, orgPos, sShotSize, bgrndColor,aspectRatio); -

    • - CCamera::CCameraSnapshot::IsSnapshotActive()

      Determines if the snapshot feature is active.

    • CCamera::CCameraSnapshot::StartSnapshot() -

      Request notifications from the Camera.

    • CCamera::CCameraSnapshot::StopSnapshot()

      Stops receiving snapshot notifications.

    • CCamera::CCameraSnapshot::SnapshotDataL() -

      Returns the snapshot data from server to the client.

  • McameraSnapshot

  • McameraSnapshot2

  • CCameraDirectSnapshot

  • McameraDirectSnapshot

Using Snapshot API

Clients can use the Snapshot API to:

  • Create snapshots for still images and video.

  • View the captured images on the display instantly.

See also

Overview of the Camera component

The Snapshot tutorial

\ No newline at end of file + + + + + +Overview +

This document introduces you to the Snapshot API.

+
Purpose

This +API allows the client to request snapshot data in a specified image format +for both still images and video. The client can specify the properties of +the snapshot, such as size, background colour and position to be used. For +example, details about whether the snapshot has been scaled.

Snapshot +API Library Details

The DLL that provides the functionality and +the library to which your code must link is identified below.

+ + + +DLL +LIB +Short Description + + + + +

ecamsnapshot.dll

+

euser.lib

ecampluginsupport.lib

ecamhistogram.lib

+

These files are used for implementing the Snapshot APIs.

+ + + +
+
Architectural +Relationship

This is part of the camera component.

+
Description

The +client application using this API should provide McameraObserver2 interface +to be signalled, with event KuidECamEventCameraSnapshot, +when snapshot data is available to be retrieved from the Ecam server. The +client can then retrieve the snapshot data from the server.

+
Key Snapshot +API Classes

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

    +

  • CCamera::CCameraSnapshot

    This +class allows a client to request snapshot data in a specified image format +for both still images and video.

      +

    • CCameraSnapshot::SupportedFormats()

      Gets +a list of the camera formats for which the server supports snapshots.

      • +

    • CCamera::CCameraSnapshot::PrepareSnapshotL() +

      Selects snapshot parameters. The +following example shows how to do this:

      // Gets the list of supported formats for snapshots +TUint suppFormats = snap->SupportedFormats(); + +CCamera::TFormat format = CCamera::EFormatJpeg; +if(suppFormats & format) + { + // Sets the properties of the snapshot data including + // background colour and the position of the snapshot + TSize sShotSize(90,50); + TRgb bgrndColor(100,100,100); + TBool aspectRatio = ETrue; + TPoint orgPos(2,2); + + snap->PrepareSnapshotL(format, orgPos, sShotSize, bgrndColor,aspectRatio); +
      • +

    • + CCamera::CCameraSnapshot::IsSnapshotActive()

      Determines +if the snapshot feature is active.

      • +

    • CCamera::CCameraSnapshot::StartSnapshot() +

      Request notifications from the Camera.

      • +

    • CCamera::CCameraSnapshot::StopSnapshot()

      Stops +receiving snapshot notifications.

      • +

    • CCamera::CCameraSnapshot::SnapshotDataL() +

      Returns the snapshot data from server +to the client.

      • +
    • +

  • MCameraSnapshot

    • +

  • MCameraSnapshot2

    • +

  • CCamera::CCameraDirectSnapshot

    • +

  • MCameraDirectSnapshot

    • +
+
Using Snapshot +API

Clients can use the Snapshot API to:

    +

  • Create snapshots for +still images and video.

    • +

  • View the captured images +on the display instantly.

    • +
+
See also

Overview of the Camera +component

The Snapshot tutorial

+ \ No newline at end of file