ege图形库基本说明.docx

EGE基本说明

本库是一个类似graphics.h的BGI图形库，使用方法相当接近，所以学习过TC图形的话会很容易上手
基本使用方法几乎和TC的一样，只要#include "graphics.h"就可以了
本图形库目前支持VC6, VC2008, VC2010等IDE，同时也支持MinGW编译器和使用MinGW编译器的IDE（如Code::Blocks，C-Free，Dev-CPP，eclipse for C/C++）
在graphics.h头文件的最顶处有相关的说明，并且附带较详细的pdf文档

●为什么要写这个库？

许多学编程的都是从 C 语言开始入门的，而目前的现状是：

1. 有些学校以 Turbo C 为环境讲 C 语言，只是 Turbo C 的环境实在太老了，复制粘贴都很不方便。
2. 有些学校直接拿 VC 来讲 C 语言，因为 VC 的编辑和调试环境都很优秀，并且 VC 有适合教学的免费版本。可惜在 VC 下只能做一些文字性的练习题，想画条直线画个圆都很难，还要注册窗口类、建消息循环等等，初学者会受严重打击的。初学编程想要绘图就得用 TC，很是无奈。
3. 还有计算机图形学，这门课程的重点是绘图算法，而不是 Windows 编程。所以，许多老师不得不用 TC 教学，因为 Windows 绘图太复杂了，会偏离教学的重点。新的图形学的书有不少是用的 OpenGL，可是门槛依然很高。

所以，我想给大家一个更好的学习平台，就是 VC 方便的开发平台和 TC 简单的绘图功能，于是就有了这个库。如果您刚开始学 C 语言，或者您是一位教 C 语言的老师，再或者您在教计算机图形学，那么这个库一定会让您兴奋的。
另外：这个库不是为了给你直接移植BGI图形代码用的，直接移植多半是不能通过编译的。
如果真需要移植，请做相应的修改，或者使用高兼容性的ege老版本图形库

●本图形库的优点：
★绘图效率较好，特别在批量绘图模式下，640*480的半透明混合，可以直接使用 getpixel / putpixel 完成，
并且可以在大约1.5G CPU台式机器上达到60fps（要优化，否则一般的家用机再强也不行）
★灵活性更强，绘图可以直接针对一个PIMAGE，不必只能画在屏幕上
★功能更多，支持拉伸贴图，支持透明半透明贴图，支持图像模糊滤镜操作，
可以用对话框函数进行图形化的输入
★面向动画编程和游戏编程做了功能增强，可以方便地对帧率进行准确的控制
★附带简单的3D矢量运算函数和类，便于3D计算

★支持读写多种格式图片，支持读取bmp, jpg, png, gif，支持保存为bmp和png
★支持GUI模式编程

●简要安装说明
把include/graphics.h文件，复制到你的编译器安装目录下的include目录内
再把lib目录下的文件，复制到你的编译器安装目录下的lib目录内，具体编译器所依赖的文件情况：
VC6: graphics.lib
VS2008: graphics08.lib graphics08d.lib
VS2010: graphics08.lib graphics10d.lib
MinGW: libgraphics.a

●简要使用说明

目前模拟了绝大多数 BGI 的绘图函数。使用上，基本和 TC / BC 没太大区别。看一个画圆的例子吧：

#include "graphics.h" // 引用ege图形库
int main()
{
initgraph(640, 480); // 初始化，显示一个窗口，这里和 TC 略有区别
circle(200, 200, 100); // 画圆，圆心(200, 200)，半径 100
getch(); // 暂停一下等待用户按键
closegraph(); // 关闭图形界面
return 0;
}

呵呵，很简单吧。

●详细安装和使用方法，请看本文档的安装部分。
如果遇到问题，请直接在“ege娘”贴吧发主题帖子吧。
官方联系邮箱：misakamm[at]gmail[dot]com

EGE安装

点这里查看视频教程帖子，以下是文件说明：

●简要安装说明
首先把压缩包里include目录下所有文件，复制到你的编译器安装目录下的include目录内，不管是哪个编译器
比如，vc2008的include路径类似“Microsoft Visual Studio 9.0\VC\include”，
而lib路径类似“Microsoft Visual Studio 9.0\VC\lib”，vc2010和2008一样。
vc6的话，是“Microsoft Visual Studio\VC98\Include”和“Microsoft Visual Studio\VC98\Lib”
然后再把lib目录下对应编译器名目录下的文件，复制到你的编译器安装目录下的lib目录内。比如你的是vc6，那就把\lib\vc6\下的复制过去。

如果你还是不明白复制到哪里，那请看这个表达：
copy "include\*.*" to "Microsoft Visual Studio 9.0\VC\include\"
copy "lib\*.*" to "Microsoft Visual Studio 9.0\VC\lib\"
前面的"include\*.*"是安装包里的文件

复制了这些文件后，就已经安装完成了。
然后，如果是VC或者VS，那么要建立一个工程
以下是VC6的操作步骤（但VS2008/VS2010/VS2012也类似），请按以下步骤做：
打开VC6后，新建一个Win32 Console工程（菜单->文件->新建），如下图：

右上角的工程名字写你喜欢的名字，其下方选择你要建立的工程的目录
点确定后，在弹出的对话框里选择“一个空工程”，然后直接点完成。
然后再次新建，不过这次新建一个C++ Source File，见下图：

右边文件名写你喜欢建立的名字，然后点确定，就可以开始编写代码了。

最后，请编写如下测试代码检测你的设置是否正确：
#include <graphics.h>
int main()
{
initgraph(640, 480);
setcolor(GREEN);
line(100, 100, 500, 200);
getch();
closegraph();
return 0;
}

然后，按F7键，或者点菜单上的Build（组建）来编译并链接，如果没有错误，就可以按F5运行了。

好了，为什么说VS2008和VS2010也类似呢？看看如下VS2008的截图你就明白了：

后面建立文件的时候，在左侧的General就能找到C++源文件了。如果你的是中文版，那就细心找找吧，不难找的。
至于VS2010的就不截图了，因为几乎和VS2008一样。

至于在MinGW下的编译问题，会麻烦一些，如果你懂使用命令行编译，那么需要用如下指令编译：
g++ yourfile.cpp -lgraphics -lgdi32 -limm32 -lmsimg32 -lole32 -loleaut32 -lwinmm -luuid -mwindows
其中yourfile.cpp是你要编译的cpp文件

如果你使用的是IDE，那就要看那个IDE是如何设置的，这里无法一一列举，
主要需要设置两样东西：
一是建立Win32 Application工程（目的是让它以-mwindows来编译，这个选项很重要）
二是要添加链接库
需要加入graphics, gdi32, imm32, msimg32, ole32, oleaut32, winmm, uuid共8个

例如在Code::Blocks下（需要建立project），在菜单 - Project - build options，设置Linker选项，如图：

例如在C-Free5.0下，则可以在 菜单->构建->构建选项 里，设置连接选项，如图：

但是，如果你是以建立工程的方式建立，而不是建立单文件的话，
或者你发现上面的设置无效，那你需要在菜单 - 工程 - 设置，在这设置连接选项

此外，C-Free比较特殊的一点是，如果需要编译为Win32应用程序，那么要用WinMain来声明你的主函数，如：
#include <graphics.h>
int WinMain() // 这里在graphics.h里已经定义了宏自动把它展开成合法的声明，以减免声明的麻烦，同时用来欺骗C-Free
{
initgraph(640, 480);
getch();
closegraph();
return 0;
}

又或者，如果你不喜欢这样，那就在链接选项里（即刚刚截图里的参数框里）手工加上-mwindows也可

使用预览

　　使用上，基本和 Turbo C 没太大区别。启动 Visual C++6.0，
创建一个控制台项目（Win32 Console Application），选择空项目，

然后新建"C++ Source File"项，

然后在那个cpp里写代码就行了。
看一个画圆的例子吧：
#include "graphics.h" // 就是需要引用这个图形库
int main()
{
initgraph(640, 480); // 初始化为640*480大小的窗口，这里和TC 略有区别
circle(200, 200, 100); // 画圆，圆心(200, 200)，半径100
getch(); // 等待用户按键，按任意键继续
closegraph(); // 关闭图形界面
return 0;
}

　　呵呵，很简单吧。
　　不过还是有不少区别的，比如颜色上，TC 只有 16 色，而这个库支持了真彩色。
还有，这个库增加了鼠标、键盘扩展、双缓冲、批量绘图、读取图片（点阵或矢量）等功能。
　　另外，如果你希望运行时完全不带控制台窗口，如果在VC下，默认就是去掉控制台窗口。
但如果你需要显示出来的话，你可以把#define SHOW_CONSOLE写在#include "graphics.h"的前面，例如：
#define SHOW_CONSOLE
#include "graphics.h"
int main()
{
initgraph(640, 480);
getch();
closegraph();
return 0;
}

但，如果你用的是CFree，那把main改成WinMain即可实现控制台窗口的隐藏，如下替换一下即可：
#include "graphics.h"
int WinMain() // 这里在graphics.h里已经定义了宏自动把它展开成合法的声明，以减免声明的麻烦
{
initgraph(640, 480);
getch();
closegraph();
return 0;
}

当然，你在VC上也直接这样写也可以，因为也会自动帮你替换回main，所以直接写WinMain可以两边通用。

关于本EGE图形库

相关信息：
作者：misakamm
Blog：http://blog.misakamm.org
Mail：misakamm[at]gmail[dot]com

更新历史：
13.03
★画圆/椭圆/弧函数增加浮点版本
★填充函数增加按颜色区域填充（类似画图的油漆桶功能）
★修正IMAGE初始化背景色不是纯黑色
★修正第二次initgraph的状态错误
★源代码结构细调，抽离数据结构实现

13.02
★图形效率优化
★getch特殊键响应不正常修正
★修正keystate状态错误

13.01
★对mouse_msg友好化

12.12
★增加putimage_withalpha
★修正ege_puttexture贴图bug

12.11
★增加对VC2012的支持
★发布文件分类方式调整

12.08
★delay_fps/delay_jfps增加浮点帧率支持
★修正文档已知错误

12.06
★新增函数xyprintf/rectprintf
★修正png处理alpha为0的像素的方案
★修正对带alpha的图片的贴图支持
★增加离线示例和在线示例
★vs2010编译错误修正
★rgb2gray函数修正

12.05
★inputbox_getline函数修正
★mousemove消息参数修正
★增加发布包中的示例

12.04
★库函数调整较大，去除所有大写字母开头的函数，旧程序基本都需要改动才能正常编译
★mingw编译参数有变，增加链接库msimg32
★不允许使用IMAGE，全部改用PIMAGE，使用newimage/delimage构造和删除
★颜色全部统一为ARGB格式，不要使用宏RGB，要用EGERGB代替（否则红蓝颠倒）
★增加带aa的绘图
★增加渐变填充
★增加纹理概念，增加简单的纹理贴图
★修正若干bugs（主要的是鼠标移动消息参数不正确）
★文档增加动画示例
★增加支持64位静态库（仅vc9/vc10）
★去除原有的编译警告
★增加部分函数过时警告，不屏蔽vs的过时警告
★示例代码更新及增加
★增加邮件列表通讯讨论

12.03 stable 稳定版 svn89
★调整版本命名方式（年.月，像12.03即12年三月发布）
★调整编译参数
★默认标题风格调整
★源代码目录结构调整

2012年：
0107：
★对objc++编译做兼容
★部分函数风格调整
★增加控件button（未完善，测试版）

2011年：
0724：
★Bug修正
★解决在vs2010下编译不正确的问题
★fix 在 linux wine下窗口移动困难的问题

0602：
★增加GUI
★修正部分png读取错误
★调整getkey函数，增加配对的kbmsg函数
★增加getmouse函数
★增加setcaption函数
★版本更新为20110602 V1.0.1 Beta

0520：
★调整头文件，以使兼容性更好，减少链接出错
★GetFPS函数去掉参数
★版本更新为20110520 V0.3.8 Release

0416：
★增加png图片格式的读写函数（读取仍然用getimage，保存用savepng）
★增加压缩解压函数（ege_compress/ege_uncompress/ege_uncompress_size）
★版本更新为20110416 V0.3.8 Beta

0414：
★修正拖动时，窗口可能会漂移的问题
★重绘效率优化
★增加 INIT_LOCKWINDOW
★批量绘图函数改名为窗口锁定函数（WindowLock/WindowUpdate/WindowUnlock），原函数仍然能使用
★IMAGE 类增加 getdc 接口以便GDI操作（仅可用于Blt操作其它操作慎用）
★VC6库改用/MT编译以便多线程编程
★版本更新为20110414 V0.3.7 Release

0401：
★增加drawlines和drawbezier函数，优化drawpoly的效率
★增加对设置为屏幕保护程序的支持
★增加安装程序
★增加WM_MOUSEWHEEL宏定义以防在VC6上编译出错
★文档更新
★版本更新为20110401 V0.3.6 Release

0321：
★更名为EGE，取代原EGE（Easy Graphics Engine）库
★增加旋转缩放贴图函数（接口还可能变化，暂不推荐使用）
★增加窗口尺寸自动修正（在分辨率变小强制窗口尺寸变小了，再变回大分辨率的时候）
★版本更新为20110321 V0.3.5 Release

0129：
★修正头文件一个类型错误的问题
★增加saveimage函数，用来保存图片（目前只支持bmp）
★版本号更新为20110129 V0.3.4 Release

2010年以前的更新记录：

1213：
★增加对基本音频播放的支持（wav, mp3, midi）
★版本号更新为20101213 V0.3.3 Release

1212：
★更新文档
★增加独立下载库和帮助文档
★版本号更新为20101207 V0.3.2 Release

1207：
★修正图形更新同步时可能偶然发生无法更新的情况
★增加setbkcolor_f函数，功能是仅设置背景颜色，
仅当调用cleardevice时才使用这个颜色一次性清除屏幕
★提升了重绘性能，并修正一个资源泄露的问题
★增加swappage函数，实现双缓冲模式

1122：
★调整GetMousePos初始化坐标
★修正鼠标滚轮坐标不正确的问题
★随机函数改用专业算法，并增加randomf函数
★增加3D数学函数
★增加3D向量类
★修正文档错误，补充没加到文档的函数
★版本号改为20101122 V0.3.1 Release

1118：
★修正了三个新贴图函数的BUG
★增加了outtextrect, setfontbkcolor
★增加了logo显示
★修正鼠标消息接收时内容不全的问题
★修正多次开关批量绘图时可能会卡死的BUG
★相应更新文档
★版本号改为20101118 V0.3.0 Release

1113：
★对imagefilter_blurring函数调整参数次序，并增加默认参数，以使其使用更方便
★优化透明，半透明贴图效率

1111：
★增加三个函数支持透明/半透明贴图(putimage_transparent, putimage_alphablend, putimage_alphatransparent)
★增加图像模糊函数(imagefilter_blurring)
★版本号改为20101111 V0.2.5 Gamma

1101：
★调整putpixels，使得效率更高一些
★修正部分绘图函数如rectangle不空心的BUG
★增加INITGRAPH宏，以便于使用全局IMAGE时，抢先初始化
★相应更新文档
★版本号改为20101101 V0.2.4 Gamma

1023：
★增加putpixels函数，便于批量画点时提升速度
★修正setbkcolor函数颜色不正确的BUG

1013：
★增加GetHInstance函数，以便作为读入资源时的参数
★调整closegraph，以便close后再次init
★修正setviewport在某个版本里误编辑的问题导致区域失效
★textwidth和textheight增加单字符版本
★修正总是隐藏控制台无法故意显示的问题
★增加KEYMSG_FIRSTDOWN，便于实现按键按下一次仅响应一次的需求
★修正相应的俄罗斯方块例子（因增加了KEYMSG_FIRSTDOWN的原因）

1010：
★增加ShowMouse函数，以控制鼠标是否隐藏
★增加对VC2005的支持（不带SP1，打了SP1的不能编译通过，其实为了更稳定建议直接用VC2008）
★增加IMAGE对象有效性检查，以便更容易发现指针错误
★相应更新文档，并修正文档中部分已发现的问题
★调整initgraph，允许二次调用，并修改窗口大小（这时原内容会擦除，但除了size和viewport以外，其它属性不变）
★修正批量画图多次调用时可能发生的死锁问题
★增加初始化IMAGE在initgraph之前会直接报错并强制关闭程序
★版本号改为20101010 V0.2.2 Gamma

0930：
★调整delay_fps，使得帧数更稳定些
★修正getch, kbhit带参数时的一些问题
★改为使用SHOW_CONSOLE才显示控制台窗口，默认不显示，详见PDF内“超简单的使用预览”
★增加getpixel_f, putpixel_f，为原函数的加速版（但调用时有风险，但其实原来的已经足够快，现在的已经快不了多少）
★增加API_Sleep函数用于调用原来的原版Sleep函数
★增加delay_jfps用于自动控制跳帧（跳多少看流畅程度，如果绘图不复杂计算量少，一般不会跳）
★GetFPS函数增加一个可选参数，以便得到实际绘图帧率（在跳帧模式下）
★增加一些方便在CFree下编程的特性，如WinMain，详见PDF内“超简单的使用预览”
★基本完成pdf，并加入了几个比较好的程序源代码，包含一个俄罗斯方块程序
★版本名改为20101001 V0.2 Gamma

0928：
★前一次修改后对效率的调整和优化
★修正InputBoxGetLine, getch, GetMouseMsg的BUG
★调整延迟函数的逻辑，使得在相同帧率下能更流畅
★增加fclock函数
★增加mingw3.4.5编译器使用的静态库，即能支持在CFree下编译
★增加pdf格式的说明文档（测试版，部分函数还没有补充完成）
★版本名改为0.2 Beta

0926：
★大幅修改，使程序不会因为鼠标拖动而停下
★即使不调用delay族函数也会更新窗口，只是并不流畅，所以如果你想要流畅动画，推荐手工调用delay族函数
★增加GetFPS函数，可以随时获取当前帧率
★GetLineInputBox 更名为 InputBoxGetLine，以便于增加类似InputBoxGetNumber时，相同前缀容易查找
★getch和kbhit改为宏，以防与conio.h库冲突，当包含conio.h时，会自动忽略
★版本名改为0.2 Alpha
注：delay族函数在graphics.h头文件的最顶处有相关的说明，就是指Sleep, delay, delay_ms, delay_fps, getch, GetMouseMsg

0923：
★修正getch的行为，以保持非特殊按键键码与CRT(C Run-Time)的getch一致

0922：
★增加GetLineInputBox在图形界面下进行字符串输入，使用回车确认输入，ESC取消输入（输入为空）
★扩展getch和kbhit函数，使得能根据参数把按键放开的事件也能取得，两个函数需要组合使用

0921：
★增加void setinitmode(int mode, int x = CW_USEDEFAULT, int y = CW_USEDEFAULT)
第一个参数mode=0为普通窗口，1为无边框窗口，xy是初始窗口坐标，mode为1时，用于方便全屏模式
此函数必须在initgraph前调用，否则无效
★initgraph函数，若窗口大小均指定为-1,-1，则使用屏幕大小，用于方便全屏，全屏后可用getwidth和getheight取得窗口大小
★VC下使用HIDE_CONSOLE可以使控制台窗口彻底消失，使用方法如下：
#define HIDE_CONSOLE
#include "graphics.h"
要注意的是，#define HIDE_CONSOLE必须在graphics.h的前面
★改为Beta版本

0920：
★修正若干BUG

0918：
★第一版发布测试