web-dev-qa-db-ja.com

SVGドキュメントをロードして解析する方法

バックグラウンド

SVGパスの読み取りと解析に関連する未回答の質問がいくつかあります。

問題

SVG path要素には データ属性d)が含まれています。 SVGファイルからパス情報のみをロード、解析、抽出する必要がある場合があります。

質問

SVGファイルからSVGパス情報をどのようにロード、解析、抽出しますか?

15
Dave Jarvis

概観

Apache Batik を使用してSVGファイルをロードして解析します。ソリューションは、SVGファイルをMetaPostに変換する準備段階のJavaコードを示しています。これにより、Javaを使用してSVGファイルからコンテンツをロード、解析、および抽出する方法の一般的なアイデアが提供されます。

図書館

次のライブラリが必要です。

_batik-anim.jar
batik-awt-util.jar
batik-bridge.jar
batik-css.jar
batik-dom.jar
batik-ext.jar
batik-gvt.jar
batik-parser.jar
batik-script.jar
batik-svg-dom.jar
batik-svggen.jar
batik-util.jar
batik-xml.jar
xml-apis-ext.jar
_

SVGファイルをロード

メインアプリケーションはSVGファイルをDOMに読み込み、DOMをSVG DOMに変換します。 initSVGDOM()メソッド呼び出しは非常に重要です。 initSVGDOM()を呼び出さないと、DOMからSVG DOM要素を抽出するメソッドは使用できません。

_import Java.io.File;
import Java.io.IOException;

import Java.net.URI;

import org.Apache.batik.bridge.BridgeContext;
import org.Apache.batik.bridge.DocumentLoader;
import org.Apache.batik.bridge.GVTBuilder;
import org.Apache.batik.bridge.UserAgent;
import org.Apache.batik.bridge.UserAgentAdapter;
import org.Apache.batik.dom.svg.SAXSVGDocumentFactory;
import org.Apache.batik.dom.svg.SVGOMSVGElement;
import org.Apache.batik.util.XMLResourceDescriptor;

import org.w3c.dom.Document;
import org.w3c.dom.NodeList;


/**
 * Responsible for converting all SVG path elements into MetaPost curves.
 */
public class SVGMetaPost {
  private static final String PATH_ELEMENT_NAME = "path";

  private Document svgDocument;

  /**
   * Creates an SVG Document given a URI.
   *
   * @param uri Path to the file.
   * @throws Exception Something went wrong parsing the SVG file.
   */
  public SVGMetaPost( String uri ) throws IOException {
    setSVGDocument( createSVGDocument( uri ) );
  }

  /**
   * Finds all the path nodes and converts them to MetaPost code.
   */
  public void run() {
    NodeList pathNodes = getPathElements();
    int pathNodeCount = pathNodes.getLength();

    for( int iPathNode = 0; iPathNode < pathNodeCount; iPathNode++ ) {
      MetaPostPath mpp = new MetaPostPath( pathNodes.item( iPathNode ) );
      System.out.println( mpp.toCode() );
    }
  }

  /**
   * Returns a list of elements in the SVG document with names that
   * match PATH_ELEMENT_NAME.
   * 
   * @return The list of "path" elements in the SVG document.
   */
  private NodeList getPathElements() {
    return getSVGDocumentRoot().getElementsByTagName( PATH_ELEMENT_NAME );
  }

  /**
   * Returns an SVGOMSVGElement that is the document's root element.
   * 
   * @return The SVG document typecast into an SVGOMSVGElement.
   */
  private SVGOMSVGElement getSVGDocumentRoot() {
    return (SVGOMSVGElement)getSVGDocument().getDocumentElement();
  }

  /**
   * This will set the document to parse. This method also initializes
   * the SVG DOM enhancements, which are necessary to perform SVG and CSS
   * manipulations. The initialization is also required to extract information
   * from the SVG path elements.
   *
   * @param document The document that contains SVG content.
   */
  public void setSVGDocument( Document document ) {
    initSVGDOM( document );
    this.svgDocument = document;
  }

  /**
   * Returns the SVG document parsed upon instantiating this class.
   * 
   * @return A valid, parsed, non-null SVG document instance.
   */
  public Document getSVGDocument() {
    return this.svgDocument;
  }

  /**
   * Enhance the SVG DOM for the given document to provide CSS- and SVG-specific
   * DOM interfaces.
   * 
   * @param document The document to enhance.
   * @link http://wiki.Apache.org/xmlgraphics-batik/BootSvgAndCssDom
   */
  private void initSVGDOM( Document document ) {
    UserAgent userAgent = new UserAgentAdapter();
    DocumentLoader loader = new DocumentLoader( userAgent );
    BridgeContext bridgeContext = new BridgeContext( userAgent, loader );
    bridgeContext.setDynamicState( BridgeContext.DYNAMIC );

    // Enable CSS- and SVG-specific enhancements.
    (new GVTBuilder()).build( bridgeContext, document );
  }

  /**
   * Use the SAXSVGDocumentFactory to parse the given URI into a DOM.
   * 
   * @param uri The path to the SVG file to read.
   * @return A Document instance that represents the SVG file.
   * @throws Exception The file could not be read.
   */
  private Document createSVGDocument( String uri ) throws IOException {
    String parser = XMLResourceDescriptor.getXMLParserClassName();
    SAXSVGDocumentFactory factory = new SAXSVGDocumentFactory( parser );
    return factory.createDocument( uri );
  }

  /**
   * Reads a file and parses the path elements.
   * 
   * @param args args[0] - Filename to parse.
   * @throws IOException Error reading the SVG file.
   */
  public static void main( String args[] ) throws IOException {
    URI uri = new File( args[0] ).toURI();
    SVGMetaPost converter = new SVGMetaPost( uri.toString() );
    converter.run();
  }
}
_

注:initSVGDOM()の呼び出しは、特に指定がない限り、Batikのデフォルトの動作です。悲しいかな、そうではありません。この宝石を発見するということは、彼らのウェブサイトで documentation embedded を読むことを意味します。

SVG DOMを解析する

その場合、SVG DOMの解析は比較的簡単です。 toCode()メソッドは、クラスの主力です。

_import org.Apache.batik.dom.svg.SVGItem;
import org.Apache.batik.dom.svg.SVGOMPathElement;

import org.w3c.dom.Node;
import org.w3c.dom.svg.SVGPathSegList;

/**
 * Responsible for converting an SVG path element to MetaPost. This
 * will convert just the bezier curve portion of the path element, not
 * its style. Typically the SVG path data is provided from the "d" attribute
 * of an SVG path node.
 */
public class MetaPostPath extends MetaPost {
  private SVGOMPathElement pathElement;

  /**
   * Use to create an instance of a class that can parse an SVG path
   * element to produce MetaPost code.
   *
   * @param pathNode The path node containing a "d" attribute (output as MetaPost code).
   */
  public MetaPostPath( Node pathNode ) {
    setPathNode( pathNode );
  }

  /**
   * Converts this object's SVG path to a MetaPost draw statement.
   * 
   * @return A string that represents the MetaPost code for a path element.
   */
  public String toCode() {
    StringBuilder sb = new StringBuilder( 16384 );
    SVGOMPathElement pathElement = getPathElement();
    SVGPathSegList pathList = pathElement.getNormalizedPathSegList();

    int pathObjects = pathList.getNumberOfItems();

    sb.append( ( new MetaPostComment( getId() ) ).toString() );

    for( int i = 0; i < pathObjects; i++ ) {
      SVGItem item = (SVGItem)pathList.getItem( i );
      sb.append( String.format( "%s%n", item.getValueAsString() ) );
    }

    return sb.toString();
  }

  /**
   * Returns the value for the id attribute of the path element. If the
   * id isn't present, this will probably throw a NullPointerException.
   * 
   * @return A non-null, but possibly empty String.
   */
  private String getId() {
    return getPathElement().getAttributes().getNamedItem( "id" ).getNodeValue();
  }

  /**
   * Typecasts the given pathNode to an SVGOMPathElement for later analysis.
   * 
   * @param pathNode The path element that contains curves, lines, and other
   * SVG instructions.
   */
  private void setPathNode( Node pathNode ) {
    this.pathElement = (SVGOMPathElement)pathNode;
  }

  /**
   * Returns an SVG document element that contains path instructions (usually
   * for drawing on a canvas).
   * 
   * @return An object that contains a list of items representing pen
   * movements.
   */
  private SVGOMPathElement getPathElement() {
    return this.pathElement;
  }
}
_

ビルド

コンパイルは環境によって異なります。次のようなスクリプトが役立ちます。

_#!/bin/bash
mkdir -p ./build
javac -cp ./lib/* -d ./build ./source/*.Java
_

すべての_.jar_ファイルを_./lib_ディレクトリに配置してください。ソースファイルを_./source_ディレクトリに配置します。

走る

プログラムを実行するスクリプト(またはバッチファイル)を作成します。

_#!/bin/bash
Java -cp ./lib/*:./build SVGMetaPost $1
_

出力

有効なSVGパスを含むファイルに対して実行すると、以下が生成されます。

_$ ./run.sh stripe/trigon.svg 
% path8078-6
M 864.1712 779.3069
C 864.1712 779.3069 868.04065 815.6211 871.4032 833.4621
C 873.4048 844.08203 874.91724 855.0544 879.0846 864.82227
C 884.24023 876.9065 895.2377 887.9899 900.0184 897.3661
C 904.7991 906.7422 907.3466 918.3257 907.3466 918.3257
C 907.3466 918.3257 892.80817 887.6536 864.1712 887.3086
C 835.53424 886.9637 820.9958 918.3257 820.9958 918.3257
C 820.9958 918.3257 823.6176 906.59644 828.32404 897.3661
C 833.0304 888.1356 844.10223 876.9065 849.2578 864.82227
C 853.4252 855.05444 854.9376 844.08203 856.93915 833.4621
C 860.3017 815.6211 864.17114 779.3069 864.17114 779.3069
z
_

ここからは、Javaを使用してSVGパスデータを対応するSVGオブジェクトに読み込む方法が明確になるはずです。

補遺

SVGから MetaPost に変換する最も簡単な方法は次のとおりです。

  1. SVGをPDFに変換します(例: Inkscape または rsvg-convert を使用))。
  2. PDF pstoedit を使用してMetaPostに変換します。
14
Dave Jarvis