Skip to main content

PainterRGB888L8Bitmap

PainterRGB888L8Bitmap will take the color for a given point in the shape from a bitmap. Please be aware, the the bitmap is used by the CanvasWidgetRenderer (not Shape), so any rotation you might specify for a CanvasWidget (e.g. Shape) is not applied to the bitmap as CWR is not aware of this rotation.

See: AbstractPainter

Inherits from: AbstractPainterRGB888, AbstractPainter

Public Functions

PainterRGB888L8Bitmap(const Bitmap & bmp =Bitmap(BITMAP_INVALID))
Initializes a new instance of the PainterRGB888L8Bitmap class.
virtual voidrender(uint8_t ptr, int x, int xAdjust, int y, unsigned count, const uint8_t covers)
Paint a designated part of the RenderingBuffer with respect to the amount of coverage of each pixel given by the parameter covers.
voidsetBitmap(const Bitmap & bmp)
Sets a bitmap to be used when drawing the CanvasWidget.

Protected Functions

virtual boolrenderInit()
Initialize rendering of a single scan line of pixels for the render.
virtual boolrenderNext(uint8_t & red, uint8_t & green, uint8_t & blue, uint8_t & alpha)
Get the color of the next pixel in the scan line to blend into the framebuffer.

Protected Attributes

Bitmapbitmap
The bitmap to be used when painting.
const uint8_t *bitmapExtraPointer
Pointer to the CLUT (L8)
const uint8_t *bitmapPointer
Pointer to the bitmap (L8)
RectbitmapRectToFrameBuffer
Bitmap rectangle translated to framebuffer coordinates.

Additional inherited members

Public Functions inherited from AbstractPainterRGB888

Protected Functions inherited from AbstractPainterRGB888

virtual voidrenderPixel(uint16_t * p, uint8_t red, uint8_t green, uint8_t blue)
Renders (writes) the specified color into the framebuffer.

Protected Attributes inherited from AbstractPainterRGB888

intcurrentX
Current x coordinate relative to the widget.
intcurrentY
Current y coordinate relative to the widget.

Public Functions inherited from AbstractPainter

AbstractPainter()
Initializes a new instance of the AbstractPainter class.
voidsetOffset(uint16_t offsetX, uint16_t offsetY)
Sets the offset of the area being drawn.
virtual ~AbstractPainter()
Finalizes an instance of the AbstractPainter class.

Protected Functions inherited from AbstractPainter

voidsetWidgetAlpha(const uint8_t alpha)
Sets the widget alpha to allow an entire canvas widget to easily be faded without changing the painter of the widget.
FORCE_INLINE_FUNCTION boolcompatibleFramebuffer(Bitmap::BitmapFormat format)
Helper function to check if the provided bitmap format matches the current framebuffer format.

Protected Attributes inherited from AbstractPainter

int16_tareaOffsetX
The offset x coordinate of the area being drawn.
int16_tareaOffsetY
The offset y coordinate of the area being drawn.
uint8_twidgetAlpha
The alpha of the widget using the painter.

Public Functions Documentation

PainterRGB888L8Bitmap

PainterRGB888L8Bitmap(const Bitmap &bmp =Bitmap(BITMAP_INVALID))

Initializes a new instance of the PainterRGB888L8Bitmap class.

Parameters:
bmp(Optional) The bitmap, default is BITMAP_INVALID.

render

virtual void render(uint8_t *ptr ,
intx ,
intxAdjust ,
inty ,
unsignedcount ,
const uint8_t *covers
)

Paint a designated part of the RenderingBuffer with respect to the amount of coverage of each pixel given by the parameter covers.

The cover is the alpha for each pixel, which is what makes it possible to have smooth anti-aliased edges on the shapes drawn with CanvasWidgetRenderer.

Parameters:
ptrPointer to the row in the RenderingBuffer.
xThe x coordinate.
xAdjustThe minor adjustment of x (used when a pixel is smaller than a byte to specify that the ptr should have been advanced "xAdjust" pixels futher into the byte).
yThe y coordinate.
countNumber of pixels to fill.
coversThe coverage in of each pixel.
Note

The implementation of render() in the AbstractPainter classes is a generic (i.e. slow) implementation that should be completely implemented in subclasses of AbstractPainter for better performance.

Reimplements: touchgfx::AbstractPainterRGB888::render

setBitmap

void setBitmap(const Bitmap &bmp)

Sets a bitmap to be used when drawing the CanvasWidget.

Parameters:
bmpThe bitmap.

Protected Functions Documentation

renderInit

virtual bool renderInit()

Initialize rendering of a single scan line of pixels for the render.

If renderInit returns false, the scanline will not be rendered.

Returns:

true if it succeeds, false if it fails.

Reimplements: touchgfx::AbstractPainterRGB888::renderInit

renderNext

virtual bool renderNext(uint8_t &red ,
uint8_t &green ,
uint8_t &blue ,
uint8_t &alpha
)

Get the color of the next pixel in the scan line to blend into the framebuffer.

Parameters:
redThe red.
greenThe green.
blueThe blue.
alphaThe alpha.
Returns:

true if the pixel should be painted, false otherwise.

Reimplements: touchgfx::AbstractPainterRGB888::renderNext

Protected Attributes Documentation

bitmap

Bitmap bitmap

The bitmap to be used when painting.

bitmapExtraPointer

const uint8_t * bitmapExtraPointer

Pointer to the CLUT (L8)

bitmapPointer

const uint8_t * bitmapPointer

Pointer to the bitmap (L8)

bitmapRectToFrameBuffer

Rect bitmapRectToFrameBuffer

Bitmap rectangle translated to framebuffer coordinates.