Including Graphics in XSL-FO document

XSL-FO Tutorials - Herong's Tutorial Examples - Version 2.10, by Dr. Herong Yang

XSL-FO Tutorials - Herong's Tutorial Examples

∟Including Graphics in XSL-FO document

This chapter provides tutorial notes and example codes on including graphics and images in XSL-FO documents; Topics include introduction of 'external-graphic' and 'instream-foreign-object' formatting objects; 'width', 'height', 'content-width' and 'content-height' attributes; specifying output inline area size; higher DPI resolution; images over or under flow areas; SVG diagrams.

What Is "external-graphic" Formatting Object?

Control DPI with "content-width" and "content-height"

Fixed Higher DPI with "scale-to-fit"

Resolution Included in Image Files

Image Over and Under Flow Area

"external-graphic" with SVG Diagram

"instream-foreign-object" Formatting Object

Conclusion:

"external-graphic" is an inline-level formatting object that takes an image from an external source to generate an inline area.
"content-width" and "content-height" attributes allow you to override and scale down the pixel size of the specified image to get higher PDI.
"width" and "height" attributes allow you to set the size of output inline area to get a fixed DPI.
content-width="scale-to-fit" and content-height="scale-to-fit" with width="..in" and height="..in" is the best combination to ensure a fixed DPI image rendering.
External SVG diagrams can be specified in "external-graphic".
"instream-foreign-object" is an inline-level formatting object takes an embedded object to generate an inline area. SVG XML structure is a good example of graphical embedded object.