docbook-apps

Greetings,

I would like to place a watermark over the entire page.
Using the draft mode and watermark image params, the image is place on the
page, however it seems to be on the "bottom."

How might one place the watermark over the entire page so that it would
mark over non-transparent images?

Presently the watermark is clipped at the edges of images, which are not
transparent.
Hence my assumption that the watermark image is on the "bottom" of stacking
layers.

Best regards,

..Otto


( from mobile device, please excuse spelling errors, grammar,
abbreviations, shortness, and the such... )

Hi Otto,

I think you did not receive a response before because no one knows how
to do what you are asking.   In the XSL-FO model, it generates a page
with margins that define a body area, and then fills in the body area
with formatted content. The body area is called <fo:region-body>, and
the margin areas are called <fo:region-before> (header),
<fo:region-after> (footer), <fo:region-start> (left margin area),
<fo:region-end> (right margin area).  The watermark is normally placed
as the background image of the page in the fo:region-body, so that the
content, when it is generated, lays over it, as you noticed.  That is by
design, so that the watermark does not obscure the content and make it
unreadable.

Since you want your image to appear on every page, it cannot be part of
the content and must be part of the page declaration.  But content for
the page declaration only appears in the margin regions, as header or
footer, or side margin navigational content.  It might be possible to
declare a full size image in one of those areas but extending out side
the designated area, but I'm not sure if it would be under or over the
page content.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 6/29/2018 8:56 PM, Otto Hirr wrote:
> Greetings,
>
> I would like to place a watermark over the entire page.
> Using the draft mode and watermark image params, the image is place on
> the page, however it seems to be on the "bottom."
>
> How might one place the watermark over the entire page so that it
> would mark over non-transparent images?
>
> Presently the watermark is clipped at the edges of images, which are
> not transparent.
> Hence my assumption that the watermark image is on the "bottom" of
> stacking layers.
>
> Best regards,
>
> ..Otto
>
>
> ( from mobile device, please excuse spelling errors, grammar,
> abbreviations, shortness, and the such... )

On 01/07/2018 16:43, Bob Stayton wrote:
...
> Since you want your image to appear on every page, it cannot be part
> of the content and must be part of the page declaration. But content
> for the page declaration only appears in the margin regions, as
> header or footer, or side margin navigational content. It might be
> possible to declare a full size image in one of those areas but
> extending out side the designated area, but I'm not sure if it would
> be under or over the page content.

It depends. The approach should get you the page-size image, but
whether or not the watermark is on top of the rest depends on the formatter.

The order of the FOs for the page regions in the XSL-FO document is
defined by the XSL 1.1 specification, but the rendering order of the
page regions not defined -- and 'z-index' does not apply -- so you're
left with what the formatter implements.

AH Formatter allows you to put the FOs for the page regions in any
sequence and will render them in that sequence. See:

https://www.antennahouse.com/product/ahf65/ahf-ext.html#ext-others

So if you're using AH Formatter, just put the FO for outer region to
which you will direct the watermark after the fo:region-body FO.

But if you're using AH Formatter, then you can specify up to two sets of
watermark text in the Option Setting File that AH Formatter uses. See:

https://www.antennahouse.com/product/ahf65/ahf-optset.html#watermark-text

Regards,

Tony Graham
Senior Architect
XML Division
Antenna House, Inc.
----
Skerries, Ireland
tgraham@antenna.co.jp