Deprecated List (iText 7 - kernel 7.1.17 API)

Deprecated Interfaces
Interface and Description
com.itextpdf.kernel.log.ICounter will be removed in next major release, please use `EventCounter` instead.
com.itextpdf.kernel.log.ICounterFactory will be removed in next major release, please use `IEventCounterFactory` instead.

Deprecated Classes
Class and Description
com.itextpdf.kernel.log.CounterManager will be removed in next major release, please use `EventCounterHandler` instead.
com.itextpdf.kernel.log.DefaultCounter will be removed in next major release, please use `DefaultEventCounter` instead.
com.itextpdf.kernel.pdf.annot.PdfRichMediaAnnotation Remove this class in 7.2. The deprecation relates to the fact that the prototype hasn't been implemented in a full yet and we do not expect the situation to change.
com.itextpdf.kernel.log.SimpleCounterFactory will be removed in next major release, please use `SimpleEventCounterFactory` instead.
com.itextpdf.kernel.log.SystemOutCounter will be removed in the next major release, please use `SystemOutEventCounter` instead.
com.itextpdf.kernel.log.SystemOutCounterFactory will be removed in the next major release, please use `SystemOutEventCounterFactory` instead.

Deprecated Fields
Field and Description
com.itextpdf.kernel.PdfException.CannotAddNonDictionaryExtGStateToResources1
com.itextpdf.kernel.PdfException.CannotSetDataToPdfstreamWhichWasCreatedByInputStream
com.itextpdf.kernel.pdf.PdfDocument.currentPage Will be removed in iText 7.2
com.itextpdf.kernel.font.PdfFont.DEFAULT_FONT_MATRIX
com.itextpdf.kernel.PdfException.DictionaryDoesntHave1FontData Will be removed in nex major release as there are no usages left.
com.itextpdf.kernel.PdfException.FontSizeIsTooSmall
com.itextpdf.kernel.PdfException.GivenAccessibleElementIsNotConnectedToAnyTag
com.itextpdf.kernel.PdfException.NoMaxLenPresent Now we log a warning rather than throw an exception.
com.itextpdf.kernel.pdf.annot.PdfPolyGeomAnnotation.Polygon , use `PdfName.Polygon` instead.
com.itextpdf.kernel.pdf.annot.PdfPolyGeomAnnotation.PolyLine , use `PdfName.PolyLine` instead.
com.itextpdf.kernel.PdfException.UnsupportedDefaultColorSpaceName1
com.itextpdf.kernel.PdfException.WrongMediaBoxSize1 in favour of more informative named constant

Deprecated Methods
Method and Description
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, float, float, boolean) will be removed in 7.2, use `PdfCanvas.addImageAt(ImageData, float, float, boolean)` or `PdfCanvas.addXObjectAt(PdfXObject, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, float, float, float, boolean) will be removed in 7.2, use `PdfCanvas.addImageFittedIntoRectangle(ImageData, Rectangle, boolean)` or `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, float, float, float, boolean, boolean) will be removed in 7.2, use `PdfCanvas.addImageFittedIntoRectangle(ImageData, Rectangle, boolean)` or `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, float, float, float, float, float, float) will be removed in 7.2, use `PdfCanvas.addImageWithTransformationMatrix(ImageData, float, float, float, float, float, float)` or `PdfCanvas.addXObjectWithTransformationMatrix(PdfXObject, float, float, float, float, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, float, float, float, float, float, float, boolean) will be removed in 7.2, use `PdfCanvas.addImageWithTransformationMatrix(ImageData, float, float, float, float, float, float, boolean)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addImage(ImageData, Rectangle, boolean) will be removed in 7.2, use `PdfCanvas.addImageFittedIntoRectangle(ImageData, Rectangle, boolean)` or `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)`instead
com.itextpdf.kernel.font.PdfTrueTypeFont.addRangeUni(Set<Integer>) use `TrueTypeFont.updateUsedGlyphs(SortedSet, boolean, List)`
com.itextpdf.kernel.font.PdfType0Font.addRangeUni(TrueTypeFont, Map<Integer, int[]>, boolean) will be removed in 7.2
com.itextpdf.kernel.font.PdfType0Font.addRangeUni(TrueTypeFont, Set<Integer>) use `TrueTypeFont.updateUsedGlyphs(SortedSet, boolean, List)` instead.
com.itextpdf.kernel.pdf.canvas.parser.clipper.ClipperBridge.addRectToClipper(IClipper, Point[], IClipper.PolyType) use `ClipperBridge.addPolygonToClipper(com.itextpdf.kernel.pdf.canvas.parser.clipper.IClipper, com.itextpdf.kernel.geom.Point[], com.itextpdf.kernel.pdf.canvas.parser.clipper.IClipper.PolyType)` instead.
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addXObject(PdfXObject, float, float) will be removed in 7.2, use `PdfCanvas.addXObjectAt(PdfXObject, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addXObject(PdfXObject, float, float, float) will be removed in 7.2, use `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)` (PdfXObject, Rectangle)} and `PdfXObject.calculateProportionallyFitRectangleWithWidth(PdfXObject, float, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addXObject(PdfXObject, float, float, float, boolean) will be removed in 7.2, use `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)` (PdfXObject, Rectangle)} and `PdfXObject.calculateProportionallyFitRectangleWithHeight(PdfXObject, float, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addXObject(PdfXObject, float, float, float, float, float, float) will be removed in 7.2, use `PdfCanvas.addXObjectWithTransformationMatrix(PdfXObject, float, float, float, float, float, float)` instead
com.itextpdf.kernel.pdf.canvas.PdfCanvas.addXObject(PdfXObject, Rectangle) will be removed in 7.2, use `PdfCanvas.addXObjectFittedIntoRectangle(PdfXObject, Rectangle)` instead
com.itextpdf.kernel.pdf.PdfDocument.checkIsoConformance(Object, IsoKey, PdfResources) This method will be replaced by `checkIsoConformance` in 7.2 release
com.itextpdf.kernel.font.PdfFont.compactRanges(List<int[]>) The logic has been moved to `TrueTypeFont`.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.create(int, PdfName, float, float, float, float, float) Use `PdfExplicitDestination.create(PdfPage, PdfName, float, float, float, float, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.create(int, PdfName, float, float, float, float, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFit(int) Use `PdfExplicitDestination.createFit(PdfPage)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFit(int)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitB(int) Use `PdfExplicitDestination.createFitB(PdfPage)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitB(int)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitBH(int, float) Use `PdfExplicitDestination.createFitBH(PdfPage, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitBH(int, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitBV(int, float) Use `PdfExplicitDestination.createFitBV(PdfPage, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitBV(int, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitH(int, float) Use `PdfExplicitDestination.createFitH(PdfPage, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitH(int, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitR(int, float, float, float, float) Use `PdfExplicitDestination.createFitR(PdfPage, float, float, float, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitR(int, float, float, float, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createFitV(int, float) Use `PdfExplicitDestination.createFitV(PdfPage, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createFitV(int, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.font.PdfFontFactory.createFont(byte[], boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(byte[], EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(byte[], String, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(byte[], String, EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(byte[], String, boolean, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(byte[], String, EmbeddingStrategy, boolean)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(FontProgram, String, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(FontProgram, String, EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(String, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(String, EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(String, String, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(String, String, EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createFont(String, String, boolean, boolean) Will be removed in next major release. Use `PdfFontFactory.createFont(String, String, EmbeddingStrategy, boolean)` instead
com.itextpdf.kernel.font.PdfFontFactory.createRegisteredFont(String, String, boolean) Will be removed in next major release. Use `PdfFontFactory.createRegisteredFont(String, String, EmbeddingStrategy)` instead
com.itextpdf.kernel.font.PdfFontFactory.createRegisteredFont(String, String, boolean, boolean) Will be removed in next major release. Use `PdfFontFactory.createRegisteredFont(String, String, EmbeddingStrategy, boolean)` instead
com.itextpdf.kernel.font.PdfFontFactory.createRegisteredFont(String, String, boolean, int) Will be removed in next major release. Use `PdfFontFactory.createRegisteredFont(String, String, EmbeddingStrategy, int)` instead
com.itextpdf.kernel.font.PdfFontFactory.createRegisteredFont(String, String, boolean, int, boolean) Will be removed in next major release. Use `PdfFontFactory.createRegisteredFont(String, String, EmbeddingStrategy, int, boolean)` instead
com.itextpdf.kernel.font.PdfFontFactory.createTtcFont(byte[], int, String, boolean, boolean) Will be removed in next major release. Use `PdfFontFactory.createTtcFont(byte[], int, String, EmbeddingStrategy, boolean)` instead
com.itextpdf.kernel.font.PdfFontFactory.createTtcFont(String, int, String, boolean, boolean) Will be removed in next major release. Use `PdfFontFactory.createTtcFont(String, int, String, EmbeddingStrategy, boolean)` instead
com.itextpdf.kernel.pdf.navigation.PdfExplicitDestination.createXYZ(int, float, float, float) Use `PdfExplicitDestination.createXYZ(PdfPage, float, float, float)` to create a destination inside current PDF document, or `PdfExplicitRemoteGoToDestination.createXYZ(int, float, float, float)` to create a destination in another PDF document instead.
com.itextpdf.kernel.font.PdfType0Font.getCidFontType2(TrueTypeFont, PdfDictionary, String, int[]) use `PdfType0Font.getCidFont(PdfDictionary, String, boolean)` instead.
com.itextpdf.kernel.font.PdfType0Font.getCidFontType2(TrueTypeFont, PdfDictionary, String, int[][]) will be removed in 7.2
com.itextpdf.kernel.pdf.PdfDocument.getCounters()
com.itextpdf.kernel.font.PdfFont.getFontMatrix() Use `FontProgram.UNITS_NORMALIZATION` constant for conversion between text and glyph space. For now we opted to always expect that all `PdfFont` metrics in glyph-space are related to text space as 1 to 1000, as it is defined for the majority of fonts. For fonts which don't necessary follow this rule (see `PdfType3Font`), we perform internal normalization of font metrics in order to adhere to this common expectation. This method will be removed in next major release.
com.itextpdf.kernel.font.PdfSimpleFont.getGlyphWidth(Glyph) This method was introduced to allow overriding of widths array entry writing to output file. It's now replaced by more specific `PdfSimpleFont.buildWidthsArray(int, int)` in order to avoid confusion between this method and `Glyph.getWidth()`. This method will be removed in the next major release.
com.itextpdf.kernel.pdf.filters.DoNothingFilter.getLastFilterName() Will be removed in 7.2. Used as a crutch in `PdfImageXObject.getImageBytes()` implementation. Now this method does not needed. If the user has been used it, then the same approach can be reached with nested class.
com.itextpdf.kernel.font.PdfType0Font.getToUnicode(Object[]) will be removed in 7.2. Use `PdfType0Font.getToUnicode()` instead
com.itextpdf.kernel.pdf.collection.PdfCollection.getView() Will always return null. The return will be changed to PdfName in 7.2. Use `getPdfObject().getAsName(PdfName.View)`, or one of `PdfCollection.isViewDetails()`, `PdfCollection.isViewTile()`, `PdfCollection.isViewHidden()`.
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter.isStrictDecoding() will be removed in 7.2, use `FlateDecodeStrictFilter` instead.
com.itextpdf.kernel.pdf.canvas.PdfCanvas.newPath() in favour of endPath(), which does exactly the same thing but is better named
com.itextpdf.kernel.pdf.annot.PdfMarkupAnnotation.setExternalData(PdfName) use `PdfMarkupAnnotation.setExternalData(PdfDictionary)` instead
com.itextpdf.kernel.font.PdfType3Font.setFontMatrix(double[]) will be made internal in next major release
com.itextpdf.kernel.pdf.PdfResources.setModified(boolean) Please use `PdfResources.setModified()`.
com.itextpdf.kernel.colors.PatternColor.setPattern(PdfPattern) To be removed in iText 7.2. In order to change pattern one shall create a new `PatternColor`.
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter.setStrictDecoding(boolean) will be removed in 7.2, use `FlateDecodeStrictFilter` instead.

Deprecated Constructors
Constructor and Description
com.itextpdf.kernel.pdf.filters.FlateDecodeFilter(boolean) will be removed in 7.2, use `FlateDecodeStrictFilter` instead.
com.itextpdf.kernel.Version() Use `Version.getInstance()` instead. Will be removed in next major release.

Deprecated API

Contents