package cairo2

You can search for identifiers within the package.

in-package search v0.2.0

Package contains no libraries

The PDF surface is used to render cairo graphics to Adobe PDF files and is a multi-page vector surface backend.

To create a cairo context cr that will write the the PDF file fname with dimensions w×h points, do let cr = Cairo.create(Cairo.PDF.create fname w h). Do not forget to call Surface.finish(get_target cr) when you are done drawing because the file may not be fully written before.

val create : fname:string -> width:float -> height:float -> Surface.t

Creates a PDF surface of the specified size in points to be written to fname.

parameter width
width of the surface, in points (1 point = 1/72.0 inch)

parameter height
height of the surface, in points (1 point = 1/72.0 inch)

val create_for_stream : 
  output:(string -> unit) ->
  width:float ->
  height:float ->
  Surface.t

Creates a PDF surface of the specified size in points to be written incrementally to the stream represented by output. Any exception that output raises is considered as a write error.

parameter width
width of the surface, in points (1 point = 1/72.0 inch)

parameter height
height of the surface, in points (1 point = 1/72.0 inch)

val set_size : Surface.t -> width:float -> height:float -> unit

Changes the size of a PDF surface for the current (and subsequent) pages.

parameter width
width of the surface, in points (1 point = 1/72.0 inch)

parameter height
height of the surface, in points (1 point = 1/72.0 inch)
This function should only be called before any drawing operations have been performed on the current page. The simplest way to do this is to call this function immediately after creating the surface or immediately after completing a page with either Cairo.show_page or Cairo.copy_page.