vhardy 01/03/21 16:33:36
Modified: targets/batik install.html
Log:
Included PATCH from Steve Loughran.
Revision Changes Path
1.11 +46 -4 xml-site/targets/batik/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/xml-site/targets/batik/install.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- install.html 2000/12/04 16:42:11 1.10
+++ install.html 2001/03/22 00:33:32 1.11
@@ -15,6 +15,8 @@
<A href="dist" onMouseOut="rolloverOff('side-ext-26');"
onMouseOver="rolloverOn('side-ext-26');"><IMG alt="Download" border="0"
height="12" hspace="0" name="side-ext-26"
onLoad="rolloverLoad('side-ext-26','graphics/ext-26-label-2.jpg','graphics/ext-26-label-3.jpg');"
src="graphics/ext-26-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG alt="Install" border="0" height="12" hspace="0"
src="graphics/install-label-1.jpg" vspace="0" width="120"><BR>
<A href="pr.html" onMouseOut="rolloverOff('side-pr');"
onMouseOver="rolloverOn('side-pr');"><IMG alt="In the news" border="0"
height="12" hspace="0" name="side-pr"
onLoad="rolloverLoad('side-pr','graphics/pr-label-2.jpg','graphics/pr-label-3.jpg');"
src="graphics/pr-label-3.jpg" vspace="0" width="120"></A><BR>
+ <A href="change.html" onMouseOut="rolloverOff('side-change');"
onMouseOver="rolloverOn('side-change');"><IMG alt="Architecture proposal"
border="0" height="12" hspace="0" name="side-change"
onLoad="rolloverLoad('side-change','graphics/change-label-2.jpg','graphics/change-label-3.jpg');"
src="graphics/change-label-3.jpg" vspace="0" width="120"></A><BR>
+ <A href="thumbnails.html" onMouseOut="rolloverOff('side-thumbnails');"
onMouseOver="rolloverOn('side-thumbnails');"><IMG alt="Thumbnails" border="0"
height="12" hspace="0" name="side-thumbnails"
onLoad="rolloverLoad('side-thumbnails','graphics/thumbnails-label-2.jpg','graphics/thumbnails-label-3.jpg');"
src="graphics/thumbnails-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG border="0" height="6" hspace="0" src="resources/separator.gif"
vspace="0" width="120"><BR>
@@ -29,14 +31,20 @@
+ <A href="rasterizerTutorial.html"
onMouseOut="rolloverOff('side-rasterizerTutorial');"
onMouseOver="rolloverOn('side-rasterizerTutorial');"><IMG alt="Image Transcoder
Tutorial" border="0" height="12" hspace="0" name="side-rasterizerTutorial"
onLoad="rolloverLoad('side-rasterizerTutorial','graphics/rasterizerTutorial-label-2.jpg','graphics/rasterizerTutorial-label-3.jpg');"
src="graphics/rasterizerTutorial-label-3.jpg" vspace="0" width="120"></A><BR>
+ <IMG border="0" height="6" hspace="0" src="resources/separator.gif"
vspace="0" width="120"><BR>
+
+
+
+
<A href="whoAreWe.html" onMouseOut="rolloverOff('side-whoAreWe');"
onMouseOver="rolloverOn('side-whoAreWe');"><IMG alt="Who we are" border="0"
height="12" hspace="0" name="side-whoAreWe"
onLoad="rolloverLoad('side-whoAreWe','graphics/whoAreWe-label-2.jpg','graphics/whoAreWe-label-3.jpg');"
src="graphics/whoAreWe-label-3.jpg" vspace="0" width="120"></A><BR>
<A href="status.html" onMouseOut="rolloverOff('side-status');"
onMouseOver="rolloverOn('side-status');"><IMG alt="Status" border="0"
height="12" hspace="0" name="side-status"
onLoad="rolloverLoad('side-status','graphics/status-label-2.jpg','graphics/status-label-3.jpg');"
src="graphics/status-label-3.jpg" vspace="0" width="120"></A><BR>
-
+ <A href="changes.html" onMouseOut="rolloverOff('side-changes');"
onMouseOver="rolloverOn('side-changes');"><IMG alt="Changes" border="0"
height="12" hspace="0" name="side-changes"
onLoad="rolloverLoad('side-changes','graphics/changes-label-2.jpg','graphics/changes-label-3.jpg');"
src="graphics/changes-label-3.jpg" vspace="0" width="120"></A><BR>
- <A href="http://xml.apache.org/websrc/index.cgi/xml-batik/";
onMouseOut="rolloverOff('side-ext-64');"
onMouseOver="rolloverOn('side-ext-64');"><IMG alt="CVS Repository" border="0"
height="12" hspace="0" name="side-ext-64"
onLoad="rolloverLoad('side-ext-64','graphics/ext-64-label-2.jpg','graphics/ext-64-label-3.jpg');"
src="graphics/ext-64-label-3.jpg" vspace="0" width="120"></A><BR>
+ <A href="http://xml.apache.org/websrc/index.cgi/xml-batik/";
onMouseOut="rolloverOff('side-ext-78');"
onMouseOver="rolloverOn('side-ext-78');"><IMG alt="CVS Repository" border="0"
height="12" hspace="0" name="side-ext-78"
onLoad="rolloverLoad('side-ext-78','graphics/ext-78-label-2.jpg','graphics/ext-78-label-3.jpg');"
src="graphics/ext-78-label-3.jpg" vspace="0" width="120"></A><BR>
- <A href="http://mail-archives.apache.org/";
onMouseOut="rolloverOff('side-ext-68');"
onMouseOver="rolloverOn('side-ext-68');"><IMG alt="Mail Archive" border="0"
height="12" hspace="0" name="side-ext-68"
onLoad="rolloverLoad('side-ext-68','graphics/ext-68-label-2.jpg','graphics/ext-68-label-3.jpg');"
src="graphics/ext-68-label-3.jpg" vspace="0" width="120"></A><BR>
- <A href="http://xml.apache.org/bugs/";
onMouseOut="rolloverOff('side-ext-70');"
onMouseOver="rolloverOn('side-ext-70');"><IMG alt="Bug Database" border="0"
height="12" hspace="0" name="side-ext-70"
onLoad="rolloverLoad('side-ext-70','graphics/ext-70-label-2.jpg','graphics/ext-70-label-3.jpg');"
src="graphics/ext-70-label-3.jpg" vspace="0" width="120"></A><BR>
+ <A href="http://mail-archives.apache.org/";
onMouseOut="rolloverOff('side-ext-82');"
onMouseOver="rolloverOn('side-ext-82');"><IMG alt="Mail ArchiVe" border="0"
height="12" hspace="0" name="side-ext-82"
onLoad="rolloverLoad('side-ext-82','graphics/ext-82-label-2.jpg','graphics/ext-82-label-3.jpg');"
src="graphics/ext-82-label-3.jpg" vspace="0" width="120"></A><BR>
+ <A href="http://xml.apache.org/bugs/";
onMouseOut="rolloverOff('side-ext-84');"
onMouseOver="rolloverOn('side-ext-84');"><IMG alt="Bug Database" border="0"
height="12" hspace="0" name="side-ext-84"
onLoad="rolloverLoad('side-ext-84','graphics/ext-84-label-2.jpg','graphics/ext-84-label-3.jpg');"
src="graphics/ext-84-label-3.jpg" vspace="0" width="120"></A><BR>
<IMG border="0" height="6" hspace="0" src="resources/separator.gif"
vspace="0" width="120"><BR>
@@ -60,6 +68,7 @@
<LI><A href="#systemRequirements">System
Requirements</A></LI>
<LI><A href="#distributions">Choosing a download from the
distribution</A></LI>
<LI><A href="#optionalComponents">OptionalComponents</A></LI>
+ <LI><A href="#serverSide">Using Batik server side</A></LI>
</UL></BLOCKQUOTE>
</FONT></TD></TR></TABLE></DIV><BR>
@@ -160,6 +169,39 @@
distribution.
</P>
</FONT></TD></TR></TABLE></DIV><BR>
+
+
+ <A name="serverSide"><!--anchor--></A>
+ <DIV align="right"><TABLE border="0" cellpadding="0"
cellspacing="0" width="98%"><TR><TD align="right" height="7" valign="bottom"
width="9"><IMG border="0" height="7" hspace="0"
src="resources/bar-top-left.gif" vspace="0" width="9"></TD><TD
background="resources/bar-border-top.gif"><IMG border="0" height="5" hspace="0"
src="resources/void.gif" vspace="0" width="1"></TD><TD align="left" height="7"
valign="bottom" width="9"><IMG border="0" height="7" hspace="0"
src="resources/bar-top-right.gif" vspace="0" width="9"></TD></TR><TR><TD
background="resources/bar-border-left.gif" width="9"><IMG border="0" height="1"
hspace="0" src="resources/void.gif" vspace="0" width="9"></TD><TD
bgcolor="#0086b2" width="100%"><FONT color="#ffffff"
face="arial,helvetica,sanserif" size="+1"><IMG border="0" height="5" hspace="0"
src="resources/void.gif" vspace="0" width="5"><B>Server Side
Installation</B></FONT></TD><TD background="resources/bar-border-right.gif"
width="9"><IMG border="0" height="1" hspace="0" src="resources/void.gif"
vspace="0" width="9"></TD></TR><TR><TD align="right" height="12" valign="top"
width="9"><IMG border="0" height="12" hspace="0"
src="resources/bar-bottom-left.gif" vspace="0" width="9"></TD><TD
background="resources/bar-border-bottom.gif"><IMG border="0" height="12"
hspace="0" src="resources/void.gif" vspace="0"></TD><TD align="left"
height="12" valign="top" width="9"><IMG border="0" height="12" hspace="0"
src="resources/bar-bottom-right.gif" vspace="0"
width="9"></TD></TR></TABLE><TABLE border="0" cellpadding="0" cellspacing="0"
width="98%"><TR><TD><FONT color="#000000" face="arial,helvetica,sanserif">
+ <P>
+ Batik will run on a server, such as behind a servlet or as part of
a j2ee application.
+ To use batik in a servlet, the batik .jar libraries should be
included in the .war file
+ deployed to the server. On web servers implementing the 2.2
specification of servlets or
+ earlier is also critical to ensure that the versions of jaxp.jar
and crimson.jar of the web
+ server are up to date with the needs of Batik. Copying the batik
supplied versions of these
+ jar files into the server's lib directory (such as TOMCAT_HOME/lib)
will ensure this.
+ </P><P>
+ On servers which do not support the .war distribution format,
+ the batik libraries must be manually deployed and added to the
+ classpath.
+ </P>
+ <P>
+ Batik uses the Java2D drawing API, which is somewhat dependent on
the
+ imaging system of the underlying operating system. When
+ deploying to a Unix server, there must be an X11 server running
+ locally, or at the host named in the DISPLAY environment variable.
+ This is a known issue
+ (see that <A
href="http://java.sun.com/products/java-media/2D/forDevelopers/java2dfaq.html#xvfb";>
+ page</A> for information) of the Java 2D API, which will be
addressed in future.
+ </P><P>
+ Finally, note that the SVGGraphics2D class is not designed to be
+ used by concurrent threads (that would amount to having concurrent
threads
+ drawing to a single canvas). Therefore, SVGGraphics2D is not
thread-safe and only one
+ thread at a time should be rendering to a single
+ graphics object -so do not store a single transcoder or other
+ Batik object for use among all threads calling a single servlet.
+ </P>
+ </FONT></TD></TR></TABLE></DIV><BR>
</TD></TR></TABLE></TD></TR></TABLE><BR><TABLE border="0" cellpadding="0"
cellspacing="0" width="100%"><TR><TD bgcolor="#0086b2"><IMG height="1"
src="images/dot.gif" width="1"></TD></TR><TR><TD align="center"><FONT
color="#0086b2" face="arial,helvetica,sanserif" size="-1"><I>
Copyright © 2000 The Apache Software Foundation.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
