milsko/include/Mw/Draw.h

/*!
 * @file Mw/Draw.h
 * @brief Common drawing API
 */
#ifndef __MW_DRAW_H__
#define __MW_DRAW_H__

#include <Mw/MachDep.h>
#include <Mw/TypeDefs.h>
#include <Mw/LowLevel.h>

#ifdef __cplusplus
extern "C" {
#endif

/*!
 * @brief Parses a color text
 * @param handle Widget
 * @param text Color text
 * @return Color
 */
MWDECL MwLLColor MWAPI MwParseColor(MwWidget handle, const char* text);

/*!
 * @brief Parses a color text
 * @param text Color text
 * @param rgb RGB
 */
MWDECL void MWAPI MwParseColorNoAllocate(const char* text, MwRGB* rgb);

/*!
 * @brief Lighten a color
 * @param handle Widget
 * @param color Color
 * @param r Red
 * @param g Green
 * @param b Blue
 * @return Color
 */
MWDECL MwLLColor MWAPI MwLightenColor(MwWidget handle, MwLLColor color, int r, int g, int b);

/*!
 * @brief Draws a filled rectangle
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 */
MWDECL void MWAPI MwDrawRect(MwWidget handle, MwRect* rect, MwLLColor color);

/*!
 * @brief Draws a filled rectangle that fades to a darker color
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 */
MWDECL void MWAPI MwDrawRectFading(MwWidget handle, MwRect* rect, MwLLColor color);

/*!
 * @brief Draws a frame
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 * @param invert Invert the 3D border color or not
 * @warning `rect` gets changed to the area of rectangle inside
 */
MWDECL void MWAPI MwDrawFrame(MwWidget handle, MwRect* rect, MwLLColor color, int invert);

/*!
 * @brief Does the DrawFrame/DrawRect combo used for drawing widget.
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 * @param invert Invert the 3D border color or not
 * @warning `rect` gets changed to the area of rectangle inside
 */
MWDECL void MWAPI MwDrawWidgetBack(MwWidget handle, MwRect* rect, MwLLColor color, int invert, int border);

/*!
 * @brief Draws a triangle
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 * @param invert Invert the 3D border color or not
 */
MWDECL void MWAPI MwDrawTriangle(MwWidget handle, MwRect* rect, MwLLColor color, int invert, int direction);

/*!
 * @brief Draws a frame with specified border width
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 * @param invert Invert the 3D border color or not
 * @param border Border width
 * @param diff Difference (set this to 0 if you don't know what this does)
 * @param same Same as dark color
 * @warning `rect` gets changed to the area of rectangle inside
 */
MWDECL void MWAPI MwDrawFrameEx(MwWidget handle, MwRect* rect, MwLLColor color, int invert, int border, int diff, int same);

/*!
 * @brief Creates a pixmap from image
 * @param handle Widget
 * @param path Path
 * @return Pixmap
 */
MWDECL MwLLPixmap MWAPI MwLoadImage(MwWidget handle, const char* path);

/*!
 * @brief Get color components
 * @param color Color
 * @param red Pointer to red color
 * @param green Pointer to green color
 * @param blue Pointer to blue color
 */
MWDECL void MWAPI MwColorGet(MwLLColor color, int* red, int* green, int* blue);

/*!
 * @brief Creates a pixmap from raw data
 * @param handle Widget
 * @param rgb RGBA data
 * @param width Width
 * @param height Height
 * @return Pixmap
 */
MWDECL MwLLPixmap MWAPI MwLoadRaw(MwWidget handle, unsigned char* rgb, int width, int height);

/*!
 * @brief Updates a pixmap using raw data
 * @param pixmap Pixmap to update
 * @param rgb RGBA data
 */
MWDECL void MWAPI MwPixmapReloadRaw(MwLLPixmap pixmap, unsigned char* rgb);

/*!
 * @brief Gets the raw data of pixmap
 * @param pixmap Pixmap
 * @return RGBA data
 */
MWDECL unsigned char* MWAPI MwPixmapGetRaw(MwLLPixmap pixmap);

/*!
 * @brief Gets the size of pixmap
 * @param pixmap Pixmap
 * @param rect Size
 */
MWDECL void MWAPI MwPixmapGetSize(MwLLPixmap pixmap, MwRect* rect);

/*!
 * @brief Creates a pixmap from XPM data
 * @param handle Widget
 * @param data Data
 * @return Pixmap
 */
MWDECL MwLLPixmap MWAPI MwLoadXPM(MwWidget handle, char** data);

/*!
 * @brief Creates a pixmap from icon data
 * @param handle Widget
 * @param data Data
 * @return Pixmap
 */
MWDECL MwLLPixmap MWAPI MwLoadIcon(MwWidget handle, MwU32* data);

/*!
 * @brief Draws a diamond
 * @param handle Widget
 * @param rect Rectangle area
 * @param color Color
 * @param invert Invert the 3D border color or not
 */
MWDECL void MWAPI MwDrawDiamond(MwWidget handle, MwRect* rect, MwLLColor color, int invert);

/* text.c */

/*!
 * @brief Draws a text
 * @param handle Widget
 * @param ttf TTF, NULLable
 * @param point Center point of the text
 * @param text Text
 * @param align Align
 * @param color Color
 */
MWDECL void MWAPI MwDrawText(MwWidget handle, MwFLFont ttf, MwPoint* point, const char* text, int align, MwLLColor color);

/*!
 * @brief Calculates a text width
 * @param handle Widget
 * @param text Text
 * @param font Font, NULLable
 * @return Text width
 */
MWDECL int MWAPI MwTextWidth(MwWidget handle, MwFLFont font, const char* text);

/*!
 * @brief Calculates a text height
 * @param handle Widget
 * @param text Text
 * @param font Font, NULLable
 * @return Text height
 */
MWDECL int MWAPI MwTextHeight(MwWidget handle, MwFLFont font, const char* text);

/* color.c */

/*!
 * @brief Parses a color name
 * @param handle Widget
 * @param color Color name
 * @return Color
 */
MWDECL MwLLColor MWAPI MwParseColorName(MwWidget handle, const char* color);

/*!
 * @brief Parses a color name
 * @param color Color name
 * @param rgb RGB
 */
MWDECL void MWAPI MwParseColorNameNoAllocate(const char* color, MwRGB* rgb);

#ifdef __cplusplus
}
#endif

#endif