cairo-Error-Handling {RGtk2} | R Documentation |
Decoding cairo's status
cairoStatusToString(status)
Cairo uses a single status type to represent all kinds of errors. A status
value of CAIRO_STATUS_SUCCESS
represents no error and has an integer value
of zero. All other status values represent an error.
Cairo's error handling is designed to be easy to use and safe. All major
cairo objects retain an error status internally which
can be queried anytime by the users using cairo*status()
calls. In
the mean time, it is safe to call all cairo functions normally even if the
underlying object is in an error status. This means that no error handling
code is required before or after each individual cairo function call.
CairoStatus
CairoStatus
is used to indicate errors that can occur when
using Cairo. In some cases it is returned directly by functions.
but when using Cairo
, the last error, if any, is stored in
the context and can be retrieved with cairoStatus
.
New entries may be added in future versions. Use cairoStatusToString
to get a human-readable representation of an error message.
success
no-memory
invalid-restore
cairoRestore
called without matching cairoSave
invalid-pop-group
no-current-point
invalid-matrix
invalid-status
CairoStatus
null-pointer
NULL
pointerinvalid-string
invalid-path-data
read-error
write-error
surface-finished
surface-type-mismatch
pattern-type-mismatch
invalid-content
CairoContent
invalid-format
CairoFormat
invalid-visual
file-not-found
invalid-dash
invalid-dsc-comment
invalid-index
clip-not-representable
Derived by RGtkGen from GTK+ documentation
http://www.cairographics.org/manual/cairo-Error-Handling.html