…esult

Cairo's surface creation functions never return NULL; instead they
always return a surface, but it may be in an error state.  In gtk-rs#141 we
started making the binding functions return Result for this; some
returned the plain FooSurface type, some others Option<FooSurface>.

This makes the following functions return Result<FooSurface, Status>

  Surface::create_similar()
  Surface::create_similar_image()

  Device.surface_create()
  Device.surface_create_for_target()
  PdfSurface::new()
  RecordingSurface::create()
  RecordingSurface::from_raw_full()
  SvgSurface::new()
  XCBSurface::create()
  XCBSurface::create_for_bitmap()
  XCBSurface::create_with_xrender_format()

  From macro for_stream_constructors!:
  *::for_stream()
  *::for_raw_stream()

The foundation for all of this is that Surface::from_raw_full() now
also returns Result<FooSurface, Status>.  This is to make things
consistent with ImageSurface::from_raw_full().  Analogously, we now
have RecordingSurface::from_raw_full() that also returns Result.

Fixes gtk-rs#251

These may fail due to the caller passing a too-big size.

Most of cairo_pdf_surface_*() can set the surface to an error state,
due to their internal call to _extract_pdf_surface(), which checks a
few conditions with the surface itself and the paginated surface.

Thanks to @EPashkin for the suggestion.

Also, do the from_glib_*() in the same fashion as ImageSurface.

Also, do the from_glib_*() in the same fashion as ImageSurface.

Also, do the from_glib_*() in the same fashion as ImageSurface.

… ones

… others

This makes them consistent, and should make it possible to generate
them with a macro.

This includes implementations of:

  struct DerivedSurface(Surface)
  TryFrom<Surface>
  DerivedSurface.from_raw_full()
  ToGlibPtr
  FromGlibPtrNone
  FromGlibPtrBorrow
  FromGlibPtrFull
  gvalue_impl!
  Deref
  Clone
  Display