1 /*2 Copyright © 2006 Stefano Chizzolini. http://clown.stefanochizzolini.it3 4 Contributors:5 * Stefano Chizzolini (original code developer, info@stefanochizzolini.it):6 contributed code is Copyright © 2006 by Stefano Chizzolini.7 8 This file should be part of the source code distribution of "PDF Clown library"9 (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 under12 the terms of the GNU General Public License as published by the Free Software13 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 ANY16 WARRANTY, either expressed or implied; without even the implied warranty of17 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 this20 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 such23 redistributions retain the above copyright notice, license and disclaimer, along with24 this list of conditions.25 */26 27 package it.stefanochizzolini.clown.documents.contents;28 29 import it.stefanochizzolini.clown.objects.PdfArray;30 import it.stefanochizzolini.clown.objects.PdfDictionary;31 32 /**33 Content stream context.34 */35 public interface IContentStreamContext36 {37 /**38 Gets the bounding box associated with the object, either explicitly (directly39 associated to the object) or (if not explicitly available) implicitly (inherited40 from a higher level object).41 <h3>Remarks</h3>42 <p>The box represents the physical-coordinates frame expressed in default43 user-space units. This frame is crucial for the proper positioning of graphic44 elements on the canvas, as the spec [PDF:1.6:4.2] *sadly* states that the45 coordinate system is positively-oriented, although the typographic coordinates46 would be conveniently expressed as negatively-oriented (typical content flow47 moves from top to bottom, doesn't it? -- in the spec opinion, typical48 user-space content flow moves from bottom to top!!! I can't doubt that PDF is49 agnostic about the concept of "content flow", anyway this choice is quite50 bizarre...).</p>51 */52 PdfArray getContextBox(53 );54 55 /**56 Gets the resources associated with the object, either explicitly (directly57 associated to the object) or (if not explicitly available) implicitly (inherited58 from a higher level object).59 */60 PdfDictionary getContextResources(61 );62 }