[Okular-devel] [Bug 159023] Wish: shape tool improvements

albert alberthilbert at hotmail.it
Mon Mar 10 16:59:24 CET 2008


------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
         
http://bugs.kde.org/show_bug.cgi?id=159023         




------- Additional Comments From alberthilbert hotmail it  2008-03-10 16:59 -------
>About the thickness: we currently have our annotation tools matching as close as possible the PDF annotations. Because of that, I don't want to add options that we will not be able to eventually write back to the PDF some (not so remote) day. So, this is out, sorry.
 
This is an extract from: PDF Reference, Sixth Edition, version 1.7 (http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference_1-7.pdf), page 630 and following.

Circle and square annotations are described by an annotation dictionary. The entries specific to these types of annotations are:

KEY		TYPE       	VALUE
Subtype 		name      	 (Required) The type of annotation that this dictionary describes; must be Square
                   			or Circle for a square or circle annotation, respectively.

BS      		dictionary 	(Optional) A border style dictionary (see Table 8.17 on page 611) specifying the
                   			line width and dash pattern to be used in drawing the rectangle or ellipse.
                   			Note: The annotation dictionary’s AP entry, if present, takes precedence over the
                   			Rect and BS entries; see Table 8.15 on page 606 and Section 8.4.4, “Appearance
                   			Streams.”

IC     		 array      	(Optional; PDF 1.4) An array of numbers in the range 0.0 to 1.0 specifying the
                   			interior color with which to fill the annotation’s rectangle or ellipse. The number
                   			of array elements determines the color space in which the color is defined:
                       			0    No color; transparent
                       			1    DeviceGray
                       			3    DeviceRGB
                       			4    DeviceCMYK

BE      		dictionary 	(Optional; PDF 1.5) A border effect dictionary describing an effect applied to the
                   			border described by the BS entry (see Table 8.18).

The entries of Border Style dictionary (BS) are:

KEY  		TYPE   		VALUE

Type 		name   		(Optional) The type of PDF object that this dictionary describes; if present, must be
            				Border for a border style dictionary.

W    		number 		(Optional) The border width in points. If this value is 0, no border is drawn. Default
            				value: 1.

S    		name   		(Optional) The border style:
                			S    (Solid) A solid rectangle surrounding the annotation.
                			D    (Dashed) A dashed rectangle surrounding the annotation. The dash pattern
                 			      is specified by the D entry (see below).
                			B    (Beveled) A simulated embossed rectangle that appears to be raised above the
                			     surface of the page.
                			I    (Inset) A simulated engraved rectangle that appears to be recessed below the
                			     surface of the page.
                			U    (Underline) A single line along the bottom of the annotation rectangle.
            				      Other border styles may be defined in the future. Default value: S.

D    		array  		(Optional) A dash array defining a pattern of dashes and gaps to be used in drawing a
            				dashed border (border style D above). The dash array is specified in the same format
            				as in the line dash pattern parameter of the graphics state (see “Line Dash Pattern” on
            				page 217). The dash phase is not specified and is assumed to be 0. For example, a D
            				entry of [ 3 2 ] specifies a border drawn with 3-point dashes alternating with 2-point
            				gaps. Default value: [ 3 ].

As you can see to be compatible with PDF Specifications, border width must be editable (0, no border, is allowed and default is 1 point not 18 points).

Ciao...


More information about the Okular-devel mailing list