Debian Codegraph @

podofo/API-MIGRATION.md

raw
1 # 1.0.* -> 1.1
2
3 - `PdfFontFactory`: Removed, this was a leftover of a removed class,
4 as a friendship declaration
5 - `PdfFontMetricsFreetype`: The `GetFaceHandle` can now be accessed only by
6 setting `PODOFO_3RDPARTY_INTEROP_ENABLED`. This was forgotten in 1.0 release
7 - `PdfCharCodeList`: Removed. This was used only privately and had a big
8 CHECK-ME/TODO asking for optimization. This was probably forgotten
9 and not migrated to private code
10
11 # 1.0.2 -> 1.0.1
12 - `PdfSignerCmsParams`: Deprecated `Encryption` field. The encryption is determined
13 from the public key in the X.509 certificate
14
15 ## 1.0.1 -> 1.0.2
16 - `PdfXMPPacket`: make reserved 3rd party interop `GetDescription` non const, as we
17 generally ensure const correctness in all the API (with limited exceptions)
18
19 ## 0.10.1 -> 1.0.0
20 - `PdfFontConfigWrapper`: Put `GetFcConfig()` and the constructor with `FcConfig*`
21 argument under guard by the `PODOFO_3RDPARTY_INTEROP_ENABLED` macro
22 - `PdfXMPPacket`: `GetDoc()`, `GetOrCreateDescription()`, `GetDescription()`
23 are now guarded by `PODOFO_3RDPARTY_INTEROP_ENABLED` macro
24 - `PdfContent`: the class is now generally not internally accessible as it was before.
25 You can now get content fields with safe getters, or you can directly access them
26 with `operator*` and `operator->` overloads, possibly after checking the type,
27 errors and warnings with `GetType()`, `GetErrors()` and `GetWarnings()`
28 - `PdfEncodingMapFactory`:
29 * `WinAnsiEncodingInstance()` renamed to `GetWinAnsiEncodingInstancePt()`
30 * `MacRomanEncodingInstance()` renamed to `GetPtrMacRomanEncodingInstancePtr()`
31 * `MacExpertEncodingInstance()` renamed to `GetMacExpertEncodingInstancePtr()`
32 * `TwoBytesHorizontalIdentityEncodingInstance()` renamed to `GetHorizontalIdentityEncodingInstancePtr()`
33 * `TwoBytesVerticalIdentityEncodingInstance()` renamed to `GetVerticalIdentityEncodingInstancePtr()`
34 * `GetStandard14FontEncodingMap()` renamed to `GetStandard14FontEncodingInstancePtr()`
35 - `PdfDifferenceEncoding`:
36 * Inverted parameters in constructor
37 * `NameToCodePoint()`: Renamed to `TryGetCodePointsFromCharName()`, changed the semantics and now it returns a `CodePointSpan` instead of `char32_t`
38 * `CodePointToName()`: Removed. It's not so simple to have an inverse map from code points to AGL name: there are multiple AGL lists and in the same AGL list there are ambiguous mappings. You can find a safest alternative in `PdfPredefinedEncodingType::TryGetCharNameFromCodePoint()` but it supports a smaller character set
39 - `PdfDifferenceList`:
40 * Renamed to `PdfDifferenceMap`
41 * `TryGetMappedName` now returns a `CodePointSpan` instead of `char32_t` in the overload
42 * `AddDifference`: Removed overload with name. Use `PdfDifferenceEncoding::TryGetCodePointsFromCharName()` first if you need a replacement
43 - `Object<T>`: Renamed to `ObjectAdapter<T>`
44 - `PdfArray`: `FindAtAs` doesn't take a default value anymore and throws on failed lookup . Use `FindAtAsSafe` instead
45 - `PdfDictionary`: `GetKeyAs`, `FindKeyAs`, `FindKeyAsParent`. doesn't take a default value anymore and throws on failed lookup . Use safe method versions instead
46 - `PdfXObjectForm`: Removed `HasRotation()`. Rotation is zero for xobject forms and it still implements privately `TryGetRotationRadians()`
47 - `PoDofo::TransformRectPage`: Removed `inputIsTransformed` parameter. Now the function accepts only rect in the canonical PDF coordinate system
48 - `PdfExtension`: Reworked constructor parameters
49 - `PdfTokenizer`:
50 * Moved `IsWhitespace`, `IsDelimiter`, `IsTokenDelimiter`, `IsRegular`, `IsPrintable` to `<podofo/optional/PdfUtils.h>`.
51 It doesn't seems justified to have them as part of the regular public API in PdfTokenizer.
52 Also renamed them with `IsChar` suffix.
53 * `IsPrintable`: Renamed to `IsCharASCIIPrintable`. That should be the correct semantic of the method
54 - `PoDoFo::GetPdfOperator()`, `PoDoFo::TryGetPdfOperator()`, `PoDoFo::GetPdfOperatorName()`, `PoDoFo::TryGetPdfOperatorName()`: Make them private, include `<podofo/optional/PdfConvert.h>` for substitutes
55 - `PoDoFo::GetOperandCount()`, `PoDoFo::TryGetOperandCount()`: Make them private, no substitute provided
56 - `PdfPageMode`:
57 * Removed `DontCare` (which was something like a pointless "ignore")
58 * Renamed `UseBookmarks` -> `UseOutlines`: "bookmark" is not really part of PDF terminology
59 - `PdfPageLayout`:
60 * Removed `Ignore` (pointless)
61 * Removed `Default`: just use nullptr in `PdfCatalog::SetPageLayout()`
62 - `GIDMap`: Removed, it was just a infrastructural typedef
63 - `PdfCIDToGIDMap`: Removed `HasGlyphAccess`, this map is always for accessing font program GIDs
64 - `PdfGlyphAccess`: `Width` renamed to `ReadMetrics`
65 - `Matrix2D`: Removed, all methods using it were converted to use `Matrix` instead, which is a full replacement
66 - `Matrix`: Removed `FromCoefficients()`, just use the now public constructor with coefficients
67 - `PdfTilingPattern`, `PdfShadingPatter`: Wholly changed API and semantics. See `PdfTilingPatternDefinition` and
68 `PdfShadingPatternDefinition`
69 - `PdfPainter`:
70 * `SetTilingPattern`, `SetShadingPattern`, `SetStrokingShadingPattern`, `SetStrokingTilingPattern`:
71 Removed, use the `SetStrokingPattern`,`SetShadingPattern`, `SetStrokingUncolouredTilingPattern`,
72 `SetNonStrokingUncolouredTilingPattern`
73 * Removed setting `PdfPainterFlags` in the constructor and moved to the `SetCanvas(canvas, flags)` method instead
74 - `PdfFontMetrics`:
75 * `GetFontNameSafe()` removed: Just use `GetFontName` instead
76 * `GetBaseFontName()`: make it protected, `GeFamilyFontNameSafe()` it's the closest substitute
77 * `GetBaseFontNameSafe()`: removed, `GeFamilyFontNameSafe()` it's the closest substitute
78 * `GetBoundingBox()` now returns `Corners`
79 * `TryGetImplicitEncoding()`: removed, no substitute supplied. Retrieving a implicit encoding it's more involuted
80 * `GetCIDToGIDMap()`: removed, no substitute supplied. CID to GID mappings can be retrieved only from the font
81 - `PdfFontMatchBehaviorFlags`: `MatchPostScriptName` inverted logic and renamed to `SkipMatchPostScriptName`
82 - `PdfFontConfigSearchFlags`: `MatchPostScriptName` inverted logic and renamed to `SkipMatchPostScriptName`
83 - `PdfContentType`:
84 * Renamed `EndXObjectForm` -> `EndFormXObject`
85 * `DoXObject` is issued for Form XObject only if `PdfContentReaderFlags::SkipFollowFormXObjects` is passed, otherwise `BeginXObjectForm` is issued
86 - `PdfContentReaderFlags`: Renamed `DontFollowXObjectForms` -> `SkipFollowFormXObjects`
87 - `PdfFont`:
88 * Renamed `IsCIDKeyed()` -> `IsCIDFont()`, which is less confusing
89 * Renamed `AddSubsetGIDs` -> `AddSubsetCIDs`
90 * Renamed `TryGetSubstituteFont` -> `TryCreateProxyFont`
91 * Removed `GetUsedGIDs`: it was more implementation detail for various embedding operations
92 - `PdfFontFileType`:
93 * Removed `CIDType1`. Just use `Type1` instead
94 * Renamed `OpenType` -> `OpenTypeCFF`
95 - Renamed `PdfFontCIDType0` -> `PdfFontCIDCFF`
96 - Renamed `PdfFontType::CIDType1` -> `PdfFontType::CIDCFF`
97 - `PdfTextBox`/`PdChoiceField`: Fixed `Spellchecking` casing to `SpellChecking`
98 - `PdfDrawTextMultiLineParams`:
99 * Inverted semantics of `Clip` and renamed to `SkipClip`
100 * Inverted semantics of `SkipSpaces` and renamed to `PreserveTrailingSpaces`
101 - `PdfVariant`/`PdfObect`: `GetDataTypeString()` now returns `string_view` instead of `const char*`
102 - `PdfErrorCode`:
103 * Renamed `FreeType` -> `FreeTypeError`
104 * Renamed `OpenSSL` -> `OpenSSLError`
105 * Renamed `InvalidDeviceOperation` -> `IOError`
106 * Renamed `NoPdfFile` -> `InvalidPDF`
107 * Renamed `NoObject` -> `ObjectNotFound`
108 * Renamed `NoTrailer` -> `InvalidTrailer`
109 * Renamed `NoEOFToken` -> `InvalidEOFToken`
110 * Renamed `XmpMetadata` -> `XmpMetadataError`
111 * Renamed Flate -> FlateError
112 * Removed unused `NoXRef`, `Date`, `ActionAlreadyPresent`, `MissingEndStream`, `InvalidTrailerSize`,
113 `SignatureError`, `NotCompiled`, `InvalidTrailerSize`, `DestinationAlreadyPresent`,
114 `OutlineItemAlreadyPresent`, `NotLoadedForUpdate`, `CannotEncryptedForUpdate`,
115 `InvalidHexString`, `InvalidStreamLength`, `InvalidXRefType`
116 - `PdfDocument`:
117 * Removed `AttachFile()`, `GetAttachment()`: Use `GetNames().GetNameTree<PdfEmbeddedFiles>()` or similar methods and use that instance
118 * Removed `AddNamedDestination()`: Use `GetNames().GetTree<PdfDestinations>()` or similar methods and use that instance
119 - `PdfName`: Removed `operator<`, `std::hash` overload. Just use new `PdfNameMap`, `PdfNameHashMap`,
120 or use `PdfNameInequality`, `PdfNameEquality` and `PdfNameHashing` to create your new data structure
121 - `PdfNameComparator`: Renamed to `PdfNameInequality`
122 - `PdfDictionaryMap`: Renamed to `PdfNameMap`
123 - `PdfResources`: Moved all string resource type functions to the `PdfResourceOperations` interface and
124 make all the implementations private. Cast `PdfResources` instances to this `PdfResourceOperations`
125 interface if you want to use the now reserved generic functions
126 - `PdfXObject`, `PdfFont`: Removed `GetIdentifier()`, the identifiers are now generated when inserted to `PdfResources`
127 - `PdfXObjet:SetMatrix()`: Removed and moved it to `PdfXObjectForm` (specification tells it doesn't belong to other XObject)
128 - `PdfGraphicsStateWrapper`:
129 * Renamed `SetFillColor()` -> `SetNonStrokingColor()`
130 * Renamed `SetFillColorSpace()` -> `SetNonStrokingColorSpace()`
131 * Renamed `SetStrokeColor()` -> `SetStrokingColor()`
132 * Renamed `SetStrokeColorSpace()` -> `SetStrokingColorSpace()`
133 * Renamed `SetCurrentMatrix()` -> `ConcatenateTransformationMatrix()`
134 - `PdfPage`:
135 * `GetRectRaw()` now returns `Corners` instead of `Rect`
136 * `SetRectRaw()` now takes `Corners` instead of `Rect`
137 * Removed `rawrect` parameter from `CreateField()`, use `SetRectRaw` after creation if you need it
138 * Removed `rawrect` parameter from `CreateAnnotation()`, use `SetRectRaw` after creation if you need it
139 * Renamed `MoveAt()` -> `MoveTo()`
140 * Removed `SetPageWidth()`, `SetPageHeight()`. Use `SetRect()`, `SetMediaBox()`, `SetCropBox()`, etc. instead
141 * Removed `SetICCProfile()`, `SetICCProfile()`: create a
142 `PdfColorSpaceFilterICCBased` and set it through `PdfGraphicsStateWrapper::SetNonStrokingColorSpace`
143 * `GetResources()`: Now it returns a reference instead (reflecting in the specification resources is required for pages)
144 * `MustGetResources()`: Removed, use the reference returning `GetResources()` instead
145 * Renamed `HasRotation()` -> `TryGetRotationRadians()`
146 * Removed `GetRotationRaw()` and introduced `TryGetRotationRaw()`
147 or `PdfGraphicsStateWrapper::SetStrokingColorSpace`
148 - `PdfColorSpaceFilter`: Make `GetExportObject` protected (no public substitute provided)
149 - `FileStreamDevice` doesn't inherit `StandardStreamDevice` anymore
150 - `PdfString`:
151 * `GetString()` and `GetRawData()` now returns `std::string_view`
152 * `PdfStringState` renamed to `PdfStringCharset`, `PdfString::GetState()`
153 renamed to `PdfString::GetCharset()` and added `PdfString::IsStringEvaluated()`
154 - `PdfName`: `GetString()` and `GetRawData()` now returns `std::string_view`
155 - `PdfMemDocument`:
156 * Renamed `LoadFromDevice()` -> `Load()`
157 * FreeObjectMemory: Removed, use PdfObject TryUnload() instead
158 * `AddPdfExtension`, `HasPdfExtension`, `RemovePdfExtension`, `GetPdfExtensions` to `PdfDocument`
159 * Renamed `AddPdfExtension` to `PushPdfExtension`
160 - `PdfAppearanceState`: Renamed to `PdfAppearanceStream`
161 - `PdfMetadata`:
162 * `GetTitle()`, `GetAuthor()`, `GetSubject()`, `GetKeywordsRaw()`, `GetCreator()`, `GetProducer()` now return `nullable<const PdfString&>` instead
163 * `GetCreationDate()`, `GetModifyDate()` now return `nullable<const PdfDate&>` instead
164 * `GetTrapped()` now returns `nullable<bool>` instead
165 * `SetTrapped()` now takes `nullable<bool>` instead
166 * `GetTrappedRaw()`: removed, you can still access `PdfInfo::GetTrapped()` for a raw version from /Info
167 * Removed argument `trySyncXMP` from all functions setting values. Manually call new `TrySyncXMPMetadata` instead
168 * Removed `EnsureXMPMetadata`, use `SyncXMPMetadata` instead
169 - Added `optional/PdfNames.h` and moved all known `PdfName::Key...` names there
170 - `PdfEncrypt`:
171 * `GenerateEncryptionKey` renamed to `EnsureEncryptionInitialized` and takes `PdfEncryptContxt` as an argument
172 * `Authenticate`, `EncryptTo`, `DecryptTo`, `CreateEncryptionInputStream`, `CreateEncryptionOutputStream` now take `PdfEncryptContxt` as an argument
173 - `PdfIndirectObjectList`:
174 * `SetStreamFactory` is now private, it's supposed to be used only by private PdfImmediateWriter
175 * `ReplaceObject`: Removed, it was added during pdfmm times when there was no better way to rewrite object streams without temporary objects
176 * `SetCanReuseObjectNumbers`, `GetCanReuseObjectNumbers`: Removed, the default is true ans it's untested with false. Reusing object numbers
177 is a standard PDF feature and it's better to fix bugs in that part (if any) than allowing to mess with internal indirect object numbering
178 in the public API
179 * `RemoveObject()`, `CreateStream()`, `Attach()` `Detach`, `Clear()`,`BeginAppendStream()`,`EndAppendStream()`, `TryIncrementObjectCount()`:
180 Removed from the public API: They have always been for inner use and dangerous to call for the user. For object removal we now rely on garbage collection
181 * Renamed `ObjectListComparator` to `PdfObjectInequality` and moved it to PoDoFo namespace
182 - `PdfExtGState`:
183 * Constructor is now private, create it through `PdfDocument::CreateExtGState(definition)`
184 * All methods removed: Retrieve the `PdfExtGStateDefinition` instance
185 * Fill opacity -> `PdfExtGStateDefinition::NonStrokingAlpha`
186 * Stroke opacity -> `PdfExtGStateDefinition::StrokingAlpha`
187 * FillOverprintEnabled, StrokeOverprintEnabled -> `PdfExtGStateDefinition::OverprintControl`
188 * NonZeroOverprintEnabled -> `PdfExtGStateDefinition::NonZeroOverprintMode`
189 * `SetFrequency()`: Removed, for now. Needs a more extensive HalfTone dictionary support
190 - `PdfStreamedObjectStream`: Removed from public API, it's an internal implementation detail
191 - `PdfXRefEntry`,`PdfXRefEntries`, `PdfParserObject`, `PdfXRefStreamParserObject`: Removed from public API,
192 they are internal implementation details
193 - `PdfParser`: Taken out of the public API, moved `GetMaxObjectCount`/`SetMaxObjectCount` to `PdfCommon`
194 - `PdfEncrypt`:
195 * Renamed `PdfEncryptAlgorithm::AESV3` -> `PdfEncryptAlgorithm::AESV3R5`
196 * Removed `SetEnabledEncryptionAlgorithms()`: Disabling algorithms is not supported anymore
197 * Removed `CreateFromEncrypt()`: Internal usage only
198 * Removed `GetUserPassword()`, `GetOwnerPassword()`: sensitive content, one shouldn't be able to retrieve again after setting;
199 * Removed `PdfAESV3Revision`: Internal usage only
200 * Removed `PdfEncryptSHABase`: Not needed
201 * Removed `PdfEncryptAESBase`, `PdfEncryptRC4Base`: Implementation details, moved to composition instead of multiple inheritance
202 * `PdfEncryptRC4`, `PdfEncryptAESV2`, `PdfEncryptAESV3` are now final
203 * Removed `PdfEncryptRC4`, `PdfEncryptAESV2`, `PdfEncryptAESV3` public constructors: Implementation details,
204 instances are not supposed to be created by API users
205 * `PdfEncryptMD5Base`: Removed `GetMD5Binary`, `GetMD5String`: They are not supposed to be part of a PDF library
206 - `PdfWriter`,`PdfImmediateWriter`: Removed from public API, they were an implementation detail
207 - `PdfFontManager::GetOrCreateFont(face)`, `PdfFontMetricsFreetype::CreateFromFace(face)`, `PdfFontMetrics::TryGetOrLoadFace(face)`, `PdfFontMetrics::GetOrLoadFace`: removed, exposing methods with `FT_Face` type may be dangerous in a public API because of possible mismatch of FreeType library version used by the API consumer and the version used in the PoDoFo compilation
208 - `FreeTypeFacePtr`: Removed, it was just used in the implementation
209 - Moved `PdfCMapEncoding::CreateFromObject` to `PdfEncodingMapFactory::ParseCMapEncoding`
210 - `PdfNameTree`:
211 * Renamed -> `PdfNameTrees`
212 * Moved all string tree type functions to the `PdfNameTreeOperations` and make mutable functions private. Cast to that type if you still want to use them
213 * `ToDictionary` now takes `std::map<PdfString, PdfObject>` as input
214 * `HasValue` -> renamed to `HasKey`
215 - Renamed enum `PdfColorSpace` -> `PdfColorSpaceType`, `PdfColorSpace` is now a doc element.
216 - `PdfColor` now it's used just to represent GrayScale, RGB, CMYK colors. Now `PdfColorRaw` is used to supply color components for other color spaces
217 - `PdfCanvas`:
218 * `GetRectRaw()` now returns `Corners` instead of `Rect`
219 * Rename `GetStreamForAppending()` -> `GetOrCreateContentsStream()`
220 * Removed `GetFromResources`: just use `GetResources`
221 * Renamed `HasRotation()` -> `TryGetRotationRadians()`
222 - `PdfContents`: `Reset()` is now parameterless. It was created to replace the stream. To achieve the same one can do GetStreamForAppending()
223 and use move semantics on the stream
224 - `PdfContents`: Rename `GetStreamForAppending()` -> `CreateStreamForAppending()`
225 - `PdfParserObject::HasStreamToParse()` Make it protected virtual in `PdfObject` (it's unreliable to access it publicly)
226 - Removed `PdfFontMetricsFreetype::FromBuffer()`
227 - Make `PdfFontMetricsFreetype::FromMetrics()` private (it's really an internal method)
228 - Removed `PdfFontTrueTypeSubset`: it's an implementation detail and not to be exposed in the public API
229 - `PdfFilespec`:
230 * Removed public constructors, moved construction to `PdfDocument::CreateFilespec()`
231 * Moved setters to public methods instead of construction parameters. By default now just the `/UF` entry is set
232 - `PdfDestination`:
233 * Removed public constructors, moved construction to `PdfDocument::CreateDestination()`
234 - `PdfAction`:
235 * Reworked hierarchy, create `PdfActionURI`, `PdfActionJavascript` and so on classes. Moved URI, script accessors
236 to respective classes
237 * Removed public constructors, moved construction to `PdfDocument::CreateAction()`
238 - `PdfOutlineItem`, `PdfOutlines`:
239 * Removed public constructors, they are now construct privately only
240 * Removed `GetTextColorRed()`, `GetTextColorGreen()`, `GetTextColorBlue()`, added `GetTextColor()` that returns `PdfColor`
241 * `SetTextColor()` now takes a `PdfColor`
242 * Setting/Getting destination now uses `nullable<PdfDestination&>`
243 * Setting/Getting action now uses `nullable<PdfAction&>`
244 * `InsertChild` is now private only
245 - `PdfAnnotation`:
246 * `GetRectRaw()` now returns `Corners` instead of `Rect`
247 * `SetRectRaw()` now takes `Corners` instead of `Rect`
248 - `PdfAnnotationActionBase`:
249 * Setting/Getting action now uses `nullable<PdfAction&>`
250 - `PdfAnnotationLink`:
251 * Setting/Getting destination now uses `nullable<PdfDestination&>`
252 - `PdfAnnotationFileAttachment`:
253 * Setting/Getting filespec now uses `nullable<PdfFilespec&>`
254 - `PdfRef`, `PdfXRefStream`: Make the constructor internal, `PdfXRefStream` class final
255 - `PdfSignature`:
256 * Removed `SetAppearanceStream`. Use `GetWidget().SetAppearanceStream()` (plus optional `GetWidget().GetOrCreateAppearanceCharacteristics()`, if you needed that) instead
257 * `PrepareForSigning()`: Make it internal
258 - `PdfACtion` hierarchy: make all hierarchy constructors internals and leave classes final
259 - `PdfField` hierarchy: make all hierarchy leave classes final
260 - `PdfDataProvider`, `PdfDataContainer`: Make the classes internal
261 - `PdfEncodingMapOneByte` renamed to `PdfEncodingMapSimple`
262 - `PdfEncodingMap`, `PdfEncodingMapSimple`, `PdfBuiltInEncoding`, `PdfPredefinedEncoding`, `PdfEncodingMapBase`: make the constructors internal
263 - `PdfEncodingMap`:
264 * Removed `IsBuiltinEncoding`. No replacement, it just told if the font was built-in in Type1 font program. For now it's not expected to be useful
265 * `TryGetCodePoints()`, `TryGetNextCodePoints` now takes `CodePointSpan` instead of vector<codepoint>
266 * `TryGetExportObject`: Make it private, no public substitute provided
267 - `PdfCharCodeMap`: `TryGetCodePoints()` now takes `CodePointSpan` instead of vector<codepoint>
268 - `PdfEncoding`: `TryScan` now takes `CodePointSpan` instead of vector<codepoint>
269 - `PdfExtension`: Make the constructor internal and class final
270 - `PdfFilter`: Make the constructor internal
271 - `PdfFilterFactory`: Make class internal use only
272 - `PdfFont`, `PdfFontSimple`, `PdfFontCID`, `PdfFontObject`: Make the constructor internal
273 - `PdfFontType1`, `PdfFontType3`, `PdfFontTrueType`, `PdfFontCIDTrueType`, `PdfFontCIDType1`: Make the classes final
274 - `PdfObjectInputStream`, `PdfObjectOutputStream`: Make the classes final
275 - `PdfObjectStreamParser`: Made the class internal use only
276 - `PdfWinAnsiEncoding`: Made the class final
277 - `PdfXObjectPostScript`: Made the class final
278 - `PdfContents`: Made the constructor internal and the class internal
279 - `PdfCatalog`: Made the constructor internal
280 - `PdfEncoding`: Made the class final, made `ExportToFont()` internal
281
282 ## 0.10.0 -> 0.10.1
283 - `PdfParser::TakeEncrypt()` -> `PdfParser::GetEncrypt()` which now returns `std::shared_ptr`. This change was needed to address a vulnerability concern in #70. Although public, This method is considered to be infrastructural and not called often outside of PoDofo;
284 - `PdfPageTreeCache` was removed. Also this class was infrastructural and probably not used outside of PoDofo.
285
286 ## 0.9.8 -> 0.10.0
287
288 The following is an incomplete list of 0.9.8 -> 0.10.0 API modifications. Feel free to suggest improvements in the ML or in a GitHub issue.
289
290 - Removed all `pdf_int*` types and moved to standard `int*_t` types;
291 - Removed `pdf_long` and all usages converted to either `size_t` and `ssize_t`;
292 - Renamed `PdfVecObjects` -> `PdfIndirectObjectList`
293 - Renamed `PdfFontCache` -> `PdfFontManager`
294 - Renamed `PdfNamesTree` -> `PdfNameTree`
295 - Renamed `PdfPagesTree` -> `PdfPageCollection`
296 - Renamed `PdfInputDevice` -> `InputDevice`
297 - Renamed `PdfOutputDevice` -> `OutputDevice`
298 - Renamed `PdfInputStream` -> `InputStream`
299 - Renamed `PdfOutputStream` -> `OutputStream`
300 - Merged `InputDevice`/`OutputDevice` into `StreamDevice`
301 - Renamed `PdfDocument::GetNameTree()` -> `GetNames()`
302 - `PdfDocument::GetPage()`/`PdfDocument::CreatePage()` removed and moved to `PdfPageCollection`
303 - `PdfDocument::CreateFont()`, `PdfDocument::CreateFontSubset` moved to `PdfFontManager::SearchFonts()`, `PdfFontManager::GetStandard14Font()`, `PdfFontManager::GetOrCreateFont()`, `PdfDocument::GetOrCreateFontFromBuffer()`
304 - Removed `PdfDocument::CreateDuplicateFontType1()`
305 - Renamed `PdfMemDocument::Write()` -> `PdfMemDocument::Save()`
306 - `PdfArray::FindAt()` now returns reference
307 - `PdfDocument::GetFontCache()` -> `PdfDocument::GetFonts()`
308 - `PdfPage::GetAnnot()` and annotations methods are removed. Use `PdfPage::GetAnnots()` instead
309 - `PdfWriteFlags` are now internal use, use `PdfSaveOptions` instead
310 - `PdfXObject`, is now an abstract class. Refer to `PdfXObjectForm`
311 - To create a `PdfXObjectForm`, use `PdfDocument::CreateXObjectForm()`
312 - `PdfAnnotation`, is now an abstract class. Refer to the full new hierarchy (`PdfAnnotationWidget`, `PdfAnnotationLink`, ...)
313 - Renamed `PdfSignatureField` -> `PdfSignature`
314 - Renamed `PdfTextField` -> `PdfTextBox`
315 - Renamed `PdfListField` -> `PdfChoiceField`
316 - Renamed `PdfImage::GetFilteredCopy()` -> `PdfImage::GetDecodedCopy()`
317 - `PdfObject::GetIndirectKey()` like methods removed. Use `PdfObject::TryGetDictionary(dict)` and `PdfDictionary` methods instead
318 - `PdfSignOutputDevice` removed, use `PoDoFo::SignDocument()` instead
319 - `PdfDate::PdfDate()` now creates an epoch date. Use `PdfDate::LocalNow()` `PdfDate::UtcNow()`.
320 `PdfDate::PdfDate(str)` is moved to `PdfDate::Parse(str)`
321 - `PdfFontMetrics::GetStringWidth()` -> `PdfFont::GetStringLength(state)`, `PdfFontMetrics::GetGlyphWidth()` -> `PdfFont::GetCharLength()` with state filled with `FontSize`
322 - `PdfFont::SetFontSize()` removed. See functions in `PdfFont` that accepts `PdfTextState`. `PdfFont::SetBold()`, `PdfFont::SetItalic()` removed as they were no sense. Font style now is read-only and can be read from `PdfFontMetrics::GetFontStyle()`
323 - `PdfTable`: Removed as providing formatting features that are too high level for the scope of PoDoFo
324 - `PdfDocument::Clear()`: Removed, reintroduced in >0.10 as `PdfDocument::Reset()`
325 - `PdfDocument::InsertExistingPageAt`: Moved and renamed to `PdfPageCollection::InsertDocumentPageAt`
326 - `PdfDocument::Append`: Moved, renamed and improved to `PdfPageCollection::AppendDocumentPages`
327 - `PdfPage::GetField()`, `PdfPage::GetFieldCount()`: Removed, [iterate annotations](https://github.com/podofo/podofo/issues/158#issuecomment-2081646748) instead for now.