451 lines
22 KiB
C++

/******************************************************************************
* Copyright (c) 2018(-2023) STMicroelectronics.
* All rights reserved.
*
* This file is part of the TouchGFX 4.21.2 distribution.
*
* This software is licensed under terms that can be found in the LICENSE file in
* the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
*******************************************************************************/
/**
* @file platform/driver/lcd/LCD8bpp_ARGB2222.hpp
*
* Declares the touchgfx::LCD8bpp_ARGB2222 class.
*/
#ifndef TOUCHGFX_LCD8BPP_ARGB2222_HPP
#define TOUCHGFX_LCD8BPP_ARGB2222_HPP
#include <touchgfx/Bitmap.hpp>
#include <touchgfx/hal/HAL.hpp>
#include <touchgfx/hal/Types.hpp>
#include <touchgfx/lcd/LCD.hpp>
#include <touchgfx/lcd/LCD8ARGB2222DebugPrinter.hpp>
namespace touchgfx
{
/**
* This class contains the various low-level drawing routines for drawing bitmaps, texts and
* rectangles on 16 bits per pixel displays.
*
* @see LCD
*
* @note All coordinates are expected to be in absolute coordinates!
*/
class LCD8bpp_ARGB2222 : public LCD
{
public:
LCD8bpp_ARGB2222();
virtual void drawPartialBitmap(const Bitmap& bitmap, int16_t x, int16_t y, const Rect& rect, uint8_t alpha = 255, bool useOptimized = true);
virtual void blitCopy(const uint16_t* sourceData, const Rect& source, const Rect& blitRect, uint8_t alpha, bool hasTransparentPixels);
virtual void blitCopy(const uint8_t* sourceData, Bitmap::BitmapFormat sourceFormat, const Rect& source, const Rect& blitRect, uint8_t alpha, bool hasTransparentPixels);
virtual uint16_t* copyFrameBufferRegionToMemory(const Rect& visRegion, const Rect& absRegion, const BitmapId bitmapId);
virtual Rect copyFrameBufferRegionToMemory(const Rect& visRegion, const Rect& absRegion, uint8_t* dst, int16_t dstWidth, int16_t dstHeight);
virtual void copyAreaFromTFTToClientBuffer(const Rect& region);
virtual void fillRect(const Rect& rect, colortype color, uint8_t alpha = 255);
virtual void fillBuffer(uint8_t* const destination, uint16_t pixelStride, const Rect& rect, const colortype color, const uint8_t alpha);
virtual uint8_t bitDepth() const
{
return 8;
}
virtual Bitmap::BitmapFormat framebufferFormat() const
{
return Bitmap::ARGB2222;
}
virtual uint16_t framebufferStride() const
{
return getFramebufferStride();
}
/**
* Framebuffer stride in bytes. The distance (in bytes) from the start of one
* framebuffer row, to the next.
*
* @return The number of bytes in one framebuffer row.
*/
FORCE_INLINE_FUNCTION static uint16_t getFramebufferStride()
{
assert(HAL::FRAME_BUFFER_WIDTH > 0 && "HAL has not been initialized yet");
return HAL::FRAME_BUFFER_WIDTH;
}
/**
* Gets color from RGB.
*
* @param red The red.
* @param green The green.
* @param blue The blue.
*
* @return The color from RGB.
*/
FORCE_INLINE_FUNCTION static uint8_t getNativeColorFromRGB(uint8_t red, uint8_t green, uint8_t blue)
{
return 0xC0 | ((red & 0xC0) >> 2) | ((green & 0xC0) >> 4) | ((blue & 0xC0) >> 6);
}
/**
* Generates a color representation to be used on the LCD, based on 24 bit RGB values.
*
* @param color The color.
*
* @return The color representation depending on LCD color format.
*/
FORCE_INLINE_FUNCTION static uint8_t getNativeColor(colortype color)
{
return 0xC0 | ((color >> 18) & 0x30) | ((color >> 12) & 0x0C) | ((color >> 6) & 0x03);
}
/**
* Gets red from color.
*
* @param color The color.
*
* @return The red from color.
*/
FORCE_INLINE_FUNCTION static uint8_t getRedFromNativeColor(uint8_t color)
{
return ((color >> 4) & 0x03) * 0x55;
}
/**
* Gets green from color.
*
* @param color The color.
*
* @return The green from color.
*/
FORCE_INLINE_FUNCTION static uint8_t getGreenFromNativeColor(uint8_t color)
{
return ((color >> 2) & 0x03) * 0x55;
}
/**
* Gets blue from color.
*
* @param color The color.
*
* @return The blue from color.
*/
FORCE_INLINE_FUNCTION static uint8_t getBlueFromNativeColor(uint8_t color)
{
return (color & 0x03) * 0x55;
}
/**
* Gets alpha from color.
*
* @param color The color.
*
* @return The alpha from color.
*/
FORCE_INLINE_FUNCTION static uint8_t getAlphaFromNativeColor(uint8_t color)
{
return ((color >> 6) & 0x03) * 0x55;
}
/**
* Enables the texture mappers for all image formats. This allows drawing any image
* using Bilinear Interpolation and Nearest Neighbor algorithms, but might use a lot of
* memory for the drawing algorithms.
*/
void enableTextureMapperAll();
/**
* Enables the texture mappers for ARGB2222 image format. This allows drawing ARGB2222
* images using Bilinear Interpolation and Nearest Neighbor algorithms.
*
* @see enableTextureMapperARGB2222_BilinearInterpolation,
* enableTextureMapperARGB2222_NearestNeighbor
*/
void enableTextureMapperARGB2222();
/**
* Enables the texture mappers for ARGB2222 image format. This allows drawing ARGB2222
* images using Bilinear Interpolation algorithm.
*
* @see enableTextureMapperARGB2222, enableTextureMapperARGB2222_NearestNeighbor
*/
void enableTextureMapperARGB2222_BilinearInterpolation();
/**
* Enables the texture mappers for ARGB2222 image format. This allows drawing ARGB2222
* images using Nearest Neighbor algorithm.
*
* @see enableTextureMapperARGB2222, enableTextureMapperARGB2222_BilinearInterpolation
*/
void enableTextureMapperARGB2222_NearestNeighbor();
/**
* Enables the texture mappers for ARGB8888 image format. This allows drawing ARGB8888
* images using Bilinear Interpolation and Nearest Neighbor algorithms.
*
* @see enableTextureMapperARGB8888_BilinearInterpolation,
* enableTextureMapperARGB8888_NearestNeighbor
*/
void enableTextureMapperARGB8888();
/**
* Enables the texture mappers for ARGB8888 image format. This allows drawing ARGB8888
* images using Bilinear Interpolation algorithm.
*
* @see enableTextureMapperARGB8888, enableTextureMapperARGB8888_NearestNeighbor
*/
void enableTextureMapperARGB8888_BilinearInterpolation();
/**
* Enables the texture mappers for ARGB8888 image format. This allows drawing ARGB8888
* images using Nearest Neighbor algorithm.
*
* @see enableTextureMapperARGB8888, enableTextureMapperARGB8888_BilinearInterpolation
*/
void enableTextureMapperARGB8888_NearestNeighbor();
/**
* Enables the texture mappers for A4 image format. This allows drawing A4 images using
* Bilinear Interpolation and Nearest Neighbor algorithms.
*
* @see enableTextureMapperA4_BilinearInterpolation, enableTextureMapperA4_NearestNeighbor
*/
void enableTextureMapperA4();
/**
* Enables the texture mappers for A4 image format. This allows drawing A4 images using
* Bilinear Interpolation algorithm.
*
* @see enableTextureMapperA4, enableTextureMapperA4_NearestNeighbor
*/
void enableTextureMapperA4_BilinearInterpolation();
/**
* Enables the texture mappers for A4 image format. This allows drawing A4 images using
* Nearest Neighbor algorithm.
*
* @see enableTextureMapperA4, enableTextureMapperA4_BilinearInterpolation
*/
void enableTextureMapperA4_NearestNeighbor();
protected:
virtual DrawTextureMapScanLineBase* getTextureMapperDrawScanLine(const TextureSurface& texture, RenderingVariant renderVariant, uint8_t alpha);
/**
* Find out how much to advance in the display buffer to get to the next pixel.
*
* @param rotatedDisplay Is the display running in portrait mode?
* @param textRotation Rotation to perform.
*
* @return How much to advance to get to the next pixel.
*/
static int nextPixel(bool rotatedDisplay, TextRotation textRotation);
/**
* Find out how much to advance in the display buffer to get to the next line.
*
* @param rotatedDisplay Is the display running in portrait mode?
* @param textRotation Rotation to perform.
*
* @return How much to advance to get to the next line.
*/
static int nextLine(bool rotatedDisplay, TextRotation textRotation);
virtual void drawGlyph(uint16_t* wbuf16, Rect widgetArea, int16_t x, int16_t y, uint16_t offsetX, uint16_t offsetY, const Rect& invalidatedArea, const GlyphNode* glyph, const uint8_t* glyphData, uint8_t byteAlignRow, colortype color, uint8_t bitsPerPixel, uint8_t alpha, TextRotation rotation);
/**
* Blit a 2D source-array to the framebuffer performing alpha-blending per pixel as
* specified if ARGB8888 is not supported by the DMA a software blend is performed.
*
* @param sourceData The source-array pointer (points to the beginning of the data). The
* sourceData must be stored as 32- bits ARGB8888 values.
* @param source The location and dimensions of the source.
* @param blitRect A rectangle describing what region is to be drawn.
* @param alpha The alpha value to use for blending applied to the whole image (255 =
* solid, no blending)
*/
static void blitCopyARGB8888(const uint32_t* sourceData, const Rect& source, const Rect& blitRect, uint8_t alpha);
/**
* Blit a 2D source-array to the framebuffer performing alpha-blending per pixel as
* specified Performs always a software blend.
*
* @param sourceData16 The source-array pointer (points to the beginning of the data). The
* sourceData must be stored as 8-bits ARGB2222 values.
* @param source The location and dimensions of the source.
* @param blitRect A rectangle describing what region is to be drawn.
* @param alpha The alpha value to use for blending applied to the whole image (255 =
* solid, no blending)
*/
static void blitCopyAlphaPerPixel(const uint16_t* sourceData16, const Rect& source, const Rect& blitRect, uint8_t alpha);
private:
DrawTextureMapScanLineBase* textureMapper_ARGB2222_NonOpaque_NearestNeighbor_GA;
DrawTextureMapScanLineBase* textureMapper_ARGB2222_Opaque_NearestNeighbor_GA;
DrawTextureMapScanLineBase* textureMapper_ARGB2222_NonOpaque_BilinearInterpolation_GA;
DrawTextureMapScanLineBase* textureMapper_ARGB2222_Opaque_BilinearInterpolation_GA;
DrawTextureMapScanLineBase* textureMapper_ARGB8888_NonOpaque_NearestNeighbor_GA;
DrawTextureMapScanLineBase* textureMapper_ARGB8888_NonOpaque_BilinearInterpolation_GA;
DrawTextureMapScanLineBase* textureMapper_A4_NearestNeighbor_GA;
DrawTextureMapScanLineBase* textureMapper_A4_BilinearInterpolation_GA;
FORCE_INLINE_FUNCTION static uint8_t bilinearInterpolate8(uint8_t c00, uint8_t c10, uint8_t x)
{
assert(x < 16);
const uint16_t xy10 = 16 * x;
const uint16_t xy00 = 256 - xy10;
return (c00 * xy00 + c10 * xy10) >> 8;
}
FORCE_INLINE_FUNCTION static uint8_t bilinearInterpolate8(uint8_t c00, uint8_t c10, uint8_t c01, uint8_t c11, uint8_t x, uint8_t y)
{
assert(x < 16 && y < 16);
const uint16_t xy11 = x * y;
const uint16_t xy10 = 16 * x - xy11;
const uint16_t xy01 = 16 * y - xy11;
const uint16_t xy00 = 256 - (xy11 + xy10 + xy01);
return (c00 * xy00 + c10 * xy10 + c01 * xy01 + c11 * xy11) >> 8;
}
FORCE_INLINE_FUNCTION uint32_t convertARGB2222toARGB8888(colortype col) const
{
return (((col & 0xC0) << 18) | ((col & 0x30) << 12) | ((col & 0x0C) << 6) | (col & 0x03)) * 0x55;
}
FORCE_INLINE_FUNCTION static uint32_t convertARGB2222toRGB888(uint8_t val)
{
return (((val & 0x30) << 12) | ((val & 0x0C) << 6) | (val & 0x03)) * 0x55;
}
FORCE_INLINE_FUNCTION static uint8_t convertRGB888toXRGB2222(uint32_t val)
{
val &= 0xC0C0C0;
return (val >> 6) | (val >> 12) | (val >> 18);
}
FORCE_INLINE_FUNCTION static uint32_t bilinearInterpolate888(uint32_t c00, uint32_t c10, uint32_t c01, uint32_t c11, uint8_t x, uint8_t y)
{
assert(x < 16 && y < 16);
const uint16_t xy11 = x * y;
const uint16_t xy10 = 16 * x - xy11;
const uint16_t xy01 = 16 * y - xy11;
const uint16_t xy00 = 256 - (xy11 + xy10 + xy01);
return ((((c00 & 0xFF00FF) * xy00 + (c10 & 0xFF00FF) * xy10 + (c01 & 0xFF00FF) * xy01 + (c11 & 0xFF00FF) * xy11) >> 8) & 0xFF00FF) |
((((c00 & 0x00FF00) * xy00 + (c10 & 0x00FF00) * xy10 + (c01 & 0x00FF00) * xy01 + (c11 & 0x00FF00) * xy11) >> 8) & 0x00FF00);
}
FORCE_INLINE_FUNCTION static uint32_t div255_888(uint32_t val, uint8_t factor)
{
return div255rb((val & 0xFF00FF) * factor) | div255g((val & 0x00FF00) * factor);
}
FORCE_INLINE_FUNCTION static uint32_t div255_888_FFcheck(uint32_t val, uint8_t factor)
{
return factor < 0xFF ? div255_888(val, factor) : val;
}
FORCE_INLINE_FUNCTION static uint8_t alphaBlend(const uint8_t r, const uint8_t g, const uint8_t b, const uint8_t alpha, const uint8_t fbr, const uint8_t fbg, const uint8_t fbb, const uint8_t ialpha)
{
return getNativeColorFromRGB(div255(r * alpha + fbr * ialpha), div255(g * alpha + fbg * ialpha), div255(b * alpha + fbb * ialpha));
}
class DrawTextureMapScanLineBase8 : public DrawTextureMapScanLineBase
{
protected:
FORCE_INLINE_FUNCTION bool overrunCheckNearestNeighbor(uint8_t*& destBits, int& pixelsToDraw, fixed16_16& U, fixed16_16& V, fixed16_16 deltaU, fixed16_16 deltaV, const int16_t maxWidth, const int16_t maxHeight) const;
FORCE_INLINE_FUNCTION bool overrunCheckBilinearInterpolation(uint8_t*& destBits, int& pixelsToDraw, fixed16_16& U, fixed16_16& V, fixed16_16 deltaU, fixed16_16 deltaV, const int16_t maxWidth, const int16_t maxHeight) const;
};
class TextureMapper_ARGB2222_NonOpaque_NearestNeighbor_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t alpha) const;
};
class TextureMapper_ARGB2222_Opaque_NearestNeighbor_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t alpha) const;
};
class TextureMapper_ARGB2222_NonOpaque_BilinearInterpolation_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
void writePixelOnEdge(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int16_t bitmapHeight, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
};
class TextureMapper_ARGB2222_Opaque_BilinearInterpolation_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
void writePixelOnEdge(uint8_t* const destBits, const uint8_t* const textureBits, const int16_t bitmapWidth, const int16_t bitmapHeight, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
};
class TextureMapper_ARGB8888_NonOpaque_NearestNeighbor_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint32_t* const textureBits32, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t alpha) const;
};
class TextureMapper_ARGB8888_NonOpaque_BilinearInterpolation_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint32_t* const textureBits32, const int16_t bitmapWidth, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
void writePixelOnEdge(uint8_t* const destBits, const uint32_t* const textureBits32, const int16_t bitmapWidth, const int16_t bitmapHeight, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
};
class TextureMapper_A4_NearestNeighbor_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint8_t a4, const uint8_t alpha) const;
};
class TextureMapper_A4_BilinearInterpolation_GA : public DrawTextureMapScanLineBase8
{
public:
virtual void drawTextureMapScanLineSubdivisions(int subdivisions, const int widthModLength, int pixelsToDraw, const int affineLength, float oneOverZRight, float UOverZRight, float VOverZRight, fixed16_16 U, fixed16_16 V, fixed16_16 deltaU, fixed16_16 deltaV, float ULeft, float VLeft, float URight, float VRight, float ZRight, const DrawingSurface& dest, const int destX, const int destY, const TextureSurface& texture, uint8_t alpha, const float dOneOverZdXAff, const float dUOverZdXAff, const float dVOverZdXAff);
private:
FORCE_INLINE_FUNCTION void writePixel(uint8_t* const destBits, const uint16_t* const textureBits, const int16_t bitmapStride, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
void writePixelOnEdge(uint8_t* const destBits, const uint16_t* const textureBits, const int16_t bitmapStride, const int16_t bitmapWidth, const int16_t bitmapHeight, const int UInt, const int VInt, const uint8_t UFrac, const uint8_t VFrac, const uint8_t alpha) const;
};
};
} // namespace touchgfx
#endif // TOUCHGFX_LCD8BPP_ARGB2222_HPP