From 60717596e8c88523ad76e84b09c14ed27682998a Mon Sep 17 00:00:00 2001 From: yixy-only Date: Thu, 4 Jul 2024 19:41:19 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E8=87=B3=2024.04?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- man/about/index.htm | 98 +++++++++++- man/api/col/alphablend.htm | 55 +++++++ man/api/col/alphablend_f.htm | 54 +++++++ man/api/col/alphablend_premultiplied.htm | 55 +++++++ man/api/col/colorblend.htm | 55 +++++++ man/api/col/colorblend_f.htm | 56 +++++++ man/api/col/getlinecolor.htm | 35 +++++ man/api/col/gettextcolor.htm | 35 +++++ man/api/col/index.htm | 66 ++++---- man/api/col/intro.htm | 20 +-- man/api/col/setlinecolor.htm | 38 +++++ man/api/col/settextcolor.htm | 38 +++++ man/api/console/getch_console.htm | 27 ++++ man/api/console/index.htm | 11 +- man/api/draw/arc.htm | 2 +- man/api/draw/circle.htm | 2 +- man/api/draw/drawbezier.htm | 2 +- man/api/draw/drawlines.htm | 2 +- man/api/draw/drawpoly.htm | 2 +- man/api/draw/ege_arc.htm | 2 +- man/api/draw/ege_bezier.htm | 2 +- man/api/draw/ege_drawclosedcurve.htm | 59 +++++++ man/api/draw/ege_drawcurve.htm | 20 ++- man/api/draw/ege_drawimage.htm | 20 +-- man/api/draw/ege_drawpath.htm | 50 ++++++ man/api/draw/ege_drawpoly.htm | 2 +- man/api/draw/ege_ellipse.htm | 2 +- man/api/draw/ege_fillclosedcurve.htm | 58 +++++++ man/api/draw/ege_fillpath.htm | 0 man/api/draw/ege_fillroundrect.htm | 74 +++++++++ man/api/draw/ege_line.htm | 2 +- man/api/draw/ege_roundrect.htm | 74 +++++++++ man/api/draw/ellipse.htm | 2 +- man/api/draw/fillcircle.htm | 2 +- man/api/draw/fillellipse.htm | 2 +- man/api/draw/fillpie.htm | 70 +++++++++ man/api/draw/fillpoly.htm | 2 +- man/api/draw/fillpoly_gradient.htm | 2 +- man/api/draw/getlinecap.htm | 58 +++++++ man/api/draw/getlinejoin.htm | 57 +++++++ man/api/draw/index.htm | 174 +++++++++++++-------- man/api/draw/pie.htm | 71 +++++++++ man/api/draw/putpixel_alphablend.htm | 65 ++++++++ man/api/draw/setfillstyle.htm | 2 +- man/api/draw/setlinecap.htm | 63 ++++++++ man/api/draw/setlinejoin.htm | 58 +++++++ man/api/draw/solidcircle.htm | 56 +++++++ man/api/draw/solidellipse.htm | 58 +++++++ man/api/draw/solidpie.htm | 70 +++++++++ man/api/draw/solidpoly.htm | 45 ++++++ man/api/draw/solidrect.htm | 52 ++++++ man/api/draw/solidroundrect.htm | 58 +++++++ man/api/env/flushwindow.htm | 34 ++++ man/api/env/getcodepage.htm | 38 +++++ man/api/env/getunicodecharmessage.htm | 39 +++++ man/api/env/hidewindow.htm | 34 ++++ man/api/env/index.htm | 16 +- man/api/env/initgraph.htm | 4 +- man/api/env/setcaption.htm | 4 +- man/api/env/setcodepage.htm | 41 +++++ man/api/env/setinitmode.htm | 4 +- man/api/env/setunicodecharmessage.htm | 40 +++++ man/api/env/showwindow.htm | 36 +++++ man/api/env/swappage.htm | 31 ++++ man/api/font/ege_drawtext.htm | 4 +- man/api/font/ege_outtextxy.htm | 76 +++++++++ man/api/font/ege_xyprintf.htm | 52 ++++++ man/api/font/index.htm | 2 +- man/api/font/outtext.htm | 8 +- man/api/font/outtextrect.htm | 8 +- man/api/font/outtextxy.htm | 8 +- man/api/font/rectprintf.htm | 4 +- man/api/font/setfont.htm | 89 ++++++----- man/api/font/settextjustify.htm | 4 +- man/api/font/textheight.htm | 4 +- man/api/font/textwidth.htm | 4 +- man/api/font/xyprintf.htm | 4 +- man/api/img/getimage.htm | 80 +++++----- man/api/img/getimage_pngfile.htm | 4 +- man/api/img/imagefilter_blurring.htm | 14 +- man/api/img/index.htm | 10 +- man/api/img/newimage.htm | 3 +- man/api/img/putimage.htm | 165 +++++++++---------- man/api/img/putimage_alphablend.htm | 44 +++--- man/api/img/putimage_alphafilter.htm | 40 ++--- man/api/img/putimage_alphatransparent.htm | 52 +++--- man/api/img/putimage_rotate.htm | 36 ++--- man/api/img/putimage_rotatetransparent.htm | 90 ++++++----- man/api/img/putimage_rotatezoom.htm | 60 +++---- man/api/img/putimage_transparent.htm | 41 ++--- man/api/img/putimage_withalpha.htm | 73 +++++---- man/api/img/savebmp.htm | 4 +- man/api/img/saveimage.htm | 4 +- man/api/img/savepng.htm | 4 +- man/api/input/key_msg.htm | 4 +- man/api/macro/index.htm | 9 +- man/api/math/index.htm | 2 +- man/api/other/index.htm | 2 +- man/api/other/inputboxgetline.htm | 4 +- man/api/time/ege_sleep.htm | 20 +-- man/index.htm | 2 +- 101 files changed, 2754 insertions(+), 586 deletions(-) create mode 100644 man/api/col/alphablend.htm create mode 100644 man/api/col/alphablend_f.htm create mode 100644 man/api/col/alphablend_premultiplied.htm create mode 100644 man/api/col/colorblend.htm create mode 100644 man/api/col/colorblend_f.htm create mode 100644 man/api/col/getlinecolor.htm create mode 100644 man/api/col/gettextcolor.htm create mode 100644 man/api/col/setlinecolor.htm create mode 100644 man/api/col/settextcolor.htm create mode 100644 man/api/console/getch_console.htm create mode 100644 man/api/draw/ege_drawclosedcurve.htm create mode 100644 man/api/draw/ege_drawpath.htm create mode 100644 man/api/draw/ege_fillclosedcurve.htm create mode 100644 man/api/draw/ege_fillpath.htm create mode 100644 man/api/draw/ege_fillroundrect.htm create mode 100644 man/api/draw/ege_roundrect.htm create mode 100644 man/api/draw/fillpie.htm create mode 100644 man/api/draw/getlinecap.htm create mode 100644 man/api/draw/getlinejoin.htm create mode 100644 man/api/draw/pie.htm create mode 100644 man/api/draw/putpixel_alphablend.htm create mode 100644 man/api/draw/setlinecap.htm create mode 100644 man/api/draw/setlinejoin.htm create mode 100644 man/api/draw/solidcircle.htm create mode 100644 man/api/draw/solidellipse.htm create mode 100644 man/api/draw/solidpie.htm create mode 100644 man/api/draw/solidpoly.htm create mode 100644 man/api/draw/solidrect.htm create mode 100644 man/api/draw/solidroundrect.htm create mode 100644 man/api/env/flushwindow.htm create mode 100644 man/api/env/getcodepage.htm create mode 100644 man/api/env/getunicodecharmessage.htm create mode 100644 man/api/env/hidewindow.htm create mode 100644 man/api/env/setcodepage.htm create mode 100644 man/api/env/setunicodecharmessage.htm create mode 100644 man/api/env/showwindow.htm create mode 100644 man/api/env/swappage.htm create mode 100644 man/api/font/ege_outtextxy.htm create mode 100644 man/api/font/ege_xyprintf.htm diff --git a/man/about/index.htm b/man/about/index.htm index 6f48ef2d..49841cc7 100644 --- a/man/about/index.htm +++ b/man/about/index.htm @@ -17,9 +17,10 @@

相关信息：

 
-作者：misakamm
-Blog：http://misakamm.com
-Mail：misakamm@gmail.com
+项目：https://github.com/wysaid/xege
+作者：wysaid
+官网：https://xege.org/
+原作者：misakamm(misakamm@gmail.com)
@@ -31,8 +32,93 @@

更新历史：

+ + + + - - + @@ -26,12 +26,20 @@ - + + - - + + + + + + + + +
版本更新日志
 24.04 
配置变更
+1. 库文件名统一命名为 graphics(libgraphics.a, graphics.lib)，不区分 64/32 位
+2. GCC 链接的库由 20.08 的 9 个调整为 3个: -lgraphics -lgdi32 -lgdiplus
+
+新增功能
+1.  新增 EGE_VERSION, EGE_VERSION_NUMBER 等版本相关的宏
+2.  提供 Linux /MacOs 下的编译支持(使用 MinGW-W64 工具链)
+3.  新增 putimage_rotatetransparent()，支持指定透明色旋转绘制图像
+4.  新增 putpixel_savealpha(写入像素时保留原来的 alpha 值),
+5.  新增 putpixel_alphablend(使用 alpha 混合公式写入像素)
+6.  新增 ege_drawimage()，用于绘制带透明通道图像(支持坐标变换，拉伸)
+7.  新增控制台系列相关函数(不支持 VC++ 6.0)
+8.  新增圆角矩形系列函数、填充圆系列函数，饼形系列函数，闭合曲线系列函数，填充矩形(fillrect)
+9.  新增无边框填充的普通图形函数
+10. 新增与 drawpoly 相似但更明确的 polyline(折线), polygon(多边形)
+11. 新增路径图形
+12. 支持保存带透明通道的 BMP 图片， 新增保存 BMP 格式图片的 savebmp 函数
+13. 新增 key_A 和 key_Z 中间的键码定义
+14. 新增更多预定义颜色
+15. 新增按键标志位key_flag_first_down，指示按键按下时发送的第一次 down 消息
+16. 新增 showwindow(), hidewindow() 函数，用于控制窗口显示/隐藏
+17. 新增 INIT_HIDE 初始化模式，使用窗口创建后不可见(调用 showwindow() 显示窗口)
+18. 支持在 EGE 中使用 UTF-8 字符串
+19. 新增用于刷新窗口的 flushwindow() 函数，确保显示绘图内容
+20. 提供对 VS2022 的支持
+21. putimage_withalpha() 支持缩放
+22. ege_系列绘图函数支持设置线型(由 setlinestyle 设置)
+23. MUSIC 类增加 RepeatPlay(), 支持循环播放
+24. 新增 alpha 颜色混合计算函数 alphablend(标准公式), colorblend(保留目标颜色的alpha值),
+    alphablend_premultiplied(预乘 alpha 格式)
+25. 支持设置线帽和线条连接样式
+26. randomize 支持传入随机数种子，并且会返回所使用的随机数种子
+27. 新增 ege_系列使用 ARGB 颜色的单行文本输出函数(ege_xyprintf, ege_outtextxy)
+28. 支持对使用预乘 alpha 像素格式的图像进行混合
+29. 支持设置和获取 EGE 所使用的代码页
+30. ege_系列高级绘图函数支持坐标变换
+31. 支持独立设置和获取线条颜色和文本颜色
+
+功能变更
+1. getimage() 返回值类型统一为 int, 表示是否成功读取图像
+2. saveimage() 根据文件名后缀确定保存为 PNG 格式还是 BMP 格式(优先保存为 PNG 格式)
+3. resize() 恢复为自动填充背景色(20.08 行为改为不填充，现恢复)，另新增不填充背景色的 resize_f()
+4. EGERGB(), EGEARGB() 等宏的返回值类型修改为 color_t
+5. 定时精度提升至 1ms
+6. 为部分类型增加 EGE_XXX_TYPEDEF 宏，控制类型定义
+7. 消除扩展中的头文件包含顺序依赖
+8. 取消 setfillstyle/getfillstyle 的弃用标记
+9. 图像旋转正方向修改为与坐标系一致的顺时针方向
+10. 调整文本垂直对齐方式的值
+11. 为 GCC4.5 以上版本增加弃用信息
+12. 线条连接点默认样式统一修改为尖角
+13. color_t 恢复为与 uint32_t 一致的 unsigned int 类型(20.08 为 DWORD)
+
+问题修复
+1. 修复 inputbox_getline() 界面发黑的问题(20.08 引入)
+2. 修复 sector 函数在半径小于等于20时出现绘制错误的问题
+3. 修复 drawpoly 绘制闭合多边形时首尾连接点无拐角的问题
+4. 修复 setinitmode() 无法改变窗口位置的问题 (20.08 引入)
+5. 修复初始化后 initgraph(-1, -1) 无法将窗口大小设置为全屏的问题
+6. 修复 sys_edit的 isfocus() 函数不可用的问题
+7. 修复 sys_edit 在调用 setfocus 后不显示光标的问题
+8. 修复初始化后鼠标初始位置不正确的问题
+9. 修复 rgb2gray 未对做近似处理的问题
+10. 修复用户手动关闭窗口，不能马上退出的问题
+11. 修复 delay_ms(0) 延时过长的问题，改为与 Sleep(0) 一致的行为(放弃剩余 CPU 时间片，其它线程执行后立即返回)
+12. 修复角度不为0的文本在设置垂直居中时发生偏移的问题
+13. 修复 RGB 格式图片文件读取后图像 alpha 通道为 0 的问题
+14. 修复 ege_drawtext() 无法旋转的问题
+15. 修复填充模式 EMPTY_FILL 不正确的问题
+16. 修复矩形区域输出文本无法按照对齐方式正确的问题
+17. 修复ege_drawtext()无法按照指定字体宽度输出文本的问题
+18. 修复 outtext() 不更新当前点的问题
+19. 纠正 HOME 键和END键的键码
+20. 修复设置视口后当前点没有移动至视口左上角的问题
+21. 修复 putimage 系列函数在源矩形区域左上角不为(0,0) 且宽高使用默认值0时会发生越界的问题
+22. 修复设置视口后 GDI+ 绘图坐标系未移动至视口左上角的问题
+23. VECTOR3D 的 GetAngel() 函数纠正为 GetAngle()
+24. 修复 random() 无默认参数的问题
+
+其它
+1. 减少初次显示屏幕时的闪烁
+2. 图片读取速度优化
 20.08 
 新增功能 
+
 新增功能
  1.  [2019-10-26] 提供对 VS2019 的支持
  2.  [2019-10-26] 引入 CMAKE 构建系统，支持 MSVC 系列和 MinGW-W64 版本编译器
  3.  [2020-04-14] 在 key_code_e 中新增小键盘符号键键码
@@ -48,7 +134,7 @@ 
更新历史：

  13. [2020-07-26] 新增 putpixel_withalpha/putpixel_withalpha_f 绘制带透明通道像素点
  14. [2020-07-26] 新增 alphablend() ARGB 颜色混合函数
  15. [2020-08-12] 添加 LGPL 开源许可证
- 
+
 功能变更：
  1.  [2020-04-06] 项目内移除 gdiplus 依赖
  2.  [2020-05-19] 使用 Simsun(宋体)作为默认字体
@@ -60,7 +146,7 @@ 
更新历史：

  8.  [2020-07-19] 为 getimage() 增加 NULL 参数检查
  9.  [2020-07-26] color_t 的定义由 unsigned int 改为 DWORD(unsigned long)
  10. [2020-07-26] initgraph() 不使用默认参数而改为两个重载
- 
+
 错误修复：
  1. [2019-02-02] 修复无法接收到 key_msg_char 类型消息的错误
  2. [2019-02-04] 修复 putimage_xxx 系列函数在裁剪区域外绘图的错误
diff --git a/man/api/col/alphablend.htm b/man/api/col/alphablend.htm
new file mode 100644
index 00000000..66c8ff74
--- /dev/null
+++ b/man/api/col/alphablend.htm
@@ -0,0 +1,55 @@
+
+    
+    alphablend
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / alphablend
+
+功能：
+
+将两个 ARGB 颜色进行混合。
+混合公式 (dst 为背景色，src 为前景色, alpha 范围映射到 0.0~1.0)：
+A = alpha * 1.0    + (1.0 - alpha) * A(dst)
+R = alpha * R(src) + (1.0 - alpha) * R(dst)
+G = alpha * G(src) + (1.0 - alpha) * G(dst)
+B = alpha * B(src) + (1.0 - alpha) * B(dst)
+
+声明：
+
color_t alphablend(
+    color_t dst,                  // 背景色
+    color_t src,                  // 前景色（提供 alpha，取自透明通道）
+);
+
color_t alphablend(
+    color_t dst,                  // 背景色
+    color_t src,                  // 前景色（提供 alpha，取自透明通道）
+    unsigned char srcAlphaFactor  // 透明度系数
+);
+

+参数：
+
+dst
+背景色
+
+src
+前景色
+
+srcAlphaFactor
+前景色透明度系数，范围为 0 ~ 255，对应 0.0~1.0。
+混合时前景色的透明度先乘以 srcAlphaFactor/255 再进行计算。
+当透明度系数为 0 时，前景色透明度为0，当透明度系数为 255 时，前景色透明度保持不变。
+
+返回值：
+
+混合后的 ARGB 颜色
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/col/alphablend_f.htm b/man/api/col/alphablend_f.htm
new file mode 100644
index 00000000..ff798b18
--- /dev/null
+++ b/man/api/col/alphablend_f.htm
@@ -0,0 +1,54 @@
+
+    
+    alphablend_f
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / alphablend_f
+
+功能：
+
+将两个 ARGB 颜色进行混合。dst 为背景色，src 为前景色。
+混合结果保留背景色 dst 的透明通道。
+
+说明：
+计算较为快速但有微小误差，可用于图像显示。
+如果是连续迭代、图层或者是精确的像素比较则建议用 alphablend 替代。
+
+声明：
+
color_t alphablend_f(
+    color_t dst,         // 背景色
+    color_t src,         // 前景色（提供 alpha，取自透明通道）
+);
+
color_t alphablend_f(
+    color_t dst,         // 背景色
+    color_t src,         // 前景色
+    unsigned char alpha  // 透明度
+);
+

+参数：
+
+dst
+背景色
+
+src
+前景色
+
+alpha
+范围为 0 ~ 255，共 256 个透明度级别。
+0~255 对应混合结果中前景色所占的比例 0~100%.
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/col/alphablend_premultiplied.htm b/man/api/col/alphablend_premultiplied.htm
new file mode 100644
index 00000000..22c74125
--- /dev/null
+++ b/man/api/col/alphablend_premultiplied.htm
@@ -0,0 +1,55 @@
+
+    
+    alphablend_premultiplied
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / alphablend_premultiplied
+
+功能：
+
+将两个使用预乘 alpha 格式的 ARGB 颜色进行混合。
+混合公式 (dst 为背景色，src 为前景色, alpha 范围映射到 0.0~1.0)：
+A = A(src) + (1.0 - alpha) * A(dst)
+R = R(src) + (1.0 - alpha) * R(dst)
+G = G(src) + (1.0 - alpha) * G(dst)
+B = B(src) + (1.0 - alpha) * B(dst)
+
+声明：
+
color_t alphablend_premultiplied(
+    color_t dst,                  // 背景色
+    color_t src,                  // 前景色（提供 alpha，取自透明通道）
+);
+
color_t alphablend_premultiplied(
+    color_t dst,                  // 背景色
+    color_t src,                  // 前景色（提供 alpha，取自透明通道）
+    unsigned char srcAlphaFactor  // 透明度系数
+);
+

+参数：
+
+dst
+背景色(预乘 alpha 格式)
+
+src
+前景色(预乘 alpha 格式)
+
+srcAlphaFactor
+前景色透明度系数，范围为 0 ~ 255，对应 0.0~1.0。
+混合时前景色各分量先乘以 srcAlphaFactor/255 再进行计算。
+当透明度系数为 0 时，前景色透明度为0，当透明度系数为 255 时，前景色透明度保持不变。
+
+返回值：
+
+混合后的 ARGB 颜色 (预乘 alpha 格式)
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/col/colorblend.htm b/man/api/col/colorblend.htm
new file mode 100644
index 00000000..eb76e5e5
--- /dev/null
+++ b/man/api/col/colorblend.htm
@@ -0,0 +1,55 @@
+
+    
+    colorblend
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / colorblend
+
+功能：
+
+将两个 RGB 颜色以指定的 alpha 进行混合，混合结果保留背景色的透明通道。
+混合公式 (dst 为背景色，src 为前景色, alpha 范围映射到 0.0~1.0)：
+R = alpha * R(src) + (1.0 - alpha) * R(dst)
+G = alpha * G(src) + (1.0 - alpha) * G(dst)
+B = alpha * B(src) + (1.0 - alpha) * B(dst)
+A = A(dst)
+
+说明：
+另有 colorblend_f 函数，用于快速计算。
+
+声明：
+
+color_t colorblend(
+    color_t dst,         // 背景色
+    color_t src,         // 前景色
+    unsigned char alpha  // 透明度
+);
+

+参数：
+
+dst
+背景色
+
+src
+前景色
+
+alpha
+透明度，范围为 0 ~ 255，共 256 个透明度级别。数值越大，前景色在混合时所占的比例越大。
+当透明度为   0 时，前景色所占比例为   0%，混合结果等于背景色
+当透明度为 255 时，前景色所占比例为 100%，混合结果等于前景色。
+
+返回值：
+
+混合后的 ARGB 颜色 (alpha 与背景色相同)
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/col/colorblend_f.htm b/man/api/col/colorblend_f.htm
new file mode 100644
index 00000000..22c4d943
--- /dev/null
+++ b/man/api/col/colorblend_f.htm
@@ -0,0 +1,56 @@
+
+    
+    colorblend_f
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / colorblend_f
+
+功能：
+
+将两个 RGB 颜色以指定的 alpha 进行混合，混合结果保留背景色的透明通道。
+混合公式 (dst 为背景色，src 为前景色, alpha 范围映射到 0.0~1.0)：
+R = alpha * R(src) + (1.0 - alpha) * R(dst)
+G = alpha * G(src) + (1.0 - alpha) * G(dst)
+B = alpha * B(src) + (1.0 - alpha) * B(dst)
+A = A(dst)
+
+说明：
+计算较为快速但有微小误差，可正常用于颜色混合，但如果是要求混合后像素数值与标准公式
+无偏差，那么建议使用 colorblend 函数。
+
+声明：
+
+color_t colorblend_f(
+    color_t dst,         // 背景色
+    color_t src,         // 前景色
+    unsigned char alpha  // 透明度
+);
+

+参数：
+
+dst
+背景色
+
+src
+前景色
+
+alpha
+透明度，范围为 0 ~ 255，共 256 个透明度级别。数值越大，前景色在混合时所占的比例越大。
+当透明度为   0 时，前景色所占比例为   0%，混合结果等于背景色
+当透明度为 255 时，前景色所占比例为 100%，混合结果等于前景色。
+
+返回值：
+
+混合后的 ARGB 颜色 (alpha 与背景色相同)
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/col/getlinecolor.htm b/man/api/col/getlinecolor.htm
new file mode 100644
index 00000000..4fafd9bd
--- /dev/null
+++ b/man/api/col/getlinecolor.htm
@@ -0,0 +1,35 @@
+
+    
+    getlinecolor
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / getlinecolor
+
+功能：
+
+获取窗口（图像）设置的线条颜色。
+
+声明：
+
color_t getlinecolor(
+    PCIMAGE pimg = NULL
+);
+

+参数：
+
+pimg
+目标图像 (NULL 为 窗口)
+
+返回值：
+
+窗口（图像）设置的线条颜色
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/col/gettextcolor.htm b/man/api/col/gettextcolor.htm
new file mode 100644
index 00000000..e8b42615
--- /dev/null
+++ b/man/api/col/gettextcolor.htm
@@ -0,0 +1,35 @@
+
+    
+    gettextcolor
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / gettextcolor
+
+功能：
+
+获取窗口（图像）的文本颜色。
+
+声明：
+
color_t gettextcolor(
+    PCIMAGE pimg = NULL
+);
+

+参数：
+
+pimg
+要获取文本颜色的目标图像 (NULL 为 窗口)
+
+返回值：
+
+窗口（图像）的文本颜色
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/col/index.htm b/man/api/col/index.htm
index d3c28ee0..6122d491 100644
--- a/man/api/col/index.htm
+++ b/man/api/col/index.htm
@@ -9,40 +9,50 @@
 
 
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
+
+

 
函数或类型说明最低版本要求
颜色表示				介绍颜色表示方法				
颜色表示				介绍颜色表示方法						

 
EGERGB				通过红、绿、蓝颜色分量合成 RGB 颜色	
EGEGRAY				由灰度值生成对应的 RGB 灰色				
getbkcolor		获取当前绘图背景色				
getcolor			获取当前绘图前景色				
getfillcolor	获取当前绘图填充色				
setbkcolor		设置当前绘图背景色				
setbkcolor_f	设置清屏时所用的背景色			
setbkmode			设置输出文字时的背景模式		
setcolor			设置当前绘图前景色				
setfillcolor	设置当前绘图填充色				
setfontbkcolor设置当前文字背景色				
ege_setalpha	设置图像颜色为统一透明度		
EGEGET_R			返回指定颜色中的红色分量			
EGEGET_G			返回指定颜色中的绿色分量			
EGEGET_B			返回指定颜色中的蓝色分量			
EGEGET_A			返回指定颜色中的透明度			
HSLtoRGB(hsl2rgb)			将 HSL 颜色转换为 RGB 颜色	
HSVtoRGB(hsv2rgb)			将 HSV 颜色转换为 RGB 颜色	
RGBtoHSL(rgb2hsl)			将 RGB 颜色转换为 HSL 颜色	
RGBtoHSV(rgb2hsv)			将 RGB 颜色转换为 HSV 颜色	
RGBTOBGR							将 RGB 颜色转换为 BGR 颜色	在 ege 20.08 中移除
RGBtoGRAY(rgb2gray)		将 RGB 颜色转换为灰度颜色	
EGEGRAY				由灰度值生成对应的 RGB 灰色			
getbkcolor		获取当前绘图背景色						
getcolor			获取当前绘图前景色						
getfillcolor	获取当前绘图填充色						
getlinecolor	获取当前线条颜色						24.04
gettextcolor	获取当前文本颜色						24.04
setbkcolor		设置当前绘图背景色						
setbkcolor_f	设置清屏时所用的背景色					
setbkmode			设置输出文字时的背景模式				
setcolor			设置当前绘图前景色						
setlinecolor	设置当前线条颜色					
settextcolor	设置当前文本颜色					
setfillcolor	设置当前绘图填充色						
setfontbkcolor设置当前文字背景色						
ege_setalpha	设置图像透明通道						
colorblend		RGB  颜色混合							24.04
colorblend_f	RGB  颜色混合							24.04
alphablend		ARGB 颜色混合							20.08
alphablend_premultiplied		预乘 alpha 格式的 ARGB 颜色混合	24.04
EGEGET_R			返回指定颜色中的红色分量				
EGEGET_G			返回指定颜色中的绿色分量				
EGEGET_B			返回指定颜色中的蓝色分量				
EGEGET_A			返回指定颜色中的alpha分量					
HSLtoRGB(hsl2rgb)			将 HSL 颜色转换为 RGB 颜色						
HSVtoRGB(hsv2rgb)			将 HSV 颜色转换为 RGB 颜色						
RGBtoHSL(rgb2hsl)			将 RGB 颜色转换为 HSL 颜色						
RGBtoHSV(rgb2hsv)			将 RGB 颜色转换为 HSV 颜色						
RGBTOBGR							将 RGB 颜色转换为 BGR 颜色						在 20.08 中移除
RGBtoGRAY(rgb2gray)		将 RGB 颜色转换为灰度颜色						

 
 
EGERGBA								通过红、绿、蓝颜色分量和透明度合成 ARGB 颜色	

 
EGEARGB								通过透明度和红、绿、蓝颜色分量合成 ARGB 颜色	

 
EGEACOLOR							通过透明度和 RGB 颜色合成 ARGB 颜色			

 
EGECOLORA							通过 RGB 颜色和透明度合成 ARGB 颜色			
EGEGRAYA							由灰度值和透明度生成对应的灰色				
EGEAGRAY							由灰度值和透明度生成对应的灰色				
EGEGRAYA							由灰度值和透明度生成对应的灰色					
EGEAGRAY							由灰度值和透明度生成对应的灰色					

 

 
 注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。
diff --git a/man/api/col/intro.htm b/man/api/col/intro.htm
index 72be9e19..83b111e0 100644
--- a/man/api/col/intro.htm
+++ b/man/api/col/intro.htm
@@ -61,44 +61,44 @@
 
 4. 用预定义颜色，如下：
 
-
ege20.08 及之前的版本

+
20.08 及之前的版本

 
-				
+		
-				
+		
-				
+		
-				
+		
-					
+		
-					
+		
-				
+		
-			
+		

 	
常量值颜色常量值颜色

 	
BLACK		EGERGB(0x00, 0x00, 0x00)	 黑BLACK		EGERGB(0x00, 0x00, 0x00)	 黑
 		DARKGRAY		EGERGB(0x54, 0x54, 0x54)		 深灰
 	

 	
BLUE		EGERGB(0x00, 0x00, 0xA8)	 蓝BLUE		EGERGB(0x00, 0x00, 0xA8)	 蓝
 		LIGHTBLUE		EGERGB(0x54, 0x54, 0xFC)		 亮蓝
 	

 	
GREEN		EGERGB(0x00, 0xA8 ,0x00)	 绿GREEN		EGERGB(0x00, 0xA8 ,0x00)	 绿
 		LIGHTGREEN		EGERGB(0x54, 0xFC, 0x54)		 亮绿
 	

 	
CYAN		EGERGB(0x00, 0xA8, 0xA8)	 青CYAN		EGERGB(0x00, 0xA8, 0xA8)	 青
 		LIGHTCYAN		EGERGB(0x54, 0xFC, 0xFC)		 亮青
 	

 	
RED			EGERGB(0xA8, 0x00, 0x00)	 红RED			EGERGB(0xA8, 0x00, 0x00)	 红
 		LIGHTRED		EGERGB(0xFC, 0x54, 0x54)		 亮红
 	

 	
MAGENTA		EGERGB(0xA8, 0x00, 0xA8)	 紫MAGENTA		EGERGB(0xA8, 0x00, 0xA8)	 紫
 		LIGHTMAGENTA	EGERGB(0xFC, 0x54, 0xFC)		 亮紫
 	

 	
BROWN		EGERGB(0xA8, 0xA8, 0x00)	 棕BROWN		EGERGB(0xA8, 0xA8, 0x00)	 棕
 		YELLOW			EGERGB(0xFC, 0xFC, 0x54)		 黄
 	

 	
LIGHTGRAY	EGERGB(0xA8, 0xA8, 0xA8)	 浅灰LIGHTGRAY	EGERGB(0xA8, 0xA8, 0xA8)	 浅灰
 		WHITE			EGERGB(0xFC, 0xFC, 0xFC)		 白
 	

 

 
-
ege dev 版本

+
ege 24.04 版本

 
diff --git a/man/api/col/setlinecolor.htm b/man/api/col/setlinecolor.htm
new file mode 100644
index 00000000..353dfbd8
--- /dev/null
+++ b/man/api/col/setlinecolor.htm
@@ -0,0 +1,38 @@
+
+    
+    setlinecolor
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / setlinecolor
+ 
+功能：
+
+设置窗口（图像）的线条颜色。
+
+声明：
+
void setlinecolor(
+    color_t color,
+    PIMAGE pimg = NULL
+);
+

+参数：
+color
+线条颜色
+
+pimg
+目标图像（NULL 为窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/col/settextcolor.htm b/man/api/col/settextcolor.htm
new file mode 100644
index 00000000..51f5c53a
--- /dev/null
+++ b/man/api/col/settextcolor.htm
@@ -0,0 +1,38 @@
+
+    
+    settextcolor
+    
+
+
+
+
主页 / 库函数目录 / 颜色 / settextcolor
+ 
+功能：
+
+设置窗口（图像）的文本颜色。
+
+声明：
+
void settextcolor(
+    color_t color,
+    PIMAGE pimg = NULL
+);
+

+参数：
+color
+文本颜色
+
+pimg
+目标图像（NULL 为窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/console/getch_console.htm b/man/api/console/getch_console.htm
new file mode 100644
index 00000000..f97baa0a
--- /dev/null
+++ b/man/api/console/getch_console.htm
@@ -0,0 +1,27 @@
+
+    
+    getch_console
+    
+
+
+
+
主页 / 库函数目录 / 控制台 / getch_console
+
+功能：
+
+从控制台中读取单个字符(不回显)。相当于 conio.h 中的 getch();
+
+声明：
+
int getch_console();
+

+参数：
+（无）
+
+返回值：
+读取的字符。
+
+示例：
+（无）
+
+
+
diff --git a/man/api/console/index.htm b/man/api/console/index.htm
index 37591e2b..8c59d66f 100644
--- a/man/api/console/index.htm
+++ b/man/api/console/index.htm
@@ -10,11 +10,12 @@
 
 

 	
常量值颜色

 	
ALICEBLUE				EGERGB(0xF0, 0xF8, 0xFF)	 	

-
-
-
-
-
+
+
+
+
+
+

 
函数说明最低版本要求
init_console		初始化（并显示）控制台窗口		 ege dev 
close_console	关闭控制台窗口					 ege dev 
show_console		显示控制台窗口					 ege dev 
hide_console		隐藏控制台窗口					 ege dev 
clear_console	清除控制台窗口中的内容			 ege dev 
init_console		初始化（并显示）控制台窗口		 24.04 
close_console		关闭控制台窗口					 24.04 
show_console		显示控制台窗口					 24.04 
hide_console		隐藏控制台窗口					 24.04 
clear_console		清除控制台窗口中的内容			 24.04 
getch_console		从控制台中读取单个字符(不回显)	 24.04 

 

 
 注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。
diff --git a/man/api/draw/arc.htm b/man/api/draw/arc.htm
index 917979b1..2549dcd5 100644
--- a/man/api/draw/arc.htm
+++ b/man/api/draw/arc.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制圆弧。边线颜色由 setcolor() 函数指定
+绘制圆弧。线条颜色由 setcolor() 函数或 setlinecolor() 函数指定
 
 声明：
 
void arc(
diff --git a/man/api/draw/circle.htm b/man/api/draw/circle.htm
index f1fe5ad9..26b9dcce 100644
--- a/man/api/draw/circle.htm
+++ b/man/api/draw/circle.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制圆，此圆是空心的，不填充，边线颜色由 setcolor() 函数指定
+绘制圆，此圆是空心的，不填充，线条颜色由 setcolor() 函数或 setlinecolor() 函数指定
 
 声明：
 
void circle(
diff --git a/man/api/draw/drawbezier.htm b/man/api/draw/drawbezier.htm
index f936ae40..5424c147 100644
--- a/man/api/draw/drawbezier.htm
+++ b/man/api/draw/drawbezier.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制 bezier 曲线，线条颜色由 setcolor() 函数指定。
+绘制 bezier 曲线，线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
 
void drawbezier(
diff --git a/man/api/draw/drawlines.htm b/man/api/draw/drawlines.htm
index 5d90bad4..b70fffcb 100644
--- a/man/api/draw/drawlines.htm
+++ b/man/api/draw/drawlines.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制多条线段，线条颜色由 setcolor() 函数指定。
+绘制多条线段，线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
 
void drawlines(
diff --git a/man/api/draw/drawpoly.htm b/man/api/draw/drawpoly.htm
index 4029f93a..0df14652 100644
--- a/man/api/draw/drawpoly.htm
+++ b/man/api/draw/drawpoly.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制多边形，边线颜色由 setcolor() 函数指定
+绘制多边形，线条颜色由 setcolor() 函数或 setlinecolor() 函数指定
 
 声明：
 
void drawpoly(
diff --git a/man/api/draw/ege_arc.htm b/man/api/draw/ege_arc.htm
index 2b165fcd..837ba20d 100644
--- a/man/api/draw/ege_arc.htm
+++ b/man/api/draw/ege_arc.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制椭圆弧。线条颜色由 setcolor() 函数指定
+绘制椭圆弧。线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定
 
 声明：
 
void ege_arc(
diff --git a/man/api/draw/ege_bezier.htm b/man/api/draw/ege_bezier.htm
index 76284add..c98206c8 100644
--- a/man/api/draw/ege_bezier.htm
+++ b/man/api/draw/ege_bezier.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制 bezier 曲线，线条颜色由 setcolor() 函数指定。
+绘制 bezier 曲线，线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
 
void ege_bezier(
diff --git a/man/api/draw/ege_drawclosedcurve.htm b/man/api/draw/ege_drawclosedcurve.htm
new file mode 100644
index 00000000..0e104327
--- /dev/null
+++ b/man/api/draw/ege_drawclosedcurve.htm
@@ -0,0 +1,59 @@
+
+    
+    ege_drawclosedcurve
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / ege_drawclosedcurve
+
+功能：
+
+画一条经过所有点的闭合基数样条曲线。
+线条颜色由 setcolor() 或 setlinecolor() 函数指定。
+
+声明：
+
+void ege_drawclosedcurve(
+    int numpoints,
+    ege_point* polypoints,
+    PIMAGE pimg = NULL
+);
+void ege_drawclosedcurve(
+    int numpoints,
+    ege_point* polypoints,
+    float tension,
+    PIMAGE pimg = NULL
+);
+

+
+注意事项：
+使用的是 ARGB 颜色，透明度不能为 0，否则无绘制效果。
+
+参数：
+numpoints
+点的个数。
+
+polypoints
+每个点的坐标，数组元素个数为 numpoints。
+基数样条曲线经过所有点。
+
+tension
+曲线张力，为 0.0 时闭合曲线变为多边形。（默认设置为 0.25）
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/ege_drawcurve.htm b/man/api/draw/ege_drawcurve.htm
index bb568b13..451be1b4 100644
--- a/man/api/draw/ege_drawcurve.htm
+++ b/man/api/draw/ege_drawcurve.htm
@@ -9,14 +9,21 @@
 
 功能：
 
-画一条经过所有点的拟合曲线，线条颜色由 setcolor() 函数指定。
+画一条经过所有点的基数样条曲线，线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
-
void ege_drawcurve(
+
+void ege_drawcurve(
     int numpoints,
     ege_point* polypoints,
-    PIMAGE pimg = NULL
-);
+    PIMAGE pimg = NULL
+);
+void ege_drawcurve(
+    int numpoints,
+    ege_point* polypoints,
+    float tension,
+    PIMAGE pimg = NULL
+);
 

 
 注意事项：
@@ -28,7 +35,10 @@
 
 polypoints
 每个点的坐标，数组元素个数为 numpoints。
-拟合曲线经过所有点。
+基数样条曲线经过所有点。
+
+tension
+曲线张力，为 0.0 时曲线变为折线。（默认设置为 0.25）
 
 pimg
 绘制的目标图像，默认为 NULL（即绘制到窗口）。
diff --git a/man/api/draw/ege_drawimage.htm b/man/api/draw/ege_drawimage.htm
index 227379e4..b5a8f8f1 100644
--- a/man/api/draw/ege_drawimage.htm
+++ b/man/api/draw/ege_drawimage.htm
@@ -16,22 +16,22 @@
 
// 绘制图像
 void ege_drawimage(
     PCIMAGE srcimg,        // 源图像指针
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
     PCIMAGE pimg = NULL    //目标图像指针，NULL表示绘制到屏幕
 );
 
 // 绘制图像(拉伸)
 void ege_drawimage(
     PCIMAGE srcimg,        // 源图像指针
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    int dstWidth,          // 绘制的宽度
-    int dstHeight,         // 绘制的高度
-    int srcX,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int srcY,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int srcWidth,          // 绘制内容在源 IMAGE 对象中的宽度
-    int srcHeight,         // 绘制内容在源 IMAGE 对象中的高度
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    int widthDest,          // 绘制的宽度
+    int heightDest,         // 绘制的高度
+    int xSrc,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc,          // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc,         // 绘制内容在源 IMAGE 对象中的高度
     PCIMAGE pimg = NULL    //目标图像指针，NULL表示绘制到屏幕
 );
 

diff --git a/man/api/draw/ege_drawpath.htm b/man/api/draw/ege_drawpath.htm
new file mode 100644
index 00000000..08299d2a
--- /dev/null
+++ b/man/api/draw/ege_drawpath.htm
@@ -0,0 +1,50 @@
+
+    
+    ege_drawimage
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / ege_drawimage
+
+功能：
+
+绘制路径
+
+声明：
+
+void ege_drawpath(
+    const ege_path* path,  // 源图像指针
+    PCIMAGE pimg = NULL    //目标图像指针，NULL表示绘制到屏幕
+);
+
+void ege_drawpath(
+    const ege_path* path,  // 路径
+    int x,                 // 目标位置的 x 坐标
+    int y,                 // 目标位置的 y 坐标
+    PCIMAGE pimg = NULL    //目标图像指针，NULL表示绘制到屏幕
+);
+

+参数：
+
+path
+路径
+
+x
+目标位置的 x 坐标
+y
+目标位置的 y 坐标
+
+pimg
+目标图像（NULL 为窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+

+
+
+
diff --git a/man/api/draw/ege_drawpoly.htm b/man/api/draw/ege_drawpoly.htm
index 01ebea53..34ff7874 100644
--- a/man/api/draw/ege_drawpoly.htm
+++ b/man/api/draw/ege_drawpoly.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-画多边形线框，边线颜色由 setcolor() 函数指定。
+画多边形线框，线条颜色由 setcolor() 或 setlinecolor() 函数指定。
 
 声明：
 
void ege_drawpoly(
diff --git a/man/api/draw/ege_ellipse.htm b/man/api/draw/ege_ellipse.htm
index 159c1a97..9a5e0d01 100644
--- a/man/api/draw/ege_ellipse.htm
+++ b/man/api/draw/ege_ellipse.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制椭圆线框，边线颜色由 setcolor() 函数指定。。
+绘制椭圆线框，线条颜色由 setcolor() 或 setlinecolor() 函数指定。。
 
 声明：
 
void ege_ellipse(
diff --git a/man/api/draw/ege_fillclosedcurve.htm b/man/api/draw/ege_fillclosedcurve.htm
new file mode 100644
index 00000000..e10c3e3c
--- /dev/null
+++ b/man/api/draw/ege_fillclosedcurve.htm
@@ -0,0 +1,58 @@
+
+    
+    ege_fillclosedcurve
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / ege_fillclosedcurve
+
+功能：
+
+绘制填充的闭合基数样条曲线。填充颜色由 setfillcolor() 指定
+
+声明：
+
+void ege_fillclosedcurve(
+    int numpoints,
+    ege_point* polypoints,
+    PIMAGE pimg = NULL
+);
+void ege_fillclosedcurve(
+    int numpoints,
+    ege_point* polypoints,
+    float tension,
+    PIMAGE pimg = NULL
+);
+

+
+注意事项：
+使用的是 ARGB 颜色，透明度不能为 0，否则无绘制效果。
+
+参数：
+numpoints
+点的个数。
+
+polypoints
+每个点的坐标，数组元素个数为 numpoints。
+基数样条曲线经过所有点。
+
+tension
+曲线张力，为 0.0 时闭合曲线变为多边形。（默认设置为 0.25）
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/ege_fillpath.htm b/man/api/draw/ege_fillpath.htm
new file mode 100644
index 00000000..e69de29b
diff --git a/man/api/draw/ege_fillroundrect.htm b/man/api/draw/ege_fillroundrect.htm
new file mode 100644
index 00000000..5a74b167
--- /dev/null
+++ b/man/api/draw/ege_fillroundrect.htm
@@ -0,0 +1,74 @@
+
+    
+    ege_fillroundrect
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / ege_fillroundrect
+
+功能：
+
+绘制无边框的填充圆角矩形。填充颜色由 setfillcolor() 指定。
+
+声明：
+
+void ege_fillroundrect(
+    float x,
+    float y,
+    float w,
+    float h,
+    float radius,      // 圆角半径
+    PIMAGE pimg = NULL
+);
+void ege_fillroundrect(
+    float x,
+    float y,
+    float w,
+    float h,
+    float radius1,     // 左上角圆角半径
+    float radius2,     // 右上角圆角半径
+    float radius3,     // 右下角圆角半径
+    float radius4,     // 左下角圆角半径
+    PIMAGE pimg = NULL
+);
+

+
+注意事项：
+使用的是 ARGB 颜色，透明度不能为 0，否则无绘制效果。
+
+参数：
+x
+矩形左上角 x 坐标。
+
+y
+矩形左上角 y 坐标。
+
+w
+矩形宽。
+
+h
+矩形高。
+
+radius
+四个圆角的半径（四个圆角都为同样的半径，因此半径最大为矩形最短边长的一半）
+
+radius1, radius2, radius3, radious4
+从左上角开始按顺时针顺序对应的四个圆角的半径。
+圆角半径最小为 0，无法大于矩形边长，如果相邻两个圆角的半径之和大于边长，则顺序靠前的优先。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/draw/ege_line.htm b/man/api/draw/ege_line.htm
index 385ca780..5658f650 100644
--- a/man/api/draw/ege_line.htm
+++ b/man/api/draw/ege_line.htm
@@ -9,7 +9,7 @@
 
 功能：
 
-绘制直线， 线条颜色由 setcolor() 函数指定。
+绘制直线， 线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
 
void ege_line(
diff --git a/man/api/draw/ege_roundrect.htm b/man/api/draw/ege_roundrect.htm
new file mode 100644
index 00000000..96e4e611
--- /dev/null
+++ b/man/api/draw/ege_roundrect.htm
@@ -0,0 +1,74 @@
+
+    
+    ege_roundrect
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / ege_roundrect
+
+功能：
+
+绘制圆角矩形边框。线条颜色由 setcolor() 或 setlinecolor() 指定。
+
+声明：
+
+void ege_roundrect(
+    float x,
+    float y,
+    float w,
+    float h,
+    float radius,      // 圆角半径
+    PIMAGE pimg = NULL
+);
+void ege_roundrect(
+    float x,
+    float y,
+    float w,
+    float h,
+    float radius1,     // 左上角圆角半径
+    float radius2,     // 右上角圆角半径
+    float radius3,     // 右下角圆角半径
+    float radius4,     // 左下角圆角半径
+    PIMAGE pimg = NULL
+);
+

+
+注意事项：
+使用的是 ARGB 颜色，透明度不能为 0，否则无绘制效果。
+
+参数：
+x
+矩形左上角 x 坐标。
+
+y
+矩形左上角 y 坐标。
+
+w
+矩形宽。
+
+h
+矩形高。
+
+radius
+四个圆角的半径（四个圆角都为同样的半径，因此半径最大为矩形最短边长的一半）
+
+radius1, radius2, radius3, radious4
+从左上角开始按顺时针顺序对应的四个圆角的半径。
+圆角半径最小为 0，无法大于矩形边长，如果相邻两个圆角的半径之和大于边长，则顺序靠前的优先。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+

+
+
+
diff --git a/man/api/draw/ellipse.htm b/man/api/draw/ellipse.htm
index 6726f776..3d761fc6 100644
--- a/man/api/draw/ellipse.htm
+++ b/man/api/draw/ellipse.htm
@@ -10,7 +10,7 @@
 功能：
 
 绘制椭圆弧线。
-线条颜色由 setcolor() 函数指定。
+线条颜色由 setcolor() 函数 或 setlinecolor() 函数指定。
 
 声明：
 
void ellipse(
diff --git a/man/api/draw/fillcircle.htm b/man/api/draw/fillcircle.htm
index e4b87bf0..f5268223 100644
--- a/man/api/draw/fillcircle.htm
+++ b/man/api/draw/fillcircle.htm
@@ -11,7 +11,7 @@
 功能：
 
 绘制填充圆。
-边线颜色由 setcolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
+线条颜色由 setcolor() 函数或 setlinecolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
 
 声明：
 
void fillcircle(
diff --git a/man/api/draw/fillellipse.htm b/man/api/draw/fillellipse.htm
index f2154395..b487c190 100644
--- a/man/api/draw/fillellipse.htm
+++ b/man/api/draw/fillellipse.htm
@@ -10,7 +10,7 @@
 功能：
 
 绘制填充的椭圆。
-边线颜色由 setcolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
+线条颜色由 setcolor() 函数或 setlinecolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
 
 声明：
 
void fillellipse(
diff --git a/man/api/draw/fillpie.htm b/man/api/draw/fillpie.htm
new file mode 100644
index 00000000..40fde9d6
--- /dev/null
+++ b/man/api/draw/fillpie.htm
@@ -0,0 +1,70 @@
+
+    
+    pie
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / pie
+
+功能：
+
+画填充饼形。填充颜色由 setfillcolor() 指定。
+
+声明：
+
+void pie(
+    int x,
+    int y,
+    int stangle,
+    int endangle,
+    int xRadius,
+    int yRadius,
+    PIMAGE pimg = NULL
+);
+
+void pief(
+    float x,
+    float y,
+    float stangle,
+    float endangle,
+    float xRadius,
+    float yRadius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+x
+饼形的圆心 x 坐标。
+
+y
+饼形的圆心 y 坐标。
+
+stangle
+饼形的起始角的角度。
+
+endangle
+饼形的终止角的角度。
+
+xRadius
+饼形的水平半径。
+
+yRadius
+饼形的垂直半径。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/fillpoly.htm b/man/api/draw/fillpoly.htm
index 46326a83..9ff2ee5c 100644
--- a/man/api/draw/fillpoly.htm
+++ b/man/api/draw/fillpoly.htm
@@ -10,7 +10,7 @@
 功能：
 
 绘制填充的多边形。
-边线颜色由 setcolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
+线条颜色由 setcolor() 函数或 setlinecolor() 函数指定，填充颜色由 setfillcolor() 函数指定。
 
 声明：
 
void fillpoly(
diff --git a/man/api/draw/fillpoly_gradient.htm b/man/api/draw/fillpoly_gradient.htm
index eae57260..f361ad72 100644
--- a/man/api/draw/fillpoly_gradient.htm
+++ b/man/api/draw/fillpoly_gradient.htm
@@ -10,7 +10,7 @@
 功能：
 
 绘制由渐变填充填充的多边形。
-边线颜色由 setcolor() 函数指定，根据指定点的颜色对多边形内部进行渐变填充。
+线条颜色由 setcolor() 函数或 setlinecolor() 函数指定，根据指定点的颜色对多边形内部进行渐变填充。
 
 声明：
 
void fillpoly_gradient(
diff --git a/man/api/draw/getlinecap.htm b/man/api/draw/getlinecap.htm
new file mode 100644
index 00000000..b2dc7dde
--- /dev/null
+++ b/man/api/draw/getlinecap.htm
@@ -0,0 +1,58 @@
+
+    
+    getlinecap
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / getlinecap
+
+功能：
+
+获取当前设置的线条线帽样式。
+
+说明：
+    高级绘图函数可以单独控制线条头部和尾部线帽，而普通绘图函数只能将
+两端设置为同样的线帽。
+
+线帽样式，可以是以下值：
+
+
+
+
+
+
+
值含义
LINECAP_FLAT平直线帽（默认）
LINECAP_SQUARE方形线帽
LINECAP_ROUND圆形线帽

+
+声明：
+
+line_cap_type getlinecap(
+    PIMAGE pimg = NULL
+);
+
+void getlinecap(
+    line_cap_type* startCap,  // 线条头部线帽样式
+    line_cap_type* endCap,    // 线条尾部线帽样式
+    PIMAGE pimg = NULL
+);
+

+参数：
+
+startCap
+line_cap_type 型变量地址，用于返回线条头部线帽样式。
+
+endCap
+line_cap_type 型变量地址，用于返回线条尾部线帽样式。
+
+pimg
+目标图像，默认为 NULL (窗口)
+
+返回值：
+线条头部线帽样式
+
+示例：
+
+

+
+
+
diff --git a/man/api/draw/getlinejoin.htm b/man/api/draw/getlinejoin.htm
new file mode 100644
index 00000000..b378aede
--- /dev/null
+++ b/man/api/draw/getlinejoin.htm
@@ -0,0 +1,57 @@
+
+    
+    getlinejoin
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / getlinejoin
+
+功能：
+
+获取当前设置的线条连接处样式。
+
+说明：
+
+
+线条连接处样式，可以是以下值：
+
+
+
+
+
+
+
值含义
LINEJOIN_MITER尖角（默认）
LINEJOIN_BEVEL斜角
LINEJOIN_ROUND圆角

+
+声明：
+
+line_join_type getlinejoin(
+    PIMAGE pimg = NULL
+);
+
+void getlinejoin(
+    line_join_type* linejoin,    // 线条连接处样式
+    float*          miterLimit,  // 尖角长度上限
+    PIMAGE          pimg = NULL
+);
+

+参数：
+
+linejoin
+line_join_type 型变量地址，用于返回所设置的线条连接处样式。
+
+miterLimit
+float 型变量地址，用于返回设置的尖角长度上限。
+
+pimg
+目标图像，默认为 NULL (窗口)
+
+返回值：
+所设置的线条连接处样式
+
+示例：
+
+

+
+
+
diff --git a/man/api/draw/index.htm b/man/api/draw/index.htm
index c6965458..d5f246cd 100644
--- a/man/api/draw/index.htm
+++ b/man/api/draw/index.htm
@@ -15,94 +15,144 @@
     另外，这里每一个函数的最后一个参数均为一个 PIMAGE 的指针，是一个可选参数，如果不填或者填入 NULL，则绘制到当前绘图页。如果填上，则绘制到指定的图像。
     关于效率，如果使用手动渲染模式（setrendermode(RENDER_MANUAL)），那以上所有函数的执行速度都会得到提升。
 
-
-
普通绘图函数：

-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
样式设置
函数或类型说明最低版本要求
arc							绘制圆弧							
bar								绘制无边框填充矩形					
bar3d							绘制有边框三维填充矩形				
circle						绘制圆								
drawbezier				绘制bezier曲线						
drawlines					绘制多条不连续线段					
drawpoly					绘制多边形							
ellipse						绘制椭圆弧线						
fillcircle				绘制填充的圆						 ege dev 
fillellipse				绘制填充的椭圆						
fillpoly					绘制填充的多边形					
fillpoly_gradient	绘制渐变填充的多边形				
fillrect					绘制填充的矩形						 ege dev 
fillroundrect			绘制填充的圆角矩形					 ege dev 
floodfill					指定边界色填充区域					
floodfillsurface	指定区域色填充区域					

+
+
+
+
+
+
+
+
+
+
-
-
+
+
+
+
+
-
-
-
-
-
+
+
设置样式说明最低版本要求
setfillcolor			设置当前填充颜色					
setcolor					设置当前前景颜色					
setlinecolor			设置当前线条颜色					24.04
setfillstyle			设置当前填充类型					
setlinestyle			设置当前线形						
setlinecap				设置当前线帽						24.04
setlinejoin				设置当前线条连接样式				24.04
setlinewidth			设置当前线宽						
setwritemode			设置绘图位操作模式					

 
getfillcolor			获取当前填充颜色					

 
getfillstyle			 								获取当前填充类型（暂不支持）		
getheight					获取绘图区的高度					

 
getlinestyle			获取当前线形						
getpixel					获取像素点的颜色					
getlinecap				获取当前线帽						24.04
getlinejoin				获取当前线条连接处样式				24.04
绘图环境说明最低版本要求

 
getwidth					获取绘图区的宽度					
getheight					获取绘图区的高度					

 
getx							获取当前 x 坐标					

 
gety							获取当前 y 坐标					
line							绘制线								
linerel						绘制线								
lineto						绘制线								

 
moverel						移动当前点							
moveto						移动当前点							
pieslice					绘制填充圆扇形						
moveto						移动当前点至指定坐标				

+
+
普通绘图函数：

+
+
-
-
+
+
+
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
像素点说明最低版本要求
getpixel					获取像素点的颜色					

 
putpixel					设置像素点的颜色					
putpixel_savealpha			设置像素点的颜色（同时保留原有alpha值）	ege dev
putpixel_withalpha			绘制像素点（根据 alpha 进行混合）	        ege 20.08
putpixel_savealpha			设置像素点的颜色（同时保留原有alpha值）							24.04
putpixel_withalpha			绘制像素点（根据 alpha 进行混合，混合结果保留背景色 alpha）		20.08
putpixel_alphablend			绘制像素点（根据 alpha 进行混合）									24.04

 
putpixels					绘制多个像素点						
rectangle					绘制空心矩形						
roundrect					绘制空心圆角矩形					
sector						绘制填充椭圆扇形					
setfillcolor			设置当前填充颜色					
setfillstyle			设置当前填充类型（过时函数）		
setlinestyle			设置当前线形						
setlinewidth			设置当前线宽						
setwritemode			设置绘图位操作模式					
弧说明最低版本要求
arc								绘制圆弧							
ellipse						绘制椭圆或椭圆弧					
直线说明最低版本要求
line						绘制直线							
linerel					绘制直线							
lineto					绘制直线							
drawlines				绘制多条不连续线段					
折线说明最低版本要求
polygon					绘制折线							24.04
drawpoly				绘制折线或多边形边框				
曲线说明最低版本要求
drawbezier				绘制贝塞尔曲线						
矩形说明最低版本要求
rectangle					绘制矩形边框						
fillrect					绘制填充矩形(有边框)				 24.04 
solidrect					绘制填充矩形(无边框)				 24.04 
bar								绘制填充矩形(无边框)				
bar3d							绘制三维填充矩形(有边框)			
多边形说明最低版本要求
drawpoly					绘制折线或多边形边框				
polygon						绘制多边形边框						24.04
fillpoly					绘制填充多边形(有边框)				
solidpoly					绘制填充多边形(无边框)				24.04
fillpoly_gradient	绘制渐变填充多边形					
椭圆说明最低版本要求
circle						绘制圆								
ellipse						绘制椭圆或椭圆弧					
fillcircle				绘制填充圆(有边框)					24.04
fillellipse				绘制填充椭圆(有边框)				
solidcircle				绘制填充圆(无边框)					24.04
solidellipse			绘制填充椭圆(无边框)				
饼形/扇形说明最低版本要求
pie								绘制饼形边框						24.04
fillpie						绘制填充饼形(有边框)				24.04
solidpie					绘制填充饼形(无边框)				24.04
sector						绘制填充椭圆扇形(有边框)			
pieslice					绘制填充圆扇形(有边框)				
圆角矩形说明最低版本要求
roundrect					绘制圆角矩形边框					
fillroundrect			绘制填充圆角矩形(有边框)			 24.04 
solidroundrect		绘制填充圆角矩形(无边框)			 24.04 
区域填充说明最低版本要求
floodfill					指定边界色填充区域					
floodfillsurface	指定区域色填充区域					

 

 
+
 注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。
 
 
高级绘图函数(图形可设置透明度，可带抗锯齿)：

-
 
-
-
+
+
+
-
-
-
-
+
+
+
+
+
-
-
-
-
-
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
-
+
diff --git a/man/api/draw/pie.htm b/man/api/draw/pie.htm
new file mode 100644
index 00000000..5de6b3d3
--- /dev/null
+++ b/man/api/draw/pie.htm
@@ -0,0 +1,71 @@
+
+    
+    pie
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / pie
+
+功能：
+
+画饼形线框。
+线条颜色由 setcolor() 或 setlinecolor() 指定。
+
+声明：
+
+void pie(
+    int x,
+    int y,
+    int stangle,
+    int endangle,
+    int xRadius,
+    int yRadius,
+    PIMAGE pimg = NULL
+);
+
+void pief(
+    float x,
+    float y,
+    float stangle,
+    float endangle,
+    float xRadius,
+    float yRadius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+x
+饼形的圆心 x 坐标。
+
+y
+饼形的圆心 y 坐标。
+
+stangle
+饼形的起始角的角度。
+
+endangle
+饼形的终止角的角度。
+
+xRadius
+饼形的水平半径。
+
+yRadius
+饼形的垂直半径。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/putpixel_alphablend.htm b/man/api/draw/putpixel_alphablend.htm
new file mode 100644
index 00000000..331cd8ea
--- /dev/null
+++ b/man/api/draw/putpixel_alphablend.htm
@@ -0,0 +1,65 @@
+
+    
+    putpixel_alphablend
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / putpixel_alphablend
+
+功能：
+
+绘制一个像素点（使用 ARGB 颜色，根据 alpha 进行混合，参见 alphablend）。
+
+声明：
+
+void putpixel_alphablend(
+    int x,
+    int y,
+    color_t color,
+    PIMAGE pimg = NULL
+);
+
+void putpixel_alphablend(
+    int x,
+    int y,
+    color_t color,
+    unsigned char alphaFactor,
+    PIMAGE pimg = NULL
+);
+

+参数：
+x
+点的 x 坐标。
+
+y
+点的 y 坐标。
+
+color
+像素点的 ARGB 颜色。
+
+srcAlphaFactor
+前景色透明度系数，范围为 0 ~ 255，对应 0.0~1.0。
+混合时前景色的透明度先乘以 srcAlphaFactor/255 再进行计算。
+当透明度系数为 0 时，前景色透明度为0，当透明度系数为 255 时，前景色透明度保持不变。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+其它说明：另有高速版的 putpixel_alphablend_f 函数，参数一样，作用一样，但不进行相对坐标变换
+（如果越界绘图，要么画错地方，要么程序结果莫名其妙，甚至直接崩溃）
+并且必须在窗口锁定绘图模式下才能使用，否则将发生不可预知的结果。
+
+
+

+
+
+
diff --git a/man/api/draw/setfillstyle.htm b/man/api/draw/setfillstyle.htm
index ea47e47c..ed526978 100644
--- a/man/api/draw/setfillstyle.htm
+++ b/man/api/draw/setfillstyle.htm
@@ -43,7 +43,7 @@
 填充颜色。
 
 pimg
-设置的图像，默认为 NULL（窗口)
+设置的图像，默认为 NULL（窗口）
 
 
 返回值：
diff --git a/man/api/draw/setlinecap.htm b/man/api/draw/setlinecap.htm
new file mode 100644
index 00000000..37502dab
--- /dev/null
+++ b/man/api/draw/setlinecap.htm
@@ -0,0 +1,63 @@
+
+    
+    setlinecap
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / setlinecap
+
+功能：
+
+设置线条的线帽样式。
+
+说明：
+    高级绘图函数可以单独控制线条头部和尾部线帽，而普通绘图函数只能将
+两端设置为同样的线帽（设置的两端线帽不相同时，与头部线帽一致）。
+
+声明：
+
+void setlinecap(
+    line_cap_type linecap,   // 线条两端线帽样式
+    PIMAGE pimg = NULL
+);
+
+void setlinecap(
+    line_cap_type startCap,  // 线条头部线帽样式
+    line_cap_type endCap,    // 线条尾部线帽样式
+    PIMAGE pimg = NULL
+);
+

+参数：
+
+线帽样式，可以是以下值：
+
+
函数或类型		说明		最低版本要求
ege_enable_aa								抗锯齿设置		
图形设置		说明		最低版本要求
ege_enable_aa								抗锯齿设置				
线框图形		说明		最低版本要求

 
ege_line										绘制线					
ege_rectangle								绘制矩形线框				
ege_arc											绘制圆弧					
ege_ellipse									绘制椭圆线框				
ege_pie											绘制扇形线框				
ege_rectangle								绘制矩形线框			
ege_roundrect								绘制圆角矩形线框		24.04
ege_arc											绘制圆弧				
ege_ellipse									绘制椭圆线框			
ege_pie											绘制扇形线框			

 
ege_drawpoly								绘制多边形线框			

 
ege_bezier									绘制贝塞尔曲线			
ege_drawcurve								绘制拟合曲线				
ege_fillrect								绘制填充矩形				
ege_fillpie									绘制填充扇形				
ege_drawcurve								绘制基数样条曲线		
ege_drawclosedcurve					绘制闭合基数样条曲线	24.04
ege_drawpath								绘制路径				24.04
填充图形		说明		最低版本要求
ege_fillrect								绘制填充矩形			
ege_fillroundrect						绘制填充圆角矩形		24.04
ege_fillpie									绘制填充扇形			

 
ege_fillpoly								绘制填充多边形			
ege_fillellipse							绘制填充椭圆				
ege_drawimage								(alpha混合)绘制图像	ege dev
ege_transform_rotate				旋转坐标变换			ege dev
ege_translate_rotate				平移坐标变换			ege dev
ege_transform_scale					缩放坐标变换			ege dev
ege_transform_reset					重置（清除）所有坐标变换		ege dev
ege_get_transform						获取现有坐标变换矩阵	ege dev
ege_set_transform						设置坐标变换矩阵		ege dev
ege_fillellipse							绘制填充椭圆			
ege_fillclosedcurve					绘制填充的闭合基数样条曲线	24.04
ege_fillpath								绘制填充路径			24.04
ege_drawimage								(alpha混合)绘制图像	24.04
坐标变换		说明		最低版本要求
ege_transform_rotate				旋转坐标变换			24.04
ege_translate_rotate				平移坐标变换			24.04
ege_transform_scale					缩放坐标变换			24.04
ege_transform_reset					重置（清除）所有坐标变换		24.04
ege_get_transform						获取现有坐标变换矩阵	24.04
ege_set_transform						设置坐标变换矩阵		24.04
填充模式		说明		最低版本要求

 
ege_setpattern_none							设置为默认填充模式		 

 
ege_setpattern_lineargradient		设置为线性渐变填充模式	 

 
ege_setpattern_ellipsegradient	设置为椭圆渐变填充模式	 

 
ege_setpattern_texture					设置为纹理填充模式		 

 
ege_setpattern_pathgradient			设置为路径渐变填充模式	 
纹理		说明		最低版本要求

 
ege_gentexture							生成纹理				

 
ege_puttexture							绘制纹理				
类型		说明		最低版本要求

 
ege_point 结构体								点						

 
ege_rect 结构体									矩形区域				

 
ege_colpoint 结构体							颜色点					

+
+
+
+
+
值含义
LINECAP_FLAT平直线帽（默认）
LINECAP_SQUARE方形线帽
LINECAP_ROUND圆形线帽

+
+linecap
+线条两端线帽样式。
+
+startCap
+线条头部线帽样式。
+
+endCap
+线条尾部线帽样式。
+
+pimg
+目标图像，默认为 NULL (窗口)
+
+返回值：
+
+（无）
+
+示例：
+
+

+
+
+
diff --git a/man/api/draw/setlinejoin.htm b/man/api/draw/setlinejoin.htm
new file mode 100644
index 00000000..0c5a2967
--- /dev/null
+++ b/man/api/draw/setlinejoin.htm
@@ -0,0 +1,58 @@
+
+    
+    setlinejoin
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / setlinejoin
+
+功能：
+
+设置线条连接处样式。
+
+声明：
+
+void setlinejoin(
+    line_join_type linejoin,   // 线条连接处样式
+    PIMAGE pimg = NULL
+);
+
+void setlinejoin(
+    line_join_type linejoin,    // 线条连接处样式
+    float          miterLimit,  // 尖角长度上限
+    PIMAGE         pimg = NULL
+);
+

+参数：
+
+线条连接处样式，可以是以下值：
+
+
+
+
+
+
+
值含义
LINEJOIN_MITER尖角（默认）
LINEJOIN_BEVEL斜角
LINEJOIN_ROUND圆角

+
+linejoin
+线条连接处样式
+
+miterLimit
+尖角长度上限，允许的最大尖角长度与笔划宽度的比率，最小值为 1.0f。(内部默认设置为 10.0f)
+当两条线之间的角度较小时，斜线长度可能很大。因此设置上限，当尖角过长时，在尖端处以斜角截断。
+
+
+pimg
+目标图像，默认为 NULL (窗口)
+
+返回值：
+
+（无）
+
+示例：
+
+

+
+
+
diff --git a/man/api/draw/solidcircle.htm b/man/api/draw/solidcircle.htm
new file mode 100644
index 00000000..d7237658
--- /dev/null
+++ b/man/api/draw/solidcircle.htm
@@ -0,0 +1,56 @@
+
+    
+    solidcircle
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / solidcircle
+
+
+功能：
+
+绘制无边框填充圆，填充颜色由 setfillcolor() 函数指定。
+
+声明：
+
void solidcircle(
+    int x,
+    int y,
+    int radius,
+    PIMAGE pimg = NULL
+);
+
+void solidcirclef(
+    float x,
+    float y,
+    float radius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+
+x
+圆的圆心 x 坐标。
+
+y
+圆的圆心 y 坐标。
+
+radius
+圆的半径。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/solidellipse.htm b/man/api/draw/solidellipse.htm
new file mode 100644
index 00000000..db1078b8
--- /dev/null
+++ b/man/api/draw/solidellipse.htm
@@ -0,0 +1,58 @@
+
+    
+    solidellipse
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / solidellipse
+
+功能：
+
+绘制无边框填充椭圆。填充颜色由 setfillcolor() 函数指定。
+
+声明：
+
void solidellipse(
+    int x,
+    int y,
+    int xradius,
+    int yradius,
+    PIMAGE pimg = NULL
+);
+void solidellipsef(
+    float x,
+    float y,
+    float xradius,
+    float yradius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+x
+椭圆的圆心 x 坐标。
+
+y
+椭圆的圆心 y 坐标。
+
+xradius
+椭圆的 x 轴半径。
+
+yradius
+椭圆的 y 轴半径。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/solidpie.htm b/man/api/draw/solidpie.htm
new file mode 100644
index 00000000..79e4add2
--- /dev/null
+++ b/man/api/draw/solidpie.htm
@@ -0,0 +1,70 @@
+
+    
+    pie
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / pie
+
+功能：
+
+画无边框的填充饼形。填充颜色由 setfillcolor() 指定。
+
+声明：
+
+void pie(
+    int x,
+    int y,
+    int stangle,
+    int endangle,
+    int xRadius,
+    int yRadius,
+    PIMAGE pimg = NULL
+);
+
+void pief(
+    float x,
+    float y,
+    float stangle,
+    float endangle,
+    float xRadius,
+    float yRadius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+x
+饼形的圆心 x 坐标。
+
+y
+饼形的圆心 y 坐标。
+
+stangle
+饼形的起始角的角度。
+
+endangle
+饼形的终止角的角度。
+
+xRadius
+饼形的水平半径。
+
+yRadius
+饼形的垂直半径。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/solidpoly.htm b/man/api/draw/solidpoly.htm
new file mode 100644
index 00000000..69ce0d38
--- /dev/null
+++ b/man/api/draw/solidpoly.htm
@@ -0,0 +1,45 @@
+
+    
+    solidpoly
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / solidpoly
+
+功能：
+
+绘制无边框填充多边形。填充颜色由 setfillcolor() 函数指定。
+
+声明：
+
void solidpoly(
+    int numpoints,
+    const int *polypoints,
+    PIMAGE pimg = NULL
+);
+

+参数：
+numpoints
+多边形点的个数。
+
+polypoints
+每个点的坐标，数组元素个数为 numpoints * 2。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+说明：
+
+
+

+
+
+
diff --git a/man/api/draw/solidrect.htm b/man/api/draw/solidrect.htm
new file mode 100644
index 00000000..bd8733f6
--- /dev/null
+++ b/man/api/draw/solidrect.htm
@@ -0,0 +1,52 @@
+
+    
+    solidrect
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / solidrect
+
+功能：
+
+绘制无边框填充矩形。其中，填充颜色由 setfillcolor() 函数指定
+
+声明：
+
void solidrect(
+    int left,
+    int top,
+    int right,
+    int bottom,
+    PIMAGE pimg = NULL
+);
+

+参数：
+
+left
+矩形左部 x 坐标。
+
+top
+矩形上部 y 坐标。
+
+right
+矩形右部 x 坐标（该点取不到，实际右边界为 right-1 ）。
+
+bottom
+矩形下部 y 坐标（该点取不到，实际下边界为 bottom-1 ）。
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/draw/solidroundrect.htm b/man/api/draw/solidroundrect.htm
new file mode 100644
index 00000000..864cb94f
--- /dev/null
+++ b/man/api/draw/solidroundrect.htm
@@ -0,0 +1,58 @@
+
+    
+    fillroundrect
+    
+
+
+
+
主页 / 库函数目录 / 图形绘制 / fillroundrect
+
+功能：
+
+绘制无边框填充圆角矩形。填充颜色由 setfillcolor() 指定。
+
+声明：
+
void fillroundrect(
+    int left,
+    int top,
+    int right,
+    int bottom,
+    int xradius,
+    int yradius,
+    PIMAGE pimg = NULL
+);
+

+参数：
+left
+矩形左部 x 坐标。
+
+top
+矩形上部 y 坐标。
+
+right
+矩形右部 x 坐标（该点取不到，实际右边界为right-1）。
+
+bottom
+矩形下部 y 坐标（该点取不到，实际下边界为bottom-1）。
+
+xradius
+圆角的x方向半径
+
+yradius
+圆角的y方向半径
+
+pimg
+绘制的目标图像，默认为 NULL（即绘制到窗口）。
+
+返回值：
+
+（无）
+
+示例：
+见demo/ege5rectangles.cpp
+
+
+

+
+
+
diff --git a/man/api/env/flushwindow.htm b/man/api/env/flushwindow.htm
new file mode 100644
index 00000000..c87d8878
--- /dev/null
+++ b/man/api/env/flushwindow.htm
@@ -0,0 +1,34 @@
+
+    
+    flushwindow
+    
+
+
+
+
主页 / 库函数目录 / 绘图环境 / flushwindow
+
+功能：
+
+刷新窗口，将绘图内容显示到窗口上。
+
+声明：
+
+void flushwindow();
+

+参数：
+
+（无）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/env/getcodepage.htm b/man/api/env/getcodepage.htm
new file mode 100644
index 00000000..7eea2f87
--- /dev/null
+++ b/man/api/env/getcodepage.htm
@@ -0,0 +1,38 @@
+
+    
+    getcodepage
+    
+
+
+
+
主页 / 库函数目录 / 绘图环境 / getcodepage
+
+功能：
+
+获取当前 EGE 所使用的代码页。
+
+声明：
+
unsigned int getcodepage();

+参数：
+
+
+返回值：
+
+代码页，与 Windows 代码页编号一致。EGE 为常用的几个代码页定义了名称。
+
+
+	
+	
+	
+	
+
 代码页		值		对应编码
 EGE_CODEPAGE_ANSI  			0		 ANSI
 EGE_CODEPAGE_GB2312			936		GB2312
 EGE_CODEPAGE_UTF8  			65001	UTF-8

+
+示例：
+
+（无）
+

+
+
+

+
+
diff --git a/man/api/env/getunicodecharmessage.htm b/man/api/env/getunicodecharmessage.htm
new file mode 100644
index 00000000..d506d40d
--- /dev/null
+++ b/man/api/env/getunicodecharmessage.htm
@@ -0,0 +1,39 @@
+
+    
+    getunicodecharmessage
+    
+
+
+
+
主页 / 库函数目录 / 绘图环境 / getunicodecharmessage
+
+功能：
+
+获取字符消息(由 getkey 读取)是否使用 Unicode(UTF-16) 编码的设置。
+
+声明：
+
void getunicodecharmessage(bool enable);

+参数：
+
+（无）
+
+返回值：
+
+字符消息是否使用 Unicode(UTF-16) 编码。
+
+
+	
+	
+	
+
 值		描述
 true			使用 Unicode(UTF-16) 编码
 false			使用 EGE 代码页所对应的编码

+
+示例：
+
+（无）
+

+
+
+

+
+
+
diff --git a/man/api/env/hidewindow.htm b/man/api/env/hidewindow.htm
new file mode 100644
index 00000000..1a7e0b95
--- /dev/null
+++ b/man/api/env/hidewindow.htm
@@ -0,0 +1,34 @@
+
+    
+    hidewindow
+    
+
+
+
+
主页 / 库函数目录 / 绘图环境 / hidewindow
+
+功能：
+
+隐藏窗口。
+
+声明：
+
+void hidewindow();
+

+参数：
+
+（无）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+

+
+
+
diff --git a/man/api/env/index.htm b/man/api/env/index.htm
index bd27700a..be5c4681 100644
--- a/man/api/env/index.htm
+++ b/man/api/env/index.htm
@@ -14,7 +14,7 @@
cleardevice 清除窗口(图像)内容
is_run 判断窗口环境是否还在运行
setcaption 设置窗口标题
seticon 设置窗口图标 ege 20.08
seticon 设置窗口图标 20.08
setinitmode 设置初始化参数
setrendermode 设置窗口渲染模式
clearviewport 清除视口区域内容
setactivepage 设置当前绘图页
setvisualpage 设置当前显示页
setvisualpage 设置当前显示页
swappage 交换显示页和绘图页
window_getviewport 获取当前窗口可见部分
window_setviewport 设置窗口可见部分
movewindow 移动窗口 ege 20.08
resizewindow 调整窗口大小 ege 20.08
movewindow 移动窗口 20.08
resizewindow 调整窗口大小 20.08
flushwindow 刷新窗口 24.04
showwindow 显示窗口 24.04
hidewindow 隐藏窗口 24.04
setcodepage 设置代码页 24.04
getcodepage 获取代码页 24.04
setunicodecharmessage 设置字符消息是否使用 UTF-16 编码 24.04
getunicodecharmessage 判断字符消息是否使用 UTF-16 编码 24.04
注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。 diff --git a/man/api/env/initgraph.htm b/man/api/env/initgraph.htm index a451867d..5e05975e 100644 --- a/man/api/env/initgraph.htm +++ b/man/api/env/initgraph.htm @@ -49,8 +49,8 @@ INIT_TOPMOST 0x4 顶层窗口(不会被其它窗口遮挡) INIT_RENDERMANUAL 0x8 手动渲染模式 INIT_NOFORCEEXIT 0x10 退出时不强制结束程序，而是设置标志位，可由 is_run() 判断
当设置了 INIT_NOFORCEEXIT 模式后，用户进行关闭窗口操作时窗口不会关闭，程序也不会退出，此时 is_run() 返回 false。
同时 getch(), getmouse() 之类的阻塞性函数将不再阻塞，由于窗口没有主动关闭，所以后续需要在代码中自行做窗口关闭和程序退出的相关处理。 - INIT_UNICODE (ege20.08 起) 0x20 窗口使用 Unicode 字符集 - INIT_HIDE (ege dev) 0x40 窗口使用 Unicode 字符集 + INIT_UNICODE (20.08 起) 0x20 窗口使用 Unicode 字符集 + INIT_HIDE (24.04) 0x40 窗口使用 Unicode 字符集 INIT_WITHLOGO 0x100 带 EGE logo 出场动画 diff --git a/man/api/env/setcaption.htm b/man/api/env/setcaption.htm index 73d8084b..5d52aaf4 100644 --- a/man/api/env/setcaption.htm +++ b/man/api/env/setcaption.htm @@ -12,8 +12,8 @@ 设置窗口标题。 声明： -
void setcaption(LPCSTR  caption);
-void setcaption(LPCWSTR caption);
+
void setcaption(const char*  caption);
+void setcaption(const wchar_t* caption);
 

 参数：
 
diff --git a/man/api/env/setcodepage.htm b/man/api/env/setcodepage.htm
new file mode 100644
index 00000000..9d615a0c
--- /dev/null
+++ b/man/api/env/setcodepage.htm
@@ -0,0 +1,41 @@
+
+    
+    setcodepage
+    
+
+
+
+
主页 / 库函数目录 / 绘图环境 / setcodepage
+
+功能：
+
+设置 MBCS（多字节字符集）字符串所使用的代码页。默认使用的代码页为 ANSI。
+
+声明：
+
void setcodepage(unsigned int codepage);

+参数：
+
+page
+代码页，与 Windows 代码页编号一致。EGE 为常用的几个代码页定义了名称。
+
+
+	
+	
+	
+	
+
 代码页		值		对应编码
 EGE_CODEPAGE_ANSI			0	 ANSI
 EGE_CODEPAGE_GB2312			936	GB2312
 EGE_CODEPAGE_UTF8			65001	UTF-8

+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+

+
+
+
+ + + diff --git a/man/api/env/setinitmode.htm b/man/api/env/setinitmode.htm index 82299974..93b0131d 100644 --- a/man/api/env/setinitmode.htm +++ b/man/api/env/setinitmode.htm @@ -27,8 +27,8 @@ INIT_TOPMOST 0x4 顶层窗口(不会被其它窗口遮挡) INIT_RENDERMANUAL 0x8 手动渲染模式 INIT_NOFORCEEXIT 0x10 退出时不强制结束程序，而是设置标志位，可由 is_run() 判断
当设置了 INIT_NOFORCEEXIT 模式后，用户进行关闭窗口操作时窗口不会关闭，程序也不会退出，此时 is_run() 返回 false。
同时 getch(), getmouse() 之类的阻塞性函数将不再阻塞，由于窗口没有主动关闭，所以后续需要在代码中自行做窗口关闭和程序退出的相关处理。 - INIT_UNICODE (ege20.08 起) 0x20 窗口使用 Unicode 字符集 - INIT_HIDE (ege dev) 0x40 窗口使用 Unicode 字符集 + INIT_UNICODE (20.08 起) 0x20 窗口使用 Unicode 字符集 + INIT_HIDE (24.04) 0x40 窗口使用 Unicode 字符集 INIT_WITHLOGO 0x100 带 EGE logo 出场动画 diff --git a/man/api/env/setunicodecharmessage.htm b/man/api/env/setunicodecharmessage.htm new file mode 100644 index 00000000..604f24b1 --- /dev/null +++ b/man/api/env/setunicodecharmessage.htm @@ -0,0 +1,40 @@ + + + setunicodecharmessage + + + + +
主页 / 库函数目录 / 绘图环境 / setunicodecharmessage
+
+功能：
+
+设置字符消息（由 getkey 读取）是否使用 Unicode(UTF-16) 编码。
+
+声明：
+
void setunicodecharmessage(bool enable);

+参数：
+
+enable
+字符消息是否使用 Unicode(UTF-16) 编码。
+
+
+	
+	
+	
+
 值		描述
 true			使用 Unicode(UTF-16) 编码
 false			使用 EGE 代码页所对应的编码

+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+ + + + + + diff --git a/man/api/env/showwindow.htm b/man/api/env/showwindow.htm new file mode 100644 index 00000000..92f52ba9 --- /dev/null +++ b/man/api/env/showwindow.htm @@ -0,0 +1,36 @@ + + + showwindow + + + + +
主页 / 库函数目录 / 绘图环境 / showwindow
+
+功能：
+    显示窗口，并将窗口置于顶层。
+    如果 initgraph() 中的初始化模式包含 INIT_HIDE，那么窗口创建后处于不可见状态，需要调用
+showwindow() 显示窗口。如果初始化模式中还设置了 INIT_WITHLOGO，那么窗口在第一次显示时还会
+出现 LOGO 动画。
+
+声明：
+
+void showwindow();
+

+参数：
+
+（无）
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+
+
+ + + diff --git a/man/api/env/swappage.htm b/man/api/env/swappage.htm new file mode 100644 index 00000000..25624d1c --- /dev/null +++ b/man/api/env/swappage.htm @@ -0,0 +1,31 @@ + + + swappage + + + + +
主页 / 库函数目录 / 绘图环境 / swappage
+
+功能：
+
+交换显示页和绘图页。
+
+声明：
+
void swappage();

+参数：
+
+返回值：
+
+（无）
+
+示例：
+
+（无）
+
+ + + + + + diff --git a/man/api/font/ege_drawtext.htm b/man/api/font/ege_drawtext.htm index 0720d7cf..e744d66f 100644 --- a/man/api/font/ege_drawtext.htm +++ b/man/api/font/ege_drawtext.htm @@ -13,13 +13,13 @@ 声明： 
void ege_drawtext(
-    LPCSTR format,
+    const char* format,
     int x,
     int y,
     ...
 );
 void ege_drawtext(
-    LPCWSTR format,
+    const wchar_t* format,
     int x,
     int y,
     ...
diff --git a/man/api/font/ege_outtextxy.htm b/man/api/font/ege_outtextxy.htm
new file mode 100644
index 00000000..ef0206e8
--- /dev/null
+++ b/man/api/font/ege_outtextxy.htm
@@ -0,0 +1,76 @@
+
+    
+    ege_outtextxy
+    
+
+
+
+
主页 / 库函数目录 / 文字输出 / ege_outtextxy
+
+功能：
+
+在指定位置输出字符串，支持 ARGB 颜色。
+
+声明：
+
void ege_outtextxy(
+    int x,
+    int y,
+    const char* text,
+    PIMAGE pimg = NULL
+);
+
+void ege_outtextxy(
+    int x,
+    int y,
+    CHAR c,
+    PIMAGE pimg = NULL
+);
+
+void ege_outtextxy(
+    int x,
+    int y,
+    const wchar_t* text,
+    PIMAGE pimg = NULL
+);
+
+void ege_outtextxy(
+    int x,
+    int y,
+    wchar_t c,
+    PIMAGE pimg = NULL
+);

+参数：
+
+x
+字符串输出时头字母的 x 轴的坐标值
+
+y
+字符串输出时头字母的 y 轴的坐标值。
+
+text
+要输出的文本内容。
+
+c
+要输出的字符。
+
+返回值：
+
+（无）
+
+示例：
+
// 输出字符串
+char s[] = "Hello World";
+ege_outtextxy(10, 20, s);
+// 输出字符
+char c = 'A';
+ege_outtextxy(10, 40, c);
+// 输出数值，先将数字格式化输出为字符串
+char s[5];
+sprintf(s, "%d", 1024);
+ege_outtextxy(10, 60, s);

+
+
+

+
+
+
diff --git a/man/api/font/ege_xyprintf.htm b/man/api/font/ege_xyprintf.htm
new file mode 100644
index 00000000..a4767d95
--- /dev/null
+++ b/man/api/font/ege_xyprintf.htm
@@ -0,0 +1,52 @@
+
+    
+    ege_xyprintf
+    
+
+
+
+
主页 / 库函数目录 / 文字输出 / ege_xyprintf
+
+功能：
+
+在指定位置格式化输出字符串，使用 ARGB 颜色。
+
+声明：
+
void ege_xyprintf(
+    int x,
+    int y,
+    const char* format,
+    ...
+);
+void ege_xyprintf(
+    int x,
+    int y,
+    const wchar_t* format,
+    ...
+);
+

+参数：
+
+x
+字符串输出时头字母的 x 轴的坐标值
+
+y
+字符串输出时头字母的 y 轴的坐标值。
+
+format
+格式字符串。
+...
+要输出的内容的参数，类似 printf。
+
+返回值：
+
+（无）
+
+示例：
+无
+
+
+

+
+
+
diff --git a/man/api/font/index.htm b/man/api/font/index.htm
index 340c8bb8..9c476b0d 100644
--- a/man/api/font/index.htm
+++ b/man/api/font/index.htm
@@ -28,7 +28,7 @@
 textheight				获取字符串的高				
 textwidth					获取字符串的宽				
 xyprintf					在指定位置格式化输出字符串	
-ege_drawtext			在指定位置格式化输出字符串（使用 ARGB 颜色）	不低于 ege 20.08
+ege_drawtext			在指定位置格式化输出字符串（使用 ARGB 颜色）	20.08
 
 注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。
 
diff --git a/man/api/font/outtext.htm b/man/api/font/outtext.htm
index 9ff72534..68589df4 100644
--- a/man/api/font/outtext.htm
+++ b/man/api/font/outtext.htm
@@ -13,7 +13,7 @@
 
 声明：
 
void outtext(
-    LPCSTR textstring,
+    const char* text,
     PIMAGE pimg = NULL
 );
 
@@ -23,16 +23,16 @@
 );
 
 void outtext(
-    LPCWSTR textstring,
+    const wchar_t* text,
     PIMAGE pimg = NULL
 );
 
 void outtext(
-    WCHAR c,
+    wchar_t c,
     PIMAGE pimg = NULL
 );

 参数：
-textstring
+text
 要输出的字符串。
 
 c
diff --git a/man/api/font/outtextrect.htm b/man/api/font/outtextrect.htm
index c2f7f015..1734d873 100644
--- a/man/api/font/outtextrect.htm
+++ b/man/api/font/outtextrect.htm
@@ -17,7 +17,7 @@
     int y,
     int w,
     int h,
-    LPCSTR textstring,
+    const char* text,
     PIMAGE pimg = NULL
 );
 void outtextrect(
@@ -25,15 +25,15 @@
     int y,
     int w,
     int h,
-    LPCWSTR textstring,
+    const wchar_t* text,
     PIMAGE pimg = NULL
 );
参数： x, y, w, h 要输出字符串所在的矩形区域 -textstring -要输出的字符串。 +text +要输出的字符串。 返回值： diff --git a/man/api/font/outtextxy.htm b/man/api/font/outtextxy.htm index f44ffefc..922cff5e 100644 --- a/man/api/font/outtextxy.htm +++ b/man/api/font/outtextxy.htm @@ -15,7 +15,7 @@ 
void outtextxy(
     int x,
     int y,
-    LPCSTR textstring,
+    const char* text,
     PIMAGE pimg = NULL
 );
 
@@ -29,14 +29,14 @@
 void outtextxy(
     int x,
     int y,
-    LPCWSTR textstring,
+    const wchar_t* text,
     PIMAGE pimg = NULL
 );
 
 void outtextxy(
     int x,
     int y,
-    WCHAR c,
+    wchar_t c,
     PIMAGE pimg = NULL
 );
参数： @@ -47,7 +47,7 @@ y 字符串输出时头字母的 y 轴的坐标值。 -textstring +text 要输出的字符串。 c diff --git a/man/api/font/rectprintf.htm b/man/api/font/rectprintf.htm index 051dc9fa..e52cb083 100644 --- a/man/api/font/rectprintf.htm +++ b/man/api/font/rectprintf.htm @@ -17,7 +17,7 @@ int y, int w, int h, - LPCSTR format, + const char* format, ... ); @@ -26,7 +26,7 @@ int y, int w, int h, - LPCWSTR format, + const wchar_t* format, ... ); diff --git a/man/api/font/setfont.htm b/man/api/font/setfont.htm index 69fb0708..cb6fc50f 100644 --- a/man/api/font/setfont.htm +++ b/man/api/font/setfont.htm @@ -9,44 +9,47 @@ 功能： -设置当前字体样式,字体颜色另外由setcolor()设置。 +设置当前字体样式,字体颜色另外由setcolor() 或 settextcolor() 设置。 + +备注： +另有接收类型为 const wchar_t* 的 typeface 参数的重载。 声明： 
void setfont(
-    int nHeight,
-    int nWidth,
-    LPCSTR lpszFace,
+    int height,
+    int width,
+    const char* typeface,
     PIMAGE pimg = NULL
 );
 
 void setfont(
-    int nHeight,
-    int nWidth,
-    LPCSTR lpszFace,
-    int nEscapement,
-    int nOrientation,
-    int nWeight,
-    bool bItalic,
-    bool bUnderline,
-    bool bStrikeOut,
+    int height,
+    int width,
+    const char* typeface,
+    int escapement,
+    int orientation,
+    int weight,
+    bool italic,
+    bool underline,
+    bool strikeOut,
     PIMAGE pimg = NULL
 );
 
 void setfont(
-    int nHeight,
-    int nWidth,
-    LPCSTR lpszFace,
-    int nEscapement,
-    int nOrientation,
-    int nWeight,
-    bool bItalic,
-    bool bUnderline,
-    bool bStrikeOut,
-    BYTE fbCharSet,
-    BYTE fbOutPrecision,
-    BYTE fbClipPrecision,
-    BYTE fbQuality,
-    BYTE fbPitchAndFamily,
+    int height,
+    int width,
+    const char* typeface,
+    int escapement,
+    int orientation,
+    int weight,
+    bool italic,
+    bool underline,
+    bool strikeOut,
+    BYTE charSet,
+    BYTE outPrecision,
+    BYTE clipPrecision,
+    BYTE quality,
+    BYTE pitchAndFamily,
     PIMAGE pimg = NULL
 );
 
@@ -55,24 +58,24 @@
     PIMAGE pimg = NULL
 );
参数： -nHeight +height 指定高度（逻辑单位）。如果为正，表示指定的高度包括字体的默认行距；如果为负，表示指定的高度只是字符的高度。 -nWidth +width 字符的平均宽度（逻辑单位）。如果为 0，则比例自适应。 -lpszFace -字体名称。对于此参数均有LPCSTR和LPCWSTR两个版本，以上函数声明仅列出一种。提供两个接口是为了方便能同时使用两种不同的字符集。 +typeface +字体名称。对于此参数均有const char*和const wchar_t*两个版本，以上函数声明仅列出一种。提供两个接口是为了方便能同时使用两种不同的字符集。 常用的字体名称有：宋体，楷体_GB2312，隶书，黑体，幼圆，新宋体，仿宋_GB2312，Fixedsys，Arial，Times New Roman 具体可用名字，可查阅你系统已安装字体。 -nEscapement +escapement 字符串的书写角度，单位为 0.1°。 -nOrientation +orientation 每个字符的书写角度，单位为 0.1°。 -nWeight +weight 字符的笔画粗细，范围 0~1000。0 表示默认粗细。使用数字或下表中定义的宏均可： @@ -93,28 +96,28 @@
宏粗细值
FW_BLACK900
-bItalic +italic 是否斜体，true / false。 -bUnderline +underline 是否有下划线，true / false。 -bStrikeOut +strikeOut 是否有删除线，true / false。 -fbCharSet +charSet 指定字符集(详见 LOGFONT 结构体)。 -fbOutPrecision +outPrecision 指定文字的输出精度(详见 LOGFONT 结构体)。 -fbClipPrecision +clipPrecision 指定文字的剪辑精度(详见 LOGFONT 结构体)。 -fbQuality +quality 指定文字的输出质量(详见 LOGFONT 结构体)。 -fbPitchAndFamily +pitchAndFamily 指定以常规方式描述字体的字体系列(详见 LOGFONT 结构体)。 font @@ -133,7 +136,7 @@ getfont(&f); // 获取当前字体设置 f.lfHeight = 48; // 设置字体高度为 48（包含行距） strcpy(f.lfFaceName, "黑体"); // 设置字体为“黑体” -f.lfQuality = ANTIALIASED_QUALITY; // 设置输出效果为抗锯齿 +f.lfQuality = ANTIALIASED_QUALITY; // 设置输出效果为抗锯齿 setfont(&f); // 设置字体样式 outtextxy(0,50,"抗锯齿效果"); diff --git a/man/api/font/settextjustify.htm b/man/api/font/settextjustify.htm index e4261f37..d3378e61 100644 --- a/man/api/font/settextjustify.htm +++ b/man/api/font/settextjustify.htm @@ -30,8 +30,8 @@ CENTER_TEXT居中对齐CENTER_TEXT居中对齐 RIGHT_TEXT右对齐BOTTOM_TEXT底部对齐 -textstring -要输出的字符串的指针。 +text +要输出的字符串的指针。 返回值： diff --git a/man/api/font/textheight.htm b/man/api/font/textheight.htm index bdc6e62d..66e63b3a 100644 --- a/man/api/font/textheight.htm +++ b/man/api/font/textheight.htm @@ -13,11 +13,11 @@ 声明： 
int textheight(
-    LPCTSTR textstring,
+    LPCTSTR text,
     PIMAGE pimg = NULL
 );
参数： -textstring +text 指定的字符串指针。 返回值： diff --git a/man/api/font/textwidth.htm b/man/api/font/textwidth.htm index dbdf4941..96165088 100644 --- a/man/api/font/textwidth.htm +++ b/man/api/font/textwidth.htm @@ -13,11 +13,11 @@ 声明： 
int textwidth(
-    LPCTSTR textstring,
+    LPCTSTR text,
     PIMAGE pimg = NULL
 );
参数： -textstring +text 指定的字符串指针。 返回值： diff --git a/man/api/font/xyprintf.htm b/man/api/font/xyprintf.htm index 55f1da43..5441cd3e 100644 --- a/man/api/font/xyprintf.htm +++ b/man/api/font/xyprintf.htm @@ -15,13 +15,13 @@ 
void xyprintf(
     int x,
     int y,
-    LPCSTR format,
+    const char* format,
     ...
 );
 void xyprintf(
     int x,
     int y,
-    LPCWSTR format,
+    const wchar_t* format,
     ...
 );
diff --git a/man/api/img/getimage.htm b/man/api/img/getimage.htm index a6d82e05..788a332f 100644 --- a/man/api/img/getimage.htm +++ b/man/api/img/getimage.htm @@ -5,47 +5,53 @@ -
主页 / 库函数目录 / 图像处理 / getimage
+
+主页 / 库函数目录 / 图像处理 / getimage
 
 功能：
 
 这个函数的四个重载分别用于从窗口 / 文件 / 资源 / IMAGE 对象中获取图像
 
+说明：
+
+如果目标对象包含多帧图像，那么仅获取第一帧图像。
+
 声明：
-
// 从窗口获取图像
-int getimage(
-    PIMAGE pDstImg,       // 保存图像的 IMAGE 对象指针
-    int srcX,             // 要获取图像的区域左上角 x 坐标
-    int srcY,             // 要获取图像的区域左上角 y 坐标
-    int srcWidth,         // 要获取图像的区域宽度
-    int srcHeight         // 要获取图像的区域高度
-);
+
+// 从窗口获取图像
+int getimage(
+    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
+    int xSrc,             // 要获取图像的区域左上角 x 坐标
+    int ySrc,             // 要获取图像的区域左上角 y 坐标
+    int widthSrc,         // 要获取图像的区域宽度
+    int heightSrc         // 要获取图像的区域高度
+);
 
-// 从另一个 IMAGE 对象中获取图像
-int getimage(
-    PIMAGE pDstImg,       // 保存图像的 IMAGE 对象指针
-    PCIMAGE pSrcImg,      // 源图像 IMAGE 对象
-    int srcX,             // 要获取图像的区域左上角 x 坐标
-    int srcY,             // 要获取图像的区域左上角 y 坐标
-    int srcWidth,         // 要获取图像的区域宽度
-    int srcHeight         // 要获取图像的区域高度
-);
+// 从另一个 IMAGE 对象中获取图像
+int getimage(
+    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
+    PCIMAGE imgSrc,       // 源图像 IMAGE 对象
+    int xSrc,             // 要获取图像的区域左上角 x 坐标
+    int ySrc,             // 要获取图像的区域左上角 y 坐标
+    int widthSrc,         // 要获取图像的区域宽度
+    int heightSrc         // 要获取图像的区域高度
+);
 
-// 从图片文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
-int getimage(
-    PIMAGE pDstImg,       // 保存图像的 IMAGE 对象指针
-    LPCTSTR pImgFile,     // 图片文件名
-    int zoomWidth = 0,    // 设定图像缩放至的宽度（0 表示默认宽度，不缩放）
-    int zoomHeight = 0    // 设定图像缩放至的高度（0 表示默认高度，不缩放）
-);
+// 从图片文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
+int getimage(
+    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
+    LPCTSTR pImgFile,     // 图片文件名
+    int zoomWidth = 0,    // 设定图像缩放至的宽度（0 表示默认宽度，不缩放）
+    int zoomHeight = 0    // 设定图像缩放至的高度（0 表示默认高度，不缩放）
+);
 
-// 从资源文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
-int getimage(
-    PIMAGE pDstImg,       // 保存图像的 IMAGE 对象指针
-    LPCTSTR pResType,     // 资源类型
-    LPCTSTR pResName,     // 资源名称
-    int zoomWidth = 0,    // 设定图像缩放至的宽度（0 表示默认宽度，不缩放）
-    int zoomHeight = 0    // 设定图像缩放至的高度（0 表示默认高度，不缩放）
+// 从资源文件获取图像(png/bmp/jpg/gif/emf/wmf/ico)
+int getimage(
+    PIMAGE imgDest,       // 保存图像的 IMAGE 对象指针
+    LPCTSTR pResType,     // 资源类型
+    LPCTSTR pResName,     // 资源名称
+    int zoomWidth = 0,    // 设定图像缩放至的宽度（0 表示默认宽度，不缩放）
+    int zoomHeight = 0    // 设定图像缩放至的高度（0 表示默认高度，不缩放）
 );
 

 参数：
@@ -56,11 +62,11 @@
 
 
-
-
-
-
-
+
+
+
+
+

 
返回值含义
grOk (值为 0)读取成功
grAllocError读取时内存分配失败
grFileNotFound文件不存在
grNullPointer指针转换失败
grIOerror读取失败
grOk (值为 0)      读取成功           
grAllocError       读取时内存分配失败 
grFileNotFound     文件不存在         
grNullPointer      指针转换失败       
grIOerror          读取失败           

 

 
 
diff --git a/man/api/img/getimage_pngfile.htm b/man/api/img/getimage_pngfile.htm
index edddb5a3..6d800676 100644
--- a/man/api/img/getimage_pngfile.htm
+++ b/man/api/img/getimage_pngfile.htm
@@ -14,12 +14,12 @@
 声明：
 
int getimage_pngfile(
     PIMAGE  pimg,
-    LPCSTR  filename
+    const char*  filename
 );
 
 int getimage_pngfile(
     PIMAGE  pimg,
-    LPCWSTR  filename
+    const wchar_t*  filename
 );
 

 参数：
diff --git a/man/api/img/imagefilter_blurring.htm b/man/api/img/imagefilter_blurring.htm
index 9b40129b..e2da4ad9 100644
--- a/man/api/img/imagefilter_blurring.htm
+++ b/man/api/img/imagefilter_blurring.htm
@@ -13,16 +13,16 @@
 
 声明：
 
int imagefilter_blurring (
-    PIMAGE imgdest,
+    PIMAGE imgDest,
     int intensity,
     int alpha,
-    int nXOriginDest = 0,
-    int nYOriginDest = 0,
-    int nWidthDest = 0,
-    int nHeightDest = 0
+    int xDest = 0,
+    int yDest = 0,
+    int widthDest = 0,
+    int heightDest = 0
 );

 参数：
-imgdest
+imgDest
 要进行模糊操作的图片，如果为NULL则表示操作窗口上的图片
 
 intensity
@@ -31,7 +31,7 @@
 alpha
 图像亮度。取值为0x100表示亮度不变，取值为0x0表示图像变成纯黑
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
+xDest, yDest, widthDest, heightDest
 描述要进行此操作的矩形区域。如果nWidthDest和nHeightDest 为0，表示操作整张图片。
 
 返回值：
diff --git a/man/api/img/index.htm b/man/api/img/index.htm
index e8d9ffe7..41b3e50c 100644
--- a/man/api/img/index.htm
+++ b/man/api/img/index.htm
@@ -18,23 +18,25 @@
 
 putimage							绘制指定图像								
 putimage_withalpha		绘制带透明通道的图像						
+putimage_withalpha_f	绘制带透明通道的图像						24.04
 putimage_alphablend		以半透明方式绘制指定图像					
-putimage_alphafilter	根据提供的 alpha，将源图像和目标图像进行混合					ege 20.08
+putimage_alphafilter	根据提供的 alpha，将源图像和目标图像进行混合					20.08
 putimage_transparent	以透明方式绘制指定图像						
 putimage_alphatransparent		以透明/半透明方式绘制指定图像	
 putimage_rotate							将图像旋转后绘制				
 putimage_rotatezoom					将图像旋转缩放后绘制			
-putimage_rotatetransparent	将图像旋转缩放后以透明方式绘制	ege dev
+putimage_rotatetransparent	将图像旋转缩放后以透明方式绘制	24.04
 
 resize								调整图像尺寸								
-resize_f							调整图像尺寸，不进行背景色填充				ege dev
+resize_f							调整图像尺寸，不进行背景色填充				24.04
 getwidth							获取图像宽度								
 getheight							获取图像高度								
 getbuffer							获取图像缓存区								
+ege_setalpha				设置图像透明通道							
 
 saveimage							保存图像									
 savepng								保存 PNG 图像								
-savebmp								保存 BMP 图像								ege dev
+savebmp								保存 BMP 图像								24.04
 
 imagefilter_blurring	对指定图像进行图像模糊滤镜操作				
 三元光栅操作码							介绍三元光栅操作码							
diff --git a/man/api/img/newimage.htm b/man/api/img/newimage.htm
index 1e54c051..be5a9357 100644
--- a/man/api/img/newimage.htm
+++ b/man/api/img/newimage.htm
@@ -14,7 +14,6 @@
 
 声明：
 
PIMAGE newimage();   //创建大小为1x1的图像
-    
 
 PIMAGE newimage(      //创建指定大小的图像
     int width,
@@ -23,7 +22,7 @@
 

 参数：
 width, height
-图像的尺寸
+图像的宽度和高度（单位：像素）
 
 
 返回值：
diff --git a/man/api/img/putimage.htm b/man/api/img/putimage.htm
index d8c85506..fe3787c4 100644
--- a/man/api/img/putimage.htm
+++ b/man/api/img/putimage.htm
@@ -12,74 +12,77 @@
 这个函数的几个重载用于在窗口或另一个图像上绘制指定图像。
 
 声明：
-
// 绘制图像到窗口
-void putimage(
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    PCIMAGE pSrcImg,       // 要绘制的 IMAGE 对象指针
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);
-
-// 绘制图像到(指定宽高)
-void putimage(
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    int dstWidth,          // 绘制的宽度
-    int dstHeight,         // 绘制的高度
-    PCIMAGE pSrcImg,       // 要绘制的 IMAGE 对象指针
-    int srcX,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int srcY,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);
-
-// 绘制图像到窗口(拉伸)
-void putimage(
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    int dstWidth,          // 绘制的宽度
-    int dstHeight,         // 绘制的高度
-    PCIMAGE pSrcImg,       // 要绘制的 IMAGE 对象指针
-    int srcX,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int srcY,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int srcWidth,          // 绘制内容在源 IMAGE 对象中的宽度
-    int srcHeight,         // 绘制内容在源 IMAGE 对象中的高度
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);
-
-// 绘制图像到另一图像
-void putimage(
-    PIMAGE pDstImg,        // 目标 IMAGE 对象指针
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    PCIMAGE pSrcImg,       // 源 IMAGE 对象指针
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);
-// 绘制图像到另一图像(指定宽高)
-void putimage(
-    PIMAGE pDstImg,        // 目标 IMAGE 对象指针
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    int dstWidth,          // 绘制的宽度
-    int dstHeight,         // 绘制的高度
-    PCIMAGE pSrcImg,       // 源 IMAGE 对象指针
-    int srcX,              // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
-    int srcY,              // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);
-// 绘制图像到另一图像(拉伸)
-void putimage(
-    PIMAGE pDstImg,        // 目标 IMAGE 对象指针
-    int dstX,              // 绘制位置的 x 坐标
-    int dstY,              // 绘制位置的 y 坐标
-    int dstWidth,          // 绘制的宽度
-    int dstHeight,         // 绘制的高度
-    PCIMAGE pSrcImg,       // 源 IMAGE 对象指针
-    int srcX,              // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
-    int srcY,              // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
-    int srcWidth,          // 绘制内容在源 IMAGE 对象中的宽度
-    int srcHeight,         // 绘制内容在源 IMAGE 对象中的高度
-    DWORD dwRop = SRCCOPY  // 三元光栅操作码（详见备注）
-);

+
+// 绘制图像到窗口
+void putimage(
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    PCIMAGE imgSrc,         // 要绘制的 IMAGE 对象指针
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);
+
+// 绘制图像到(指定宽高)
+void putimage(
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    int widthDest,          // 绘制的宽度
+    int heightDest,         // 绘制的高度
+    PCIMAGE imgSrc,         // 要绘制的 IMAGE 对象指针
+    int xSrc,               // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc,               // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);
+
+// 绘制图像到窗口(拉伸)
+void putimage(
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    int widthDest,          // 绘制的宽度
+    int heightDest,         // 绘制的高度
+    PCIMAGE imgSrc,         // 要绘制的 IMAGE 对象指针
+    int xSrc,               // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc,               // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc,           // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc,          // 绘制内容在源 IMAGE 对象中的高度
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);
+
+// 绘制图像到另一图像
+void putimage(
+    PIMAGE imgDest,         // 目标 IMAGE 对象指针
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    PCIMAGE imgSrc,         // 源 IMAGE 对象指针
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);
+
+// 绘制图像到另一图像(指定宽高)
+void putimage(
+    PIMAGE imgDest,         // 目标 IMAGE 对象指针
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    int widthDest,          // 绘制的宽度
+    int heightDest,         // 绘制的高度
+    PCIMAGE imgSrc,         // 源 IMAGE 对象指针
+    int xSrc,               // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
+    int ySrc,               // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);
+
+// 绘制图像到另一图像(拉伸)
+void putimage(
+    PIMAGE imgDest,         // 目标 IMAGE 对象指针
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    int widthDest,          // 绘制的宽度
+    int heightDest,         // 绘制的高度
+    PCIMAGE imgSrc,         // 源 IMAGE 对象指针
+    int xSrc,               // 绘制内容在源 IMAGE 对象中的左上角 x 坐标
+    int ySrc,               // 绘制内容在源 IMAGE 对象中的左上角 y 坐标
+    int widthSrc,           // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc,          // 绘制内容在源 IMAGE 对象中的高度
+    DWORD dwRop = SRCCOPY   // 三元光栅操作码（详见备注）
+);

 参数：
 
 （详见各重载函数原型内的注释）
@@ -89,19 +92,19 @@
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+

 
值含义
DSTINVERT绘制出的像素颜色 = NOT 窗口颜色
MERGECOPY绘制出的像素颜色 = 图像颜色 AND 当前填充颜色
MERGEPAINT绘制出的像素颜色 = 窗口颜色 OR (NOT 图像颜色)
NOTSRCCOPY绘制出的像素颜色 = NOT 图像颜色
NOTSRCERASE绘制出的像素颜色 = NOT (窗口颜色 OR 图像颜色)
PATCOPY绘制出的像素颜色 = 当前填充颜色
PATINVERT绘制出的像素颜色 = 窗口颜色 XOR 当前填充颜色
PATPAINT绘制出的像素颜色 = 窗口颜色 OR ((NOT 图像颜色) OR 当前填充颜色)
SRCAND绘制出的像素颜色 = 窗口颜色 AND 图像颜色
SRCCOPY绘制出的像素颜色 = 图像颜色
SRCERASE绘制出的像素颜色 = (NOT 窗口颜色) AND 图像颜色
SRCINVERT绘制出的像素颜色 = 窗口颜色 XOR 图像颜色
SRCPAINT绘制出的像素颜色 = 窗口颜色 OR 图像颜色
+
DSTINVERT      绘制出的像素颜色 = NOT 窗口颜色
MERGECOPY      绘制出的像素颜色 = 图像颜色 AND 当前填充颜色
MERGEPAINT     绘制出的像素颜色 = 窗口颜色 OR (NOT 图像颜色)
NOTSRCCOPY     绘制出的像素颜色 = NOT 图像颜色
NOTSRCERASE    绘制出的像素颜色 = NOT (窗口颜色 OR 图像颜色)
PATCOPY        绘制出的像素颜色 = 当前填充颜色
PATINVERT      绘制出的像素颜色 = 窗口颜色 XOR 当前填充颜色
PATPAINT       绘制出的像素颜色 = 窗口颜色 OR ((NOT 图像颜色) OR 当前填充颜色)
SRCAND         绘制出的像素颜色 = 窗口颜色 AND 图像颜色
SRCCOPY        绘制出的像素颜色 = 图像颜色
SRCERASE       绘制出的像素颜色 = (NOT 窗口颜色) AND 图像颜色
SRCINVERT      绘制出的像素颜色 = 窗口颜色 XOR 图像颜色
SRCPAINT       绘制出的像素颜色 = 窗口颜色 OR 图像颜色
 

 
 注：1. AND / OR / NOT / XOR 为布尔位运算。2. "窗口颜色"指绘制所经过的窗口像素点的颜色。3. "图像颜色"是指通过 IMAGE 对象中的图像的颜色。4. "当前填充颜色"是指通过 setfillstyle 设置的用于当前填充的颜色。5. 查看全部的三元光栅操作码请详见：三元光栅操作码。
diff --git a/man/api/img/putimage_alphablend.htm b/man/api/img/putimage_alphablend.htm
index ae12bbde..2d0abe78 100644
--- a/man/api/img/putimage_alphablend.htm
+++ b/man/api/img/putimage_alphablend.htm
@@ -9,39 +9,41 @@
 
 功能：
 
-对两张图片进行半透明混合，并把混合结果写入目标图片。
+对两张图像进行透明混合，并将混合结果写入目标图像。
 
 声明：
 
int putimage_alphablend(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    unsigned char alpha,      // 透明度值
-    int nXOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
+    PIMAGE imgDest,       // 目标图像
+    PCIMAGE imgSrc,       // 源图像
+    int xDest,            // 绘制位置的 x 坐标
+    int yDest,            // 绘制位置的 y 坐标
+    unsigned char alpha,  // 透明度
+    int xSrc = 0,         // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc = 0,         // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc = 0,     // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc = 0     // 绘制内容在源 IMAGE 对象中的高度
 );

 参数：
-imgdest
-要进行半透明混合的目标图片，如果为 NULL 则表示操作窗口上的图片
+imgDest
+要进行半透明混合的目标图像，如果为 NULL 则表示窗口。
 
-imgsrc
-要进行半透明混合的源图片，该操作不会改变源图片
+imgSrc
+要进行半透明混合的源图像（该操作不会改变源图像）。
 
-nXOriginDest, nYOriginDest
-要开始进行混合的目标图片坐标，该坐标是混合区域的左上角
+xDest, yDest
+目标图像上要进行混合的混合区域的左上角坐标。
 
-alpha
-透明度值，如果为 0x0，表示源图片完全透明，如果为 0xFF，表示源图片完全不透明。
+alpha
+透明度，范围：0~255，共 256 个透明度级别。
+alpah = 0 时表示源图像完全透明，alpha = 255 时表示源图像完全不透明。
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
-描述要进行此操作的源图矩形区域。如果 nWidthDest 和 nHeightDest 为 0，表示操作整张图片。
+xSrc, ySrc, widthSrc, heightSrc
+描述要进行此操作的源图像矩形区域（左上角的x, y 坐标，宽度width, 高度 height ）。
+如果 widthSrc 和 heightSrc 为 0，表示操作整张图片。
 
 返回值：
 
-成功返回 0，否则返回非 0，若 imgdest 或 imgsrc 传入错误，会引发运行时异常。
+成功返回 0，否则返回非 0，若 imgDest 或 imgSrc 传入错误，会引发运行时异常。
 
 示例：
 
diff --git a/man/api/img/putimage_alphafilter.htm b/man/api/img/putimage_alphafilter.htm
index e6a906be..d419c1dd 100644
--- a/man/api/img/putimage_alphafilter.htm
+++ b/man/api/img/putimage_alphafilter.htm
@@ -13,35 +13,35 @@
 
 声明：
 
int putimage_alphafilter(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    PCIMAGE imgalpha,         // 提供透明度(alpha)值的图像
-    int nXOriginSrc,          // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc,          // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc,            // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc            // 绘制内容在源 IMAGE 对象中的高度
+    PIMAGE imgDest,    // 目标 IMAGE 对象指针
+    PCIMAGE imgSrc,    // 源 IMAGE 对象指针
+    int xDest,         // 绘制位置的 x 坐标
+    int yDest,         // 绘制位置的 y 坐标
+    PCIMAGE imgalpha,  // 提供透明度(alpha)值的图像
+    int xSrc,          // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc,          // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc,      // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc      // 绘制内容在源 IMAGE 对象中的高度
 );

 参数：
-imgdest
-要进行半透明混合的目标图片，如果为 NULL 则表示操作窗口上的图片
+imgDest
+要进行半透明混合的目标图像，如果为 NULL 则表示操作窗口上的图片
 
-imgsrc
-要进行半透明混合的源图片，该操作不会改变源图片
+imgSrc
+要进行半透明混合的源图像，该操作不会改变源图像
 
-nXOriginDest, nYOriginDest
-要开始进行混合的目标图片坐标，该坐标是混合区域的左上角
+xDest, yDest
+要开始进行混合的目标图像坐标，该坐标是混合区域的左上角
 
-imgalpha
-提供透明度(alpha)值的图像。图像中像素值不再作为颜色，而是取低 8 位(取值范围：0 到 255)做为 alpha 值。
+imgalpha
+提供 alpha 值的图像。图像中像素值不再作为颜色，而是取低 8 位(取值范围：0 到 255)作为 alpha 值。
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
-描述要进行此操作的源图矩形区域。如果 nWidthDest 和 nHeightDest 为 0，表示操作整张图片。
+xSrc, ySrc, widthSrc, heightSrc
+描述要进行此操作的源图像矩形区域。如果 widthSrc 和 heightSrc 为 0，表示操作整张图片。
 
 返回值：
 
-成功返回 0，否则返回非 0，若 imgdest 或 imgsrc 传入错误，会引发运行时异常。
+成功返回 0，否则返回非 0，若 imgDest 或 imgSrc 传入错误，会引发运行时异常。
 
 示例：
 
diff --git a/man/api/img/putimage_alphatransparent.htm b/man/api/img/putimage_alphatransparent.htm
index 1f993590..38b5b644 100644
--- a/man/api/img/putimage_alphatransparent.htm
+++ b/man/api/img/putimage_alphatransparent.htm
@@ -9,39 +9,43 @@
 
 功能：
 
-对两张图片进行透明/半透明混合，并把混合结果写入目标图片。
+对两张图片进行透明/半透明混合，并把混合结果写入目标图像。
 
 声明：
-
int putimage_alphatransparent(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    color_t crTransparent,    // 变为透明的像素颜色
-    unsigned char alpha,      // 透明度值
-    int nXOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
+
+int putimage_alphatransparent(
+    PIMAGE imgDest,         // 目标 IMAGE 对象指针
+    PCIMAGE imgSrc,         // 源 IMAGE 对象指针
+    int xDest,              // 绘制位置的 x 坐标
+    int yDest,              // 绘制位置的 y 坐标
+    color_t transparentColor,  // 变为透明的像素颜色
+    unsigned char alpha,    // 透明度值
+    int xSrc = 0,           // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc = 0,           // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc = 0,       // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc = 0       // 绘制内容在源 IMAGE 对象中的高度
 );

 参数：
-imgdest
-要进行半透明混合的目标图片，如果为NULL则表示操作窗口上的图片
 
-imgsrc
-要进行半透明混合的源图片，该操作不会改变源图片
+imgDest
+要进行半透明混合的目标图像，如果为NULL则表示操作窗口上的图片
 
-nXOriginDest, nYOriginDest
-要开始进行混合的目标图片坐标，该坐标是混合区域的左上角
+imgSrc
+要进行半透明混合的源图像，该操作不会改变源图像
 
-crTransparent
-关键色。源图片上为该颜色值的像素，将忽略，不会改写目标图片上相应位置的像素。
+xDest, yDest
+要开始进行混合的目标图像坐标，该坐标是混合区域的左上角
 
-alpha
-透明度值，如果为0x0，表示源图片完全透明，如果为0xFF，表示源图片完全不透明。
+transparentColor
+关键色。源图像上为该颜色值的像素，将忽略，不会改写目标图像上相应位置的像素。
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
-描述要进行此操作的源图矩形区域。如果nWidthDest和nHeightDest 为0，表示操作整张图片。
+alpha
+表示不透明度，范围：0~255，共 256 级，对应不透明度 0%~100%
+alpah = 0 时表示源图像完全透明，alpha = 255 时表示源图像完全不透明。
+
+xSrc, ySrc, widthSrc, heightSrc
+描述要进行此操作的源图像矩形区域（左上角的x, y 坐标，宽度width, 高度 height ）。
+如果 widthSrc 和 heightSrc 为 0，表示操作整张图片。
 
 返回值：
 
diff --git a/man/api/img/putimage_rotate.htm b/man/api/img/putimage_rotate.htm
index 21fede08..baeadd06 100644
--- a/man/api/img/putimage_rotate.htm
+++ b/man/api/img/putimage_rotate.htm
@@ -15,39 +15,39 @@
 
 
  int putimage_rotate(
-    PIMAGE imgdest,               // 目标 IMAGE 对象指针
-    PCIMAGE PIMAGE imgtexture,    // 纹理IMAGE 对象指针
-    int nXOriginDest,             // 绘制位置的 x 坐标
-    int nYOriginDest,             // 绘制位置的 y 坐标
-    float centerx,                // 旋转中心在源图像纹理坐标系上的x坐标
-    float centery,                // 旋转中心在源图像纹理坐标系上的y坐标
-    float  radian,                // 旋转弧度
-    int btransparent = 0,         // 是否允许图像透明通道
-    int alpha = -1,               // 透明度
-    int smooth = 0                // 是否进行平滑处理
+    PIMAGE imgDest,             // 目标 IMAGE 对象指针
+    PCIMAGE PIMAGE imgTexture,  // 纹理IMAGE 对象指针
+    int xDest,                  // 绘制位置的 x 坐标
+    int yDest,                  // 绘制位置的 y 坐标
+    float xCenter,              // 旋转中心在源图像纹理坐标系上的x坐标
+    float yCenter,              // 旋转中心在源图像纹理坐标系上的y坐标
+    float  radian,              // 旋转弧度
+    bool transparent = false,   // 是否使用图像透明通道
+    int alpha = -1,             // 透明度
+    int smooth = 0              // 是否进行平滑处理
 );
 
>
 参数：
-imgdest
+imgDest
 绘制的目标图像，如果为NULL则绘制到窗口
 
-imgtexture
+imgTexture
 要绘制的源图像，该操作不会改变源图像
 
-nXOriginDest, nYOriginDest
+xDest, yDest
 旋转中心在目标图像上的位置
 
-centerx, certery
+xCenter, certery
 旋转中心在源图像纹理坐标系上的位置
 
 radian
-旋转的弧度, 
+旋转的弧度,
 
-btransparent
-是否允许图像透明通道, 设置为1可以绘制带透明通道的纹理图像，设置为0时忽略图像的透明通道。
+transparentColor
+是否使用图像透明通道, 设置为1可以绘制带透明通道的纹理图像，设置为0时忽略图像的透明通道。
 
 alpha
-设置图像透明度值，如果为0x0，表示源图片完全透明，如果为0xFF，表示源图片完全不透明，-1表示不进行透明处理。
+设置图像透明度值，如果为0x0，表示源图像完全透明，如果为0xFF，表示源图像完全不透明，-1表示不进行透明处理。
 
 smooth
 是否对图像进行平滑处理。旋转后绘制出的图像可能带有锯齿，失真，为1时
diff --git a/man/api/img/putimage_rotatetransparent.htm b/man/api/img/putimage_rotatetransparent.htm
index 5bfe2633..4db68f24 100644
--- a/man/api/img/putimage_rotatetransparent.htm
+++ b/man/api/img/putimage_rotatetransparent.htm
@@ -9,70 +9,68 @@
 
 功能：
 
-将一个图像（源图像）缩放旋转后复制到目标图像上。
+将源图像缩放旋转后绘制到目标图像上。
 
 声明：
 
int putimage_rotatetransparent(
-    PIMAGE imgdest,           // 目的图像指针, NULL表示窗口
-    PCIMAGE imgsrc,            // 源图像指针
-    int xCenterDest,         // 旋转中心在目的图像的x坐标 
-    int yCenterDest,         // 旋转中心在目的图像的y坐标
-    int xCenterSrc,         // 源图像旋转中心的x坐标 
-    int yCenterSrc,         // 源图像旋转中心的y坐标
-    color_t crTransparent,    // 源图像透明背景色
-    float radian,      // 顺时针旋转角度(弧度) 
-    float zoom=1.0      // 缩放因子
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
-);

-
-
int putimage_rotatetransparent(
-    PIMAGE imgdest,           // 目的图像指针, NULL表示窗口
-    PCIMAGE imgsrc,            // 源图像指针
-    int xCenterDest,         // 旋转中心在目的图像的x坐标 
-    int yCenterDest,         // 旋转中心在目的图像的y坐标
-    int xOriginSrc,         // 源图像复制区域左上角x坐标 
-    int yOriginSrc,         // 源图像复制区域左上角y坐标
-    int widthSrc,         // 源图像复制区域宽度 
-    int heightSrc,         // 源图像复制区域高度
-    int xCenterSrc,         // 源图像旋转中心的x坐标 
-    int yCenterSrc,         // 源图像旋转中心的y坐标
-    color_t crTransparent,    // 源图像透明背景色
-    float radian,      // 顺时针旋转角度(弧度) 
-    float zoom=1.0      // 缩放因子
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
+    PIMAGE imgDest,              // 目的图像指针, NULL表示窗口
+    PCIMAGE imgSrc,              // 源图像指针
+    int xCenterDest,             // 旋转中心在目的图像的x坐标 
+    int yCenterDest,             // 旋转中心在目的图像的y坐标
+    int xCenterSrc,              // 源图像旋转中心的x坐标 
+    int yCenterSrc,              // 源图像旋转中心的y坐标
+    color_t transparentColor,    // 源图像透明背景色
+    float radian,                // 顺时针旋转角度(弧度) 
+    float zoom = 1.0f            // 缩放因子
+);
+

+
+int putimage_rotatetransparent(
+    PIMAGE imgDest,              // 目的图像指针, NULL表示窗口
+    PCIMAGE imgSrc,              // 源图像指针
+    int xCenterDest,             // 旋转中心在目的图像的x坐标 
+    int yCenterDest,             // 旋转中心在目的图像的y坐标
+    int xSrc,                    // 源图像复制区域左上角x坐标 
+    int ySrc,                    // 源图像复制区域左上角y坐标
+    int widthSrc,                // 源图像复制区域宽度 
+    int heightSrc,               // 源图像复制区域高度
+    int xCenterSrc,              // 源图像旋转中心的x坐标 
+    int yCenterSrc,              // 源图像旋转中心的y坐标
+    color_t transparentColor,    // 源图像透明背景色
+    float radian,                // 顺时针旋转角度(弧度) 
+    float zoom = 1.0f            // 缩放因子
 );

 
 
 参数：
-imgdest
-要被复制到的目标图像，如果为NULL则表示操作窗口上的图像
 
-imgsrc
-被赋值的源图像，该操作不会改变源图像内容。
+imgDest
+目标图像，如果为 NULL 则表示窗口。
+
+imgSrc
+源图像。该操作不会改变源图像内容。
 
-xCenterDest, yCenterDest
-复制后旋转中心在目标图像上的位置
+xCenterDest, yCenterDest
+旋转中心在目标图像上的对应位置
 
-xCenterSrc, yCenterSrc
+xCenterSrc, yCenterSrc
 旋转中心在源图像上的位置
 
-crTransparent
-透明背景色。源图像上为该颜色值的像素，将忽略，不会改写目标图像上相应位置的像素。
+transparentColor
+源图像上视为透明的像素颜色。源图像上为该颜色值的像素，将忽略，不会改写目标图像上相应位置的像素。
 
-xOriginSrc, yOriginSrc, widthSrc, heightSrc
-描述要进行此操作的源图像矩形区域。
+xSrc, ySrc, widthSrc, heightSrc
+源图像上要绘制的矩形区域。
 
-radian
-源图像复制时的旋转角度。单位为弧度。当此值为正时，按顺时针方向旋转。
+radian
+源图像绘制时的旋转角度。单位为弧度。当此值为正时，按顺时针方向旋转。
 
-zoom
-源图像复制时的放大倍数。
+zoom
+源图像绘制时的缩放系数。
 
 返回值：
 
-成功返回0，否则返回非0，若imgdest或imgsrc传入错误，会引发运行时异常。
+成功返回0，否则返回非0，若 imgDest 或 imgSrc 传入错误，会引发运行时异常。
 
 示例：
 
diff --git a/man/api/img/putimage_rotatezoom.htm b/man/api/img/putimage_rotatezoom.htm
index a08a8388..3757108b 100644
--- a/man/api/img/putimage_rotatezoom.htm
+++ b/man/api/img/putimage_rotatezoom.htm
@@ -9,53 +9,59 @@
 
 功能：
 
-绘制旋转后的图像
+绘制旋转后的图像。
 
 声明：
 
-
  int putimage_rotatezoom(
-    PIMAGE imgdest,               // 目标 IMAGE 对象指针
-    PCIMAGE imgtexture,           // 纹理 IMAGE 对象指针
-    int nXOriginDest,             // 绘制位置的 x 坐标
-    int nYOriginDest,             // 绘制位置的 y 坐标
-    float centerx,                // 旋转中心在源图像纹理坐标系上的x坐标
-    float centery,                // 旋转中心在源图像纹理坐标系上的y坐标
-    float radian,                 // 旋转弧度
-    float zoom,                   // 缩放倍数
-    int btransparent = 0,         // 是否允许图像透明通道
-    int alpha = -1,               // 透明度
-    int smooth = 0                // 是否进行平滑处理
+    PIMAGE  imgDest,                 // 目标 IMAGE 对象指针
+    PCIMAGE imgTexture,              // 纹理 IMAGE 对象指针
+    int   xDest,                     // 绘制位置的 x 坐标
+    int   yDest,                     // 绘制位置的 y 坐标
+    float xCenter,                   // 旋转中心在源图像纹理坐标系上的x坐标
+    float yCenter,                   // 旋转中心在源图像纹理坐标系上的y坐标
+    float radian,                    // 旋转弧度
+    float zoom,                      // 缩放倍数
+    bool  transparentColor = false,  // 是否使用图像透明通道
+    int   alpha = -1,                // 透明度
+    bool  smooth = false             // 是否进行平滑处理
 );
 

 参数：
-imgdest
+
+imgDest
 绘制的目标图像，如果为NULL则绘制到窗口
 
-imgtexture
+imgTexture
 要绘制的源图像，该操作不会改变源图像
+源图像使用纹理坐标，左上角为 (0.0, 0.0)，右下角为 (1.0, 1.0)，而不是以像素为单位
+
+xDest, yDest
+旋转中心在目标图像上的位置（像素坐标）
 
-nXOriginDest, nYOriginDest
-旋转中心在目标图像上的位置
+xCenter, certery
+旋转中心在源图像纹理坐标系上的位置。
+（源图像左上角为 (0.0, 0.0)，源图像中心为 (0.5, 0.5)，右下角为 (1.0, 1.0)
 
-centerx, certery
-旋转中心在源图像纹理坐标系上的位置
+radian
+旋转的弧度，度数大于 0 时为逆时针旋转。
 
-radian
-旋转的弧度, 逆时针为弧度增方向。
+zoom
+源图像绘制时的缩放倍数，1.0 为不缩放。
 
-btransparent
-是否允许图像透明通道, 设置为1可以绘制带透明通道的纹理图像，设置为0时忽略图像的透明通道。
+transparentColor
+是否使用图像透明通道, 设置为 true 可以绘制带透明通道的纹理图像，设置为 false 时忽略图像的透明通道。
 
-alpha
-设置图像透明度值，如果为0x0，表示源图片完全透明，如果为0xFF，表示源图片完全不透明，-1表示不进行透明处理。
+alpha
+设置图像整体透明度，如果为 0，表示源图像完全透明，如果为 256，表示源图像完全不透明。
+-1 表示不进行透明处理，相当于完全不透明。
 
-smooth
+smooth
 是否对图像进行平滑处理。旋转后绘制出的图像可能带有锯齿，失真，为1时
 
 返回值：
 
-成功返回0，否则返回非0，若imgdest或imgsrc传入错误，会引发运行时异常。
+成功返回 0 ，否则返回非 0 值，若 imgDest 或 imgTexture 传入错误，会引发运行时异常。
 
 示例：
 
diff --git a/man/api/img/putimage_transparent.htm b/man/api/img/putimage_transparent.htm
index cd15ca04..06c36558 100644
--- a/man/api/img/putimage_transparent.htm
+++ b/man/api/img/putimage_transparent.htm
@@ -9,35 +9,36 @@
 
 功能：
 
-对两张图片进行透明混合，并把混合结果写入目标图片。
+对两张图片进行透明混合，并把混合结果写入目标图像。
 
 声明：
 
int putimage_transparent(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    color_t crTransparent,    // 变为透明的像素颜色
-    int nXOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
+    PIMAGE imgDest,            // 目标 IMAGE 对象指针
+    PCIMAGE imgSrc,            // 源 IMAGE 对象指针
+    int xDest,                 // 绘制位置的 x 坐标
+    int yDest,                 // 绘制位置的 y 坐标
+    color_t transparentColor,     // 变为透明的像素颜色
+    int xSrc = 0,              // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc = 0,              // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc = 0,          // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc = 0          // 绘制内容在源 IMAGE 对象中的高度
 );

 参数：
-imgdest
-要进行透明混合的目标图片，如果为NULL则表示操作窗口上的图片
+imgDest
+要进行透明混合的目标图像，如果为NULL则表示操作窗口上的图片
 
-imgsrc
-要进行透明混合的源图片，该操作不会改变源图片
+imgSrc
+要进行透明混合的源图像，该操作不会改变源图像
 
-nXOriginDest, nYOriginDest
-要开始进行混合的目标图片坐标，该坐标是混合区域的左上角
+xDest, yDest
+要开始进行混合的目标图像坐标，该坐标是混合区域的左上角
 
-crTransparent
-关键色。源图片上为该颜色值的像素，将忽略，不会改写目标图片上相应位置的像素。
+transparentColor
+关键色。源图像上为该颜色值的像素，将忽略，不会改写目标图像上相应位置的像素。
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
-描述要进行此操作的源图矩形区域。如果nWidthDest和nHeightDest 为0，表示操作整张图片。
+xSrc, ySrc, widthSrc, heightSrc
+描述要进行此操作的源图像矩形区域（左上角的x, y 坐标，宽度width, 高度 height ）。
+如果 widthSrc 和 heightSrc 为 0，表示操作整张图片。
 
 返回值：
 
diff --git a/man/api/img/putimage_withalpha.htm b/man/api/img/putimage_withalpha.htm
index 2524b43c..ea0ff12a 100644
--- a/man/api/img/putimage_withalpha.htm
+++ b/man/api/img/putimage_withalpha.htm
@@ -9,50 +9,57 @@
 
 功能：
 
-绘制带透明通道的图像
+绘制带透明通道的图像。
+
 
 声明：
 
int putimage_withalpha(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    int nXOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc = 0,      // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc = 0,        // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc = 0        // 绘制内容在源 IMAGE 对象中的高度
-);

+    PIMAGE imgDest,     // 目标 IMAGE 对象指针
+    PCIMAGE imgSrc,     // 源 IMAGE 对象指针
+    int xDest,          // 绘制位置的 x 坐标
+    int yDest,          // 绘制位置的 y 坐标
+    int xSrc = 0,       // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc = 0,       // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc = 0,   // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc = 0   // 绘制内容在源 IMAGE 对象中的高度
+);
 
-
int putimage_withalpha(
-    PIMAGE imgdest,           // 目标 IMAGE 对象指针
-    PCIMAGE imgsrc,           // 源 IMAGE 对象指针
-    int nXOriginDest,         // 绘制位置的 x 坐标
-    int nYOriginDest,         // 绘制位置的 y 坐标
-    int nWidthDest,           // 绘制内容在目标 IMAGE 对象中的宽度
-    int nHeightDest,          // 绘制内容在目标 IMAGE 对象中的高度
-    int nXOriginSrc,          // 绘制内容在 IMAGE 对象中的左上角 x 坐标
-    int nYOriginSrc,          // 绘制内容在 IMAGE 对象中的左上角 y 坐标
-    int nWidthSrc,            // 绘制内容在源 IMAGE 对象中的宽度
-    int nHeightSrc            // 绘制内容在源 IMAGE 对象中的高度
-);

+int putimage_withalpha(
+    PIMAGE imgDest,     // 目标 IMAGE 对象指针
+    PCIMAGE imgSrc,     // 源 IMAGE 对象指针
+    int xDest,          // 绘制位置的 x 坐标
+    int yDest,          // 绘制位置的 y 坐标
+    int widthDest,      // 绘制内容在目标 IMAGE 对象中的宽度
+    int heightDest,     // 绘制内容在目标 IMAGE 对象中的高度
+    int xSrc,           // 绘制内容在 IMAGE 对象中的左上角 x 坐标
+    int ySrc,           // 绘制内容在 IMAGE 对象中的左上角 y 坐标
+    int widthSrc,       // 绘制内容在源 IMAGE 对象中的宽度
+    int heightSrc,      // 绘制内容在源 IMAGE 对象中的高度
+    bool smooth = false // 是否进行平滑处理
+);
+

 参数：
-imgdest
-要进行半透明混合的目标图片，如果为NULL则表示操作窗口上的图片
+imgDest
+要进行半透明混合的目标图像，如果为NULL则表示操作窗口上的图片
 
-imgsrc
-要进行半透明混合的源图片，该操作不会改变源图片
+imgSrc
+要进行半透明混合的源图像，该操作不会改变源图像
 
-nXOriginDest, nYOriginDest
-要开始进行混合的目标图片坐标，该坐标是混合区域的左上角
+xDest, yDest
+要开始进行混合的目标图像坐标，该坐标是混合区域的左上角
 
-nWidthDest, nHeightDest
+widthDest, heightDest
 要开始进行混合的目标矩形区域大小
 
-alpha
-透明度值，如果为0x0，表示源图片完全透明，如果为0xFF，表示源图片完全不透明。
+alpha
+范围：0~255，对应不透明度 0~100%，如果为 0，表示源图像完全透明，如果为 255，表示源图像完全不透明。
+
+xSrc, ySrc, widthSrc, heightSrc
+描述要进行此操作的源图像矩形区域（左上角的x, y 坐标，宽度width, 高度 height ）。
+如果 widthSrc 和 heightSrc 为 0，表示操作整张图片。
 
-nXOriginDest, nYOriginDest, nWidthDest, nHeightDest
-描述要进行此操作的源图矩形区域。如果nWidthDest和nHeightDest 为0，表示操作整张图片。
+smooth
+是否进行平滑处理。
 
 返回值：
 
diff --git a/man/api/img/savebmp.htm b/man/api/img/savebmp.htm
index bfe8e62e..93061d1a 100644
--- a/man/api/img/savebmp.htm
+++ b/man/api/img/savebmp.htm
@@ -14,13 +14,13 @@
 声明：
 
int savebmp(
     PCIMAGE  pimg,
-    LPCSTR   filename,
+    const char*   filename,
     bool     withAlphaChannel = false
 );
 
 int savebmp(
     PCIMAGE  pimg,
-    LPCWSTR  filename,
+    const wchar_t*  filename,
     bool     withAlphaChannel = false
 );
 

diff --git a/man/api/img/saveimage.htm b/man/api/img/saveimage.htm
index 44526bec..2e5b7c89 100644
--- a/man/api/img/saveimage.htm
+++ b/man/api/img/saveimage.htm
@@ -14,13 +14,13 @@
 声明：
 
int saveimage(
     PCIMAGE  pimg,
-    LPCSTR   filename,
+    const char*   filename,
     bool     withAlphaChannel = false
 );
 
 int saveimage(
     PCIMAGE  pimg,
-    LPCWSTR  filename,
+    const wchar_t*  filename,
     bool     withAlphaChannel = false
 );
 

diff --git a/man/api/img/savepng.htm b/man/api/img/savepng.htm
index bb099df2..1298e2be 100644
--- a/man/api/img/savepng.htm
+++ b/man/api/img/savepng.htm
@@ -14,13 +14,13 @@
 声明：
 
int savepng(
     PCIMAGE  pimg,
-    LPCSTR   filename,
+    const char*   filename,
     bool     withAlphaChannel = false
 );
 
 int savepng(
     PCIMAGE  pimg,
-    LPCWSTR  filename,
+    const wchar_t*  filename,
     bool     withAlphaChannel = false
 );
 

diff --git a/man/api/input/key_msg.htm b/man/api/input/key_msg.htm
index ae357215..4de4cf0b 100644
--- a/man/api/input/key_msg.htm
+++ b/man/api/input/key_msg.htm
@@ -27,7 +27,7 @@
 	值含义
 	key_msg_down按键按下消息。
 	key_msg_up按键弹起消息。
-	key_msg_char(ege20.08 起)键盘字符输入消息。
+	key_msg_char(20.08 起)键盘字符输入消息。
 
 
 key
@@ -39,7 +39,7 @@
 	值含义
 	key_flag_shift		同时按下了 Shift 键
 	key_flag_ctrl		同时按下了 Ctrl  键
-	key_flag_first_down(ege dev)按键按下后发送的第一个按下消息(按键长按时，利用此标志位可以将其与后面连续发送的按下消息区分开)
+	key_flag_first_down(24.04)按键按下后发送的第一个按下消息(按键长按时，利用此标志位可以将其与后面连续发送的按下消息区分开)
 
 
 示例：
diff --git a/man/api/macro/index.htm b/man/api/macro/index.htm
index 5d29c24c..1cc2e4c5 100644
--- a/man/api/macro/index.htm
+++ b/man/api/macro/index.htm
@@ -12,7 +12,14 @@
 
+在这种情况下 <ege.h> 将不会包含 <windows.h>，以尽量减少出现在智能提示列表中的 Windows API 定义数量。
+
+
+
+
+
+

 
预定义常量（宏）说明最低版本要求

 
EGE_FOR_AUTO_CODE_COMPLETETION_ONLY当该常量被定义时,表示当前是 IDE 为了智能提示功能，正在解析 ege.h 文件获取相关定义。
-在这种情况下 <ege.h> 将不会包含 <windows.h>，以尽量减少出现在智能提示列表中的 Windows API 定义数量。 ege dev 
 24.04 
EGE_VERSIONEGE 版本(字符串，格式为 "YY.0M.Patch"(年份.月份.修订)，当 Patch 为 0 时使用 "YY.0M"。
+（取年份后两位，月份不足两位时补 0) 24.04 
EGE_VERSION_MAJOREGE 主版本号（取年份后两位） 24.04 
EGE_VERSION_MINOREGE 次版本号（月份不足两位时补 0） 24.04 
EGE_VERSION_PATCHEGE 修订版本号 24.04 
EGE_VERSION_NUMBEREGE 版本号(十进制整数类型，等于 10000 * major + 100 * minor + patch) 24.04 
EGE_MAKE_VERSION_NUMBER(major, minor, patch)由 major, minor, patch 生成对应的版本号 24.04 

 

 注：最低版本要求中的 ege dev 为 GitHub 开发版本，尚未正式发布。
 
diff --git a/man/api/math/index.htm b/man/api/math/index.htm
index 4e2b9d17..4d910a32 100644
--- a/man/api/math/index.htm
+++ b/man/api/math/index.htm
@@ -19,7 +19,7 @@
 VECTOR3D::operator -		三维向量减法										
 VECTOR3D::operator *		与浮点数相乘时为向量缩放，与向量相乘时为点乘		
 VECTOR3D::operator &		向量叉乘											
-VECTOR3D::GetAngel			计算两个三维向量的夹角								
+VECTOR3D::GetAngle			计算两个三维向量的夹角								
 VECTOR3D::GetModule		计算三维向量的模									
 VECTOR3D::GetSqrModule>	计算三维向量模的平方								
 VECTOR3D::Rotate			三维向量绕另一任意向量旋转，或者按指定旋转角旋转	
diff --git a/man/api/other/index.htm b/man/api/other/index.htm
index df7110f9..aab22921 100644
--- a/man/api/other/index.htm
+++ b/man/api/other/index.htm
@@ -11,7 +11,7 @@
 
-
+
diff --git a/man/api/other/inputboxgetline.htm b/man/api/other/inputboxgetline.htm
index e7a3931e..f6bc47d0 100644
--- a/man/api/other/inputboxgetline.htm
+++ b/man/api/other/inputboxgetline.htm
@@ -12,8 +12,8 @@
 使用对话框让用户输入一个字符串
 
 声明：
-
int inputbox_getline(LPCSTR  title, LPCSTR  text, LPSTR  buf, int len);
-int inputbox_getline(LPCWSTR title, LPCWSTR text, LPWSTR buf, int len);

+
int inputbox_getline(const char*  title, const char*  text, LPSTR  buf, int len);
+int inputbox_getline(const wchar_t* title, const wchar_t* text, LPWSTR buf, int len);
参数：
 title
 对话框标题
diff --git a/man/api/time/ege_sleep.htm b/man/api/time/ege_sleep.htm
index 3038e970..61921c61 100644
--- a/man/api/time/ege_sleep.htm
+++ b/man/api/time/ege_sleep.htm
@@ -5,22 +5,22 @@
 
 
-
ҳ-⺯Ŀ¼-ʱ亯-ege_sleep
+
主页-＞库函数目录-＞时间函数-＞ege_sleep
 
-ܣ
-ӳԺΪλʱ,ˢ´ڵĹܡ
+功能：
+至少延迟以毫秒为单位的时间,不具有刷新窗口的功能。
 
-
+声明：
 
void ege_sleep(long Milliseconds);

-
+参数：
 Milliseconds
-Ҫӳٵʱ䣬ԺΪλ
+要延迟的时间，以毫秒为单位
 
-ֵ
-ޣ
+返回值：
+（无）
 
-ʾ
-ޣ
+示例：
+（无）
 
 
 

diff --git a/man/index.htm b/man/index.htm
index 5594c537..6a25a202 100644
--- a/man/index.htm
+++ b/man/index.htm
@@ -7,7 +7,7 @@
 
 
 

-
EGE (Easy Graphics Engine) 20.08

+
EGE (Easy Graphics Engine) 24.04

 
 
作者：misakamm

 


 
函数或类型说明最低版本要求

 
getfps						获取当前窗口刷新率（FPS = Frame Per Second）	
getHDC						获取 EGE 后台缓冲区的设备上下文句柄			ege 20.08
getHDC						获取 EGE 后台缓冲区的设备上下文句柄			20.08

 
getHWnd						获取 EGE 图形窗口的句柄						

 
getHInstance			获取主进程实例句柄								

 
attachHWND				依附窗口