Re: [Understanding] FO Tree [3]

[Keiron Liddle]

On 2002.02.23 16:33 Matthew L. Avizinis wrote:
> The question is, "How are extension element properties mapped?"  I new
> element seems to be recognized by FOP just fine, but any properties I
> include are "ignored" by FOP, i.e. an exception is raised stating that
> the
> property in question is ignored and/or no maker found.
> matthew l. avizinis

In terms of what I am writing about, the extension element properties are 
not mapped. The extension element classes get the xml attributes directly. 
They can then get whatever attributes are required.
This is releveant information only to the development of FOP not older 
versions.

You want to know how to map properties for older versions. For this you 
need to do something like src/codegen/extproperties.xml and add the 
appropriate processing into the build.xml.



> > Keiron Liddle wrote:
> > ...
> >
> > >>> By using element mappings it is possible to read other XML and
> either
> > >>> - set information on the area tree
> > >>> - create pseudo FO Objects that create areas in the area tree
> > >>> - create FO Objects
> > >>
> > >>
> > >> ** Mapping elements to classes?
> > >
> > >
> > > I'm not sure what the question is.
> > >
> > Keiron,
> >
> > The post below is from the fop-user list.
> >
> > Peter
> >
> > Hello all,
> >   I have read the extension element writing document and examined the
> >  and  extension elements code, but I don't see
> > precisely how
> > element properties are mapped.  I have followed the pattern of
> > the examples
> > in the code and mapped the element correctly but the properties are
> > "ignored" when FOP runs.
> >   Any help is appreciated.  Please be as detailed as possible --
> > I am not a
> > veteran FOP developer, so what may be patently obvious to you might not
> be
> > to me.
> > Gratefully,
> >Matthew L. Avizinis 
> > Gleim Publications, Inc.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

RE: [Understanding] FO Tree [3]

[Matthew L. Avizinis]

The question is, "How are extension element properties mapped?"  I new
element seems to be recognized by FOP just fine, but any properties I
include are "ignored" by FOP, i.e. an exception is raised stating that the
property in question is ignored and/or no maker found.
matthew l. avizinis

> -Original Message-
> From: Peter B. West [mailto:[EMAIL PROTECTED]]
> Sent: Friday, February 22, 2002 6:24 PM
> To: [EMAIL PROTECTED]
> Subject: Re: [Understanding] FO Tree [3]
>
>
> Keiron Liddle wrote:
> ...
>
> >>> By using element mappings it is possible to read other XML and either
> >>> - set information on the area tree
> >>> - create pseudo FO Objects that create areas in the area tree
> >>> - create FO Objects
> >>
> >>
> >> ** Mapping elements to classes?
> >
> >
> > I'm not sure what the question is.
> >
> Keiron,
>
> The post below is from the fop-user list.
>
> Peter
>
> Hello all,
>   I have read the extension element writing document and examined the
>  and  extension elements code, but I don't see
> precisely how
> element properties are mapped.  I have followed the pattern of
> the examples
> in the code and mapped the element correctly but the properties are
> "ignored" when FOP runs.
>   Any help is appreciated.  Please be as detailed as possible --
> I am not a
> veteran FOP developer, so what may be patently obvious to you might not be
> to me.
> Gratefully,
>Matthew L. Avizinis <mailto:[EMAIL PROTECTED]>
> Gleim Publications, Inc.
>
>
>
>
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, email: [EMAIL PROTECTED]


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Re: [Understanding] FO Tree [3]

[Peter B. West]

Keiron Liddle wrote:
...

>>> By using element mappings it is possible to read other XML and either
>>> - set information on the area tree
>>> - create pseudo FO Objects that create areas in the area tree
>>> - create FO Objects
>>
>>
>> ** Mapping elements to classes?
>
>
> I'm not sure what the question is.
>
Keiron,

The post below is from the fop-user list.

Peter

Hello all,
  I have read the extension element writing document and examined the
 and  extension elements code, but I don't see precisely how
element properties are mapped.  I have followed the pattern of the examples
in the code and mapped the element correctly but the properties are
"ignored" when FOP runs.
  Any help is appreciated.  Please be as detailed as possible -- I am not a
veteran FOP developer, so what may be patently obvious to you might not be
to me.
Gratefully,
   Matthew L. Avizinis 
Gleim Publications, Inc.




-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Re: [Understanding] FO Tree [3]

[Keiron Liddle]

On 2002.02.16 03:13 Peter B. West wrote:
> ** What other classes (if any) extend FONode?  Where will they be 
> discussed?

These classes will be displayed in the diagram. That should provide enough 
information to tell people where to get more information, ie. in the 
classes.


> ** Apart from end(), what methods are common to FObjs?

the handleAttributes and setUserAgent would be common to FONode. Other 
than that I would say it is yet to be finalised.

> ** How is the FO Tree represented?  How is it traversed?

The FO Tree is simple a heirarchy of java objects that represent the fo 
elements from xml. The traversal is done by the layout or structure 
process only in the flow elements.

> ** This is a big topic (Properties).  Do you have plans to discuss it in 
> more detail?

This is an entirely separate topic. It is mentioned here only in terms of 
how it relates to the FO Tree.

>> By using element mappings it is possible to read other XML and either
>> - set information on the area tree
>> - create pseudo FO Objects that create areas in the area tree
>> - create FO Objects
> 
> ** Mapping elements to classes?

I'm not sure what the question is.

> The layout-master-set is specified in a subtree isolated from the 
> content specification of the pages (see page sequences, below).
> 
> ** Where are references to these factories maintained?

The objects in the FO Tree that represent these elements are themselves 
the factory. The root element keeps these objects as a factory for the 
page sequences.

> Declarations
> 
> 
> From the spec (6.4.3)
> 
> The fo:declarations formatting object is used to group global 
> declarations for a stylesheet.
> 
> Only fo:color-profile is defined within fo:declarations.
> 
> ** "...handled by ... parent element."  fo:root?

Yes the root looks after the declarations and the declarations maintains a 
list of colour profiles.

> Page Sequences
> --
> 
> The page masters define the layout of the page containers into which the 
> substance of the document will be poured.  This substance is defined in 
> fo:page-sequences.  They contain an optional fo:title, zero or more 
> fo:static-content elements, and a single fo:flow.  They are children of 
> fo:root, and are encountered in the document tree after the 
> fo:layout-master-set has been read.
> 
> ** The fo:page-sequence elements determine the layout-master that will 
> be used for layout of their children.  How is the association between 
> page master, page-sequence (FO Tree) and area tree maintained?

Why does this matter. This will be done by the class that looks after the 
area tree whatever that is.

> Flows
> -
> 
> Flows provide the content which is poured into page containers, 
> specifically the regions.  fo:static-flows are content, associated with 
> a particular region, which repeats on each page containing such a 
> region; i.e. it does *not* flow over a page boundary.  fo:flows are the 
> primary content of a page-sequence.  They overflow individual page 
> containers (region-body containers, practically speaking) to continue in 
> the same region of the next page.
> 
> ** Which classes/methods determine how the elements of a flow are 
> processed and converted into areas in the area tree?

This is for the "Layout Managers" topic.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Re: [Understanding] FO Tree [3]

[Peter B. West]

Keiron,

Some questions below.


Keiron Liddle wrote:

>
>
> FO Tree
> ---
>
> The FO Tree is a representation of the XSL:FO document. This represents
> the steps Objectify from the spec. The Refinement step is part of reading
> and using the properties which may happen immediately or during the 
> layout
> process.
>
> Each xml element is represented by a java object. For pagination the
> classes are in org.apache.fop.fo.pagination.*, for elements in the flow
> they are in org.apache.fop.fo.flow.* and some others are in
> org.apache.fop.fo.*.
>
> The base class for all objects in the tree is FONode. The base class for
> all FO Objects is FObj.

** What other classes (if any) extend FONode?  Where will they be 
discussed?

>
> (insert diagram here)
>
> There is a class for each element in the FO set. An object is created for
> each element in the FO Tree. This object holds the properties for the FO
> Object.
>
> When the object is created it is setup. It is given its element name, the
> FOUserAgent - for resolving properties etc., the logger and the
> attributes. The object will then be given any text data or child 
> elements.
> Then the end() method is called.
> The end method is used by a number of elements to indicate that it can do
> certain processing since all the children have been added.

** Apart from end(), what methods are common to FObjs?

>
> Some validity checking is done during these steps. The user can be 
> warned of the error and processing can continue if possible.
>
> The purpose of the FO Tree is to hold the information so that it can 
> be properly processed.

** How is the FO Tree represented?  How is it traversed?

>
> Properties
> --
>
> The XML attributes on each element are passed to the object. The objects
> that represent FO objects then convert the attributes into properties.
>
> Since properties can be inherited the PropertyList class handles 
> resolving
> properties for a particular element. 

** Is it a Property_List_ because it represents the set of properties 
specified as attributes on the FO element?  How are the PropertyLists 
structured in order to resolve the inheritance of individual properties 
within the list?

>
> All properties are specified in an XML file. Classes are created
> automatically during the build process.
>
> (insert diagram here)
>
> In some cases the element may be moved to have a different parent, for
> example markers, or the inheritance could be different, for example
> initial property set.

** This is a big topic.  Do you have plans to discuss it in more detail?

>
>
> Foreign XML
> ---
>
> The base class for foreign XML is XMLObj. This class handles creating a
> DOM Element and the setting of attributes. It also can create a DOM
> Document if it is a top level element, class XMLElement.
> This class must be extended for the namespace of the XML elements. For
> unknown namespaces the class is UnknowXMLObj.
>
> (insert diagram here)
>
> If some special processing is needed then the top level element can 
> extend
> the XMLObj. For example the SVGElement makes the special DOM required for
> batik and gets the size of the svg.
>
> Foreign XML will usually be in an fo:instream-foreign-object, the XML 
> will
> be passed to the render as a DOM where the render will be able to handle
> it. Other XML from an unknwon namespace will be ignored.
>
> By using element mappings it is possible to read other XML and either
> - set information on the area tree
> - create pseudo FO Objects that create areas in the area tree
> - create FO Objects

** Mapping elements to classes?

>
>
> Unknown Elements
> 
>
> If an element is in a known namespace but the element is unknown then an
> Unknown object is created. This is mainly to provide information to the
> user.
> This could happen if the fo document contains an element from a different
> version or the element is misspelt.
>
> Page Masters
> 
>
> The first elements in a document are the elements for the page master
> setup. This is usually only a small number and will be used throughout 
> the
> document to create new pages.
> These elements are kept as a factory to create the page and appropriate
> regions whenever a new page is requested by the layout.

fo:layout-master-set is a wrapper around all of the page *masters*.  As 
noted, all of the page master setup occurs at the beginning of the 
document, so the layout-master-set is the first element under fo:root. 
 At the bottom of the hierarchy are the fo:simple-page-masters, each 
defining the division of one type of page into regions; basically the 
body and the four possible edge regions surrounding it.  This 
"regionalisation" of a page is the "layout" implied by 
"layout-master-set."  The layout of every page is eventually defined by 
a simple-page-master.  They can be accessed directly by name, or 
indirectly by the name of a page-sequence-master.  If specified directly 
by name, a simple-page-master re

RE: [Understanding] FO Tree

[Savino, Matt C]

Understood. So when can we expect [Understanding] FO Tree[4]?

Sorry, I couldn't resist :P

-Matt

> -Original Message-
> From: Sachin Oswal [mailto:[EMAIL PROTECTED]]
> Sent: Thursday, February 14, 2002 2:07 AM
> To: '[EMAIL PROTECTED]'
> Subject: RE: [Understanding] FO Tree
> 
> 
> Hi Michiel & Brahma,
> To make Keiron's life easier
> In the first place there is nothing like "[Understanding] FO 
> Tree [2]" 
> There have been three lessons in this ongoing tutorialand 
> they are:-
> Understanding FOP[1]
> XML Parsing[2] &
> Understanding  FO Tree [3]
> 
> If you've missed the earlier ones u can find them in the archives at
> http://marc.theaimsgroup.com/?l=fop-dev&r=1&w=2#
> 
> Have a nice day
> Sachin
> 
> \\\|///
>  \\  ~ ~  //
>  (  @ @  )
> oOOo-(_)-oOOo-
> Sachin Oswal
> 
>Wilco Systems Hyderabad  
>  E-Mail :[EMAIL PROTECTED]   
>  Phone (040)-3408600   Extensionn : 8507   
> --
> 
> 
> 
> > -Original Message-
> > From:   Michiel Verhoef [SMTP:[EMAIL PROTECTED]]
> > Sent:   Thursday, February 14, 2002 3:30 PM
> > To: '[EMAIL PROTECTED]'
> > Subject:RE: [Understanding] FO Tree
> > 
> > Yep, same here. I checked just about my entire mailbox but 
> I must have
> > deleted it.
> > Is there an archive somewhere?
> > 
> > TIA,
> > 
> > Michiel
> > 
> > -Original Message-
> > From: BRAHMA [mailto:[EMAIL PROTECTED]]
> > Sent: donderdag 14 februari 2002 10:41
> > To: [EMAIL PROTECTED]
> > Subject: [Understanding] FO Tree
> > 
> > 
> > Hi Keiron, 
> > Thank you very much for providing the  FOP
> > knowledge.Unfortunately I missed some how "[Understanding] 
> FO Tree [2]"
> > can
> > you tell me where can I find it please. 
> > thanks and regards 
> >  brahma 
> > - 
> > Brahmaiah Kurabalakota 
> > Software Developer 
> > eMIS eMerging Information Systems GmbH 
> > Am Friedrichsbrunnen 
> > D-24782 Büdelsdorf 
> > Tel.: +49 (4331) 447 1520 
> > Mobile: +49 (172) 5372297 
> > mailto: [EMAIL PROTECTED] 
> > www.emis-intl.com 
> >   
> > 
> > 
> -
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, email: [EMAIL PROTECTED]
> 
> 
> This message is confidential and may also be legally 
> privileged. If you are not the intended recipient, please 
> notify us immediately. You should not copy it or use it for 
> any purpose, nor disclose it's contents to any other person. 
> The views and opinions expressed in this e-mail message are 
> the author's own and may not reflect the views and opinions 
> of Wilco International.
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, email: [EMAIL PROTECTED]
> 
> 


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

RE: [Understanding] FO Tree

[Sachin Oswal]

Hi Michiel & Brahma,
To make Keiron's life easier
In the first place there is nothing like "[Understanding] FO Tree [2]" 
There have been three lessons in this ongoing tutorialand they are:-
Understanding FOP[1]
XML Parsing[2] &
Understanding  FO Tree [3]

If you've missed the earlier ones u can find them in the archives at
http://marc.theaimsgroup.com/?l=fop-dev&r=1&w=2#

Have a nice day
Sachin

\\\|///
 \\  ~ ~  //
 (  @ @  )
oOOo-(_)-oOOo-
Sachin Oswal

   Wilco Systems Hyderabad  
 E-Mail :[EMAIL PROTECTED]   
 Phone (040)-3408600   Extensionn : 8507   
--



> -Original Message-
> From: Michiel Verhoef [SMTP:[EMAIL PROTECTED]]
> Sent: Thursday, February 14, 2002 3:30 PM
> To:   '[EMAIL PROTECTED]'
> Subject:  RE: [Understanding] FO Tree
> 
> Yep, same here. I checked just about my entire mailbox but I must have
> deleted it.
> Is there an archive somewhere?
> 
> TIA,
> 
> Michiel
> 
> -Original Message-
> From: BRAHMA [mailto:[EMAIL PROTECTED]]
> Sent: donderdag 14 februari 2002 10:41
> To: [EMAIL PROTECTED]
> Subject: [Understanding] FO Tree
> 
> 
> Hi Keiron, 
> Thank you very much for providing the  FOP
> knowledge.Unfortunately I missed some how "[Understanding] FO Tree [2]"
> can
> you tell me where can I find it please. 
> thanks and regards 
>  brahma 
> - 
> Brahmaiah Kurabalakota 
> Software Developer 
> eMIS eMerging Information Systems GmbH 
> Am Friedrichsbrunnen 
> D-24782 Büdelsdorf 
> Tel.: +49 (4331) 447 1520 
> Mobile: +49 (172) 5372297 
> mailto: [EMAIL PROTECTED] 
> www.emis-intl.com 
>   
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, email: [EMAIL PROTECTED]


This message is confidential and may also be legally privileged. If you are not the 
intended recipient, please notify us immediately. You should not copy it or use it for 
any purpose, nor disclose it's contents to any other person. The views and opinions 
expressed in this e-mail message are the author's own and may not reflect the views 
and opinions of Wilco International.

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Re: [Understanding] FO Tree

[Keiron Liddle]

Understanding FOP [1]
http://marc.theaimsgroup.com/?l=fop-dev&m=101306832215969&w=2

XML Parsing [2]
http://marc.theaimsgroup.com/?l=fop-dev&m=101341919226256&w=2

[Understanding] FO Tree [3]
http://marc.theaimsgroup.com/?l=fop-dev&m=101367710030461&w=2


On 2002.02.14 11:00 Michiel Verhoef wrote:
> Yep, same here. I checked just about my entire mailbox but I must have
> deleted it.
> Is there an archive somewhere?
> 
> TIA,
> 
> Michiel
> 
> -Original Message-
> From: BRAHMA [mailto:[EMAIL PROTECTED]]
> Sent: donderdag 14 februari 2002 10:41
> To: [EMAIL PROTECTED]
> Subject: [Understanding] FO Tree
> 
> 
> Hi Keiron,
> Thank you very much for providing the  FOP
> knowledge.Unfortunately I missed some how "[Understanding] FO Tree [2]"
> can
> you tell me where can I find it please.
> thanks and regards
>  brahma
> -
> Brahmaiah Kurabalakota
> Software Developer
> eMIS eMerging Information Systems GmbH
> Am Friedrichsbrunnen
> D-24782 Büdelsdorf
> Tel.: +49 (4331) 447 1520
> Mobile: +49 (172) 5372297
> mailto: [EMAIL PROTECTED]
> www.emis-intl.com
> 
> 
> -
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, email: [EMAIL PROTECTED]
> 
> 

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

RE: [Understanding] FO Tree

[Michiel Verhoef]

Great, thanks!

$ -Original Message-
$ From: [EMAIL PROTECTED] 
$ [mailto:[EMAIL PROTECTED]]
$ Sent: donderdag 14 februari 2002 11:00
$ To: [EMAIL PROTECTED]
$ Subject: RE: [Understanding] FO Tree
$ 
$ 
$ 
$ alll sent messages can be found here:
$ http://marc.theaimsgroup.com/
$ 
$ 
$ 
$ Jochen Maes
$ EDP departement
$ Programmeur
$ 
$ KBC-Securities
$ Havenlaan 16
$ 1080 Brussel
$ 
$ Tel : 02/429.96.81
$ Fax : 02/429.17.48
$ E-mail : [EMAIL PROTECTED]
$ 
$ **
$ **
$ **
$ 
$ This message is for the named person's use only. It may contain
$ confidential, proprietary or legally privileged information. 
$ You must not,
$ directly or indirectly, use, disclose, distribute, print, or 
$ copy any part
$ of this message if you are not the intended recipient. KBC Securities
$ reserves the right to monitor all e-mail communications through its
$ networks. Any views expressed in this message are those of 
$ the individual
$ sender, except where the message states otherwise and the sender is
$ authorised to state them to be the views of any such entity.
$ **
$ **
$ **
$ 
$ 
$ -
$ To unsubscribe, e-mail: [EMAIL PROTECTED]
$ For additional commands, email: [EMAIL PROTECTED]
$ 

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

RE: [Understanding] FO Tree

[Jochen . Maes]

alll sent messages can be found here:
http://marc.theaimsgroup.com/



Jochen Maes
EDP departement
Programmeur

KBC-Securities
Havenlaan 16
1080 Brussel

Tel : 02/429.96.81
Fax : 02/429.17.48
E-mail : [EMAIL PROTECTED]

**

This message is for the named person's use only. It may contain
confidential, proprietary or legally privileged information. You must not,
directly or indirectly, use, disclose, distribute, print, or copy any part
of this message if you are not the intended recipient. KBC Securities
reserves the right to monitor all e-mail communications through its
networks. Any views expressed in this message are those of the individual
sender, except where the message states otherwise and the sender is
authorised to state them to be the views of any such entity.
**


-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

RE: [Understanding] FO Tree

[Michiel Verhoef]

Yep, same here. I checked just about my entire mailbox but I must have
deleted it.
Is there an archive somewhere?

TIA,

Michiel

-Original Message-
From: BRAHMA [mailto:[EMAIL PROTECTED]]
Sent: donderdag 14 februari 2002 10:41
To: [EMAIL PROTECTED]
Subject: [Understanding] FO Tree


Hi Keiron, 
Thank you very much for providing the  FOP
knowledge.Unfortunately I missed some how "[Understanding] FO Tree [2]" can
you tell me where can I find it please. 
thanks and regards 
 brahma 
- 
Brahmaiah Kurabalakota 
Software Developer 
eMIS eMerging Information Systems GmbH 
Am Friedrichsbrunnen 
D-24782 Büdelsdorf 
Tel.: +49 (4331) 447 1520 
Mobile: +49 (172) 5372297 
mailto: [EMAIL PROTECTED] 
www.emis-intl.com 
  

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]