# 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)