MiniGUI API Reference (MiniGUI-Threads)
v5.0.6
A mature and proven cross-platform GUI system for embedded and smart IoT devices
|
Example: More...
Data Structures | |
struct | _STRETCH_EXTRA_INFO |
Typedefs | |
typedef struct _STRETCH_EXTRA_INFO | STRETCH_EXTRA_INFO |
Functions | |
MG_EXPORT BOOL GUIAPI | GetBitmapFromDC (HDC hdc, int x, int y, int w, int h, BITMAP *bmp) |
Get image box on a DC and saves it into a BITMAP object. More... | |
MG_EXPORT BOOL GUIAPI | FillBoxWithBitmap (HDC hdc, int x, int y, int w, int h, const BITMAP *bmp) |
Fills a box with a BITMAP object. More... | |
MG_EXPORT BOOL GUIAPI | FillBoxWithBitmapPart (HDC hdc, int x, int y, int w, int h, int bw, int bh, const BITMAP *bmp, int xo, int yo) |
Fills a box with a part of a bitmap oject. More... | |
MG_EXPORT BOOL GUIAPI | FillBitmapPartInBox (HDC hdc, int box_x, int box_y, int box_w, int box_h, const BITMAP *pbmp, int bmp_x, int bmp_y, int bmp_w, int bmp_h) |
Fills a part of bitmap into a box, and the parts bitmap will be scaled if needed. More... | |
MG_EXPORT void GUIAPI | BitBlt (HDC hsdc, int sx, int sy, int sw, int sh, HDC hddc, int dx, int dy, DWORD dwRop) |
Performs a bit-block transfer from a device context into another device context. More... | |
static void GUIAPI | StretchBlt (HDC hsdc, int sx, int sy, int sw, int sh, HDC hddc, int dx, int dy, int dw, int dh, DWORD dwRop) |
Copies a bitmap from a source rectangle into a destination rectangle, streches the bitmap if necessary. More... | |
MG_EXPORT BOOL GUIAPI | ScaleBitmapEx (BITMAP *dst, const BITMAP *src, HDC ref_dc) |
Scales a BITMAP object into another BITMAP object by specify algorithm. More... | |
MG_EXPORT gal_pixel GUIAPI | GetPixelInBitmapEx (const BITMAP *bmp, int x, int y, Uint8 *alpha) |
Returns the pixel value in a BITMAP object. More... | |
static gal_pixel GUIAPI | GetPixelInBitmap (const BITMAP *bmp, int x, int y) |
Returns the pixel value in a BITMAP object. More... | |
static BOOL GUIAPI | SetPixelInBitmap (const BITMAP *bmp, int x, int y, gal_pixel pixel) |
Set pixel value in a BITMAP object. More... | |
MG_EXPORT BOOL GUIAPI | SaveScreenRectContent (const RECT *rcWin, const char *filename) |
Saves content of a rectangle in the screen to a file. More... | |
MG_EXPORT BOOL GUIAPI | SaveMainWindowContent (HWND hWnd, const char *filename) |
Saves content of a main window to a file. More... | |
Example:
typedef struct _STRETCH_EXTRA_INFO STRETCH_EXTRA_INFO |
The stretch extra information for StretchBltEx.
enum ColorBlendMethod |
The color blend mothed.
See Compositing and Blending Level 1 Note: we define the same values with Pixman.
enum ColorLogicalOp |
enum ScalingFilter |
The scaling filter for StretchBlt.
void GUIAPI BitBlt | ( | HDC | hsdc, |
int | sx, | ||
int | sy, | ||
int | sw, | ||
int | sh, | ||
HDC | hddc, | ||
int | dx, | ||
int | dy, | ||
DWORD | dwRop | ||
) |
Performs a bit-block transfer from a device context into another device context.
This function performs a bit-block transfer of the color data cooresponding to a rectangle of pixels from the specified source device context hsdc into a destination device context hddc. (sx,sy,sw,sh) specifies the rectangle in the source DC, and (dx,dy) specifies the position of the rectangle in the destination DC. Note that the size of the two rectangles are identical.
Note that all coordinates should be in the device space.
hsdc | The source device context. |
sx | The x coordinate of the upper-left corner of the rectangle in the source DC. |
sy | The y coordinate of the upper-left corner of the rectangle in the source DC. |
sw | The width of the source rectangle. |
sh | The height of the source rectangle. |
hddc | The destination device context hddc. |
dx | The x coordinate of the upper-left corner of the rectangle in the destination DC. |
dy | The y coordinate of the upper-left corner of the rectangle in the destination DC. |
dwRop | The color blending method, see ColorBlendMethod. This argument is only valid when Pixman is used. |
BOOL FillBitmapPartInBox | ( | HDC | hdc, |
int | box_x, | ||
int | box_y, | ||
int | box_w, | ||
int | box_h, | ||
const BITMAP * | pbmp, | ||
int | bmp_x, | ||
int | bmp_y, | ||
int | bmp_w, | ||
int | bmp_h | ||
) |
Fills a part of bitmap into a box, and the parts bitmap will be scaled if needed.
This function gives an intuitionistic way to use function FillBoxWidthBitmapPart.
hdc | The target DC to show bitmap |
box_x | The left of target box |
box_y | The top of target box |
box_w | The width of target box |
box_h | The height of target box |
pbmp | The bitmap which will be showed in the hdc |
bmp_x | The visible part's left of bitmap |
bmp_y | The visible part's top of bitmap |
bmp_w | The visible part's width of bitmap |
bmp_h | The visible part's height of bitmap |
Fills a box with a BITMAP object.
This function fills a box with a BITMAP object pointed to by bmp. (x,y) is the upper-left corner of the box, and w, h are the width and the height of the box respectively.
This function will scale the bitmap when necessary; that is, when the width or the height of the box is not equal to the with or the height of the BITMAP object.
hdc | The device context. |
x | The x coordinate of the upper-left corner of the box. |
y | The y coordinate of the upper-left corner of the box. |
w | The width of the box. Can be zero, means the width or the height will be equal to the width or the height of the BITMAP object. |
h | The height of the box. Can be zero, means the width or the height will be equal to the width or the height of the BITMAP object. |
bmp | The pointer to the BITMAP object. |
BOOL GUIAPI FillBoxWithBitmapPart | ( | HDC | hdc, |
int | x, | ||
int | y, | ||
int | w, | ||
int | h, | ||
int | bw, | ||
int | bh, | ||
const BITMAP * | bmp, | ||
int | xo, | ||
int | yo | ||
) |
Fills a box with a part of a bitmap oject.
This function fills a box with a part of a bitmap object pointed to by bmp. (x,y) is the upper-left corner of the box, and w, h are the width and the height of the box respectively. (xo, yo) is the start position of the part box in the bitmap relative to upper-left corner of the bitmap, and bw, bh are the width and the height of the full bitmap expected.
If bw or bh is less than or equal to zero, this function will use the original width and height of the bitmap, else it will scale the BITMAP object when necessary; that is, when bw or bh is not equal to the width or the height of the BITMAP object.
hdc | The device context. |
x | The x coordinate of the upper-left corner of the box. |
y | The y coordinate of the upper-left corner of the box. |
w | The width of the box. |
h | The height of the box. |
bw | The width of the full bitmap expected. Can be zero, means the width or the height will be equal to the width or the height of the BITMAP object. |
bh | The height of the full bitmap expected. Can be zero, means the width or the height will be equal to the width or the height of the BITMAP object. |
xo | xo,yo: The start position of the part box in the bitmap relative to upper-left corner of the BITMAP object. |
yo | xo,yo: The start position of the part box in the bitmap relative to upper-left corner of the BITMAP object. |
bmp | The pointer to the BITMAP object. |
Get image box on a DC and saves it into a BITMAP object.
This function gets image box on the specified device context hdc, and saves the image bits into the BITMAP object pointed to by bmp. The image box begins at (x,y), and is w wide and h high. You must make sure that bmp->bits is big enough to store the image.
hdc | The device context. |
x | The x coordinate in pixels of upper-left corner of the image box. |
y | The y coordinate in pixels of upper-left corner of the image box. |
w | The width of the image box. |
h | The height of the image box. |
bmp | The pointer to the BITMAP object. |
Returns the pixel value in a BITMAP object.
This function returns the pixel value at the position (x,y) in the BITMAP object bmp.
bmp | The BITMAP object. |
x | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
y | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
Returns the pixel value in a BITMAP object.
This function returns the pixel value and alpha at the position (x,y) in the BITMAP object bmp.
bmp | The BITMAP object. |
x | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
y | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
alpha | The point to alpha of position (x, y). |
Saves content of a main window to a file.
This function saves the content of the main window hWnd to the image file filename. MiniGUI uses the extension name of the file to determine the format of the image file.
hWnd | Handle to the main window. |
filename | The name of the image file. |
Saves content of a rectangle in the screen to a file.
This function saves the content of the rect rc to the image file filename. MiniGUI uses the extension name of the file to determine the format of the image file.
rc | The RECT object defined the rectangle in the screen. |
filename | The name of the image file. |
Scales a BITMAP object into another BITMAP object by specify algorithm.
This function scales a BITMAP object src into another BITMAO object dst by specify algorithm. The source rectangle and the destination rectangle both are defined in the BITMAP objects.
dst | The destination BITMAP object. |
src | The srouce BITMAP object. |
ref_dc | The device context of Bitmap's relative device dc. |
|
inlinestatic |
Set pixel value in a BITMAP object.
This function sets the pixel value at the position (x,y) in the BITMAP object bmp.
bmp | The BITMAP object. |
x | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
y | x,y: The position of the pixel in the bitmap relative to the upper-left corner of the bitmap. |
pixel | The pixel value. |
|
inlinestatic |
Copies a bitmap from a source rectangle into a destination rectangle, streches the bitmap if necessary.
This function copies a bitmap from a source rectangle into a destination rectangle, streching or compressing the bitmap to fit the dimension of the destination rectangle, if necessary. This function is similar with
hsdc | The source device context. |
sx | The x coordinate of the upper-left corner of the rectangle in the source DC. |
sy | The y coordinate of the upper-left corner of the rectangle in the source DC. |
sw | The width of the source rectangle. |
sh | The height of the source rectangle. |
hddc | The destination device context hddc. |
dx | The x coordinate of the upper-left corner of the rectangle in the destination DC. |
dy | The y coordinate of the upper-left corner of the rectangle in the destination DC. |
dw | The width of the destination rectangle. |
dh | The height of the destination rectangle. |
dwRop | The color blending method, see ColorBlendMethod. This argument is only valid when Pixman is used. |