Deprecated List (Apache FOP Core 2.11 API)
Date: 2025-04-24

# Deprecated API

## Contents

- Deprecated Interfaces
- Deprecated Classes
- Deprecated Fields
- Deprecated Methods

- Deprecated Interfaces
  Interface and Description
  org.apache.fop.render.Graphics2DImagePainter use `Graphics2DImagePainter` directly!

- Deprecated Classes
  Class and Description
  org.apache.fop.util.ColorExt Replaced by `ColorWithAlternatives`
  org.apache.fop.util.ColorProfileUtil use org.apache.xmlgraphics.java2d.color.profile.ColorProfileUtil directly
  org.apache.fop.util.DataURIResolver
  org.apache.fop.util.DataURLUtil use org.apache.xmlgraphics.util.uri.DataURLUtil directly
  org.apache.fop.fonts.Glyphs Use the Glyphs class from XML Graphics Commons instead!
  org.apache.fop.util.QName Use the XML Graphics Commons variant instead!
  org.apache.fop.util.UnitConv use org.apache.xmlgraphics.util.UnitConv instead.
  org.apache.fop.util.WriterOutputStream use org.apache.xmlgraphics.util.WriterOutputStream instead
  org.apache.fop.fonts.XMLFontMetricsReader

- Deprecated Fields
  Field and Description
  org.apache.fop.util.UnitConv.IN2CM use org.apache.xmlgraphics.util.UnitConv.IN2CM instead.
  org.apache.fop.util.UnitConv.IN2MM use org.apache.xmlgraphics.util.UnitConv.IN2MM instead.
  org.apache.fop.util.UnitConv.IN2PT use org.apache.xmlgraphics.util.UnitConv.IN2PT instead.

- Deprecated Methods
  Method and Description
  org.apache.fop.layoutmgr.TraitSetter.addBorders(Area, CommonBorderPaddingBackground, PercentBaseContext) Call the other addBorders() method and addPadding separately.
  org.apache.fop.fo.FONode.addCharacters(char[], int, int, PropertyList, Locator) Please override `FONode.characters(char[], int, int, PropertyList, Locator)` instead!
  org.apache.fop.area.AreaTreeHandler.addUnresolvedIDRef(String, Resolvable) use getIDTracker().addUnresolvedIDRef(idref, res) instead
  org.apache.fop.area.AreaTreeHandler.alreadyResolvedID(String) use getIDTracker().alreadyResolvedID(id) instead
  org.apache.fop.area.AreaTreeHandler.associateIDWithPageViewport(String, PageViewport) use getIDTracker().associateIDWithPageViewport(id, pv) instead
  org.apache.fop.apps.FopFactoryBuilder.buildConfig() Exposing the `FopFactoryConfig` is only to maintain backwards compatibility
  org.apache.fop.util.DataURLUtil.createDataURL(InputStream, String)
  org.apache.fop.util.ColorProfileUtil.getICCProfileDescription(ICC_Profile) use org.apache.xmlgraphics.java2d.color.profile.ColorProfileUtil directly
  org.apache.fop.pdf.PDFDocument.getImage(String) Use getXObject instead (so forms are treated in the same way)
  org.apache.fop.svg.PDFGraphics2D.getInternalFontForAWTFont(Font) use FontInfo.getFontInstanceForAWTFont(java.awt.Font awtFont) instead
  org.apache.fop.area.AreaTreeHandler.getPageViewportsContainingID(String) use getIDTracker().getPageViewportsContainingID(id) instead
  org.apache.fop.apps.Fop.getUserAgent() this getter doesn't need to exist. By virtue of the fact that the client has an instance of this object, it means they also have the `FOUserAgent` since this's constructor is only used in `FOUserAgent`
  org.apache.fop.util.UnitConv.in2mm(double) use org.apache.xmlgraphics.util.UnitConv.in2mm(in) instead.
  org.apache.fop.util.UnitConv.in2mpt(double) use org.apache.xmlgraphics.util.UnitConv.in2mpt(in) instead.
  org.apache.fop.util.UnitConv.in2pt(double) use org.apache.xmlgraphics.util.UnitConv.in2pt(in) instead.
  org.apache.fop.util.ColorProfileUtil.isDefaultsRGB(ICC_Profile) use org.apache.xmlgraphics.java2d.color.profile.ColorProfileUtil directly
  org.apache.fop.fonts.FontCache.load() use `FontCache.loadFrom(File)` instead
  org.apache.fop.util.UnitConv.mm2in(double) use org.apache.xmlgraphics.util.UnitConv.pt2mm(pt) instead.
  org.apache.fop.util.UnitConv.mm2mpt(double) use org.apache.xmlgraphics.util.UnitConv.mm2mpt(mm) instead.
  org.apache.fop.util.UnitConv.mm2pt(double) use org.apache.xmlgraphics.util.UnitConv.mm2pt(mm) instead.
  org.apache.fop.util.UnitConv.mm2px(double, int) use org.apache.xmlgraphics.util.UnitConv.mm2px(mm, resolution) instead.
  org.apache.fop.util.UnitConv.mpt2in(double) use org.apache.xmlgraphics.util.UnitConv.mpt2in(mpt) instead.
  org.apache.fop.util.UnitConv.mpt2px(double, int) use org.apache.xmlgraphics.util.UnitConv.mpt2px(mpt, resolution) instead.
  org.apache.fop.util.UnitConv.mptToPt(AffineTransform) use org.apache.xmlgraphics.util.UnitConv.mptToPt(at) instead.
  org.apache.fop.render.Graphics2DAdapter.paintImage(Graphics2DImagePainter, RendererContext, int, int, int, int) Use the variant with the Graphics2DImagePainter from XML Graphics Commons instead
  org.apache.fop.render.AbstractGraphics2DAdapter.paintImage(Graphics2DImagePainter, RendererContext, int, int, int, int)
  org.apache.fop.util.UnitConv.pt2mm(double) use org.apache.xmlgraphics.util.UnitConv.pt2mm(pt) instead.
  org.apache.fop.util.UnitConv.ptToMpt(AffineTransform) use org.apache.xmlgraphics.util.UnitConv.ptToMpt(at) instead.
  org.apache.fop.util.DataURIResolver.resolve(String, String)
  org.apache.fop.fonts.FontCache.save() use `FontCache.saveTo(File)` instead
  org.apache.fop.pdf.PDFDestination.setGoToReference(String) use setGoToReference(Object) instead
  org.apache.fop.afp.ioca.ImageSegment.setIDEColorModel(byte) Use `IDEStructureParameter.setColorModel(byte)` instead.
  org.apache.fop.afp.modca.ImageObject.setIDEColorModel(byte) Use `IDEStructureParameter.setColorModel(byte)` instead.
  org.apache.fop.afp.ioca.ImageContent.setImageIDEColorModel(byte) use `ImageContent.setIDEStructureParameter(IDEStructureParameter)` instead
  org.apache.fop.afp.ioca.ImageContent.setSubtractive(boolean) use `ImageContent.setIDEStructureParameter(IDEStructureParameter)` instead
  org.apache.fop.afp.ioca.ImageSegment.setSubtractive(boolean) Use `IDEStructureParameter.setSubtractive(boolean)` instead.
  org.apache.fop.afp.modca.ImageObject.setSubtractive(boolean) Use `IDEStructureParameter.setSubtractive(boolean)` instead.
  org.apache.fop.area.AreaTreeHandler.signalIDProcessed(String) use getIDTracker().signalIDProcessed(id) instead
  org.apache.fop.area.AreaTreeHandler.signalPendingID(String) use getIDTracker().signalPendingID(id) instead
  org.apache.fop.render.AbstractRenderer.startPageSequence(LineArea)
  org.apache.fop.render.Renderer.startPageSequence(LineArea) Use `Renderer.startPageSequence(PageSequence)` instead
  org.apache.fop.configuration.DefaultConfiguration.toString(Document) For debug only.
  org.apache.fop.area.AreaTreeHandler.tryIDResolution(PageViewport) use getIDTracker().tryIDResolution(pv) instead
  org.apache.fop.util.DataURLUtil.writeDataURL(InputStream, String, Writer)

Copyright © 2025 Apache Software Foundation. All rights reserved.