batik详解

在java平台中所有的绘图，都通过Graphics2D抽象类，这个类提供象drawRect，fillRect，drawString这样的方法。对于每个类型的输出这个抽象类都有指定的执行，比如屏幕或者打印机。SVGGraphics2D是这个接口的一个新的执行生成SVG内容，以用来替代画到屏幕或者打印机上。

SVGGraphics2D 拥有以下特性:
1.它允许应用程序输出图形到SVG格式
2.它输出图形到svg格式，不需要修改任何图形代码
3。它提供用户使用DOMApi操作生成文档的能力

以上图形显示生成器是怎样用DOMAPI工作的。W3C已经定义了一个API用来显示带有java对象的XML内容。这个API允许程序员在内存中操作，创建或者修改XML内容。DOMAPI包含象document，Element，Attr的接口，这些接口等价于java语言中的XML documents, elements 和attributes。

生成器管理一个DOM对象树用来显示相应于SVGGraphics2D实例的svg内容。换句话说，每次一个程序调用一个绘图方法，比如fillRect，在一个SVGGraphics2D实例中，一个新的DOM对象，描绘等价SVG，被添加到DOM树中。举个例子，一个矩形元素将在fillrect方法调用后被添加。

程序员使用这个生成器，可以存储DOM树到更深层的操作，或者可以直接写内容到一个输出流中，就象我们下面选项中看到的那样。

怎样使用SVGGraphics2D

从上面部分的描述我们可以看到为了使用一个SVGGraphics2D实例来构建SVG内容，一个文档类实例是必须的。DOM树是svg文档的内存内表现，它可以被用户使用DOMAPI深入操作，或者通过一个Write对象，流输出。下面的例子证明怎么从java图形中怎么生成SVG内容

import java.awt.Rectangle;
import java.awt.Graphics2D;
import java.awt.Color;
import java.io.Writer;
import java.io.OutputStreamWriter;
import java.io.IOException;

import org.apache.batik.svggen.SVGGraphics2D;
import org.apache.batik.dom.GenericDOMImplementation;

import org.w3c.dom.Document;
import org.w3c.dom.DOMImplementation;

public class TestSVGGen {

    public void paint(Graphics2D g2d) {
        g2d.setPaint(Color.red);
        g2d.fill(new Rectangle(10, 10, 100, 100));
    }

    public static void main(String[] args) throws IOException {

        // Get a DOMImplementation.
        DOMImplementation domImpl =
            GenericDOMImplementation.getDOMImplementation();

        // Create an instance of org.w3c.dom.Document.
        String svgNS = "http://www.w3.org/2000/svg";
        Document document = domImpl.createDocument(svgNS, "svg", null);

        // Create an instance of the SVG Generator.
        SVGGraphics2D svgGenerator = new SVGGraphics2D(document);

        // Ask the test to render into the SVG Graphics2D implementation.
        TestSVGGen test = new TestSVGGen();
        test.paint(svgGenerator);

        // Finally, stream out SVG to the standard output using
        // UTF-8 encoding.
        boolean useCSS = true; // we want to use CSS style attributes
        Writer out = new OutputStreamWriter(System.out, "UTF-8");
        svgGenerator.stream(out, useCSS);
    }
}

我们可以看到在我们的TestSVGGen实例中生成SVG内容包括三个步骤：

1.创建一个org.w3c.dom.Document实例，以便生成器用来构建它的XML内容，并且使用Document实例创建一个SVG生成器

 // Get a DOMImplementation.
        DOMImplementation domImpl =
            GenericDOMImplementation.getDOMImplementation();

        // Create an instance of org.w3c.dom.Document.
        String svgNS = "http://www.w3.org/2000/svg";
        Document document = domImpl.createDocument(svgNS, "svg", null);

        // Create an instance of the SVG Generator.
        SVGGraphics2D svgGenerator = new SVGGraphics2D(document);

2.调用SVG生成器上的描绘代码。在我们的例子中，我们调用了TestSVGGen的paint方法

// Ask the test to render into the SVG Graphics2D implementation.
        TestSVGGen test = new TestSVGGen();
        test.paint(svgGenerator);

3.流输出svg内容。svg生成器可以流输出它的内容到任意的java.io.Writer中。在我们的例子中，我们流输出内容到标准的输出流中

        // Finally, stream out SVG to the standard output using
        // UTF-8 encoding.
        boolean useCSS = true; // we want to use CSS style attributes
        Writer out = new OutputStreamWriter(System.out, "UTF-8");
        svgGenerator.stream(out, useCSS);

svg有两种方式来指定风格属性，比如填充颜色，显示属性或者CSS类型属性。useCss 参数允许用户使用这个属性