]> source.dussan.org Git - xmlgraphics-fop.git/commitdiff
added layout manager info
authorKeiron Liddle <keiron@apache.org>
Wed, 31 Jul 2002 10:31:54 +0000 (10:31 +0000)
committerKeiron Liddle <keiron@apache.org>
Wed, 31 Jul 2002 10:31:54 +0000 (10:31 +0000)
Submitted by: Cyril Rognon <crognon@objectiva.fr>

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@195041 13f79535-47bb-0310-9956-ffa450edef68

docs/design/understanding/book.xml
docs/design/understanding/layout_managers.xml

index 505d3c06c151bbd84dbbed6059e3c8ec67209cb2..4e3013ca15f397b19c20595c11b62be4eaac714d 100644 (file)
@@ -9,7 +9,7 @@
   <page id="xml_parsing"          label="XML Parsing"      source="xml_parsing.xml"/>
   <page id="fo_tree"          label="FO Tree"      source="fo_tree.xml"/>
   <page id="properties"          label="Properties"      source="properties.xml"/>
-  <page id="layout_managers"          label="Layout Managers"      source="layout_process.xml"/>
+  <page id="layout_managers"          label="Layout Managers"      source="layout_managers.xml"/>
   <page id="layout_process"          label="Layout Process"      source="layout_process.xml"/>
   <page id="handling_attributes"          label="Handling Attributes"      source="handling_attributes.xml"/>
   <page id="area_tree"          label="Area Tree"      source="area_tree.xml"/>
@@ -20,4 +20,4 @@
   <page id="svg"          label="SVG"      source="svg.xml"/>
   <separator/>
   <page id="status"          label="Status"      source="status.xml"/>
-</book>
\ No newline at end of file
+</book>
index 6630ac64ba46ba80eff85b9390c524449264b81a..48e85c94bb54543a340eccf3299c7f31ef673521 100644 (file)
@@ -8,6 +8,60 @@
         </authors> 
   </header> 
   <body><s1 title="Layout Managers"> 
-               <p>Yet to come :))</p> 
-               <note>The series of notes for developers has started but it has not yet gone so far ! Keep watching</note></s1> 
+
+
+
+<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>
+
+
+<s2 title="Block Areas">
+
+<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></s2>
+
+
+
+<s2 title="Side Floats">
+
+<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></s2>
+
+
+
+<s2 title="Footnotes and Before Floats">
+
+<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>
+
+</s2>
+<note>(note: more info to follow)</note>
+
+
+</s1> 
   </body></document>
\ No newline at end of file