You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by vm...@apache.org on 2003/04/22 21:12:33 UTC
cvs commit: xml-fop/src/documentation/content/xdocs graphics.xml
vmote 2003/04/22 12:12:33
Modified: src/documentation/content/xdocs graphics.xml
Log:
Expand discussion of graphics resolutions.
Revision Changes Path
1.3 +7 -5 xml-fop/src/documentation/content/xdocs/graphics.xml
Index: graphics.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/graphics.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- graphics.xml 22 Apr 2003 18:24:28 -0000 1.2
+++ graphics.xml 22 Apr 2003 19:12:33 -0000 1.3
@@ -278,11 +278,13 @@
</section>
<section id="resolution">
<title>Graphics Resolution</title>
- <p>This is an important issue when creating output for printing.
-The dpi is used to convert measurements into points. For example 1in
-= 2.54cm = 72 points. It is also used when determining the size of
-images and the rendering of certain graphics in the output. Currently
-FOP uses a value of 72dpi.</p>
+ <p>Some bitmapped image file formats store a dots-per-inch (dpi) or other resolution value. Since PDF and most output formats do not have a concept of resolution, but only of absolute image units (i.e. pixels) FOP ignores the resolution values as well. Instead, FOP uses the dimensions of the image as specified in the fo:external-graphic element to render the image:</p>
+ <ul>
+ <li>If no dimensions are given, FOP uses a default value of 72 dpi to compute the graphic's dimensions. For example, suppose a graphic 300 pixels wide and 400 pixels high. FOP will render the graphic at 4.167 inches wide, 5.555 inches high, with an apparent resolution of 72 dpi.</li>
+ <li>If only one dimension is given, FOP by default uses the same aspect ratio to compute the other dimension (to avoid the appearance of stretching). For example, suppose a graphic 300 pixels wide and 400 pixels high, for which content-width = ".5in". FOP will compute the content-height = .667 inches, and will render the graphic at that size, with an apparent resolution of 600 dpi.</li>
+ <li>If both dimensions are given, FOP simply renders the image in that space. For example, suppose a graphic 300 pixels wide and 400 pixels high, for which content-width = "3in" and content-height = "4in". FOP will render the graphic at that size, with an apparent resolution of 100 dpi.</li>
+ </ul>
+ <note>The explanation above describes only the basic default behavior. There are other attributes of the fo:external-graphic element that can affect the behavior described above.</note>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: fop-cvs-help@xml.apache.org