エリアツリー

Antenna House Formatter V7.3のエリアツリーは、XSL 1.1 の 4. Area Model を具現したものであるが、4.10 にあるサンプルを忠実に真似たものではない（非常に似てはいるが）。

This specification is provided as-is, without any warranty expressed or implied.

エリアツリーのXML表現に関するW3Cによる規定はない。 ここに示すエリアツリーのXML表現は、Antenna House Formatter V7.3 が生成するものであり、Antenna House 独自仕様のものである。

「Hello World!」と出力するだけのエリアツリーは次のようなものである。 ここには、紙面(A4)上のどこにどのフォントで何色で出力すればよいかなどの情報が含まれているのが見て取れるであろう。

<?xml version="1.0"?>
<AreaRoot is-first="true" is-last="true" version="602.2"
    xmlns="http://www.antennahouse.com/names/XSL/AreaTree">
    <PageViewportArea output-volume-break="false" is-first="true" is-last="true"
        width="595.276pt" height="841.89pt" abs-page-number="1" page-number="1" format="1">
        <PageReferenceArea is-first="true" is-last="true" width="595.276pt" height="841.89pt"
            display-role="block">
            <RegionViewportArea is-first="true" is-last="true" width="595.276pt"
                height="841.89pt" region-name="xsl-region-body">
                <RegionReferenceArea is-first="true" is-last="true" width="595.276pt"
                    height="841.89pt" display-role="block">
                    <MainReferenceArea is-first="true" is-last="true" width="595.276pt"
                        height="841.89pt">
                        <ColumnReferenceArea is-first="true" is-last="true" width="595.276pt"
                            height="841.89pt">
                            <NormalFlowReferenceArea is-first="true" is-last="true"
                                width="595.276pt" height="841.89pt">
                                <BlockArea is-first="true" is-last="true"
                                    bottom-position="829.89pt" width="595.276pt" height="12pt">
                                    <LineArea is-first="true" is-last="true"
                                        top-position="1pt" bottom-position="830.89pt"
                                        width="595.276pt" height="10pt"
                                        baseline-after="2.16309pt" space-before="1pt"
                                        space-after="1pt">
                                        <TextArea color="#000000" is-first="true"
                                            is-last="true" top-position="1pt"
                                            bottom-position="830.89pt"
                                            right-position="542.483pt" width="52.793pt"
                                            height="10pt" baseline-after="2.16309pt"
                                            script="Latn" font-size="10pt"
                                            font-family="Times New Roman"
                                            text-width="52.793pt" text="Hello World!"
                                            kerning-mode="pair" />
                                    </LineArea>
                                </BlockArea>
                            </NormalFlowReferenceArea>
                        </ColumnReferenceArea>
                    </MainReferenceArea>
                </RegionReferenceArea>
            </RegionViewportArea>
        </PageReferenceArea>
    </PageViewportArea>
</AreaRoot>

XSLの 領域モデル(Area Model) は、領域(area) を入れ子構造の長方形で表現するモデルである。したがって、入れ子長方形構造で表現できない文書を扱うことはできない。 ただし、入れ子構造は論理的な構造としての入れ子であり、実際の長方形が重なってレンダリングされることはあり得る。

☞  領域モデルの詳細については、XSL 1.1 の 4. Area Model を見よ。

ルート要素以外のすべての要素は領域である。領域は、ブロック領域 (block-area) と 行内領域 (inline-area) の２種類に分類することができる。 また、XSL仕様では、領域はスタックされて、ある進行方向(上から下とか)に積み重ねられるとあるが、エリアツリー中ではすべての領域の位置は決定済みであり、レンダラがスタックを意識する必要はない。 ブロック領域か行内領域かを意識する必要はあまりないが、進行方向は意識する必要がある。それは、長方形の各辺(edge)の物理的な位置を把握するのに必要である。

長方形の領域は、図のように内容長方形(Content Rectangle)、パディング長方形(Padding Rectangle)、境界長方形(Border Rectangle)で構成されている。

+----------------------------+
| Border Rectangle           |
| +------------------------+ |
| | Padding Rectangle      | |
| | +--------------------+ | |
| | | Content Rectangle  | | |
| | |                    | | |
| | +--------------------+ | |
| +------------------------+ |
+----------------------------+

この図で、普通の横書きの文章は、ブロック進行方向(block-progression-direction) は上から下であり、行内進行方向(inline-progression-direction) は左から右である。これは、lr-tb と略される。lr が行内進行方向(left to right)であり、 tb がブロック進行方向(top to bottom)である。 このとき、各辺は次のように定義される。

• 前辺(before-edge) は、ブロック進行方向で最初に現れる辺。lr-tb では上の辺。
• 後辺(after-edge) は、前辺の反対の辺。lr-tb では下の辺。
• 開始辺(start-edge) は、行内進行方向で最初に現れる辺。lr-tb では左の辺。
• 終了辺(end-edge) は、開始辺の反対の辺。lr-tb では右の辺。

また、領域自身が回転することがあり得る。その場合でも論理的な辺の定義は不変である。しかし、領域自体が回転しているので、紙面に対する物理的な位置も回転している。

before や start ではなく、top や left など絶対的な位置指定が行われることがある。これらは、進行方向によって次のようにマップされる。

領域には、表示領域(viewport-area) と呼ばれる領域と 参照領域(reference-area) と呼ばれる領域がある。 表示領域は、その領域に含まれる領域がレンダリングされるべき領域であることを示している。 参照領域は、その領域が独自の座標系を持っており、含まれる子領域の座標は参照領域の座標となる。 XSL仕様によれば、表示領域には参照領域が子として必ず含まれることになっているが、エリアツリーでは必ずしもそうではない。 エリアツリーのXML表現では、表示領域要素名には ViewportArea が後行し、参照領域要素名には ReferenceArea が後行している。

<digits> は、数字列である。すなわち符号なし整数。

<integer> は、(符号付きの)整数。

<number> は、(符号付きの)数値。 数値には小数点を含めてよい。小数点はピリオドであり、位取りのカンマなどは含まれない。

<length> は、12pt のような、単位を持つ <number> である。 利用できる単位は以下のとおり。

Antenna House Formatter V7.3は、すべて pt に換算してエリアツリーを出力する。それには、フォントサイズが pt であることから、誤差をなるべくなくそうという意図がある。

<percentage> は、75% のような、%付きの値である。これは、単に 0.75 と <number> を書いたのと等価。

<color> は、次のいずれかの形式。値の大文字小文字は無視される。

• #RRGGBB
• transparent
• rgb(<R>,<G>,<B>)
• rgb-icc(<R>,<G>,<B>,#GRAYSCALE,<S>)
• rgb-icc(<R>,<G>,<B>,#CMYK,<C>,<M>,<Y>,<K>)

共通プロパティ

|-->left-position
+-------------------+ --
|                   | ↓
|   +-----------+   | top-position
|   | Content   |   |
|   | Rectangle |   |
|   +-----------+   | bottom-position
|                   | ↑
+-------------------+ --
   right-position<--|

------------------------
                        <--space-before
+-----------------------
| Border Rectangle
| +---------------------
| | Padding Rectangle
| | +-------------------
| | | Content Rectangle
| | |

+-----------------------
| Border Rectangle
| +---------------------
| | Padding Rectangle   <--padding-before
| | +-------------------
| | | Content Rectangle
| | |

+-----------------------
| Border Rectangle      <--border-before-width
| +---------------------
| | Padding Rectangle
| | +-------------------
| | | Content Rectangle
| | |

 0         X
0+-----+---+
 |   θ/ \  |
 |  /     \|
 |/        +
 +        /|
 |\     /  |
 |  \ /    |
Y+---+-----+

Annotation properties

AreaRoot

PageViewportArea

PageReferenceArea

RegionViewportArea

          +-------------------+
          |   region-before   |
          +--+-------------+--+
          |  |             |  |
region-start | region-body | region-end
          |  |             |  |
          +--+-------------+--+
          |   region-after    |
          +-------------------+

RegionReferenceArea

PageRegionViewportArea

PageRegionReferenceArea

MainReferenceArea

ColumnReferenceArea

+---------------+---------------+
| Column        | Column        |
| ReferenceArea | ReferenceArea |
+---------------+---------------+
|       SpanReferenceArea       |
+---------------+---------------+
| Column        | Column        |
| ReferenceArea | ReferenceArea |
+---------------+---------------+

SpanReferenceArea

FlowReferenceArea

NormalFlowReferenceArea

BlockArea

LineArea

InlineArea

TextArea

GlyphArea

EmphasisArea

LeaderArea

BidiOverrideArea

BeforeFloatReferenceArea

BeforeFloatArea

FootnoteReferenceArea

FootnoteArea

RubyArea

RubyContainerArea

RubyBaseArea

RubyTextArea

FormFieldArea

FormArea

BlockAnchorArea

InlineAnchorArea

GraphicViewportArea

GraphicArea

graphic-image="data:image/svg+xml;base64,H4sIAAAAAAAAC31S3W7TMBS...
graphic-image="H4sIAAAAAAAAC31S3W7TMBS...

TableAndCaptionArea

TableCaptionViewportArea

TableCaptionArea

TableViewportArea

TableArea

TableColumnGroupArea

TableColumnArea

TableRowGroupArea

TableRowArea

TableCellArea

ListBlockArea

ListItemArea

ListItemLabelArea

ListItemBodyArea

RelativeFloatArea

SideFloatArea

SideNoteReferenceArea

SideNoteArea

AbsoluteFloatArea

BlockViewportArea

AbsoluteViewportArea

FixedViewportArea

InlineViewportArea

ColumnruleArea

RevisionbarArea

MultiColumnReferenceArea