RML User Guide Report Markup Language Document generated on 2020/12/02 11:32:03 ReportLab, Wimbletech (Zone 2) Wimbledon Reference Library Wimbledon Hill Rd Wimbledon London SW19 7NB, United Kingdom Evaluation copy ofReportLab PLUS. Contact ReportLab (www.reportlab.com) to purchase. RML User Guide Document generated on 2020/12/02 11:32:03 1. Introduction ...................................................................................................................... 4 1.1. ReportLab PLUS ...................................................................................................... 4 1.2. Installation and Use .................................................................................................. 4 1.3. What is RML? .......................................................................................................... 7 1.4. What is this document?............................................................................................. 7 1.5. Who is this document aimed at?............................................................................... 7 1.6. Conventions used in this document.......................................................................... 7 Part I - The Basics 9 2. Pages and page structures ............................................................................................... 9 2.1. XML syntax and RML ............................................................................................. 9 2.2. The prolog................................................................................................................. 9 2.3. Document forms: stylesheet/pageDrawing vs template/stylesheet/story ................. 11 3. Basic Text Operations...................................................................................................... 14 3.1. Coordinates and measurements ................................................................................ 14 3.2. Using Colors............................................................................................................. 14 3.3. Using fonts................................................................................................................ 15 3.4. Basic text operations - setFont and drawString........................................................ 15 4. Basic figures - lines and shapes ....................................................................................... 17 4.1. Rect, circle and ellipse.............................................................................................. 17 4.2. Fill and stroke ........................................................................................................... 19 4.3. Lines and lineMode .................................................................................................. 19 5. Graphics vs Flowables ..................................................................................................... 25 6. More about pages and page structures .......................................................................... 26 6.1. More about template and pageTemplate .................................................................. 26 6.2. Frame and nextFrame ............................................................................................... 27 6.3. condPageBreak: conditional page breaks................................................................. 27 6.4. storyPlace: out of band flowables............................................................................. 27 6.5. pto: Please Turn Over Control.................................................................................. 28 6.6. keepInFrame fixed space control.............................................................................. 28 6.7. imageAndFlowables tag ........................................................................................... 29 6.8. More about stylesheets ............................................................................................. 29 7. Advanced text ................................................................................................................... 32 7.1. Title........................................................................................................................... 32 7.2. Headings -- h1, h2, h3 .............................................................................................. 32 7.3. Paragraphs and paragraph styles............................................................................... 32 7.4. The font tag............................................................................................................... 33 Page 2 Evaluation copy ofReportLab PLUS. Contact ReportLab (www.reportlab.com) to purchase. RML User Guide Document generated on 2020/12/02 11:32:03 7.5. Superscripts and subscripts....................................................................................... 33 7.6. Lists .......................................................................................................................... 34 7.7. Using multiple frames .............................................................................................. 35 7.8. Preformated text -- pre and xpre............................................................................... 36 7.9. Greek letters.............................................................................................................. 36 7.10. Asian Fonts............................................................................................................. 39 7.11. Paragraph Hyphenation .......................................................................................... 40 Part II - Advanced Features 41 8. Miscellaneous useful features.......................................................................................... 41 8.1. pageNumber.............................................................................................................. 41 8.2. name, namedString and getName............................................................................. 41 8.3. Seq, seqReset, seqChain and SeqFormat.................................................................. 41 8.4. Entities...................................................................................................................... 45 8.5. Aliases ...................................................................................................................... 46 8.6. CDATA -- unparsed character data.......................................................................... 46 8.7. Plug-ins: plugInGraphic and plugInFlowable .......................................................... 47 8.8. Integrating with PageCatcher: catchForms, doForm and includePdfPages ............. 47 8.9. Outlines..................................................................................................................... 50 8.10. Form field tags........................................................................................................ 50 8.11. Interactive Form Field tags..................................................................................... 58 8.12. Colorspace Checking.............................................................................................. 62 8.13. Balanced Column ................................................................................................... 63 9. About Cross References and Page Numbers ................................................................. 64 9.1. the namedString tag and forward references ............................................................ 64 9.2. Multiple pass pdf formatting .................................................................................... 64 9.3. Calculated Page Numbers: evalString ...................................................................... 65 9.4. Generated RML ........................................................................................................ 65 10. More graphics................................................................................................................. 67 10.1. curves...................................................................................................................... 67 10.2. paths........................................................................................................................ 68 10.3. grids ........................................................................................................................ 71 10.4. Translations ............................................................................................................ 71 10.5. scaling..................................................................................................................... 72 10.6. rotations .................................................................................................................. 73 10.7. Skew ....................................................................................................................... 74 10.8. Generic affine transforms ....................................................................................... 75 10.9. About scale, rotate, and skew ................................................................................. 75 Page 3 Evaluation copy ofReportLab PLUS. Contact ReportLab (www.reportlab.com) to purchase. RML User Guide Document generated on 2020/12/02 11:32:03 10.10. Bitmapped images ...............................................................................................