diff -r 000000000000 -r 40261b775718 imagingandcamerafws/camerafw/Include/ecamdef.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/imagingandcamerafws/camerafw/Include/ecamdef.h Tue Feb 02 01:56:55 2010 +0200 @@ -0,0 +1,163 @@ +// Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). +// All rights reserved. +// This component and the accompanying materials are made available +// under the terms of "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: +// +// Description: +// + +/** + @file + @internalTechnology + @released +*/ +#ifndef ECAM_DEF_H +#define ECAM_DEF_H + +#ifdef SYMBIAN_ENABLE_SPLIT_HEADERS +#include +#include +#endif +/** +Viewfinder fading effect has been set. +This event should be packed in TECAMEvent2 class. + +Note: TECAMEvent2::iParam represents viewfinder handle. + +@internalTechnology +*/ +static const TUid KUidECamEvent2ViewFinderFadingEffect = {KUidECamEvent2ViewFinderFadingEffectUidValue}; + +/** +Event providing focussing feedback. The focussing feedback will be provided whenever the focussing state changes for the +selected spot combination. +This event should be packed in TECAMEvent2 class. +Note: TECAMEvent2::iParam represents bitfield of chosen spots which are in focus. +Note: TECAMEvent2::iParam1 represents bitfield of chosen spots which are not in focus. + +@internalTechnology +*/ +static const TUid KECamEvent2ImageCaptureControlFocussingInformation = {KECamEvent2ImageCaptureControlFocussingInformationUidValue}; + +/** +Focussing spot combination. This event tells about completion of the setting operation for the spot combination. +This event should be packed in TECAMEvent2 class. + +@note static_cast(TECAMEvent2::iParam) represents the focus mode for + which the spot combination has to be set for receiving focussing feedback. + +@internalTechnology +*/ +static const TUid KUidECamEvent2ImageCaptureControlSpotCombination = {KUidECamEvent2ImageCaptureControlSpotCombinationUidValue}; + +/** +Viewfinder magnification has been set. +This event should be packed in TECAMEvent2 class. + +Note: TECAMEvent2::iParam represents viewfinder handle. + +@internalTechnology +*/ +static const TUid KUidECamEvent2ViewFinderMagnification = {KUidECamEvent2ViewFinderMagnificationUidValue}; + +/** +Notifies the current camera reserver that the camera control will be forcefully overtaken by another requesting client +after a specific time interval. + +This TUid is available from the following methods only to the API clients using CCamera::New2L() or CCamera::NewDuplicate2L(): +void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray& aSettings) const; +void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray& aActiveSettings) const; +void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray& aDisabledSettings) const; + +@note TTimeIntervalMicroSeconds32(TECAMEvent2::iParam) represents the maximum time to wait. + TECAMEvent2::iParam needs to be passed as argument in order to construct the TTimeIntervalMicroSeconds32 object. + +Note: TECAMEvent2::iParam1 represents the priority of the requestor client to whom the camera control will be forcibly +passed after a specific time interval. + +@internalTechnology +*/ +static const TUid KUidECamEvent2CameraRequestForcedTimedTakeOver = {KUidECamEvent2CameraRequestForcedTimedTakeOverUidValue}; + +/** +Notifies the current camera reserver that another client is requesting for camera control in a specific time interval. + +This TUid is available from the following methods only to the API clients using CCamera::New2L() or CCamera::NewDuplicate2L(): +void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray& aSettings) const; +void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray& aActiveSettings) const; +void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray& aDisabledSettings) const; + +@note TTimeIntervalMicroSeconds32(TECAMEvent2::iParam) represents the maximum requested time within which the current + reserver may release the camera if it wishes to do so. + TECAMEvent2::iParam needs to be passed as argument in order to construct the TTimeIntervalMicroSeconds32 object. + +Note: TECAMEvent2::iParam1 represents the priority of the requestor client to whom the camera control will be passed +should the current reserver wish to do so. + +@internalTechnology +*/ +static const TUid KUidECamEvent2CameraRequestTimedTakeOver = {KUidECamEvent2CameraRequestTimedTakeOverUidValue}; + +/** +Notifies the manual gain setting completion for the particular channel. + +This TUid is available from the following methods only to the API clients using CCamera::New2L() or CCamera::NewDuplicate2L(): +void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray& aSettings) const; +void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray& aActiveSettings) const; +void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray& aDisabledSettings) const; + +Note: TECAMEvent2::iParam represents the specific channel for which the manual gain value has been set. + +@internalTechnology +*/ +static const TUid KUidECamEvent2CameraSettingManualGain = {KUidECamEvent2CameraSettingManualGainUidValue}; + +/** +Retrieves the optimal focussing feedback while using manual focus. This will be issued as a result of setting operation +CCamera::CCameraAdvancedSettings::SetFocusDistance(TInt aDistance). + +This TUid is available from the following methods only to the API clients using CCamera::New2L() or CCamera::NewDuplicate2L(): +void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray& aSettings) const; +void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray& aActiveSettings) const; +void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray& aDisabledSettings) const; + +@note If TECAMEvent2::iParam > 1, information is unavailable; if TECAMEvent2::iParam < 0, error case. + Otherwise, static_cast(TECAMEvent2::iParam) retrieves whether optimal focussing has been achieved or not. + +@internalTechnology +*/ +static const TUid KUidECamEvent2CameraSettingFocusDistance = {KUidECamEvent2CameraSettingFocusDistanceUidValue}; + +/** +Instructs the client to change its priority in order to allow the legacy client to get hold of the camera. Client should +restore their priority when they receive the notification 'KUidECamEventCameraSettingRestoreClientPriority'. + +This TUid is available from the following methods only to the API clients using CCamera::New2L() or CCamera::NewDuplicate2L(): +void CCamera::CCameraAdvancedSettings::GetSupportedSettingsL(RArray& aSettings) const; +void CCamera::CCameraAdvancedSettings::GetActiveSettingsL(RArray& aActiveSettings) const; +void CCamera::CCameraAdvancedSettings::GetDisabledSettingsL(RArray& aDisabledSettings) const; + +Note: TECAMEvent2::iParam represents the target priority to which the client should set itself using the method SetClientPriorityL() + +@internalTechnology +*/ +static const TUid KUidECamEvent2CameraSettingChangeClientPriority = {KUidECamEvent2CameraSettingChangeClientPriorityUidValue}; + +/** +Event indicating image enhancement setting has been applied. +This event should be packed in TECAMEvent2 class. + +Note: TECAMEvent2::iParam represents viewfinder handle. + +@internalTechnology +*/ +static const TUid KUidECamEvent2ViewFinderImageEnhancement = {KUidECamEvent2ViewFinderImageEnhancementUidValue}; + +#endif // ECAM_DEF_H