[librsvg] First try at documenting RenderingError
- From: Federico Mena Quintero <federico src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [librsvg] First try at documenting RenderingError
- Date: Tue, 5 May 2020 17:08:45 +0000 (UTC)
commit 8161f70011697fef21fbb0c842f9b558f80f9b41
Author: Federico Mena Quintero <federico gnome org>
Date: Mon May 4 15:34:17 2020 -0500
First try at documenting RenderingError
rsvg_internals/src/error.rs | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
---
diff --git a/rsvg_internals/src/error.rs b/rsvg_internals/src/error.rs
index 0b1b2cc5..58405dda 100644
--- a/rsvg_internals/src/error.rs
+++ b/rsvg_internals/src/error.rs
@@ -101,14 +101,33 @@ pub enum DefsLookupErrorKind {
NotFound,
}
+/// Errors that can happen while rendering or measuring an SVG document.
#[derive(Debug, Clone, PartialEq)]
pub enum RenderingError {
+ /// A Cairo error happened during rendering.
Cairo(cairo::Status),
+
+ /// There is a circular reference between elements.
+ // FIXME: should be internal only.
CircularReference,
+
+ /// The maximum number of rendered objects was reached.
+ ///
+ /// Librsvg has a limit on the number of rendered objects, so that malicious
+ /// files cannot consume CPU time arbitrarily.
InstancingLimit,
+
+ /// Tried to reference an SVG element from a fragment identifier that is incorrect.
InvalidId(DefsLookupErrorKind),
+
+ // FIXME: unused.
InvalidHref,
+
+ /// Not enough memory was available for rendering.
+ // FIXME: right now this is only returned from pixbuf_utils.rs
OutOfMemory,
+
+ /// Cannot occur from librsvg_crate; this is just for the C API.
HandleIsNotLoaded,
}
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]