[Okular-devel] [Bug 159007] Personal gallery od stamps

[albert]

------- 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=159007         




------- Additional Comments From alberthilbert hotmail it  2008-03-10 17:00 -------
> I think that doesn't make sense. If we really will come to the point
> where we can save back annotations to a PDF document, we have to stay
> compatible with the PDF definitions of stamp annotations. And there is
> no way of storing a custom image stamp...

This is false!
PDF Reference, Sixth Edition, version 1.7 (http://www.adobe.com/devnet/acrobat/pdfs/pdf_reference_1-7.pdf), page 635 states:
a rubber stamp annotation (PDF 1.3) displays text or graphics intended to look as if they were stamped on the page with a rubber stamp.
The annotation dictionary entries specific to this type of annotation are:

KEY     		TYPE 		VALUE

Subtype 		name 		(Required) The type of annotation that this dictionary describes; must be Stamp
             				for a rubber stamp annotation.

Name 		name 		(Optional) The name of an icon to be used in displaying the annotation. Viewer
          				applications should provide predefined icon appearances for at least the follow-
          				ing standard names:
             				   Approved		Experimental		NotApproved
         				   AsIs			Expired			NotForPublicRelease
          				   Confidential		Final			Sold
          				   Departmental		ForComment		TopSecret
          				   Draft			ForPublicRelease
          				Additional names may be supported as well. Default value: Draft.
          				Note: The annotation dictionary’s AP entry, if present, takes precedence over the
          				Name entry; see Table 8.15 on page 606 and Section 8.4.4, “Appearance Streams.”
	
As you can see from the table, the aspect of stamp is specified by a Name entry or by an AP entry (that takes precedence over the Name entry). For the moment, okular provides only 4 symbols (okular, kde, bookmark, information), no one of them may be "safely" associated to the standard names reported in the specifications. The AP entry is an appearance dictionary specifying how the annotation is
presented visually on the page. The entries of a appearance dictionary are:

KEY 		TYPE                 		VALUE

N   		stream or dictionary 	(Required) The annotation’s normal appearance.

R   		stream or dictionary 	(Optional) The annotation’s rollover appearance. Default value: the value of
                         				the N entry.

D   		stream or dictionary 	(Optional) The annotation’s down appearance. Default value: the value of the
                         				N entry.

As you can see, the appearance of the annotation in this case is described by a stream and so may well contain an arbitrary image or text.
The AP mechanism is very important because even when okular will offer a symbol for each standard name they will be simply not enought for the generic user necessities.

Ciao...