author | Fionntina Carville <fionntinac@symbian.org> |
Fri, 12 Nov 2010 18:52:18 +0000 | |
branch | RCL_3 |
changeset 69 | a2232ad2df6d |
parent 67 | 756ad29ed18e |
permissions | -rw-r--r-- |
54 | 1 |
/* |
2 |
* Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies). |
|
3 |
* All rights reserved. |
|
4 |
* This component and the accompanying materials are made available |
|
5 |
* under the terms of "Eclipse Public License v1.0" |
|
6 |
* which accompanies this distribution, and is available |
|
7 |
* at the URL "http://www.eclipse.org/legal/epl-v10.html". |
|
8 |
* |
|
9 |
* Initial Contributors: |
|
10 |
* Nokia Corporation - initial contribution. |
|
11 |
* |
|
12 |
* Contributors: |
|
13 |
* |
|
14 |
* Description: Class for managing intercommunication between Camcera UI* |
|
15 |
*/ |
|
16 |
||
17 |
||
18 |
#ifndef CAMAPPCONTROLLER_H |
|
19 |
#define CAMAPPCONTROLLER_H |
|
20 |
||
21 |
||
22 |
// =========================================================================== |
|
23 |
// INCLUDES |
|
24 |
#include <e32base.h> |
|
25 |
||
26 |
#include <cflistener.h> // publish zoom state related |
|
27 |
#include <cfclient.h> |
|
28 |
||
29 |
#include <sensrvdatalistener.h> |
|
30 |
#include <sensrvchannel.h> |
|
31 |
#include <sensrvorientationsensor.h> |
|
32 |
||
33 |
#include "MCamAppController.h" |
|
34 |
#include "CamControllerObservers.h" |
|
35 |
#include "mcamsettingsmodelobserver.h" |
|
36 |
#include "CamSettings.hrh" |
|
37 |
#include "Cam.hrh" // TCamSoundId |
|
38 |
#include "CamSettingsInternal.hrh" |
|
39 |
||
40 |
#include "mcamplayerobserver.h" |
|
41 |
||
42 |
#include "CamImageSaveActive.h" |
|
43 |
#include "CamCallStateAo.h" |
|
44 |
#include "CamObserver.h" |
|
45 |
#include "CamBurstModeObserver.h" |
|
46 |
#include "CamPerformance.h" |
|
47 |
||
48 |
#ifndef __WINSCW__ |
|
49 |
#include <rlocationtrail.h> |
|
50 |
#endif |
|
51 |
||
52 |
#include "CamPropertyObserver.h" |
|
53 |
||
54 |
// <CAMERAAPP_CAPI_V2_MIGRATION> |
|
55 |
#include "mcamcameraobserver.h" |
|
56 |
#include "camcamerarequests.h" |
|
57 |
#include "camfolderutility.h" |
|
58 |
#include "camcameracontroller.h" |
|
59 |
#include "CamDriveChangeNotifier.h" |
|
60 |
#include "CamSyncRotatorAo.h" |
|
61 |
#include "camtvaccessorymonitor.h" |
|
62 |
||
63 |
// =========================================================================== |
|
64 |
// CONSTANTS |
|
65 |
||
66 |
// !Do not change the order of these without careful consideration! |
|
67 |
// |
|
68 |
enum TCamCameraState |
|
69 |
{ |
|
70 |
ECamCameraIdle = 0, |
|
71 |
ECamCameraReserved = 1 << 0, |
|
72 |
ECamCameraPowerOn = 1 << 1, |
|
73 |
ECamCameraPreparedImage = 1 << 2, |
|
74 |
ECamCameraPreparedVideo = 1 << 3, |
|
75 |
ECamCameraStateLast // Not valid state, only marker |
|
76 |
}; |
|
77 |
||
78 |
/** |
|
79 |
* Flags for ongoing operations |
|
80 |
*/ |
|
81 |
enum TCamBusyFlags |
|
82 |
{ |
|
83 |
EBusyNone = 0, |
|
84 |
EBusyRequest = 1<<0, |
|
85 |
EBusySequence = 1<<1, |
|
86 |
EBusySetting = 1<<2, |
|
87 |
EBusyLast // Marker |
|
88 |
}; |
|
89 |
||
90 |
enum TCamHdmiEvent |
|
91 |
{ |
|
92 |
ECamHdmiNoEvent, |
|
93 |
ECamHdmiCableConnectedBeforeRecording, |
|
94 |
ECamHdmiCableConnectedDuringRecording |
|
95 |
}; |
|
96 |
||
97 |
// =========================================================================== |
|
98 |
// FORWARD DECLARATIONS |
|
99 |
class CRepository; |
|
100 |
//class CCamSettingsModelBase; |
|
101 |
class MCamAppController; |
|
102 |
class MCamSettingsModel; |
|
103 |
class MCamSettingPreviewHandler; // <CAMERAAPP_CAPI_V2_MIGRATION/> |
|
104 |
//class CCamConstantSettingProvider; // <CAMERAAPP_CAPI_V2_MIGRATION/> |
|
105 |
class CCamSettingProvider; // <CAMERAAPP_CAPI_V2_MIGRATION/> |
|
106 |
class CCamTimer; |
|
107 |
class CCamObserverHandler; |
|
108 |
class CCamBurstCaptureArray; |
|
109 |
class CCamAudioPlayerController; |
|
110 |
class MCamStaticSettings; |
|
111 |
class CCamGSInterface; |
|
112 |
class CCameraUiConfigManager; |
|
113 |
class CCamPropertyWatcher; |
|
114 |
class CCamSnapShotRotator; |
|
115 |
||
116 |
||
117 |
class CCamFlashStatus; |
|
118 |
class CCamConfiguration; |
|
119 |
class CCFClient; |
|
120 |
||
121 |
// =========================================================================== |
|
122 |
// CLASS DECLARATION |
|
123 |
||
124 |
class TCamAppControllerInfo |
|
125 |
{ |
|
126 |
public: |
|
127 |
TCamAppControllerInfo(); |
|
128 |
||
129 |
public: |
|
130 |
TCamActiveCamera iActiveCamera; |
|
131 |
||
132 |
TCamCameraMode iMode; |
|
133 |
TCamCameraMode iTargetMode; |
|
134 |
||
135 |
TCamImageCaptureMode iImageMode; // ECamImageCaptureNone in video controller mode |
|
136 |
TCamImageCaptureMode iTargetImageMode; |
|
137 |
||
138 |
TCamCaptureOperation iOperation; // Current operation |
|
139 |
||
140 |
// Target viewfinder state and mode |
|
141 |
TCamCameraTriState iTargetVfState; |
|
142 |
TBool iViewfinderMirror; // set when viewfinder initialized |
|
143 |
||
144 |
// Target image parameters |
|
145 |
TInt iTargetImageResolution; |
|
146 |
TInt iTargetImageQuality; |
|
147 |
||
148 |
// Target video parameters |
|
149 |
/** not supported yet */ |
|
150 |
||
151 |
// Request being handled |
|
152 |
TCamCameraRequestId iBusyRequestId; |
|
153 |
}; |
|
154 |
||
155 |
||
156 |
/** |
|
157 |
* Handle intercommunication between camcorder UI and engine. |
|
158 |
* |
|
159 |
* @since 2.8 |
|
160 |
*/ |
|
161 |
class CCamAppController : public CBase, |
|
162 |
public MCamAppController, |
|
163 |
public MCamSettingsModelObserver, |
|
164 |
public MCamCameraObserver, |
|
165 |
public MCamImageSaveObserver, |
|
166 |
public MCamCallStateObserver, |
|
167 |
public MPropertyObserver, |
|
168 |
public MSensrvDataListener, |
|
169 |
public MCamPlayerObserver, |
|
170 |
public MCamObserver, |
|
171 |
public MCamBurstModeObserver, |
|
172 |
public MCFListener |
|
173 |
,public MCamDriveChangeNotifierObserver |
|
174 |
,public MBitmapRotationObserver, |
|
175 |
public MCamTvAccessoryObserver |
|
176 |
||
177 |
{ |
|
178 |
public: // Constructors and destructor |
|
179 |
||
180 |
/** |
|
181 |
* Two-phased constructor. |
|
182 |
* @since 2.8 |
|
183 |
* @return pointer to the created CCamAppController object |
|
184 |
*/ |
|
185 |
static CCamAppController* NewL(); |
|
186 |
||
187 |
||
188 |
/** |
|
189 |
* Complete construction of the engine and issue notification requests. |
|
190 |
* The camera engine cannot be instantiated until the application |
|
191 |
* orientation has been set by the CCamAppUi. This does not |
|
192 |
* exist when the CCamAppController is constructed. CompleteConstructionL |
|
193 |
* must be called in the CCamAppUi::ConstructL() |
|
194 |
* @since 3.0 |
|
195 |
*/ |
|
196 |
void CompleteConstructionL(); |
|
197 |
||
198 |
||
199 |
/** |
|
200 |
* Destructor. |
|
201 |
* @since 2.8 |
|
202 |
*/ |
|
203 |
virtual ~CCamAppController(); |
|
204 |
||
205 |
public: |
|
206 |
/** |
|
207 |
* Calls CamSettingModel to save user defined FT setting |
|
208 |
* @since S60 5.0 |
|
209 |
* @param None |
|
210 |
* @return None |
|
211 |
*/ |
|
212 |
void StoreFaceTrackingValue(); |
|
213 |
||
214 |
// ------------------------------------------------------- |
|
215 |
// From MCamCameraObserver |
|
216 |
public: |
|
217 |
||
218 |
virtual void HandleCameraEventL( TInt aStatus, |
|
219 |
TCamCameraEventId aEventId, |
|
220 |
TAny* aEventData /*= NULL*/ ); |
|
221 |
||
222 |
||
223 |
||
224 |
// ------------------------------------------------------- |
|
225 |
// from MCamSettingsModelObserver |
|
226 |
public: |
|
227 |
||
228 |
virtual void IntSettingChangedL( TCamSettingItemIds aSettingItem, |
|
229 |
TInt aSettingValue ); |
|
230 |
virtual void TextSettingChangedL( TCamSettingItemIds aSettingItem, |
|
231 |
const TDesC& aSettingValue ); |
|
232 |
||
233 |
||
234 |
// ------------------------------------------------------- |
|
235 |
// from MCamBurstModeObserver |
|
236 |
||
237 |
/** |
|
238 |
* Burst mode activation has changed |
|
239 |
* @since 2.8 |
|
240 |
* @param aActive whether or not burst mode is active |
|
241 |
* @param aStillModeActive whether or not still capture is active |
|
242 |
*/ |
|
243 |
virtual void BurstModeActiveL( TBool aActive, TBool aStillModeActive ); |
|
244 |
||
245 |
// ------------------------------------------------------- |
|
246 |
// from MCamAudioPlayerObserver |
|
247 |
virtual void PlayComplete( TInt aStatus, TInt aSoundId ); |
|
248 |
||
249 |
||
250 |
// ------------------------------------------------------- |
|
251 |
public: |
|
252 |
// From MCFListener ( Context framework for publishing zoom state. |
|
253 |
/** |
|
254 |
* Indicates a change in context for subscribed clients. |
|
255 |
* If client has subscribed to partial context class path, |
|
256 |
* only the changed context will be indicated. |
|
257 |
* |
|
258 |
* @since S60 4.0 |
|
259 |
* @param aIndication: Context indication. |
|
260 |
* @return None |
|
261 |
*/ |
|
262 |
inline void ContextIndicationL( |
|
263 |
const CCFContextIndication& /*aChangedContext*/ ) {}; |
|
264 |
||
265 |
/** |
|
266 |
* Indicates that specified action is needed to be executed. |
|
267 |
* When action indication is received certain rule has been triggered |
|
268 |
* and action is needed to be performed. |
|
269 |
* |
|
270 |
* @since S60 4.0 |
|
271 |
* @param aActionToExecute Action indication. |
|
272 |
* @return None |
|
273 |
*/ |
|
274 |
inline void ActionIndicationL( |
|
275 |
const CCFActionIndication& /*aActionToExecute*/ ) {}; |
|
276 |
||
277 |
/** |
|
278 |
* Indicates that error has occured. |
|
279 |
* @since S60 4.0 |
|
280 |
* @param aError Error code. |
|
281 |
* @return None |
|
282 |
*/ |
|
283 |
inline void HandleContextFrameworkError( TCFError /*aError*/, |
|
284 |
const TDesC& /*aSource*/, |
|
285 |
const TDesC& /*aType*/ ){}; |
|
286 |
||
287 |
/** |
|
288 |
* Returns an extension interface. |
|
289 |
* The extension interface is mapped with the extension UID. |
|
290 |
* |
|
291 |
* If the client does not support the requested interface, |
|
292 |
* client must return NULL. Otherwise client needs to return |
|
293 |
* the correct interface combined with the UID. |
|
294 |
* |
|
295 |
* @since S60 5.0 |
|
296 |
* @param aExtensionUid: The identifier of the extension. |
|
297 |
* @return Pointer to the extension. |
|
298 |
*/ |
|
299 |
inline TAny* Extension( const TUid& /*aExtensionUid*/ ) const { return NULL; }; |
|
300 |
||
301 |
// New Function |
|
302 |
||
303 |
/* |
|
304 |
* Method to publish the zoom key and setting the |
|
305 |
* value or the state to enabled or disabled. |
|
306 |
* @Paran aEnabled used to set the the state of zoom key |
|
307 |
* to be enabled or disabled. |
|
308 |
*/ |
|
309 |
void PublishZoomStateL( const TBool aEnabled ); |
|
310 |
||
311 |
public: |
|
312 |
||
313 |
/** |
|
314 |
* Returns whether or not the current profile is silent |
|
315 |
* @since 3.0 |
|
316 |
* @return ETrue if current profile is silent |
|
317 |
*/ |
|
318 |
TBool IsProfileSilent(); |
|
319 |
||
320 |
/** |
|
321 |
* Returns whether or not we have touch screen support in the device |
|
322 |
* @return ETrue if device supports touch screen |
|
323 |
*/ |
|
324 |
TBool IsTouchScreenSupported(); |
|
325 |
||
326 |
/** |
|
327 |
* Returns whether or not we have direct screen viewfinder support in the device |
|
328 |
* @return ETrue if device supports direct screen viewfinder |
|
329 |
*/ |
|
330 |
TBool IsDirectScreenVFSupported( TBool aPrimaryCamera = ETrue ); |
|
331 |
||
332 |
// --------------------------------------------------------------------------- |
|
333 |
//Helper function for making notification about deleted files |
|
334 |
//Added this method to do notification if files have been |
|
335 |
//deleted outside camera application and then camera is |
|
336 |
//put back to foreground in postcapture view. |
|
337 |
//Security note. Contents of the files might have been |
|
338 |
//changed when camera was in background. |
|
339 |
// --------------------------------------------------------------------------- |
|
340 |
// |
|
341 |
void MediaFileChangedNotification(); |
|
342 |
||
343 |
TBool EngineRequestsPending() const; |
|
344 |
/** |
|
345 |
* Set settings restore to be done at earliest |
|
346 |
* convenient time. |
|
347 |
*/ |
|
348 |
void SetSettingsRestoreNeeded(); |
|
349 |
||
350 |
/** |
|
351 |
* Set the flag to indicate that the original values |
|
352 |
* of remaining images is stored |
|
353 |
*/ |
|
354 |
void SetRemainingImageStored(); |
|
355 |
||
356 |
/** |
|
357 |
* Returns the flag that indicates if the original value |
|
358 |
* of remaing images is stored or not. |
|
359 |
*/ |
|
360 |
TBool IsRemainingImageStored() const; |
|
361 |
||
362 |
/** |
|
363 |
* Return whether saving is still in progress. |
|
364 |
*/ |
|
365 |
TBool IsSavingInProgress() const; |
|
67
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
366 |
|
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
367 |
/** |
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
368 |
* Return whether snapshot rotation is still active. |
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
369 |
*/ |
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
370 |
TBool IsRotationActive() const; |
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
371 |
|
54 | 372 |
/** |
373 |
* Return if settings restore is set pending. |
|
374 |
*/ |
|
375 |
TBool IsSettingsRestoreNeeded() const; |
|
376 |
||
377 |
||
378 |
void RestartTimeLapseTimerL(); |
|
379 |
||
380 |
||
381 |
static TInt CamerasAvailable(); |
|
382 |
||
383 |
/** |
|
384 |
* Is time lapse supported. |
|
385 |
* Value read from Central Repository. |
|
386 |
*/ |
|
387 |
TBool TimeLapseSupported(); |
|
388 |
||
389 |
/** |
|
390 |
* Is time lapse supported. |
|
391 |
* Value read from Central Repository. |
|
392 |
*/ |
|
393 |
TBool AlwaysOnSupported(); |
|
394 |
||
395 |
/** |
|
396 |
* Release version number. |
|
397 |
* Value read from Central Repository. |
|
398 |
*/ |
|
399 |
const TVersion& Version(); |
|
400 |
||
401 |
/*** |
|
402 |
* Can a new request be made to controller or not. |
|
403 |
* Shutdown may be requested at any moment. |
|
404 |
*/ |
|
405 |
TBool Busy() const; |
|
406 |
||
407 |
/** |
|
408 |
* Returns true if the last captured image was saved |
|
409 |
* @since 2.8 |
|
410 |
* @return ETrue if the last captured image has been saved. |
|
411 |
*/ |
|
412 |
TBool SavedCurrentImage() const; |
|
413 |
||
414 |
/** |
|
415 |
* Rename image/video. |
|
416 |
* @since 2.8 |
|
417 |
* @param aNewName the new name for the current capture array file. |
|
418 |
* @param aMode the current capture mode. |
|
419 |
* @return ETrue if the file has been renamed successfully. |
|
420 |
*/ |
|
421 |
TBool RenameCurrentFileL( const TDesC& aNewName, |
|
422 |
const TCamCameraMode& aMode ); |
|
423 |
||
424 |
/** |
|
425 |
* Add a controller observer. |
|
426 |
* @since 2.8 |
|
427 |
* @param aObserver Pointer to an object implementing |
|
428 |
* MCamControllerObserver |
|
429 |
* @return ?description |
|
430 |
*/ |
|
431 |
void AddControllerObserverL( const MCamControllerObserver* aObserver ); |
|
432 |
||
433 |
/** |
|
434 |
* Remove a controller observer |
|
435 |
* @since 2.8 |
|
436 |
* @param aObserver Pointer to the observer to remove. The object |
|
437 |
* does not have to be added as an observer. |
|
438 |
*/ |
|
439 |
void RemoveControllerObserver |
|
440 |
( const MCamControllerObserver* aObserver ); |
|
441 |
||
442 |
/** |
|
443 |
* Add camera observer. |
|
444 |
* Forwards call to CCamCameraController. |
|
445 |
* @see CCamCameraController for more details. |
|
446 |
*/ |
|
447 |
void AddCameraObserverL( const MCamCameraObserver* aObserver, |
|
448 |
const TUint& aEventInterest ); |
|
449 |
||
450 |
/** |
|
451 |
* Removes camera observer. |
|
452 |
* Forwards call to CCamCameraController. |
|
453 |
* @see CCamCameraController for more details. |
|
454 |
*/ |
|
455 |
void RemoveCameraObserver( const MCamCameraObserver* aObserver ); |
|
456 |
||
457 |
void AddSettingsObserverL( const MCamSettingsModelObserver* aObserver ); |
|
458 |
void RemoveSettingsObserver( const MCamSettingsModelObserver* aObserver ); |
|
459 |
||
460 |
TBool CameraControllerBusy() const; |
|
461 |
TUint CameraControllerState() const; |
|
462 |
||
463 |
TCamCameraState CameraState() const; |
|
464 |
TCamCameraMode CurrentMode() const; |
|
465 |
TCamCameraMode TargetMode() const; |
|
466 |
TCamImageCaptureMode CurrentImageModeSetup() const; |
|
467 |
TCamCaptureOperation CurrentOperation() const; |
|
468 |
TCamCaptureOperation CurrentImageOperation() const; |
|
469 |
TCamCaptureOperation CurrentVideoOperation() const; |
|
470 |
TCamImageCaptureMode CurrentImageMode() const; |
|
471 |
||
472 |
||
473 |
TInt CaptureLimit() const; |
|
474 |
TInt CaptureLimitSetting() const; |
|
475 |
void SetCaptureLimitL( TInt aLimit ); |
|
476 |
||
477 |
/** |
|
478 |
* From MBitmapRotationObserver |
|
479 |
* Notification of bitmap rotation complete events |
|
480 |
* @param aErr KErrNone if successful |
|
481 |
*/ |
|
482 |
void RotationCompleteL( TInt aErr ); |
|
483 |
||
484 |
/** |
|
485 |
* From MCamTvaccessoryObserver |
|
486 |
* Handles TV Out/HDMI Cable connect Events |
|
487 |
*/ |
|
488 |
void HandleTvAccessoryConnectedL(); |
|
489 |
||
490 |
/** |
|
491 |
* From MCamTvaccessoryObserver |
|
492 |
* Handles TV Out/HDMI Cable disconnect Events |
|
493 |
*/ |
|
494 |
void HandleTvAccessoryDisconnectedL(); |
|
495 |
||
496 |
||
497 |
/** |
|
498 |
* Returns Etrue if HDMI Cable is connected |
|
499 |
*/ |
|
500 |
TBool IsHdmiCableConnected(); |
|
501 |
||
502 |
||
503 |
/** |
|
504 |
* Called when exiting in secondary camera mode |
|
505 |
*/ |
|
506 |
void HandleSecondaryCameraExitL(); |
|
507 |
||
508 |
private: |
|
509 |
void ReadVariantFlagsL(); |
|
510 |
||
511 |
||
512 |
void SetMode( const TCamCameraMode& aNewMode ); |
|
513 |
void SetTargetMode( const TCamCameraMode& aNewMode ); |
|
514 |
||
515 |
void SetImageMode( const TCamImageCaptureMode& aNewMode ); |
|
516 |
void SetTargetImageMode( const TCamImageCaptureMode& aNewMode ); |
|
517 |
||
518 |
void SetOperation( TCamCaptureOperation aNewOperation, |
|
519 |
TInt aError = KErrNone ); |
|
520 |
||
521 |
TCamCameraTriState ViewfinderTargetState() const; |
|
522 |
||
523 |
||
524 |
public: |
|
525 |
/* |
|
526 |
* Handle to Camera Ui Config Manager |
|
527 |
*/ |
|
528 |
CCameraUiConfigManager* UiConfigManagerPtr(); |
|
529 |
||
530 |
/* |
|
531 |
* De-register harvester client events. |
|
532 |
*/ |
|
533 |
void DeRegisterHarverterClientEvents(); |
|
534 |
||
535 |
/** |
|
536 |
* Return resource id for video viewfinder layout |
|
537 |
* @since 3.0 |
|
538 |
* @param aResolution for current resolution |
|
539 |
* @return Resource id for video viewfinder layout |
|
540 |
*/ |
|
541 |
TInt VideoViewFinderResourceId( TCamVideoResolution aResolution ); |
|
542 |
||
543 |
/** |
|
544 |
* Start the viewfinder for the specified mode |
|
545 |
* as soon as the engine is intialised |
|
546 |
* @since 2.8 |
|
547 |
* @param aMode The viewfinder mode being entered |
|
548 |
*/ |
|
549 |
void EnterViewfinderMode( const TCamCameraMode& aMode ); |
|
550 |
||
551 |
/** |
|
552 |
* ExitViewinderMode |
|
553 |
* @since 2.8 |
|
554 |
* @param aMode The viewfinder mode being exited |
|
555 |
*/ |
|
556 |
void ExitViewfinderMode( const TCamCameraMode& aMode ); |
|
557 |
||
558 |
/** |
|
559 |
* FreezeViewFinder |
|
560 |
* @since 2.8 |
|
561 |
* @param aFreeze Whether or not the viewfinder is |
|
562 |
* being frozen after this frame |
|
563 |
*/ |
|
564 |
void FreezeViewFinder( TBool aFreeze ); |
|
565 |
||
566 |
/** |
|
567 |
* Return number of images that can still be captured |
|
568 |
* @since 2.8 |
|
569 |
* @param aStorage storage location - defaults to current loation |
|
570 |
* @param aBurstActive - set to ETrue if burst mode is active |
|
571 |
* @return the number of images |
|
572 |
*/ |
|
573 |
TInt ImagesRemaining( TCamMediaStorage aStorage, |
|
574 |
TBool aBurstActive ); |
|
575 |
||
576 |
/** |
|
577 |
* Return number of images that can still be captured for a particular |
|
578 |
* image quality |
|
579 |
* @since 2.8 |
|
580 |
* @param aStorage storage location - defaults to current loation |
|
581 |
* @param aBurstActive - set to ETrue if burst mode is active |
|
582 |
* @param aQualityIndex - index of the image quality |
|
583 |
* @return the number of images |
|
584 |
*/ |
|
585 |
TInt ImagesRemaining( TCamMediaStorage aStorage, |
|
586 |
TBool aBurstActive, |
|
587 |
TInt aQualityIndex ); |
|
588 |
||
589 |
/** |
|
590 |
* Return amount of video that has been captured |
|
591 |
* @since 2.8 |
|
592 |
* @return the amount of video in micro secs |
|
593 |
*/ |
|
594 |
TTimeIntervalMicroSeconds RecordTimeElapsed() const; |
|
595 |
||
596 |
||
597 |
/** |
|
598 |
* Set amount of video that has been captured |
|
599 |
* @param aElapsed - recorded video time. |
|
600 |
*/ |
|
601 |
void RecordTimeElapsed(TTimeIntervalMicroSeconds aElapsed ); |
|
602 |
||
603 |
||
604 |
/* |
|
605 |
* Return amount of video that can still be captured |
|
606 |
* @since 2.8 |
|
607 |
* @return the amount of video in secs |
|
608 |
*/ |
|
609 |
TTimeIntervalMicroSeconds RecordTimeRemaining(); |
|
610 |
||
611 |
/** |
|
612 |
* Updates the interval used in next TimeLapse capture |
|
613 |
* @since 3.0 |
|
614 |
* @param aInterval The new interval to use |
|
615 |
*/ |
|
616 |
void SetTimeLapseInterval( TTimeIntervalMicroSeconds aInterval ); |
|
617 |
||
618 |
/** |
|
619 |
* Returns the interval used in next TimeLapse capture |
|
620 |
* @since 3.0 |
|
621 |
* @return The current time lapse interval in microseconds |
|
622 |
*/ |
|
623 |
TTimeIntervalMicroSeconds TimeLapseInterval(); |
|
624 |
||
625 |
/** |
|
626 |
* Returns the remaining time lapse interval until the next capture |
|
627 |
* @since 3.0 |
|
628 |
* @return The remaining time to the next timelapse capture |
|
629 |
*/ |
|
630 |
TTimeIntervalMicroSeconds TimeLapseCountdown(); |
|
631 |
||
632 |
/** |
|
633 |
* Start the autofocus procedure |
|
634 |
* @since 2.8 |
|
635 |
*/ |
|
636 |
void StartAutoFocus(); |
|
637 |
||
638 |
/** |
|
639 |
* Begin the capture procedure |
|
640 |
* @since 2.8 |
|
641 |
*/ |
|
642 |
void Capture(); |
|
643 |
||
644 |
/** |
|
645 |
* Stop the burst capture operation |
|
646 |
* @since 2.8 |
|
647 |
*/ |
|
648 |
void StopSequenceCaptureL(); |
|
649 |
||
650 |
/** |
|
651 |
* Whether or not a still capture operation is pending |
|
652 |
* i.e. a request to start still capture has been made and is |
|
653 |
* waiting for the focus operation to complete. |
|
654 |
* @since 2.8 |
|
655 |
* @return ETrue if a still capture operation is pending |
|
656 |
*/ |
|
657 |
TBool CapturePending() const; |
|
658 |
||
659 |
/** |
|
660 |
* Whether or not a capture key pressed during image saving |
|
661 |
* @since 2.8 |
|
662 |
* @return ETrue if capture key is pressed during image saving |
|
663 |
*/ |
|
664 |
TBool CaptureKeyPressedWhileImageSaving() const; |
|
665 |
||
666 |
/** |
|
667 |
* Stores shutter key press during saving image |
|
668 |
* @since 2.8 |
|
669 |
*/ |
|
670 |
void SetCaptureKeyPressedWhileImageSaving(TBool aCaptureKeyPressed); |
|
671 |
||
672 |
/** |
|
673 |
* Whether or not a video recording operation is pending |
|
674 |
* i.e. a request to start video recording has been made and is |
|
675 |
* waiting for the engine to complete a video name update operation. |
|
676 |
* @since 2.8 |
|
677 |
* @return ETrue if a record operation is pending |
|
678 |
*/ |
|
679 |
TBool VideoRecordPending() const; |
|
680 |
||
681 |
/** |
|
682 |
* Whether or not a sequence capture is in progress |
|
683 |
* @since 2.8 |
|
684 |
* @return ETrue if a sequence capture is in progress |
|
685 |
*/ |
|
686 |
TBool SequenceCaptureInProgress() const; |
|
687 |
||
688 |
/** |
|
689 |
* Begin the recording procedure |
|
690 |
* @since 2.8 |
|
691 |
*/ |
|
692 |
void StartVideoRecordingL(); |
|
693 |
||
694 |
/** |
|
695 |
* End the recording procedure |
|
696 |
* @since 2.8 |
|
697 |
*/ |
|
698 |
void StopVideoRecording(); |
|
699 |
||
700 |
/** |
|
701 |
* End the recording procedure |
|
702 |
* @since 5.0 |
|
703 |
*/ |
|
704 |
void StopVideoRecordingAsync(); |
|
705 |
||
706 |
/** |
|
707 |
* Store the cause of the video stop |
|
708 |
* @since 3.0 |
|
709 |
*/ |
|
710 |
void SetVideoStoppedForPhoneApp( TBool aIsPhoneApp ); |
|
711 |
||
712 |
/** |
|
713 |
* Pause the recording procedure |
|
714 |
* @since 2.8 |
|
715 |
*/ |
|
716 |
void PauseVideoRecording(); |
|
717 |
||
718 |
/** |
|
719 |
* Continue the recording procedure |
|
720 |
* @since 2.8 |
|
721 |
*/ |
|
722 |
void ContinueVideoRecording(); |
|
723 |
||
724 |
/** |
|
725 |
* Issue AF request. |
|
726 |
*/ |
|
727 |
TBool TryAFRequest( TInt aAFRequest ); |
|
728 |
||
729 |
/** |
|
730 |
* Cancel ongoing AutoFocus. |
|
731 |
*/ |
|
732 |
void CancelAFNow(); |
|
733 |
||
734 |
/** |
|
735 |
* Cancel a requested capture |
|
736 |
* @since 2.8 |
|
737 |
*/ |
|
738 |
void CancelFocusAndCapture(); |
|
739 |
||
740 |
/** |
|
741 |
* Return the current snapshot image |
|
742 |
* @since 2.8 |
|
743 |
* @return the current snapshot image |
|
744 |
*/ |
|
745 |
const CFbsBitmap* SnapshotImage(); |
|
746 |
||
747 |
/** |
|
748 |
* Sets the specified burst mode item as the current image, in |
|
749 |
* preparation for a Post-capture view of the image. |
|
750 |
* @since 2.8 |
|
751 |
* @param aIndex The index of the burst item in "CCamBurstCaptureArray" |
|
752 |
*/ |
|
753 |
void SetAsCurrentImage( TInt aIndex ); |
|
754 |
||
755 |
/** |
|
756 |
* Get the user-visible name for next image. |
|
757 |
* @since 2.8 |
|
758 |
* @return file name for the current image or video without path or |
|
759 |
* extension |
|
760 |
*/ |
|
761 |
const TDesC& CurrentImageName() const; |
|
762 |
||
763 |
/** |
|
764 |
* Delete the current image/video file |
|
765 |
* @since 2.8 |
|
766 |
* @param aNofity Should notification be sent to observers about |
|
767 |
* change in media files. When this call is made |
|
768 |
* several times in a row, it's worth to do the |
|
769 |
* notification only once. |
|
770 |
* @return KErrNone if delete successful, otherwise system-wide |
|
771 |
* error code |
|
772 |
*/ |
|
773 |
TInt DeleteCurrentFile( TBool aNotify = ETrue ); |
|
774 |
||
775 |
/** |
|
776 |
* Delete the timelapse sequence files |
|
777 |
* @since 3.0 |
|
778 |
*/ |
|
779 |
void DeleteTimeLapseFiles(); |
|
780 |
||
781 |
/** |
|
782 |
* Indicate whether or not the controller is actively engaged in still |
|
783 |
* or video capture - this includes paused video, saving photos/videos, |
|
784 |
* periods in between timelapse captures and pending captures |
|
785 |
* (captures that have been requested but not yet started) |
|
786 |
* @since 3.0 |
|
787 |
* @return EFalse if not currently capturing, otherwise ETrue |
|
788 |
*/ |
|
789 |
TBool IsProcessingCapture(); |
|
790 |
||
791 |
/** |
|
792 |
* Complete current capture asap, then report completion to the observer |
|
793 |
* @since 3.0 |
|
794 |
* @param aObserver To be notified when the current capture process completes |
|
795 |
* @param aSafeCompletion ETrue if all captures should be saved. EFalse to complete |
|
796 |
* sooner and lose any images that have not yet begun to save |
|
797 |
*/ |
|
798 |
void CompleteCaptureAndNotifyL( MCamObserver* aObserver, TBool aSafeCompletion ); |
|
799 |
||
800 |
/** |
|
801 |
* The application is closing. Complete any active operations then |
|
802 |
* exit the application. |
|
803 |
* @param aImmediateShutdown ETrue: shutdown immediately or |
|
804 |
* EFalse: wait for pending operations to complete. |
|
805 |
* @since 2.8 |
|
806 |
*/ |
|
807 |
void EnterShutdownMode( TBool aImmediateShutdown ); |
|
808 |
||
809 |
/** |
|
810 |
* Whether or not the controller is in shutdown mode |
|
811 |
* @since 2.8 |
|
812 |
* @return ETrue if the controller is in shutdown mode else EFalse |
|
813 |
*/ |
|
814 |
TBool IsInShutdownMode() const; |
|
815 |
||
816 |
/** |
|
817 |
* Returns true if AppUi has been constructed, and not yet |
|
818 |
* destructed. |
|
819 |
*/ |
|
820 |
TBool IsAppUiAvailable() const; |
|
821 |
||
822 |
/** |
|
823 |
* Sets AppUi availablility (see IsAppUiAvailable()) |
|
824 |
*/ |
|
825 |
void SetAppUiAvailable( TBool aAvailable ); |
|
826 |
||
827 |
||
828 |
/** |
|
829 |
* Called to return the range of supported zoom values |
|
830 |
* @since 2.8 |
|
831 |
* @param aMinZoom on return contains the minimum zoom value |
|
832 |
* @param aMaxZoom on return contains the maximum zoom value |
|
833 |
*/ |
|
834 |
void GetZoomRange( TInt& aMinZoom, TInt& aMaxZoom ) const; |
|
835 |
||
836 |
/** |
|
837 |
* Called to return current zoom value |
|
838 |
* @since 2.8 |
|
839 |
* @return the current zoom value |
|
840 |
*/ |
|
841 |
TInt ZoomValue() const; |
|
842 |
||
843 |
/** |
|
844 |
* Sets the current zoom value |
|
845 |
* @since 2.8 |
|
846 |
* @param aValue the new zoom value to be used |
|
847 |
*/ |
|
848 |
void SetZoomValue( TInt aValue ); |
|
849 |
||
850 |
/** |
|
851 |
* Resets all user scene settings to their defaults. |
|
852 |
* @since 2.8 |
|
853 |
*/ |
|
854 |
void ResetUserSceneL(); |
|
855 |
||
856 |
/** |
|
857 |
* Previews a new value for the specified integer setting |
|
858 |
* @param aSettingItem specifies which setting item that want |
|
859 |
* to preview. |
|
860 |
* @param aSettingValue the new integer value for the specified |
|
861 |
* setting item to be previewed. |
|
862 |
* @since 2.8 |
|
863 |
*/ |
|
864 |
void PreviewSettingChangeL( TInt aSettingItem, TInt aSettingValue ); |
|
865 |
||
866 |
/** |
|
867 |
* Cancels all preview changes, since last commit/cancel. |
|
868 |
* @since 2.8 |
|
869 |
*/ |
|
870 |
void CancelPreviewChangesL(); |
|
871 |
||
872 |
/** |
|
873 |
* Commits last preview change. |
|
874 |
* @since 2.8 |
|
875 |
*/ |
|
876 |
void CommitPreviewChanges(); |
|
877 |
||
878 |
/** |
|
879 |
* Re-prepare video after e.g. a setting change requires this. |
|
880 |
*/ |
|
881 |
void RePrepareVideoL(); |
|
882 |
||
883 |
/** |
|
884 |
* Returns the current integer value for the specified setting |
|
885 |
* @return the current integer setting value |
|
886 |
* @param aSettingItem specifies which setting item that want |
|
887 |
* the value of. |
|
888 |
* @since 2.8 |
|
889 |
*/ |
|
890 |
TInt IntegerSettingValue( TInt aSettingItem ) const; |
|
891 |
||
892 |
/** |
|
893 |
* Returns the current integer value for the specified setting |
|
894 |
* without the filtering usually performed on storage location. |
|
895 |
* This is neccesary to allow the video/photo settings list to show |
|
896 |
* the selected storage location rather than the forced storage location. |
|
897 |
* @return the current integer setting value |
|
898 |
* @param aSettingItem specifies which setting item that want the value of. |
|
899 |
* @since 2.8 |
|
900 |
*/ |
|
901 |
TInt IntegerSettingValueUnfiltered( TInt aSettingItem ) const; |
|
902 |
||
903 |
/** |
|
904 |
* Sets a new value for the specified integer setting |
|
905 |
* @param aSettingItem specifies which setting item that want |
|
906 |
* to set the value of. |
|
907 |
* @param aSettingValue the new integer value for the specified |
|
908 |
* setting item. |
|
909 |
* @since 2.8 |
|
910 |
*/ |
|
911 |
void SetIntegerSettingValueL( TInt aSettingItem, TInt aSettingValue ); |
|
912 |
||
913 |
/** |
|
914 |
* Sets pathnames for video and image files to point to the specified storage |
|
915 |
* @param aMediaStorage specifies phone memory or MMC |
|
916 |
* @since 2.8 |
|
917 |
*/ |
|
918 |
void SetPathnamesToNewStorageL( TCamMediaStorage aMediaStorage ); |
|
919 |
||
920 |
/** |
|
921 |
* Sets a new text value for the specified setting |
|
922 |
* @param aSettingItem specifies which setting item that want to set |
|
923 |
* the text value of. |
|
924 |
* @param aSettingValue the new text value for the specified setting |
|
925 |
* item. |
|
926 |
* @since 2.8 |
|
927 |
*/ |
|
928 |
void SetTextSettingValueL( TInt aSettingItem, |
|
929 |
const TDesC& aSettingValue ); |
|
930 |
||
931 |
||
932 |
/** |
|
933 |
* Returns the current text value for the specified setting |
|
934 |
* @return the current text setting value |
|
935 |
* @param aSettingItem specifies which setting item that want |
|
936 |
* the text value of. |
|
937 |
* @since 2.8 |
|
938 |
*/ |
|
939 |
TPtrC TextSettingValue( TInt aSettingItem ) const; |
|
940 |
||
941 |
/** |
|
942 |
* Returns whether a particular setting value can be set or not. |
|
943 |
* @return ETrue if can be set. Otherwise, EFalse. |
|
944 |
* @param aSettingItem the setting item in question. |
|
945 |
* @param aSettingValue the value in question. |
|
946 |
* @since 2.8 |
|
947 |
*/ |
|
948 |
TBool SettingValueEnabled( TInt aSettingItem, TInt aSettingValue ) const; |
|
949 |
||
950 |
/** |
|
951 |
* Loads the settings from shared data, or if unable to from the |
|
952 |
* resource file. |
|
953 |
* @param aIsEmbedded whether or not the application is running in |
|
954 |
* embedded mode. |
|
955 |
* @since 2.8 |
|
956 |
*/ |
|
957 |
void LoadStaticSettingsL( TBool aIsEmbedded ); |
|
958 |
||
959 |
/** |
|
960 |
* Get the default value for a setting item. |
|
961 |
* @param aSettingId The id of the setting. |
|
962 |
* @return The default value for setting item or KErrNotFound if not found. |
|
963 |
*/ |
|
964 |
TInt DynamicSettingDefaultValue( TInt aSettingId ) const; |
|
965 |
||
966 |
/** |
|
967 |
* Sets all dynamic settings to their defaults. |
|
968 |
* @since 2.8 |
|
969 |
*/ |
|
970 |
void SetDynamicSettingsToDefaults(); |
|
971 |
||
972 |
/** |
|
973 |
* Sets a single dynamic setting to its default. |
|
974 |
* @since 2.8 |
|
975 |
*/ |
|
976 |
void SetDynamicSettingToDefault(TInt aSettingItem); |
|
977 |
||
978 |
/** |
|
979 |
* Set scene default value to a dynamic setting. |
|
980 |
* @param aSceneId Id of the scene to use. |
|
981 |
* @param aSceneField Id of scene field. |
|
982 |
* @param aSettingId If of the dynamic setting to set. |
|
983 |
* @param aVideoScene Does aSceneId refer to a video scene. |
|
984 |
* @return KErrNotFound, if setting could not be set. |
|
985 |
*/ |
|
986 |
TInt SetDynamicSettingToSceneDefaultL( TInt aSceneId, |
|
987 |
TInt aSceneField, |
|
988 |
TInt aSettingId, |
|
989 |
TBool aVideoScene ); |
|
990 |
||
991 |
||
992 |
#ifdef PRODUCT_USES_GENERIC_SETUP_INDICATOR |
|
993 |
/** |
|
994 |
* Returns whether or not the video setup settings are set to the |
|
995 |
* defaults for its current scene. |
|
996 |
* @since 2.8 |
|
997 |
* @return ETrue if set to defaults. Otherwise, EFalse |
|
998 |
*/ |
|
999 |
TBool VideoSceneDefaultsAreSet(); |
|
1000 |
||
1001 |
/** |
|
1002 |
* Returns whether or not the photo setup settings are set to the |
|
1003 |
* defaults for its current scene. |
|
1004 |
* @since 2.8 |
|
1005 |
* @return ETrue if set to defaults. Otherwise, EFalse |
|
1006 |
*/ |
|
1007 |
TBool PhotoSceneDefaultsAreSet(); |
|
1008 |
#endif // PRODUCT_USES_GENERIC_SETUP_INDICATOR |
|
1009 |
||
1010 |
/** |
|
1011 |
* Returns the file name of the most recent saved image/video clip |
|
1012 |
* @return Filename of most recent captured image/video |
|
1013 |
* @since 2.8 |
|
1014 |
*/ |
|
1015 |
const TDesC& CurrentFullFileName() const; |
|
1016 |
||
1017 |
/** |
|
1018 |
* Get the current video filename. |
|
1019 |
*/ |
|
1020 |
const TDesC& CurrentVideoFileName() const; |
|
1021 |
||
1022 |
/** |
|
1023 |
* Returns a pointer to an array representing the images in a burst |
|
1024 |
* capture |
|
1025 |
* @return reference to the burst capture array |
|
1026 |
* @since 2.8 |
|
1027 |
*/ |
|
1028 |
CCamBurstCaptureArray* BurstCaptureArray() const; |
|
1029 |
||
1030 |
/** |
|
1031 |
* Returns the number of non-deleted items in the array |
|
1032 |
* @return count of non-deleted items |
|
1033 |
* @since 2.8 |
|
1034 |
*/ |
|
1035 |
TInt CurrentItemCount(); |
|
1036 |
||
1037 |
/** |
|
1038 |
* Returns the number of burst capture moments that have taken |
|
1039 |
* place in a current burst. If no burst is active this returns |
|
1040 |
* 0 |
|
1041 |
* @return count of burst capture moments |
|
1042 |
* @since 3.0 |
|
1043 |
*/ |
|
1044 |
TInt CurrentCapturedCount(); |
|
1045 |
||
1046 |
/** |
|
1047 |
* Returns the number of items in a timelapse sequence |
|
1048 |
* @return count of timelapse sequence items |
|
1049 |
* @since 3.0 |
|
1050 |
*/ |
|
1051 |
TInt TimeLapseImageCount(); |
|
1052 |
||
1053 |
/** |
|
1054 |
* Resets the array of filenames used in timelapse capture |
|
1055 |
* @since 3.0 |
|
1056 |
*/ |
|
1057 |
void ResetTimelapseArray(); |
|
1058 |
||
1059 |
/** |
|
1060 |
* Initiates the playing of the specified sound. |
|
1061 |
* @since 2.8 |
|
1062 |
* @param aSoundId The enum value of the sound to play |
|
1063 |
* @param aEnableCallback Whether we want a callback when play complete |
|
1064 |
*/ |
|
1065 |
void PlaySound( TCamSoundId aSoundId, TBool aEnableCallback ); |
|
1066 |
||
1067 |
||
1068 |
/** |
|
1069 |
* Releases the camera hardware for other apps to use |
|
1070 |
* @since 2.8 |
|
1071 |
*/ |
|
1072 |
void ReleaseCamera(); |
|
1073 |
||
1074 |
/** |
|
1075 |
* Increments the engine usage count |
|
1076 |
* @since 2.8 |
|
1077 |
*/ |
|
1078 |
void IncCameraUsers(); |
|
1079 |
||
1080 |
/** |
|
1081 |
* Decrements the engine usage count If the engine is no longer required |
|
1082 |
* then it is released. If it is still processing, the engine count will |
|
1083 |
* be checked when the current process completes and the engine will be |
|
1084 |
* released if it is no longer needed. |
|
1085 |
* @since 2.8 |
|
1086 |
*/ |
|
1087 |
void DecCameraUsers(); |
|
1088 |
||
1089 |
/* |
|
1090 |
* Gets the handle to the static settings model, which is used inturn by the |
|
1091 |
* plugin to call the interfaces for performing needed actions. |
|
1092 |
*/ |
|
1093 |
MCamStaticSettings& StaticSettingsModel(); |
|
1094 |
||
1095 |
/* |
|
1096 |
* Check if image/video scene mode is supported |
|
1097 |
*/ |
|
1098 |
TBool IsSceneSupported( const TInt aSceneId, TBool aPhotoScene = ETrue ) const; |
|
1099 |
||
1100 |
/** |
|
1101 |
* Whether a call is active, including the ringing state |
|
1102 |
* @since 2.8 |
|
1103 |
* @return ETrue if in call or ringing, else EFalse |
|
1104 |
*/ |
|
1105 |
TBool InCallOrRinging() const; |
|
1106 |
||
1107 |
/** |
|
1108 |
* Whether a video call is active, including the ringing state |
|
1109 |
* @return ETrue if in videocall or ringing, else EFalse |
|
1110 |
*/ |
|
1111 |
TBool InVideocallOrRinging(); |
|
1112 |
||
1113 |
/** |
|
1114 |
* Whether or not a video clip is currently being saved |
|
1115 |
* @since 2.8 |
|
1116 |
* @return ETrue if saving, else EFalse |
|
1117 |
*/ |
|
1118 |
TBool CurrentlySavingVideo() const; |
|
1119 |
||
1120 |
/** |
|
1121 |
* Returns whether all the settings list options for a particular setting |
|
1122 |
* item are visible or not |
|
1123 |
* @since 2.8 |
|
1124 |
* @param aSettingItem The setting item to be checked. |
|
1125 |
* @param aRevisedResourceId Receives the id of a resource if the return |
|
1126 |
* value is EFalse. The resource contains the list of visible |
|
1127 |
* options. |
|
1128 |
* @return ETrue if all options are visible. Otherwise, EFalse. |
|
1129 |
*/ |
|
1130 |
TBool AllOptionsVisibleForSettingItem( TInt aSettingItem, |
|
1131 |
TInt& aRevisedResourceId ); |
|
1132 |
||
1133 |
/** |
|
1134 |
* Switches the camera being used |
|
1135 |
* @since 2.8 |
|
1136 |
*/ |
|
1137 |
void SwitchCameraL(); |
|
1138 |
||
1139 |
/** |
|
1140 |
* Returns the active camera |
|
1141 |
* @since 2.8 |
|
1142 |
* @return @return either primary, secondary or none ( if in process of switching ) |
|
1143 |
*/ |
|
1144 |
TCamActiveCamera ActiveCamera() const; |
|
1145 |
||
1146 |
/** |
|
1147 |
* Whether we currently have a camera switch required |
|
1148 |
* @since 2.8 |
|
1149 |
* @return TCameraSwitchRequired a camera switch is required or not |
|
1150 |
*/ |
|
1151 |
TCameraSwitchRequired CameraSwitchQueued() const; |
|
1152 |
||
1153 |
/** |
|
1154 |
* Check if exit is required |
|
1155 |
* @since 2.8 |
|
1156 |
* @return TBool True if exit is required |
|
1157 |
*/ |
|
1158 |
TBool CheckExitStatus(); |
|
1159 |
||
1160 |
/** |
|
1161 |
* Informs the controller that an end key event is waiting |
|
1162 |
* to close the app, or has been acted upon |
|
1163 |
* This is used when the end key is pressed during sequence capture |
|
1164 |
* @since 2.8 |
|
1165 |
*/ |
|
1166 |
void SetEndKeyExitWaiting( TBool aEndKeyWaiting ); |
|
1167 |
||
1168 |
/** |
|
1169 |
* Returns the status of the camera slide |
|
1170 |
* @since 2.8 |
|
1171 |
* @return the status of the camera slide |
|
1172 |
*/ |
|
1173 |
TInt CameraSlideState() const; |
|
1174 |
||
1175 |
/** |
|
1176 |
* Informs the controller that a slider close event has |
|
1177 |
* been reacted to by 'pretending' to exit |
|
1178 |
* @since 2.8 |
|
1179 |
*/ |
|
1180 |
void SliderCloseEventActioned(); |
|
1181 |
||
1182 |
/** |
|
1183 |
* Set camera switch to queue |
|
1184 |
*/ |
|
1185 |
void SetCameraSwitchRequired( TCameraSwitchRequired aSwitchRequired ); |
|
1186 |
||
1187 |
/** |
|
1188 |
* Check slide state and schedule camera switch if required |
|
1189 |
* @since 2.8 |
|
1190 |
*/ |
|
1191 |
void CheckSlideStatus(); |
|
1192 |
||
1193 |
||
1194 |
/** |
|
1195 |
* Return range of EV value supported for current product |
|
1196 |
* @since 3.0 |
|
1197 |
* @return TEvRange struct |
|
1198 |
*/ |
|
1199 |
TCamEvCompRange EvRange() const; |
|
1200 |
||
1201 |
/** |
|
1202 |
* Switches camera to standby |
|
1203 |
* @since 5.1 |
|
1204 |
* @param aSratus Error code for Standby mode |
|
1205 |
* @return |
|
1206 |
*/ |
|
1207 |
void SwitchToStandbyL( TInt aStatus = KErrNone ); |
|
1208 |
||
1209 |
public: // Derived from MCamCallStateObserver base class |
|
1210 |
/** |
|
1211 |
* Callback for when the current phone call state changes |
|
1212 |
* @since 3.0 |
|
1213 |
* @param aState The new call state |
|
1214 |
* @param aError An error code associated with the event |
|
1215 |
*/ |
|
1216 |
void CallStateChanged( TPSCTsyCallState aState, TInt aError ); |
|
1217 |
||
1218 |
/** |
|
1219 |
* Returns the file size of the specified file |
|
1220 |
* @since 3.0 |
|
1221 |
* @param aFilename The file to retrieve the size of. |
|
1222 |
* @return The size of the file or KErrNotFound |
|
1223 |
*/ |
|
1224 |
TInt FileSize( TDesC& aFilename ) const; |
|
1225 |
||
1226 |
/** |
|
1227 |
* Returns whether the current scene uses forced |
|
1228 |
* autofocus (so no AF required at capture time) |
|
1229 |
* @since 3.0 |
|
1230 |
* @return ETrue if forced, EFalse if not |
|
1231 |
*/ |
|
1232 |
TBool CurrentSceneHasForcedFocus() const; |
|
1233 |
||
1234 |
public: |
|
1235 |
||
1236 |
/** |
|
1237 |
* Get the actual resolution (WxH) of current image quality. |
|
1238 |
*/ |
|
1239 |
TSize GetCurrentImageDimensions() const; |
|
1240 |
||
1241 |
/** |
|
1242 |
* Retrieves the current image resolution, taking into account |
|
1243 |
* the user settings and and modifications due to zoom state. |
|
1244 |
* @since 2.8 |
|
1245 |
* @returns The current image resolution. |
|
1246 |
*/ |
|
1247 |
TCamPhotoSizeId GetCurrentImageResolution() const; |
|
1248 |
||
1249 |
/** |
|
1250 |
* Retrieves the current image compression |
|
1251 |
* @since 2.8 |
|
1252 |
* @returns The current image compression. |
|
1253 |
*/ |
|
1254 |
TInt GetCurrentImageCompression() const; |
|
1255 |
||
1256 |
/** |
|
1257 |
* Retrieves the current video resolution. |
|
1258 |
* @since 2.8 |
|
1259 |
* @returns The current video resolution. |
|
1260 |
*/ |
|
1261 |
TCamVideoResolution GetCurrentVideoResolution() const; |
|
1262 |
||
1263 |
/** |
|
1264 |
* Force use of phone memory storage |
|
1265 |
* @since 2.8 |
|
1266 |
*/ |
|
1267 |
void UsePhoneMemoryL() const; |
|
1268 |
||
1269 |
/** |
|
1270 |
* Sets the correct memory to be used based on settings |
|
1271 |
* and availability of MMC. |
|
1272 |
* @since 4.0 |
|
1273 |
* @return ETrue if memory location changed |
|
1274 |
*/ |
|
1275 |
TBool CheckMemoryToUseL(); |
|
1276 |
||
1277 |
/** |
|
1278 |
* Indicate whether the phone memory is being force-used |
|
1279 |
* because of un-availability or errors in MMC. |
|
1280 |
* @since 4.0 |
|
1281 |
*/ |
|
1282 |
TBool IsPhoneMemoryForced(); |
|
1283 |
||
1284 |
/** |
|
1285 |
* Retrieves the current image resolution from Settings. |
|
1286 |
* @since 2.8 |
|
1287 |
* @returns The current image from Settings |
|
1288 |
*/ |
|
1289 |
TCamPhotoSizeId SettingsPhotoResolution() const; |
|
1290 |
||
1291 |
||
1292 |
/** |
|
1293 |
* Indication that a view has finished using the capture array |
|
1294 |
* @since 2.8 |
|
1295 |
* @param aForcedRelease Should the array be released even if |
|
1296 |
* the apparent usage count is not null. |
|
1297 |
*/ |
|
1298 |
void ReleaseArray( TBool aForcedRelease = EFalse ); |
|
1299 |
||
1300 |
/** |
|
1301 |
* Restore Camera settings to default |
|
1302 |
* @since 3.0 |
|
1303 |
* @param aIsEmbedded if app is embedded |
|
1304 |
*/ |
|
1305 |
void RestoreFactorySettingsL( TBool aIsEmbedded ); |
|
1306 |
||
1307 |
private: |
|
1308 |
/** |
|
1309 |
* Called when playback of a sound has completed |
|
1310 |
* @since 2.8 |
|
1311 |
*/ |
|
1312 |
void PlaySoundComplete(); |
|
1313 |
public: |
|
1314 |
||
1315 |
/** |
|
1316 |
* Non-leaving version of StartViewFinderL() |
|
1317 |
* @since 2.8 |
|
1318 |
*/ |
|
1319 |
void StartViewFinder(); |
|
1320 |
||
1321 |
/** |
|
1322 |
* Stop viewfinder |
|
1323 |
* @since 2.8 |
|
1324 |
*/ |
|
1325 |
void StopViewFinder(); |
|
1326 |
||
1327 |
/** |
|
1328 |
* Stop viewfinder Ecam only |
|
1329 |
* Needed with async video recording stopping |
|
1330 |
* @since 5.0 |
|
1331 |
*/ |
|
1332 |
void StopViewFinderEcam(); |
|
1333 |
||
1334 |
/** |
|
1335 |
* Sets the zoom mode of the engine |
|
1336 |
* @param aZoomMode The zoom mode to set |
|
1337 |
* @since 3.0 |
|
1338 |
*/ |
|
1339 |
// Only digital mode supported currently - no need for this |
|
1340 |
//void SetZoomMode( const TCamZoomMode& aZoomMode ); |
|
1341 |
||
1342 |
/** |
|
1343 |
* Report whether a capture mode transition is currently in progress |
|
1344 |
* @since 2.8 |
|
1345 |
* @return TBool ETrue if transition (i.e. still/video capture prepare) is |
|
1346 |
* currently in progress, EFalse otherwise; |
|
1347 |
*/ |
|
1348 |
TBool CaptureModeTransitionInProgress(); |
|
1349 |
||
1350 |
/** |
|
1351 |
* Check if viewfinder is active |
|
1352 |
* @since 2.8 |
|
1353 |
* @returns ETrue if viewfinding |
|
1354 |
*/ |
|
1355 |
TBool IsViewFinding() const; |
|
1356 |
||
1357 |
/** |
|
1358 |
* Check if capture key needs to be released before starting |
|
1359 |
* new capture process. Used in post capture state to prevent |
|
1360 |
* image capture before viewfinder is completely shown. |
|
1361 |
* @since S60 v5.0 |
|
1362 |
* @return ETrue if waiting key release before next capture |
|
1363 |
*/ |
|
1364 |
TBool IsDemandKeyRelease(); |
|
1365 |
||
1366 |
/** |
|
1367 |
* Set iDemandKeyRelease value |
|
1368 |
* @param aDemand Demand to release capture key |
|
1369 |
* @since S60 v5.0 |
|
1370 |
*/ |
|
1371 |
void SetDemandKeyRelease( TBool aDemand ); |
|
1372 |
||
1373 |
/** |
|
1374 |
* Stop the idle timer |
|
1375 |
* @since 2.8 |
|
1376 |
*/ |
|
1377 |
void StopIdleTimer(); |
|
1378 |
||
1379 |
/** |
|
1380 |
* Restart the idle timer |
|
1381 |
* @since 2.8 |
|
1382 |
*/ |
|
1383 |
void StartIdleTimer(); |
|
1384 |
||
1385 |
||
1386 |
/** |
|
1387 |
* Flash modes supported by engine |
|
1388 |
* @since 3.0 |
|
1389 |
* @return supported flash modes |
|
1390 |
*/ |
|
1391 |
TUint32 SupportedFlashModes(); |
|
1392 |
||
1393 |
||
1394 |
/** |
|
1395 |
* White balance modes supported by engine |
|
1396 |
* @since 3.0 |
|
1397 |
* @return supported white balance modes |
|
1398 |
*/ |
|
1399 |
TUint32 SupportedWBModes(); |
|
1400 |
||
1401 |
/** |
|
1402 |
* EV modes supported by engine |
|
1403 |
* @since 3.0 |
|
1404 |
* @return supported EV modes |
|
1405 |
*/ |
|
1406 |
TUint32 SupportedEVModes(); |
|
1407 |
||
1408 |
/** |
|
1409 |
* Capture state |
|
1410 |
* @return TInt capture state |
|
1411 |
*/ |
|
1412 |
TInt CaptureState(); |
|
1413 |
||
1414 |
/** |
|
1415 |
* Returns the current capture-tone id |
|
1416 |
* @since 3.0 |
|
1417 |
* @return the current capture-tone id |
|
1418 |
*/ |
|
1419 |
TCamSoundId CaptureToneId( ); |
|
1420 |
||
1421 |
#ifdef CAMERAAPP_PERFORMANCE_MEASUREMENT |
|
1422 |
public: |
|
1423 |
void SetPerformanceState( TCamPerformanceState aState ); |
|
1424 |
#endif |
|
1425 |
||
1426 |
/** |
|
1427 |
* Set pointer to settings plug-in. Takes ownership! |
|
1428 |
* @param aPlugin Pointer to settings plug-in. This object |
|
1429 |
* takes ownership. |
|
1430 |
* @since S60 v5.0 |
|
1431 |
*/ |
|
67
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
1432 |
void SetSettingsPlugin( CCamGSInterface* aPlugin ); |
54 | 1433 |
|
1434 |
/** |
|
1435 |
* Set viewfinder window for direct screen viewfinder. The handle must remain |
|
1436 |
* valid as long as viewfinder is running. |
|
1437 |
* @since S60 v5.0 |
|
1438 |
* @param aWindow Handle to viewfinder window. Must remain valid while |
|
1439 |
* viewfinder is running. Ownership not transferred. |
|
1440 |
*/ |
|
1441 |
void SetViewfinderWindowHandle( RWindowBase* aWindow ); |
|
1442 |
||
1443 |
/** |
|
1444 |
* Notify that the viewfinder window is about to be deleted. Viewfinder |
|
1445 |
* will be stopped if this window handle is currently used for the |
|
1446 |
* viewfinder. |
|
1447 |
* @since S60 v5.0 |
|
1448 |
* @param aWindow Handle to viewfinder window. Ownership not transferred. |
|
1449 |
*/ |
|
1450 |
void ViewfinderWindowDeleted( RWindowBase* aWindow ); |
|
1451 |
||
1452 |
protected: // New functions |
|
1453 |
||
1454 |
/** |
|
1455 |
* C++ default constructor. |
|
1456 |
* @since 2.8 |
|
1457 |
*/ |
|
1458 |
CCamAppController(); |
|
1459 |
||
1460 |
/** |
|
1461 |
* Symbian OS 2nd phase constructor. |
|
1462 |
* @since 2.8 |
|
1463 |
*/ |
|
1464 |
void ConstructL(); |
|
1465 |
||
1466 |
// ----------------------------------------------------- |
|
1467 |
// Burst related |
|
1468 |
public: |
|
1469 |
||
1470 |
/** |
|
1471 |
* Stop burst in a soft way: |
|
1472 |
* - if have not moved yet to long burst mode, |
|
1473 |
* wait until the short burst ends and do not |
|
1474 |
* enter long burst mode (if aFastStop is true, |
|
1475 |
* stop asap when atleast 2 images captured). |
|
1476 |
* - if long burst already entered, stop capturing |
|
1477 |
* after the next capture. |
|
1478 |
* @param aFastStop Stop also short burst asap, but so that |
|
1479 |
* atleast 2 images are captured. |
|
1480 |
*/ |
|
1481 |
void SoftStopBurstL( TBool aFastStop = EFalse ); |
|
1482 |
||
1483 |
/** |
|
1484 |
* Set iNoBurstCancel flag which is used to prevent stopping burst |
|
1485 |
* when actual burst capture has started after focusing. |
|
1486 |
*/ |
|
1487 |
void SetNoBurstCancel( TBool aValue ); |
|
1488 |
||
1489 |
/** |
|
1490 |
* Set iKeyUPl flag which is used to prevent late |
|
1491 |
* activated burst timer when capturekey is up already |
|
1492 |
* before burstcapture has started. |
|
1493 |
*/ |
|
1494 |
void SetKeyUp( TBool aValue = EFalse ); |
|
1495 |
||
1496 |
/** |
|
1497 |
* Returns amount of images captured in burst mode |
|
1498 |
* @return Amount of captured images |
|
1499 |
* |
|
1500 |
*/ |
|
1501 |
TInt CapturedImages() const; |
|
1502 |
||
1503 |
private: |
|
1504 |
||
1505 |
/** |
|
1506 |
* Start the burst timer for changing to long burst mode. |
|
1507 |
*/ |
|
1508 |
void StartBurstTimerL(); |
|
1509 |
||
1510 |
/* |
|
1511 |
* Stop the burst timer. |
|
1512 |
*/ |
|
1513 |
void StopBurstTimer(); |
|
1514 |
||
1515 |
/** |
|
1516 |
* Callback for short burst timer. |
|
1517 |
* @param aController Pointer to app controller instance. |
|
1518 |
* @return Always zero, implies no repeated callbacks wanted. |
|
1519 |
*/ |
|
1520 |
static TInt ShortBurstTimeout( TAny* aController ); |
|
1521 |
||
1522 |
/** |
|
1523 |
* Helper method for short burst timer callback. |
|
1524 |
*/ |
|
1525 |
void DoShortBurstTimeoutL(); |
|
1526 |
||
1527 |
||
1528 |
// ----------------------------------------------------- |
|
1529 |
private: |
|
1530 |
||
1531 |
/** |
|
1532 |
* Return number of images that can still be captured for a particular |
|
1533 |
* image photo resolution |
|
1534 |
* @since 2.8 |
|
1535 |
* @param aStorage storage location - defaults to current loation |
|
1536 |
* @param aBurstActive - set to ETrue if burst mode is active |
|
1537 |
* @param aSize - the id of the photo resolution |
|
1538 |
* @return the number of images |
|
1539 |
*/ |
|
1540 |
TInt ImagesRemaining( TCamMediaStorage aStorage, |
|
1541 |
TBool aBurstActive, |
|
1542 |
TCamPhotoSizeId aSize ); |
|
1543 |
||
1544 |
/** |
|
1545 |
* Change the controller's current state |
|
1546 |
* Notifies controller observers of change |
|
1547 |
* @since 2.8 |
|
1548 |
* @param aNewState new state code |
|
1549 |
*/ |
|
1550 |
void ChangeState( const TCamCameraState& aNewState ); |
|
1551 |
||
1552 |
/** |
|
1553 |
* Change the controller's target state. The state will not be |
|
1554 |
* altered if the controller is already in shutdown mode. |
|
1555 |
* @since 2.8 |
|
1556 |
* @param aNewState new state code |
|
1557 |
*/ |
|
1558 |
void ChangeTargetState( const TCamCameraState& aNewState ); |
|
1559 |
||
1560 |
/** |
|
1561 |
* Change the controller's current operation |
|
1562 |
* Notifies controller observers of change |
|
1563 |
* @since 2.8 |
|
1564 |
* @param aNewOperation new operation code |
|
1565 |
* @param aError error code associated with new state (if any) |
|
1566 |
*/ |
|
1567 |
void ChangeOperation( TCamCaptureOperation aNewOperation, |
|
1568 |
TInt aError = KErrNone ); |
|
1569 |
||
1570 |
public: |
|
1571 |
/** |
|
1572 |
* Notify controller observers of an event. |
|
1573 |
* @since 2.8 |
|
1574 |
* @param aEvent event code |
|
1575 |
* @param aError error code |
|
1576 |
*/ |
|
1577 |
void NotifyControllerObservers( TCamControllerEvent aEvent, |
|
1578 |
TInt aError = KErrNone ) const; |
|
1579 |
private: |
|
1580 |
||
1581 |
/** |
|
1582 |
* Starts the viewfinder if the engine has been prepared for the |
|
1583 |
* current mode. |
|
1584 |
* @since 2.8 |
|
1585 |
*/ |
|
1586 |
void StartViewFinderL(); |
|
1587 |
||
1588 |
/** |
|
1589 |
* Initiate image capture |
|
1590 |
* @since 2.8 |
|
1591 |
* @return ETrue if the capture was initiated otherwise EFalse |
|
1592 |
*/ |
|
1593 |
TBool DoCaptureL(); |
|
1594 |
||
1595 |
/** |
|
1596 |
* Initiate video recording |
|
1597 |
* @since 2.8 |
|
1598 |
*/ |
|
1599 |
void DoRecord(); |
|
1600 |
||
1601 |
/** |
|
1602 |
* Make a local copy of the viewfinder frame to use when |
|
1603 |
* the viewfinder is frozen |
|
1604 |
* @since 2.8 |
|
1605 |
*/ |
|
1606 |
void CopyFrameL( const CFbsBitmap& aBitmap ); |
|
1607 |
||
1608 |
/** |
|
1609 |
* Reserve a set of file names for the current capture |
|
1610 |
* Store the reserved name(s) in iCaptureArray |
|
1611 |
* @since 2.8 |
|
1612 |
* @param aCaptureMode still, burst or video mode |
|
1613 |
* @param aForcePhoneMem force path to use Phone memory (C:) |
|
1614 |
*/ |
|
1615 |
void ReserveFileNamesL( |
|
1616 |
const TCamCameraMode& aCaptureMode, |
|
1617 |
const TCamImageCaptureMode& aImageMode, |
|
1618 |
TBool aForcePhoneMem = EFalse ); |
|
1619 |
||
1620 |
/** |
|
1621 |
* Create a file ready for saving captured image into |
|
1622 |
* @since 2.8 |
|
1623 |
* @param aFs: Handle to RFs |
|
1624 |
* @param aFullPath: Full path including drive and extension |
|
1625 |
* @return error code from file creation |
|
1626 |
*/ |
|
1627 |
TInt CreateDummyFileL( RFs& aFs, const TDesC& aFullPath ); |
|
1628 |
||
1629 |
||
1630 |
/** |
|
1631 |
* Store file name and full file name (incl. path) |
|
1632 |
* to burst capture array |
|
1633 |
* @since 2.8 |
|
1634 |
* @param aFullPath: Full path including drive and extension |
|
1635 |
*/ |
|
1636 |
void StoreNextFileNameL( const TDesC& aFullPath ); |
|
1637 |
||
1638 |
/** |
|
1639 |
* Generate a new file name and full path for saving the next video |
|
1640 |
* according to the specified mode (unless specified otherwise) |
|
1641 |
* @since 2.8 |
|
1642 |
* @param aForcePhoneMem force path to use Phone memory (C:) |
|
1643 |
*/ |
|
1644 |
void GenerateNextVideoFilePathL( TBool aForcePhoneMem = EFalse ); |
|
1645 |
||
1646 |
/** |
|
1647 |
* Generate a new path for saving the next image |
|
1648 |
* @since 3.0 |
|
1649 |
*/ |
|
1650 |
void GenerateNextValidImagesPathL(); |
|
1651 |
||
1652 |
/** |
|
1653 |
* Generate a new file name and full path for saving the next video |
|
1654 |
* according to the specified mode. File will always be |
|
1655 |
* available. |
|
1656 |
* @since 2.8 |
|
1657 |
*/ |
|
1658 |
void GenerateNextValidVideoPathL(); |
|
1659 |
||
1660 |
/** |
|
1661 |
* Handle a notification from the autofocus custom extension |
|
1662 |
* @since 2.8 |
|
1663 |
*/ |
|
1664 |
void HandleAutoFocusNotification( TCamExtAutoFocus aNotification ); |
|
1665 |
||
1666 |
/** |
|
1667 |
* Static callback function for idle timer expiry |
|
1668 |
* @since 2.8 |
|
1669 |
* @param aPtr Pointer to an instance of the CCamAppController |
|
1670 |
* @return TInt to indicate if function should be called again |
|
1671 |
*/ |
|
1672 |
static TInt IdleTimeoutL( TAny* aPtr ); |
|
1673 |
||
1674 |
/** |
|
1675 |
* Static callback function for time lapse timer expiry |
|
1676 |
* @since 3.0 |
|
1677 |
* @param aPtr Pointer to an instance of the CCamAppController |
|
1678 |
* @return TInt to indicate if function should be called again |
|
1679 |
*/ |
|
1680 |
static TInt TimeLapseTimeoutL( TAny* aPtr ); |
|
1681 |
||
1682 |
private: // Deep sleep timer |
|
1683 |
/** |
|
1684 |
* Static callback function for camera deep sleep |
|
1685 |
* @since S60 5.0 |
|
1686 |
* @param aPtr Pointer to an instance of the CCamAppController |
|
1687 |
* @return TInt dummy |
|
1688 |
*/ |
|
1689 |
static TInt DeepSleepTimeout( TAny* aPtr ); |
|
1690 |
||
1691 |
/** |
|
1692 |
* Deep sleep timeout handler |
|
1693 |
*/ |
|
1694 |
void DoDeepSleepTimeout(); |
|
1695 |
||
1696 |
public: // Deep sleep timer |
|
1697 |
/** |
|
1698 |
* Start deep sleep timer |
|
1699 |
*/ |
|
1700 |
void DeepSleepTimerStart(); |
|
1701 |
||
1702 |
/** |
|
1703 |
* Cancel deep sleep timer |
|
1704 |
*/ |
|
1705 |
void DeepSleepTimerCancel(); |
|
1706 |
||
1707 |
private: |
|
1708 |
/** |
|
1709 |
* Set video length (max or short) |
|
1710 |
* @param aLength Length of video |
|
1711 |
* @since 2.8 |
|
1712 |
*/ |
|
1713 |
void SetVideoLengthL( TInt aLength ); |
|
1714 |
||
1715 |
/** |
|
1716 |
* Returns the current photo storage location. |
|
1717 |
* @return the photo storage location |
|
1718 |
* @since 2.8 |
|
1719 |
*/ |
|
1720 |
TInt CurrentPhotoStorageLocation() const; |
|
1721 |
||
1722 |
/** |
|
1723 |
* Returns the current video storage location. |
|
1724 |
* @return the video storage location |
|
1725 |
* @since 2.8 |
|
1726 |
*/ |
|
1727 |
TInt CurrentVideoStorageLocation() const; |
|
1728 |
||
1729 |
/** |
|
1730 |
* Returns ETrue if the supplied toneId should be silent if the profile is |
|
1731 |
* set to silent. Does *not* take into account network variant forcing |
|
1732 |
* sounds on. |
|
1733 |
* @since 3.0 |
|
1734 |
* @param aSoundId The tone to check |
|
1735 |
* @return ETrue if sound should always be played, else EFalse |
|
1736 |
*/ |
|
1737 |
TBool ToneShouldBeSilent( TCamSoundId aSoundId ); |
|
1738 |
||
1739 |
/** |
|
1740 |
* Report to any observers that capture processing has completed |
|
1741 |
* @since 3.0 |
|
1742 |
*/ |
|
1743 |
void HandleCaptureCompletion(); |
|
1744 |
||
1745 |
/** |
|
1746 |
* Tries to autofocus, will do nothing if camera in use is not |
|
1747 |
* primary camera, or focus range has not been set first |
|
1748 |
* @since 3.0 |
|
1749 |
* @return Whether or not auto focus has been initiated |
|
1750 |
*/ |
|
1751 |
TBool TryAutoFocus(); |
|
1752 |
||
1753 |
/** |
|
1754 |
* Checks the current scene, and where required, updates the autofocus |
|
1755 |
* mode in use. Called when the photo scene or based-on-scene change |
|
1756 |
* @since 3.0 |
|
1757 |
* @param aForceAFReset Whether to force a ResetToIdle independant of scene mode |
|
1758 |
*/ |
|
1759 |
void CheckAfModeForScene( TBool aForceAFReset = EFalse ); |
|
1760 |
||
1761 |
/** |
|
1762 |
* Initalises the AutoFocus interface, if needed |
|
1763 |
* @since 3.0 |
|
1764 |
*/ |
|
1765 |
void InitAutoFocusL(); |
|
1766 |
||
1767 |
/** |
|
1768 |
* Timeout to play capture tone after delay (to match |
|
1769 |
* capture tone to actual capture event) |
|
1770 |
* @since 3.0 |
|
1771 |
* @param aPtr TAny* ptr (cast to CCamAppController) |
|
1772 |
* @return Error code retruned by function |
|
1773 |
*/ |
|
1774 |
static TInt CaptureToneDelayTimeout( TAny* aPtr ); |
|
1775 |
||
1776 |
/** |
|
1777 |
* Play the capture tone (called from capture delay timeout) |
|
1778 |
* @since 3.0 |
|
1779 |
*/ |
|
1780 |
void PlayDelayedCaptureTone(); |
|
1781 |
||
1782 |
/** |
|
1783 |
* Copy Snapshot if needed. Helper function for McaeoSnapImageReady |
|
1784 |
* @since 3.0 |
|
1785 |
* @param aSnapshot the snapshot to copy |
|
1786 |
* @param aError Error code KErrNone to indicate success or a |
|
1787 |
* standard Symbian OS error code. |
|
1788 |
*/ |
|
1789 |
void CopySnapshotIfNeeded(const CFbsBitmap& aSnapshot, TInt aError); |
|
1790 |
||
1791 |
||
1792 |
/** |
|
1793 |
* Checks whether flash is required for taking a picture. |
|
1794 |
* @return true if flash is required current mode |
|
1795 |
*/ |
|
1796 |
TBool FlashRequired() const; |
|
1797 |
||
1798 |
||
1799 |
private: // Functions from base classes |
|
1800 |
||
1801 |
/** |
|
1802 |
* From MCamImageSaveObserver, image save has completed |
|
1803 |
* @since 2.8 |
|
1804 |
*/ |
|
1805 |
void HandleSaveEvent( TCamSaveEvent aEvent ); |
|
1806 |
||
1807 |
/** |
|
1808 |
* From MCamImageSaveObserver, image save has completed |
|
1809 |
* @since 2.8 |
|
1810 |
*/ |
|
1811 |
void HandleFileHarvestingComplete(); |
|
1812 |
||
1813 |
/** |
|
1814 |
* Idle timeout expiry - invoke switch to standby mode |
|
1815 |
* @since 2.8 |
|
1816 |
* @return TInt to indicate if function should be called again |
|
1817 |
*/ |
|
1818 |
TInt DoIdleTimeoutL(); |
|
1819 |
||
1820 |
/** |
|
1821 |
* Time lapse timeout expiry - update the remaining time countdown |
|
1822 |
* or initiate the next capture if the full period has expired |
|
1823 |
* @return TInt to indicate if function should be called again |
|
1824 |
*/ |
|
1825 |
TInt DoTimeLapseTimeoutL(); |
|
1826 |
||
1827 |
/** |
|
1828 |
* Force the application to use phone memory for Video and Image saving. |
|
1829 |
* Typically called when attempting to access MMC fails. |
|
1830 |
* @since 2.8 |
|
1831 |
*/ |
|
1832 |
void ForceUsePhoneMemoryL( TBool aEnable = ETrue ); |
|
1833 |
||
1834 |
/** |
|
1835 |
* Complete the burst operation |
|
1836 |
* @since 2.8 |
|
1837 |
*/ |
|
1838 |
void CompleteBurstOperation(); |
|
1839 |
||
1840 |
/** |
|
1841 |
* Complete the time lapse operation |
|
1842 |
* @since 3.0 |
|
1843 |
*/ |
|
1844 |
void CompleteTimeLapseOperation(); |
|
1845 |
||
1846 |
||
1847 |
/** |
|
1848 |
* Whether or not the engine is currently processing a capture |
|
1849 |
* still, video or sequence. |
|
1850 |
* @since 2.8 |
|
1851 |
* @return ETrue if the engine is performing a capture operation |
|
1852 |
*/ |
|
1853 |
TBool EngineProcessingCapture() const; |
|
1854 |
||
1855 |
/** |
|
1856 |
* Handle an arriving call. Stops video and cancels sequence capture |
|
1857 |
* in early stages. |
|
1858 |
* @since 2.8 |
|
1859 |
*/ |
|
1860 |
void HandleIncomingCall(); |
|
1861 |
||
1862 |
/** |
|
1863 |
* Cleans up the controller active camera state |
|
1864 |
* @param aAny Pointer to the object which is the target |
|
1865 |
* of the cleanup operation |
|
1866 |
* @since 2.8 |
|
1867 |
*/ |
|
1868 |
static void Cleanup( TAny* aAny ); |
|
1869 |
||
1870 |
/** |
|
1871 |
* Immediately cancels a still capture at any stage. |
|
1872 |
* @since 2.8 |
|
1873 |
*/ |
|
1874 |
void CancelStillCaptureNow(); |
|
1875 |
||
1876 |
/** |
|
1877 |
* Attempt to cleanup capture array if burst capture fails |
|
1878 |
* @since 2.8 |
|
1879 |
* @param aImageCountDelivered number of images delivered |
|
1880 |
* @param aError error returned from burst capture operation |
|
1881 |
*/ |
|
1882 |
void TidyCaptureArray( TInt aImageCountDelivered, |
|
1883 |
TInt aError ); |
|
1884 |
||
1885 |
/** |
|
1886 |
* Load 2ndary caera specifc settings (on construction or camera switch) |
|
1887 |
* @since 3.0 |
|
1888 |
*/ |
|
1889 |
void LoadSecondaryCameraSettingsL(); |
|
1890 |
||
1891 |
// ------------------------------------------------------- |
|
1892 |
// Orientation sensor / rotation related |
|
1893 |
public: |
|
1894 |
||
1895 |
/** |
|
1896 |
* Get current orientation to be used on image rotation. |
|
1897 |
* Always ECamOrientation0 if rotation setting is OFF. |
|
1898 |
* @return Current image orientation value. |
|
1899 |
*/ |
|
1900 |
TCamImageOrientation ImageOrientation() const; |
|
1901 |
||
1902 |
/** |
|
1903 |
* Checks if mass storage exist in current phone. |
|
1904 |
* @ return True if Mass storage exist |
|
1905 |
*/ |
|
1906 |
TBool ExistMassStorage() const; |
|
1907 |
||
1908 |
/** |
|
1909 |
* Checks if a memory type is available on the phone. |
|
1910 |
* @param aStorage TCamMediaStorage enum specifiying the type of storage; |
|
1911 |
* default=ECamMediaStorageCurrent |
|
1912 |
* @return ETrue if the Memory type is available |
|
1913 |
*/ |
|
1914 |
TBool IsMemoryAvailable( const TCamMediaStorage aStorage = |
|
1915 |
ECamMediaStorageCurrent, TBool aIgnoreUsbPersonality = EFalse ) const; |
|
1916 |
||
1917 |
public: |
|
1918 |
||
1919 |
/** |
|
1920 |
* Update the sensor api object |
|
1921 |
* @since 3.0 |
|
1922 |
* @param aStartupApi eTrue if we need to recreate the Api |
|
1923 |
*/ |
|
1924 |
void UpdateSensorApiL( TBool aStartupApi ); |
|
1925 |
||
1926 |
/** |
|
1927 |
* Forces a refresh of the local copy of the back slide status |
|
1928 |
* @since 2.8 |
|
1929 |
*/ |
|
1930 |
void RefreshSlideStatus(); |
|
1931 |
||
1932 |
private: |
|
1933 |
||
1934 |
/** |
|
1935 |
* From MSensrvDataListener receive Sensor Data |
|
1936 |
* |
|
1937 |
* Indicates data is available in the receiving buffer. A client can read |
|
1938 |
* the data through GetData()-function in the related channel object. Data |
|
1939 |
* is valid until the data received notification occurs again. |
|
1940 |
* |
|
1941 |
* @since 5.0 |
|
1942 |
* @param[in] aChannel Reference to the related channel object |
|
1943 |
* @param[in] aCount Data object count in receiving buffer. |
|
1944 |
* @param[in] aDataLost Number of lost data items. Data loss can occur if |
|
1945 |
* the client does not request new data from server fast enough. This |
|
1946 |
* can happen |
|
1947 |
* when system is under heavy load and the client process has lower |
|
1948 |
* priority than sensor server process. If data loss is a problem, |
|
1949 |
* consider using higher object count in data listening, which will reduce |
|
1950 |
* number of expensive IPC calls used in data transmission. |
|
1951 |
*/ |
|
1952 |
void DataReceived( CSensrvChannel& aChannel, |
|
1953 |
TInt aCount, |
|
1954 |
TInt aDataLost ); |
|
1955 |
/** |
|
1956 |
* From MSensrvDataListener receive data error notice |
|
1957 |
* |
|
1958 |
* Data listening failed. |
|
1959 |
* If error was fatal, channel has also been closed and sensor server session |
|
1960 |
* terminated. If error was minor, some data has potentially been lost. |
|
1961 |
* |
|
1962 |
* @since 5.0 |
|
1963 |
* @param[in] aChannel Reference to the related channel object |
|
1964 |
* @param[in] aError Error code. |
|
1965 |
*/ |
|
1966 |
void DataError( CSensrvChannel& aChannel, |
|
1967 |
TSensrvErrorSeverity aError ); |
|
1968 |
||
1969 |
/** |
|
1970 |
* From MSensrvDataListener |
|
1971 |
* |
|
1972 |
* Returns a pointer to a specified interface - to allow future extension |
|
1973 |
* of this class without breaking binary compatibility |
|
1974 |
* |
|
1975 |
* @since S60 5.0 |
|
1976 |
* @param aInterfaceUid Identifier of the interface to be retrieved |
|
1977 |
* @param aInterface A reference to a pointer that retrieves the specified interface. |
|
1978 |
*/ |
|
1979 |
void GetDataListenerInterfaceL( TUid aInterfaceUid, |
|
1980 |
TAny*& aInterface ); |
|
1981 |
||
1982 |
/** |
|
1983 |
* Set image rotation parameters |
|
1984 |
* @since 3.0 |
|
1985 |
*/ |
|
1986 |
void SetImageOrientationL(); |
|
1987 |
||
1988 |
/** |
|
1989 |
* Mapping from Sensor orientation data type to our own |
|
1990 |
* image orientation type. |
|
1991 |
* @param aSensorOrientation Orientation Sensor device orientation value. |
|
1992 |
* @return Camera orientation value. |
|
1993 |
*/ |
|
1994 |
static TCamImageOrientation MapSensorOrientatio2CamOrientation( |
|
1995 |
const TSensrvOrientationData::TSensrvDeviceOrientation& aSensorOrientation, |
|
1996 |
TCamImageOrientation aLastImageOrientation, |
|
1997 |
TCamActiveCamera aActiveCamera ); |
|
1998 |
||
1999 |
/** |
|
2000 |
* Mapping from camera orientation data type to bitmap orientation type. |
|
2001 |
* @param camera orientation value. |
|
2002 |
* @return CBitmapRotator::TRotationAngle. |
|
2003 |
*/ |
|
2004 |
static CBitmapRotator::TRotationAngle MapCamOrientation2RotationAngle( |
|
2005 |
const TCamImageOrientation aOrientation ); |
|
2006 |
||
2007 |
// ------------------------------------------------------- |
|
2008 |
||
2009 |
private: |
|
2010 |
||
2011 |
/** |
|
2012 |
* From MPropertyObserver Handle change in a watched property |
|
2013 |
* @since 2.8 |
|
2014 |
* @param aCategory The type of property |
|
2015 |
* @param aKey The property that has changed |
|
2016 |
*/ |
|
2017 |
void HandlePropertyChangedL( const TUid& aCategory, const TUint aKey ); |
|
2018 |
||
2019 |
private: |
|
2020 |
||
2021 |
/** |
|
2022 |
* Callback function that is called when lens cover state changes. |
|
2023 |
* Used to implement delayed handling of lens cover events. |
|
2024 |
* @param aPtr Pointer to CCamAppController |
|
2025 |
* @return |
|
2026 |
*/ |
|
2027 |
static TInt LensCoverUpdateL( TAny* aPtr ); |
|
2028 |
||
2029 |
/** |
|
2030 |
* Handles the slide closed event |
|
2031 |
* @since 2.8 |
|
2032 |
*/ |
|
2033 |
void HandleSlideClosedL(); |
|
2034 |
||
2035 |
/** |
|
2036 |
* Handles the slide open event |
|
2037 |
* @since 2.8 |
|
2038 |
*/ |
|
2039 |
void HandleSlideOpenedL(); |
|
2040 |
||
2041 |
||
2042 |
private: // Functions from base classes |
|
2043 |
||
2044 |
/** |
|
2045 |
* From MCamObserver |
|
2046 |
* Receives event codes from observables |
|
2047 |
* @since 3.0 |
|
2048 |
* @param aEvent The event code |
|
2049 |
*/ |
|
2050 |
void HandleObservedEvent( TCamObserverEvent aEvent ); |
|
2051 |
||
2052 |
/** |
|
2053 |
* Returns whether or not the current profile is silent |
|
2054 |
* @since 3.0 |
|
2055 |
* @return ETrue if current profile is silent |
|
2056 |
*/ |
|
2057 |
TBool IsProfileSilentL(); |
|
2058 |
||
2059 |
/** |
|
2060 |
* Static callback function for backlight timer reset |
|
2061 |
* since 3.0 |
|
2062 |
* @param aPtr Pointer to an instance of the CCamAppController |
|
2063 |
* @return TInt to indicate if function should be called again |
|
2064 |
*/ |
|
2065 |
static TInt ResetInactivityTimer( TAny* aPtr ); |
|
2066 |
||
2067 |
/** |
|
2068 |
* Enable or disable the system screensaver |
|
2069 |
* @since 3.0 |
|
2070 |
* @param aEnable ETrue if the screensaver is enabled |
|
2071 |
* else EFalse |
|
2072 |
*/ |
|
2073 |
void EnableScreenSaver( TBool aEnable ); |
|
2074 |
||
2075 |
/** |
|
2076 |
* Static callback function for timer callback for closing |
|
2077 |
* location trail. |
|
2078 |
* @since S60 v5.0 |
|
2079 |
* @param aPtr Pointer to an instance of the CCamAppController |
|
2080 |
* @return TInt to indicate if function should be called again |
|
2081 |
*/ |
|
2082 |
static TInt RetryStopLocationTrail( TAny* aPtr ); |
|
2083 |
||
2084 |
public: |
|
2085 |
void StartLocationTrailL(); |
|
2086 |
void StopLocationTrail( TBool aCloseSession = EFalse ); |
|
2087 |
||
2088 |
public: |
|
2089 |
/** |
|
2090 |
* Returns a pointer to flash status object. Never NULL if |
|
2091 |
* ConstructL has been executed successfully. |
|
2092 |
* @return flashStatusPointer |
|
2093 |
*/ |
|
2094 |
CCamFlashStatus* FlashStatus() const; |
|
2095 |
||
2096 |
/** |
|
2097 |
* Returns false, if a picture cannot be taken, due to flash being |
|
2098 |
* required and recharged, true otherwise. |
|
2099 |
* @return flashstatus |
|
2100 |
*/ |
|
2101 |
TBool CheckFlash() const; |
|
2102 |
||
2103 |
/** |
|
2104 |
* Called when about to switch to burst or timelapse mode. Stores |
|
2105 |
* the current flash mode and scene. |
|
2106 |
*/ |
|
2107 |
void SaveFlashMode(); |
|
2108 |
||
2109 |
/** |
|
2110 |
* Called when switching to single image capture mode. Restores |
|
2111 |
* flash mode, if using same scene mode as was used when the |
|
2112 |
* flash mode was stored. Otherwise clears the stored info. |
|
2113 |
*/ |
|
2114 |
void RestoreFlashMode(); |
|
2115 |
||
2116 |
public: |
|
2117 |
/** |
|
2118 |
* Returns a pointer to dynamic Configuration Manager. |
|
2119 |
* |
|
2120 |
* Never NULL if ConstructL has been executed successfully. |
|
2121 |
* @return Pointer to Configuration Manager |
|
2122 |
*/ |
|
2123 |
CCamConfiguration* Configuration() const; |
|
2124 |
||
2125 |
||
2126 |
/** |
|
2127 |
* Returns whether or not the keylock is on |
|
2128 |
* @since 5.0 |
|
2129 |
* @return ETrue if keylock is on, otherwise EFalse |
|
2130 |
*/ |
|
2131 |
TBool IsKeyLockOn(); |
|
2132 |
||
2133 |
/** |
|
2134 |
* Used to get whether user is sliding in the self timer preview. |
|
2135 |
* @return ETrue if user is sliding in the self timer preview. |
|
2136 |
*/ |
|
2137 |
inline TBool IsSlideInSelfTimerPreview() const { return iSlideInSelfTimerPreview; }; |
|
2138 |
||
2139 |
/** |
|
2140 |
* Used to set whether user is sliding in the self timer preview. |
|
2141 |
* @param aValue the value to indicate whether user is sliding in the self timer preview. |
|
2142 |
*/ |
|
2143 |
inline void SetSlideInSelfTimerPreview( TBool aValue ) { iSlideInSelfTimerPreview = aValue; }; |
|
2144 |
||
2145 |
/** |
|
2146 |
* Used to get the current storage. |
|
2147 |
* @return the current storage. |
|
2148 |
*/ |
|
2149 |
TCamMediaStorage CurrentStorage(); |
|
2150 |
||
2151 |
/** |
|
2152 |
* Returns whether autofocus is still needed before capturing. |
|
2153 |
* @return ETrue if it's necessary to try autofocus one more time before the capture. |
|
2154 |
*/ |
|
2155 |
TBool IsAfNeeded(); |
|
2156 |
||
2157 |
/** |
|
2158 |
* Sets an autofocus needed flag, so that autofocus is done after cancel and range set are finished. |
|
2159 |
*/ |
|
2160 |
void SetAfNeeded( TBool aAfNeeded ); |
|
2161 |
||
2162 |
/** |
|
2163 |
* Returns whether recording was stopped because USB was connected. |
|
2164 |
* @return ETrue if video recording was stopped because USB was connected. |
|
2165 |
*/ |
|
2166 |
TBool IsCaptureStoppedForUsb(); |
|
2167 |
||
2168 |
/** |
|
2169 |
* set the flag of iSetCaptureStoppedForUsb. |
|
2170 |
*/ |
|
2171 |
void SetCaptureStoppedForUsb( TBool aCaptureStoppedForUsb ); |
|
2172 |
||
2173 |
/** |
|
2174 |
* Cancels the memory card dismount monitoring |
|
2175 |
*/ |
|
2176 |
void CancelDismountMonitoring(); |
|
2177 |
||
2178 |
/** |
|
2179 |
* Start the memory card dismount monitoring |
|
2180 |
*/ |
|
2181 |
void StartDismountMonitoring(); |
|
2182 |
||
2183 |
/** |
|
2184 |
* Returns whether all snapshots have been received in burst mode |
|
2185 |
* @return ETrue if all snapshots have been received in burst mode. |
|
2186 |
*/ |
|
2187 |
TBool AllSnapshotsReceived(); |
|
2188 |
||
2189 |
/** |
|
2190 |
* Returns the last made autofocusrequest type or 0, if there are |
|
2191 |
* no pending autofocus requests. |
|
2192 |
*/ |
|
2193 |
TInt PendingAFRequest(); |
|
2194 |
||
2195 |
/** |
|
2196 |
* Calculates the remaining video recording time based on video |
|
2197 |
* quality settings (instead of getting the value from camera |
|
2198 |
* controller) |
|
2199 |
* @param aStorage TCamMediaStorage enum specifying the type of storage; |
|
2200 |
* default=ECamMediaStorageCurrent |
|
2201 |
* @return remaining time |
|
2202 |
*/ |
|
2203 |
TTimeIntervalMicroSeconds |
|
2204 |
CalculateVideoTimeRemainingL( TCamMediaStorage |
|
2205 |
aStorage = ECamMediaStorageCurrent); |
|
2206 |
/** |
|
2207 |
* Sets orientation of the application to CCamera |
|
2208 |
* |
|
2209 |
*/ |
|
2210 |
void SetCameraOrientationModeL( TInt aOrientation ); |
|
2211 |
||
2212 |
/** |
|
2213 |
* Final part in constructing cameracontroller |
|
2214 |
* |
|
2215 |
*/ |
|
2216 |
void CompleteCameraConstructionL(); |
|
2217 |
||
2218 |
/** |
|
2219 |
* Returns index of current image. |
|
2220 |
*/ |
|
2221 |
TInt CurrentImageIndex(); |
|
2222 |
||
2223 |
/** |
|
2224 |
* Sets the value defining the need for CAE video init and prepare |
|
2225 |
*/ |
|
2226 |
void SetVideoInitNeeded( TBool aVideoInitNeeded ); |
|
2227 |
||
2228 |
/** |
|
2229 |
* Returns the value defining the need for CAE video init and prepare |
|
2230 |
*/ |
|
2231 |
TBool VideoInitNeeded(); |
|
2232 |
||
2233 |
/** |
|
2234 |
* Stores the UserScene settings |
|
2235 |
*/ |
|
2236 |
void StoreUserSceneSettingsL(); |
|
2237 |
||
2238 |
/** |
|
2239 |
* Toggles between highest 16:9 and 4:3 quality levels. |
|
2240 |
*/ |
|
2241 |
TBool ToggleWideScreenQuality( TBool aWide ); |
|
2242 |
||
2243 |
/** |
|
2244 |
* Returns the value of iSaveStarted |
|
2245 |
*/ |
|
2246 |
TBool IsSaveStarted(); |
|
2247 |
||
2248 |
/** |
|
2249 |
* Getter for iIssueModeChangeSequenceSucceeded |
|
2250 |
*/ |
|
2251 |
TBool IssueModeChangeSequenceSucceeded(); |
|
2252 |
||
2253 |
/** |
|
2254 |
* Initiates startup sequence in embedded mode |
|
2255 |
*/ |
|
2256 |
void EmbeddedStartupSequence(); |
|
2257 |
||
2258 |
/** |
|
2259 |
* Called by the snapshotrotator to indicate when snapshot |
|
2260 |
* is rotated and ready for drawing |
|
2261 |
*/ |
|
2262 |
void SnapshotRotationComplete(); |
|
2263 |
||
2264 |
/** |
|
2265 |
* Method to retrieve Remaining Recording time from CCaeEngine |
|
2266 |
*/ |
|
2267 |
TTimeIntervalMicroSeconds RemainingVideoRecordingTime(); |
|
2268 |
||
2269 |
||
2270 |
/** |
|
2271 |
* Handles hdmi connect event during recording after video stop |
|
2272 |
*/ |
|
2273 |
void HandlePostHdmiConnectDuringRecordingEventL(); |
|
2274 |
||
2275 |
/** |
|
2276 |
* Sets a Pending Hdmi Event |
|
2277 |
*/ |
|
2278 |
void SetPendingHdmiEvent( TCamHdmiEvent aPendingHdmiEvent ); |
|
2279 |
||
2280 |
/** |
|
2281 |
* Handles the current pending Hdmi EVent |
|
2282 |
*/ |
|
2283 |
void HandlePendingHdmiEvent(); |
|
2284 |
||
2285 |
/** |
|
2286 |
* Returns ETrue when scene mode is forced to |
|
2287 |
* "Automatic" by secondary camera |
|
2288 |
*/ |
|
2289 |
TBool SceneModeForcedBySecondaryCamera(); |
|
2290 |
||
2291 |
/** |
|
2292 |
* Set value defining if capturing with touch capture button |
|
2293 |
*/ |
|
2294 |
void SetTouchCapture( TBool aTouchCapture ); |
|
62
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2295 |
|
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2296 |
/** |
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2297 |
* Set value used for idle timeout |
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2298 |
* @param aLong should idle timer be long |
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2299 |
*/ |
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2300 |
void SetIdleTimerTimeout( TBool aLong = EFalse ); |
54 | 2301 |
private: |
2302 |
||
2303 |
// ----------------------------------------------------- |
|
2304 |
// Construction parts |
|
2305 |
||
2306 |
void ConstructCameraControllerL( TInt aCameraIndex ); |
|
2307 |
||
2308 |
// ----------------------------------------------------- |
|
2309 |
// Helper utility methods |
|
2310 |
TInt GetCriticalMemoryLevelL( const TCamMediaStorage& aStorage ); |
|
2311 |
||
2312 |
// ----------------------------------------------------- |
|
2313 |
// Events and requests handling |
|
2314 |
void EventHandlingErrorRecovery( TInt aError ); |
|
2315 |
||
2316 |
void HandleSequenceEventL( TInt aStatus, |
|
2317 |
TCamCameraEventId aEventId, |
|
2318 |
TAny* aEventData ); |
|
2319 |
||
2320 |
void HandleRequestEventL( TInt aStatus, |
|
2321 |
TCamCameraEventId aEventId, |
|
2322 |
TAny* aEventData ); |
|
2323 |
||
2324 |
void HandleSettingEventL( TInt aStatus, |
|
2325 |
TCamCameraEventId aEventId, |
|
2326 |
TAny* aEventData ); |
|
2327 |
||
2328 |
void HandleImageCaptureEventL( TInt aStatus, |
|
2329 |
CCamBufferShare* aShare ); |
|
2330 |
void HandleImageStopEventL( TInt aStatus, |
|
2331 |
TInt aFullCaptureCount ); |
|
2332 |
||
2333 |
void HandleViewfinderFrame( TInt aStatus, CFbsBitmap* aFrame ); |
|
2334 |
void HandleSnapshotEvent( TInt aStatus, CFbsBitmap* aBitmap ); |
|
2335 |
void HandleVideoAsyncStopEvent( TInt aStatus ); |
|
2336 |
void HandleVideoStopEvent( TInt aStatus ); |
|
2337 |
||
2338 |
void IssueModeChangeSequenceL( TBool aStartup = EFalse ); |
|
2339 |
void GenerateModeChangeSequenceL( RCamRequestArray& aSequence ); |
|
2340 |
void GenerateStartupSequenceL( RCamRequestArray& aSequence ); |
|
2341 |
||
2342 |
void IssueRequestL( const TCamCameraRequestId& aId ); |
|
2343 |
void IssueDirectRequestL( const TCamCameraRequestId& aId ); |
|
2344 |
void IssueSettingsChangeRequestL(); |
|
2345 |
||
2346 |
void ProceedPendingOrNotifyReadyL(); |
|
2347 |
||
2348 |
void DoVideoNameRetryL( TInt aStatus ); |
|
2349 |
||
2350 |
/** |
|
2351 |
* Sets the current image/video settings from UI to camera, by calling |
|
2352 |
* RestoreSettingIfNecessaryL for each supported setting, and starting |
|
2353 |
* the setting process if any of them needs setting. |
|
2354 |
* This function needs to be called after camera release and switches |
|
2355 |
* between image/video mode. |
|
2356 |
*/ |
|
2357 |
void RestoreSettingsToCameraL(); |
|
2358 |
||
2359 |
/** |
|
2360 |
* Checks if the setting needs restoring (UI setting value doesn't match |
|
2361 |
* the actual setting value in camera). In that case, function adds |
|
2362 |
* this setting to the list of pending settings. |
|
2363 |
* @param aSettingItem Setting item id |
|
2364 |
*/ |
|
2365 |
void RestoreSettingIfNecessaryL( TCamSettingItemIds aSettingItem ); |
|
2366 |
||
2367 |
/** |
|
2368 |
* Checks if the setting needs restoring (UI setting value doesn't match |
|
2369 |
* the actual setting value in camera). In that case, function |
|
2370 |
* directly set settting to camera |
|
2371 |
* @param aSettingItem Setting item id |
|
2372 |
*/ |
|
2373 |
void DirectRestoreSettingIfNecessaryL( TCamSettingItemIds aSettingItem ); |
|
2374 |
||
2375 |
/** |
|
2376 |
* Set internal state based on camera event. |
|
2377 |
*/ |
|
2378 |
void SetStateFromEvent( TCamCameraEventId aEventId ); |
|
2379 |
||
2380 |
void InitCaptureLimitL(); |
|
2381 |
||
2382 |
static TCamCameraRequestId |
|
2383 |
NextRequestL( const TCamCameraState& aFrom, |
|
2384 |
const TCamCameraState& aTo ); |
|
2385 |
||
2386 |
static TCamCameraEventId |
|
2387 |
ResponseForRequest( const TCamCameraRequestId& aRequestId ); |
|
2388 |
||
2389 |
||
2390 |
/** |
|
2391 |
* Called when mmc is about to be dismounted |
|
2392 |
*/ |
|
2393 |
TInt DriveChangeL( TCamDriveChangeType aType ); |
|
2394 |
||
2395 |
/** |
|
2396 |
* Rotate the snapshot copy before thumbnail creation |
|
2397 |
*/ |
|
2398 |
void RotateSnapshotL(); |
|
2399 |
||
2400 |
/** |
|
2401 |
* Handle change in image quality setting. |
|
2402 |
* Handle stopping viewfinder, re-preparing quality and |
|
2403 |
* restarting viewfinder if viewfinder is running. |
|
2404 |
* Notify observers about quality change. |
|
2405 |
*/ |
|
2406 |
void HandleImageQualitySettingChangeL(); |
|
2407 |
||
2408 |
/** |
|
2409 |
* Handle change in video quality setting. |
|
2410 |
* Handle stopping viewfinder, re-preparing quality and |
|
2411 |
* restarting viewfinder if viewfinder is running. |
|
2412 |
* Notify observers about quality change. |
|
2413 |
*/ |
|
2414 |
void HandleVideoQualitySettingChangeL(); |
|
2415 |
||
2416 |
// ======================================================= |
|
2417 |
private: // Data |
|
2418 |
TBool iValueIsStored; |
|
2419 |
CCamCameraController* iCameraController; |
|
2420 |
CCamSettingProvider* iSettingProvider; |
|
2421 |
||
2422 |
TUint iBusyFlags; // TCamBusyFlags values |
|
2423 |
TCamAppControllerInfo iInfo; |
|
2424 |
||
2425 |
// Temporarily stop notifications to observers |
|
2426 |
TBool iMuteNotifications; |
|
2427 |
||
2428 |
// Observers of controller events |
|
2429 |
RPointerArray<MCamControllerObserver> iControllerObservers; |
|
2430 |
TInt iCameraReferences; |
|
2431 |
||
2432 |
// The settings model for dynamic and static data. |
|
2433 |
// CCamSettingsModelBase* iSettingsModel; |
|
2434 |
MCamSettingsModel* iSettingsModel; |
|
2435 |
MCamSettingPreviewHandler* iSettingsPreviewHandler; // Currently same object as iSettingsModel. |
|
2436 |
RArray<TCamSettingItemIds> iPreviewRollbacks; // Used when cancelling previews. |
|
2437 |
||
2438 |
// Used to indicate whether user is sliding in the self timer preview. |
|
2439 |
TBool iSlideInSelfTimerPreview; |
|
2440 |
||
2441 |
TBool iVideoPrepareNeeded; // Video re-prepare needed due to setting change |
|
2442 |
||
2443 |
// Boolean to record if view finder should be frozen at next frame |
|
2444 |
TBool iFreezeViewFinder; |
|
2445 |
// Boolean to indicate that the frozen frame should be updated |
|
2446 |
TBool iUpdateFrozenFrame; |
|
2447 |
||
2448 |
// name for next file, including path and extension |
|
2449 |
TFileName iSuggestedVideoPath; |
|
2450 |
// Used to indicate that the media storage has been changed tbe |
|
2451 |
// pathnames need to be checked |
|
2452 |
TCamMediaStorage iSetNewPathnamesPending; |
|
2453 |
// Counters used for creating multiple month folders |
|
2454 |
TInt iMonthFolderCounters[CCamFolderUtility::ECamFolderTypeLast]; |
|
2455 |
// Counter for image number. |
|
2456 |
// Stored locally to avoid performance problems during burst. |
|
2457 |
TInt iImageNumberCache; |
|
2458 |
||
2459 |
// Whether or not the engine is initialized for video recording |
|
2460 |
TBool iVideoRecorderInitialized; |
|
2461 |
||
2462 |
// estimate of record time elapsed |
|
2463 |
TTimeIntervalMicroSeconds iVideoTimeElapsed; |
|
2464 |
// estimate of record time remaining |
|
2465 |
TTimeIntervalMicroSeconds iVideoTimeRemaining; |
|
2466 |
||
2467 |
// Whether or not a capture mode transition is in progress |
|
2468 |
TBool iCaptureModeTransitionInProgress; |
|
2469 |
||
2470 |
// Active object for saving images to file asynchronously |
|
2471 |
CCamImageSaveActive* iImageSaveActive; |
|
2472 |
// Array containing data that represents the images in a burst capture |
|
2473 |
CCamBurstCaptureArray* iCaptureArray; |
|
2474 |
// Index into burst capture array used to determine current image for |
|
2475 |
// SnapshotImage(), CurrentImageName(), CurrentFullFileName() and |
|
2476 |
// DeleteCurrentFile(). Set by call to SetAsCurrentImage(). |
|
2477 |
// Single capture and video always use index 0. |
|
2478 |
TInt iCurrentImageIndex; |
|
2479 |
// Filenames for a timelapse sequence used for the delete sequence option |
|
2480 |
CDesCArray* iSequenceFilenameArray; |
|
2481 |
// Tracks usage of the capture array, for timely release of memory |
|
2482 |
TInt iArrayUsageCount; |
|
2483 |
// Capture count requested. |
|
2484 |
// Used in burst and self-timer+timelapse modes. |
|
2485 |
TInt iRequestedCaptureCount; |
|
2486 |
// Indicates wheter autofocuscancel requests should be handled or not.. |
|
2487 |
// Used in CancelFocusAndCapture. |
|
2488 |
TBool iNoBurstCancel; |
|
2489 |
||
2490 |
// Indicates if capturekey has been raised or not. This is used to |
|
2491 |
// determine if bursttimer should be activated or not. |
|
2492 |
TBool iKeyUP; |
|
2493 |
||
2494 |
// Timer to control when short burst is changed to press and hold burst. |
|
2495 |
CCamTimer* iBurstTimer; |
|
2496 |
// Timer for switch to standby mode |
|
2497 |
CCamTimer* iIdleTimer; |
|
2498 |
// Timer for initiating Time Lapse captures |
|
2499 |
CCamTimer* iTimeLapseTimer; |
|
2500 |
||
2501 |
// Status variable for location trail |
|
2502 |
TBool iLocationTrailStarted; |
|
2503 |
||
2504 |
// Timer for stopping location trail |
|
2505 |
CCamTimer* iLocationTrailTimer; |
|
2506 |
||
2507 |
// Whether or not a capture key pressed during image saving |
|
2508 |
TBool iCaptureKeyPressedWhileImageSaving; |
|
2509 |
// flag to indicate current VF status |
|
2510 |
TBool iViewFinding; |
|
2511 |
// timer to keep backlight active while VF is running |
|
2512 |
CPeriodic* iBacklightTimer; |
|
2513 |
// Class for playing sounds |
|
2514 |
CCamAudioPlayerController* iSoundPlayer; |
|
2515 |
CRepository* iRepository; |
|
2516 |
TInt iDiskCriticalLevel; // critical threshold for card storage |
|
2517 |
TInt iRamDiskCriticalLevel; // critical threshold for phone memory storage |
|
2518 |
// Whether we are currently in a call or ringing |
|
2519 |
TBool iInCallOrRinging; |
|
2520 |
// Keep track of whether we are currently saving a video clip or image |
|
2521 |
TBool iSaving; |
|
2522 |
TBool iSaveStarted; |
|
2523 |
// Keep track of whether a ReleaseEngine call has been made while an Init call has been made |
|
2524 |
TBool iPendingRelease; |
|
2525 |
TBool iEndKeyWaiting; |
|
2526 |
TBool iCompleteTimeLapsePending; |
|
2527 |
TBool iAutoFocusRequested; |
|
2528 |
TBool iCaptureRequested; |
|
2529 |
TBool iVideoRequested; |
|
2530 |
TBool iAfNeeded; |
|
2531 |
||
2532 |
TBool iDemandKeyRelease; // Demand to release capture key |
|
2533 |
||
2534 |
// Keep track of the camera that the next switch will activate |
|
2535 |
TInt iNextSwitchIsToPrimaryCamera; |
|
2536 |
||
2537 |
// Flag for queued Camera switch operation |
|
2538 |
TCameraSwitchRequired iCameraSwitchRequired; |
|
2539 |
||
2540 |
TBool iForceUseOfPhoneMemory; |
|
2541 |
||
2542 |
// Keeps track of the number of times we have attempted to set the video name |
|
2543 |
TInt iVideoNameRetries; |
|
2544 |
||
2545 |
// Specified whether an image save request is pending. That is, |
|
2546 |
// we are waiting for the engine to return with an image that can be saved. |
|
2547 |
// Required to let post-capture know whether an image has been saved yet. |
|
2548 |
TBool iImageSaveRequestPending; |
|
2549 |
||
2550 |
// Keeps track of the camera slider state so that |
|
2551 |
// we don't have to keep accessing the shared data file |
|
2552 |
TInt iSlideState; |
|
2553 |
TInt iNewSlideState; |
|
2554 |
||
2555 |
// callback used for delayed slider update |
|
2556 |
CPeriodic* iSliderCallBack; |
|
2557 |
||
2558 |
// Slider event flag |
|
2559 |
TBool iSliderCloseEvent; |
|
2560 |
||
2561 |
// The period between each timelapse capture |
|
2562 |
TTimeIntervalMicroSeconds iTimeLapseInterval; |
|
2563 |
// The time at which the previous timelapse capture was initiated |
|
2564 |
TTime iTimeLapseStartTime; |
|
2565 |
||
2566 |
||
2567 |
||
2568 |
CSensrvChannel* iAccSensorChannel; |
|
2569 |
TBool iAccSensorListening; |
|
2570 |
TBool iAccSensorInfoInitialized; |
|
2571 |
// Flag to allow delayed re-preparation of engine |
|
2572 |
TBool iOrientationChangeOccured; |
|
2573 |
||
2574 |
// Outside flags, as available for Camera Controller at all times. |
|
2575 |
TCamImageOrientation iImageOrientation; |
|
2576 |
TCamImageOrientation iLastImageOrientation; |
|
2577 |
||
62
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2578 |
// Idle timeout for paused videorecording. |
f0c0788c4de2
Revision: 201035
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
54
diff
changeset
|
2579 |
TInt iLongIdleTimeout; |
54 | 2580 |
// Property watcher to report changes in the slide state |
2581 |
CCamPropertyWatcher* iSlideStateWatcher; |
|
2582 |
// Property watcher to report changes in the keylock state |
|
2583 |
CCamPropertyWatcher* iKeyLockStatusWatcher; |
|
2584 |
// Property watcher to report changes in the profile state |
|
2585 |
CCamPropertyWatcher* iProfileStatusWatcher; |
|
2586 |
// Set to ETrue if shutter sound always played |
|
2587 |
// otherwise playing shutter sound depends on |
|
2588 |
// current profile |
|
2589 |
TBool iShutterSndAlwaysOn; |
|
2590 |
// Active object to listen to the call state. |
|
2591 |
CCamCallStateAo* iCallStateAo; |
|
2592 |
// Organises notifications to observers of capture completion |
|
2593 |
CCamObserverHandler* iCaptureCompletionObserverHandler; |
|
2594 |
TInt iActualBurst; |
|
2595 |
CCamTimer* iCaptureToneDelayTimer; |
|
2596 |
// Whether or not the video was stopped due to the phone app |
|
2597 |
// having the foreground |
|
2598 |
TBool iVideoStoppedForPhoneApp; |
|
2599 |
// used to simulate the receipt of a viewfinder frame when |
|
2600 |
// timelapse capturing. |
|
2601 |
CFbsBitmap* iSnapShotCopy; |
|
2602 |
// estimated snapshot size in bytes - used when monitoring free |
|
2603 |
// RAM during burst capture |
|
2604 |
TInt iSnapshotDataSize; |
|
2605 |
// array of estimated jpeg sizes in bytes for different image |
|
2606 |
// resolutions - used when monitoring free RAM during burst capture |
|
2607 |
RArray<TInt> iJpegDataSizes; |
|
2608 |
// array of estimated post capture sizes required in bytes for |
|
2609 |
// different image resolutions - used when monitoring free RAM |
|
2610 |
// during burst capture |
|
2611 |
RArray<TInt> iSequencePostProcessDataSizes; |
|
2612 |
// Array of CameraEventInterested observers which wanted to be camera |
|
2613 |
// observers when camera wasn't yet created. When camera is created |
|
2614 |
// Observers from this array should be attached first and array should |
|
2615 |
// be cleared. |
|
2616 |
RArray<const MCamCameraObserver*> iPendingObserversArray; |
|
2617 |
RArray<TUint> iCameraEventInterested; |
|
2618 |
||
2619 |
// Used to wake the camera hardware approximately 2-3 seconds before |
|
2620 |
// a timelapse capture |
|
2621 |
TBool iCameraWoken; |
|
2622 |
TBool iZoomWaitingForCamera; |
|
2623 |
TBool iNewZoomPending; |
|
2624 |
TInt iDesiredZoomVal; |
|
2625 |
||
2626 |
TBool iSequenceCaptureInProgress; |
|
2627 |
TInt iLongSequenceLimit; |
|
2628 |
||
2629 |
// Boolean to determine whether filename has already been |
|
2630 |
// reserved for the image being currently captured. Reserving |
|
2631 |
// is done when either the image's snapshot snapshot or |
|
2632 |
// image data arrives. (But not again when the other one comes) |
|
2633 |
TBool iFilenameReserved; |
|
2634 |
TCamEvCompRange iEvRange; |
|
2635 |
||
2636 |
#if defined(RD_MDS_2_5) && !defined(__WINSCW__) |
|
2637 |
RLocationTrail iLocationUtility; |
|
2638 |
TBool iLocationUtilityConnected; |
|
2639 |
#endif // __WINSCW__ |
|
2640 |
||
2641 |
#ifdef CAMERAAPP_PERFORMANCE_MEASUREMENT |
|
2642 |
TCamPerformanceState iPerformanceState; |
|
2643 |
#endif |
|
2644 |
||
2645 |
TBool iAppUiAvailable; |
|
2646 |
// If this boolean is set to true, the next focus successful |
|
2647 |
// or focus failed event should be ignored as it's resulted by |
|
2648 |
// moving lens to hyperfocal position when cancelling AF. |
|
2649 |
TBool iAFCancelInProgress; |
|
2650 |
// Holds last made autofocusrequest type or 0, if there are no |
|
2651 |
// pending autofocus requests. |
|
2652 |
TInt iPendingAFRequest; |
|
2653 |
// AFrequest currently in processing. |
|
2654 |
TInt iCurrentAFRequest; |
|
2655 |
CCamFlashStatus* iFlashStatus; |
|
2656 |
TBool iFlashModeSaved; |
|
2657 |
TCamSceneId iSavedFlashScene; |
|
2658 |
TCamFlashId iSavedFlashMode; |
|
2659 |
TBool iSettingsRestoreNeeded; |
|
2660 |
CCamConfiguration* iConfiguration; //< Configuration Manager. *owned* |
|
2661 |
CCFClient* iContextFwClient; |
|
2662 |
TBool iDefineContextSuccessful; |
|
2663 |
TBool iStorageChangeProcessOngoing; |
|
2664 |
// own. |
|
67
756ad29ed18e
Revision: 201039
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
62
diff
changeset
|
2665 |
CCamGSInterface* iPlugin; |
54 | 2666 |
TBool iSilentProfile; |
2667 |
TInt iTimeLapseCaptureCount; |
|
2668 |
RFs iFs; |
|
2669 |
CCamDriveChangeNotifier* iDriveChangeNotifier; |
|
2670 |
TCamMediaStorage iCurrentStorage; |
|
2671 |
TCamMediaStorage iPreferredStorageLocation; |
|
2672 |
TCamMediaStorage iForcedStorageLocation; |
|
2673 |
TCamMediaStorage iInitialVideoStorageLocation; |
|
2674 |
TBool iCaptureStoppedForUsb; |
|
2675 |
TBool iDismountPending; |
|
2676 |
TBool iAllSnapshotsReceived; |
|
2677 |
CCamTimer* iDeepSleepTimer; // own |
|
2678 |
TBool iDeepSleepTimerExpired; |
|
2679 |
// not owned by camappcontroller |
|
2680 |
CCameraUiConfigManager* iConfigManager; |
|
2681 |
TBool iVideoInitNeeded; // Used to decide if the need to call CAE video init |
|
2682 |
CCamSyncRotatorAo* iRotatorAo; |
|
2683 |
CFbsBitmap* iRotatedSnapshot; |
|
2684 |
CCamBurstCaptureArray* iRotationArray; |
|
2685 |
CCamSnapShotRotator* iSnapShotRotator; |
|
2686 |
// orientation at capture time |
|
2687 |
TCamImageOrientation iCaptureOrientation; |
|
2688 |
||
2689 |
TBool iIssueModeChangeSequenceSucceeded; |
|
2690 |
||
2691 |
CCamTvAccessoryMonitor* iTvAccessoryMonitor; |
|
2692 |
||
2693 |
TBool iHdmiCableConnectedDuringRecording; |
|
2694 |
||
2695 |
TBool iSnapshotRedrawNeeded; |
|
2696 |
||
2697 |
TCamHdmiEvent iPendingHdmiEvent; |
|
2698 |
||
2699 |
TBool iSceneModeForcedBySecondaryCamera; |
|
2700 |
||
2701 |
TBool iTouchCapture; |
|
2702 |
||
2703 |
}; |
|
2704 |
||
2705 |
#endif // CAMAPPCONTROLLER_H |
|
2706 |
||
2707 |
// End of File |