epoc32/include/pdrstore.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h) This is the epoc32/include tree with the "platform" subtrees removed, and all but a selected few mbg and rsg files removed.

// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//

#ifndef PDRSTORE_H
#define PDRSTORE_H

/** 
@file 
@publishedAll
@released
*/

#include <s32mem.h>
#include <gdi.h>
#include <fbs.h>

class CPdrControl;
class CStreamStore;
class CBandedDevice;

/** 
Codes used by printer drivers. 
*/
enum TFbsEncoding
	{
	/** No code. */
	EFbsNone = 0,
	/** Run length. */
	EFbsRunLength = 1,
	/** TIFF. */
	EFbsTIFF = 2,
	/** Delta row. */
	EFbsDeltaRow = 3,
	/** Reserved. */
	EFbsReserved = 4,
	/** Adaptive. */
	EFbsAdaptive = 5
	};

/**
Determines the raster mode used by printer drivers. 
*/
enum TFbsRasterGraphicsMode
	{
	/** Logical page orientation. */
	EFbsLogicalPageOrientation = 0,
	/** Physcial page orientation. */
	EFbsPhysicalPageOrientation = 3
	};

/**
Enumerates resources used by printer drivers. 
*/
enum TPdrResourceId  // Corresponds to IdentResource in PDRREADR.H
	{
	/** Reset. */
	EPdrReset,
	/** Set page size. */
	EPdrSetPageSize,
	/** Preamble. */
	EPdrPreAmble,
	/** Postamble. */
	EPdrPostAmble,
	/** Set text colour. */
	EPdrSetTextColor,
	/** Bold text. */
	EPdrBoldOn,
	/** Normal text weighting. */
	EPdrBoldOff,
	/** Italic text. */
	EPdrItalicOn,
	/** Normal text slant. */
	EPdrItalicOff,
	/** Underline text. */
	EPdrUnderlineOn,
	/** No text underline. */
	EPdrUnderlineOff,
	/** Strike through text. */
	EPdrStrikethroughOn,
	/** No text strike through. */
	EPdrStrikethroughOff,
	/** New page. */
	EPdrNewPage,
	/** Portrait view. */
	EPdrPortrait,
	/** Landscape view. */
	EPdrLandscape,
	/** Set the x-position of the printer head. */
	EPdrSetXPos,
	/** Set the y-position of the printer head. */
	EPdrSetYPos,
	/** Increment the x-position. */
	EPdrIncrementXPos,
	/** Increment the y-position. */
	EPdrIncrementYPos,
	/** Carriage return. */
	EPdrCarriageReturn,
	/** Set the graphics colour. */
	EPdrSetGraphicsColor,
	/** Starting position of bitmap. */
	EPdrBitmapStart,
	/** End position of bitmap. */
	EPdrBitmapEnd,
	/** Scan line. */
	EPdrScanLine,
	/** End of scan line. */
	EPdrEndScanLine, 
	/** Extra resource holder. */
	EPdrResource1,
	/** Extra resource holder. */
	EPdrResource2,
	/** Extra resource holder. */
	EPdrResource3,
	/** Extra resource holder. */
	EPdrResource4,
	/** Extra resource holder. */
	EPdrResource5,
	/** Extra resource holder. */
	EPdrResource6,
	/** Extra resource holder. */
	EPdrResource7,
	/** Extra resource holder. */
	EPdrResource8
	};

/**
Maximum length of a printer command string. 
*/
const TInt KMaxCommandStringLength = 0x40;
/**
Defines a command string used by printer drivers. 
*/
typedef TBuf8<KMaxCommandStringLength> TCommandString;

// Forward declarations
class CFontInfo;
class CPdrTranslates;
class CPdrDevice;

/** WARNING: Class for internal use ONLY.  Compatibility is not guaranteed in future releases.
 */
class CInfoFont : public CFont
	{
	friend class CPdrTypefaceStore;
public:
	// New functions
	IMPORT_C HBufC8* TranslateStringL(const TDesC& aString) const;
	IMPORT_C TPtrC8 CommandString() const;
	IMPORT_C TBool RepertoireContains(TChar aChar) const;
	IMPORT_C TBool AllCharsInFontRepertoire(const TDesC& aString, TInt& aFirstCharNotInRepertoire, TInt& aLength) const;
	inline CFontInfo* FontInfo() const {return iFontInfo;}
	CFont* RealFont() const;
private:
	CInfoFont(TInt aBaselineOffsetInPixels, const TFontSpec& aFontSpecInTwips, TInt aFontInfoHeightInTwips, TInt aHeightInPixels, CPdrTranslates* aTranslates, const TDesC8& aCommandString, CPdrDevice* aPdrDevice);
	~CInfoFont();
	TInt Width(TInt aNum) const;
	TInt Height(TInt aNum) const;
	void CreateBandedFontIfRequired();
	// From CFont
	IMPORT_C virtual TUid DoTypeUid() const;
	IMPORT_C virtual TInt DoHeightInPixels() const;
	IMPORT_C virtual TInt DoAscentInPixels() const;
	IMPORT_C virtual TInt DoCharWidthInPixels(TChar aChar) const;
	IMPORT_C virtual TInt DoTextWidthInPixels(const TDesC &aText) const;
	IMPORT_C virtual TInt DoBaselineOffsetInPixels() const;
	IMPORT_C virtual TInt DoTextCount(const TDesC &aText, TInt aWidthInPixels) const;
	IMPORT_C virtual TInt DoTextCount(const TDesC &aText, TInt aWidthInPixels, TInt &aExcessWidthInPixels) const;
	IMPORT_C virtual TInt DoMaxCharWidthInPixels() const;
	IMPORT_C virtual TInt DoMaxNormalCharWidthInPixels() const;
	IMPORT_C virtual TFontSpec DoFontSpecInTwips() const;
private:
    TCommandString iCommandString;
	TInt iBaselineOffsetInPixels;
	TFontSpec iFontSpecInTwips;
	TInt iFontInfoHeightInTwips;
	TInt iHeightInPixels;
	CFontInfo* iFontInfo;
	CPdrTranslates* iTranslates;
	CPdrDevice* iPdrDevice;
	CFont* iRealFont;
	};


class CPageBuffer : public CActive
	{
public:
	IMPORT_C static CPageBuffer* NewL(CPrinterPort* aPrinterPort);
	IMPORT_C static CPageBuffer* NewL(CPrinterPort* aPrinterPort, TInt aGranularity);
	IMPORT_C void StartFlush(TRequestStatus& aRequestStatus);
	IMPORT_C void AddBytesL(const TDesC8& aDes);
	IMPORT_C RWriteStream& CreateWriteStreamL();
	IMPORT_C void CloseWriteStream();
	IMPORT_C ~CPageBuffer();
	void DoCancel();
	void RunL();
private:
	void ConstructL();
	CPageBuffer(CPrinterPort* aPrinterPort, TInt aGranularity);
	void Queue();
private:
	
	TRequestStatus* iRequestStatus;
	
	TInt iWritePos;
	
	TInt iGranularity;
	
	CBufSeg* iBuffer;
	
	TPtr8 iPtr;
	
	CPrinterPort* iPrinterPort;
	
	RBufWriteStream iWriteStream;
	
	CBufSeg* iWriteStreamBuffer;
	};


/** WARNING: Class for internal use ONLY.  Compatibility is not guaranteed in future releases.
 */
class TTextFormat	
	{
public:
	IMPORT_C TTextFormat();
	IMPORT_C TTextFormat(const TFontUnderline anUnderlineStyle, const TFontStrikethrough aStrikethroughStyle, const TRgb& aColor, const TDesC8& aFontString, const TFontStyle& aFontStyle);
	IMPORT_C TBool operator == (const TTextFormat& aFormat) const;
public:
	
	TFontUnderline iUnderlineStyle;
	
	TFontStrikethrough iStrikethroughStyle;
	
	TRgb iColor;
	
	TCommandString iFontString;
	
	TFontStyle iFontStyle;
	};


// Forward declarations
class CPdrModelInfo;
class CPdrTypefaceStore;

/**
@see CFbsDrvDevice
*/
class CPdrDevice : public CPrinterDevice
	{
protected:
	IMPORT_C CPdrDevice();
public:
	IMPORT_C virtual ~CPdrDevice();
	IMPORT_C void SelectPageSpecInTwips(const TPageSpec& aPageSpec);
	IMPORT_C TDisplayMode DisplayMode() const;
	IMPORT_C TSize SizeInPixels() const;
	IMPORT_C TSize SizeInTwips() const;
	IMPORT_C TRect PrintablePageInPixels() const;
	IMPORT_C TInt HorizontalTwipsToPixels(TInt aTwips) const;
	IMPORT_C TInt VerticalTwipsToPixels(TInt aTwips) const;
	IMPORT_C TInt HorizontalPixelsToTwips(TInt aPixels) const;
	IMPORT_C TInt VerticalPixelsToTwips(TInt aPixels) const;
	IMPORT_C TInt GetNearestFontInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
	IMPORT_C TInt GetNearestFontToDesignHeightInTwips(CFont *&aFont, const TFontSpec &aFontSpec);
	IMPORT_C TInt GetNearestFontToMaxHeightInTwips(CFont *&aFont, const TFontSpec &aFontSpec, TInt aMaxHeight);
	IMPORT_C TInt NumTypefaces() const;
	IMPORT_C void TypefaceSupport(TTypefaceSupport& aTypefaceSupport, TInt aTypefaceIndex) const;
	IMPORT_C TInt FontHeightInTwips(TInt aTypefaceIndex, TInt aHeightIndex) const;
	IMPORT_C void PaletteAttributes(TBool& aModifiable, TInt& aNumEntries) const;
	IMPORT_C void SetPalette(CPalette* aPalette);
	IMPORT_C TInt GetPalette(CPalette*& aPalette) const;
	IMPORT_C TPrinterModelEntry Model() const;
	IMPORT_C TInt Flags() const;
	IMPORT_C TInt SetModel(const TPrinterModelHeader& aModel, CStreamStore& aStore);
	IMPORT_C void ReleaseFont(CFont* aFont);
	IMPORT_C TPoint OffsetInPixels();

protected:
	IMPORT_C virtual TSize KPixelSizeInTwips() const;
private:
	void DoSetModelL();
protected:
	
	CStreamStore* iStore;
	
	TPrinterModelHeader iModel;
	
	CPdrModelInfo* iModelInfo;
	
	CPdrTypefaceStore* iTypefaceStore;
	}; 


//Forward declarations
class CPdrResources;
class CPageText;

class CPdrControl : public CPrinterControl
	{
public:
	IMPORT_C ~CPdrControl();
	IMPORT_C TInt CreateContext(CGraphicsContext*& aGC);
	IMPORT_C TInt BandsPerPage();
	IMPORT_C TMoreOnPage QueueGetBand(TRequestStatus& aStatus, TBandAttributes& aBand); // returns affirmative if more to print on current page
	IMPORT_C void QueueEndPrint(TRequestStatus& aStatus); // Called at finish to flush buffer, tidy up printer etc.
	IMPORT_C void AbortPrint(); // tidy up synchronously in a short time
	IMPORT_C virtual void DrawTextL(const TPoint& aPoint, const TFontUnderline aUnderlineStyle, const TFontStrikethrough aStrikethroughStyle, const TRgb& aColor, const CInfoFont* aFont, const TDesC& aString); 
	IMPORT_C TBool IsGraphicsBand() const;
	inline CBandedDevice* BandedDevice() const {return iBandedDevice;}
protected:
	IMPORT_C CPdrControl(CPdrDevice* aPdrDevice, CPrinterPort* aPrinterPort);
	IMPORT_C virtual void DoQueueGetBandL();
	IMPORT_C virtual void DoQueueEndPrintL();
	IMPORT_C void ConstructL(CStreamStore& aStore, TStreamId aStreamId);

	virtual void OutputBandL() = 0;

	IMPORT_C virtual void MoveToL(const TPoint& aPoint); 
	IMPORT_C virtual void MoveByL(const TPoint& aVector); 
	IMPORT_C virtual void OutputTextL(const TPoint& aPoint, TInt aWidthInPixels, const TTextFormat& aTextFormat, const TDesC8& aString); 

	IMPORT_C virtual void SetPageSizeL(); 
	IMPORT_C virtual void SetPageOrientationL();
	IMPORT_C virtual void SetFontPostureL(const TFontPosture aPosture);
	IMPORT_C virtual void SetFontStrokeWeightL(const TFontStrokeWeight aStrokeWeight);
	IMPORT_C virtual void SetTextColorL(const TRgb& aColor);
	IMPORT_C virtual void CommandL(const TInt anId);

	IMPORT_C TBool TransformBuffer(); // These two functions are not implemented anywhere
	IMPORT_C TBool CompressBuffer();  // for this class. Nor do I believe they are defined
									  // for a reason. But since they are part of the 
									  // existing interface of a DLL in a ROM I need to
									  // patch. They get to stay there for the moment. CJC

protected:
	
	CPdrDevice* iPdrDevice;
	
	CPageBuffer* iPageBuffer;
	
	CPdrResources* iResources;
	
	CBandedDevice* iBandedDevice;
	
	CPageText* iPageText;
	
	TInt iBandIndex;
	
	TInt iEntryIndex;
	
	TPoint iPosition;
	
	TTextFormat iTextFormat;
	};


class CFbsDrvDevice : public CPdrDevice
	{
public:
	IMPORT_C CFbsDrvDevice();
	IMPORT_C ~CFbsDrvDevice();

	IMPORT_C TInt GetNearestFontInTwips(CFont*& aFont, const TFontSpec& aFontSpec);
	IMPORT_C TInt GetNearestFontToDesignHeightInTwips(CFont *&aFont, const TFontSpec &aFontSpec);
	IMPORT_C void ReleaseFont(CFont* aFont);
	IMPORT_C TInt NumTypefaces() const;
	IMPORT_C void TypefaceSupport(TTypefaceSupport& aTypefaceSupport, TInt aTypefaceIndex) const;
	IMPORT_C TInt FontHeightInTwips(TInt aTypefaceIndex, TInt aHeightIndex) const;

	IMPORT_C TInt CreateContext(CGraphicsContext*& aGc);
	IMPORT_C void CreateControlL(CPrinterPort* aPrinterPort);
	IMPORT_C TInt SetModel(const TPrinterModelHeader& aModel, CStreamStore& aStore);
	IMPORT_C void LoadTypeFaceList();
	IMPORT_C TSize KPixelSizeInTwips() const;
	IMPORT_C void LoadTypeFaceListL();
	IMPORT_C TInt SetModelL(const TPrinterModelHeader& aModel, CStreamStore& aStore);
private:
// reserved virtual function space
	IMPORT_C virtual void Reserved_1();

protected:
	
	CFbsTypefaceStore* iFbsTypefaceStore;
	
	CArrayFixFlat<TInt>* iGenTypefaceFontsList;
	
	CArrayFixFlat<TInt>* iGenTypefaceFontsType;
	
	TInt iFbsTypefaceCount;
	
	TInt iPdrTypefaceCount;

private:
	
	TAny* iReserved;
	};


class CFbsDrvControl : public CPdrControl
	{
public:
	IMPORT_C static CFbsDrvControl* NewL(CPdrDevice* aPdrDevice, CPrinterPort* aPrinterPort, CStreamStore& aStore, TStreamId aResourcesStreamId);
	IMPORT_C ~CFbsDrvControl();

protected:
	IMPORT_C virtual void OutputBandL();

	IMPORT_C CFbsDrvControl(CPdrDevice* aPdrDevice, CPrinterPort* aPrinterPort);
	IMPORT_C void ConstructL(CStreamStore& aStore, TStreamId aResourcesStreamId);
	IMPORT_C void SetPageSizeL();

	IMPORT_C TBool TransformBuffer();
	IMPORT_C TBool CompressBuffer();

private:
// reserved virtual function space
	IMPORT_C virtual void Reserved_1();
		
protected:
	
	HBufC8* iScanLine;
	
	HBufC8* iCompressedScanLine;

private:
	
	TAny* iReserved;
	};

#endif