原文 【译】在Asp.Net中操作PDF - iTextSharp - 绘制矢量图

在上一篇iTextSharp文章中讲述了如何将现有的图片插入PDF中并对其进行操作。但有时,你需要在PDF中绘制不依赖于任何图片文件的矢量图形。iTextSharp既包含了绘制简单矢量图功能,也包含了绘制复杂矢量图的功能。这篇文章将会帮助你入门。本系列文章之前的文章如下:

在ASP.NET中创建PDF-iTextSharp起步

在Asp.Net中操作PDF - iTextSharp - 使用字体

在Asp.Net中操作PDF – iTextSharp -利用块,短语,段落添加文本

在Asp.Net中操作PDF – iTextSharp-列表

在Asp.Net中操作PDF – iTextSharp - 使用链接和书签

在Asp.Net中操作PDF – iTextSharp - 使用表格

在Asp.Net中操作PDF – iTextSharp - 操作图片

在前面的文章所讲述的内容中,直到现在为止,所有添加到PDF文档的内容都只是依赖于将页面中的内容加入到排版流中的简单iText排版.简单的iText排版还负责如果文字内容溢出当前页面,则生成新的页面。而对于处理矢量图来说,就需要另一种方法了。那就是使用PdfContentByte()对象,这个对象的实例可以从PdfWriter对象的DirectContent属性获得.这也意味着不像前面那样仅仅是使用PdfWriter.GetInstance方法了,我们还需要获得PdfWrite类的实例:

  string pdfpath = Server.MapPath("PDFs");

  Document doc = new Document();

  try

  {

    PdfWriter writer = PdfWriter.GetInstance(doc, new FileStream(pdfpath + "/Graphics.pdf", FileMode.Create));

    doc.Open();

    PdfContentByte cb = writer.DirectContent;
...

现在我们就可以使用PdfContentByte对象来画矢量图了:

cb.MoveTo(doc.PageSize.Width / 2, doc.PageSize.Height / 2);

cb.LineTo(doc.PageSize.Width / 2, doc.PageSize.Height);

cb.Stroke();

cb.MoveTo(0, doc.PageSize.Height/2);

cb.LineTo(doc.PageSize.Width, doc.PageSize.Height / 2);

cb.Stroke();

第一行代码将光标移动到传入的X,Y坐标轴参数,也就是文档的正中间.下一行代码从当前光标的位置画一条线到传入的坐标参数点。这里就是从文档中间画一条线到文档上边。当然,这个方法还没有开始”画”这条线,这个方法仅仅是记录我们要画这条线的意图,直到调用了Stroke()方法后,这条线才能真正写入PDF文档。第二段代码从文档中间的最左边画到中间的最右边,形成了一个上面2分的文档大纲:

使用同样的方法,我们可以在文档左上的格子中加入一个正方形:

cb.MoveTo(100f, 700f);

cb.LineTo(200f, 700f);

cb.LineTo(200f, 600f);

cb.LineTo(100f, 600f);

cb.ClosePath();

cb.Stroke();

我们并没有直接指定画出正方形的最后一条边,使用ClosePath()方法可以直接从当前点画回到原点坐标.其实,我们还可以使用iTextSharp所提供的画正方形的快捷方法,下面代码展示如何利用这个快捷方法在右上方画出正方形:

cb.Rectangle(doc.PageSize.Width-200f, 600f, 100f, 100f);

cb.Stroke();

让我们继续在页面添加四个正方形,每个正方形最后都使用了不同于Stroke()的方法来将其写入文档,如果你是用过Photoshop或是firework就应该知道,实际上Stroke()其实是对象的轮廓,而Fill实际上就是对象的填充色,在这里我使用CMYK颜色,将边框颜色设置成蓝绿色,而填充颜色设置为黄色:

cb.SetColorStroke(new CMYKColor(1f, 0f, 0f, 0f));

cb.SetColorFill(new CMYKColor(0f, 0f, 1f, 0f));

cb.MoveTo(70, 200);

cb.LineTo(170, 200);

cb.LineTo(170, 300);

cb.LineTo(70, 300);

//Path closed and stroked

cb.ClosePathStroke();

cb.MoveTo(190, 200);

cb.LineTo(290, 200);

cb.LineTo(290, 300);

cb.LineTo(190, 300);

//Filled, but not stroked or closed

cb.Fill();

cb.MoveTo(310, 200);

cb.LineTo(410, 200);

cb.LineTo(410, 300);

cb.LineTo(310, 300);

//Filled, stroked, but path not closed

cb.FillStroke();

cb.MoveTo(430, 200);

cb.LineTo(530, 200);

cb.LineTo(530, 300);

cb.LineTo(430, 300);

//Path closed, stroked and filled

cb.ClosePathFillStroke();

当你使用Rectangle对象而不是手动去画矩形时,传入的第一个和第二个参数是矩形右下角的坐标,而其他两个参数分别为矩形的宽和高.iTextSharp中还包括其他矢量图,比如说圆,圆中传入的坐标则是圆心的坐标,第三个参数则为半径的大小。上面的四个正方形中不难看出正方形的边长为100像素,正方形的中心坐标则为120 x, 250 y,下面代码可以在正方形中加入一个圆:

cb.SetCMYKColorStroke(255, 255, 0, 0);

cb.SetCMYKColorFill(0, 255, 255, 0);
cb.SetLineWidth(2f); cb.Circle(120f, 250f, 50f); cb.Fill();

我猜想你是不是在想我在代码中用过的CMYK的四个参数分别代表什么。这并不直观,CMYK分别代表四种颜色所占的百分比,比如暖红色实际上是C:0%,M100%,Y100%,K100%.CMYK的构造函数需要的四个参数都为float类型,你可以传入代表着百分比的数字.我还可以传入0和1,其实传入的参数可以是任何大小的float类型,百分比实际上是几个参数的比例。所以如果我想设置成100%的蓝色(蓝绿),我可以使用3000f,0,0,0这样的参数.注意这里不要不小心多打了一个0.

SetCMYKColorFill()方法接受一个int类型的参数.我觉得可能是因为这个方法是基于百分比来设置CMYK的吧,所以对于暖红色的设置我传入了0,100,100,0,但我得到的却是一个粉色。我认为这是一个bug.是由于之前使用过一次SetCMYKColorFill()方法而影响到了这次的颜色,所以我重置了CMYK的颜色并再次实验,还是不行。最后我发现CMYKColor对象是派生于ExtendedColor类,而所能接受的最大int值为255,这和RGB有些类似,如果你不知道这个类的工作原理,那你会很迷惑。所以我按照这个进行了设置,终于得到了我想要的颜色.为了进行验证,我还传入了大于255的数字,最后发现任何大于255的数字都会被iTextSharp截断,比如256就等于1,510就等于255.至少,这是在我的测试中得到的结论.

让我们回到正题,下面的第一个正方形中放入了一个红色有着蓝色边框(2px)的圆:

接下来,让我们来看看使用iTextSharp提供的预定义的其他形状,椭圆。首先,定义一个长方形,然后将一个椭圆加入到长方形之内:

// x, y of bottom left corner, width, height

cb.Rectangle(100f, 200f, 300f, 100f);

cb.Stroke();

//Bottom left and top right coordinates

cb.Ellipse(100f, 200f, 400f, 300f);

cb.Stroke();

如果上面两个图形中第一个和第三个参数不同,第二个和第四个参数相同,最后结果会是一个圆。

接下来的代码展示如何使用另一个预定义的图形:圆角矩形.圆角矩形的构造函数分别为左下角的坐标,宽和高,以及圆角的度数。为了演示圆角矩形圆角的度数原理,我还在这个圆角矩形的左下角加入一个圆:

//Bottom left coordinates followed by width, height and radius of corners

cb.RoundRectangle(100f, 500f, 200f, 200f, 20f);

cb.Stroke();

cb.Circle(120f, 520f, 20f);

cb.Stroke();

cb.MoveTo(118f, 520f);

cb.LineTo(122f, 520f);

cb.Stroke();

cb.MoveTo(120f, 518f);

cb.LineTo(120f, 522f);

cb.Stroke();

三角形就更容易画了,只需要画三条线就好,下面代码展示了如何画一个直角三角形,并标出直角:

cb.MoveTo(350f, 450f);

cb.LineTo(350f, 600f);

cb.LineTo(500f, 450f);

cb.ClosePathStroke();

cb.MoveTo(350f, 460f);

cb.LineTo(360f, 460f);

cb.LineTo(360f, 450f);

cb.Stroke();

曲线和弧

贝塞尔曲线是矢量图中很重要的一种。这种曲线的画法是基于数学公式而不是仅仅点到点。贝塞尔曲线的画法是通过指定一个开始点,一个结束点,和两个控制点。第一个控制点产生的效果是基于开始点,第二个控制点产生的效果是基于结束点。贝塞尔曲线从开始点朝向结束点,中间的弯曲是取决于控制点。但曲线本身会很接近控制点,但不会穿过控制点,如果你使用过PhotoShop或是Firework,控制点可以理解为你进行拖拽用来控制弧度的”控键(handles)”:

下面是一个画曲线的例子,开始点设置为(200,10),结束点设置为(350,150):

//Start Point

cb.MoveTo(200f, 10f); 

//Control Point 1, Control Point 2, End Point

cb.CurveTo(150f, 30f, 450f, 70f, 350f, 150f);

cb.Stroke();

这个曲线由开始点朝向第一个控制点,并向第二个控制点弯曲,在到达结束点之前,曲线如下:

上面的图片或许并不是那么容易让人理解,所以我加上了一些”控键(handles)”:

cb.MoveTo(200f, 10f);

cb.LineTo(150f, 30f);

cb.Stroke();

cb.MoveTo(450f, 70f);

cb.LineTo(350f, 150f);

cb.Stroke();

cb.Circle(450f, 70f, 1f);

cb.Stroke();

cb.Circle(150f, 30f, 1f);

cb.Stroke();

第一个控制点的“控键(handles)”相对比较短,所以曲线仅仅朝第一个控制点弯曲了一点,第二个控制点相对较长,所以曲线在其影响下朝着第二个控制点弯曲比较多,理解这个意思的最好办法是将第二个控制点的“控键(handles)”再次延长:

cb.SetColorStroke(Color.GREEN);

//start point (x,y)

cb.MoveTo(200f, 10f);

//control point 1 (x,y), control point 2 (x,y), end point (x,y)

cb.CurveTo(150f, 30f, 550f, 100f, 350f, 150f);

cb.Stroke();

cb.MoveTo(550f, 100f);

cb.LineTo(350f, 150f);

cb.Stroke();

cb.Circle(550f, 100f, 1f);

cb.Stroke();

cb.SetColorStroke(Color.LIGHT_GRAY);

//Bottom Left(x,y), Top Right(x,y), Start Angle, Extent

cb.Arc(350f, 70f, 550f, 130f, 270f, 90f);

cb.SetLineDash(3f, 3f);

cb.Stroke();

cb.SetLineDash(0f);

cb.MoveTo(550f, 100f);

cb.LineTo(535f, 95f);

cb.Stroke();

cb.MoveTo(550f, 100f);

cb.LineTo(552f, 88f);

cb.Stroke();

原来的曲线用黑色显示.后加入的曲线用绿色显示。现在你可以看到绿色的控制点已经展示出它的影响.从开始点开始,绿色曲线开始慢慢的低于黑色曲线,然后分开.因为第二个控制点离曲线的结束点比较远,使得绿色的曲线更加的圆一些。也就是在到达终点之前朝向控制点偏离的更多一些。

对于上面展示的新添加的代码,还有其他一些需要说明的地方。其中之一就是Arc对象,这里用于画一个带箭头的从原来的控制点到新的控制点的曲线。弧是曲线的一部分.这里弧从左下角的(350,70)到右上角的(550,130).弧的度数默认是按逆时针算的。这里的弧度是270,相当于顺时针90度.除此之外,SetLineDash()方法的用途是将所画的弧线变为虚线。

-------------------------------------------

原文链接:iTextSharp - Drawing shapes and Graphics

Translate by CareySon

【译】在Asp.Net中操作PDF - iTextSharp - 绘制矢量图的更多相关文章

  1. 【译】在Asp.Net中操作PDF - iTextSharp - 利用列进行排版

    原文 [译]在Asp.Net中操作PDF - iTextSharp - 利用列进行排版 在使用iTextSharp通过ASP.Net生成PDF的系列文章中,前面的文章已经讲述了iTextSharp所涵 ...

  2. 【译】在Asp.Net中操作PDF - iTextSharp - 利用列进行排版(转)

    [译]在Asp.Net中操作PDF - iTextSharp - 利用列进行排版   在使用iTextSharp通过ASP.Net生成PDF的系列文章中,前面的文章已经讲述了iTextSharp所涵盖 ...

  3. 【译】在Asp.Net中操作PDF – iTextSharp - 操作图片

    原文 [译]在Asp.Net中操作PDF – iTextSharp - 操作图片 作为我的iTextSharp系列的文章的第七篇,开始探索使用iTextSharp在PDF中操作图片,理解本篇文章需要看 ...

  4. 【译】在Asp.Net中操作PDF – iTextSharp - 使用表格

    原文 [译]在Asp.Net中操作PDF – iTextSharp - 使用表格 使用Asp.Net生成PDF最常用的元素应该是表格,表格可以帮助比如订单或者发票类型的文档更加格式化和美观.本篇文章并 ...

  5. 【译】在Asp.Net中操作PDF – iTextSharp - 使用链接和书签

    原文 [译]在Asp.Net中操作PDF – iTextSharp - 使用链接和书签 用户和PDF文档的交互可以通过锚(链接)和书签进行,接着我前面iTextSharp的系列文章,本篇文章主要讲通过 ...

  6. 【译】在Asp.Net中操作PDF – iTextSharp -利用块,短语,段落添加文本

    原文 [译]在Asp.Net中操作PDF – iTextSharp -利用块,短语,段落添加文本 本篇文章是讲述使用iTextSharp这个开源组件的系列文章的第三篇,iTextSharp可以通过As ...

  7. 【译】在Asp.Net中操作PDF - iTextSharp - 使用字体

    原文 [译]在Asp.Net中操作PDF - iTextSharp - 使用字体 紧接着前面我对iTextSharp简介博文,iTextSharp是一个免费的允许Asp.Net对PDF进行操作的第三方 ...

  8. 在Asp.Net中操作PDF – iTextSharp - 使用表格

    使用Asp.Net生成PDF最常用的元素应该是表格,表格可以帮助比如订单或者发票类型的文档更加格式化和美观.本篇文章并不会深入探讨表格,仅仅是提供一个使用iTextSharp生成表格的方法介绍 使用i ...

  9. 在Asp.Net中操作PDF – iTextSharp - 操作图片

    iTextSharp支持所有主流的图片格式,比如:jpg, tif, gif, bmp, png和wmf.在iTextSharp中使用Image.GetInstance()方法创建图片有很多种方式,或 ...

随机推荐

  1. react的初涉入

    1.react并不是一个完整的MVC,MVVM框架 它只负责view层 2.react跟Web Components不冲突 3.react的特点是“轻” 4.react用组件的方式重新思考构建UI的过 ...

  2. Arduino 跷跷板(2016-01-04)

    前言这是参加社区活动,用赠送的 LilyPad 来做小实验,也体验了一把艺术的LilyPad!本来是申请 nano 的,不知道怎么的就出错啦,申请成 LilyPad 了,这个实验应该用 nano 比较 ...

  3. Lowest Common Multiple Plus

    Lowest Common Multiple Plus Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 65536/32768 K (Java ...

  4. GNU scientific library

    GNU scientific library 是一个强大的C,C++数学库.它涉及的面很广,并且代码效率高,接口丰富.正好最近做的一个项目中用到多元高斯分布,就找到了这个库. GNU scientif ...

  5. shell学习之变量、判断、重复动作

    1.1 环境以及变量的定义.赋值.展开.删除 export:将一个变量导入到环境中:export PATH=$PATH:/home. readonly 讲一个变量设置为只读模式,在shell脚本中定义 ...

  6. 亲测VS2010纯静态编译QT4.8.0,实现VS2010编译调试Qt程序,QtCreator静态发布程序(图文并茂,非常详细)

    下载源代码,注意一定是源码压缩包如qt-everywhere-opensource-src-4.8.0.zip,不是Qt发布的已编译的不同版本的标准库如qt-win-opensource-4.8.0- ...

  7. myeclipse部署时An internal error occurred 错误的几种情况

    myecplise上将工程部署到应用下时,经常出现 An internal error occurred during: "Add Deployment". java.lang.N ...

  8. Java调用Python脚本

    今天遇到Java调用一个Python脚本的问题,纠结了大半天,遇到各种问题.网上搜索的大部分都是用jython,但是我想要调用的python脚本里有import urllib,这个urllib也不是什 ...

  9. Python3 官方文档翻译 - 5 数据结构

    这章会更详细地描述了一些你已经学过的知识,同时添加一些新东西. 5.1 List进阶 下面是关于List的所有方法 list.append(x) 将元素添加至列表尾,相当于a[len(a):] = [ ...

  10. BZOJ 1684: [Usaco2005 Oct]Close Encounter

    题目 1684: [Usaco2005 Oct]Close Encounter Time Limit: 5 Sec  Memory Limit: 64 MB Description Lacking e ...