utilityapps/screengrabber/inc/sgengine.h
author hgs
Mon, 18 Oct 2010 16:30:05 +0300
changeset 55 2d9cac8919d3
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
55
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description: 
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#ifndef SGENGINE_H
hgs
parents:
diff changeset
    19
#define SGENGINE_H
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
// INCLUDES
hgs
parents:
diff changeset
    23
#include <e32std.h>
hgs
parents:
diff changeset
    24
#include <e32base.h>
hgs
parents:
diff changeset
    25
#include <f32file.h>
hgs
parents:
diff changeset
    26
#include <w32std.h>
hgs
parents:
diff changeset
    27
#include <mdaaudiotoneplayer.h> 
hgs
parents:
diff changeset
    28
#include <qsymbianevent.h>
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
hgs
parents:
diff changeset
    31
class CFrameImageData;
hgs
parents:
diff changeset
    32
class CDictionaryFileStore;
hgs
parents:
diff changeset
    33
class CImageEncoder;
hgs
parents:
diff changeset
    34
class EngineWrapper;
hgs
parents:
diff changeset
    35
hgs
parents:
diff changeset
    36
hgs
parents:
diff changeset
    37
// setting keys (do not change uids of existing keys to maintain compatibility to older versions!)
hgs
parents:
diff changeset
    38
const TUid KSGSettingCaptureMode                            = { 0x00 };
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
const TUid KSGSettingSingleCaptureHotkey                    = { 0x01 };
hgs
parents:
diff changeset
    41
const TUid KSGSettingSingleCaptureImageFormat               = { 0x02 };
hgs
parents:
diff changeset
    42
const TUid KSGSettingSingleCaptureMemoryInUseMultiDrive     = { 0x04 };
hgs
parents:
diff changeset
    43
const TUid KSGSettingSingleCaptureFileName                  = { 0x05 };
hgs
parents:
diff changeset
    44
hgs
parents:
diff changeset
    45
const TUid KSGSettingSequantialCaptureHotkey                = { 0x06 };
hgs
parents:
diff changeset
    46
const TUid KSGSettingSequantialCaptureImageFormat           = { 0x07 };
hgs
parents:
diff changeset
    47
const TUid KSGSettingSequantialCaptureDelay                 = { 0x08 };
hgs
parents:
diff changeset
    48
const TUid KSGSettingSequantialCaptureMemoryInUseMultiDrive = { 0x0A };
hgs
parents:
diff changeset
    49
const TUid KSGSettingSequantialCaptureFileName              = { 0x0B };
hgs
parents:
diff changeset
    50
hgs
parents:
diff changeset
    51
const TUid KSGSettingVideoCaptureHotkey                     = { 0x0C };
hgs
parents:
diff changeset
    52
const TUid KSGSettingVideoCaptureVideoFormat                = { 0x0D };
hgs
parents:
diff changeset
    53
const TUid KSGSettingVideoCaptureMemoryInUseMultiDrive      = { 0x0F };
hgs
parents:
diff changeset
    54
const TUid KSGSettingVideoCaptureFileName                   = { 0x10 };
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
const TUid KUidScreenGrabber = { 0x101FB751 };
hgs
parents:
diff changeset
    57
hgs
parents:
diff changeset
    58
hgs
parents:
diff changeset
    59
#define TRANSPARENCY_INDEX 30
hgs
parents:
diff changeset
    60
#define TRANSPARENCY_ALTERNATIVE_INDEX 24
hgs
parents:
diff changeset
    61
hgs
parents:
diff changeset
    62
enum TScreenGrabberSettingCaptureModes
hgs
parents:
diff changeset
    63
    {
hgs
parents:
diff changeset
    64
    ECaptureModeSingleCapture = 0,
hgs
parents:
diff changeset
    65
    ECaptureModeSequantialCapture,
hgs
parents:
diff changeset
    66
    ECaptureModeVideoCapture
hgs
parents:
diff changeset
    67
    };
hgs
parents:
diff changeset
    68
    
hgs
parents:
diff changeset
    69
enum TScreenGrabberSettingHotkeys
hgs
parents:
diff changeset
    70
    {
hgs
parents:
diff changeset
    71
    EHotkeySendKey = 0,
hgs
parents:
diff changeset
    72
    EHotkeyPowerKey,
hgs
parents:
diff changeset
    73
    EHotkeySideKey,
hgs
parents:
diff changeset
    74
    EHotkeyCameraKey1
hgs
parents:
diff changeset
    75
    };
hgs
parents:
diff changeset
    76
hgs
parents:
diff changeset
    77
enum TScreenGrabberSettingImageFormats
hgs
parents:
diff changeset
    78
    {
hgs
parents:
diff changeset
    79
    EImageFormatPNG = 0,
hgs
parents:
diff changeset
    80
    EImageFormatJPGHQ,
hgs
parents:
diff changeset
    81
    EImageFormatJPGLQ,
hgs
parents:
diff changeset
    82
    EImageFormatBMP,
hgs
parents:
diff changeset
    83
    EImageFormatGIF,
hgs
parents:
diff changeset
    84
    EImageFormatMBM
hgs
parents:
diff changeset
    85
    };
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
enum TScreenGrabberSettingVideoFormats
hgs
parents:
diff changeset
    88
    {
hgs
parents:
diff changeset
    89
    EVideoFormatAnimatedGIF = 0
hgs
parents:
diff changeset
    90
    };
hgs
parents:
diff changeset
    91
hgs
parents:
diff changeset
    92
enum TScreenGrabberSettingMultiDrive
hgs
parents:
diff changeset
    93
	{
hgs
parents:
diff changeset
    94
	EPhoneMemory = 0,
hgs
parents:
diff changeset
    95
	EMemoryCard
hgs
parents:
diff changeset
    96
	};
hgs
parents:
diff changeset
    97
	
hgs
parents:
diff changeset
    98
hgs
parents:
diff changeset
    99
class TGrabSettings
hgs
parents:
diff changeset
   100
    {
hgs
parents:
diff changeset
   101
public:
hgs
parents:
diff changeset
   102
    TInt            iCaptureMode;
hgs
parents:
diff changeset
   103
    
hgs
parents:
diff changeset
   104
    TInt            iSingleCaptureHotkey;
hgs
parents:
diff changeset
   105
    TInt            iSingleCaptureImageFormat;
hgs
parents:
diff changeset
   106
    TInt            iSingleCaptureMemoryInUseMultiDrive;
hgs
parents:
diff changeset
   107
    TFileName       iSingleCaptureFileName;
hgs
parents:
diff changeset
   108
hgs
parents:
diff changeset
   109
    TInt            iSequantialCaptureHotkey;
hgs
parents:
diff changeset
   110
    TInt            iSequantialCaptureImageFormat;
hgs
parents:
diff changeset
   111
    TInt            iSequantialCaptureDelay;
hgs
parents:
diff changeset
   112
    TInt            iSequantialCaptureMemoryInUseMultiDrive;
hgs
parents:
diff changeset
   113
    TFileName       iSequantialCaptureFileName;
hgs
parents:
diff changeset
   114
hgs
parents:
diff changeset
   115
    TInt            iVideoCaptureHotkey;
hgs
parents:
diff changeset
   116
    TInt            iVideoCaptureVideoFormat;
hgs
parents:
diff changeset
   117
    TInt		    iVideoCaptureMemoryInUseMultiDrive;
hgs
parents:
diff changeset
   118
    TFileName       iVideoCaptureFileName;
hgs
parents:
diff changeset
   119
    };
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
class TVideoFrame
hgs
parents:
diff changeset
   122
    {
hgs
parents:
diff changeset
   123
public:
hgs
parents:
diff changeset
   124
    TUint       iWidth;
hgs
parents:
diff changeset
   125
    TUint       iHeight;
hgs
parents:
diff changeset
   126
    TUint       iXPos;
hgs
parents:
diff changeset
   127
    TUint       iYPos;
hgs
parents:
diff changeset
   128
    TUint       iDelay; // 1000 = 1 sec
hgs
parents:
diff changeset
   129
    TBool       iEnableTransparency;
hgs
parents:
diff changeset
   130
    TBool       iFillsWholeScreen;
hgs
parents:
diff changeset
   131
    TFileName   iFileStorePath;
hgs
parents:
diff changeset
   132
    };
hgs
parents:
diff changeset
   133
hgs
parents:
diff changeset
   134
hgs
parents:
diff changeset
   135
typedef CArrayFixSeg<TVideoFrame> CVideoFrameArray;
hgs
parents:
diff changeset
   136
hgs
parents:
diff changeset
   137
/**
hgs
parents:
diff changeset
   138
 *  CEngine
hgs
parents:
diff changeset
   139
 * 
hgs
parents:
diff changeset
   140
 */
hgs
parents:
diff changeset
   141
class SGEngine : public CActive //, public MMdaAudioToneObserver
hgs
parents:
diff changeset
   142
    {
hgs
parents:
diff changeset
   143
    
hgs
parents:
diff changeset
   144
    // active object states
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
    enum TState 
hgs
parents:
diff changeset
   147
        {
hgs
parents:
diff changeset
   148
        EIdle = 0,              // do nothing
hgs
parents:
diff changeset
   149
        EEncodingImage,         // ICL encoding of an image
hgs
parents:
diff changeset
   150
        ESequenceDelay,         // waiting till next capture
hgs
parents:
diff changeset
   151
        ECancelCapturing,       // asking to cancel capturing
hgs
parents:
diff changeset
   152
        ENextVideoFrame,        // get next frame for video
hgs
parents:
diff changeset
   153
        ECancelVideoCapturing,  // asking to cancel video capturing  
hgs
parents:
diff changeset
   154
        EQueryDelay             // waiting till to remove query
hgs
parents:
diff changeset
   155
        };
hgs
parents:
diff changeset
   156
    
hgs
parents:
diff changeset
   157
public:
hgs
parents:
diff changeset
   158
    // Constructors and destructor
hgs
parents:
diff changeset
   159
hgs
parents:
diff changeset
   160
    /**
hgs
parents:
diff changeset
   161
     * Destructor.
hgs
parents:
diff changeset
   162
     */
hgs
parents:
diff changeset
   163
    ~SGEngine();
hgs
parents:
diff changeset
   164
hgs
parents:
diff changeset
   165
    /**
hgs
parents:
diff changeset
   166
     * Two-phased constructor.
hgs
parents:
diff changeset
   167
     */
hgs
parents:
diff changeset
   168
    static SGEngine* NewL(EngineWrapper *aEngineWrapper);
hgs
parents:
diff changeset
   169
hgs
parents:
diff changeset
   170
    /**
hgs
parents:
diff changeset
   171
     * Two-phased constructor.
hgs
parents:
diff changeset
   172
     */
hgs
parents:
diff changeset
   173
    static SGEngine* NewLC(EngineWrapper *aEngineWrapper);
hgs
parents:
diff changeset
   174
    
hgs
parents:
diff changeset
   175
    /**
hgs
parents:
diff changeset
   176
     * returns current settings
hgs
parents:
diff changeset
   177
     */
hgs
parents:
diff changeset
   178
    inline TGrabSettings GrabSettings(){ return iGrabSettings; };
hgs
parents:
diff changeset
   179
    
hgs
parents:
diff changeset
   180
    /**
hgs
parents:
diff changeset
   181
     * saves settings to engine
hgs
parents:
diff changeset
   182
     */
hgs
parents:
diff changeset
   183
    void SaveSettingsL(const TGrabSettings& aGrabSettings);
hgs
parents:
diff changeset
   184
    
hgs
parents:
diff changeset
   185
    /**
hgs
parents:
diff changeset
   186
     * takes one screen shot
hgs
parents:
diff changeset
   187
     */
hgs
parents:
diff changeset
   188
    bool TakeScreenShotAndSaveL();
hgs
parents:
diff changeset
   189
hgs
parents:
diff changeset
   190
    TBool DriveOK(TDriveNumber aNumber);
hgs
parents:
diff changeset
   191
    
hgs
parents:
diff changeset
   192
    TBool IsDriveMMC(TDriveNumber aDrive);
hgs
parents:
diff changeset
   193
    
hgs
parents:
diff changeset
   194
#if defined(HB_QT_S60_EVENT_FILTER)
hgs
parents:
diff changeset
   195
    TBool HandleCaptureCommandsL(const TWsEvent* aEvent);
hgs
parents:
diff changeset
   196
#else
hgs
parents:
diff changeset
   197
    TBool HandleCaptureCommandsL(const QSymbianEvent *event);
hgs
parents:
diff changeset
   198
#endif
hgs
parents:
diff changeset
   199
	
hgs
parents:
diff changeset
   200
    
hgs
parents:
diff changeset
   201
    void ActivateModelL();
hgs
parents:
diff changeset
   202
    void DeActivateModelL();
hgs
parents:
diff changeset
   203
    void ActivateCaptureKeysL(TBool aChangeKey=EFalse);
hgs
parents:
diff changeset
   204
	void EnableRcpOfFoc(TBool aState);
hgs
parents:
diff changeset
   205
    void LoadSettingsL();
hgs
parents:
diff changeset
   206
	
hgs
parents:
diff changeset
   207
private:
hgs
parents:
diff changeset
   208
hgs
parents:
diff changeset
   209
    void CapturingFinishedL(TInt aErr);
hgs
parents:
diff changeset
   210
hgs
parents:
diff changeset
   211
    void RunL();
hgs
parents:
diff changeset
   212
    void DoCancel();
hgs
parents:
diff changeset
   213
    void SaveVideoL(TInt aErr);
hgs
parents:
diff changeset
   214
    void CleanTemporaryFilesL();
hgs
parents:
diff changeset
   215
    void LoadDFSValueL(CDictionaryFileStore* aDicFS, const TUid& aUid, TInt& aValue);
hgs
parents:
diff changeset
   216
    void LoadDFSValueL(CDictionaryFileStore* aDicFS, const TUid& aUid, TDes& aValue); 
hgs
parents:
diff changeset
   217
hgs
parents:
diff changeset
   218
    void SaveDFSValueL(CDictionaryFileStore* aDicFS, const TUid& aUid, const TInt& aValue);
hgs
parents:
diff changeset
   219
    void SaveDFSValueL(CDictionaryFileStore* aDicFS, const TUid& aUid, const TDes& aValue);
hgs
parents:
diff changeset
   220
hgs
parents:
diff changeset
   221
    void CancelCapturing();
hgs
parents:
diff changeset
   222
    void CaptureFrameForVideoL();
hgs
parents:
diff changeset
   223
	
hgs
parents:
diff changeset
   224
    
hgs
parents:
diff changeset
   225
    /**
hgs
parents:
diff changeset
   226
     * Constructor for performing 1st stage construction
hgs
parents:
diff changeset
   227
     */
hgs
parents:
diff changeset
   228
    SGEngine();
hgs
parents:
diff changeset
   229
hgs
parents:
diff changeset
   230
    /**
hgs
parents:
diff changeset
   231
     * EPOC default constructor for performing 2nd stage construction
hgs
parents:
diff changeset
   232
     */
hgs
parents:
diff changeset
   233
    void ConstructL(EngineWrapper *aEngineWrapper);
hgs
parents:
diff changeset
   234
    
hgs
parents:
diff changeset
   235
    
hgs
parents:
diff changeset
   236
private:
hgs
parents:
diff changeset
   237
	RFs 		  iFileSession;
hgs
parents:
diff changeset
   238
hgs
parents:
diff changeset
   239
    CActiveScheduler* iActiveScheduler;
hgs
parents:
diff changeset
   240
	CActiveSchedulerWait* iWait;
hgs
parents:
diff changeset
   241
 
hgs
parents:
diff changeset
   242
    TGrabSettings           iGrabSettings;              // a simple class to store the settings used in the screen capture
hgs
parents:
diff changeset
   243
    RWindowGroup            iRootWin;                   // application's window group
hgs
parents:
diff changeset
   244
    TInt                    iCapturedKey;               // a handle to the key which is captured
hgs
parents:
diff changeset
   245
    TInt                    iCapturedKeyUnD;            // a handle to the key which is captured, up and down
hgs
parents:
diff changeset
   246
    TInt                    iCapturedKeyHash;           // a handle to the hash key which is captured
hgs
parents:
diff changeset
   247
    TInt                    iCapturedKeyHashUnD;        // a handle to the hash key which is captured, up and down
hgs
parents:
diff changeset
   248
    TBool                   iHashKeyCapturingActivated; // captures hash key is activated    
hgs
parents:
diff changeset
   249
    CFbsBitmap*             iPreviouslyCapturedBitmap;  // a previously captured bitmap
hgs
parents:
diff changeset
   250
    TFileName               iSaveFileName;   
hgs
parents:
diff changeset
   251
    CImageEncoder*          iImageEncoder;              // engine from ICL to do the image conversion// target filename of the taken screen shot
hgs
parents:
diff changeset
   252
    CFrameImageData*        iFrameImageData;            // frame and image block data needed by ICL
hgs
parents:
diff changeset
   253
    TState                  iState;                     // state of this active object
hgs
parents:
diff changeset
   254
    TBool                   iHashKeyDown;               // stores state if hash key is currently down
hgs
parents:
diff changeset
   255
    TBool                   iCapturingInProgress;       // boolean to check if capturing is in progress
hgs
parents:
diff changeset
   256
    TBool                   iStopCapturing;             // boolean to specify if to ask capturing
hgs
parents:
diff changeset
   257
    TUint                   iNumberOfTakenShots;        // a number of the taken screen shots in the sequantial mode
hgs
parents:
diff changeset
   258
    RTimer                  iTimer;                     // a timer for async delays
hgs
parents:
diff changeset
   259
    TUint                   iCurrentFrameNumber;        // a number of taken frames in video mode
hgs
parents:
diff changeset
   260
    TTime                   iPreviousFrameTaken;        // time when the last frame was taken
hgs
parents:
diff changeset
   261
    TSize                   iVideoDimensions;           // dimension of the video
hgs
parents:
diff changeset
   262
    TSize                   iPreviousFrameScreenDimension; // dimension of the screen in previous frame
hgs
parents:
diff changeset
   263
    CVideoFrameArray*       iVideoFrameArray;           // the frames of the video
hgs
parents:
diff changeset
   264
    EngineWrapper*          iEngineWrapper;             // Eninewrapper that is used for communicating between QT and Symbian
hgs
parents:
diff changeset
   265
    };
hgs
parents:
diff changeset
   266
hgs
parents:
diff changeset
   267
hgs
parents:
diff changeset
   268
hgs
parents:
diff changeset
   269
hgs
parents:
diff changeset
   270
hgs
parents:
diff changeset
   271
#endif // SGENGINE_H