epoc32/include/ecamimageprocessing.h
author William Roberts <williamr@symbian.org>
Tue, 16 Mar 2010 16:12:26 +0000
branchSymbian2
changeset 2 2fe1408b6811
parent 0 061f57f2323e
child 4 837f303aceeb
permissions -rw-r--r--
Final list of Symbian^2 public API header files
williamr@2
     1
// Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2
     2
// All rights reserved.
williamr@2
     3
// This component and the accompanying materials are made available
williamr@2
     4
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2
     5
// which accompanies this distribution, and is available
williamr@2
     6
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2
     7
//
williamr@2
     8
// Initial Contributors:
williamr@2
     9
// Nokia Corporation - initial contribution.
williamr@2
    10
//
williamr@2
    11
// Contributors:
williamr@2
    12
//
williamr@2
    13
// Description:
williamr@2
    14
//
williamr@2
    15
williamr@2
    16
williamr@2
    17
williamr@2
    18
/**
williamr@2
    19
 @file	
williamr@2
    20
 @publishedAll
williamr@2
    21
 @released
williamr@2
    22
*/
williamr@2
    23
#ifndef  ECAMIMAGEPROCESSING_H
williamr@2
    24
#define  ECAMIMAGEPROCESSING_H
williamr@2
    25
williamr@2
    26
#include <e32base.h>
williamr@2
    27
#include <gdi.h>
williamr@2
    28
#include <ecam.h>
williamr@2
    29
#include <ecamadvsettingsuids.hrh>
williamr@2
    30
#include <ecam/ecamconstants.h>
williamr@2
    31
williamr@2
    32
class MCameraImageProcessing;
williamr@2
    33
class MCameraImageProcessing2;
williamr@2
    34
class MCameraImageProcessing3;
williamr@2
    35
williamr@2
    36
class MImplementationFactory;
williamr@2
    37
williamr@2
    38
/** 
williamr@2
    39
The current Version of the TColorOperationCapabilities class.
williamr@2
    40
williamr@2
    41
*/
williamr@2
    42
static const TUint KECamColorOperationCapabilitiesCurrentVersion = 1;
williamr@2
    43
williamr@2
    44
/** 
williamr@2
    45
The current Version of the TBitsIgnore class.
williamr@2
    46
williamr@2
    47
*/
williamr@2
    48
static const TUint KECamBitsIgnoreCurrentVersion = 1;
williamr@2
    49
williamr@2
    50
/** 
williamr@2
    51
The current Version of the TColorOperationEntry class.
williamr@2
    52
williamr@2
    53
*/
williamr@2
    54
static const TUint KECamColorOperationEntryCurrentVersion = 1;
williamr@2
    55
williamr@2
    56
williamr@2
    57
/* General purpose constants */
williamr@2
    58
williamr@2
    59
/** 
williamr@2
    60
	Uid used to identify the CCamera Post Processing API.
williamr@2
    61
	Such image operations are performed on the acquired image by the camera itself. 
williamr@2
    62
	@see CCamera::CCameraPresets
williamr@2
    63
*/
williamr@2
    64
static const TUid  KECamImageProcessingUid 	= {KECamImageProcessingUidValue};
williamr@2
    65
williamr@2
    66
/** Transformations */
williamr@2
    67
/* Adjustments */
williamr@2
    68
/** Brightness adjustment - recognized range [-100:100] */
williamr@2
    69
static const TUid  KUidECamEventImageProcessingAdjustBrightness 	= {KUidECamEventImageProcessingAdjustBrightnessUidValue};
williamr@2
    70
/** Contrast adjustment  - recognized range [-100:100] */
williamr@2
    71
static const TUid  KUidECamEventImageProcessingAdjustContrast 		= {KUidECamEventImageProcessingAdjustContrastUidValue};
williamr@2
    72
/** Gamma adjustment  - recognized range [0:1000] */
williamr@2
    73
static const TUid  KUidECamEventImageProcessingAdjustGamma 			= {KUidECamEventImageProcessingAdjustGammaUidValue};
williamr@2
    74
/** Sharpness adjustment - recognized range [-100:100] */
williamr@2
    75
static const TUid  KUidECamEventImageProcessingAdjustSharpness 		= {KUidECamEventImageProcessingAdjustSharpnessUidValue};
williamr@2
    76
/** Saturation adjustment  - recognized range [-100:100] */
williamr@2
    77
static const TUid  KUidECamEventtImageProcessingAdjustSaturation 	= {KUidECamEventtImageProcessingAdjustSaturationUidValue};
williamr@2
    78
static const TUid  KUidECamEventImageProcessingAdjustSaturation 	= {KUidECamEventtImageProcessingAdjustSaturationUidValue};
williamr@2
    79
/** Hue adjustment  - recognized range [-100:100] */
williamr@2
    80
static const TUid  KUidECamEventtImageProcessingAdjustHue 			= {KUidECamEventtImageProcessingAdjustHueUidValue};
williamr@2
    81
static const TUid  KUidECamEventImageProcessingAdjustHue 			= {KUidECamEventtImageProcessingAdjustHueUidValue};
williamr@2
    82
/** Contrast Enhancement
williamr@2
    83
williamr@2
    84
This uid value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
    85
CCamera::NewDuplicate2L().
williamr@2
    86
williamr@2
    87
@internalTechnology
williamr@2
    88
*/
williamr@2
    89
static const TUid  KUidECamEventCIPAdjustContrastEnhancement 		= {KUidECamEventCIPAdjustContrastEnhancementUidValue};
williamr@2
    90
/** Software based Red Eye Reduction
williamr@2
    91
williamr@2
    92
This uid value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
    93
CCamera::NewDuplicate2L()
williamr@2
    94
williamr@2
    95
@internalTechnology
williamr@2
    96
*/
williamr@2
    97
static const TUid  KUidECamEventCIPAdjustRedEyeReduction 		    = {KUidECamEventCIPAdjustRedEyeReductionUidValue};
williamr@2
    98
williamr@2
    99
/**
williamr@2
   100
Image distortion correction.
williamr@2
   101
williamr@2
   102
This uid value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   103
CCamera::NewDuplicate2L()
williamr@2
   104
williamr@2
   105
@internalTechnology
williamr@2
   106
*/
williamr@2
   107
static const TUid KUidECamEventCIPImageDistortionCorrection         = {KUidECamEventCIPImageDistortionCorrectionUidValue};
williamr@2
   108
williamr@2
   109
williamr@2
   110
/** Effect value */
williamr@2
   111
static const TUid  KUidECamEventImageProcessingEffect 				= {KUidECamEventImageProcessingEffectUidValue};
williamr@2
   112
williamr@2
   113
/* Transforms */
williamr@2
   114
/** Crop */
williamr@2
   115
static const TUid  KUidECamEventImageProcessingTransformCrop 		= {KUidECamEventImageProcessingTransformCropUidValue};
williamr@2
   116
/** Rotation */
williamr@2
   117
static const TUid  KUidECamEventImageProcessingTransformRotate 		= {KUidECamEventImageProcessingTransformRotateUidValue};
williamr@2
   118
/** Mirroring */
williamr@2
   119
static const TUid  KUidECamEventImageProcessingTransformMirror		= {KUidECamEventImageProcessingTransformMirrorUidValue};
williamr@2
   120
/** Rescale */
williamr@2
   121
static const TUid  KUidECamEventImageProcessingTransformScale		= {KUidECamEventImageProcessingTransformScaleUidValue};
williamr@2
   122
/** origin subset */
williamr@2
   123
static const TUid  KUidECamEventImageProcessingSourceRect 			= {KUidECamEventImageProcessingSourceRectUidValue};
williamr@2
   124
/** Noise reduction */
williamr@2
   125
static const TUid  KUidECamEventImageProcessingNoiseReduction		= {KUidECamEventImageProcessingNoiseReductionUidValue};
williamr@2
   126
/** Glare removal */
williamr@2
   127
static const TUid  KUidECamEventImageProcessingGlareRemoval			= {KUidECamEventImageProcessingGlareRemovalUidValue};
williamr@2
   128
/** Relative Orientation 
williamr@2
   129
williamr@2
   130
This uid value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   131
CCamera::NewDuplicate2L().
williamr@2
   132
williamr@2
   133
@publishedPartner
williamr@2
   134
@prototype
williamr@2
   135
*/
williamr@2
   136
static const TUid  KUidECamEventImageProcessingTransformRelativeOrientation = {KUidECamEventImageProcessingTransformRelativeOrientationUidValue};
williamr@2
   137
williamr@2
   138
/** Default value for image processing */
williamr@2
   139
static const TInt  KECamImageProcessingDefaultValue  = 0;
williamr@2
   140
williamr@2
   141
/**
williamr@2
   142
Uid used to indicate completion of StartColorSwap
williamr@2
   143
williamr@2
   144
*/
williamr@2
   145
static const TUid  KUidECamEventCIPStartColorSwap					= {KUidECamEventCIPStartColorSwapUidValue};
williamr@2
   146
williamr@2
   147
/**
williamr@2
   148
Uid used to indicate completion of StartColorAccent
williamr@2
   149
williamr@2
   150
*/
williamr@2
   151
static const TUid  KUidECamEventCIPStartColorAccent					= {KUidECamEventCIPStartColorAccentUidValue};
williamr@2
   152
williamr@2
   153
/**
williamr@2
   154
Uid used to notify that the current picture orientation is unachievable after setting the relative custom orientation.
williamr@2
   155
williamr@2
   156
@see CCamera::CCameraImageProcessing::SetRelativeCustomOrientationL(TOrientationReference aOrientationReference, 
williamr@2
   157
												TRelativeCustomOrientation aRelativeCustomOrientation);
williamr@2
   158
williamr@2
   159
@publishedPartner
williamr@2
   160
@prototype
williamr@2
   161
*/
williamr@2
   162
static const TUid  KUidECamEventPictureOrientationUnachievable		= {KUidECamEventPictureOrientationUnachievableUidValue};
williamr@2
   163
williamr@2
   164
/** 
williamr@2
   165
This class is used to perform image processing operations on the camera.
williamr@2
   166
These include brightness, contrast, gamma, hue, sharpness and saturation adjustments. The client is also 
williamr@2
   167
able to perform simple image transformations like cropping, rotation, mirroring, scaling, noise reduction and glare reduction. .  
williamr@2
   168
When an operation selection is complete, all clients are notified with the respective event UID.
williamr@2
   169
williamr@2
   170
As often cameras may support only a subset of discrete values of the allowed range, 
williamr@2
   171
the API allows the client to retrieve those and use them explicitly.   
williamr@2
   172
williamr@2
   173
@note This class is not intended for sub-classing and used to standardise existing
williamr@2
   174
	  varieties of implementations.
williamr@2
   175
williamr@2
   176
@note it is assumed that setting a new value for a transformations(transform, adjust, effect) effectively
williamr@2
   177
	  activates the transformations. Whilst for effects and adjustments there is always a value, transforms 
williamr@2
   178
	  may have a dependency on other parameters and 
williamr@2
   179
	  crop 	- requires setting of source rectangle.
williamr@2
   180
	  scale - will use setting of source rectangle, and the magnification factor is 
williamr@2
   181
	  		  determined by the source rectangle and the output size. This is always magnification.
williamr@2
   182
	  		  if a value is set, it is assumed to be a scaling factor multiplied by KECamFineResolutionFactor
williamr@2
   183
	  		  and set to integer.
williamr@2
   184
	  mirror - values of TMirror type.
williamr@2
   185
	  rotation - the angle in degrees.
williamr@2
   186
	  noise reduction - TNoiseReduction.
williamr@2
   187
	  glare removal - TGlareReduction.
williamr@2
   188
williamr@2
   189
	  	Example 
williamr@2
   190
		
williamr@2
   191
		@code
williamr@2
   192
		// Lets assume that an application would need to check whether gamma correction is 
williamr@2
   193
		// supported on a particular platform. After obtaining a valid pointer to the interface, 
williamr@2
   194
		// it would call GetSupportedTransformationsL() to obtain the list of the supported 
williamr@2
   195
		// transformations and check whether KUidECamEventImageProcessingAdjustGamma
williamr@2
   196
		// is in the list. If it is then call SetTranformationValue(KUidECamEventImageProcessingAdjustGamma, 200);
williamr@2
   197
		// to set the new value. A notification will be generated to the client to indicate success.
williamr@2
   198
williamr@2
   199
		RArray<TUid> suppTransforms; // array of supported transformations
williamr@2
   200
		CleanupClosePushL(suppTransforms);
williamr@2
   201
williamr@2
   202
		imageProcess->GetSupportedTransformationsL(suppTransfUids);
williamr@2
   203
		 ...
williamr@2
   204
		// if the gamma is supported 
williamr@2
   205
		TInt gammaCorrection = 200; // gamma correction of 2.0
williamr@2
   206
		imageProcess->SetTranformationValue(KUidECamEventImageProcessingAdjustGamma, gammaCorrection);
williamr@2
   207
		...
williamr@2
   208
		// pop stack to close the RArray
williamr@2
   209
		@endcode
williamr@2
   210
		
williamr@2
   211
@note   If the class methods leave, the output type parameter value is not guaranteed to be valid.
williamr@2
   212
williamr@2
   213
@publishedAll
williamr@2
   214
@released	
williamr@2
   215
*/
williamr@2
   216
class CCamera::CCameraImageProcessing : public CBase
williamr@2
   217
	{
williamr@2
   218
	
williamr@2
   219
	// so can use internal factory functions etc.
williamr@2
   220
	friend class CCamera;
williamr@2
   221
	
williamr@2
   222
public: 
williamr@2
   223
	
williamr@2
   224
	/** Gamma settings */		
williamr@2
   225
   	enum TGamma
williamr@2
   226
	   	{
williamr@2
   227
   		/** Sets the gamma adjustment automatically. */
williamr@2
   228
	   	EGammaAuto						= KMinTInt
williamr@2
   229
	   	};
williamr@2
   230
	/** Sharpness Settings */	   	
williamr@2
   231
	enum TSharpness
williamr@2
   232
	   	{
williamr@2
   233
   		/** Sets the sharpness adjustment automatically. */
williamr@2
   234
	   	ESharpnessAuto					= KMinTInt
williamr@2
   235
	   	};   	
williamr@2
   236
	/** Saturation Settings */	 
williamr@2
   237
	enum TSaturation
williamr@2
   238
	   	{
williamr@2
   239
   		/** Sets the saturation adjustment automatically. */
williamr@2
   240
	   	ESaturationAuto					= KMinTInt
williamr@2
   241
	   	};
williamr@2
   242
	/** Hue Settings */	 
williamr@2
   243
	enum THue
williamr@2
   244
	   	{
williamr@2
   245
   		/** Sets the hue adjustment automatically. */
williamr@2
   246
	   	EHueAuto						= KMinTInt
williamr@2
   247
	   	};	   	
williamr@2
   248
	   	     	
williamr@2
   249
	/** Settings for the supported effects */
williamr@2
   250
	enum TEffect
williamr@2
   251
	  	{
williamr@2
   252
		/** Effects off is default, always supported */
williamr@2
   253
		EEffectNone			     	= 0x00000000,
williamr@2
   254
		/** Negative visual effect. */
williamr@2
   255
		EEffectNegative		   		= 0x00000001,
williamr@2
   256
		/** Black and white visual effect. */
williamr@2
   257
		EEffectMonochrome 			= 0x00000002,
williamr@2
   258
		/** Solarization visual effect. */
williamr@2
   259
		EEffectSolarize		 		= 0x00000004,
williamr@2
   260
		/** Sepia visual effect. */
williamr@2
   261
		EEffectSepia		     	= 0x00000008,
williamr@2
   262
		/** Emboss visual effect. */
williamr@2
   263
		EEffectEmboss 				= 0x00000010,
williamr@2
   264
		/** Red eye glare reduction visual effect. */
williamr@2
   265
		EEffectRedEyeReduction 		= 0x00000020,
williamr@2
   266
		/** Vivid colour visual effect. */ 
williamr@2
   267
		EEffectVivid 				= 0x00000040,
williamr@2
   268
		/** Neutral colour visual effect. */ 
williamr@2
   269
		EEffectNeutral 				= 0x00000080,
williamr@2
   270
		/** Selective sharpening visual effect. */ 
williamr@2
   271
		EEffectLowSharpening		= 0x00000100,
williamr@2
   272
		/** 
williamr@2
   273
		Natural visual effect. 
williamr@2
   274
		
williamr@2
   275
		This enum value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   276
		CCamera::NewDuplicate2L().
williamr@2
   277
		
williamr@2
   278
		*/
williamr@2
   279
		EEffectNatural 				= 0x00000200, 
williamr@2
   280
		/** 
williamr@2
   281
		Cine visual effect. 
williamr@2
   282
		
williamr@2
   283
		This enum value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   284
		CCamera::NewDuplicate2L().
williamr@2
   285
		
williamr@2
   286
		*/
williamr@2
   287
		EEffectCine 				= 0x00000400, 
williamr@2
   288
		/** 
williamr@2
   289
		Old film visual effect. 
williamr@2
   290
		
williamr@2
   291
		This enum value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   292
		CCamera::NewDuplicate2L().
williamr@2
   293
		
williamr@2
   294
		*/
williamr@2
   295
		EEffectOldFilm 				= 0x00000800,  
williamr@2
   296
		/** 
williamr@2
   297
		Color swap visual effect. 
williamr@2
   298
		
williamr@2
   299
		This enum value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   300
		CCamera::NewDuplicate2L().
williamr@2
   301
		
williamr@2
   302
		*/
williamr@2
   303
		EEffectColorSwap 			= 0x00001000, 
williamr@2
   304
		/** 
williamr@2
   305
		Where a list of color can be kept as they are and the rest converted to gray. 
williamr@2
   306
	
williamr@2
   307
		This enum value is available from the 'supported' or 'getter' methods only to the API clients using CCamera::New2L() or 
williamr@2
   308
		CCamera::NewDuplicate2L().
williamr@2
   309
	
williamr@2
   310
		*/
williamr@2
   311
		EEffectColorAccent			= 0x00002000
williamr@2
   312
 		};
williamr@2
   313
		
williamr@2
   314
	/** Mirror settings */		
williamr@2
   315
	enum TMirror
williamr@2
   316
		{
williamr@2
   317
		/** Default value. Mirroring is disabled. */
williamr@2
   318
		EMirrorNone			= 0x00000000, 
williamr@2
   319
		/** Mirror along horizontal axis. */
williamr@2
   320
		EMirrorHorizontal	= 0x00000001,
williamr@2
   321
		/** Mirror along vertical axis. */
williamr@2
   322
		EMirrorVertical		= 0x00000002,
williamr@2
   323
		/** Mirror along horizontal and vertical axis. */
williamr@2
   324
		EMirrorBoth			= 0x00000003
williamr@2
   325
		};
williamr@2
   326
	
williamr@2
   327
	/** Noise filter settings */		
williamr@2
   328
	enum TNoiseReduction
williamr@2
   329
		{
williamr@2
   330
		/** Default value. Noise reduction disabled. */
williamr@2
   331
		ENoiseReductionNone			= 0x0000, 
williamr@2
   332
		/** most basic noise reduction. */
williamr@2
   333
		ENoiseReductionBasic		= 0x0001
williamr@2
   334
		};
williamr@2
   335
	
williamr@2
   336
	/** Glare reduction settings */		
williamr@2
   337
	enum TGlareReduction
williamr@2
   338
		{
williamr@2
   339
		/** Default value. Glare reduction disabled. */
williamr@2
   340
		EGlareReductionNone			= 0x0000, 
williamr@2
   341
		/** most basic glare reduction. */
williamr@2
   342
		EGlareReductionBasic		= 0x0001
williamr@2
   343
		};
williamr@2
   344
	
williamr@2
   345
	/** 
williamr@2
   346
	Used for color swap and color accent feature in TEffect. It describes whether the given source 
williamr@2
   347
	or target color represents itself or a group of color.
williamr@2
   348
	
williamr@2
   349
	*/
williamr@2
   350
	enum TColorOperationRepresentation
williamr@2
   351
		{
williamr@2
   352
		/** Feature is not supported */
williamr@2
   353
		ERepresentationNone         = 0x00,
williamr@2
   354
		/** The given color is uniquely represented */
williamr@2
   355
		ERepresentationSingle	    = 0x01,
williamr@2
   356
		/** The given color represents a group of colors */
williamr@2
   357
		ERepresentationMultiple     = 0x02
williamr@2
   358
		};
williamr@2
   359
williamr@2
   360
	/**
williamr@2
   361
	Used for color swap and color accent feature in TEffect. It describes the type of grouping for 
williamr@2
   362
	source and target colors when they represent a group of color.
williamr@2
   363
	
williamr@2
   364
	*/
williamr@2
   365
	enum TColorOperationRgbGroupingMode
williamr@2
   366
		{
williamr@2
   367
		/** Feature is not supported */
williamr@2
   368
		ERgbGroupingNone			= 0x00,
williamr@2
   369
		/** This means no neighbourhood colors are considered */
williamr@2
   370
		ERgbGroupingFixed			= 0x01,
williamr@2
   371
		/** This means neighbourhood colors are to be automatically decided by the implementation or hardware */
williamr@2
   372
		ERgbGroupingAutomatic		= 0x02,
williamr@2
   373
		/** This means neighbourhood colors for source have to be decided by ignoring few starting bits. Used for source only */
williamr@2
   374
		ERgbGroupingSignificantBits = 0x04,
williamr@2
   375
		/** This means colors in target are obtained as some uniform proportion using source. Used for target only */
williamr@2
   376
		ERgbGroupingUniform			= 0x08
williamr@2
   377
		};
williamr@2
   378
	
williamr@2
   379
	/**
williamr@2
   380
	Used to provide different types of references for orientation of images retrieved. These references are the various 
williamr@2
   381
	means by the orientation of an image can be defined. Client needs to choose a particular TOrientationReference and 
williamr@2
   382
	specify any relative rotation, mirroring and flipping on top of it.	
williamr@2
   383
	
williamr@2
   384
	This enumeration has nothing to do with absolute rotation. Uid KUidECamEventImageProcessingTransformRotate is used 
williamr@2
   385
	for absolute rotation purposes.
williamr@2
   386
	
williamr@2
   387
	The enumeration list may be extended in future.	
williamr@2
   388
	
williamr@2
   389
	@publishedPartner
williamr@2
   390
	@prototype
williamr@2
   391
	*/
williamr@2
   392
	enum TOrientationReference
williamr@2
   393
		{
williamr@2
   394
		/** The retrieved images will follow the camera sensor orientation. This orientation would be relative 
williamr@2
   395
		to the current screen mode as given by the reference screen. */
williamr@2
   396
		EOrientationReferenceCameraSensorOrientation,
williamr@2
   397
	
williamr@2
   398
		/** The retrieved images will get oriented as per the tilt sensor information. 
williamr@2
   399
		So,the orientation would be relative to the current screen mode as given by the reference screen. */
williamr@2
   400
		EOrientationReferenceTiltOrientation
williamr@2
   401
		};
williamr@2
   402
	
williamr@2
   403
	/**
williamr@2
   404
	Used to describe the various relative rotation. The term 'relative' means that the rotation is applied after the 
williamr@2
   405
	image undergoes orientation as given by TOrientationReference.
williamr@2
   406
	
williamr@2
   407
	The enumeration list may be extended in future.	
williamr@2
   408
	
williamr@2
   409
	@publishedPartner
williamr@2
   410
	@prototype
williamr@2
   411
	*/
williamr@2
   412
	enum TRelativeRotation
williamr@2
   413
		{
williamr@2
   414
		/** Zero degree Rotation applied on top of orientation reference and is relative to current reference screen. */
williamr@2
   415
		ERelativeRotation0Degrees				= 0x00,
williamr@2
   416
		/** 90 degree clockwise Rotation applied on top of orientation reference and is relative to current reference screen. */
williamr@2
   417
		ERelativeRotation90DegreesClockwise 	= 0x01,
williamr@2
   418
		/** 180 degree clockwise Rotation applied on top of orientation reference and is relative to current reference screen. */
williamr@2
   419
		ERelativeRotation180DegreesClockwise	= 0x02,
williamr@2
   420
		/** 270 degree clockwise Rotation applied on top of orientation reference and is relative to current reference screen. */
williamr@2
   421
		ERelativeRotation270DegreesClockwise 	= 0x04
williamr@2
   422
		};
williamr@2
   423
		
williamr@2
   424
	/**
williamr@2
   425
	Used to describe the various relative mirroring. The term 'relative' means that the mirroring is applied after the 
williamr@2
   426
	image undergoes orientation as given by TOrientationReference.
williamr@2
   427
		
williamr@2
   428
	The enumeration list may be extended in future.	
williamr@2
   429
	
williamr@2
   430
	@publishedPartner
williamr@2
   431
	@prototype
williamr@2
   432
	*/
williamr@2
   433
	enum TRelativeMirror
williamr@2
   434
		{
williamr@2
   435
		/** No mirroring. */
williamr@2
   436
		ERelativeMirrorNone				= 0x00,
williamr@2
   437
		/** Used to mirror an image about the horizontal axis. This is applied on top of orientation reference and is 
williamr@2
   438
		relative to current reference screen. */
williamr@2
   439
		ERelativeMirrorHorizontalAxis	= 0x10,
williamr@2
   440
		/** Used to mirror an image about the vertical axis. This is applied on top of orientation reference and is 
williamr@2
   441
		relative to current reference screen. */
williamr@2
   442
		ERelativeMirrorVerticalAxis 	= 0x20 
williamr@2
   443
		};
williamr@2
   444
		
williamr@2
   445
	/**
williamr@2
   446
	Used to describe the various relative flipping. The term 'relative' means that the flipping is applied after the 
williamr@2
   447
	image undergoes orientation as given by TOrientationReference.
williamr@2
   448
	
williamr@2
   449
	The enumeration list may be extended in future.
williamr@2
   450
	
williamr@2
   451
	@publishedPartner
williamr@2
   452
	@prototype
williamr@2
   453
	*/
williamr@2
   454
	enum TRelativeFlipping
williamr@2
   455
		{
williamr@2
   456
		/** No flipping. */
williamr@2
   457
		ERelativeFlippingNone			= 0x00,
williamr@2
   458
		/** Used to flip an image horizontally. This is applied on top of orientation reference and is relative to current
williamr@2
   459
		reference screen. */
williamr@2
   460
		ERelativeFlippingHorizontal		= 0x10,
williamr@2
   461
		/** Used to flip an image vertically. This is applied on top of orientation reference and is relative to current
williamr@2
   462
		reference screen. */
williamr@2
   463
		ERelativeFlippingVertical 		= 0x20 
williamr@2
   464
		};
williamr@2
   465
		
williamr@2
   466
	/**
williamr@2
   467
	Different types of contrast enhancement options.
williamr@2
   468
	The enumeration list may be extended in future.
williamr@2
   469
	
williamr@2
   470
	@publishedPartner
williamr@2
   471
	@prototype
williamr@2
   472
	*/	
williamr@2
   473
	enum TContrastEnhancement
williamr@2
   474
		{
williamr@2
   475
		/** Not Supported. */
williamr@2
   476
		EContrastEnhancementNone				=0x00,
williamr@2
   477
		/** Contrast Enhancement switched off. */
williamr@2
   478
		EContrastEnhancementSwitchOff			=0x01,
williamr@2
   479
		/** Contrast Enhacement switched On manually. */
williamr@2
   480
		EContrastEnhancementManualSwitchOn		=0x02,
williamr@2
   481
		/** Contrast Enhancement in auto mode. */
williamr@2
   482
		EContrastEnhancementSwitchAuto			=0x04
williamr@2
   483
		};
williamr@2
   484
		
williamr@2
   485
	/**
williamr@2
   486
	Different types of software-based red eye reduction options.
williamr@2
   487
	The enumeration list may be extended in future.
williamr@2
   488
	
williamr@2
   489
	@publishedPartner
williamr@2
   490
	@prototype
williamr@2
   491
	*/
williamr@2
   492
	enum TRedEyeReduction
williamr@2
   493
		{
williamr@2
   494
		/** Not Supported. */
williamr@2
   495
		ERedEyeReductionNone				=0x00,
williamr@2
   496
		/** Software based Red Eye Reduction can be switched off(disabled). */
williamr@2
   497
		ERedEyeReductionSwitchOff			=0x01,
williamr@2
   498
		/** Software based Red Eye Reduction can be switched on (enabled). */
williamr@2
   499
		ERedEyeReductionManualSwitchOn		=0x02,
williamr@2
   500
		/** Software based Red Eye Reduction can be put to auto mode. */
williamr@2
   501
		ERedEyeReductionSwitchAuto			=0x04
williamr@2
   502
		};
williamr@2
   503
williamr@2
   504
	/** 
williamr@2
   505
	Color operation capabilities characterizing both color swap and color accent feature 
williamr@2
   506
	
williamr@2
   507
	*/
williamr@2
   508
	class TColorOperationCapabilities
williamr@2
   509
		{
williamr@2
   510
	public:
williamr@2
   511
		/**
williamr@2
   512
		Constructor.
williamr@2
   513
		Sets the size of this class in iSize.
williamr@2
   514
		*/
williamr@2
   515
		IMPORT_C TColorOperationCapabilities();
williamr@2
   516
		
williamr@2
   517
		IMPORT_C TInt Size() const;
williamr@2
   518
		IMPORT_C TUint Version() const;
williamr@2
   519
	
williamr@2
   520
	private:
williamr@2
   521
		//for future expansion
williamr@2
   522
		TUint iSize:24;
williamr@2
   523
		TUint iVersion:8;
williamr@2
   524
		
williamr@2
   525
		// reserved for future expansion
williamr@2
   526
		TInt    iReserved;
williamr@2
   527
		
williamr@2
   528
	public:
williamr@2
   529
		/** The source color representation that the server supports.
williamr@2
   530
	    The supported representations are held as a bitwise logical OR of the relevant individual modes
williamr@2
   531
	    defined in CCamera::CCameraImageProcessing:: TColorOperationRepresentation. */
williamr@2
   532
		TUint	iSupportedSourceRepresentation;
williamr@2
   533
		
williamr@2
   534
		/** The target color representation that the server supports.
williamr@2
   535
	    The supported representations are held as a bitwise logical OR of the relevant individual modes
williamr@2
   536
	    defined in CCamera::CCameraImageProcessing:: TColorOperationRepresentation.
williamr@2
   537
	    Not applicable for color accent */
williamr@2
   538
		TUint	iSupportedTargetRepresentation;
williamr@2
   539
williamr@2
   540
		/** The source color Rgb grouping modes that the server supports.
williamr@2
   541
	    The modes are held as a bitwise logical OR of the relevant individual modes
williamr@2
   542
	    defined in CCamera::CCameraImageProcessing:: TColorOperationRgbGroupingMode. */
williamr@2
   543
		TUint   iSupportedSourceRgbGroupingMode;
williamr@2
   544
williamr@2
   545
		/** The target color Rgb grouping modes that the server supports.
williamr@2
   546
	    The modes are held as a bitwise logical OR of the relevant individual modes
williamr@2
   547
	    defined in CCamera::CCameraImageProcessing:: TColorOperationRgbGroupingMode. 
williamr@2
   548
	    Not applicable for color accent */
williamr@2
   549
		TUint   iSupportedTargetRgbGroupingMode;
williamr@2
   550
		
williamr@2
   551
		/** This indicates whether the mapping mode and Rgb grouping mode uniform for every color entry */
williamr@2
   552
		TBool   iIsCapabilityUniform;
williamr@2
   553
		};
williamr@2
   554
williamr@2
   555
	/** 
williamr@2
   556
	Class used to control the number of bits to ignore for Red, Green, Blue or Alpha.
williamr@2
   557
	This may be used when deciding for neighbourhood for source color in case of color swap and color accent feature
williamr@2
   558
williamr@2
   559
	*/
williamr@2
   560
	class TBitsIgnore
williamr@2
   561
		{
williamr@2
   562
	public:
williamr@2
   563
		/**
williamr@2
   564
		Constructor.
williamr@2
   565
		Sets the size of this class in iSize.
williamr@2
   566
		*/
williamr@2
   567
		IMPORT_C TBitsIgnore();
williamr@2
   568
		
williamr@2
   569
		IMPORT_C TInt Size() const;
williamr@2
   570
		IMPORT_C TUint Version() const;
williamr@2
   571
	
williamr@2
   572
	private:
williamr@2
   573
		//for future expansion
williamr@2
   574
		TUint iSize:24;
williamr@2
   575
		TUint iVersion:8;
williamr@2
   576
		
williamr@2
   577
		// for future use
williamr@2
   578
		TUint iReservedBits:16;
williamr@2
   579
			
williamr@2
   580
	public:
williamr@2
   581
		/** This gives the no. of bits to ignore for Red color. Varies from 0 to 8. 
williamr@2
   582
		Any other value should be an error */
williamr@2
   583
		TUint iRedBitsIgnore:4;
williamr@2
   584
		
williamr@2
   585
		/** This gives the no. of bits to ignore for Green color. Varies from 0 to 8. 
williamr@2
   586
		Any other value should be an error */
williamr@2
   587
		TUint iGreenBitsIgnore:4;
williamr@2
   588
		
williamr@2
   589
		/** This gives the no. of bits to ignore for Blue color. Varies from 0 to 8. 
williamr@2
   590
		Any other value should be an error */
williamr@2
   591
		TUint iBlueBitsIgnore:4;
williamr@2
   592
williamr@2
   593
		/** This gives the no. of bits to ignore for Alpha. Varies from 0 to 8. 
williamr@2
   594
		Any other value should be an error */
williamr@2
   595
		TUint iAlphaBitsIgnore:4;
williamr@2
   596
		};
williamr@2
   597
williamr@2
   598
	/** 
williamr@2
   599
	Color operation parameters characterizing both color swap and color accent feature; and for a particular entry.
williamr@2
   600
	 
williamr@2
   601
	*/
williamr@2
   602
	class TColorOperationEntry
williamr@2
   603
		{
williamr@2
   604
	public:
williamr@2
   605
		/**
williamr@2
   606
		Constructor.
williamr@2
   607
		Sets the size of this class in iSize.
williamr@2
   608
		*/
williamr@2
   609
		IMPORT_C TColorOperationEntry();
williamr@2
   610
				
williamr@2
   611
		IMPORT_C TInt Size() const;
williamr@2
   612
		IMPORT_C TUint Version() const;
williamr@2
   613
williamr@2
   614
	private:
williamr@2
   615
		//for future expansion
williamr@2
   616
		TUint iSize:24;
williamr@2
   617
		TUint iVersion:8;
williamr@2
   618
		
williamr@2
   619
		// reserved for future expansion
williamr@2
   620
		TInt iReserved;
williamr@2
   621
		
williamr@2
   622
	public:
williamr@2
   623
		/** The source color (rgb triplet) which is changed to target color in case of Color Swap operation 
williamr@2
   624
		and remains unaffected in case of Color Accent operation */
williamr@2
   625
		TRgb iSourceColor;
williamr@2
   626
williamr@2
   627
		/** The target color (rgb triplet) which replaces the source color in case of Color Swap operation. 
williamr@2
   628
		Redundant for Color Accent operation */
williamr@2
   629
		TRgb iTargetColor;
williamr@2
   630
williamr@2
   631
		/** This defines whether the given source color represents itself or a group of colors */
williamr@2
   632
		TColorOperationRepresentation iSourceColorRepresentation;
williamr@2
   633
williamr@2
   634
		/** This defines whether the given target color represents itself or a group of colors in case of 
williamr@2
   635
		Color Swap operation. Redundant for Color Accent operation */
williamr@2
   636
		TColorOperationRepresentation iTargetColorRepresentation;
williamr@2
   637
williamr@2
   638
		/** This defines the type of grouping for multiple representation of source color */
williamr@2
   639
		TColorOperationRgbGroupingMode iColorOperationSourceRgbGroupingMode;
williamr@2
   640
williamr@2
   641
		/** This defines the type of grouping for multiple representation of target color in case of 
williamr@2
   642
		Color Swap operation. Redundant for Color Accent operation */
williamr@2
   643
		TColorOperationRgbGroupingMode iColorOperationTargetRgbGroupingMode;  
williamr@2
   644
williamr@2
   645
		/** This gives the number of bits to ignore in case ERgbGroupingSignificantBits is used for 
williamr@2
   646
		multiple representation of source color. For any other case, no. of bits ignored for red, green, 
williamr@2
   647
		blue or alpha should be 0 */
williamr@2
   648
		TBitsIgnore iNumBitsIgnored;
williamr@2
   649
williamr@2
   650
		/** This gives the entry status of every color operation entry. If entry is not set or removed, 
williamr@2
   651
		this is ENotActive. And if entry is set, then this is EDiscreteSteps */
williamr@2
   652
		TValueInfo iEntryStatus;
williamr@2
   653
		};
williamr@2
   654
williamr@2
   655
public:
williamr@2
   656
	
williamr@2
   657
    IMPORT_C static CCameraImageProcessing* NewL(CCamera& aCamera);
williamr@2
   658
    
williamr@2
   659
    IMPORT_C static CCameraImageProcessing* CreateL(CCamera& aCamera, MImplementationFactory& aImplFactory);
williamr@2
   660
    
williamr@2
   661
	IMPORT_C void GetSupportedTransformationsL(RArray<TUid>& aTransformations) const;
williamr@2
   662
williamr@2
   663
	IMPORT_C void GetActiveTransformationsL(RArray<TUid>& aTransformations) const;
williamr@2
   664
williamr@2
   665
	IMPORT_C void GetTransformationSupportedValuesL(TUid aTransformation, RArray<TInt>& aValues, TValueInfo& aInfo) const;
williamr@2
   666
williamr@2
   667
	IMPORT_C TInt TransformationValue(TUid aTransformation) const;
williamr@2
   668
	
williamr@2
   669
	IMPORT_C TInt GetTransformationValue(TUid aTransformation, TInt& aTransformationValue) const;
williamr@2
   670
williamr@2
   671
	IMPORT_C void SetTransformationValue(TUid aTransformation, TInt aValue);
williamr@2
   672
williamr@2
   673
	IMPORT_C void GetActiveTransformSequenceL(RArray<TUid>& aTransformSequence) const;
williamr@2
   674
williamr@2
   675
	IMPORT_C void SetActiveTransformSequenceL(RArray<TUid>& aTransformSequence);
williamr@2
   676
williamr@2
   677
	IMPORT_C void SetSourceRect(const TRect& aRect);
williamr@2
   678
williamr@2
   679
	IMPORT_C void GetSourceRect(TRect& aRect) const;
williamr@2
   680
williamr@2
   681
	IMPORT_C ~CCameraImageProcessing();
williamr@2
   682
	
williamr@2
   683
	IMPORT_C void GetConcurrentColorSwappingsSupportedL(TInt& aConcurrentColorSwappingSupported) const; 
williamr@2
   684
	
williamr@2
   685
	IMPORT_C void GetColorSwapCapabilitiesL(TInt aIndex, TColorOperationCapabilities& aColorSwapCapabilities) const;
williamr@2
   686
	
williamr@2
   687
	IMPORT_C void SetColorSwapEntryL(TInt aIndex, const TColorOperationEntry& aColorSwapParameters); 
williamr@2
   688
	
williamr@2
   689
	IMPORT_C void RemoveColorSwapEntryL(TInt aIndex);
williamr@2
   690
	
williamr@2
   691
	IMPORT_C void GetColorSwapEntryL(TInt aIndex, TColorOperationEntry& aColorSwapParameters) const; 
williamr@2
   692
	
williamr@2
   693
	IMPORT_C void StartColorSwappingL();
williamr@2
   694
	
williamr@2
   695
	IMPORT_C void CancelColorSwappingL();
williamr@2
   696
	
williamr@2
   697
	IMPORT_C void GetConcurrentColorAccentSupportedL(TInt& aConcurrentColorAccentSupported) const; 
williamr@2
   698
	
williamr@2
   699
	IMPORT_C void GetColorAccentCapabilitiesL(TInt aIndex, TColorOperationCapabilities& aColorAccentCapabilities) const;
williamr@2
   700
	
williamr@2
   701
	IMPORT_C void SetColorAccentEntryL(TInt aIndex, const TColorOperationEntry& aColorAccentParameters); 
williamr@2
   702
	
williamr@2
   703
	IMPORT_C void RemoveColorAccentEntryL(TInt aIndex);
williamr@2
   704
	
williamr@2
   705
	IMPORT_C void GetColorAccentEntryL(TInt aIndex, TColorOperationEntry& aColorAccentParameters) const; 
williamr@2
   706
	
williamr@2
   707
	IMPORT_C void StartColorAccentL();
williamr@2
   708
	
williamr@2
   709
	IMPORT_C void CancelColorAccentL();
williamr@2
   710
	
williamr@2
   711
	IMPORT_C void GetSupportedRelativeOrientationOptionsL(TOrientationReference aOrientationReference, 
williamr@2
   712
		TUint& aSupportedRelativeRotation, TUint& aSupportedRelativeMirroring, TUint& aSupportedRelativeFlipping) const;
williamr@2
   713
																
williamr@2
   714
	IMPORT_C void GetCurrentRelativeOrientationOptionsL(TOrientationReference& aOrientationReference, 
williamr@2
   715
		TRelativeRotation& aRelativeRotation, TRelativeMirror& aRelativeMirror, TRelativeFlipping& aRelativeFlipping) const;
williamr@2
   716
												
williamr@2
   717
	IMPORT_C void SetRelativeOrientationOptionsL(TOrientationReference aOrientationReference, 
williamr@2
   718
		TRelativeRotation aRelativeRotation, TRelativeMirror aRelativeMirror, TRelativeFlipping aRelativeFlipping);
williamr@2
   719
	
williamr@2
   720
private:
williamr@2
   721
	CCameraImageProcessing(CCamera& aOwner);
williamr@2
   722
	void ConstructL();
williamr@2
   723
	void ConstructL(const MImplementationFactory& aImplFactory);
williamr@2
   724
	
williamr@2
   725
private:
williamr@2
   726
	CCamera& iOwner;
williamr@2
   727
	MCameraImageProcessing* iImpl;  // not owned
williamr@2
   728
	MCameraImageProcessing2* iImpl2;   //not owned
williamr@2
   729
	MCameraImageProcessing3* iImpl3;   //not owned
williamr@2
   730
	};
williamr@2
   731
#endif//ECAMIMAGEPROCESSING_H