12.5.3 Decoration Areas

Facilities in this clause require the page feature.

An area container may be decorated with one or more other areas called decoration areas. Decoration areas do not affect how parent areas treat the decorated area; in particular, they shall not change the width or height of the decorated area.

(decoration-area sosofo #!key placement-point-x: placement-point-y: placement-direction:)

Returns an object of type decoration-area. The sosofo can specify a single flow object of any class that can be used inline. The result of formatting the sosofo is used as the decoration area. The decoration area has a placement point and a placement direction specified by the other arguments. The inline area produced by the sosofo is placed so that its position point lies on the placement point of the decoration area and its escapement direction is in the placement direction of the decoration area.

placement-point-x: is a length-spec specifying the distance between the bottom left corner of the decorated area and the placement point of the decoration area in the x-direction of the decorated area. placement-point-y: is a length-spec specifying the distance between the bottom left corner of the decorated area and the placement point of the decoration area in the y-direction of the decorated area. placement-direction: is one of the symbols left-to-right, right-to-left, or top-to-bottom giving the placement direction of the decoration area relative to the orientation of the decorated area. In this case, the line-progression direction of the decoration area is the placement direction of the decorated area.

(decorated-area-width) (decorated-area-height)

decorated-area-width and decorated-area-height return a length-spec specifying, respectively, the width and height of the area to be decorated. They may be used in the specification for the placement-point-x: and placement-point-y: arguments of a decoration-area.