/****************************************************** * EasyX Library for C++ (Ver:20220901) * https://easyx.cn * * EasyX.h * Provides the latest API. ******************************************************/
以下截取自easyx.h第37行到第366行
// EasyX Window PropertiesEasyX 窗口属性
#define EX_SHOWCONSOLE 1 // Maintain the console window when creating a graphics window创建图形窗口时维护控制台窗口
#define EX_NOCLOSE 2 // Disable the close button禁用关闭按钮
#define EX_NOMINIMIZE 4 // Disable the minimize button禁用最小化按钮
#define EX_DBLCLKS 8 // Support double-click events支持双击事件
// Color constant颜色常数
#define BLACK 0
#define BLUE 0xAA0000
#define GREEN 0x00AA00
#define CYAN 0xAAAA00青
#define RED 0x0000AA
#define MAGENTA 0xAA00AA品红
#define BROWN 0x0055AA棕
#define LIGHTGRAY 0xAAAAAA浅灰
#define DARKGRAY 0x555555深灰色
#define LIGHTBLUE 0xFF5555浅蓝
#define LIGHTGREEN 0x55FF55
#define LIGHTCYAN 0xFFFF55浅青色
#define LIGHTRED 0x5555FF
#define LIGHTMAGENTA 0xFF55FF
#define YELLOW 0x55FFFF
#define WHITE 0xFFFFFF
// Color conversion macro颜色转换宏
#define BGR(color) ( (((color) & 0xFF) << 16) | ((color) & 0xFF00FF00) | (((color) & 0xFF0000) >> 16) )
class IMAGE;
// Line style class线条类
class LINESTYLE
{
public:
LINESTYLE();
LINESTYLE(const LINESTYLE &style);
LINESTYLE& operator = (const LINESTYLE &style);
virtual ~LINESTYLE();
DWORD style;
DWORD thickness;
DWORD *puserstyle;
DWORD userstylecount;
};
// Fill style class填充样式类
class FILLSTYLE
{
public:
FILLSTYLE();
FILLSTYLE(const FILLSTYLE &style);
FILLSTYLE& operator = (const FILLSTYLE &style);
virtual ~FILLSTYLE();
int style; // Fill style填充样式
long hatch; // Hatch pattern填充图案
IMAGE* ppattern; // Fill image填充图像
};
// Image class图像类
class IMAGE
{
public:
int getwidth() const; // Get the width of the image
int getheight() const; // Get the height of the image
private:
int width, height; // Width and height of the image
HBITMAP m_hBmp;
HDC m_hMemDC;
float m_data[6];
COLORREF m_LineColor; // Current line color
COLORREF m_FillColor; // Current fill color
COLORREF m_TextColor; // Current text color
COLORREF m_BkColor; // Current background color
DWORD* m_pBuffer; // Memory buffer of the image图像的内存缓冲区
LINESTYLE m_LineStyle; // Current line style
FILLSTYLE m_FillStyle; // Current fill style
virtual void SetDefault(); // Set the graphics environment as default将图形环境设置为默认
public:
IMAGE(int _width = 0, int _height = 0);
IMAGE(const IMAGE &img);
IMAGE& operator = (const IMAGE &img);
virtual ~IMAGE();
virtual void Resize(int _width, int _height); // Resize image调整图像大小
};
// Graphics window related functions图形窗口相关函数
HWND initgraph(int width, int height, int flag = 0); // Create graphics window
void closegraph(); // Close graphics window
// Graphics environment related functions图形环境相关函数
void cleardevice(); // Clear device清除设备
void setcliprgn(HRGN hrgn); // Set clip region设置剪辑区域
void clearcliprgn(); // Clear clip region
void getlinestyle(LINESTYLE* pstyle); // Get line style
void setlinestyle(const LINESTYLE* pstyle); // Set line style
void setlinestyle(int style, int thickness = 1, const DWORD *puserstyle = NULL, DWORD userstylecount = 0); // Set line style
void getfillstyle(FILLSTYLE* pstyle); // Get fill style获取填充样式
void setfillstyle(const FILLSTYLE* pstyle); // Set fill style
void setfillstyle(int style, long hatch = NULL, IMAGE* ppattern = NULL); // Set fill style
void setfillstyle(BYTE* ppattern8x8); // Set fill style
void setorigin(int x, int y); // Set coordinate origin设置坐标原点
void getaspectratio(float *pxasp, float *pyasp); // Get aspect ratio获取纵横比
void setaspectratio(float xasp, float yasp); // Set aspect ratio设置纵横比
int getrop2(); // Get binary raster operation mode获取二进制光栅操作模式
void setrop2(int mode); // Set binary raster operation mode
int getpolyfillmode(); // Get polygon fill mode获取多边形填充模式
void setpolyfillmode(int mode); // Set polygon fill mode
void graphdefaults(); // Reset the graphics environment as default将图形环境重置为默认值
COLORREF getlinecolor(); // Get line color
void setlinecolor(COLORREF color); // Set line color
COLORREF gettextcolor(); // Get text color
void settextcolor(COLORREF color); // Set text color
COLORREF getfillcolor(); // Get fill color
void setfillcolor(COLORREF color); // Set fill color
COLORREF getbkcolor(); // Get background color
void setbkcolor(COLORREF color); // Set background color
int getbkmode(); // Get background mode
void setbkmode(int mode); // Set background mode
// Color model transformation related functions颜色模型转换相关函数
COLORREF RGBtoGRAY(COLORREF rgb);
void RGBtoHSL(COLORREF rgb, float *H, float *S, float *L);
void RGBtoHSV(COLORREF rgb, float *H, float *S, float *V);
COLORREF HSLtoRGB(float H, float S, float L);
COLORREF HSVtoRGB(float H, float S, float V);
// Drawing related functions绘图相关函数
COLORREF getpixel(int x, int y); // Get pixel color获取像素颜色
void putpixel(int x, int y, COLORREF color); // Set pixel color
void line(int x1, int y1, int x2, int y2); // Draw a line画一条线
void rectangle (int left, int top, int right, int bottom); // Draw a rectangle without filling画一个没有填充的矩形
void fillrectangle (int left, int top, int right, int bottom); // Draw a filled rectangle with a border绘制一个带边框的填充矩形
void solidrectangle(int left, int top, int right, int bottom); // Draw a filled rectangle without a border
void clearrectangle(int left, int top, int right, int bottom); // Clear a rectangular region清除一个矩形区域
void circle (int x, int y, int radius); // Draw a circle without filling画一个没有填充的圆
void fillcircle (int x, int y, int radius); // Draw a filled circle with a border
void solidcircle(int x, int y, int radius); // Draw a filled circle without a border
void clearcircle(int x, int y, int radius); // Clear a circular region
void ellipse (int left, int top, int right, int bottom); // Draw an ellipse without filling
void fillellipse (int left, int top, int right, int bottom); // Draw a filled ellipse with a border绘制带边框的实心椭圆
void solidellipse(int left, int top, int right, int bottom); // Draw a filled ellipse without a border
void clearellipse(int left, int top, int right, int bottom); // Clear an elliptical region
void roundrect (int left, int top, int right, int bottom, int ellipsewidth, int ellipseheight); // Draw a rounded rectangle without filling画一个没有填充的圆角矩形
void fillroundrect (int left, int top, int right, int bottom, int ellipsewidth, int ellipseheight); // Draw a filled rounded rectangle with a border
void solidroundrect(int left, int top, int right, int bottom, int ellipsewidth, int ellipseheight); // Draw a filled rounded rectangle without a border绘制一个没有边框的填充圆角矩形
void clearroundrect(int left, int top, int right, int bottom, int ellipsewidth, int ellipseheight); // Clear a rounded rectangular region
void arc (int left, int top, int right, int bottom, double stangle, double endangle); // Draw an arc画弧线
void pie (int left, int top, int right, int bottom, double stangle, double endangle); // Draw a sector without filling画一个没有填充的扇区
void fillpie (int left, int top, int right, int bottom, double stangle, double endangle); // Draw a filled sector with a border绘制一个带边框的填充扇区
void solidpie(int left, int top, int right, int bottom, double stangle, double endangle); // Draw a filled sector without a border
void clearpie(int left, int top, int right, int bottom, double stangle, double endangle); // Clear a rounded rectangular region
void polyline (const POINT *points, int num); // Draw multiple consecutive lines绘制多条连续的线
void polygon (const POINT *points, int num); // Draw a polygon without filling绘制一个没有填充的多边形
void fillpolygon (const POINT *points, int num); // Draw a filled polygon with a border
void solidpolygon(const POINT *points, int num); // Draw a filled polygon without a border
void clearpolygon(const POINT *points, int num); // Clear a polygon region清除多边形区域
void polybezier(const POINT *points, int num); // Draw three square Bezier curves
void floodfill(int x, int y, COLORREF color, int filltype = FLOODFILLBORDER); // Fill the area填充区域
// Text related functions文字相关函数
void outtextxy(int x, int y, LPCTSTR str); // Output a string at the specified location在指定位置输出字符串
void outtextxy(int x, int y, TCHAR c); // Output a char at the specified location在指定位置输出一个字符
int textwidth(LPCTSTR str); // Get the width of a string获取字符串的宽度
int textwidth(TCHAR c); // Get the width of a char
int textheight(LPCTSTR str); // Get the height of a string
int textheight(TCHAR c); // Get the height of a char
int drawtext(LPCTSTR str, RECT* pRect, UINT uFormat); // Output a string in the specified format within the specified area.在指定区域内输出指定格式的字符串。
int drawtext(TCHAR c, RECT* pRect, UINT uFormat); // Output a char in the specified format within the specified area.
// Set current text style.设置当前文本样式。
// nHeight: The height of the text
// nWidth: The average width of the character. If 0, the scale is adaptive.字符的平均宽度。 如果为 0，则比例是自适应的。
// lpszFace: The font name字体名称
// nEscapement: The writing angle of the string, 0.1 degrees, defaults to 0.字符串的书写角度，0.1度，默认为0。
// nOrientation: The writing angle of each character, 0.1 degrees, defaults to 0.每个字符的书写角度，0.1度，默认为0。
// nWeight: The stroke weight of the character字符的笔划粗细
// bItalic: Specify whether the font is italic指定字体是否为斜体
// bUnderline: Specify whether the font is underlined指定字体是否带下划线
// bStrikeOut: Specify whether the font has a strikeout指定字体是否有删除线
// fbCharSet: Specifies the character set指定字符集
// fbOutPrecision: Specifies the output accuracy of the text指定文本的输出精度
// fbClipPrecision: Specifies the clip accuracy of the text指定文本的剪辑精度
// fbQuality: Specifies the output quality of the text指定文本的输出质量
// fbPitchAndFamily: Specifies a font family that describes a font in a general way指定以一般方式描述字体的字体系列
void settextstyle(int nHeight, int nWidth, LPCTSTR lpszFace);
void settextstyle(int nHeight, int nWidth, LPCTSTR lpszFace, int nEscapement, int nOrientation, int nWeight, bool bItalic, bool bUnderline, bool bStrikeOut);
void settextstyle(int nHeight, int nWidth, LPCTSTR lpszFace, int nEscapement, int nOrientation, int nWeight, bool bItalic, bool bUnderline, bool bStrikeOut, BYTE fbCharSet, BYTE fbOutPrecision, BYTE fbClipPrecision, BYTE fbQuality, BYTE fbPitchAndFamily);
void settextstyle(const LOGFONT *font); // Set current text style
void gettextstyle(LOGFONT *font); // Get current text style
// Image related functions图片相关函数
void loadimage(IMAGE *pDstImg, LPCTSTR pImgFile, int nWidth = 0, int nHeight = 0, bool bResize = false); // Load image from a file (bmp/gif/jpg/png/tif/emf/wmf/ico)从文件加载图像
void loadimage(IMAGE *pDstImg, LPCTSTR pResType, LPCTSTR pResName, int nWidth = 0, int nHeight = 0, bool bResize = false); // Load image from resources (bmp/gif/jpg/png/tif/emf/wmf/ico)从资源加载图像
void saveimage(LPCTSTR pImgFile, IMAGE* pImg = NULL); // Save image to a file (bmp/gif/jpg/png/tif)
void getimage(IMAGE *pDstImg, int srcX, int srcY, int srcWidth, int srcHeight); // Get image from device从设备获取图像
void putimage(int dstX, int dstY, const IMAGE *pSrcImg, DWORD dwRop = SRCCOPY); // Put image to device将图像放入设备
void putimage(int dstX, int dstY, int dstWidth, int dstHeight, const IMAGE *pSrcImg, int srcX, int srcY, DWORD dwRop = SRCCOPY); // Put image to device
void rotateimage(IMAGE *dstimg, IMAGE *srcimg, double radian, COLORREF bkcolor = BLACK, bool autosize = false, bool highquality = true);// Rotate image旋转图像
void Resize(IMAGE* pImg, int width, int height); // Resize the device调整设备大小
DWORD* GetImageBuffer(IMAGE* pImg = NULL); // Get the display buffer of the graphics device获取图形设备的显示缓冲区
IMAGE* GetWorkingImage(); // Get current graphics device
void SetWorkingImage(IMAGE* pImg = NULL); // Set current graphics device
HDC GetImageHDC(IMAGE* pImg = NULL); // Get the graphics device handle获取图形设备句柄
// Other functions其他函数
int getwidth(); // Get the width of current graphics device获取当前图形设备的宽度
int getheight(); // Get the height of current graphics device
void BeginBatchDraw(); // Begin batch drawing mode开始批量绘制模式
void FlushBatchDraw(); // Refreshes the undisplayed drawing刷新未显示的绘图
void FlushBatchDraw(int left, int top, int right, int bottom); // Refreshes the undisplayed drawing
void EndBatchDraw(); // End batch drawing mode and refreshes the undisplayed drawing结束批量绘图模式并刷新未显示的绘图
void EndBatchDraw(int left, int top, int right, int bottom); // End batch drawing mode and refreshes the undisplayed drawing
HWND GetHWnd(); // Get the handle of the graphics window获取图形窗口的句柄
const TCHAR* GetEasyXVer(); // Get version of EasyX library获取 EasyX 库的版本
// Get user input as a dialog box将用户输入作为对话框获取
bool InputBox(LPTSTR pString, int nMaxCount, LPCTSTR pPrompt = NULL, LPCTSTR pTitle = NULL, LPCTSTR pDefault = NULL, int width = 0, int height = 0, bool bOnlyOK = true);
// Message
//
// Category Type Description类别类型说明
//
// EX_MOUSE WM_MOUSEMOVE Mouse moves鼠标移动
// WM_MOUSEWHEEL Mouse wheel is rotated鼠标滚轮旋转
// WM_LBUTTONDOWN Left mouse button is pressed
// WM_LBUTTONUP Left mouse button is released鼠标左键被释放
// WM_LBUTTONDBLCLK Left mouse button is double-clicked双击鼠标左键
// WM_MBUTTONDOWN Middle mouse button is pressed
// WM_MBUTTONUP Middle mouse button is released
// WM_MBUTTONDBLCLK Middle mouse button is double-clicked
// WM_RBUTTONDOWN Right mouse button is pressed
// WM_RBUTTONUP Right mouse button is released
// WM_RBUTTONDBLCLK Right mouse button is double-clicked
//
// EX_KEY WM_KEYDOWN A key is pressed按下一个键
// WM_KEYUP A key is released
//
// EX_CHAR WM_CHAR
//
// EX_WINDOW WM_ACTIVATE The window is activated or deactivated窗口被激活或停用
// WM_MOVE The window has been moved窗口已移动
// WM_SIZE The size of window has changed窗口的大小发生了变化
// Message Category
#define EX_MOUSE 1
#define EX_KEY 2
#define EX_CHAR 4
#define EX_WINDOW 8
// Message Structure消息结构
struct ExMessage
{
USHORT message; // The message identifier消息标识符
union
{
// Data of the mouse message鼠标消息的数据
struct
{
bool ctrl :1; // Indicates whether the CTRL key is pressed指示是否按下了 CTRL 键
bool shift :1; // Indicates whether the SHIFT key is pressed
bool lbutton :1; // Indicates whether the left mouse button is pressed
bool mbutton :1; // Indicates whether the middle mouse button is pressed
bool rbutton :1; // Indicates whether the right mouse button is pressed指示是否按下鼠标右键
short x; // The x-coordinate of the cursor
short y; // The y-coordinate of the cursor光标的y坐标
short wheel; // The distance the wheel is rotated, expressed in multiples or divisions of 120车轮转动的距离，以120的倍数或除数表示
};
// Data of the key message
struct
{
BYTE vkcode; // The virtual-key code of the key按键的虚拟键码
BYTE scancode; // The scan code of the key. The value depends on the OEM按键的扫描码。 该值取决于 OEM
bool extended :1; // Indicates whether the key is an extended key, such as a function key or a key on the numeric keypad. The value is true if the key is an extended key; otherwise, it is false.表示该键是否为扩展键，如功能键或数字键盘上的键。 如果密钥是扩展密钥，则值为真； 否则，它是错误的。
bool prevdown :1; // Indicates whether the key is previously up or down指示键之前是向上还是向下
};
// Data of the char message字符消息的数据
TCHAR ch;
// Data of the window message窗口消息的数据
struct
{
WPARAM wParam;
LPARAM lParam;
};
};
};
// Message Function
ExMessage getmessage(BYTE filter = -1); // Get a message until a message is available for retrieval获取消息，直到消息可用于检索
void getmessage(ExMessage *msg, BYTE filter = -1); // Get a message until a message is available for retrieval
bool peekmessage(ExMessage *msg, BYTE filter = -1, bool removemsg = true); // Get a message if any exist, otherwise return false如果存在则获取消息，否则返回false
void flushmessage(BYTE filter = -1); // Flush the message buffer刷新消息缓冲区