Tom, that's great, but why don't you just use our main Wiki? http://wiki.apache.org/xmlgraphics-fop/
Another request: Please call this area tree XML rather than intermediate format. Yes, we called it that in the past but we have two intermediate formats now, so it's necessary to keep the two apart. On 25.08.2009 17:43:16 TomWilcox wrote: > > Hi Jeremias and Georg, > > Thanks very much. That's really helpful and at least good to know that no > proper documentation exists. > > I have taken the liberty of starting a wiki to share this information whilst > I attempt to accumulate more info about the IF tree. If anyone would like to > contribute please do. It would be great to produce something of use to > anyone else with similar needs. > > I have added the information that you have both provided me to the wiki page > (and cited you both as contributors) please let me know if this is not OK > and feel free to edit. > > http://fop-if-tree.wikispaces.com/ > > Thanks, > Tom > > > > Jeremias Maerki-2 wrote: > > > > There's no formal documentation of the area tree XML format to date. It > > is something very very few people need to use and the whole thing grew > > organically over time, so documentation wasn't a top priority. A > > contribution in this direction would be highly welcome. I'm happy to > > fill in any blanks if such a documentation is started. I don't have time > > to write the whole thing myself in the short term. > > > > bpd = block-progression-dimension of the content rectangle of the area > > (= height for lr-tb script) > > bpda = allocated bpd = content bpd + spaces + borders + padding > > > > ipd = inline-progression-dimension of the content rectangle of the area > > (= width for lr-tb script) > > ipda = allocated ipd = content ipd + spaces + borders + padding > > > > Units are millipoints (1000ths of a point) as used in most of FOP (most > > notably the layout engine). > > > > Please note that our area tree is relatively close to the conceptual > > area tree (with its traits) described in the XSL specification. If you > > know a bit of the specification, the area tree XML is much easier to > > read. > > > > If you look into our layout engine test suite > > (test/layoutengine/standard-testcases), you'll find a lot of examples of > > what is expected in the area tree for various situations. > > > > HTH > > > > On 25.08.2009 16:26:29 TomWilcox wrote: > >> > >> Hi Guys, > >> > >> Sorry to return your attention to this aging thread! > >> > >> I am knee deep in IF and I have a been attempting to divine what each of > >> the > >> different node attributes represent such as bpd (block progression > >> dimension?), etc. > >> > >> It would be really good to have a definitive description of the meaning > >> and > >> function of each of the attribute (and nodes) in an IF document. I have > >> been > >> searching diligently however I have failed to find any document that > >> completely satisfies this requirement. > >> > >> Would be possible for you provide me with a link to a thorough > >> documentation > >> of the IF format or, if not, perhaps you might be able to provide an > >> explanation of the attributes important for reading the dimension of a > >> given > >> block from an IF document (I think position is bpd, ipd, .. but ipda? and > >> bpda?) and what are the units (millipoints?). > >> > >> I am very grateful for any assistance. > >> > >> Thanks in advance, > >> Tom > >> -- > >> View this message in context: > >> http://www.nabble.com/Area-Tree-Handling-tp24431098p25135373.html > >> Sent from the FOP - Users mailing list archive at Nabble.com. > > > > > > Jeremias Maerki > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: fop-users-unsubscr...@xmlgraphics.apache.org > > For additional commands, e-mail: fop-users-h...@xmlgraphics.apache.org > > > > > > > > -- > View this message in context: > http://www.nabble.com/Area-Tree-Handling-tp24431098p25136891.html > Sent from the FOP - Users mailing list archive at Nabble.com. > Jeremias Maerki --------------------------------------------------------------------- To unsubscribe, e-mail: fop-users-unsubscr...@xmlgraphics.apache.org For additional commands, e-mail: fop-users-h...@xmlgraphics.apache.org
