/**

 * Interface to observer contain

 * ImageReadyCallBack function return error code and scaled/resized bitmap.

 */

    virtual void ImageReadyCallBack(TInt error, const CFbsBitmap *bitmap) = 0;

/**

 * Class to scaling graphic file/s.

 */

    /**

     * Kind of graphic file scaling.

     * EIgnoreAspectRatio          - the file is scaled to size, aspect ratio isn't preserving.

     * EKeepAspectRatio            - the file is scaled to a rectangle as large as possible inside size

     *                               preserving the aspect ratio.

     * EKeepAspectRatioByExpanding - the file is scaled to a rectangle as small as possible outside size

     *                               preserving the aspect ratio.

     */

    enum TKindOfScaling

    {

       EIgnoreAspectRatio = 0,

       EKeepAspectRatio = 1,

       EKeepAspectRatioByExpanding = 2,

    };

private:

    /**

     * Active object current operation.

     */

    enum TCurrentOperation{

public:

    /**

    * Destructor.

    */

    /**

     * All constructors initialise active object asynchronous operation

     * by calling ConstructL function.

     * 1st group - decoding and scaling.

     * 2nd group - scaling.

     */

    /**

     * 1st group.

     * Exported from dll constructors for activation graphic file scaling.

     * aNotify        - reference to observer implementation.

     * aFs            - reference to file server session.

     * aFileName      - path to graphic file.

     * aMimeType      - mime type of graphic file.

     * aNewSize       - new size of output graphic file.

     * aKindOfScaling - kind of graphic file scaling described above.

     */

    /**

     * 2nd group.

     * Exported from dll constructors for activation graphic file scaling.

     * aNotify         - reference to observer implementation.

     * aImputFbsBitmap - reference to pattern CFbsBitmap.

     * aNewSize        - new size of output graphic file.

     * aKindOfScaling  - kind of graphic file scaling described above.

     */

    IMPORT_C static CTsGraphicFileScalingHandler* NewL(MImageReadyCallBack &aNotify,

        const CFbsBitmap &aImputFbsBitmap,

        const TSize &aNewSize,

        TKindOfScaling aKindOfScaling = CTsGraphicFileScalingHandler::EIgnoreAspectRatio);

     IMPORT_C static CTsGraphicFileScalingHandler* NewLC(MImageReadyCallBack &aNotify,

        const CFbsBitmap &aImputFbsBitmap,

        const TSize &aNewSize,

        TKindOfScaling aKindOfScaling = CTsGraphicFileScalingHandler::EIgnoreAspectRatio);

     /**

      * Cancels the wait for completion of an outstanding request.

      */

    /**

     * Handles an active object’s request completion event.

     */

    /**

     * Handles a leave occurring in the request completion event handler RunL().

     */

    /**

     * Functions construct active objest instance and made asynchronous operation/s.

     * Parameters - the same meaning as in appropriate NewL/NewLC functions.

     */

    void ConstructL(const CFbsBitmap &aImputFbsBitmap);

    /**

     * Private constructor.

     * Parameters - the same meaning as in appropriate NewL/NewLC functions.

     */

    /**

     * Action to made before decoding graphic file operation.

     * Parameters - the same meaning as in appropriate NewL/NewLC functions.

     */

    void DecodingOperationL(RFs &aFs, const TDesC &aFileName, const TDesC8& aMimeType);

    /**

     * Action to made before scaling graphic file operation.

     */

    void ScalingOperationL();

    /**

     * Algorithm to determine output bitmap (returned in ImageReadyCallBack) size

     * after scaling operation.

     */

    TSize NewSizeToScalingOperation();

    /**

     * Fix for TDisplayMode == EColor16MAP not supported by scaling operation!

     * ! ! ! ADD OTHER NOT SUPPORTED DISPLAY MODES ! ! !

     */

    void FixForDisplayModeNotSupportedByScalingOperation();

    /**

     * Reference to observer implementation - return error code and output bitmap.

     */

    /**

     * Pointer to decoder used by decoding graphic file algorithm.

     */

    /**

     * Pointer to input bitmap - before decoding/scaling operation/s.

     */

    CFbsBitmap *mInputBitmap;

    /**

     * Pointer to output bitmap - returned in mNotify object.

     */

    CFbsBitmap *mOutputBitmap;

    /**

     * Pointer to CBitmapScaler calss used by scaling graphic file algorithm.

     */

    /**

     * New size of output graphic file.

     */

    /**

     * Kind of graphic file scaling described above.

     */

    /**

     * Active object current operation.

     */