George Bilalis wrote:
> Q: What are the exact parameters saved (- or restored by restoreState())
>  by this method?

You probably know this and it's very obvious, but in case
you didn't know: saveState doesn't really save anything in
your Java program (in any case: nothing essential).
The only important thing the methods saveState and restoreState
do is writing a 'q' (save) or a 'Q' (restore) to the OutputStream
(and some whitespace). This is the 'stupid' answer, in case your
question is a 'newbie' question ;-)

The actual 'saving/restoring of the graphics state' happens
in the PDF viewer. The PDF viewer has to keep track of properties
such as the current line width, current fill color, current stroke
color, and so on.

This is how the PDF Reference describes it (section 4.3.1 p214-215):

"A well-structured PDF document typically contains many graphical
elements that are essentially independent of each other and sometimes
nested to multiple levels. The graphics state stack allows these
elements to make local changes to the graphics state without disturbing
the graphics state of the surrounding environment.

The stack is a LIFO (last in, first out) data structure in which the
contents of the graphics state can be saved and later restored using
the following operators:

* The q operator pushes a copy of the entire graphics state onto the
   stack.
* The Q operator restores the entire graphics state to its former value
   by popping it from the stack.

These operators can be used to encapsulate a graphical element so that
it can modify parameters of the graphics state and later restore them
to their previous values. Occurrences of the q and Q operators must be
balanced within a given content stream (or within the sequence of
streams specified in a page dictionary’s Contents array)."

The answer to your question "what are the exact parameters" is
the "entire graphics state". If you want a list, please read
chapter 4 and 5 of the PDF Reference (it's about 300 pages,
I can't copy/paste all this in a mail).

This is the intelligent answer, probably the one you expected.
br,
Bruno

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
iText-questions mailing list
iText-questions@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/itext-questions
Buy the iText book: http://itext.ugent.be/itext-in-action/

Reply via email to