1. ----------------------------------------------------------------------- 
  2. --               GtkAda - Ada95 binding for Gtk+/Gnome               -- 
  3. --                                                                   -- 
  4. --                    Copyright (C) 2011-2013, AdaCore               -- 
  5. --                                                                   -- 
  6. -- This library is free software; you can redistribute it and/or     -- 
  7. -- modify it under the terms of the GNU General Public               -- 
  8. -- License as published by the Free Software Foundation; either      -- 
  9. -- version 2 of the License, or (at your option) any later version.  -- 
  10. --                                                                   -- 
  11. -- This library is distributed in the hope that it will be useful,   -- 
  12. -- but WITHOUT ANY WARRANTY; without even the implied warranty of    -- 
  13. -- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU -- 
  14. -- General Public License for more details.                          -- 
  15. --                                                                   -- 
  16. -- You should have received a copy of the GNU General Public         -- 
  17. -- License along with this library; if not, write to the             -- 
  18. -- Free Software Foundation, Inc., 59 Temple Place - Suite 330,      -- 
  19. -- Boston, MA 02111-1307, USA.                                       -- 
  20. --                                                                   -- 
  21. -- As a special exception, if other files instantiate generics from  -- 
  22. -- this unit, or you link this unit with other files to produce an   -- 
  23. -- executable, this  unit  does not  by itself cause  the resulting  -- 
  24. -- executable to be covered by the GNU General Public License. This  -- 
  25. -- exception does not however invalidate any other reasons why the   -- 
  26. -- executable file  might be covered by the  GNU Public License.     -- 
  27. ----------------------------------------------------------------------- 
  28.  
  29. package Cairo.PDF is 
  30.  
  31.    function Create 
  32.      (Filename         : String; 
  33.       Width_In_Points  : Gdouble; 
  34.       Height_In_Points : Gdouble) return Cairo_Surface; 
  35.    --  Creates a PDF surface of the specified size in points to be written to 
  36.    --  filename. 
  37.    -- 
  38.    --  filename : 
  39.    --   a filename for the PDF output (must be writable), NULL may be used to 
  40.    --   specify no output. This will generate a PDF surface that may be queried 
  41.    --   and used as a source, without generating a temporary file. 
  42.    --  width_in_points: 
  43.    --   width of the surface, in points (1 point == 1/72.0 inch) 
  44.    --  height_in_points: 
  45.    --   height of the surface, in points (1 point == 1/72.0 inch) 
  46.    --  Returns: 
  47.    --   a pointer to the newly created surface. The caller owns the surface and 
  48.    --   should call cairo_surface_destroy() when done with it. This function 
  49.    --   always returns a valid pointer, but it will return a pointer to a "nil" 
  50.    --   surface if an error such as out of memory occurs. You can use 
  51.    --   cairo_surface_status() to check for this. 
  52.    -- 
  53.    --  Since 1.2 
  54.  
  55. end Cairo.PDF;