1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
//! Defines the [PdfiumError] enum, used to wrap Pdfium errors as `Err` values.
use crate::bindgen::{
FPDF_ERR_FILE, FPDF_ERR_FORMAT, FPDF_ERR_PAGE, FPDF_ERR_PASSWORD, FPDF_ERR_SECURITY,
FPDF_ERR_UNKNOWN,
};
use std::error::Error;
use std::ffi::IntoStringError;
use std::fmt::{Display, Formatter, Result};
#[cfg(target_arch = "wasm32")]
use wasm_bindgen::JsValue;
/// A wrapped internal library error from Pdfium's FPDF_ERR_* constant values.
#[derive(Debug)]
pub enum PdfiumInternalError {
Unknown = FPDF_ERR_UNKNOWN as isize,
FileError = FPDF_ERR_FILE as isize,
FormatError = FPDF_ERR_FORMAT as isize,
PasswordError = FPDF_ERR_PASSWORD as isize,
SecurityError = FPDF_ERR_SECURITY as isize,
PageError = FPDF_ERR_PAGE as isize,
}
#[derive(Debug)]
pub enum PdfiumError {
/// The Pdfium WASM module has not been configured.
/// It is essential that the exported `initialize_pdfium_render()` function be called
/// from Javascript _before_ calling any `pdfium-render` function from within your Rust code.
/// See: <https://github.com/ajrcarey/pdfium-render/blob/master/examples/index.html>
#[cfg(target_arch = "wasm32")]
PdfiumWASMModuleNotConfigured,
/// The external Pdfium library could not be loaded.
#[cfg(not(target_arch = "wasm32"))]
LoadLibraryError(libloading::Error),
UnrecognizedPath,
PageIndexOutOfBounds,
LinkIndexOutOfBounds,
UnknownBitmapFormat,
UnknownBitmapRotation,
UnknownFormType,
UnknownFormFieldType,
UnknownActionType,
PageObjectIndexOutOfBounds,
PageObjectNotAttachedToPage,
PageObjectAlreadyAttachedToDifferentPage,
PageAnnotationIndexOutOfBounds,
PageObjectNotAttachedToAnnotation,
PageFlattenFailure,
PageMissingEmbeddedThumbnail,
UnknownPdfPageObjectType,
UnknownPdfPageTextRenderMode,
UnknownPdfPagePathFillMode,
UnknownPdfAnnotationType,
UnknownPdfSecurityHandlerRevision,
UnsupportedPdfPageObjectType,
TextSegmentIndexOutOfBounds,
CharIndexOutOfBounds,
NoCharsInPageObject,
NoCharsInAnnotation,
NoCharsInRect,
ImageObjectFilterIndexOutOfBounds,
ImageObjectFilterIndexInBoundsButFilterUndefined,
UnknownPdfColorSpace,
InvalidTransformationMatrix,
SignatureIndexOutOfBounds,
AttachmentIndexOutOfBounds,
NoDataInAttachment,
FontGlyphIndexOutOfBounds,
UnknownPathSegmentType,
NoPagesInDocument,
NoPageObjectsInCollection,
PageObjectNotCloneable,
ImageObjectFiltersNotCloneable,
PathObjectBezierControlPointsNotCloneable,
PathObjectUnknownSegmentTypeNotCloneable,
GroupContainsNonCloneablePageObjects,
SourcePageIndexNotInCache,
NoUriForAction,
/// An error occurred converting a byte stream into a CString.
CStringConversionError(IntoStringError),
/// Two data buffers are expected to have the same size, but they do not.
DataBufferLengthMismatch,
/// The setting cannot be returned because this `PdfPageGroupObject` is empty.
EmptyPageObjectGroup,
/// A call to a internal Pdfium `FPDF_*` function returned a value indicating failure.
///
/// For Pdfium functions that return enumerations, this means the function returned
/// a value of -1 rather than a valid enumeration constant.
///
/// For Pdfium functions that return C-style boolean integers, this means that the function
/// returned a value other than `PdfiumLibraryBindings::TRUE`.
PdfiumFunctionReturnValueIndicatedFailure,
/// A call to a Pdfium function that returns a standard 8-bit color component value
/// (for example, `FPDFPageObj_GetStrokeColor()` and `FPDFPageObj_GetStrokeColor()`)
/// successfully returned a value, but the value could not be converted from a c_int
/// to a standard Rust u8.
UnableToConvertPdfiumColorValueToRustu8(std::num::TryFromIntError),
/// The browser's built-in `Window` object could not be retrieved.
WebSysWindowObjectNotAvailable,
/// A JsValue returned from a function call was set to JsValue::UNDEFINED instead of
/// a valid value of the expected type.
#[cfg(target_arch = "wasm32")]
JsValueUndefined,
/// An error was returned when attempting to use the browser's built-in `fetch()` API.
#[cfg(target_arch = "wasm32")]
WebSysFetchError(JsValue),
/// An invalid Response object was returned when attempting to use the browser's built-in `fetch()` API.
#[cfg(target_arch = "wasm32")]
WebSysInvalidResponseError,
/// An error was returned when attempting to construct a `Blob` object from a byte buffer.
#[cfg(target_arch = "wasm32")]
JsSysErrorConstructingBlobFromBytes,
/// An error occurred when attempting to retrieve the function table for the compiled
/// Pdfium WASM module.
#[cfg(target_arch = "wasm32")]
JsSysErrorRetrievingFunctionTable(JsValue),
/// An error occurred when attempting to retrieve an exported function from
/// `pdfium-render`'s WASM module.
#[cfg(target_arch = "wasm32")]
JsSysErrorRetrievingFunction(JsValue),
/// An error occurred when attempting to update an entry in Pdfium's WASM function table.
#[cfg(target_arch = "wasm32")]
JsSysErrorPatchingFunctionTable(JsValue),
/// No previously cached function was available for a WASM function table restore operation.
///
/// This error should never occur; if it does, it indicates a programming error in pdfium-render.
/// Please file an issue: https://github.com/ajrcarey/pdfium-render/issues
#[cfg(target_arch = "wasm32")]
NoPreviouslyCachedFunctionSet,
/// An error occurred during an image processing operation.
ImageError,
/// Dimensions of `Image::Image` are specified in `u32`, but bitmaps in Pdfium are sized in
/// `c_int` (`i32`), meaning that an `Image::Image` can have dimensions that overflow
/// the maximum size of a Pdfium bitmap. As a compromise, Image dimensions in `pdfium-render`
/// are limited to `u16`.
///
/// This error indicates that an `Image::Image` had a width or height larger than the maximum
/// `u16` size allowed by `pdfium-render`.
ImageSizeOutOfBounds,
/// An I/O error occurred during a Pdfium file operation.
IoError(std::io::Error),
/// A wrapped internal library error from Pdfium's `FPDF_ERR_*` constant values.
PdfiumLibraryInternalError(PdfiumInternalError),
}
impl Display for PdfiumError {
fn fmt(&self, f: &mut Formatter<'_>) -> Result {
write!(f, "{:#?}", self)
}
}
impl Error for PdfiumError {}