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 05:01:53 UTC
cvs commit: xml-fop/src/documentation/content/xdocs/design/understanding book.xml layout_managers.xml
vmote 2003/04/21 20:01:53
Modified: src/documentation/content/xdocs/design book.xml layout.xml
src/documentation/content/xdocs/design/understanding
book.xml
Removed: src/documentation/content/xdocs/design/understanding
layout_managers.xml
Log:
Move content from design/understanding/layout_managers.xml to design/layout.xml.
Revision Changes Path
1.13 +0 -1 xml-fop/src/documentation/content/xdocs/design/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/design/book.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- book.xml 22 Apr 2003 00:21:04 -0000 1.12
+++ book.xml 22 Apr 2003 03:01:52 -0000 1.13
@@ -27,7 +27,6 @@
<menu-item label="XML Parsing" href="understanding/xml_parsing.html"/>
<menu-item label="FO Tree" href="understanding/fo_tree.html"/>
<menu-item label="Properties" href="understanding/properties.html"/>
- <menu-item label="Layout Managers" href="understanding/layout_managers.html"/>
</menu>
<menu label="Extras">
<menu-item label="Images" href="understanding/images.html"/>
1.5 +32 -3 xml-fop/src/documentation/content/xdocs/design/layout.xml
Index: layout.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/design/layout.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- layout.xml 20 Apr 2003 23:46:10 -0000 1.4
+++ layout.xml 22 Apr 2003 03:01:52 -0000 1.5
@@ -12,6 +12,18 @@
</header>
<body>
+<p>The role of the layout managers is to build the Area Tree by using the
+information from the FO Tree. The layout managers decide where information
+is placed in the area tree.</p>
+<p>A layout manager is typically associated with an FO Object but not always.</p>
+
+<p>The layout managers are in between the FO Tree and the Area Tree. They get
+information from the FO Tree and create areas and build the pages. They
+hold the state of the layout process as it builds up the areas and pages.
+They also manage the handling of breaks and spacing between areas.</p>
+<p>FO Objects can have two types of properties, ones that relate to the layout and ones that relate to the rendering. THe layout related properties area used by the layout managers to determine how and where to create the areas. The render related properties should be passed through to the renderer in the most efficient way possible.
+</p>
+
<p>
The aim of the layout system is to be self contained and allow for
easy changes or extensions for future development. For example the
@@ -254,6 +266,11 @@
of the separator regions when before floats/footnotes area added
and removed.
</p>
+<p>Footnotes and Before Floats are placed in special areas in the body region
+of the page. The size of these areas is determined by the content. This in
+turn effects the available size of the main reference area that contains
+the flow.</p>
+<p>A layout manager handles the adding and removing of footnotes/floats, this in turn effects the available space in the main reference area.</p>
</section>
<section>
<title>Side Floats</title>
@@ -265,9 +282,12 @@
also effected as there must be enough space on the page to fit the
side float.
</p>
- <p>
-<!--img src="float.svg" alt="Diagram of Float"/-->
- </p>
+<p>Side floats alter the length of the inline progression dimension for the
+current line and following lines for the size of the float.</p>
+<p>This means that the float needs to be handled by the block layout manager
+so that it can adjust the available inline progression dimension for the
+relevant line areas.</p>
+<!--<p>img src="float.svg" alt="Diagram of Float"/>-->
</section>
<section>
<title>Unresolved Areas</title>
@@ -366,6 +386,15 @@
</section>
<section>
<title>Block Areas</title>
+<p>When a block creating element is complete then it is possible to build the
+block area and add it to the paprent.</p>
+<p>A block area will contain either more block areas or line areas, which are
+special block areas. The line areas are created by the LineLayoutManager
+in which the inline areas flow into.</p>
+<p>So a block area manager handles the lines or blocks as its children and
+determines things like spacing and breaks.</p>
+<p>In the case of tables and lists the blocks are stacked in a specific way
+that needs to be handled by the layout manager.</p>
<p>
The block area has info about the following:
</p>
1.6 +0 -1 xml-fop/src/documentation/content/xdocs/design/understanding/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/design/understanding/book.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- book.xml 22 Apr 2003 00:21:04 -0000 1.5
+++ book.xml 22 Apr 2003 03:01:53 -0000 1.6
@@ -31,7 +31,6 @@
<menu-item label="XML Parsing" href="xml_parsing.html"/>
<menu-item label="FO Tree" href="fo_tree.html"/>
<menu-item label="Properties" href="properties.html"/>
- <menu-item label="Layout Managers" href="layout_managers.html"/>
</menu>
<menu label="Extras">
<menu-item label="Images" href="images.html"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: fop-cvs-help@xml.apache.org