Skia简介以及在Windows下编译操作步骤

Skia是一个C++的开源2D向量图形处理函数库(Cairo是一个矢量库),包括字型、坐标转换、位图等等,相当于轻量级的Cairo,目前主要用于Google的Android和Chrome平台,Skia搭配OpenGL/ES与特定的硬件特征,强化显示的效果。另外,Skia是WebKit支持的众多图形平台之一,在WebKit的GraphicsContext.h/.c中有相关实现。

Android与Chrome的源代码库中都有一份Skia的复制,因需求不同,做了部分的修改。

Skia需要的底层库有:freetype2,expat,tinyxml。

可以用svn从Google下载源码:svncheckout http://skia.googlecode.com/svn 。

Skia的头文件以及库函数接口是以C++实现的。

代码结构,src目录下:

(1)、animator目录:用来实现Skia的动画效果,Android不支持;

(2)、core目录:Skia的核心,基本都是一些图形绘制函数;

(3)、effects目录:实现一些图形图像的特效效果,包括遮罩、浮雕、模糊、滤镜、渐变色、离散、透明等,并且实现了PATH的各种特效;

(4)gl目录:实现了Skia的图形库,Skia调用OpenGL或OpenGL ES来实现一些简单的3D效果;

(5)、images目录:用来处理images的,支持常见图像的解码、部分图像的编码和动画。Skia能处理的图像类型包括:BMP、JPEG/PVJPEG、PNG、ICO、SkMovie处理gif动画;

(6)、ports目录:是Skia的一些接口在不同系统上的实现,平台相关的代码,比如字体、线程、时间等。这些与Skia的接口,需要针对不同的操作系统实现;

(7)、svg目录:实现了Skia对矢量图SVG的支持,Android不支持;

(8)、utils目录:一些辅助工具类;

(9)、views目录:Skia构建了一套界面UI库;

(10)、xml目录:处理xml的数据,Skia在这里只是对xml解析器做了一层包装,具体的xml解析器的实现需要根据不同的操作系统及宿主程序来实现;

(11)、opts目录:性能优化的代码;

(12)、pdf目录:处理PDF文档,用了一个fpdfemb库;

Skia主要使用的第三方库:Zlib、Jpeglib、Pnglib、giflib、fpdfemb(处理pdf文档)。

Skia引擎在android源代码当中的位置:(1)、头文件:android/external/skia/include,其中还包含几个子目录:animotor,core,effects,images,views,…;(2)、源文件位于:android/external/skia/src目录,子目录结构和头文件目录相同;(3)、封装层:android对Skia引擎进行了封装,以便让java代码方便的调用,对Skia封装的代码存在于android/framework/base/core/jni以及android/framework/base/core/jni/android/graphics目录下面。在Android中Skia以扩展库的形式存在,目录为external/skia。

Skia本身是一个opensource的project,集成于android系统中。所以Skia不是android框架的一部分,不需要实现框架的api来支持Skia。不过Skia同样可以挂接其它的第3方编码解码库或者硬件编解码库。

Android版本不同,Skia版本也不太相同,接口有些细微的差别。

Skia主要包含三个库:(1)、libcorecg.so:包含/skia/src/core的部分内容,比如其中的Region,Rect是在SurfaceFlinger里面用来计算可视区域的;(2)、libsgl.so:包含/skia/src/core|effects|images|ports|utils的部分和全部内容,这个实现了skia大部分的图形效果,以及图形格式的编解码;(3)、libskiagl.so:包含/skia/src/gl里面的内容,主要用来调用opengl实现部分效果。

Skia对上层的接口:Skia的源文件及部分头文件都在external/skia/src目录下,导出的头文件在external/skia/include目录下。最主要的是SKCanvas类,几乎整个AndroidGUI系统的底层绘制都是由这个类来完成的。SKCanvas类主要有三种绘制功能:(1)、基本图形绘制(如drawARGB,drawLine函数);(2)、图像文件绘制(如drawBitmap函数);(3)、文本绘制(drawText函数)。

Skia的图像编解码部分:(1)、/include/image/SKImageDecoder.h:把图像文件或者流解码到skia的内部内存SKBitmap中;(2)、/include/image/SKImageEncoder.h :把skia内部内存SKBitmap编码成文件或流的形式。这些接口需要具体的类实现,主要代码在src/image文件中。

Skia引擎重要类:(1)、SkCanvas:Skia引擎的一个核心类,它封装了所有对设备进行的画图操作.

Skia中用到的硬件加速技术:(1)、OpenGL/OpenGLES;(2)、SIMD:SSE2/SSSE3,NEON.

 

Skia在Windows下的编译:

1、   从https://www.python.org/download/releases/2.7.8/下载python-2.7.8.amd64.msi并安装;安装到D:\ProgramFiles\Python27目录下,并将D:\ProgramFiles\Python27添加到环境变量Path中,重启电脑;

2、    从 https://cygwin.com/install.html 下载setup-x86_64.exe 并安装;

3、   使用svn,下载gyp: http://gyp.googlecode.com/svn/trunk, 将整个gyp文件夹存放到/trunk_no_commit/third_party/externals文件夹下;

4、   在其它分支中将jsoncpp、jsoncpp-chromium、libjpeg、libwebp四个文件夹内容全部拷贝到/trunk_no_commit/third_party/externals文件夹下;

5、   打开Cygwin,将其切换到Skia的trunk_no_commit目录下,执行 python gyp_skia,会生成一个out文件夹,里面有生成的skia.sln工程;

6、   如果在执行python gyp_skia命令过程中,提示/third_party/externals/libwebp/src/dec/frame.c 等文件丢失,则从相关网站下载最新代码替换之即可。

7、   (1)、如果出现errorC2220:warning treated as error -no ‘object’ file generated,则将相应工程中的C/C++->General:Treat Warning As Errors,由原来的Level3(/W3)改为No(/WX-),如effects、gm工程;(2)、选中gm/verttext.cpp文件->File->AdvancedSave Options->Encoding:由原来的Unicode(UTF-8 without signature)-Codepage 65001改为ChineseSimplified(GB2312)-Codepage 936;(3)、如果third_party/extternal中的第三方库文件编译时与其它源代码不匹配,可以通过改动gyp文件夹下的相应.gyp文件来做相应的调整;

8、   通过svn http://skia.googlecode.com/svn下载所有相应的Skia源码,包括branchestrunk,下载后发现没有trunk,只有trunk_no_commit

9、   打开Cygwin,将其定位到trunk_no_commit文件夹,执行 python gyp_skia 命令,如果出现Warning: Missing input files相关信息,说明缺少相关文件,则根据提示查找原因,否则在后期编译时会报错;

10、 正确执行完pythongyp_skia命令后,会在trunk_no_commit目录下生成out文件夹,打开里面的skia.sln,编译SampleApp工程,会生成SampleApp.exe和其它相应静态库。

11、仿照tests工程新创建一个TestSkia工程,工程设置及代码如下:

(1)、Debug和Release下,Character Set:Use Unicode Character Set;

(2)、C/C++ ->Additional Include Directories:

E:\Skia\code\google\trunk_no_commit\include
E:\Skia\code\google\trunk_no_commit\include\animator
E:\Skia\code\google\trunk_no_commit\include\config
E:\Skia\code\google\trunk_no_commit\include\core
E:\Skia\code\google\trunk_no_commit\include\device\xps
E:\Skia\code\google\trunk_no_commit\include\effects
E:\Skia\code\google\trunk_no_commit\include\gpu
E:\Skia\code\google\trunk_no_commit\include\gpu\gl
E:\Skia\code\google\trunk_no_commit\include\images
E:\Skia\code\google\trunk_no_commit\include\pathops
E:\Skia\code\google\trunk_no_commit\include\pdf
E:\Skia\code\google\trunk_no_commit\include\pipe
E:\Skia\code\google\trunk_no_commit\include\ports
E:\Skia\code\google\trunk_no_commit\include\record
E:\Skia\code\google\trunk_no_commit\include\svg
E:\Skia\code\google\trunk_no_commit\include\text
E:\Skia\code\google\trunk_no_commit\include\utils
E:\Skia\code\google\trunk_no_commit\include\utils\win
E:\Skia\code\google\trunk_no_commit\include\views
E:\Skia\code\google\trunk_no_commit\include\views\animated
E:\Skia\code\google\trunk_no_commit\include\xml
E:\Skia\code\google\trunk_no_commit\tools
(3)、C/C++ -> Preprocessor: 

Debug:

WIN32
_DEBUG
_CONSOLE
SK_INTERNAL
SK_GAMMA_SRGB
SK_GAMMA_APPLY_TO_A8
SK_SCALAR_TO_FLOAT_EXCLUDED
SK_ALLOW_STATIC_GLOBAL_INITIALIZERS=1
SK_SUPPORT_GPU=1
SK_SUPPORT_OPENCL=0
SK_FORCE_DISTANCEFIELD_FONTS=0
SK_SCALAR_IS_FLOAT
SK_CAN_USE_FLOAT
SK_BUILD_FOR_WIN32
_CRT_SECURE_NO_WARNINGS
GR_GL_FUNCTION_TYPE=__stdcall
SK_BUILD_JSON_WRITER
SK_SUPPORT_PDF
SK_DEBUG
SK_DEVELOPER=1

Release:

WIN32
NDEBUG
_CONSOLE
SK_INTERNAL
SK_GAMMA_SRGB
SK_GAMMA_APPLY_TO_A8
SK_SCALAR_TO_FLOAT_EXCLUDED
SK_ALLOW_STATIC_GLOBAL_INITIALIZERS=1
SK_SUPPORT_GPU=1
SK_SUPPORT_OPENCL=0
SK_FORCE_DISTANCEFIELD_FONTS=0
SK_SCALAR_IS_FLOAT
SK_CAN_USE_FLOAT
SK_BUILD_FOR_WIN32
_CRT_SECURE_NO_WARNINGS
GR_GL_FUNCTION_TYPE=__stdcall
SK_BUILD_JSON_WRITER
SK_SUPPORT_PDF
SK_RELEASE

(4)、Linker -> Input -> Additional Dependencies:

OpenGL32.lib
usp10.lib
DelayImp.lib
windowscodecs.lib

(5)、将trunk_no_commit->tools->flags中的SkCommandLineFlags两个文件拷贝到此测试工程下并加入到工程中;

(6)、stdafx.h:

#pragma once

#include "targetver.h"

#include <stdio.h>

#include "SkCanvas.h"
#include "SkData.h"
#include "SkDocument.h"
#include "SkForceLinking.h"
#include "SkGraphics.h"
#include "SkSurface.h"
#include "SkImage.h"
#include "SkStream.h"
#include "SkString.h"

#include "SkCommandLineFlags.h"

(7)、stdafx.cpp:

#include "stdafx.h"

// TODO: reference any additional headers you need in STDAFX.H
// and not in this file
#ifdef _DEBUG
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/experimental.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libetc1.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libjpeg.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libwebp_dec.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libwebp_dsp.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libwebp_enc.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/libwebp_utils.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/lua.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/skflate.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/lib/views_animated.lib")

	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_animator.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_core.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_effects.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_images.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_opts.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_opts_ssse3.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_pdf.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_ports.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_sfnt.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_skgpu.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_skgputest.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_utils.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_views.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Debug/skia_xml.lib")
#else
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/experimental.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libetc1.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libjpeg.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libwebp_dec.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libwebp_dsp.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libwebp_enc.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/libwebp_utils.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/lua.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/skflate.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/lib/views_animated.lib")

	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_animator.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_core.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_effects.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_images.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_opts.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_opts_ssse3.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_pdf.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_ports.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_sfnt.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_skgpu.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_skgputest.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_utils.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_views.lib")
	#pragma comment(lib, "E:/Skia/code/google/trunk_no_commit/out/Release/skia_xml.lib")
#endif

(8)、TestSkia.cpp:

#include "stdafx.h"
#include <iostream>

using namespace std;

__SK_FORCE_IMAGE_DECODER_LINKING;

DEFINE_string2(outFile, o, "skhello", "The filename to write the image.");
DEFINE_string2(text, t, "Hello", "The string to write.");

static void doDraw(SkCanvas* canvas, const SkPaint& paint, const char text[]) 
{
	SkRect bounds;
	canvas->getClipBounds(&bounds);

	canvas->drawColor(SK_ColorWHITE);
	canvas->drawText(text, strlen(text), bounds.centerX(), bounds.centerY(), paint);
}

static bool do_surface(int w, int h, const char path[], const char text[], const SkPaint& paint) 
{
	SkAutoTUnref<SkSurface> surface(SkSurface::NewRasterPMColor(w, h));
	doDraw(surface->getCanvas(), paint, text);

	SkAutoTUnref<SkImage> image(surface->newImageSnapshot());
	SkAutoDataUnref data(image->encode());
	if (NULL == data.get()) {
		return false;
	}
	SkFILEWStream stream(path);
	return stream.write(data->data(), data->size());
}

static bool do_document(int w, int h, const char path[], const char text[], const SkPaint& paint) 
{
	SkAutoTUnref<SkDocument> doc(SkDocument::CreatePDF(path));
	if (doc.get()) {
		SkScalar width = SkIntToScalar(w);
		SkScalar height = SkIntToScalar(h);
		doDraw(doc->beginPage(width, height, NULL), paint, text);
		return true;
	}
	return false;
}

int tool_main(int argc, char** argv) 
{
	SkCommandLineFlags::SetUsage("");
	SkCommandLineFlags::Parse(argc, argv);

	SkAutoGraphics ag;
	SkString path("skhello");
	SkString text("Hello");

	if (!FLAGS_outFile.isEmpty()) {
		path.set(FLAGS_outFile[0]);
	}
	if (!FLAGS_text.isEmpty()) {
		text.set(FLAGS_text[0]);
	}

	SkPaint paint;
	paint.setAntiAlias(true);
	paint.setTextSize(SkIntToScalar(30));
	paint.setTextAlign(SkPaint::kCenter_Align);

	SkScalar width = paint.measureText(text.c_str(), text.size());
	SkScalar spacing = paint.getFontSpacing();

	int w = SkScalarRoundToInt(width) + 30;
	int h = SkScalarRoundToInt(spacing) + 30;

	static const struct {
		bool (*fProc)(int w, int h, const char path[], const char text[],
			const SkPaint&);
		const char* fSuffix;
	} gRec[] = {
		{ do_surface, ".png" },
		{ do_document, ".pdf" },
	};

	for (size_t i = 0; i < SK_ARRAY_COUNT(gRec); ++i) {
		SkString file;
		file.printf("%s%s", path.c_str(), gRec[i].fSuffix);
		if (!gRec[i].fProc(w, h, file.c_str(), text.c_str(), paint)) {
			return -1;
		}
	}
	return 0;
}

int main(int argc, char* argv[])
{
	int flag = tool_main(argc, (char**) argv);

	if (flag == 0)
		cout<<"ok"<<endl;
	else 
		cout<<"error"<<endl;

	return 0;
}

运行此工程,会在此工程目录下生成 skhello.pdf 和 skhello.png 两个文件,文件内容为Hello


你可能感兴趣的:(Skia简介以及在Windows下编译操作步骤)