BLU-specific graphics-wrapper. More...

#include <GfxWrapBLU.h>

Inheritance diagram for CGfxWrapBLU:

[legend]

Public Types
typedef void *	SetFrameBuffer(void *, unsigned long, unsigned long))
	signature for function to set the framebuffer

Public Types inherited from CGfxWrap
enum	RefreshCall_t { SINGLE_REFRESH , FIRST_REFRESH_OF_FRAME , INTERMEDIATE_REFRESH , LAST_REFRESH_OF_FRAME , FORCED_REFRESH }

Public Member Functions
virtual void	Arc (const eC_Value &vX1, const eC_Value &vY1, const eC_Value &vX2, const eC_Value &vY2, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)

virtual void	BlitImgExtImpl (const CGUIImageData &kImageData, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY)

virtual void	BlitImgExtImpl (const ImageResource_t &eID, const eC_UInt &uiAbsSrcX, const eC_UInt &uiAbsSrcY, const eC_UInt &uiSrcWidth, const eC_UInt &uiSrcHeight, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY, const eC_Value &vDestWidth, const eC_Value &vDestHeight, const eC_UByte &ubAlpha=255, const eC_Value &vAngle=eC_FromFloat(0), const eC_Value &vRotCenterX=eC_FromFloat(0.5), const eC_Value &vRotCenterY=eC_FromFloat(0.5))

CGUIBitmapPlane *	CreateGfxDependentBitmap (GUIBitmapPlaneID_t uiNewBitmapID, const CGUIObject &rkParentObject, const eC_Value &vWidth, const eC_Value &vHeight)

virtual eC_Bool	DrawToBitmap (GUIBitmapPlaneID_t uiBitmapID)

virtual eC_Bool	DrawToScreen ()

virtual void	Ellipse (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2, const eC_Bool &bFilled)

virtual void	FilledRect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)

eC_UByte	GetAlphaThreshold () const

__blu_bitmap *	GetDestination ()

virtual eC_UInt	GetImageSize (const ImageResource_t &eID) const

virtual eC_UInt	GetImgHeightImpl (const ImageResource_t &eID) const

virtual eC_UInt	GetImgWidthImpl (const ImageResource_t &eID) const

virtual eC_UInt	GetPhysicalScreenHeight ()

virtual eC_UInt	GetPhysicalScreenWidth ()

CGUIRect	GetScratchBufferRect () const

virtual eC_UInt	GetVirtualScreenHeight ()

virtual eC_UInt	GetVirtualScreenWidth ()

virtual eC_Bool	ImageExists (const ImageResource_t eID) const

void	Init ()

void	Init (const eC_UInt &uiWidth, const eC_UInt &uiHeight, const eC_UByte &ubBitPerPixel, const eC_UInt uiNumberOfBuffers, void **pkFrameBuffers)

eC_Bool	IsScratchBufferIsUse () const

virtual void	Line (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)
	the following methods are protected to prevent calling them directly More...

virtual void	LoadImgImpl (const eC_String &kPath, const ImageResource_t &eID)

virtual void	LoadImgImpl (void *pkMemory, const eC_UInt &uiWidth, const eC_UInt &uiHeight, const eC_UInt &eImageType, const ImageResource_t &eID)

virtual void	Rect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)

virtual eC_Bool	Refresh (const RefreshCall_t eRefreshCallType)

virtual void	Ring (const eC_Value &vX1, const eC_Value &vY1, const eC_Value &vX2, const eC_Value &vY2, const eC_Value &vRingWidth, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)

void	SetAlphaThreshold (const eC_UByte &ubAlphaThreshold)

virtual void	SetCliprect (const CGUIRect &NewClipRect)

virtual void	SetForegroundColorImpl (const eC_UByte &ubRed, const eC_UByte &ubGreen, const eC_UByte &ubBlue, const eC_UByte &ubAlpha=255)

void	SetFrameBufferFP (SetFrameBuffer pkSetFrameBuffer)

virtual eC_Bool	SupportCompressedFonts () const

virtual void	UnloadImg (const ImageResource_t &eImageID)

Public Member Functions inherited from CGfxWrap
void	ForceRefresh ()

eC_Bool	GetDoubleBufferingEnforcesFlipping ()

virtual eC_UInt	GetNOFImages ()

virtual eC_UInt	GetPhysicalScreenHeight ()=0

virtual eC_UInt	GetPhysicalScreenWidth ()=0

CGUICommonEnums::ImageType_t	GetScreenFormat () const

virtual eC_UInt	GetScreenHorizontalPPI () const

virtual eC_UInt	GetScreenVerticalPPI () const

virtual eC_UInt	GetVirtualScreenHeight ()=0

virtual eC_UInt	GetVirtualScreenWidth ()=0

virtual eC_UByte *	GetWorkingMemory (const eC_UInt &uiSize)

eC_String	GetWrapperName () const

virtual eC_Bool	ImageExists (const ImageResource_t eID) const =0

virtual void	ReleaseWorkingMemory (eC_UByte *pkMemory)

virtual void	ResetWorkingMemory ()

virtual void	RestoreWrapperState ()

void	SetDoubleBufferingEnforcesFlipping (const eC_Bool bDoubleBufferingEnforcesFlipping)

virtual void	SetFilteredBlit (const eC_Bool &bFilteredBlit)

void	SetGfxEnv (CGfxEnv *pkGfxEnv)

virtual void	SetOptimizedBlit (const eC_Bool &bOptimizedBlit)

void	SetScreenFormat (const CGUICommonEnums::ImageType_t &uiScreenFormat)

virtual void	SetScreenSize (const eC_UInt &uiWidth, const eC_UInt &uiHeight)

virtual void	SetWindowCaption (const eC_String &kText)

virtual void	StoreWrapperState ()

virtual void	SyncWorkingMemory ()

void	SetForegroundColor (const eC_UByte &ubRed, const eC_UByte &ubGreen, const eC_UByte &ubBlue, const eC_UByte &ubAlpha=255)

void	SetForegroundColor (const eC_UInt &uiCol)

void	UpdateGlobalAlpha (const eC_UByte &ubAlpha)

void	SetGlobalAlpha (const eC_UByte &ubAlpha)

virtual eC_Value	SetLineWidth (const eC_Value &vWidth)

eC_UInt	GetForegroundColor () const

eC_UByte	GetGlobalAlpha () const

eC_UByte	ApplyGlobalAlpha (const eC_UByte ubAlpha) const

void	Line (const CGUIRect &kAbsRect)

void	Rect (const CGUIRect &kAbsRect)

void	FilledRect (const CGUIRect &kAbsRect)

void	Ellipse (const CGUIRect &kAbsRect, const eC_Bool &bFilled)

void	Arc (const CGUIRect &kAbsRect, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)

void	Ring (const CGUIRect &kAbsRect, const eC_Value &vRingWidth, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)

void	Text (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_String *const lpString)

virtual void	RedrawGUI ()

virtual void	ResetCliprect ()
	Resets the clipping rectangle.

virtual void	GetCliprect (CGUIRect &AbsClipRect) const

void	InvalidateRect (const CGUIRect &kInvalidRect)

void	InvalidateRect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)

const CGUIRect &	GetInvalidatedRect () const

virtual void	ClearInvalidRect ()

void	BlitImg (const ImageResource_t &eID, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY)

void	BlitImg (const CGUIImageData &kImageData, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY)

void	BlitImgExt (const ImageResource_t &eID, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY, const eC_Value &vWidth, const eC_Value &vHeight, const eC_Bool &bStretch=true, const eC_UByte &ubAlpha=255)

virtual void	BlitImgNinePatch (const ImageResource_t &eID, const CGUIRect &kAbsRect, const eC_UInt uiTopBorder, const eC_UInt uiBottomBorder, const eC_UInt uiLeftBorder, const eC_UInt uiRightBorder, const eC_UByte &ubAlpha=255)

void	BlitImgNinePatch (const ImageResource_t &eID, const CGUIRect &kAbsRect, const CGUINinePatch &kNinePatch, const eC_UByte &ubAlpha=255)

void	BlitImgExt (const ImageResource_t &eID, const CGUIRect &kAbsRect, const eC_Bool &bStretch=true, const eC_UByte &ubAlpha=255)

void	BlitImgExt (const ImageResource_t &eID, const CGUIRect &kSrcAbsRect, const CGUIRect &kDstAbsRect, const eC_UByte &ubAlpha=255)

void	BlitImgExt (const ImageResource_t &eID, const eC_UInt &uiAbsSrcX, const eC_UInt &uiAbsSrcY, const eC_UInt &uiSrcWidth, const eC_UInt &uiSrcHeight, const eC_Value &vAbsDestX, const eC_Value &vAbsDestY, const eC_Value &vDestWidth, const eC_Value &vDestHeight, const eC_UByte &ubAlpha=255, const eC_Value &vAngle=eC_FromFloat(0), const eC_Value &vRotCenterX=eC_FromFloat(0.5), const eC_Value &vRotCenterY=eC_FromFloat(0.5))

eC_UInt	GetImgWidth (const ImageResource_t &eID) const

eC_UInt	GetImgHeight (const ImageResource_t &eID) const

CGUIRect	GetImgOriginRect (const ImageResource_t &eID) const

void	SetFont (const FontResource_t &eID)

void	SetFontSpacing (const eC_Float &fSpacing)

void	RequiredSpace (const eC_String *const pkText, eC_Value &vWidth, eC_Value &vHeight)

void	FittingNumChars (const eC_String *const pkText, eC_Value vWidthMax, eC_UInt &uiNumChars, const eC_Bool &bStartAtEnd=false)

eC_Int	GetAscender () const

eC_Int	GetDescender () const

eC_Int	GetInternalLeading () const

void	GetGlyphMetrics (const eC_Char cChar, CFntWrap::GlyphMetrics_t &kMetrics)

eC_Value	GetTextXPosAdjustment (const CGUIText::HorAligned_t eHorAlignment)

eC_Value	GetTextYPosAdjustment (const CGUIText::VerAligned_t eVerAlignment)

eC_Bool	SetNOFFonts (const eC_UInt uiNOFFonts)

eC_UInt	GetNOFFonts ()

void	ChangeFont (const FontResource_t &eFontID, const eC_Char *const pcPath, const eC_UInt &uiFontSize, const CFntWrap::GUIFont_t &eFontStyle)

void	LoadFont (const FontResource_t &eFontID)

void	UnloadFont (const FontResource_t &eFontID)

virtual void	LoadGlyphData (CGUIImageData pkImageData, const eC_UInt &uiGlyphWidth, const eC_UInt &uiGlyphHeight, eC_UByte pkGlyphBitmap)

virtual void	UnloadGlyphData (CGUIImageData *pkImageData)

virtual eC_TArray< eC_UByte > *	GetBitmapPlaneData (const GUIBitmapPlaneID_t &eBitmapPlaneID)

virtual void	SetTargetLayer (const eC_UInt &uiLayerID)

virtual void	SetRenderingOffset (const eC_Value &vOffsetX, const eC_Value &vOffsetY)

void	GetRenderingOffset (eC_Value &vOffsetX, eC_Value &vOffsetY)

virtual GUIBitmapPlaneID_t	CreateBitmapPlane (const CGUIObject &rkParentObject, const eC_Value &vWidth, const eC_Value &vHeight)

void	DeleteBitmapPlane (const GUIBitmapPlaneID_t uiBitmapID)

void	DeleteBitmapPlanes (const CGUIObject *pkObject)

CGUIBitmapPlane &	GetBitmapPlane (const GUIBitmapPlaneID_t uiBitmapID)

GUIBitmapPlaneID_t	GetUsedBitmapPlaneID () const

Static Public Member Functions
static eC_Bool	CreateInstance (CGfxEnv *pkGfxEnv=NULL)

Static Public Member Functions inherited from CGfxWrap
static void	DeleteInstance ()
	Delete the graphics wrapper instance.

static eC_UInt	GetNextPowerOf2 (const eC_Value &vValue)

Protected Member Functions
	CGfxWrapBLU (CGfxEnv *pkGfxEnv=NULL)

virtual	~CGfxWrapBLU ()
	Destructor.

virtual void	DrawPolygon (blu_point16_t *pkPoints, eC_UInt uiCount)

virtual void	FillPolygon (blu_point16_t *pkPoints, eC_UInt uiCount, eC_UByte ubMode)

virtual eC_Bool	SetNOFImagesImpl (const eC_UInt uiNOFImages)

virtual void	StartHandleDraw (const CGUIRect &crkClipRect)

Protected Member Functions inherited from CGfxWrap
	CGfxWrap ()
	Constructor.

virtual	~CGfxWrap (void)
	Destructor.

virtual void	Arc (const eC_Value &vX1, const eC_Value &vY1, const eC_Value &vX2, const eC_Value &vY2, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)=0

void	DeInit ()
	Deinitialization.

virtual void	Ellipse (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2, const eC_Bool &bFilled)=0

virtual void	FilledRect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)=0

virtual void	Line (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)=0
	the following methods are protected to prevent calling them directly More...

virtual void	Rect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)=0

virtual void	Ring (const eC_Value &vX1, const eC_Value &vY1, const eC_Value &vX2, const eC_Value &vY2, const eC_Value &vRingWidth, const eC_Value &vStartAngle, const eC_Value &vEndAngle, const eC_Value &vRotationAngle, const eC_Bool &bFilled)=0

virtual void	SetForegroundColorImpl (const eC_UByte &ubRed, const eC_UByte &ubGreen, const eC_UByte &ubBlue, const eC_UByte &ubAlpha=255)=0

virtual void	StartRedrawGUI ()

virtual void	EndRedrawGUI ()
	Callback which is called at the end of RedrawGUI() after all Invalidated areas were drawn and refreshed.

virtual void	DestroyScreen ()
	Method to clean and release the screen which was created via the CreateScreen Method. More...

eC_Bool	SetNOFImages (const eC_UInt uiNOFImages)

void	LoadImg (const eC_String &kPath, const ImageResource_t &eID)

void	LoadImg (void *pkMemory, const eC_UInt &uiWidth, const eC_UInt &uiHeight, const eC_UInt &eImageType, const ImageResource_t &eID)

virtual void	RefreshImage (const ImageResource_t &eID, void *pkMemory)

void	SetInvalidatedRect (const eC_Value &vAbsX1, const eC_Value &vAbsY1, const eC_Value &vAbsX2, const eC_Value &vAbsY2)

void	SetInvalidatedRect (const CGUIRect &NewAbsRect)

void	ResetInvalidatedRect ()
	Resets the invalidated rectangle.

CGUIBitmapPlane &	GetDummyBitmap ()

virtual eC_Bool	FinishDrawToBitmap ()

Protected Attributes
eC_Bool	m_bScratchbufferInUse
	Whether we're using the scratch buffer instead of the display.

CGUIRect	m_kScratchbufferRect
	Rect describing the scratchpad's position on the screen.

__blu_bitmap	m_kScratchPad
	scratch-buffer

__blu_bitmap	m_kSourceBitmap
	source-bitmap

__blu_bitmap *	m_pkDestinationBitmaps
	destination-bitmaps

eC_TArray< CGUIImageDataBLU * >	m_pkImages
	internal images

SetFrameBuffer *	m_pkSetFrameBuffer
	function-pointer to specific flip-method

eC_UByte	m_ubAlphaThreshold
	alpha-threshold

eC_UInt	m_uiCurrentBuffer
	currently active framebuffer

eC_UInt	m_uiNumberOfBuffers
	number of framebuffers used

eC_UInt	m_uiSizeOfScratchpad
	size of sratch-buffer

Protected Attributes inherited from CGfxWrap
eC_Bool	m_bDoubleBufferingEnforcesFlipping

eC_Bool	m_bFilteredBlit
	if filtered blit is active

eC_Bool	m_bInvalidationInLastFrame

eC_Bool	m_bOptimizedBlit
	if optimized blit is active

CGUIRect	m_kClippingRect

eC_Semaphore	m_kGfxWrapSemaphore
	Semaphore to lock access to methods used in a multi thread context.

CGUIRect	m_kInvalidatedRect

eC_TListDoubleLinked< CGUIRect >	m_kInvalidatedRectList
	This is the list of invalidated rectangular regions within the GUI.

eC_TListDoubleLinked< CGUIRect >	m_kLastFrameInvalidatedRectList
	This is the list of regions which have been invalidated during the LAST frame.

eC_String	m_kWrapperName
	name of the wrapper

CGfxEnv *	m_pkGfxEnv
	pointer to the graphics-environment

eC_UByte	m_ubAlpha
	Currently set global alpha value.

eC_UInt	m_uiColor
	Currently set foreground color.

eC_UInt	m_uiNOFImages
	total number of image-objects

eC_UInt	m_uiScreenHeight
	Screen height.

eC_UInt	m_uiScreenWidth
	Screen width.

eC_Value	m_vGlobalAlphaFactor

eC_Value	m_vLineWidth
	Line width in pixels.

eC_Value	m_vRenderingOffsetX
	offset in x-direction

eC_Value	m_vRenderingOffsetY
	offset in y-direction

Static Protected Attributes
static const eC_UInt	cuiSegmentAngle
	angle of segment for arc and ring

Static Protected Attributes inherited from CGfxWrap
static const eC_Value	cvTwoPi
	constant for 2 PI

Detailed Description

BLU-specific graphics-wrapper.

Constructor & Destructor Documentation

◆ CGfxWrapBLU()

CGfxWrapBLU::CGfxWrapBLU ( CGfxEnv * pkGfxEnv = NULL )

protected

Constructor

Parameters

pkGfxEnv

Member Function Documentation

◆ Arc()

virtual void CGfxWrapBLU::Arc	(	const eC_Value &	vX1,
		const eC_Value &	vY1,
		const eC_Value &	vX2,
		const eC_Value &	vY2,
		const eC_Value &	vStartAngle,
		const eC_Value &	vEndAngle,
		const eC_Value &	vRotationAngle,
		const eC_Bool &	bFilled
	)

virtual

Draws an arc which is completly inside the rectangle described through the rectangle the top left edge at (vAbsX1, vAbsY1) and bottom right edge at (vAbsX2, vAbsY2). The arc will be filled out if the last parameter is true 0-degrees is at the mathematically correct position on the unit-circle angles are increasing in counter-clockwise direction. rotation-angle is increasing in clockwise direction, i.e. rotating by 90 degrees will result in the 0-degress being at the bottom-center

Parameters

vX1	X-coordinate of bounding rectangle's top left corner
vY1	Y-Coordinate of bounding rectangle's top left corner
vX2	X-coordinate of bounding rectangle's bottom right corner
vY2	Y-Coordinate of bounding rectangle's bottom right corner
vStartAngle	start-angle
vEndAngle	end-angle
vRotationAngle	rotation-angle
bFilled	Specifies whether the arc will be drawn outlined (false) or filled (true)

Implements CGfxWrap.

◆ BlitImgExtImpl() [1/2]

virtual void CGfxWrapBLU::BlitImgExtImpl	(	const CGUIImageData &	kImageData,
		const eC_Value &	vAbsDestX,
		const eC_Value &	vAbsDestY
	)

virtual

Blits an image. This MUST be implemented by all graphics wrappers. It is ensured that the supplied image ID is in the valid range and is not DUMMY_IMAGE. For detailed explanations, please refer to CGfxWrap::BlitImgExt

Parameters

kImageData	ImageData
vAbsDestX	Destination X position in absolute coordinates
vAbsDestY	Destination Y position in absolute coordinates

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ BlitImgExtImpl() [2/2]

virtual void CGfxWrapBLU::BlitImgExtImpl	(	const ImageResource_t &	eID,
		const eC_UInt &	uiAbsSrcX,
		const eC_UInt &	uiAbsSrcY,
		const eC_UInt &	uiSrcWidth,
		const eC_UInt &	uiSrcHeight,
		const eC_Value &	vAbsDestX,
		const eC_Value &	vAbsDestY,
		const eC_Value &	vDestWidth,
		const eC_Value &	vDestHeight,
		const eC_UByte &	ubAlpha = `255`,
		const eC_Value &	vAngle = `eC_FromFloat(0)`,
		const eC_Value &	vRotCenterX = `eC_FromFloat(0.5)`,
		const eC_Value &	vRotCenterY = `eC_FromFloat(0.5)`
	)

virtual

Blits an image. This MUST be implemented by all graphics wrappers. It is ensured that the supplied image ID is in the valid range and is not DUMMY_IMAGE. For detailed explanations, please refer to CGfxWrap::BlitImgExt

Parameters

eID	Identifier of the image to be blitted.
uiAbsSrcX	X coordinate of upper left corner of the relevant area within the source image
uiAbsSrcY	Y coordinate of upper left corner of the relevant area within the source image
uiSrcWidth	Width of the relevant area within the source image
uiSrcHeight	Height of the relevant area within the source image
vAbsDestX	Destination X position in absolute coordinates
vAbsDestY	Destination Y position in absolute coordinates
vDestWidth	Destination width
vDestHeight	Destination height
ubAlpha	Degree of transparency. 0=transparent 255=opaque Default is opaque.
vAngle	Angle in degrees by which the image will be rotated
vRotCenterX	Rotation center X. In range of 0 to 1 (like U/V coordinates)
vRotCenterY	Rotation center Y. In range of 0 to 1 (like U/V coordinates)

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ CreateGfxDependentBitmap()

CGUIBitmapPlane * CGfxWrapBLU::CreateGfxDependentBitmap	(	GUIBitmapPlaneID_t	uiNewBitmapID,
		const CGUIObject &	rkParentObject,
		const eC_Value &	vWidth,
		const eC_Value &	vHeight
	)

virtual

Method which will be called by CreateBitmap to instantiate a new Bitmap-Object. This Method needs to be implemented by every derived GfxWrapper. If a GfxWrapper does not support Bitmap-Handling, he may create an CGUIBaseBitmap

See also: Bitmap planes

Parameters

uiNewBitmapID	ID of the new BitmapPlane
rkParentObject	reference to the GUIObject which will be the parent of the bitmap
vWidth	width of the new bitmap
vHeight	height of the new bitmap

Returns: pointer to the new created BitmapObject

Reimplemented from CGfxWrap.

◆ CreateInstance()

static eC_Bool CGfxWrapBLU::CreateInstance ( CGfxEnv * pkGfxEnv = NULL )

static

Singleton for creating a GfxWrap-Null object and change the pointer in base class to this gfx wrapper.

Parameters

pkGfxEnv graphics-environment

Returns: true if successful

◆ DrawPolygon()

virtual void CGfxWrapBLU::DrawPolygon	(	blu_point16_t *	pkPoints,
		eC_UInt	uiCount
	)

protectedvirtual

Draw a polygon

Parameters

pkPoints
uiCount	number of points

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ DrawToBitmap()

virtual eC_Bool CGfxWrapBLU::DrawToBitmap ( GUIBitmapPlaneID_t uiBitmapID )

virtual

Changes the RenderTarget to the BitmapPlane with the given ID. All successive GfxWrap draw commands will be done in the bitmap of this plane instead of within the framebuffer

Parameters

uiBitmapID ID of the BitmapPlane in which will be drawn.

Returns: True if the BitmapPlane with given ID exists, otherwise False

Reimplemented from CGfxWrap.

◆ DrawToScreen()

virtual eC_Bool CGfxWrapBLU::DrawToScreen ( )

virtual

Activates the Screen as active RenderTarget again

Returns: True if the changing was successful, otherwise False

Reimplemented from CGfxWrap.

◆ Ellipse()

virtual void CGfxWrapBLU::Ellipse	(	const eC_Value &	vAbsX1,
		const eC_Value &	vAbsY1,
		const eC_Value &	vAbsX2,
		const eC_Value &	vAbsY2,
		const eC_Bool &	bFilled
	)

virtual

Draws an ellipse which is completly inside the rectangle described through the rectangle the top left edge at (vAbsX1, vAbsY1) and bottom right edge at (vAbsX2, vAbsY2). The ellipse will be filled out if the last parameter is true

Parameters

vAbsX1	X-coordinate of bounding rectangle's top left corner
vAbsY1	Y-Coordinate of bounding rectangle's top left corner
vAbsX2	X-coordinate of bounding rectangle's bottom right corner
vAbsY2	Y-Coordinate of bounding rectangle's bottom right corner
bFilled	Specifies whether the ellipse will be drawn outlined (false) or filled (true)

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ FilledRect()

virtual void CGfxWrapBLU::FilledRect	(	const eC_Value &	vAbsX1,
		const eC_Value &	vAbsY1,
		const eC_Value &	vAbsX2,
		const eC_Value &	vAbsY2
	)

virtual

Draws a filled rectangle with the top left edge at (vAbsX1, vAbsY1) and bottom right edge at (vAbsX2, vAbsY2) The bottom edge and the right edge is not included in the drawn rect. e.g. FilledRect(0, 0, 10, 10); the rect is drawn from (0,0) to (9,9) (both included).

See also: CGUIObject::GetAbsRect()

Parameters

vAbsX1	X-coordinate of top left corner
vAbsY1	Y-Coordinate of top left corner
vAbsX2	X-coordinate of bottom right corner
vAbsY2	Y-Coordinate of bottom right corner

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ FillPolygon()

virtual void CGfxWrapBLU::FillPolygon	(	blu_point16_t *	pkPoints,
		eC_UInt	uiCount,
		eC_UByte	ubMode
	)

protectedvirtual

Fill a polygon

Parameters

pkPoints	points
uiCount	number of points
ubMode	mode

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ GetAlphaThreshold()

eC_UByte CGfxWrapBLU::GetAlphaThreshold ( ) const

inline

Get the currently used threshold for alpha-blending (default: 127)

Returns: threshold

◆ GetDestination()

__blu_bitmap * CGfxWrapBLU::GetDestination ( )

inline

Return the destination-bitmap

Returns: destination-bitmap

◆ GetImageSize()

virtual eC_UInt CGfxWrapBLU::GetImageSize ( const ImageResource_t & eID ) const

virtual

Computes the size of a loaded image's raw pixel data (e.g. RGBA or RGB565, depending on platform) in memory. Needed for the Image Cache. Since this will be called by the Guiliani Image cache, derived wrappers _must not_ call NotifyImageAccess() from within this method.

Parameters

eID	The image's ID.

Returns: the size of the image in bytes

Implements CGfxWrap.

◆ GetImgHeightImpl()

virtual eC_UInt CGfxWrapBLU::GetImgHeightImpl ( const ImageResource_t & eID ) const

virtual

Returns the height of an image. Must be implemented by each graphics wrapper.

Parameters

eID	The ID of the image whose width should be returned. It is ensured that eID is always in the valid range and not DUMMY_IMAGE.

Returns: The width of the image in pixels.

Implements CGfxWrap.

◆ GetImgWidthImpl()

virtual eC_UInt CGfxWrapBLU::GetImgWidthImpl ( const ImageResource_t & eID ) const

virtual

Returns the width of an image. Must be implemented by each graphics wrapper.

Parameters

eID	The ID of the image whose width should be returned. It is ensured that eID is always in the valid range and not DUMMY_IMAGE.

Returns: The width of the image in pixels.

Implements CGfxWrap.

◆ GetPhysicalScreenHeight()

virtual eC_UInt CGfxWrapBLU::GetPhysicalScreenHeight ( )

virtual

Returns the screen height. Will always return the physical screen height with which the GfxWrap was originally initialized. Regardless of whether the virtual screen size has been modified e.g. while drawing into a CGUIBitmapPlane.

Returns: Physical screen height

Implements CGfxWrap.

◆ GetPhysicalScreenWidth()

virtual eC_UInt CGfxWrapBLU::GetPhysicalScreenWidth ( )

virtual

Returns the screen width. Will always return the physical screen width with which the GfxWrap was originally initialized. Regardless of whether the virtual screen size has been modified e.g. while drawing into a CGUIBitmapPlane.

Returns: Physical screen width

Implements CGfxWrap.

◆ GetScratchBufferRect()

CGUIRect CGfxWrapBLU::GetScratchBufferRect ( ) const

inline

Get rect of scratch-buffer

Returns: rect of scratch-buffer

◆ GetVirtualScreenHeight()

virtual eC_UInt CGfxWrapBLU::GetVirtualScreenHeight ( )

virtual

Returns the screen height in pixels, may vary if DrawToBitmap is active. It will then return the active BitmapPlane's height instead.

See also: GetPhysicalScreenHeight()

Returns: eC_UInt The screen height

Implements CGfxWrap.

◆ GetVirtualScreenWidth()

virtual eC_UInt CGfxWrapBLU::GetVirtualScreenWidth ( )

virtual

Returns the screen width in pixels, may vary if DrawToBitmap is active. It will then return the active BitmapPlane's width instead.

See also: GetPhysicalScreenWidth()

Returns: eC_UInt The screen width

Implements CGfxWrap.

◆ ImageExists()

virtual eC_Bool CGfxWrapBLU::ImageExists ( const ImageResource_t eID ) const

virtual

Returns whether the image with the given ID currently is loaded within the Graphics Wrapper. This interface must be implemented by derived graphics wrappers.

Parameters

eID	The ID to check

Returns: True if the image with the given ID is currently loaded, False otherwise.

Implements CGfxWrap.

◆ Init() [1/2]

void CGfxWrapBLU::Init ( )

Initialize

◆ Init() [2/2]

void CGfxWrapBLU::Init	(	const eC_UInt &	uiWidth,
		const eC_UInt &	uiHeight,
		const eC_UByte &	ubBitPerPixel,
		const eC_UInt	uiNumberOfBuffers,
		void **	pkFrameBuffers
	)

Initialize

Parameters

uiWidth
uiHeight
ubBitPerPixel
uiNumberOfBuffers
pkFrameBuffers

◆ IsScratchBufferIsUse()

eC_Bool CGfxWrapBLU::IsScratchBufferIsUse ( ) const

inline

Indicate if scratch-buffer is in use

Returns: true if so

◆ Line()

virtual void CGfxWrapBLU::Line	(	const eC_Value &	vAbsX1,
		const eC_Value &	vAbsY1,
		const eC_Value &	vAbsX2,
		const eC_Value &	vAbsY2
	)

virtual

the following methods are protected to prevent calling them directly

Draws a line from (vAbsX1, vAbsY1) to (vAbsX2, vAbsY2)

Parameters

vAbsX1	X-coordinate of starting point
vAbsY1	Y-Coordinate of starting point
vAbsX2	X-coordinate of ending point
vAbsY2	Y-Coordinate of ending point

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ LoadImgImpl() [1/2]

virtual void CGfxWrapBLU::LoadImgImpl	(	const eC_String &	kPath,
		const ImageResource_t &	eID
	)

virtual

Loads an image. This loads an image from the given path and associates it with an Image-Identifier.

Parameters

kPath	Complete path and filename of the image to be loaded.
eID	ID by which the image will later be accessible.

Implements CGfxWrap.

◆ LoadImgImpl() [2/2]

virtual void CGfxWrapBLU::LoadImgImpl	(	void *	pkMemory,
		const eC_UInt &	uiWidth,
		const eC_UInt &	uiHeight,
		const eC_UInt &	eImageType,
		const ImageResource_t &	eID
	)

virtual

Loads a memory-image. This loads an image from a pointer and associates it with an Image-Identifier.

Parameters

pkMemory	pointer to image-data.
uiWidth
uiHeight
eImageType
eID	ID by which the image will later be accessible.

Implements CGfxWrap.

◆ Rect()

virtual void CGfxWrapBLU::Rect	(	const eC_Value &	vAbsX1,
		const eC_Value &	vAbsY1,
		const eC_Value &	vAbsX2,
		const eC_Value &	vAbsY2
	)

virtual

Draws a rectangle with the top left edge at (vAbsX1, vAbsY1) and bottom right edge at (vAbsX2, vAbsY2). The bottom edge and the right edge is not included in the drawn rect. e.g. Rect(0, 0, 10, 10); the rect is drawn from (0,0) to (9,9) (both included).

See also: CGUIObject::GetAbsRect()

Parameters

vAbsX1	X-coordinate of top left corner
vAbsY1	Y-Coordinate of top left corner
vAbsX2	X-coordinate of bottom right corner
vAbsY2	Y-Coordinate of bottom right corner

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ Refresh()

virtual eC_Bool CGfxWrapBLU::Refresh ( const RefreshCall_t eRefreshCallType )

virtual

Method to bring the screen content onto the physical screen so that it becomes visible, usually via a blit operation.

Parameters

eRefreshCallType The call type of this refresh

Returns: True of the refresh was performed, False otherwise

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ Ring()

virtual void CGfxWrapBLU::Ring	(	const eC_Value &	vX1,
		const eC_Value &	vY1,
		const eC_Value &	vX2,
		const eC_Value &	vY2,
		const eC_Value &	vRingWidth,
		const eC_Value &	vStartAngle,
		const eC_Value &	vEndAngle,
		const eC_Value &	vRotationAngle,
		const eC_Bool &	bFilled
	)

virtual

Draws a ring which is completly inside the rectangle described through the rectangle the top left edge at (vAbsX1, vAbsY1) and bottom right edge at (vAbsX2, vAbsY2). The ring will be filled out if the last parameter is true 0-degrees is at the mathematically correct position on the unit-circle angles are increasing in counter-clockwise direction. rotation-angle is increasing in clockwise direction, i.e. rotating by 90 degrees will result in the 0-degress being at the bottom-center

Parameters

vX1	X-coordinate of bounding rectangle's top left corner
vY1	Y-Coordinate of bounding rectangle's top left corner
vX2	X-coordinate of bounding rectangle's bottom right corner
vY2	Y-Coordinate of bounding rectangle's bottom right corner
vRingWidth	width of the ring
vStartAngle	start-angle
vEndAngle	end-angle
vRotationAngle	rotation-angle
bFilled	Specifies whether the ring will be drawn outlined (false) or filled (true)

Implements CGfxWrap.

◆ SetAlphaThreshold()

void CGfxWrapBLU::SetAlphaThreshold ( const eC_UByte & ubAlphaThreshold )

inline

Sets the threshold for alpha-blending. values below will be treated as fully transparent

Parameters

ubAlphaThreshold

◆ SetCliprect()

virtual void CGfxWrapBLU::SetCliprect ( const CGUIRect & NewAbsClipRect )

virtual

Sets a clipping rectangle. All drawing operations will be limited to the region within the clipping rectangle. This is very useful for advanced features such as soft-scrolling. Note that the clipping rectangle is not allowed to exceed the invalidated rectangle, since this would lead to visual artifacts.

Parameters

NewAbsClipRect A normalised rectangle that includes all pixels that could be drawn by the functions of the graphics wrapper. The rectangle includes the border. All pixels outside will be left untouched.

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ SetForegroundColorImpl()

virtual void CGfxWrapBLU::SetForegroundColorImpl	(	const eC_UByte &	ubRed,
		const eC_UByte &	ubGreen,
		const eC_UByte &	ubBlue,
		const eC_UByte &	ubAlpha = `255`
	)

virtual

Sets the foreground color. This MUST be implemented by all graphics wrappers. For detailed explanations, please refer to CGfxWrap::SetForegroundColor

Parameters

ubRed	Red intensity within a range of 0 - 255
ubGreen	Green intensity within a range of 0 - 255
ubBlue	Blue intensity within a range of 0 - 255
ubAlpha	Alpha intensity within a range of 0 (transparent) - 255 (opaque)

Implements CGfxWrap.

Reimplemented in CGfxWrap_stm32f429, and CGfxWrap_stm32f746.

◆ SetFrameBufferFP()

void CGfxWrapBLU::SetFrameBufferFP ( SetFrameBuffer pkSetFrameBuffer )

Set the function which is called when the framebuffer will be flipped

Parameters

pkSetFrameBuffer

◆ SetNOFImagesImpl()

virtual eC_Bool CGfxWrapBLU::SetNOFImagesImpl ( const eC_UInt uiNOFImages )

protectedvirtual

Sets the total number of images. This is called internally by the ResourceManager when dynamically allocated image resources require the total number of images to be raised. Derived classes will have to override this method and resize their internal image-storage structures according to the new number of images which will have to be stored.

Parameters

uiNOFImages The number of images

Returns: True if internal storage has been successfully adapted to support the requested number of images. False otherwise.

Reimplemented from CGfxWrap.

◆ StartHandleDraw()

virtual void CGfxWrapBLU::StartHandleDraw ( const CGUIRect & crkClipRect )

protectedvirtual

Called for every single InvalidatedRect() during RedrawGUI(). Also serves as proxy function to make GETGUI.HandleDraw() accessible from derived graphics wrappers. Make sure to call CGfxWrap::StartHandleDraw() when overriding this function.

Parameters

crkClipRect Rectangle against which this cycle of handle draw calls will be clipped.

Reimplemented from CGfxWrap.

◆ SupportCompressedFonts()

virtual eC_Bool CGfxWrapBLU::SupportCompressedFonts ( ) const

inlinevirtual

Return if gfxwrap supports compressed fonts other than Alpha8

Returns: true if supported

Reimplemented from CGfxWrap.

◆ UnloadImg()

virtual void CGfxWrapBLU::UnloadImg ( const ImageResource_t & eID )

virtual

Unloads an image. Unloads the image associated with the supplied Image-identifier and frees the memory formerly occupied by this image.

Parameters

eID	Identifier of the image to be unloaded.

Reimplemented from CGfxWrap.

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

GfxWrapBLU.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CGfxWrapBLU()

Member Function Documentation

◆ Arc()

◆ BlitImgExtImpl() [1/2]

◆ BlitImgExtImpl() [2/2]

◆ CreateGfxDependentBitmap()

◆ CreateInstance()

◆ DrawPolygon()

◆ DrawToBitmap()

◆ DrawToScreen()

◆ Ellipse()

◆ FilledRect()

◆ FillPolygon()

◆ GetAlphaThreshold()

◆ GetDestination()

◆ GetImageSize()

◆ GetImgHeightImpl()

◆ GetImgWidthImpl()

◆ GetPhysicalScreenHeight()

◆ GetPhysicalScreenWidth()

◆ GetScratchBufferRect()

◆ GetVirtualScreenHeight()

◆ GetVirtualScreenWidth()

◆ ImageExists()

◆ Init() [1/2]

◆ Init() [2/2]

◆ IsScratchBufferIsUse()

◆ Line()

◆ LoadImgImpl() [1/2]

◆ LoadImgImpl() [2/2]

◆ Rect()

◆ Refresh()

◆ Ring()

◆ SetAlphaThreshold()

◆ SetCliprect()

◆ SetForegroundColorImpl()

◆ SetFrameBufferFP()

◆ SetNOFImagesImpl()

◆ StartHandleDraw()

◆ SupportCompressedFonts()

◆ UnloadImg()