vhardy 2002/06/18 10:01:51
Modified: xdocs demo.xml domTutorial.xml extendingBatik.xml faq.xml
index.xml svgviewer.xml
Log:
Minor ^M issues. Modified doc to reference the browser as SVG Browser. Added new
options to svgrasterizer page.
Revision Changes Path
1.14 +45 -45 xml-batik/xdocs/demo.xml
Index: demo.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/demo.xml,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- demo.xml 17 Jun 2002 16:28:00 -0000 1.13
+++ demo.xml 18 Jun 2002 17:01:51 -0000 1.14
@@ -27,54 +27,54 @@
<s1 title="SVG Tools and Applications">
<p>The Batik distribution contains several pre-packaged demos:</p>
<ul>
- <li><link href="#SVGBrowser">SVG Browser</link></li>
- <li><link href="#SVGRasterizer">SVG
Rasterizer</link></li>
- <li><link href="#SVGPrettyPrinter">SVG Pretty
Printer</link></li>
- <li><link href="#SVGFontConverter">SVG Font
Converter</link></li>
- </ul>
-
- <anchor id="SVGBrowser" />
- <s2 title="SVG Browser">
- <ul>
- <li><link href="svgviewer.html">SVG Browser:</link>
- <ul><li>The SVG Browser lets you view SVG file, zoom, pan and
rotate in the content and select text items in the image and much more.</li></ul>
- </li>
- </ul>
- </s2>
-
- <anchor id="SVGRasterizer" />
- <s2 title="SVG Rasterizer">
- <ul>
- <li><link href="svgrasterizer.html">SVG Rasterizer:</link>
- <ul><li>The SVG Rasterizer is a utility that can convert SVG
files to a raster format.
- The tool can convert individual files or sets of files, making
it easy to convert entire
- directories of SVG files. The provided formats are JPEG, PNG,
and TIFF, however the design allows new formats to be added easily</li></ul>
- </li>
- </ul>
- </s2>
-
- <anchor id="SVGPrettyPrinter" />
- <s2 title="SVG Pretty Printer">
- <ul>
- <li><link href="svgpp.html">SVG Pretty Printer:</link>
- <ul><li>The SVG Pretty Printer lets developers "pretty-up"
+ <li><link href="#SVGBrowser">Squiggle SVG
Browser</link></li>
+ <li><link href="#SVGRasterizer">SVG
Rasterizer</link></li>
+ <li><link href="#SVGPrettyPrinter">SVG Pretty
Printer</link></li>
+ <li><link href="#SVGFontConverter">SVG Font
Converter</link></li>
+ </ul>
+
+ <anchor id="SVGBrowser" />
+ <s2 title="SVG Browser">
+ <ul>
+ <li><link href="svgviewer.html">Squiggle SVG Browser:</link>
+ <ul><li>The Squiggle SVG Browser lets you view SVG file, zoom,
pan and rotate in the content and select text items in the image and much
more.</li></ul>
+ </li>
+ </ul>
+ </s2>
+
+ <anchor id="SVGRasterizer" />
+ <s2 title="SVG Rasterizer">
+ <ul>
+ <li><link href="svgrasterizer.html">SVG Rasterizer:</link>
+ <ul><li>The SVG Rasterizer is a utility that can convert SVG
files to a raster format.
+ The tool can convert individual files or sets of files, making
it easy to convert entire
+ directories of SVG files. The supported formats are JPEG, PNG,
and TIFF, however the design allows new formats to be added easily</li></ul>
+ </li>
+ </ul>
+ </s2>
+
+ <anchor id="SVGPrettyPrinter" />
+ <s2 title="SVG Pretty Printer">
+ <ul>
+ <li><link href="svgpp.html">SVG Pretty Printer:</link>
+ <ul><li>The SVG Pretty Printer lets developers "pretty-up"
their SVG files and get their tabulations and other cosmetic
parameters in order. It
- can also be used to modify the DOCTYPE declaration
on SVG files.</li></ul>
- </li>
- </ul>
- </s2>
-
- <anchor id="SVGFontConverter" />
- <s2 title="SVG Font Converter">
- <ul>
- <li><link href="ttf2svg.html">SVG Font Converter:</link>
- <ul><li>The SVG Font Converter lets developers convert
+ can also be used to modify the DOCTYPE declaration
on SVG files.</li></ul>
+ </li>
+ </ul>
+ </s2>
+
+ <anchor id="SVGFontConverter" />
+ <s2 title="SVG Font Converter">
+ <ul>
+ <li><link href="ttf2svg.html">SVG Font Converter:</link>
+ <ul><li>The SVG Font Converter lets developers convert
character ranges from the True Type Font format to the SVG Font
format to embed in
SVG documents. This allows SVG document to be fully self-contained
be rendered
- exactly the same on all systems</li></ul>
- </li>
+ exactly the same on all systems</li></ul>
+ </li>
</ul>
- </s2>
+ </s2>
</s1>
</body>
1.7 +35 -35 xml-batik/xdocs/domTutorial.xml
Index: domTutorial.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/domTutorial.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- domTutorial.xml 17 Jun 2002 16:28:00 -0000 1.6
+++ domTutorial.xml 18 Jun 2002 17:01:51 -0000 1.7
@@ -31,23 +31,23 @@
The <link href="http://www.w3.org/dom/";>Document Object Model</link> (DOM)
is an API for XML documents. It defines the logical structure of documents and
the way a document is accessed and manipulated. This paper shows how to create
-an SVG document using the DOM API.
+an SVG document using the DOM API.
</p>
-
- <ul>
- <li><link href="#gettingStarted">Getting started</link></li>
- <li><link href="#creating">Creating a Document</link></li>
- <li><link href="#buildsvgdoc">Building an SVG Document</link></li>
- <li><link href="#createdocfromsvgfile">Creating a Document from an
SVG file</link></li>
- <li><link href="#rendering">Rendering an SVG DOM</link></li>
-
- </ul>
+
+ <ul>
+ <li><link href="#gettingStarted">Getting started</link></li>
+ <li><link href="#creating">Creating a Document</link></li>
+ <li><link href="#buildsvgdoc">Building an SVG Document</link></li>
+ <li><link href="#createdocfromsvgfile">Creating a Document from an
SVG file</link></li>
+ <li><link href="#rendering">Rendering an SVG DOM</link></li>
+
+ </ul>
</s1>
<!-- ##################################################################### -->
-<anchor id="gettingStarted"/>
+<anchor id="gettingStarted"/>
<s1 title="Getting started">
<p>
The DOM API defines an interface called <code>DOMImplementation</code> which
@@ -80,17 +80,17 @@
</s1>
<!-- ##################################################################### -->
-<anchor id="creating"/>
+<anchor id="creating"/>
<s1 title="Creating a Document">
<p>
Using the <code>DOMImplementation</code>, you are now able to create a
-<code>Document</code>. The following example illustrates how to create an SVG
+<code>Document</code>. The following example illustrates how to create an SVG
document. Note that the Batik's Document Object Model implementation can be
-used to represent either an SVG document fragment or any kind of XML
+used to represent either an SVG document fragment or any kind of XML
document. The following code shows how to get a concrete <code>Document</code>
object using a <code>DOMImplementation</code>. Note that by choosing the
-namespace URI and the local name of the root element of SVG, we are creating an
+namespace URI and the local name of the root element of SVG, we are creating an
SVG document.
</p>
@@ -106,7 +106,7 @@
</source>
<p>
-As we have created an SVG <code>Document</code>, we can cast this document to an
+As we have created an SVG <code>Document</code>, we can cast this document to an
<code>SVGDocument</code> (defined in the <code>org.w3c.dom.svg</code> package)
if needed.
</p>
@@ -115,13 +115,13 @@
<!-- ##################################################################### -->
-<anchor id="buildsvgdoc"/>
-<s1 title="Building an SVG Document">
+<anchor id="buildsvgdoc"/>
+<s1 title="Building an SVG Document">
<p>
Finally, using the <code>Document</code> object, we are now able to
construct SVG content. Note that the document created before supports both
-generic XML and SVG. Though the DOM implementation of Batik is an SVG DOM
+generic XML and SVG. Though the DOM implementation of Batik is an SVG DOM
implementation, the SVG part is not fully implemented yet so only the DOM Level
2 core functions should be used. The following example shows how to create a red
rectangle located at (10, 20), with a size of (100, 50) placed in a (400, 450)
@@ -169,14 +169,14 @@
</s1>
<!-- ##################################################################### -->
-<anchor id="createdocfromsvgfile"/>
-<s1 title="Creating a Document from an SVG file">
+<anchor id="createdocfromsvgfile"/>
+<s1 title="Creating a Document from an SVG file">
-<p> With Batik, you can also create an SVG DOM tree from a URI, an
+<p> With Batik, you can also create an SVG DOM tree from a URI, an
<code>InputStream</code>, or a <code>Reader</code> - using the
<code>SAXSVGDocumentFactory</code>. The following example illustrates how to
-create an SVG document. Note that the Batik's Document Object Model
-implementation can be used to represent either an SVG document fragment or any
+create an SVG document. Note that the Batik's Document Object Model
+implementation can be used to represent either an SVG document fragment or any
kind of XML document. The following code shows how to get a concrete
<code>Document</code> object using the <code>SAXSVGDocumentFactory</code>.
</p>
@@ -200,7 +200,7 @@
</source>
<p>
-As we have created an SVG <code>Document</code>, we can cast this document to an
+As we have created an SVG <code>Document</code>, we can cast this document to an
<code>SVGDocument</code> (defined in the <code>org.w3c.dom.svg</code> package)
if needed.
</p>
@@ -208,29 +208,29 @@
</s1>
<!-- ##################################################################### -->
-<anchor id="rendering"/>
-<s1 title="Rendering an SVG DOM">
+<anchor id="rendering"/>
+<s1 title="Rendering an SVG DOM">
<p>
-Batik provides several ways to use an SVG DOM tree. Two modules can be
+Batik provides several ways to use an SVG DOM tree. Two modules can be
immediately used to render your SVG document.
</p>
<dl>
<dt>JSVGCanvas</dt>
<dd>
The <code>JSVGCanvas</code> is a swing component that can display SVG
-document. A SVG document can be specified using a URI or an SVG DOM tree (using
+document. A SVG document can be specified using a URI or an SVG DOM tree (using
the <code>setSVGDocument</code> method). For futher informations about the
-<code>JSVGCanvas</code>, see the <link href="svgcanvas.html">JSVGCanvas</link>
tutorial.
+<code>JSVGCanvas</code>, see the <link href="svgcanvas.html">JSVGCanvas</link>
tutorial.
</dd>
<dt>ImageTranscoder</dt>
<dd>
The <code>ImageTranscoder</code> is a transcoder which can take a URI, an
-InputStream or an SVG DOM tree and produces a raster image (such JPEG, PNG or
Tiff).
-By creating a <code>TranscoderInput</code> with the SVG DOM tree, you will
+InputStream or an SVG DOM tree and produces a raster image (such JPEG, PNG or Tiff).
+By creating a <code>TranscoderInput</code> with the SVG DOM tree, you will
be able to transform your SVG content to a raster image. For futher
-informations, see the <link href="rasterizerTutorial.html">Transcoder</link>
-tutorial.
+informations, see the <link href="rasterizerTutorial.html">Transcoder</link>
+tutorial.
</dd>
</dl>
1.12 +2 -2 xml-batik/xdocs/extendingBatik.xml
Index: extendingBatik.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/extendingBatik.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- extendingBatik.xml 17 Jun 2002 16:28:00 -0000 1.11
+++ extendingBatik.xml 18 Jun 2002 17:01:51 -0000 1.12
@@ -280,7 +280,7 @@
FilterPrimitiveBridge</link></dt>
<dd>
Constructs an element in the filter chain applied
- to an SVG graphics node.
+ to an SVG graphics node.
<br/>
<em>Example tags:</em> feBlend, feCompose, ...<br/>
<em>Example Extensions:</em>
BatikHistogramNormalizationElementBridge
1.31 +97 -96 xml-batik/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/faq.xml,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- faq.xml 17 Jun 2002 16:28:00 -0000 1.30
+++ faq.xml 18 Jun 2002 17:01:51 -0000 1.31
@@ -22,43 +22,43 @@
<answer>
<p> <img src="images/batikUses.jpg" alt="Batik use cases" />
Batik is a Java(tm) technology
- based toolkit for applications or applets that want to use images in the
+ based toolkit for applications or applets that want to use images in the
<link href="http://www.w3.org/TR/SVG/";>Scalable Vector
Graphics (SVG)</link> format for various purposes, such as
viewing, generation or manipulation.
</p>
<p>
- It is the ambition of this project to give developers a set of
- <link href="architecture.html">core modules</link> which can
- be used together or individually to support specific SVG
- solutions. Examples of modules are an <link
- href="glossary.html#SVGParser">SVG parser</link>, an <link
- href="glossary.html#SVGGenerator">SVG generator</link> and an
- <link href="glossary.html#SVGDOM">SVG DOM </link>
- implementations. Another ambition of the Batik project is to
- make it highly extensible (for example, Batik allows the
- developer to handle <link href="extendingBatik.html">custom
- SVG tags</link>). Even though the goal of the project is to
- provide a set of core modules, one of the deliveries is a full
- fledged <link href="svgviewer.html">SVG Browser</link>
- implementation which validates the various modules and their
- inter-operability.
- </p>
- <p>
- Batik provides <link href="architecture.html">building
- blocks</link> that developers can assemble in various ways in
- their Java technology applications or applets to generate,
- parse, view or convert SVG contents. For example, Batik
- contains a Swing component that can add <link
- href="svggen.html">SVG viewing capability</link> to all Java
- technology applications or applets. Batik can also be used to
- generate SVG on a client or on a server, and Batik can <link
- href="svgrasterizer.html">convert SVG content</link> into
- other formats such as JPEG, PNG or Tiff or other formats
- (<link href="rasterizerTutorial.html"> transcoder API</link>).
- Batik's goal is to make it easy for developers to handle SVG
- content for many purposes, client-side or server-side, as
- illustrated in the diagram.
+ It is the ambition of this project to give developers a set of
+ <link href="architecture.html">core modules</link> which can
+ be used together or individually to support specific SVG
+ solutions. Examples of modules are an <link
+ href="glossary.html#SVGParser">SVG parser</link>, an <link
+ href="glossary.html#SVGGenerator">SVG generator</link> and an
+ <link href="glossary.html#SVGDOM">SVG DOM </link>
+ implementations. Another ambition of the Batik project is to
+ make it highly extensible (for example, Batik allows the
+ developer to handle <link href="extendingBatik.html">custom
+ SVG tags</link>). Even though the goal of the project is to
+ provide a set of core modules, one of the deliveries is a full
+ fledged <link href="svgviewer.html">SVG Browser</link>
+ implementation which validates the various modules and their
+ inter-operability.
+ </p>
+ <p>
+ Batik provides <link href="architecture.html">building
+ blocks</link> that developers can assemble in various ways in
+ their Java technology applications or applets to generate,
+ parse, view or convert SVG contents. For example, Batik
+ contains a Swing component that can add <link
+ href="svggen.html">SVG viewing capability</link> to all Java
+ technology applications or applets. Batik can also be used to
+ generate SVG on a client or on a server, and Batik can <link
+ href="svgrasterizer.html">convert SVG content</link> into
+ other formats such as JPEG, PNG or Tiff or other formats
+ (<link href="rasterizerTutorial.html"> transcoder API</link>).
+ Batik's goal is to make it easy for developers to handle SVG
+ content for many purposes, client-side or server-side, as
+ illustrated in the diagram.
</p>
</answer>
@@ -68,7 +68,7 @@
<question>What is SVG?</question>
<answer>
<p>
- <link href="http://www.w3.org/TR/SVG/";>SVG</link> (Scalable Vector
Graphics) is an open-standard language for describing
+ <link href="http://www.w3.org/TR/SVG/";>SVG</link> (Scalable Vector
Graphics) is an open-standard language for describing
two-dimensional (2D) graphics in XML. It is a Recommendation from the
<link href="http://www.w3.org";>W3C</link>. SVG lets you describe rich images
with features such as gradients, transparency, filter effects and animation.
@@ -99,7 +99,7 @@
<question>What can I do with Batik?</question>
<answer>
<p>
- Batik contains several <link href="architecture.html">core modules</link>
which can be used independently or jointly to
+ Batik contains several <link href="architecture.html">core modules</link>
which can be used independently or jointly to
<strong>generate SVG content</strong> (see the <link href="svggen.html">SVG
Generator</link>, an
<link href="domapi.html">SVG DOM</link> implementation documentation)
<strong>view SVG content</strong> (see the <link
href="jsvgcanvas.html">JSVGCanvas</link>)
@@ -108,15 +108,15 @@
</p>
<p>
- In addition, Batik contains low <link
href="architecture.html#lowLevelComponents">level modules</link> such as
+ In addition, Batik contains <link
href="architecture.html#lowLevelComponents">low level modules</link> such as
an object oriented Graphic Vector Toolkit (<link
href="glossary.html#GVT">GVT</link>),
- a set of low level parsers(<link href="glossary.html#SVGParser">SVG
Parser</link>) specific to the SVG syntax and
- a set of <link href="extendingBatik.html">extensions</link> to the Java 2D
API (such as sophisticated fill types and
+ a set of low level parsers(<link href="glossary.html#SVGParser">SVG
Parser</link>) specific to the SVG syntax and
+ a set of <link href="extendingBatik.html">extensions</link> to the Java 2D
API (such as sophisticated fill types and
filter effects).
</p>
<p>
- Finally, Batik comes with <link href="toolsAndApps.html">packaged
applications</link> to help developers get
+ Finally, Batik comes with <link href="toolsAndApps.html">packaged
applications</link> to help developers get
familiar with the code and be quickly able to use the various modules: an
<link href="svgviewer.html">SVG browser</link> (in the
<code>org.apache.batik.apps.svgbrowser</code> package) an
@@ -127,16 +127,16 @@
<link href="svgpp.html">SVG pretty printer</link> (in the
<code>org.apache.batik.apps.svgpp package</code>).</p>
<p>
- The <strong>SVG browser</strong> <link href="svgviewer.html">(here)</link>
can display SVG documents and lets the user zoom, pan
+ The <strong>Squiggle SVG browser</strong> <link
href="svgviewer.html">(here)</link> can display SVG documents and lets the user zoom,
pan
and rotate any SVG document, view the SVG source, link between SVG
documents, view a tree representation of the SVG DOM and more. One
important component of the SVG viewer is the
<code>org.apache.batik.swing.JSVGCanvas</code>
- component which can be plugged in any Java application or applet to provide
SVG viewing capability.
+ component which can be plugged in any Java application or applet to provide
SVG viewing capability.
</p>
<p>
- The <strong>SVG rasterizer</strong> <link
href="svgrasterizer.html">(here)</link>
- lets the user convert SVG files to raster formats such
- as JPEG, PNG or Tiff . It contains an extensible mechanism so that
arbitrary
+ The <strong>SVG rasterizer</strong> <link
href="svgrasterizer.html">(here)</link>
+ lets the user convert SVG files to raster formats such
+ as JPEG, PNG or Tiff . It contains an extensible mechanism so that arbitrary
raster formats can be added. For example, the rasterizer lets you create
one SVG file with a special effect (e.g., shadows, gradients, etc...),
turn it into an PNG image, then modify the SVG source (e.g., modify
@@ -146,8 +146,8 @@
can also be used on a web server to do this conversion automatically).
</p>
<p>
- The <strong>SVG Font Converter</strong><link
href="ttf2svg.html">(here)</link> lets the user easily create
- an <link href="http://www.w3.org/TR/SVG/fonts.html";>SVG Font</link> for a
set of characters from a True Type Font file. That
+ The <strong>SVG Font Converter</strong><link
href="ttf2svg.html">(here)</link> lets the user easily create
+ an <link href="http://www.w3.org/TR/SVG/fonts.html";>SVG Font</link> for a
set of characters from a True Type Font file. That
SVG Font definition can be embedded in a document using the
characters. This allows users to create SVG documents that are self
contained and
do not rely on system fonts, and guarantees that the SVG file will
@@ -155,16 +155,16 @@
</p>
<p>
- The <strong>SVG Pretty Printer</strong><link
href="svgpp.html">(here)</link> is a convenience tool to
+ The <strong>SVG Pretty Printer</strong><link
href="svgpp.html">(here)</link> is a convenience tool to
pretty print an SVG document, which means that you can reformat any
existing SVG document to produce a properly formatted and highly legible
version.</p>
<!-- <p>The SVG Generator
(in the <code>org.apache.batik.util.awt.svg</code> package) that allows
- all Java applications or applets to export their graphics to the SVG
format.
+ all Java applications or applets to export their graphics to the SVG
format.
- The SVG generator lets all Java application or applets export their
graphics
+ The SVG generator lets all Java application or applets export their graphics
as SVG, using the same code used for drawing to the screen or for
printing. For example, an application that displays a pie chart in
a window, can use the SVG generator to easily export the sequence
@@ -178,17 +178,17 @@
used to serve SVG images to client machines that do not have SVG support).
</p>
<p>
- The <link href="svgviewer.html">SVG Browser</link> and the
- <link href="svgrasterizer.html">rasterizer</link> are examples
- of some of the types of applications Batik allows. Batik's
- <link href="architecture.html">architecture</link> allows the
- modules to be used in many different ways so other
- applications are possible, such as using the <link
- href="rasterizerTutorial.html">transcoders</link> (to other
- vector formats, such as PDF, for example). Furthermore, the
- <link href="glossary.html">Graphic Vector Toolkit</link> could
- be used to render other graphic formats such as <link
- href="http://www.w3.org/TR/xhtml1/";>XHTML</link>.
+ The <link href="svgviewer.html">Squiggle SVG Browser</link> and the
+ <link href="svgrasterizer.html">rasterizer</link> are examples
+ of some of the types of applications Batik allows. Batik's
+ <link href="architecture.html">architecture</link> allows the
+ modules to be used in many different ways so other
+ applications are possible, such as using the <link
+ href="rasterizerTutorial.html">transcoders</link> (to other
+ vector formats, such as PDF, for example). Furthermore, the
+ <link href="glossary.html">Graphic Vector Toolkit</link> could
+ be used to render other graphic formats such as <link
+ href="http://www.w3.org/TR/xhtml1/";>XHTML</link>.
</p>
</answer>
</faq>
@@ -197,7 +197,7 @@
<question>How can I see a demo?</question>
<answer>
<p>
- You can see an online demonstration of the Batik SVG browser
+ You can see an online demonstration of the Squiggle SVG browser
on the <link href="batikDemo.html">demo page</link>. Alternatively,
you can <link href="dist">download</link>
Batik or see
@@ -205,8 +205,8 @@
of the Batik SVG viewer, images created from the
<link href="svgrasterizer.html">rasterizer</link>
and an <link href="svggen.html">example</link>
- of how to use the <link href="svggen.html">SVGGraphics2D</link>
- generator.
+ of how to use the <link href="svggen.html">SVGGraphics2D</link>
+ generator.
</p>
</answer>
@@ -216,11 +216,11 @@
<question>Why do we have such a project at Apache?</question>
<answer>
<p>
- <link href="http://xml.apache.org/mission.html";>Apache's
- mission</link> is to allow the web to be an open environment
- and to remain an open environment. Batik as an open source
- implementation of a key format for today's and tomorrow's web
- fits well in this mission.
+ <link href="http://xml.apache.org/mission.html";>Apache's
+ mission</link> is to allow the web to be an open environment
+ and to remain an open environment. Batik as an open source
+ implementation of a key format for today's and tomorrow's web
+ fits well in this mission.
</p>
</answer>
@@ -288,8 +288,8 @@
Java projects at Apache. A formal description of that process
can be found on the <link
href="http://jakarta.apache.org/guidelines/index.html";>Jakarta</link>
- web site.(<link href="whoAreWe.html#BatikCommitters">Batik Commiters</link>
and
- <link href="whoAreWe.html#BatikContributors">Batik Contributors</link>)
+ web site.(<link href="whoAreWe.html#BatikCommitters">Batik Commiters</link>
and
+ <link href="whoAreWe.html#BatikContributors">Batik Contributors</link>)
</p>
<p>
For direct participation, we suggest you to subscribe to the
@@ -307,11 +307,12 @@
<faq>
<question>Where is Batik going? What is next?</question>
<answer>
- <p>The SVG implementation is not complete <link
href="status.html">(status)</link>, and there is more work to do to
+ <p>The SVG implementation is not complete <link
href="status.html">(status)</link>, and there is more work to do to
achieve a fully functional viewer.</p>
- <p>Batik 1.1 supports all the <link href="status.html#beSuiteStatus">static
SVG features</link>, linking and a limited
- support for <link href="scripting.html">scripting</link>. Design work has
- started on <link href="status.html#DynamicTest">dynamic features</link>
(scripting and SMIL animation) support.
+ <p>Batik 1.1 supports all the <link href="status.html#beSuiteStatus">static
SVG features</link>, linking and a limited
+ support for <link href="scripting.html">scripting</link>. Work has
+ started on <link href="status.html#DynamicTest">dynamic features</link>.
Scripting support with the 1.5 beta releases,
+ and declarative animation (known as SMIL animation) will be supported in
the 2.0 release.
</p>
<p>
The type of applications (e.g., transcoding applications) that can or will
@@ -330,7 +331,7 @@
and that will let you author SVG content visually.</p>
<p>
You can get a list of tools exporting SVG from the
- <link href="http://www.w3.org/Graphics/SVG/SVG-Implementations#edit";>SVG
implementation</link>
+ <link href="http://www.w3.org/Graphics/SVG/SVG-Implementations#edit";>SVG
implementation</link>
section of the SVG Home page on the W3C web site. You can also
imagine building a tool on top of Batik: feel free to contribute!
</p>
@@ -390,8 +391,8 @@
<p>
The following <link href="status.html">status page</link>
shows how much of the SVG specification Batik implements by showing which
- of the tests in the <link href="status.html#beSuiteStatus">SVG Basic
Effectivity test suite</link>
- Batik successfully passes.
+ of the tests in the <link href="status.html#beSuiteStatus">SVG Basic
Effectivity test suite</link>
+ Batik successfully passes.
</p>
</answer>
@@ -403,9 +404,9 @@
<answer>
<p>
Being an XML grammar means SVG can leverage work done around XML,
- and SVG actually leverages other grammars such as
- <link href="http://www.w3.org/TR/2001/REC-xlink-20010627/";>XLink</link>,
for linking and
- <link
href="http://www.w3.org/TR/2001/REC-smil-animation-20010904/#AnimationFramework";>SMIL</link>
+ and SVG actually leverages other grammars such as
+ <link href="http://www.w3.org/TR/2001/REC-xlink-20010627/";>XLink</link>,
for linking and
+ <link
href="http://www.w3.org/TR/2001/REC-smil-animation-20010904/#AnimationFramework";>SMIL</link>
for the animation.
</p>
<p>
@@ -510,7 +511,7 @@
What is the problem?</question>
<answer><p>There is certainly something wrong with your classpath. Clear your
CLASSPATH environment variable and be sure to remove all the libraries
- which use the W3C's DOM bindings from <code>jre/lib/ext</code>before
running
+ which use the W3C's DOM bindings from <code>jre/lib/ext</code>before
running
any of the Batik's applications.</p></answer>
</faq>
@@ -521,15 +522,15 @@
What am I missing?
</question>
<answer><p>
- When running from the <link href="install.html#distributions">source
distribution</link> you automatically get
+ When running from the <link href="install.html#distributions">source
distribution</link> you automatically get
the service provider entries for the Batik extension tags
(regularPolygon, and star for example). We chose not to include
- these by default in the <link href="install.html#distributions">binary
distribution</link> for the Batik
+ these by default in the <link href="install.html#distributions">binary
distribution</link> for the Batik
applications.
</p>
<p>
You can make the Batik extension tags available by putting the
- <code>'lib/batik-extensions.jar'</code> file on the java class path.
+ <code>'lib/batik-extensions.jar'</code> file on the java class path.
</p></answer>
</faq>
@@ -538,13 +539,13 @@
Why do I get red circles when I view the samples/extensions files?
</question>
<answer><p>
- You are using the <link href="install.html#distributions">binary
distribution</link>.
- This distribution does not include support for our example extensions (they are
just
+ You are using the <link href="install.html#distributions">binary
distribution</link>.
+ This distribution does not include support for our example extensions (they are
just
examples and other people can do more sophisticated things).
</p>
<p>
- If you want to view these examples you need to add
<code>lib/batik-extensions.jar</code> to
+ If you want to view these examples you need to add
<code>lib/batik-extensions.jar</code> to
your class path.
</p></answer>
</faq>
@@ -552,24 +553,24 @@
<faq>
<question>
I am trying to use Batik and FOP together but Batik does not work and
- fails on the <code>org.w3c.xxx packages</code>. What is happening?
+ fails on the <code>org.w3c.xxx packages</code>. What is happening?
</question>
<answer>
<p>Both FOP and Batik use the <code>org.w3c.xxx packages</code>. Depending
on the
version of FOP and Batik, Batik has been using a version of these
packages which is more recent than the one in the w3c.jar file FOP
- uses. However, if the <code>w3c.jar</code>, file which comes with the FOP
distribution
+ uses. However, if the <code>w3c.jar</code>, file which comes with the FOP
distribution
is loaded before the Batik jar files, then, the version coming with
FOP takes precedence (i.e., that is the version the Java Virtual Machine
loads). Because that version is incompatible with Batik, you get a
failure.</p>
- <p>The solution is to either repackage the <code>w3c.jar</code> file with
the
+ <p>The solution is to either repackage the <code>w3c.jar</code> file with
the
classes in the Batik distribution (you will need the Batik source
distrib to do that), or you will need to make sure the Batik jars are
- loaded before the <code>w3c.jar</code>, for example by putting them before
the
- <code>w3c.jar</code> file in your classpath. If you are copying your jar
files to
- <code>..jre/lib/ext</code>, you can simply remove the FOP
<code>w3c.jar</code> file from that
+ loaded before the <code>w3c.jar</code>, for example by putting them before
the
+ <code>w3c.jar</code> file in your classpath. If you are copying your jar
files to
+ <code>..jre/lib/ext</code>, you can simply remove the FOP
<code>w3c.jar</code> file from that
directory.</p>
</answer>
</faq>
@@ -623,11 +624,11 @@
What is happening?
</question>
<answer>
- <p>The Batik demo (see <code>http://xml.apache.org/batik/batikDemo.html</code>)
uses Java Web Start. Java Web Start (under the Applications/Utilities
+ <p>The Batik <link
href="http://xml.apache.org/batik/batikDemo.html";>demo</link> uses Java Web Start.
Java Web Start (under the Applications/Utilities
folder), lets you start a Java application from a web browser. You can see the
debug
traces by enabling the Java console for Java Web Start. If you do, you will see
that
- there is a <code>java.lang.NoSuchMethodError</code> execption thrown.</p>
- <p>This is happening because the Java Web Start jar file (<code>javaws.jar in
/Applications/Utilities/Java Web Start/Content/MacOS)</code>
+ there is a <code>java.lang.NoSuchMethodError</code> execption thrown.</p>
+ <p>This is happening because the Java Web Start jar file (<code>javaws.jar in
/Applications/Utilities/Java Web Start/Content/MacOS)</code>
contains an older version of the DOM bindings.</p>
<p>One work around is to manually patch the javaws.jar file to remove the DOM
bindings
so that they do not take precedence over the Batik ones.</p>
1.42 +79 -79 xml-batik/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/index.xml,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -r1.41 -r1.42
--- index.xml 17 Jun 2002 16:28:00 -0000 1.41
+++ index.xml 18 Jun 2002 17:01:51 -0000 1.42
@@ -26,87 +26,87 @@
<body>
<s1 title="Batik Overview">
- <figure src="images/splash.png" alt="Batik release 1.5beta2" />
+ <figure src="images/splash.png" alt="Batik release 1.5beta3" />
<p>
- Batik is a Java(tm) technology based toolkit for applications or applets
that want
+ Batik is a Java(tm) technology based toolkit for applications or applets
that want
to use images in the <link href="http://www.w3.org/TR/SVG/";>Scalable Vector
Graphics (SVG)</link> format for various purposes, such as
viewing, generation or manipulation.
</p>
- <ul>
- <li><link href="#BatikApplications">Applications of Batik</link></li>
- <li><link href="#SVGSpecification">The SVG Specification</link></li>
- <li><link href="#BatikStatus">What is Batik's Implementation
Status?</link></li>
- <li><link href="#DownloadBatik">Downloading the Batik
distribution (source and binary)</link></li>
- <li><link href="#projectAndProductExamples">Examples of projects and
products using Batik</link></li>
- </ul>
- <p>
- The project's ambition is to give developers a set of
- <link href="architecture.html#coreComponents">core
- modules</link> which can be used together or individually to support
- specific SVG solutions. Examples of
- <link href="architecture.html">modules</link>
- are the
- <link href="architecture.html#lowLevelComponents">SVG Parser</link>,
- the <link href="svggen.html">SVG Generator</link> and
- the <link href="domapi.html">SVG DOM</link>. Another ambition for
- the Batik project is to make it highly
- <link href="extendingBatik.html">extensible</link>
- (for example, Batik allows the developer to handle custom SVG
+ <ul>
+ <li><link href="#BatikApplications">Applications of Batik</link></li>
+ <li><link href="#SVGSpecification">The SVG Specification</link></li>
+ <li><link href="#BatikStatus">What is Batik's Implementation
Status?</link></li>
+ <li><link href="#DownloadBatik">Downloading the Batik
distribution (source and binary)</link></li>
+ <li><link href="#projectAndProductExamples">Examples of projects and
products using Batik</link></li>
+ </ul>
+ <p>
+ The project's ambition is to give developers a set of
+ <link href="architecture.html#coreComponents">core
+ modules</link> which can be used together or individually to support
+ specific SVG solutions. Examples of
+ <link href="architecture.html">modules</link>
+ are the
+ <link href="architecture.html#lowLevelComponents">SVG Parser</link>,
+ the <link href="svggen.html">SVG Generator</link> and
+ the <link href="domapi.html">SVG DOM</link>. Another ambition for
+ the Batik project is to make it highly
+ <link href="extendingBatik.html">extensible</link>
+ (for example, Batik allows the developer to handle custom SVG
tags). Even though the goal of the project is to provide a
set of core modules, one of the deliverables is a full fledged
- <link href="svgviewer.html">SVG browser</link> implementation
- which validates the various modules and their inter-operability.
+ <link href="svgviewer.html">SVG browser</link> implementation
+ which validates the various modules and their inter-operability.
</p>
</s1>
- <anchor id="BatikApplications" />
+ <anchor id="BatikApplications" />
<s1 title="Applications of Batik">
<p><img src="images/batikUses.jpg" alt="Batik use cases" />
With Batik, you can manipulate SVG documents anywhere Java is
- available. You can also use the various
- <link href="architecture.html">Batik modules</link> to
- <link href="svggen.html">generate</link>,
- <link href="domapi.html">manipulate</link>,
- <link href="rasterizerTutorial.html">transcode</link> and search SVG
- images in your applications or applets.
- </p>
- <p>
- Batik makes it easy for Java based applications or applets to
- deal with SVG content. For example, using Batik's
- <link href="svggen.html">SVG generator module</link>,
- a Java application or applets can very easily export its
- graphics into the SVG format. Using Batik's SVG processor and
- SVG Viewing component, an application or applet can very
- easily integrate SVG viewing capabilities. Another
- possibility is to use Batik's modules to convert SVG to
- various formats, such as raster images (JPEG,PNG or Tiff).
- </p>
- <p>
- Batik provides <link href="architecture.html">core modules</link>
- for handling and processing SVG files. See
- <link href="#projectAndProductExamples">examples of projects and
+ available. You can also use the various
+ <link href="architecture.html">Batik modules</link> to
+ <link href="svggen.html">generate</link>,
+ <link href="domapi.html">manipulate</link>,
+ <link href="rasterizerTutorial.html">transcode</link> and search SVG
+ images in your applications or applets.
+ </p>
+ <p>
+ Batik makes it easy for Java based applications or applets to
+ deal with SVG content. For example, using Batik's
+ <link href="svggen.html">SVG generator module</link>,
+ a Java application or applets can very easily export its
+ graphics into the SVG format. Using Batik's SVG processor and
+ SVG Viewing component, an application or applet can very
+ easily integrate SVG viewing capabilities. Another
+ possibility is to use Batik's modules to convert SVG to
+ various formats, such as raster images (JPEG,PNG or Tiff).
+ </p>
+ <p>
+ Batik provides <link href="architecture.html">core modules</link>
+ for handling and processing SVG files. See
+ <link href="#projectAndProductExamples">examples of projects and
products using Batik</link> for real-life example of how Batik is
already integrated in projects and products.
</p>
- <p>
- Batik provides building blocks that developers can assemble in
- various ways in their Java technology applications or applets
- to generate, parse, view or convert SVG contents. Batik can
- also be used to generate SVG on a client or on a server, and
- Batik can <link href="svgrasterizer.html">convert SVG
- content</link> convert SVG content into other formats such as
- JPEG, PNG or Tiff or other formats (<link
- href="rasterizerTutorial.html">transcoder API</link>).
- Batik's goal is to make it easy for developers to handle SVG
- content for various purposes, client-side or server-side, as
- illustrated in the diagram.
- </p>
+ <p>
+ Batik provides building blocks that developers can assemble in
+ various ways in their Java technology applications or applets
+ to generate, parse, view or convert SVG contents. Batik can
+ also be used to generate SVG on a client or on a server, and
+ Batik can <link href="svgrasterizer.html">convert SVG
+ content</link> convert SVG content into other formats such as
+ JPEG, PNG or Tiff or other formats (<link
+ href="rasterizerTutorial.html">transcoder API</link>).
+ Batik's goal is to make it easy for developers to handle SVG
+ content for various purposes, client-side or server-side, as
+ illustrated in the diagram.
+ </p>
</s1>
- <anchor id="SVGSpecification" />
+ <anchor id="SVGSpecification" />
<s1 title="The SVG Specification">
<p>
Scalable Vector Graphics, SVG, is a <link
href="http://www.w3.org";>W3C</link>
@@ -115,22 +115,22 @@
effects (shadows, lighting effects, etc...), scripting and animation.
</p>
<p>
- The <link href="http://www.w3.org/TR/SVG/";>SVG specification</link>
states:</p>
- <p>This specification defines the features and syntax for Scalable Vector
Graphics (SVG).
- SVG is a language for describing two-dimensional graphics in XML [<link
href="http://www.w3.org/TR/REC-xml";>XML10</link>]. SVG allows for three types
- of graphic objects: vector graphic shapes (e.g., paths consisting of straight
lines and curves),
- images and text. Graphical objects can be grouped, styled, transformed and
composited into previously
- rendered objects. The feature set includes nested transformations, clipping
paths, alpha masks,
- filter effects and template objects.</p>
- <p>SVG drawings can be interactive and dynamic. Animations can be defined and
triggered either declaratively
- (i.e., by embedding SVG animation elements in SVG content) or via
scripting.</p>
+ The <link href="http://www.w3.org/TR/SVG/";>SVG specification</link>
states:</p>
+ <p>This specification defines the features and syntax for Scalable Vector
Graphics (SVG).
+ SVG is a language for describing two-dimensional graphics in XML [<link
href="http://www.w3.org/TR/REC-xml";>XML10</link>]. SVG allows for three types
+ of graphic objects: vector graphic shapes (e.g., paths consisting of straight
lines and curves),
+ images and text. Graphical objects can be grouped, styled, transformed and
composited into previously
+ rendered objects. The feature set includes nested transformations, clipping
paths, alpha masks,
+ filter effects and template objects.</p>
+ <p>SVG drawings can be interactive and dynamic. Animations can be defined and
triggered either declaratively
+ (i.e., by embedding SVG animation elements in SVG content) or via
scripting.</p>
</s1>
- <anchor id="BatikStatus" />
+ <anchor id="BatikStatus" />
<s1 title="Batik's Implementation Status">
<p>
- The latest stable revision of Batik provides a complete support for all the
<link href="status.html#beSuiteStatus">static SVG features.</link>
- Work on supporting <link href="status.html#DynamicTest">dynamic SVG
features</link> such as scripting and animation is under way and
+ The latest stable revision of Batik provides a complete support for all the
<link href="status.html#beSuiteStatus">static SVG features.</link>
+ Work on supporting <link href="status.html#DynamicTest">dynamic SVG
features</link> such as scripting and animation is under way and
this work is available from the <link
href="http://cvs.apache.org/viewcvs.cgi/xml-batik/";>CVS repository</link>
or from beta <link href="http://xml.apache.org/batik/dist";>downloads</link>.
</p>
@@ -142,12 +142,12 @@
</p>
</s1>
- <anchor id="DownloadBatik" />
+ <anchor id="DownloadBatik" />
<s1 title="Download Batik">
<p>
- You can get the Batik distribution (<link
href="install.html#distributions">source</link>
- and <link href="install.html#distributions">binary</link>) on the
- <link href="http://xml.apache.org/batik/dist/";>download page</link>.
+ You can get the Batik distribution (<link
href="install.html#distributions">source</link>
+ and <link href="install.html#distributions">binary</link>) on the
+ <link href="http://xml.apache.org/batik/dist/";>download page</link>.
</p>
<note>
All other libraries needed by Batik are included in the distribution.
@@ -177,7 +177,7 @@
<li><link href="http://burma.free.fr";>eDoc</link>, a page layout software,
is using the Batik SVG generator to export pages to SVG</li>
<li><link
href="http://www.isacat.net/2002/svolgo/index.htm";>Svolgo</link>,a Graph
Visualisation/Transformation Framework for the
Semantic Web Cross-model transformation, node and arc diagrams,
representation in SVG. This project uses Batik's SVG DOM implementation.</li>
- <li><link href="http://www.throneworld.com/lords/gms/dev.html";>Lords
Map</link>, a program to allow players and visitors to view the current map
+ <li><link href="http://www.throneworld.com/lords/gms/dev.html";>Lords
Map</link>, a program to allow players and visitors to view the current map
of varoius campaigns. Lord Map uses Batik's SVG DOM and SVG
Generator.</li>
</ul>
</s1>
1.17 +97 -97 xml-batik/xdocs/svgviewer.xml
Index: svgviewer.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/svgviewer.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- svgviewer.xml 17 Jun 2002 16:28:01 -0000 1.16
+++ svgviewer.xml 18 Jun 2002 17:01:51 -0000 1.17
@@ -16,7 +16,7 @@
<document>
<header>
- <title>Batik - SVG Browser</title>
+ <title>Squiggle - SVG Browser</title>
<subtitle>A cross platform SVG Browser</subtitle>
<authors>
<person name="Vincent Hardy" email="[EMAIL PROTECTED]"/>
@@ -25,9 +25,9 @@
<body>
<s1 title="Introduction">
- <!-- <figure src="images/viewerBanner.jpg" alt="Batik Browser"/> -->
+ <!-- <figure src="images/viewerBanner.jpg" alt="Squiggle SVG Browser"/> -->
<p>
- This page describes the main features of the SVG Browser that comes with
Batik.
+ This page describes the main features of the Squiggle SVG Browser that
comes with Batik.
It discusses the following:</p>
<ul>
<li><link href="#downloading">Downloading and installing the
browser</link></li>
@@ -35,7 +35,7 @@
<li><link href="#viewing">Viewing SVG documents</link></li>
<li><link href="#exportAndPrint">Printing and Converting SVG
files</link></li>
<li><link href="#inspectingSVGSourceContent">Inspecting the SVG
source</link></li>
- <li><link href="#configuring">Configuring the SVG Browser</link></li>
+ <li><link href="#configuring">Configuring Squiggle</link></li>
<li><link href="#zooming">Navigating SVG documents (zooming, panning,
rotating, transform, thumbnail)</link></li>
</ul>
@@ -46,7 +46,7 @@
<p>Refer to the <link href="dist">download area</link> to find out how
to
download Batik. Remember that you can get either the <link
href="install.html#distributions">source distribution</link>
- or the <link href="install.html#distributions">binary
distribution</link>.</p>
+ or the <link href="install.html#distributions">binary
distribution</link>.</p>
<p>Refer to the <link href="install.html">installation page</link> for
instructions
on how to install the Batik download on your system.</p>
</s1>
@@ -55,21 +55,21 @@
<s1 title="Starting the browser">
<p>The method for starting the browser depends on the distribution of
Batik
that you chose to download. The following describes how to start the
browser
- for each distribution(<link href="install.html#distributions">binary
distribution</link> and
- <link href="install.html#distributions">source distribution</link>)</p>
+ for each distribution(<link href="install.html#distributions">binary
distribution</link> and
+ <link href="install.html#distributions">source distribution</link>)</p>
- <anchor id="startingBinaryDistribution"/>
+ <anchor id="startingBinaryDistribution"/>
<s2 title="Starting the browser for the binary distribution">
- <p>If you downloaded the <link
href="install.html#distributions">binary distribution</link>
- of Batik, you should have
- gotten a file called <code>batik-1.5beta3.zip</code>, which, when
expanded,
- created a <code>batik-svgbrowser.jar</code> file. To start the
browser,
+ <p>If you downloaded the <link
href="install.html#distributions">binary distribution</link>
+ of Batik, you should have
+ gotten a file called <code>batik-1.5beta3.zip</code>, which, when
expanded,
+ created a <code>batik-svgbrowser.jar</code> file. To start the
browser,
type the following on the command line:</p>
<p><em>cd <installationDirectory></em></p>
- <p><code>java -jar batik-svgbrowser.jar</code></p>
+ <p><code>java -jar batik-svgbrowser.jar</code></p>
<p>You can pass options to the command line:</p>
- <p><code>java -jar batik-svgbrowser.jar </code><em>[</em>
<code>-font-size </code><em><fontSize>] [svgURL]*</em></p>
+ <p><code>java -jar batik-svgbrowser.jar </code><em>[</em>
<code>-font-size </code><em><fontSize>] [svgURL]*</em></p>
<p>Where:</p>
<ul>
<li><em>-font-size <fontSize></em> will make the
browser use small fonts in the GUI.</li>
@@ -77,47 +77,47 @@
</ul>
<p>For example:</p>
<ul>
- <li><code>java -jar batik-svgbrowser.jar -font-size 10</code>
starts the browser with small fonts.</li>
- <li><code>java -jar batik-svgbrowser.jar -font-size 10
samples/batikLogo.svg</code> starts the browser with
- the <code>batikLogo.svg</code> file open and small fonts,
- because of <code>-font-size</code></li>
+ <li><code>java -jar batik-svgbrowser.jar -font-size 10</code>
starts the browser with small fonts.</li>
+ <li><code>java -jar batik-svgbrowser.jar -font-size 10
samples/batikLogo.svg</code> starts the browser with
+ the <code>batikLogo.svg</code> file open and small fonts,
+ because of <code>-font-size</code></li>
</ul>
</s2>
- <s2 title="Starting the browser for the source distribution">
+ <s2 title="Starting the browser for the source distribution">
- <p>If you downloaded the <link
href="install.html#distributions">source distribution</link>
- of Batik, you should have gotten
- a zip file batik-src-1.5beta3 that expanded into a directory called
<code>xml-batik</code>. In that directory, you
+ <p>If you downloaded the <link
href="install.html#distributions">source distribution</link>
+ of Batik, you should have gotten
+ a zip file batik-src-1.5beta3 that expanded into a directory called
<code>xml-batik</code>. In that directory, you
can find build scripts for the platform you are running on. For
example, there is
- a <code>build.bat</code> script for users of the Windows platform
and there is a <code>build.sh</code> script
+ a <code>build.bat</code> script for users of the Windows platform
and there is a <code>build.sh</code> script
for UNIX users.</p>
<p>To start the browser you should:</p><ul>
- <li>Make sure the <code>xml-batik</code> directory is in your
<code>PATH</code> environment variable</li>
- <li>Make sure the <code>ANT_HOME</code> environment variable is
set to the <code>xml-batik</code> directory</li>
- <li>Make sure that your <code>JAVA_HOME</code> environment
variable is set to your JDK installation
+ <li>Make sure the <code>xml-batik</code> directory is in your
<code>PATH</code> environment variable</li>
+ <li>Make sure the <code>ANT_HOME</code> environment variable is
set to the <code>xml-batik</code> directory</li>
+ <li>Make sure that your <code>JAVA_HOME</code> environment
variable is set to your JDK installation
directory</li>
- <li>Open a command line window and go to the
<code>xml-batik</code> directory where the Batik
+ <li>Open a command line window and go to the
<code>xml-batik</code> directory where the Batik
distribution was expanded</li>
<li>At the command prompt, type: <br />
- <strong>Windows: </strong><code>build svgbrowser</code><br
/>
- <strong>UNIX: </strong><code>build.sh svgbrowser</code><br
/>
+ <strong>Windows: </strong><code>build svgbrowser</code><br
/>
+ <strong>UNIX: </strong><code>build.sh svgbrowser</code><br
/>
This will start the browser</li>
</ul>
<p>You can pass options to the browser as follows:</p>
- <p><strong>Windows: </strong><code>build svgbrowser
</code><em>[</em><code>-font-size</code><em> <fontSize>] [svgURL]*</em></p>
- <p><strong>UNIX: </strong><code>build.sh svgbrowser</code><em>
[</em><code>-font-size</code><em> <fontSize>] [svgURL]*</em></p>
- <p>Refer to <link href="#startingBinaryDistribution">"Starting the
browser for the binary distribution"</link> for an explanation of these
- options.</p>
- <p><strong>Note:</strong> that the number of files which can be
opened on Windows, from the command line is
+ <p><strong>Windows: </strong><code>build svgbrowser
</code><em>[</em><code>-font-size</code><em> <fontSize>] [svgURL]*</em></p>
+ <p><strong>UNIX: </strong><code>build.sh svgbrowser</code><em>
[</em><code>-font-size</code><em> <fontSize>] [svgURL]*</em></p>
+ <p>Refer to <link href="#startingBinaryDistribution">"Starting the
browser for the binary distribution"</link> for an explanation of these
+ options.</p>
+ <p><strong>Note:</strong> that the number of files which can be
opened on Windows, from the command line is
limited because batch files take at most 9 parameters.</p>
</s2>
- <s2 title="SVG browser screen shot">
- <p>The following image shows the result of starting the browser, in
the
- <link href="install.html#distributions">binary distribution</link>
or
- <link href="install.html#distributions">source distribution</link>,
- with the <code>-font-size 10 samples/batikFX.svg</code>
options.</p>
+ <s2 title="Squiggle screen shot">
+ <p>The following image shows the result of starting the browser, in
the
+ <link href="install.html#distributions">binary distribution</link>
or
+ <link href="install.html#distributions">source distribution</link>,
+ with the <code>-font-size 10 samples/batikFX.svg</code> options.</p>
<figure src="images/svgviewerDefaultRegular.jpg" alt="Batik
Browser"/>
</s2>
@@ -137,12 +137,12 @@
<anchor id="localFile" />
<s2 title="Opening a local SVG file">
- <p>In situations where you want to open SVG files locally on the
machine where you are running the
- Batik SVG browser, you can use <strong>"File->Open File"</strong>
menu item to open that file, or use
- the <strong>"Ctrl-F"</strong> key accelerator. Doing so brings up a
file choser that lets you select the file
+ <p>In situations where you want to open SVG files locally on the
machine where you are running Squiggle,
+ you can use <strong>"File->Open File"</strong> menu item to open
that file, or use
+ the <strong>"Ctrl-F"</strong> key accelerator. Doing so brings up a
file choser that lets you select the file
you want to view.</p>
- <figure src="images/svgviewerFileOpen.gif" alt="File Open in SVG
Browser"/>
+ <figure src="images/svgviewerFileOpen.gif" alt="File Open in Squiggle"/>
</s2>
@@ -150,8 +150,8 @@
<s2 title="Opening an SVG file from the Web">
<p>There are many situations where the SVG content you want to view is
not local to the machine
- where the Batik SVG browser is running. In that case, you can use the
<strong>"File->Open Location"</strong> menu item, or use
- the "<strong>Ctrl-A"</strong> key accelerator to open that page. Doing
so brings up a dialog box where you
+ where Squiggle is running. In that case, you can use the
<strong>"File->Open Location"</strong> menu item, or use
+ the "<strong>Ctrl-A"</strong> key accelerator to open that page. Doing
so brings up a dialog box where you
can type in the URL for the file you want to view.</p>
<figure src="images/svgviewerOpenPage.gif" alt="Open Page in SVG
Browser"/>
@@ -159,10 +159,10 @@
</s2>
<anchor id="locationBar" />
- <s2 title="Using the location bar text field to view an SVG file">
+ <s2 title="Using the location bar text field to view an SVG file">
<p>When you know the URL of the document you want to view, you can
enter it directly in
- the location bar text field at the top of the Batik SVG browser, the
same way you can enter a
+ the location bar text field at the top of Squiggle, the same way you
can enter a
URL in an HTML browser</p>
<figure src="images/svgviewerLocationBar.gif" alt="Location Bar in SVG
Browser"/>
@@ -173,18 +173,18 @@
<p>As with HTML content, it is common to navigate back and forth
between SVG files (remember that
SVG files contain hyperlinks, just like HTML does) and, as described
later in this document,
- it is possible to <link href="#zoomInOut">zoom</link> into SVG
documents, <link href="#panning">pan</link> and <link
href="#rotating">rotate</link>.</p>
+ it is possible to <link href="#zoomInOut">zoom</link> into SVG
documents, <link href="#panning">pan</link> and <link
href="#rotating">rotate</link>.</p>
<figure src="images/svgviewerBrowsing.gif" alt="Browsing SVG files" />
- <p>The Batik SVG browser offers multiple features to help you browse
SVG files:</p>
+ <p>The Batik SVG browser offers multiple features to help you browse
SVG files:</p>
<ul>
- <li><strong>Navigating between files</strong>. The
"<strong>Go->Back</strong>" menu item (or the <strong>Ctrl-left arrow</strong>
- keyboard acceleration) and the <strong>"Go->Forward"</strong>
(or the <strong>Ctrl-right arrow</strong> keyboard acceleration)
+ <li><strong>Navigating between files</strong>. The
"<strong>Go->Back</strong>" menu item (or the <strong>Ctrl-left arrow</strong>
+ keyboard acceleration) and the <strong>"Go->Forward"</strong>
(or the <strong>Ctrl-right arrow</strong> keyboard acceleration)
let you move to the previous and next visited SVG documents</li>
- <li><strong>History</strong>. The "<strong>Go</strong>" menu also
contains a list of the visited SVG documents,
+ <li><strong>History</strong>. The "<strong>Go</strong>" menu also
contains a list of the visited SVG documents,
which gives you a way to randomly access any document you have
already visited.</li>
- <li><strong>Navigation between views</strong>. The
"<strong>"View->Previous Transform</strong>" menu item (<strong>Ctrl-k</strong>)
- and the "<strong>View->Next Transform</strong>" menu item
(<strong>Ctrl-L</strong>) let you go to the previous or next view
- you have had of a document. This is useful when, for example, you
<link href="#panning">pan</link> or <link href="#rotating">rotate</link> and document
+ <li><strong>Navigation between views</strong>. The
"<strong>"View->Previous Transform</strong>" menu item (<strong>Ctrl-k</strong>)
+ and the "<strong>View->Next Transform</strong>" menu item
(<strong>Ctrl-L</strong>) let you go to the previous or next view
+ you have had of a document. This is useful when, for example, you
<link href="#panning">pan</link> or <link href="#rotating">rotate</link> and document
and want to go back to any previous view you had of the document
(i.e., before you panned or
rotated it).</li>
</ul>
@@ -195,46 +195,46 @@
<figure src="images/svgviewerMultipleFiles.gif" alt="Viewing multiple
files" />
<p>The Batik SVG Browser can display multiple files simultaneously in
different windows. To view a
- new file in a separate window, simply select the "<strong>File->
Create New Window</strong>" menu item or use
- the <strong>Ctrl-N</strong> keyboard accelerator.</p>
+ new file in a separate window, simply select the "<strong>File->
Create New Window</strong>" menu item or use
+ the <strong>Ctrl-N</strong> keyboard accelerator.</p>
</s2>
- <anchor id="reloading"/>
+ <anchor id="reloading"/>
<s2 title="Reloading an SVG document">
<p>When working on an SVG document, you may want the browser to
reprocess a document that you
- have modified. The "<strong>File-> Reload Document</strong>" menu
item or the <strong>Ctrl-R</strong> keyboard accelerator will cause the
+ have modified. The "<strong>File-> Reload Document</strong>" menu
item or the <strong>Ctrl-R</strong> keyboard accelerator will cause the
document to be reprocessed by the browser.</p>
</s2>
</s1>
<anchor id="exportAndPrint" />
<s1 title="Exporting and Printing SVG documents">
- <p>The "<strong>File->Print</strong>" menu item or
<strong>File-P</strong> will print the currently displayed SVG document when
selected.</p>
- <p>The "<strong>File->Export As</strong>" menu offers the option to
export the currently displayed SVG document
- to various raster formats. Currently, the browser supports the PNG,
JPEG and Tiff formats.</p>
+ <p>The "<strong>File->Print</strong>" menu item or
<strong>File-P</strong> will print the currently displayed SVG document when
selected.</p>
+ <p>The "<strong>File->Export As</strong>" menu offers the option to
export the currently displayed SVG document
+ to various raster formats. Currently, the browser supports the PNG,
JPEG and Tiff formats.</p>
</s1>
<anchor id="inspectingSVGSourceContent" />
<s1 title="Inspecting the SVG Source">
<p>The browser offers two ways to inspect the source of an
- SVG document: <link href="#viewingSource">viewing the plain source</link>
or <link href="#viewingTree">viewing the
- document tree</link>. Both are explained hereafter.</p>
-
+ SVG document: <link href="#viewingSource">viewing the plain source</link>
or <link href="#viewingTree">viewing the
+ document tree</link>. Both are explained hereafter.</p>
+
<anchor id="viewingSource" />
<s2 title="Viewing the source">
<figure src="images/svgviewerViewSource.gif" alt="Viewing the source
code" />
<p>When the browser displays an SVG file, you can select
- the "<strong>View-> View Source...</strong>" menu item or use the
<strong>Ctrl-U</strong> keyboard accelerator to view the
+ the "<strong>View-> View Source...</strong>" menu item or use the
<strong>Ctrl-U</strong> keyboard accelerator to view the
source code.</p>
</s2>
<anchor id="viewingTree" />
<s2 title="Viewing the document tree">
<figure src="images/svgviewerViewTree.gif" alt="Viewing the document
tree" />
- <p>When the browser displays an SVG file, you can select the
"<strong>View-> DOM Viewer...</strong>"
- menu item or use the <strong>Ctrl-D</strong> keyboard accelerator to
open a dialog that shows the SVG
+ <p>When the browser displays an SVG file, you can select the
"<strong>View-> DOM Viewer...</strong>"
+ menu item or use the <strong>Ctrl-D</strong> keyboard accelerator to
open a dialog that shows the SVG
document in the form of a tree. The dialog lets you navigate the tree,
select individual
elements, such as a path element, and view the attributes and CSS
values that apply to
these elements.</p>
@@ -242,9 +242,9 @@
</s1>
<anchor id="configuring"/>
- <s1 title="Configuring the SVG Browser">
+ <s1 title="Configuring Squiggle">
- <p>The "<strong>Edit->Preferences</strong>" menu item or
<strong>Edit-G</strong>brings up the dialog box shown in the following
+ <p>The "<strong>Edit->Preferences</strong>" menu item or
<strong>Edit-G</strong>brings up the dialog box shown in the following
figure.</p>
<figure src="images/svgviewerPreferences.gif" alt="Configuring the SVG
Browser" />
@@ -258,20 +258,20 @@
figure. That panel lets you select your languages. The user language
can
be used in SVG documents to choose between alternate contents. For
example,
open the samples/moonPhases.svg example. Then, change the user language
to
- french and <link href="#reloading">reload</link> the document
(<strong>Ctrl-R</strong>).
- You will see that the text is now displayed in french. You can do the
same with Japanese and the text will be
+ french and <link href="#reloading">reload</link> the document
(<strong>Ctrl-R</strong>).
+ You will see that the text is now displayed in french. You can do the
same with Japanese and the text will be
shown in Japanes.</li>
<li><strong>Browser Options Panel</strong>. This panel lets you choose
some
optional behaviors:
<ul>
- <li><strong>Show Rendering</strong>. When on, the browser will
update the canvas
+ <li><strong>Show Rendering</strong>. When on, the browser will
update the canvas
while processing an SVG document. This turns on progressive
rendering.</li>
- <li><strong>Auto Adjust Window</strong>. When on, the browser
window is resized to fit
+ <li><strong>Auto Adjust Window</strong>. When on, the browser
window is resized to fit
any newly loaded document</li>
- <li><strong>Enable Double Buffering</strong>. When on, the
browser uses additional
+ <li><strong>Enable Double Buffering</strong>. When on, the
browser uses additional
memory resources which improves the quality of effects such as
zooming
and panning.</li>
- <li><strong>Show debug traces</strong>. When on, so debug
messages will be printed to
+ <li><strong>Show debug traces</strong>. When on, so debug
messages will be printed to
the standard output. This is only for developers.</li>
</ul>
</li>
@@ -298,15 +298,15 @@
<s2 title="Zooming in and out">
<p>There are several methods to zoom in or out an SVG Document:</p>
<ul>
- <li>You can select the <strong>View -> Zoom In</strong> or
<strong>View -> Zoom Out</strong> menu item</li>
- <li>You can <strong>click</strong> on the "<strong>Zoom
In/Out</strong>" tool bar button (the ones that show a magnifying glass
- with a "<strong>+/-</strong>" signs)</li>
- <li>You can use the "<strong>Ctrl+I</strong>" and
"<strong>Ctrl+O</strong>" keyboard acceleration</li>
- <li>If the mouse is over the document in the display area, you
can press the <strong>Ctrl key</strong>
- then <strong>click the left mouse button and drag</strong> to
select the area of interest in the document.
+ <li>You can select the <strong>View -> Zoom In</strong> or
<strong>View -> Zoom Out</strong> menu item</li>
+ <li>You can <strong>click</strong> on the "<strong>Zoom
In/Out</strong>" tool bar button (the ones that show a magnifying glass
+ with a "<strong>+/-</strong>" signs)</li>
+ <li>You can use the "<strong>Ctrl+I</strong>" and
"<strong>Ctrl+O</strong>" keyboard acceleration</li>
+ <li>If the mouse is over the document in the display area, you
can press the <strong>Ctrl key</strong>
+ then <strong>click the left mouse button and drag</strong> to
select the area of interest in the document.
This can only be used to zoom into a document.</li>
- <li>If the mouse is over the document in the display area, you
can press the <strong>Shift key</strong>
- then <strong>click the right mouse button and drag</strong> it.
This is called the '<em>real time</em>' zoom
+ <li>If the mouse is over the document in the display area, you
can press the <strong>Shift key</strong>
+ then <strong>click the right mouse button and drag</strong> it.
This is called the '<em>real time</em>' zoom
and can be used both for zooming in and out.</li>
</ul>
@@ -317,15 +317,15 @@
<anchor id="panning" />
<s2 title="Panning a document">
- <p>Some documents are too big to fit into the browser, especially
when you <link href="#zoomInOut">zoom</link> in with a
+ <p>Some documents are too big to fit into the browser, especially
when you <link href="#zoomInOut">zoom</link> in with a
large zoom factor. In these circumstances, it is usefull to be able
to 'move around' the
document and pan to view different parts of the documents. Again,
there are multiple ways
to do this:</p>
<ul>
- <li>With the mouse cursor over the SVG document, <strong>press
the Shift key</strong> and then
- <strong>click and drag the left mouse button</strong> to a new
location. When you release the
+ <li>With the mouse cursor over the SVG document, <strong>press
the Shift key</strong> and then
+ <strong>click and drag the left mouse button</strong> to a new
location. When you release the
mouse, the document will be translated to the new mouse
location.</li>
- <li>If you have the <link href="#thumbnail">thumbnail</link>
open, you can select the marker showing the current
+ <li>If you have the <link href="#thumbnail">thumbnail</link>
open, you can select the marker showing the current
area of interest and move it to the desired location</li>
</ul>
<figure src="images/svgviewerPan.gif" alt="Panning in an SVG
document" />
@@ -334,8 +334,8 @@
<anchor id="rotating" />
<s2 title="Rotating a document">
<p>It is sometimes useful to be able to rotate a document (maps for
example). You can
- do this in the Batik browser by first pressing the <strong>Ctrl
key</strong> and then <strong>clicking and dragging
- the right mouse button</strong> to a new location. The browser will
dynamically rotate the image
+ do this in the Batik browser by first pressing the <strong>Ctrl
key</strong> and then <strong>clicking and dragging
+ the right mouse button</strong> to a new location. The browser will
dynamically rotate the image
as you move your cursor. When you are satisfied with that angle,
you can release
the mouse button and the document will be displayed with that new
angle.
</p>
@@ -346,9 +346,9 @@
<p>While the mouse and keyboard interactions give interactive way
to navigate an
SVG document, it is sometimes desirable to be able to define
precisely the
- amount of <link href="#zoomInOut">zoom</link>, <link
href="#panning">pan</link> or
- <link href="#rotating">rotation</link> desired. The Transform
dialog, available through
- the "<strong>View->Transform</strong>" (<strong>Ctrl-E</strong>)
menu offers that feature.</p>
+ amount of <link href="#zoomInOut">zoom</link>, <link
href="#panning">pan</link> or
+ <link href="#rotating">rotation</link> desired. The Transform
dialog, available through
+ the "<strong>View->Transform</strong>" (<strong>Ctrl-E</strong>)
menu offers that feature.</p>
</s2>
<anchor id="thumbnail" />
@@ -356,11 +356,11 @@
<p>Panning in the document window can be difficult after you have
zoomed into a document
because you cannot see the whole document. Panning on large
documents (or with a large
zoom factor) is made easy by the thumbnail that you can bring up
through the
- "<strong>View -> Thumbnail</strong>" menu item or
<strong>Ctrl-Y</strong> keyboard acceleration. The
+ "<strong>View -> Thumbnail</strong>" menu item or
<strong>Ctrl-Y</strong> keyboard acceleration. The
thumbnail shows a rectangular marker that represents the "Area of
Interest", i.e., the
region currently displayed in the window (the visible portion of
the document). You
- can <strong>drag out a rectangular marker with the left mouse
button pushed down</strong> to select a new area
- of interest which will then be shown in the main window.</p>
+ can <strong>drag out a rectangular marker with the left mouse
button pushed down</strong> to select a new area
+ of interest which will then be shown in the main window.</p>
<figure src="images/svgviewerThumbnail.gif" alt="SVG Browser
Thumbnail" />
</s2>
</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
