You are viewing a plain text version of this content. The canonical link for it is here.
Posted to batik-dev@xmlgraphics.apache.org by de...@apache.org on 2002/06/21 15:28:05 UTC
cvs commit: xml-batik/xdocs extendingBatik.xml faq.xml security.xml svgviewer.xml
deweese 2002/06/21 06:28:05
Modified: resources/org/apache/batik/apps/svgbrowser/resources
Main.properties svgbrowser.bin.policy
sources batik.mf
sources/org/apache/batik/apps/svgbrowser Main.java
test-sources/org/apache/batik/util
ApplicationSecurityEnforcerTest.java
xdocs extendingBatik.xml faq.xml security.xml
svgviewer.xml
Log:
Updated everything with squiggle for svgbrowser
Revision Changes Path
1.6 +2 -2 xml-batik/resources/org/apache/batik/apps/svgbrowser/resources/Main.properties
Index: Main.properties
===================================================================
RCS file: /home/cvs/xml-batik/resources/org/apache/batik/apps/svgbrowser/resources/Main.properties,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Main.properties 20 Jun 2002 15:33:56 -0000 1.5
+++ Main.properties 21 Jun 2002 13:28:05 -0000 1.6
@@ -31,7 +31,7 @@
Command.syntax = \
Syntax:\n\
-\tsvgbrowser [options] <svg file>
+\tsquiggle [options] <svg file>
Command.options = \
Available Options:
1.7 +1 -1 xml-batik/resources/org/apache/batik/apps/svgbrowser/resources/svgbrowser.bin.policy
Index: svgbrowser.bin.policy
===================================================================
RCS file: /home/cvs/xml-batik/resources/org/apache/batik/apps/svgbrowser/resources/svgbrowser.bin.policy,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- svgbrowser.bin.policy 17 Jun 2002 08:07:38 -0000 1.6
+++ svgbrowser.bin.policy 21 Jun 2002 13:28:05 -0000 1.7
@@ -5,7 +5,7 @@
permission java.security.AllPermission;
};
-grant codeBase "${app.jar.base}/batik-svgbrowser.jar" {
+grant codeBase "${app.jar.base}/batik-squiggle.jar" {
permission java.security.AllPermission;
};
1.5 +1 -1 xml-batik/sources/batik.mf
Index: batik.mf
===================================================================
RCS file: /home/cvs/xml-batik/sources/batik.mf,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- batik.mf 10 Apr 2002 07:23:10 -0000 1.4
+++ batik.mf 21 Jun 2002 13:28:05 -0000 1.5
@@ -16,7 +16,7 @@
lib/batik-xml.jar \
lib/batik-root.jar \
lib/batik-svggen.jar \
- batik-svgbrowser.jar \
+ batik-squiggle.jar \
batik-rasterizer.jar \
batik-pp.jar \
lib/crimson-parser.jar \
1.38 +2 -2 xml-batik/sources/org/apache/batik/apps/svgbrowser/Main.java
Index: Main.java
===================================================================
RCS file: /home/cvs/xml-batik/sources/org/apache/batik/apps/svgbrowser/Main.java,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- Main.java 18 Jun 2002 12:38:02 -0000 1.37
+++ Main.java 21 Jun 2002 13:28:05 -0000 1.38
@@ -162,7 +162,7 @@
* Name of the batik browser jar file
*/
public static final String SQUIGGLE_JAR_NAME
- = "batik-svgbrowser.jar";
+ = "batik-squiggle.jar";
/**
* URL for Squiggle's security policy file
1.2 +2 -2 xml-batik/test-sources/org/apache/batik/util/ApplicationSecurityEnforcerTest.java
Index: ApplicationSecurityEnforcerTest.java
===================================================================
RCS file: /home/cvs/xml-batik/test-sources/org/apache/batik/util/ApplicationSecurityEnforcerTest.java,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- ApplicationSecurityEnforcerTest.java 3 May 2002 09:34:20 -0000 1.1
+++ ApplicationSecurityEnforcerTest.java 21 Jun 2002 13:28:05 -0000 1.2
@@ -19,7 +19,7 @@
public class ApplicationSecurityEnforcerTest extends DefaultTestSuite {
final static Class APP_MAIN_CLASS = org.apache.batik.apps.svgbrowser.Main.class;
final static String APP_SECURITY_POLICY = "org/apache/batik/apps/svgbrowser/resources/svgbrowser.policy";
- final static String APP_JAR = "batik-svgbrowser.jar";
+ final static String APP_JAR = "batik-squiggle.jar";
/**
* In the constructor, append atomic tests
1.13 +13 -17 xml-batik/xdocs/extendingBatik.xml
Index: extendingBatik.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/extendingBatik.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- extendingBatik.xml 18 Jun 2002 17:01:51 -0000 1.12
+++ extendingBatik.xml 21 Jun 2002 13:28:05 -0000 1.13
@@ -76,25 +76,21 @@
</p>
<dl>
<dt> Having your tags appear in the DOM tree. </dt>
- <dd><br/>
- As long as your custom tags are well formed (and
- preferably valid) XML they will appear in the SVG DOM
- tree. When rendering Batik will skip branches of the
- tree that use a tag it doesn't know about (so even if
- standard SVG tags are child nodes they will not be
- displayed).
- <br/>
- It is strongly suggested that you make use of XML
- namespaces for your personal tags even if you are not
- planning on validating the XML.
- <br/>
+ <dd><br/> As long as your custom tags are well formed
+ (and preferably valid) XML they will appear in the SVG
+ DOM tree. When rendering Batik will skip branches of
+ the tree that use a tag it doesn't know about (so even
+ if standard SVG tags are child nodes they will not be
+ displayed). <br/> It is strongly suggested that you
+ make use of XML namespaces for your personal tags even
+ if you are not planning on validating the XML. <br/>
This can be useful if you want to add extra pieces of
data into the standard SVG drawing. These might be
annotations, or other application specific data. In
- general this wouldn't be particularly useful with the
- svgbrowser or rasterizer, but might be very useful if
- you were writing a custom browser, rasterizer, or
- pre/post processing tools.
+ general this wouldn't be particularly useful with
+ squiggle (the SVG browser) or the rasterizer, but
+ might be very useful if you were writing a custom
+ browser, rasterizer, or pre/post processing tools.
</dd>
<dt> Tags use a custom element in the DOM tree</dt>
1.32 +58 -45 xml-batik/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/faq.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- faq.xml 18 Jun 2002 17:01:51 -0000 1.31
+++ faq.xml 21 Jun 2002 13:28:05 -0000 1.32
@@ -118,7 +118,7 @@
<p>
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
+ <link href="svgviewer.html">Squiggle</link> (in the
<code>org.apache.batik.apps.svgbrowser</code> package) an
<link href="svgrasterizer.html">SVG rasterizer</link> (in the
<code>org.apache.batik.apps.rasterizer</code> package), a
@@ -127,58 +127,71 @@
<link href="svgpp.html">SVG pretty printer</link> (in the
<code>org.apache.batik.apps.svgpp package</code>).</p>
<p>
- 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.
- </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
- 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
- a piece of text or a color), and generate another PNG image from it. This
- way, you can easily generate a series of images sharing a common
- theme or look and feel to post on a web site (note that the rasterizer
- 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
- 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
- be displayed exactly as it was authored on all platforms.
+ <strong>Squiggle</strong> the SVG browser <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.
+ </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 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 a piece of text or a color), and
+ generate another PNG image from it. This way, you can easily
+ generate a series of images sharing a common theme or look and
+ feel to post on a web site (note that the rasterizer 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 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 be displayed
+ exactly as it was authored on all platforms.
</p>
<p>
- 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>
+ 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.
+ <!-- <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.
- 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
- of Java2D drawing calls for the pie chart to a SVG format.
+ 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 of Java2D drawing calls for the pie
+ chart to a SVG format.
</p>
-->
<p>
- These applications show that Batik can be used client side (the browser
- can be used on any client machine) and server side (the rasterizer can be
- used to serve SVG images to client machines that do not have SVG support).
+ These applications show that Batik can be used client side
+ (the browser can be used on any client machine) and server
+ side (the rasterizer can be used to serve SVG images to client
+ machines that do not have SVG support).
</p>
<p>
- The <link href="svgviewer.html">Squiggle SVG Browser</link> and the
+ <link href="svgviewer.html">Squiggle</link> the SVG browser 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
@@ -197,7 +210,7 @@
<question>How can I see a demo?</question>
<answer>
<p>
- You can see an online demonstration of the Squiggle SVG browser
+ You can see an online demonstration of Squiggle the SVG browser
on the <link href="batikDemo.html">demo page</link>. Alternatively,
you can <link href="dist">download</link>
Batik or see
1.2 +22 -17 xml-batik/xdocs/security.xml
Index: security.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/security.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- security.xml 17 Jun 2002 11:43:37 -0000 1.1
+++ security.xml 21 Jun 2002 13:28:05 -0000 1.2
@@ -81,23 +81,28 @@
<ul>
<li>The default policy is defined by the policy file found
in the distribution: <code>org/apache/batik/apps/svgbrowser/svgbrowser.policy</code>.
- In the binary distribution, that file would be in the <code>batik-svgbrowser.jar</code>
- file. In the source distribution, that file would be in the
- <code>resources</code> directory.
- The default policy file gives appropriate permissions to
- the Batik code, the XML parser and the Rhino scripting engine and very limited
- permissions to scripts. </li>
- <li>At startup time, and whenever the preference settings are
- modified, Squiggle makes a copy of the default policy and appends any
- additional permissions granted to scripts by the user through the
- preference settings. This policy file can be found in the
- <code>[user.home]/.batik</code> directory. It is called <code>__svgbrowser.policy</code>.
- Note that this file is automatically generated and should not be
+ In the binary distribution, that file would be in the
+ <code>batik-squiggle.jar</code> file. In the source
+ distribution, that file would be in the
+ <code>resources</code> directory. The default policy
+ file gives appropriate permissions to the Batik code,
+ the XML parser and the Rhino scripting engine and very
+ limited permissions to scripts. </li> <li>At startup
+ time, and whenever the preference settings are
+ modified, Squiggle makes a copy of the default policy
+ and appends any additional permissions granted to
+ scripts by the user through the preference
+ settings. This policy file can be found in the
+ <code>[user.home]/.batik</code> directory. It is
+ called <code>__svgbrowser.policy</code>. Note that
+ this file is automatically generated and should not be
modified manually (as any edits would be lost).</li>
- <li>The policy defined as described above is enforced unless
- the <code>java.security.policy</code> system property is defined. In that
- case, the policy defined by the system property takes precedence and the
- policy file generated from the Squiggle preferences is ignored.</li>
+ <li>The policy defined as described above is enforced
+ unless the <code>java.security.policy</code> system
+ property is defined. In that case, the policy defined
+ by the system property takes precedence and the policy
+ file generated from the Squiggle preferences is
+ ignored.</li>
</ul>
<p><strong>Important Note</strong></p>
1.18 +263 -137 xml-batik/xdocs/svgviewer.xml
Index: svgviewer.xml
===================================================================
RCS file: /home/cvs/xml-batik/xdocs/svgviewer.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- svgviewer.xml 18 Jun 2002 17:01:51 -0000 1.17
+++ svgviewer.xml 21 Jun 2002 13:28:05 -0000 1.18
@@ -16,7 +16,7 @@
<document>
<header>
- <title>Squiggle - SVG Browser</title>
+ <title>Squiggle - the SVG Browser</title>
<subtitle>A cross platform SVG Browser</subtitle>
<authors>
<person name="Vincent Hardy" email="vincent.hardy@eng.sun.com"/>
@@ -25,9 +25,10 @@
<body>
<s1 title="Introduction">
- <!-- <figure src="images/viewerBanner.jpg" alt="Squiggle SVG Browser"/> -->
+ <!-- <figure src="images/viewerBanner.jpg"
+ alt="Squiggle SVG Browser"/> -->
<p>
- This page describes the main features of the Squiggle SVG Browser that comes with Batik.
+ This page describes the main features of Squiggle the SVG browser that comes with Batik.
It discusses the following:</p>
<ul>
<li><link href="#downloading">Downloading and installing the browser</link></li>
@@ -64,12 +65,12 @@
<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,
+ created a <code>batik-squiggle.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-squiggle.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-squiggle.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,8 +78,8 @@
</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
+ <li><code>java -jar batik-squiggle.jar -font-size 10</code> starts the browser with small fonts.</li>
+ <li><code>java -jar batik-squiggle.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>
@@ -100,13 +101,13 @@
<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 squiggle</code><br />
+ <strong>UNIX: </strong><code>build.sh squiggle</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><strong>Windows: </strong><code>build squiggle </code><em>[</em><code>-font-size</code><em> <fontSize>] [svgURL]*</em></p>
+ <p><strong>UNIX: </strong><code>build.sh squiggle</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
@@ -114,18 +115,24 @@
</s2>
<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"/>
+ <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="Squiggle - the SVG browser"/>
</s2>
</s1>
<anchor id="viewing"/>
<s1 title="Viewing SVG Documents">
- <p>The browser has several features to view and browse SVG documents:</p>
+ <p>The browser has several features to view and browse SVG
+ documents:</p>
<ul>
<li><link href="#localFile">Opening a local SVG file</link></li>
<li><link href="#urlFile">Opening an SVG file from the web</link></li>
@@ -137,148 +144,221 @@
<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 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>
+ <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 Squiggle"/>
+ <figure src="images/svgviewerFileOpen.gif"
+ alt="File Open in Squiggle - the SVG browser"/>
</s2>
<anchor id="urlFile" />
<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 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>
+ <p>There are many situations where the SVG content you
+ want to view is not local to the machine 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"/>
+ <figure src="images/svgviewerOpenPage.gif"
+ alt="Open Page in Squiggle - the SVG browser"/>
</s2>
<anchor id="locationBar" />
<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 Squiggle, the same way you can enter a
- URL in an HTML browser</p>
+ <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 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"/>
+ <figure src="images/svgviewerLocationBar.gif"
+ alt="Location Bar in Squiggle - the SVG browser"/>
</s2>
<anchor id="browsing" />
<s2 title="Browsing SVG Files">
- <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>
- <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>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>
+
+ <figure src="images/svgviewerBrowsing.gif"
+ alt="Browsing SVG files" />
+ <p>Squiggle, the 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)
- 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,
- 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
- and want to go back to any previous view you had of the document (i.e., before you panned or
- rotated it).</li>
+ <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, 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 and want
+ to go back to any previous view you had of the
+ document (i.e., before you panned or rotated it).</li>
</ul>
</s2>
<anchor id="viewingMultiple" />
<s2 title="Viewing multiple SVG files">
- <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>
+ <figure src="images/svgviewerMultipleFiles.gif"
+ alt="Viewing multiple files" />
+
+ <p>Squiggle, the 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>
+
</s2>
<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
- document to be reprocessed by the browser.</p>
+ <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 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>Ctrl-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
+ <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>
<anchor id="viewingSource" />
<s2 title="Viewing the source">
- <figure src="images/svgviewerViewSource.gif" alt="Viewing the source code" />
+ <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
- source code.</p>
+ 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
- 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>
+ <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 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>
</s2>
</s1>
<anchor id="configuring"/>
<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
- figure.</p>
- <figure src="images/svgviewerPreferences.gif" alt="Configuring the SVG Browser" />
+ <p>The "<strong>Edit->Preferences</strong>" menu item or
+ <strong>Ctrl-G</strong>brings up the dialog box shown in the
+ following figure.</p>
+
+ <figure src="images/svgviewerPreferences.gif"
+ alt="Configuring Squiggle- the SVG browser" />
<p>This dialog contains several types of options, which can be selected with
the left-hand side list. For each type of option, a panel lets you configure various
browser parameters:</p>
<ul>
- <li><strong>Network Options Panel</strong>. This panel lets you configure the
- proxy server to use if you are working from behind a firewall.</li>
- <li><strong>Languages Panel</strong>. This is the panel shown in the above
- 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
- shown in Japanes.</li>
- <li><strong>Browser Options Panel</strong>. This panel lets you choose some
- optional behaviors:
+ <li><strong>Network Options Panel</strong>. This panel
+ lets you configure the proxy server to use if you are
+ working from behind a firewall.</li>
+
+ <li><strong>Languages Panel</strong>. This is the panel
+ shown in the above 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 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
- 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
- any newly loaded document</li>
- <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
- the standard output. This is only for developers.</li>
+ <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 any newly
+ loaded document</li>
+
+ <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 the standard
+ output. This is only for developers.</li>
</ul>
</li>
- <li><strong>Stylesheet Panel</strong>. This panel lets you specify a user
- stylesheet which can override some of the default settings in viewed SVG
- documents. This might be useful if you want, for example, to override the
- font size used in text elements.</li>
+
+ <li><strong>Stylesheet Panel</strong>. This panel lets you
+ specify a user stylesheet which can override some of the
+ default settings in viewed SVG documents. This might be
+ useful if you want, for example, to override the font size
+ used in text elements.</li>
</ul>
</s1>
@@ -298,70 +378,116 @@
<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.
- 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
- and can be used both for zooming in and out.</li>
+ <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 and can
+ be used both for zooming in and out.</li>
</ul>
- <figure src="images/svgviewerZoomin.gif" alt="Zooming in an SVG document" />
- <figure src="images/svgviewerAOI.gif" alt="Zooming in an SVG document" />
+ <figure src="images/svgviewerZoomin.gif"
+ alt="Zooming in an SVG document" />
+ <figure src="images/svgviewerAOI.gif"
+ alt="Zooming in an SVG document" />
</s2>
<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
- 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>
+ <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
- 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
- area of interest and move it to the desired location</li>
+ <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 area of
+ interest and move it to the desired location</li>
</ul>
- <figure src="images/svgviewerPan.gif" alt="Panning in an SVG document" />
+ <figure src="images/svgviewerPan.gif"
+ alt="Panning in an SVG document" />
</s2>
<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
- 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>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 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>
</s2>
<anchor id="transform" />
<s2 title="Using the Transform Dialog">
- <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>
+ <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>
</s2>
<anchor id="thumbnail" />
<s2 title="Thumbnail">
- <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
- 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>
- <figure src="images/svgviewerThumbnail.gif" alt="SVG Browser Thumbnail" />
+ <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
+ 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>
+
+ <figure src="images/svgviewerThumbnail.gif"
+ alt="Squiggle - the SVG browser, Thumbnail" />
</s2>
</s1>
---------------------------------------------------------------------
To unsubscribe, e-mail: batik-dev-unsubscribe@xml.apache.org
For additional commands, e-mail: batik-dev-help@xml.apache.org