Navigation Menu

Skip to content

DLTech21/TouchVG

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

关于 TouchVG

TouchVG 是一个主要由C++开发的轻量级2D矢量绘图框架,可在 iOS、Android、Windows 等多个平台构建矢量绘图应用。

作者:张云贵 rhcad@hotmail.com 开源协议:LGPL 2.1,见 LICENSE 文件描述。

TouchVG 的功能

支持多点触摸或鼠标的交互绘图方式,可以无级放缩或平移显示矢量图形、图像、SVG

高性能绘图、快速手绘光滑曲线形状,在 iOS 上支持 CALayer 后台渲染和动态并行渲染,在 Android 上支持 SurfaceView 异步渲染。

除了基本的15余种矢量图形类型外,可使用C++或Java等来扩充更多的图形类型。

除了基本的20余种选择和绘图命令外,还可使用C++、Java等扩充更多的交互命令。

可以交互式修改图形的线宽、颜色等属性,可以进行放缩变形、克隆等图形操作。

支持JSON等格式的图形序列化操作,允许扩充XML、数据库等其他序列化适配器。

导出 SVG 矢量格式图片、PNG 透明背景图片。

无限步 Undo/Redo 记忆,轻数据量的矢量录屏。

支持多模块的扩展机制,可构建数字教育、动态几何、图文笔记等多种行业绘图模块。

更多说明将在TouchVG的 在线文档 中补充。

引用的开源框架

Larva Labs 的 Android SVG 解析框架 svg-android (Apache License 2.0)。

iOS SVG 解析框架 SVGKit (MIT)。

用于输出 SVG 的简易框架 simple-svg (BSD-3)。

用于跨语言转换的 SWIG,用此工具生成粘合代码。

iOS静态库模板 iOS-Universal-Library-Template

JSON 解析和输出框架 rapidjson (MIT)。

GCC编译脚本 x3py (Apache License 2.0)。

算法:圆弧和Bezier曲线最近点计算三次Bezier范围计算两圆求交点点线位置判断

意见和建议

在您使用 TouchVG 的过程中有任何意见和建议,请到此项目 提交Issue

捐款

如果您在使用后感到满意,或者希望增加特别的功能,请为TouchVG项目捐款,以支持作者不断完善此项目。

Android编译说明

在 eclipse 中导入此项目下的所有工程,运行 VGTest 或 vgdemo1 工程可看演示效果。

可能需要根据实际安装情况修改工程的SDK版本号。

建议使用较新的 ADT Bundle,省掉了eclipse和ADT的安装配置麻烦事。

可以将 democmds 改为你的应用库工程(例如使用UltraEdit保持大小写全文替换,并替换文件名), 该工程包含 democmds.jar 和 libdemocmds.so(本地库)。在此增加自己的图形类和命令类,这样就不需要改动 TouchVG 内核了。

不写C++代码、不要democmds也行,参考 android/test/src/vgtest/testview/shape包写自己的图形和命令吧。

如需重新生成 libtouchvg.so 和 libdemocmds.so,则进入此项目的 android 目录,运行 ./build.sh (需要将NDK安装位置加到PATH环境变量,以便使用 ndk-build)。

使用NDK-r8c以后的版本如果出现 build/gmsl/__gmsl:512: *** non-numeric second argument to wordlist function 错误, 则打开 NDK 安装目录下的 build/gmsl/__gmsl 文件,将512行改为: int_encode = $(__gmsl_tr1)$(wordlist 1,$(words $1),$(__gmsl_input_int))

如果是在Windows上编译,推荐使用 MSYS(Unix模拟环境工具)、TDM-GCC(一种MinGW发行版)。

如需重新生成内核JNI类,则运行 ./build.sh -swig (需要安装SWIG,并将SWIG位置加到 PATH 环境变量)。

iOS编译说明

在 Xcode 中打开 ios/TestVG.xcworkspace 文件,运行 TestView 演示程序。

该程序有两个编译目标项,TestView 不支持SVG的显示,使用 libTouchVG.a;TestView-SVG 使用 SVGKit 库显示SVG图形,使用 libTouchVG-SVG.a。

所需的多个静态库有两种编译方式:

进入此项目的 ios 目录,运行./build.sh(需要配置Xcode命令行环境,以便使用 xcodebuild)自动编译所有静态库到 ios/output 目录下。 在 Xcode 集成开发环境中分别选择相应的库工程编译。

在真机上调试时需要修改主程序的Bundle Identifier,例如“com.yourcompany.TestView”,并选择自己的开发证书(Code Signing)。

可以将 DemoCmds 改为你的应用库工程(例如使用UltraEdit保持大小写全文替换,并替换文件名), 增加自己的图形类和命令类,这样就不需要改动 TouchVG 内核了。

WPF编译说明

在 Visual Studio 2010 中打开 wpf/Test_cs10.sln,运行 WpfDemo 工程。VS2008则打开 wpf/Test_cs9.sln

如需重新生成内核类(编译 Swig Files 下的 touchvg.swig 或 democmds.i),需要安装 SwigWin,并将SWIG解压位置加到 PATH 环境变量。

其他编译说明

还可在Linux、MinGW、Mac OS X下编译静态库,或为 Python、Perl、Java 等应用编译动态库。

进入core目录,该目录下有 Makefile 文件,运行下列 make 指令:

make all install:编译C++静态库。

make java:为Java程序生成Jar包和动态库。

make pythonmake perl:分别为Python、Perl等生成类文件和动态库。

make clean java.clean python.clean:删除上述编译出的临时文件。

如果是在Windows上编译,推荐使用 MSYS(Unix模拟环境工具)、TDM-GCC(一种MinGW发行版)。

About

A lightweight 2D vector drawing framework using C++ for iOS, Android and Windows. 支持多点触摸的矢量绘图框架.

Resources

License

Stars

Watchers

Forks

Packages

No packages published