From: Vincent Hennebert Date: Wed, 5 Aug 2009 11:07:18 +0000 (+0000) Subject: Fixed and improved documentation about prepress extensions: X-Git-Tag: fop-1_0~192 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=b0df5eb81b9a9ced4fd694900ddb335d5e287df8;p=xmlgraphics-fop.git Fixed and improved documentation about prepress extensions: - AFAIU all of them have been implemented in both the PDF and Java2D renderers - the default value of crop-offset is bleed git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@801130 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/trunk/extensions.xml b/src/documentation/content/xdocs/trunk/extensions.xml index 91c0b9c31..a635205d2 100644 --- a/src/documentation/content/xdocs/trunk/extensions.xml +++ b/src/documentation/content/xdocs/trunk/extensions.xml @@ -240,19 +240,20 @@ to following pages. Here is an example of FO code creating such a table-header:< registration marks, color bars and page information are placed. For details, please read on below.

+ + Those extensions have been implemented in the PDF and Java2D renderers only. +
fox:scale -

Default: 1

+

Value: <number>{1,2}

+

Initial: 1

+

Applies to: fo:simple-page-master

- fox:scale="sx [sy]" attribute is used in fo:simple-page-master element and specifies - the a scale operation by sx and sy. If sy is not provided, it is assumed to be equal to sx. - sx and sy should be a positive number. A scale factor smaller than 1 shrinks the page. - A scale factor greater than 1 enlarges the page. + This property specifies a scale factor along resp. the x and y axes. If only one number + is provided it is used for both the x and y scales. A scale factor smaller than 1 + shrinks the page. A scale factor greater than 1 enlarges the page.

- - It is implemented for PDF and Java2D renderers. -
fox:bleed @@ -260,15 +261,17 @@ to following pages. Here is an example of FO code creating such a table-header:< Value: <length>{1,4}

- Default: 0pt + Initial: 0pt

+

Applies to: fo:simple-page-master

If there is only one value, it applies to all sides. If there are two values, the top and bottom bleed widths are set to the first value and the right and left bleed widths are set to the second. If there are three values, the top is set to the first value, the left and right are set to the second, and the bottom is set to the third. If there are four values, they apply to the top, right, bottom, and left, respectively. - (Corresponds to http://www.w3.org/TR/xsl11/#padding). + (Corresponds to the definition of + padding).

This extension indirectly defines the BleedBox and is calculated by expanding the TrimBox by @@ -281,10 +284,12 @@ to following pages. Here is an example of FO code creating such a table-header:< Value: <length>{1,4}

- Default: 0pt + Initial: bleed (see below)

+

Applies to: fo:simple-page-master

- Same behaviour as with fox:bleed. + Same behaviour as with fox:bleed. The initial value is set to the same values as the + fox:bleed property.

This extension indirectly defines the MediaBox and is calculated by expanding @@ -294,11 +299,12 @@ to following pages. Here is an example of FO code creating such a table-header:<

fox:crop-box

- Value: (trim-box|bleed-box|media-box) + Value: [trim-box | bleed-box | media-box]

- Default: media-box + Initial: media-box

+

Applies to: fo:simple-page-master

The crop box controls how Acrobat displays the page (CropBox in PDF) or how the Java2DRenderer sizes the output media. The PDF specification defines that the CropBox defaults to the MediaBox. This extension @@ -307,7 +313,7 @@ to following pages. Here is an example of FO code creating such a table-header:<

If requested in the future, we could offer to specify the CropBox in absolute coordinates rather - than just be referencing another box. + than just by referencing another box.