/* * Copyright 2020-2024 MicroEJ Corp. All rights reserved. * This library is provided in source code for use, modification and test, subject to license terms. * Any modification of the source code will break MicroEJ Corp. warranties on the whole library. */ #ifndef _LLDW_PAINTER_IMPL #define _LLDW_PAINTER_IMPL #ifdef __cplusplus extern "C" { #endif /* * @brief Provides native functions of ej.drawing library to perform some * drawings. * * This header file is an extension of LLUI_PAINTER_impl.h and respects the same rules. */ // -------------------------------------------------------------------------------- // Includes // -------------------------------------------------------------------------------- #include // -------------------------------------------------------------------------------- // Macros and Defines // -------------------------------------------------------------------------------- /** * Drawing library's native functionss */ #define LLDW_PAINTER_IMPL_drawThickFadedPoint Java_ej_drawing_DrawingPainterNatives_drawThickFadedPoint #define LLDW_PAINTER_IMPL_drawThickFadedLine Java_ej_drawing_DrawingPainterNatives_drawThickFadedLine #define LLDW_PAINTER_IMPL_drawThickFadedCircle Java_ej_drawing_DrawingPainterNatives_drawThickFadedCircle #define LLDW_PAINTER_IMPL_drawThickFadedCircleArc Java_ej_drawing_DrawingPainterNatives_drawThickFadedCircleArc #define LLDW_PAINTER_IMPL_drawThickFadedEllipse Java_ej_drawing_DrawingPainterNatives_drawThickFadedEllipse #define LLDW_PAINTER_IMPL_drawThickLine Java_ej_drawing_DrawingPainterNatives_drawThickLine #define LLDW_PAINTER_IMPL_drawThickCircle Java_ej_drawing_DrawingPainterNatives_drawThickCircle #define LLDW_PAINTER_IMPL_drawThickEllipse Java_ej_drawing_DrawingPainterNatives_drawThickEllipse #define LLDW_PAINTER_IMPL_drawThickCircleArc Java_ej_drawing_DrawingPainterNatives_drawThickCircleArc #define LLDW_PAINTER_IMPL_drawFlippedImage Java_ej_drawing_DrawingPainterNatives_drawFlippedImage #define LLDW_PAINTER_IMPL_drawRotatedImageNearestNeighbor \ Java_ej_drawing_DrawingPainterNatives_drawRotatedImageNearestNeighbor #define LLDW_PAINTER_IMPL_drawRotatedImageBilinear Java_ej_drawing_DrawingPainterNatives_drawRotatedImageBilinear #define LLDW_PAINTER_IMPL_drawScaledImageNearestNeighbor \ Java_ej_drawing_DrawingPainterNatives_drawScaledImageNearestNeighbor #define LLDW_PAINTER_IMPL_drawScaledImageBilinear Java_ej_drawing_DrawingPainterNatives_drawScaledImageBilinear #define LLDW_PAINTER_IMPL_drawScaledStringBilinear Java_ej_drawing_DrawingPainterNatives_drawScaledStringBilinear #define LLDW_PAINTER_IMPL_drawScaledRenderableStringBilinear \ Java_ej_drawing_DrawingPainterNatives_drawScaledRenderableStringBilinear #define LLDW_PAINTER_IMPL_drawCharWithRotationBilinear \ Java_ej_drawing_DrawingPainterNatives_drawCharWithRotationBilinear #define LLDW_PAINTER_IMPL_drawCharWithRotationNearestNeighbor \ Java_ej_drawing_DrawingPainterNatives_drawCharWithRotationNearestNeighbor // -------------------------------------------------------------------------------- // Typedefs and Structures // -------------------------------------------------------------------------------- /* * @brief Defines the start and end caps to draw when rendering an anti-aliased * drawing. */ typedef enum { /* * @brief No specific cap is drawn. */ DRAWING_ENDOFLINE_NONE = 0, /* * @brief Cap is represented by a semi circle. */ DRAWING_ENDOFLINE_ROUNDED = 1, /* * @brief Cap is perpendicular to the line. */ DRAWING_ENDOFLINE_PERPENDICULAR = 2, } DRAWING_Cap; /* * @brief Defines the transformation to apply when drawing an image with flip. */ typedef enum { /* * @brief Defines the flip mode "none": no flip must be performed. * * The image * * A B * C D * E F * * is drawn: * * A B * C D * E F */ DRAWING_FLIP_NONE = 0, /* * @brief Defines the flip mode 90°: image must be rotated to 90° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * B D F * A C E */ DRAWING_FLIP_90 = 7, /* * @brief Defines the flip mode 180°: image must be rotated to 180° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * F E * D C * B A */ DRAWING_FLIP_180 = 4, /* * @brief Defines the flip mode 270°: image must be rotated to 270° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * E C A * F D B */ DRAWING_FLIP_270 = 2, /* * @brief Defines the flip mode mirror + "none": only a vertical mirror must * be applied. * * The image * * A B * C D * E F * * is drawn: * * B A * D C * F E */ DRAWING_FLIP_MIRROR = 3, /* * @brief Defines the flip mode mirror + 90°: a vertical mirror must be applied * and then the image must be rotated to 90° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * A C E * B D F * and then mirrored */ DRAWING_FLIP_MIRROR_90 = 1, /* * @brief Defines the flip mode mirror + 180°: a vertical mirror must be applied * and then the image must be rotated to 180° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * E F * C D * A B */ DRAWING_FLIP_MIRROR_180 = 6, /* * @brief Defines the flip mode mirror + 270°: a vertical mirror must be applied * and then the image must be rotated to 270° anticlockwise. * * The image * * A B * C D * E F * * is drawn: * * F D B * E C A */ DRAWING_FLIP_MIRROR_270 = 5, } DRAWING_Flip; // -------------------------------------------------------------------------------- // Functions that must be implemented // -------------------------------------------------------------------------------- /* * @brief Draws a thick point with fade at given position. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the point X coordinate. * @param[in] y the point Y coordinate. * @param[in] thickness the point thickness. * @param[in] fade the fade to apply. */ void LLDW_PAINTER_IMPL_drawThickFadedPoint(MICROUI_GraphicsContext *gc, jint x, jint y, jint thickness, jint fade); /* * @brief Draws a thick line with fade between given points. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] startX the x coordinate of the start of the line * @param[in] startY the y coordinate of the start of the line * @param[in] endX the x coordinate of the end of the line * @param[in] endY the y coordinate of the end of the line * @param[in] thickness the line thickness. * @param[in] fade the fade to apply. * @param[in] startCap cap representation of start of shape * @param[in] endCap cap representation of end of shape */ void LLDW_PAINTER_IMPL_drawThickFadedLine(MICROUI_GraphicsContext *gc, jint startX, jint startY, jint endX, jint endY, jint thickness, jint fade, DRAWING_Cap startCap, DRAWING_Cap endCap); /* * @brief Draws a thick circle with fade covering the square specified by its diameter. * * If diameter is negative or zero, nothing is drawn. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the square where the circle is drawn * @param[in] y the y coordinate of the upper-left corner of the square where the circle is drawn * @param[in] diameter the diameter of the circle to draw * @param[in] thickness the circle thickness. * @param[in] fade the fade to apply. */ void LLDW_PAINTER_IMPL_drawThickFadedCircle(MICROUI_GraphicsContext *gc, jint x, jint y, jint diameter, jint thickness, jint fade); /* * @brief Draws a thick circle with fade arc covering the specified square. * * The arc is drawn from startAngle up to arcAngle degrees. The center of the arc * is defined as the center of the square whose origin is at (x,y) (upper-left * corner) and whose dimension is given by diameter. * * Angles are interpreted such that 0 degrees is at the 3 o'clock position. A positive * value indicates a counter-clockwise rotation while a negative value indicates * a clockwise rotation. * * If diameter is negative or zero, nothing is drawn. * * The angles are given relative to the square. For instance an angle of 45 degrees * is always defined by the line from the center of the square to the upper right * corner of the square. Thus for a non squared square angles are skewed along * either height or width. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the square where the arc is drawn * @param[in] y the y coordinate of the upper-left corner of the square where the arc is drawn * @param[in] diameter the diameter of the circle to draw * @param[in] startAngle the beginning angle of the arc to draw * @param[in] arcAngle the angular extent of the arc from startAngle * @param[in] thickness the arc thickness. * @param[in] fade the fade to apply. * @param[in] start cap representation of start of shape * @param[in] end cap representation of end of shape */ void LLDW_PAINTER_IMPL_drawThickFadedCircleArc(MICROUI_GraphicsContext *gc, jint x, jint y, jint diameter, jfloat startAngle, jfloat arcAngle, jint thickness, jint fade, DRAWING_Cap start, DRAWING_Cap end); /* * @brief Draws a thick ellipse with fade covering the specified rectangle. * * The center of the ellipse is defined as the center of the rectangle whose origin * is at (x,y) (upper-left corner) and whose dimension is given by width and height. * * If either width or height is negative or zero, nothing is drawn. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the rectangle where the ellipse is drawn * @param[in] y the y coordinate of the upper-left corner of the rectangle where the ellipse is drawn * @param[in] width the width of the ellipse to draw * @param[in] height the height of the ellipse to draw * @param[in] thickness the ellipse thickness. * @param[in] fade the fade to apply. */ void LLDW_PAINTER_IMPL_drawThickFadedEllipse(MICROUI_GraphicsContext *gc, jint x, jint y, jint width, jint height, jint thickness, jint fade); /* * @brief Draws a thick line between given points. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] startX the x coordinate of the start of the line * @param[in] startY the y coordinate of the start of the line * @param[in] endX the x coordinate of the end of the line * @param[in] endY the y coordinate of the end of the line * @param[in] thickness the line thickness. */ void LLDW_PAINTER_IMPL_drawThickLine(MICROUI_GraphicsContext *gc, jint startX, jint startY, jint endX, jint endY, jint thickness); /* * @brief Draws a thick circle covering the square specified by its diameter. * * If diameter is negative or zero, nothing is drawn. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the square where the circle is drawn * @param[in] y the y coordinate of the upper-left corner of the square where the circle is drawn * @param[in] diameter the diameter of the circle to draw * @param[in] thickness the circle thickness. */ void LLDW_PAINTER_IMPL_drawThickCircle(MICROUI_GraphicsContext *gc, jint x, jint y, jint diameter, jint thickness); /* * @brief Draws a thick ellipse covering the specified rectangle. * * The center of the ellipse is defined as the center of the rectangle whose origin * is at (x,y) (upper-left corner) and whose dimension is given by width and height. * * If either width or height is negative or zero, nothing is drawn. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the square where the circle is drawn * @param[in] y the y coordinate of the upper-left corner of the square where the circle is drawn * @param[in] width the width of the ellipse to draw * @param[in] height the height of the ellipse to draw * @param[in] thickness the circle thickness. */ void LLDW_PAINTER_IMPL_drawThickEllipse(MICROUI_GraphicsContext *gc, jint x, jint y, jint width, jint height, jint thickness); /* * @brief Draws a thick arc covering the square specified by its diameter. * * The arc is drawn from startAngle up to arcAngle degrees. The center of the arc is * defined as the center of the square whose origin is at (x,y) (upper-left corner) * and whose dimension is given by diameter. * * Angles are interpreted such that 0 degrees is at the 3 o'clock position. A positive * value indicates a counter-clockwise rotation while a negative value indicates a * clockwise rotation. * * If diameter is negative, nothing is drawn. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] x the x coordinate of the upper-left corner of the square where the arc is drawn * @param[in] y the y coordinate of the upper-left corner of the square where the arc is drawn * @param[in] diameter the diameter of the circle to draw * @param[in] startAngle the beginning angle of the arc to draw * @param[in] arcAngle the angular extent of the arc from startAngle * @param[in] thickness the arc thickness. */ void LLDW_PAINTER_IMPL_drawThickCircleArc(MICROUI_GraphicsContext *gc, jint x, jint y, jint diameter, jfloat startAngle, jfloat arcAngle, jint thickness); /* * @brief Draws an image applying a flip (0, 90, 180 or 270 degrees with or without * mirror). * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] img the MicroUI Image to draw. * @param[in] regionX the x coordinate of the upper-left corner of the region to draw. * @param[in] regionY the y coordinate of the upper-left corner of the region to draw. * @param[in] width the width of the region to copy. * @param[in] height the height of the region to copy. * @param[in] x the x coordinate of the top-left point in the destination. * @param[in] y the y coordinate of the top-left point in the destination. * @param[in] transformation the flip to apply. * @param[in] alpha the opacity level to apply to the region. */ void LLDW_PAINTER_IMPL_drawFlippedImage(MICROUI_GraphicsContext *gc, MICROUI_Image *img, jint regionX, jint regionY, jint width, jint height, jint x, jint y, DRAWING_Flip transformation, jint alpha); /* * @brief Draws an image applying a free rotation (0 to 360 degrees). * * The rotation is specified by the center and the angle. The reference point is * the graphical object top-left corner. The rotation point is relative where the * graphical object will be drawn. * * This method uses the nearest neighbor algorithm to render the content. This algorithm * is faster than bilinear algorithm but its rendering is faster. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] img the MicroUI Image to draw. * @param[in] x the x coordinate of the image reference anchor top-left point. * @param[in] y the y coordinate of the image reference anchor top-left point. * @param[in] rotationX the x coordinate of the rotation center. * @param[in] rotationY the y coordinate of the rotation center. * @param[in] angle the rotation angle. * @param[in] alpha the opacity level to apply to the region. */ void LLDW_PAINTER_IMPL_drawRotatedImageNearestNeighbor(MICROUI_GraphicsContext *gc, MICROUI_Image *img, jint x, jint y, jint rotationX, jint rotationY, jfloat angle, jint alpha); /* * @brief Draws an image applying a free rotation (0 to 360 degrees). * * The rotation is specified by the center and the angle. The reference point is * the graphical object top-left corner. The rotation point is relative where the * graphical object will be drawn. * * This method uses the bilinear algorithm to render the content. This algorithm * performs better rendering than nearest neighbor algorithm but it is slower to * apply. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] img the MicroUI Image to draw. * @param[in] x the x coordinate of the image reference anchor top-left point. * @param[in] y the y coordinate of the image reference anchor top-left point. * @param[in] rotationX the x coordinate of the rotation center. * @param[in] rotationY the y coordinate of the rotation center. * @param[in] angle the rotation angle. * @param[in] alpha the opacity level to apply to the region. */ void LLDW_PAINTER_IMPL_drawRotatedImageBilinear(MICROUI_GraphicsContext *gc, MICROUI_Image *img, jint x, jint y, jint rotationX, jint rotationY, jfloat angle, jint alpha); /* * @brief Draws an image applying a scaling. * * This method uses the nearest neighbor algorithm to render the content. This algorithm * is faster than bilinear algorithm but its rendering is faster. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] img the MicroUI Image to draw. * @param[in] x the x coordinate of the image reference anchor top-left point. * @param[in] y the y coordinate of the image reference anchor top-left point. * @param[in] factorX scaling X factor. * @param[in] factorY scaling Y factor. * @param[in] alpha the opacity level to apply to the region. */ void LLDW_PAINTER_IMPL_drawScaledImageNearestNeighbor(MICROUI_GraphicsContext *gc, MICROUI_Image *img, jint x, jint y, jfloat factorX, jfloat factorY, jint alpha); /* * @brief Draws an image applying a scaling. * * This method uses the bilinear algorithm to render the content. This algorithm * performs better rendering than nearest neighbor algorithm but it is slower to * apply. * * @param[in] gc the MicroUI GraphicsContext target. * @param[in] img the MicroUI Image to draw. * @param[in] x the x coordinate of the image reference anchor top-left point. * @param[in] y the y coordinate of the image reference anchor top-left point. * @param[in] factorX scaling X factor. * @param[in] factorY scaling Y factor. * @param[in] alpha the opacity level to apply to the region. */ void LLDW_PAINTER_IMPL_drawScaledImageBilinear(MICROUI_GraphicsContext *gc, MICROUI_Image *img, jint x, jint y, jfloat factorX, jfloat factorY, jint alpha); /** * @brief Draws a string applying a scaling. * * This method uses the bilinear algorithm to render the characters. This algorithm performs better rendering than * nearest neighbor algorithm but it is slower to apply. * * @param[in] gc the targeted MicroUI GraphicsContext * @param[in] chars a string of characters * @param[in] length the number of characters * @param[in] font the MicroUI Font to use * @param[in] x the left coordinate * @param[in] y the top coordinate * @param[in] xRatio the horizontal scaling ratio (1.0f meaning no scaling) * @param[in] yRatio the vertical scaling ratio (1.0f meaning no scaling) */ void LLDW_PAINTER_IMPL_drawScaledStringBilinear(MICROUI_GraphicsContext *gc, jchar *chars, jint length, MICROUI_Font *font, jint x, jint y, jfloat xRatio, jfloat yRatio); /** * @brief Draws a renderable string applying a scaling. * * This method uses the bilinear algorithm to render the characters. This algorithm performs better rendering than * nearest neighbor algorithm but it is slower to apply. * * @param[in] gc the targeted MicroUI GraphicsContext * @param[in] chars a string of characters * @param[in] length the number of characters * @param[in] font the MicroUI Font to use * @param[in] width the renderable string width in pixels * @param[in] renderableString the renderable string * @param[in] x the left coordinate * @param[in] y the top coordinate * @param[in] xRatio the horizontal scaling ratio (1.0f meaning no scaling) * @param[in] yRatio the vertical scaling ratio (1.0f meaning no scaling) */ void LLDW_PAINTER_IMPL_drawScaledRenderableStringBilinear(MICROUI_GraphicsContext *gc, jchar *chars, jint length, MICROUI_Font *font, jint width, MICROUI_RenderableString *renderableString, jint x, jint y, jfloat xRatio, jfloat yRatio); /** * @brief Draws a character applying a rotation and an alpha value. * * This method uses the bilinear algorithm to render the character. This algorithm performs better rendering than * nearest neighbor algorithm but it is slower to apply. * * @param[in] gc the targeted MicroUI GraphicsContext * @param[in] c a character * @param[in] font the MicroUI font to use * @param[in] x the left coordinate * @param[in] y the top coordinate * @param[in] xRotation the horizontal coordinate of the rotation center * @param[in] yRotation the vertical coordinate of the rotation center * @param[in] angle the rotation angle, in degrees * @param[in] alpha the alpha value to use */ void LLDW_PAINTER_IMPL_drawCharWithRotationBilinear(MICROUI_GraphicsContext *gc, jchar c, MICROUI_Font *font, jint x, jint y, jint xRotation, jint yRotation, jfloat angle, jint alpha); /** * @brief Draws a character applying a rotation and an alpha value. * * This method uses the nearest neighbor algorithm to render the character. This algorithm performs faster rendering * than nearest neighbor algorithm but gives a rougher result. * * @param[in] gc the targeted MicroUI GraphicsContext * @param[in] c a character * @param[in] font the MicroUI font to use * @param[in] x the left coordinate * @param[in] y the top coordinate * @param[in] xRotation the horizontal coordinate of the rotation center * @param[in] yRotation the vertical coordinate of the rotation center * @param[in] angle the rotation angle, in degrees * @param[in] alpha the alpha value to use */ void LLDW_PAINTER_IMPL_drawCharWithRotationNearestNeighbor(MICROUI_GraphicsContext *gc, jchar c, MICROUI_Font *font, jint x, jint y, jint xRotation, jint yRotation, jfloat angle, jint alpha); // -------------------------------------------------------------------------------- // EOF // -------------------------------------------------------------------------------- #ifdef __cplusplus } #endif #endif // ifndef _LLDW_PAINTER_IMPL