01: /*
02: Copyright © 2006,2007 Stefano Chizzolini. http://clown.stefanochizzolini.it
03:
04: Contributors:
05: * Stefano Chizzolini (original code developer, http://www.stefanochizzolini.it):
06: contributed code is Copyright © 2006,2007 by Stefano Chizzolini.
07:
08: This file should be part of the source code distribution of "PDF Clown library"
09: (the Program): see the accompanying README files for more info.
10:
11: This Program is free software; you can redistribute it and/or modify it under
12: the terms of the GNU General Public License as published by the Free Software
13: Foundation; either version 2 of the License, or (at your option) any later version.
14:
15: This Program is distributed in the hope that it will be useful, but WITHOUT ANY
16: WARRANTY, either expressed or implied; without even the implied warranty of
17: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the License for more details.
18:
19: You should have received a copy of the GNU General Public License along with this
20: Program (see README files); if not, go to the GNU website (http://www.gnu.org/).
21:
22: Redistribution and use, with or without modification, are permitted provided that such
23: redistributions retain the above copyright notice, license and disclaimer, along with
24: this list of conditions.
25: */
26:
27: package it.stefanochizzolini.clown.documents.contents;
28:
29: import it.stefanochizzolini.clown.objects.PdfArray;
30:
31: /**
32: Content stream context.
33: @version 0.0.5
34: */
35: public interface IContentContext extends IContentEntity {
36: /**
37: Gets the bounding box associated with the object, either explicitly (directly
38: associated to the object) or (if not explicitly available) implicitly (inherited
39: from a higher level object).
40: <h3>Remarks</h3>
41: <p>The box represents the physical-coordinates frame expressed in default
42: user-space units. This frame is crucial for the proper positioning of graphic
43: elements on the canvas, as the spec [PDF:1.6:4.2] *sadly* states that the
44: coordinate system is positively-oriented, although the typographic coordinates
45: would be conveniently expressed as negatively-oriented.</p>
46: */
47: PdfArray getBox();
48:
49: /**
50: Gets the contents collection representing the content stream.
51: @version 0.0.5
52: @since 0.0.5
53: */
54: Contents getContents();
55:
56: /**
57: Gets the resources associated with the object, either explicitly (directly
58: associated to the object) or (if not explicitly available) implicitly (inherited
59: from a higher level object).
60: <h3>Remarks</h3>
61: <p>The implementing class MUST ensure that the returned object isn't null.</p>
62: */
63: Resources getResources();
64: }
|