GRenderWinG Class Reference

A GDraw render region that uses normal DIBs for the bitmap and WinG to blit them. More...

#include <grndwing.h>

Inheritance diagram for GRenderWinG:

List of all members.

Public Types
typedef HDC(PASCAL *	WING_CREATEDC )(void)
typedef BOOL(PASCAL *	WING_RECOMMENDED )(BITMAPINFO FAR *pFormat)
typedef HBITMAP(PASCAL *	WING_CREATEBITMAP )(HDC WinGDC, BITMAPINFO const FAR *pHeader, void FAR *FAR *ppBits)
typedef BOOL(PASCAL *	WING_BITBLT )(HDC hdcDest, INT32 nXOriginDest, INT32 nYOriginDest, INT32 nWidthDest, INT32 nHeightDest, HDC hdcSrc, INT32 nXOriginSrc, INT32 nYOriginSrc)
Public Member Functions
	GRenderWinG (DocRect ClipRegion, Matrix ConvertMatrix, FIXED16 ViewScale, UINT32 Depth, double dpi)
	GRenderWinG constructor. Doesn't do anything actually, just calls base class. INT32 dpi changed to FIXED16 dpi (12/12/95) to improve the range of values allowed at the < 1000dpi settings that we will be using.
	~GRenderWinG ()
	GRenderWinG destructor. Frees up the bitmap.
Static Public Member Functions
static BOOL	Init (BOOL)
	Determines whether WinG is available on this platform.
static void	Deinit ()
	Tidies up WinG before exit. Frees up necessary resources etc.
static BOOL	CanWinG (UINT32 Depth)
	Use before creating GRenderWinGs inc case they are not supported. Currently only uses WinG if depth matches the recommended format.
Static Public Attributes
static HINSTANCE	WinGDLL
static WING_CREATEDC	pWinGCreateDC
static WING_RECOMMENDED	pWinGRecommendedDIBFormat
static WING_CREATEBITMAP	pWinGCreateBitmap
static WING_BITBLT	pWinGBitBlt
Private Member Functions
LPBITMAPINFO	GetLPBits (INT32 Width, INT32 Height, INT32 Depth, LPBYTE *)
	Allocates a bitmap header and the bitmap bytes.
void	FreeLPBits (LPBITMAPINFO, LPBYTE)
	Frees up a bitmap allocated with GetLPBits.
BOOL	DisplayBits (LPBITMAPINFO lpDisplayBitmapInfo=NULL, LPBYTE lpDisplayBits=NULL)
	Plots the DIB onto the owner device.
BOOL	StartRenderAfter (GMATRIX *GMat)
	Updates the Gavin matrix to cope with the upside-down nature of DIBs if that is the recommended format.
Private Attributes
HBITMAP	WinGBitmap
BOOL	Inverted
Static Private Attributes
static HDC	OffScreenDC

---

Detailed Description

A GDraw render region that uses normal DIBs for the bitmap and WinG to blit them.

Author:

Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com>

Date:

29/6/94

Definition at line 111 of file grndwing.h.

---

Member Typedef Documentation

typedef BOOL(PASCAL * GRenderWinG::WING_BITBLT)(HDC hdcDest, INT32 nXOriginDest, INT32 nYOriginDest, INT32 nWidthDest, INT32 nHeightDest, HDC hdcSrc, INT32 nXOriginSrc, INT32 nYOriginSrc)

Definition at line 133 of file grndwing.h.

typedef HBITMAP(PASCAL * GRenderWinG::WING_CREATEBITMAP)(HDC WinGDC, BITMAPINFO const FAR *pHeader, void FAR *FAR *ppBits)

Definition at line 131 of file grndwing.h.

typedef HDC(PASCAL * GRenderWinG::WING_CREATEDC)(void)

Definition at line 129 of file grndwing.h.

typedef BOOL(PASCAL * GRenderWinG::WING_RECOMMENDED)(BITMAPINFO FAR *pFormat)

Definition at line 130 of file grndwing.h.

---

Constructor & Destructor Documentation

GRenderWinG::GRenderWinG (  DocRect  ClipRegion, Matrix  ConvertMatrix, FIXED16  ViewScale, UINT32  Depth, double  dpi )

GRenderWinG constructor. Doesn't do anything actually, just calls base class. INT32 dpi changed to FIXED16 dpi (12/12/95) to improve the range of values allowed at the < 1000dpi settings that we will be using. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: GRenderRegion::GRenderRegion Definition at line 309 of file grndwing.cpp. : GRenderRegion( ClipRegion, ConvertMatrix, ViewScale, Depth, dpi) { WinGBitmap = NULL; Inverted = FALSE; }

GRenderWinG::~GRenderWinG (   )

GRenderWinG destructor. Frees up the bitmap. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 2/6/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Errors: - Definition at line 437 of file grndwing.cpp. { if (LocalBitmap) { if (HaveRenderedSomething) // We're not clean - flush bitmap to screen DisplayBits(); // FreeLPBits( lpBitmapInfo, lpBits ); FreeOffscreenState(); lpBitmapInfo = NULL; lpBits = NULL; } // will call GRenderRegions destructor here }

---

Member Function Documentation

BOOL GRenderWinG::CanWinG (  UINT32  Depth  )  [static]

Use before creating GRenderWinGs inc case they are not supported. Currently only uses WinG if depth matches the recommended format. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: Pixel  depth required [INPUTS] Returns: TRUE if GRenderWinG can be done at such a depth, FALSE if cannot Errors: - Scope: Static public Definition at line 279 of file grndwing.cpp. { if ( WinGDLL && // must have DLL OffScreenDC && // and screen DC (RecommendedDIB.biPlanes == 1) && // mono planar (Depth == RecommendedDIB.biBitCount) // and correct depth ) return TRUE; return FALSE; }

void GRenderWinG::Deinit (  void   )  [static]

Tidies up WinG before exit. Frees up necessary resources etc. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Returns: Errors: - Scope: Static Definition at line 255 of file grndwing.cpp. { if (OffScreenDC) { DeleteDC(OffScreenDC); OffScreenDC = NULL; } }

BOOL GRenderWinG::DisplayBits (  LPBITMAPINFO  lpDisplayBitmapInfo = NULL, LPBYTE  lpDisplayBits = NULL )  [private, virtual]

Plots the DIB onto the owner device. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if worked, FALSE if failed. Errors: - Implements GRenderRegion. Definition at line 504 of file grndwing.cpp. { BOOL ok = FALSE; if (lpBitmapInfo && lpBits && RenderDC) { HBITMAP hOldBitmap; hOldBitmap = SelectBitmap( OffScreenDC, WinGBitmap ); if (hOldBitmap) { ok = pWinGBitBlt( RenderDC->m_hDC, // dest WRect.left, WRect.top, // dest XY WRect.right-WRect.left, WRect.bottom-WRect.top, OffScreenDC, // source 0,0 // source XY ); SelectBitmap( OffScreenDC, hOldBitmap ); } } return ok; }

void GRenderWinG::FreeLPBits (  LPBITMAPINFO  lpBMI, LPBYTE  lpB )  [private, virtual]

Frees up a bitmap allocated with GetLPBits. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: Bitmap  characteristics. [INPUTS] -  [OUTPUTS] Returns: - Errors: - See also: GRenderWinG::FreeLPBits Implements GRenderRegion. Definition at line 413 of file grndwing.cpp. { if (WinGBitmap) { DeleteObject( WinGBitmap ); WinGBitmap = NULL; } FreeDIB( lpBMI, NULL ); }

LPBITMAPINFO GRenderWinG::GetLPBits (  INT32  Width, INT32  Height, INT32  Depth, LPBYTE *  lplpBits )  [private, virtual]

Allocates a bitmap header and the bitmap bytes. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: Bitmap  characteristics. [INPUTS] *lplpBits  is made to point to the bytes of the bitmap. [OUTPUTS] Returns: The bitmap header, or NULL if not enough memory. Errors: - See also: GRenderWinG::FreeLPBits Implements GRenderRegion. Definition at line 331 of file grndwing.cpp. { // get a bitmap header with no bits const LPBITMAPINFO bmInfo = AllocDIB( Width, Height, Depth, NULL ); if (!bmInfo) return NULL; // tell it the sort of palette we want - we want Gavin's if (Depth==8) { #if 0 RGBQUAD *rgb = bmInfo->bmiColors; LPPALETTEENTRY lpPal = GetRecommendedPalette()->palPalEntry; size_t i ; for ( i=0 ; i<256 ; i++ ) { rgb->rgbRed = lpPal->peRed; rgb->rgbGreen = lpPal->peGreen; rgb->rgbBlue = lpPal->peBlue; rgb->rgbReserved = 0; rgb ++; lpPal++; } #else GetSystemPaletteEntries ( RenderDC->m_hDC, 0, 256, (LPPALETTEENTRY) bmInfo->bmiColors ) ; RGBQUAD *rgb = bmInfo->bmiColors ; // Swap R and B. size_t i ; for ( i=0 ; i<256 ; i++ ) { BYTE t = rgb->rgbRed ; rgb->rgbRed = rgb->rgbBlue ; rgb->rgbBlue = t ; rgb ++ ; } #endif } // if WinG wants it upside-down then go for it if (RecommendedDIB.biHeight == -1) { Inverted = TRUE; bmInfo->bmiHeader.biHeight = -bmInfo->bmiHeader.biHeight; } else Inverted = FALSE; // now get a lovely WinG bitmap WinGBitmap = pWinGCreateBitmap( OffScreenDC, bmInfo, (void FAR* FAR *)lplpBits ); if (WinGBitmap==NULL) { TRACE( _T("WinGCreateBitmap failed\n")); FreeDIB( bmInfo, NULL ); return NULL; } // turn it back the other way else Gavin is likely to get confused if (Inverted) bmInfo->bmiHeader.biHeight = -bmInfo->bmiHeader.biHeight; //TRACE( _T("WinG Alloc %lx=%lx:%lx\n"), this, bmInfo, *lplpBits); return bmInfo; }

BOOL GRenderWinG::Init (  BOOL  FirstTime  )  [static]

Determines whether WinG is available on this platform. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 29/6/94 Parameters: FirstTime  is TRUE if called on startup, FALSE if called subsequently [INPUTS] (e.g. screen mode change). -  [OUTPUTS] Returns: TRUE if we can use WinG, FALSE if we cannot. Errors: - Scope: Public static Reimplemented from GRenderRegion. Definition at line 144 of file grndwing.cpp. { if (!FirstTime) { // only a screen mode change so don't redo DLL etc, just get new DC if (WinGDLL) { // kill old one if (OffScreenDC) DeleteDC( OffScreenDC ); // go get new one OffScreenDC = pWinGCreateDC(); if (OffScreenDC) return TRUE; } return FALSE; } #if WIN32 // lets see if the DLL is there // on NT 3.1 the DLL init code fails the load and produces an ugly dialog, so we don't // bother if (IsWin32NT()) { const WORD Ver = LOWORD( GetVersion() ); if ( (LOBYTE(Ver) == 3) && // NT 3.5 is minimum requirement (HIBYTE(Ver) < 50) ) return FALSE; } // try the DLL now WinGDLL = LoadLibrary("WING32.DLL"); if (WinGDLL) { // (ordinal values extracted from DLL using DUMPBIN -export) pWinGCreateDC = (WING_CREATEDC) GetProcAddress( WinGDLL, MAKEINTRESOURCE(0x3e9) ); pWinGCreateBitmap = (WING_CREATEBITMAP) GetProcAddress( WinGDLL, MAKEINTRESOURCE(0x3eb) ); pWinGBitBlt = (WING_BITBLT) GetProcAddress( WinGDLL, MAKEINTRESOURCE(0x3f2) ); pWinGRecommendedDIBFormat = (WING_RECOMMENDED) GetProcAddress( WinGDLL, MAKEINTRESOURCE( 0x3ea ) ); if ( (pWinGCreateDC == NULL) || (pWinGCreateBitmap == NULL) || (pWinGBitBlt == NULL) || (pWinGRecommendedDIBFormat==NULL) ) { TRACE( _T("WinG32 DLL entrypoints missing!\n")); FreeLibrary( WinGDLL ); WinGDLL = NULL; return FALSE; } } else { TRACE( _T("WinG DLL not found (error %d)\n"), GetLastError() ); return FALSE; } // remember the DLL handle so it gets cleaned up for us always on exit ExtraDLLs[ WinG_DLL ] = WinGDLL; RecommendedDIB.biSize = sizeof(BITMAPINFOHEADER); // excuse the seemingly rampant cast but I think the official prototype is wrong const BOOL ok = pWinGRecommendedDIBFormat( (LPBITMAPINFO)&RecommendedDIB ); if (IsUserName("Andy")) { TRACE( _T("Recommended bitmap:\n")); if (ok) { TRACE( _T("%dx%d height=%d comp=%d\n"), (INT32)RecommendedDIB.biPlanes, (INT32)RecommendedDIB.biBitCount, (INT32)RecommendedDIB.biHeight, (INT32)RecommendedDIB.biCompression ); } else TRACE( _T("ERROR - isnt one\n")); } OffScreenDC = pWinGCreateDC(); if (OffScreenDC) return TRUE; #endif // if we get here it means we failed return FALSE; }

BOOL GRenderWinG::StartRenderAfter (  GMATRIX *  GMat  )  [private, virtual]

Updates the Gavin matrix to cope with the upside-down nature of DIBs if that is the recommended format. Author: Andy_Pennell (Xara Group Ltd) <camelotdev@xara.com> Date: 30/6/94 Parameters: Pointer  to Gavins matrix created by GRenderRegion::StartRender [INPUTS] Update  matrix if required. [OUTPUTS] Returns: TRUE if worked, FALSE if failed. Errors: Always returns TRUE. See also: GRenderDDB::StartRenderAfter Reimplemented from GRenderRegion. Definition at line 470 of file grndwing.cpp. { if (Inverted) { // flip up other way GMat->BY = -GMat->BY; // calculate the new offset //XLONG ydisp = (XLONG)( (WRect.bottom - WRect.top ) * 72000 ) / (XLONG)(PixelsPerInch.MakeXlong() * ScaleFactor); FIXED16 ScaledDpi = FIXED16(PixelsPerInch) * ScaleFactor; XLONG Size = (WRect.bottom - WRect.top ) * 72000; XLONG ydisp = Size / ScaledDpi.MakeXlong(); GMat->CY = -GMat->CY + Mul(-GMat->BY, ydisp); } // we cannot fail return TRUE; }

---

Member Data Documentation

BOOL GRenderWinG::Inverted [private]

Definition at line 157 of file grndwing.h.

HDC GRenderWinG::OffScreenDC [static, private]

Definition at line 161 of file grndwing.h.

GRenderWinG::WING_BITBLT GRenderWinG::pWinGBitBlt [static]

Definition at line 146 of file grndwing.h.

GRenderWinG::WING_CREATEBITMAP GRenderWinG::pWinGCreateBitmap [static]

Definition at line 145 of file grndwing.h.

GRenderWinG::WING_CREATEDC GRenderWinG::pWinGCreateDC [static]

Definition at line 143 of file grndwing.h.

GRenderWinG::WING_RECOMMENDED GRenderWinG::pWinGRecommendedDIBFormat [static]

Definition at line 144 of file grndwing.h.

HBITMAP GRenderWinG::WinGBitmap [private]

Definition at line 156 of file grndwing.h.

HINSTANCE GRenderWinG::WinGDLL [static]

Definition at line 141 of file grndwing.h.

---

The documentation for this class was generated from the following files:

• wxOil/grndwing.h (r1785/r751)
• wxOil/grndwing.cpp (r1785/r1282)

---