aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/examples/svg/boxes.svg11
-rw-r--r--docs/examples/svg/embedding.fo82
-rw-r--r--docs/examples/svg/external.fo97
-rw-r--r--docs/examples/svg/multi.svg14
-rw-r--r--docs/examples/svg/ref.svg10
5 files changed, 212 insertions, 2 deletions
diff --git a/docs/examples/svg/boxes.svg b/docs/examples/svg/boxes.svg
new file mode 100644
index 000000000..b86c9b8d2
--- /dev/null
+++ b/docs/examples/svg/boxes.svg
@@ -0,0 +1,11 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20000802//EN"
+"http://www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd">
+
+<svg width="20" height="20" xml:space="preserve">
+ <g style="fill:red; stroke:#000000">
+ <rect x="0" y="0" width="15" height="15"/>
+ <rect x="5" y="5" width="15" height="15"/>
+ </g>
+</svg>
+
diff --git a/docs/examples/svg/embedding.fo b/docs/examples/svg/embedding.fo
index 9c24fa7e2..0a38ae40a 100644
--- a/docs/examples/svg/embedding.fo
+++ b/docs/examples/svg/embedding.fo
@@ -766,7 +766,7 @@
</fo:block>
<fo:block text-align="center">
-Some examples of how to embed an SVG image inside you FO documents
+Some examples of how to embed an SVG image inside your FO documents
</fo:block>
<fo:block break-before="page" space-after.optimum="10pt" font-weight="bold" font-size="12pt">
@@ -936,7 +936,7 @@ Sizing
<fo:table-row>
<fo:table-cell number-columns-spanned="2">
<fo:block space-before.optimum="5pt">
-Specify the size on the instream-foreign-object element.
+Specify the size on the instream-foreign-object element. <fo:inline color="red">Note: currently not functional, bug.</fo:inline>
</fo:block>
</fo:table-cell>
</fo:table-row>
@@ -972,6 +972,84 @@ Specify the size on the instream-foreign-object element.
</fo:block>
</fo:table-cell>
</fo:table-row>
+
+ <fo:table-row keep-with-next="always">
+ <fo:table-cell number-columns-spanned="2">
+ <fo:block space-before.optimum="5pt">
+Specify the size on the svg document element.
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+
+ <fo:table-row>
+ <fo:table-cell>
+ <fo:block font-size="8pt" white-space-collapse="false" space-before.optimum="5pt">
+<![CDATA[
+<fo:instream-foreign-object>
+<svg:svg width="20pt" height="20pt">
+ <svg:g style="fill:red; stroke:#000000">
+ <svg:rect x="0" y="0" width="15" height="15"/>
+ <svg:rect x="5" y="5" width="15" height="15"/>
+ </svg:g>
+</svg:svg>
+</fo:instream-foreign-object>
+]]>
+
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell>
+ <fo:block space-before.optimum="15pt">
+<fo:instream-foreign-object>
+<svg:svg width="20pt" height="20pt">
+ <svg:g style="fill:red; stroke:#000000">
+ <svg:rect x="0" y="0" width="15" height="15"/>
+ <svg:rect x="5" y="5" width="15" height="15"/>
+ </svg:g>
+</svg:svg>
+</fo:instream-foreign-object>
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+
+ <fo:table-row keep-with-next="always">
+ <fo:table-cell number-columns-spanned="2">
+ <fo:block space-before.optimum="5pt">
+Specify the size on the svg document element and for the content size on the instream-foreign-object.
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+
+ <fo:table-row>
+ <fo:table-cell>
+ <fo:block font-size="8pt" white-space-collapse="false" space-before.optimum="5pt">
+<![CDATA[
+<fo:instream-foreign-object content-width="40pt" content-height="40pt">
+<svg:svg width="20pt" height="20pt">
+ <svg:g style="fill:red; stroke:#000000">
+ <svg:rect x="0" y="0" width="15" height="15"/>
+ <svg:rect x="5" y="5" width="15" height="15"/>
+ </svg:g>
+</svg:svg>
+</fo:instream-foreign-object>
+]]>
+
+ </fo:block>
+ </fo:table-cell>
+ <fo:table-cell>
+ <fo:block space-before.optimum="15pt">
+<fo:instream-foreign-object content-width="40pt" content-height="40pt">
+<svg:svg width="20pt" height="20pt">
+ <svg:g style="fill:red; stroke:#000000">
+ <svg:rect x="0" y="0" width="15" height="15"/>
+ <svg:rect x="5" y="5" width="15" height="15"/>
+ </svg:g>
+</svg:svg>
+</fo:instream-foreign-object>
+ </fo:block>
+ </fo:table-cell>
+ </fo:table-row>
+
+
</fo:table-body>
</fo:table>
diff --git a/docs/examples/svg/external.fo b/docs/examples/svg/external.fo
new file mode 100644
index 000000000..775eb508b
--- /dev/null
+++ b/docs/examples/svg/external.fo
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">
+ <fo:layout-master-set>
+ <fo:simple-page-master
+ margin-right="1.5cm"
+ margin-left="1.5cm"
+ margin-bottom="2cm"
+ margin-top="1cm"
+ page-width="21cm"
+ page-height="29.7cm"
+ master-name="first">
+ <fo:region-before extent="1cm"/>
+ <fo:region-body margin-top="1cm"/>
+ <fo:region-after extent="1.5cm"/>
+ </fo:simple-page-master>
+ </fo:layout-master-set>
+
+ <fo:page-sequence master-name="first">
+ <fo:static-content flow-name="xsl-region-before">
+ <fo:block line-height="14pt" font-size="10pt"
+ text-align="end">External SVG examples</fo:block>
+ </fo:static-content>
+ <fo:static-content flow-name="xsl-region-after">
+ <fo:block line-height="14pt" font-size="10pt"
+ text-align="end">Page <fo:page-number/></fo:block>
+ </fo:static-content>
+
+ <fo:flow flow-name="xsl-region-body">
+
+ <fo:block text-align="center" font-weight="bold" font-size="14pt" space-before.optimum="3pt" space-after.optimum="15pt">
+ External SVG
+ </fo:block>
+
+ <fo:block space-before.optimum="3pt" space-after.optimum="20pt">
+
+
+ </fo:block>
+
+ <fo:block text-align="center">
+Some examples of how to reference external SVG images in your FO documents
+ </fo:block>
+
+ <fo:block break-before="page" space-after.optimum="10pt" font-weight="bold" font-size="12pt">
+Introduction
+ </fo:block>
+
+ <fo:block>
+This document shows some examples of how an SVG document can be in an external svg file
+which is referenced using the fo:external-graphic.
+ </fo:block>
+
+ <fo:block>
+ </fo:block>
+
+ <fo:block space-after.optimum="10pt" font-weight="bold" font-size="12pt">
+Examples
+ </fo:block>
+
+ <fo:block>
+The following svg document is obtained from an external file using the fo:external-graphic.
+ </fo:block>
+
+ <fo:block>
+<fo:external-graphic src="file:boxes.svg"/>
+ </fo:block>
+
+ <fo:block>
+This svg document (<fo:external-graphic src="file:multi.svg"/>) is also obtained from
+an external file using the fo:external-graphic. It has another svg image inside and references
+part of another svg image.
+ </fo:block>
+
+ <fo:block>
+This inline svg document (
+<fo:instream-foreign-object>
+<svg xmlns="http://www.w3.org/2000/svg" width="60" height="40" xml:space="preserve">
+ <g style="fill:none;stroke:yellow">
+ <rect x="0" y="0" width="25" height="25"/>
+ <image xlink:href="file:boxes.svg" x="10" y="10" width="20" height="20"/>
+ </g>
+ <g>
+ <use xlink:href="file:ref.svg#FOP" transform="scale(1.5)" x="18" y="40"/>
+ </g>
+</svg>
+</fo:instream-foreign-object>
+) has an external svg image inside and references part of another svg image.
+ </fo:block>
+
+ <fo:block>
+Apart from this external svg images should behave in the same way that other types of
+external graphics do.
+ </fo:block>
+
+ </fo:flow>
+ </fo:page-sequence>
+</fo:root>
+
diff --git a/docs/examples/svg/multi.svg b/docs/examples/svg/multi.svg
new file mode 100644
index 000000000..9e68d9a30
--- /dev/null
+++ b/docs/examples/svg/multi.svg
@@ -0,0 +1,14 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20000802//EN"
+"http://www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd">
+
+<svg width="60" height="40" xml:space="preserve">
+ <g style="fill:none;stroke:yellow">
+ <rect x="0" y="0" width="25" height="25"/>
+ <image xlink:href="file:boxes.svg" x="10" y="10" width="20" height="20"/>
+ </g>
+ <g>
+ <use xlink:href="file:ref.svg#FOP" transform="scale(1.5)" x="18" y="40"/>
+ </g>
+</svg>
+
diff --git a/docs/examples/svg/ref.svg b/docs/examples/svg/ref.svg
new file mode 100644
index 000000000..e3f75c6a0
--- /dev/null
+++ b/docs/examples/svg/ref.svg
@@ -0,0 +1,10 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20000802//EN"
+"http://www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd">
+
+<svg width="20" height="20" xml:space="preserve">
+ <g id="FOP">
+ <text x="0" y="0" style="fill:black;font-weight:bold;font-size:14"><tspan style="fill:red">F</tspan><tspan style="fill:purple">O</tspan><tspan style="fill:blue">P</tspan></text>
+ </g>
+</svg>
+
generated by cgit v1.2.3 (git 2.39.1) at 2024-12-27 01:43:38 +0000