From: William Victor Mote Date: Tue, 29 Apr 2003 16:33:45 +0000 (+0000) Subject: Minor changes for consistency with other design docs. X-Git-Tag: Root_Temp_KnuthStylePageBreaking~1512 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=e6935165cd4e48730c3819435da7df3c364d1ccb;p=xmlgraphics-fop.git Minor changes for consistency with other design docs. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196373 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/design/areas.xml b/src/documentation/content/xdocs/design/areas.xml index 01f77ba77..95a5279ac 100644 --- a/src/documentation/content/xdocs/design/areas.xml +++ b/src/documentation/content/xdocs/design/areas.xml @@ -3,13 +3,14 @@ "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd">
- Area Tree - Area Tree Design for FOP + FO Design: Area Tree
+
+ Introduction

The Area Tree is an internal representation of the result document, representing pages and their contents. To make the concepts clearer and easier to understand, the code to implement the area tree matches the areas defined in the XSL-FO specification.

The area tree is created by the layout managers once the layout is decided for a page. @@ -18,6 +19,7 @@ From that point forward, the area tree model can then handle the new page. The data in the area tree must be minimal and independant. This means that the data uses less memory and can be serialized to an output stream if needed.

The Area Tree consists of a set of pages, which the actual implemenation places in a set of page sequences.

+
Structure

The area tree is a root element that has a list of page-viewport-areas. diff --git a/src/documentation/content/xdocs/design/breakpos.xml b/src/documentation/content/xdocs/design/breakpos.xml index 80bf40155..ae8cc1e90 100644 --- a/src/documentation/content/xdocs/design/breakpos.xml +++ b/src/documentation/content/xdocs/design/breakpos.xml @@ -4,7 +4,7 @@

- Layout Managers + FOP Design: Layout Managers Break Possibility Proposal @@ -12,7 +12,7 @@
-
+
Introduction

As explained in Layout, diff --git a/src/documentation/content/xdocs/design/embedding.xml b/src/documentation/content/xdocs/design/embedding.xml index c44b2263c..909fc0189 100644 --- a/src/documentation/content/xdocs/design/embedding.xml +++ b/src/documentation/content/xdocs/design/embedding.xml @@ -4,15 +4,14 @@

- Embedding Design - Design Approach to FOP + FOP Design: Embedding FOP in Other Applications
-
+
Introduction

This is the design for the external interface when FOP is to be embedded diff --git a/src/documentation/content/xdocs/design/extending.xml b/src/documentation/content/xdocs/design/extending.xml index 9a0d1f80c..469b1b4e0 100644 --- a/src/documentation/content/xdocs/design/extending.xml +++ b/src/documentation/content/xdocs/design/extending.xml @@ -4,21 +4,21 @@

- FOP Extensions - Adding extensions to FOP + FOP Design: Extensions
-
- Extensions +
+ Introduction

FOP provides an extension mechanism to add extra functionality. There are a number of different types of extensions that apply to different steps when converting FO into the rendered output.

+
Extensions

@@ -99,8 +99,6 @@ to result in a text box referencing the following PDF action:

-
- diff --git a/src/documentation/content/xdocs/design/images.xml b/src/documentation/content/xdocs/design/images.xml index fc40a64d6..f1dcb2e0e 100644 --- a/src/documentation/content/xdocs/design/images.xml +++ b/src/documentation/content/xdocs/design/images.xml @@ -4,12 +4,12 @@
- Images + FOP Design: Images
-
- Images in FOP +
+ Introduction

Images may only be needed to be loaded when the image is rendered to the output or to find the dimensions.
@@ -22,6 +22,7 @@ not include any sort of resolving such as relative -> absolute. The external graphic in the FO Tree and the image area in the Area Tree only have the url as a reference. The images are handled through a static interface in ImageFactory.

+
Threading @@ -127,7 +128,6 @@ then load the required data depending on the image mime type. If the renderer can insert the image into the document and use that data for all future references of the same image then it can cache the reference in the renderer and the image can be released from the image cache.

-
diff --git a/src/documentation/content/xdocs/design/optimise.xml b/src/documentation/content/xdocs/design/optimise.xml index 0bb51ea90..83adf8e1c 100644 --- a/src/documentation/content/xdocs/design/optimise.xml +++ b/src/documentation/content/xdocs/design/optimise.xml @@ -4,16 +4,15 @@
- FOP Optimisations - Notes for Optimising FOP + FOP Design: Optimisations
-
- Process Optimisations +
+ Introduction

FOP should be able to handle very large documents. A document can be supplied using SAX and the information should be passed entirely through diff --git a/src/documentation/content/xdocs/design/pdf-library.xml b/src/documentation/content/xdocs/design/pdf-library.xml index e7301f6b1..4386e32be 100644 --- a/src/documentation/content/xdocs/design/pdf-library.xml +++ b/src/documentation/content/xdocs/design/pdf-library.xml @@ -4,16 +4,17 @@

- PDF Library + FOP Design: PDF Library
-
- PDF Library +
+ Introduction

The PDF Library is an independant package of classes in FOP. These class provide a simple way to construct documents and add the contents. The classes are found in org.apache.fop.pdf.*.

+
PDF Document @@ -69,8 +70,6 @@ The method is: byte[] toPDF().

The are a number of other features for handling pdf markup relevent to creating PDF files for FOP.

-
- diff --git a/src/documentation/content/xdocs/design/renderers.xml b/src/documentation/content/xdocs/design/renderers.xml index bc7d2ded7..87bc575ee 100644 --- a/src/documentation/content/xdocs/design/renderers.xml +++ b/src/documentation/content/xdocs/design/renderers.xml @@ -3,20 +3,12 @@ "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd">
- Renderers - Design of Renderers + FO Design: Renderers
-
- Renderers are Responsible -

Each renderer is totally responsible for its output format.

-
-
- Send Output to a Stream -
Introduction

A renderer is primarily designed to convert a given area tree into the output @@ -37,6 +29,16 @@ be rendered is setup by the renderer first so that it can reserve a space or reference for when the page is ready to be rendered.The renderer is responsible for managing the output format and associated data and flow.

+
+ Design Issues +
+ Renderers are Responsible +

Each renderer is totally responsible for its output format.

+
+
+ Send Output to a Stream +
+
Fonts

Because font metrics (and therefore layout) are obtained in two different ways depending on the renderer, the renderer actually sets up the fonts being used. The font metrics are used diff --git a/src/documentation/content/xdocs/design/svg.xml b/src/documentation/content/xdocs/design/svg.xml index 74730dcd4..d56549943 100644 --- a/src/documentation/content/xdocs/design/svg.xml +++ b/src/documentation/content/xdocs/design/svg.xml @@ -4,11 +4,11 @@

- SVG + FOP Design: SVG
-
- SVG +
+ Introduction

SVG is rendered through Batik.

The XML from the XSL:FO document is converted into an SVG DOM with batik. This DOM is then set as the Document on the Foreign Object area in the Area Tree.

This DOM is then available to @@ -19,6 +19,7 @@ create the SVG image in the PDF document.

Most of the work is done in the PDFGraphics2D class. There are also a few bridges that are plugged into batik to provide different behaviour for some SVG elements.

+
Text Drawing

Normally batik converts text into a set of curved @@ -65,8 +66,6 @@ awt canvas using batik.

The PS Renderer uses a similar technique as the PDF Renderer.

The SVG Renderer simply embeds the SVG inside an svg element.

-
-
diff --git a/src/documentation/content/xdocs/design/useragent.xml b/src/documentation/content/xdocs/design/useragent.xml index 3a64366c7..f6934d4d5 100644 --- a/src/documentation/content/xdocs/design/useragent.xml +++ b/src/documentation/content/xdocs/design/useragent.xml @@ -4,16 +4,15 @@
- FO User Agent - Design of FO User Agent + FOP Design: User Agent
-
- Purpose +
+ Introduction

Technically the user agent is FOP in the role of determining the output format and when resolving various attributes. The user