[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs:rust":3},{"versions":4,"version":13,"nav":16,"path":59,"page":80},[5,10],{"name":6,"label":7,"prefix":8,"channel":9},"0.1","0.1.0 (latest)","","latest",{"name":11,"label":12,"prefix":11,"channel":11},"next","next (main)",{"name":6,"label":7,"prefix":8,"channel":9,"base":14,"ref":15},"\u002Fdocs","v0.1.0",[17,21,24,27,30,33,36,39,43,46,49,52,55,58,61,65,68,71,74,77],{"slug":18,"title":19,"group":20},"index","Overview","Guide",{"slug":22,"title":23,"group":20},"getting-started","Getting started",{"slug":25,"title":26,"group":20},"php","PHP API",{"slug":28,"title":29,"group":20},"laravel","Laravel",{"slug":31,"title":32,"group":20},"resources","Resources",{"slug":34,"title":35,"group":20},"deployment","Deployment",{"slug":37,"title":38,"group":20},"troubleshooting","Troubleshooting",{"slug":40,"title":41,"group":42},"css","CSS reference","Reference",{"slug":44,"title":45,"group":42},"paged-media","Paged media",{"slug":47,"title":48,"group":42},"fonts","Fonts",{"slug":50,"title":51,"group":42},"extensions","Extensions",{"slug":53,"title":54,"group":42},"pdf","The PDF",{"slug":56,"title":57,"group":42},"cli","Command line",{"slug":59,"title":60,"group":42},"rust","Rust library",{"slug":62,"title":63,"group":64},"protocol","Worker protocol","Internals",{"slug":66,"title":67,"group":64},"releasing","Releasing",{"slug":69,"title":70,"group":64},"adr\u002F0001-record-architecture-decisions","1. Record architecture decisions",{"slug":72,"title":73,"group":64},"adr\u002F0002-rust-and-fragmentation-in-layout","2. Rust core with fragmentation inside layout",{"slug":75,"title":76,"group":64},"adr\u002F0003-css-parsing-and-own-selector-matching","3. lightningcss for parsing, own selector matching and cascade",{"slug":78,"title":79,"group":64},"adr\u002F0004-extensions-only-where-css-has-no-way","4. Extensions only where CSS has no way",{"title":60,"seoTitle":81,"seoDescription":82,"html":83,"headings":84,"editUrl":114,"sourceUrl":115,"markdownUrl":116,"prev":117,"next":118},"Rust library: the Fagus engine as a crate","Render PDFs inside a Rust program with the crate fagus, the engine the PHP package and the command line tool are built on, without a separate process.","\u003Ch1 id=\"rust-library\">Rust library\u003C\u002Fh1>\n\u003Cp>The crate \u003Ccode>fagus\u003C\u002Fcode> is the engine the PHP package and the command line tool are built on. Use it to\nrender PDFs inside a Rust program, without a separate process.\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">let\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> mut\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">new\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">add_font_dir\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"fonts\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> output \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">html\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(html)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">base_directory\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">))\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FFA657\">std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">write\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"invoice.pdf\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pdf)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Ch2 id=\"add-the-crate\">Add the crate\u003Ca class=\"f-doc-anchor\" href=\"#add-the-crate\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>The crate is not published on crates.io. Depend on it from the Git repository, pinned to a\nrelease tag (releases are tagged \u003Ccode>v\u003C\u002Fcode> and their version) or to a commit with \u003Ccode>rev\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>toml\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">[\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">dependencies\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">]\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">fagus = { git = \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, tag = \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"v0.1.0\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> }\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>A checkout of the repository works as a path dependency:\n\u003Ccode>fagus = { path = &quot;..\u002Ffagus\u002Fcrates\u002Ffagus&quot; }\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>The crate needs Rust 1.97 or newer (edition 2024). Its code has no \u003Ccode>unsafe\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch3 id=\"features\">Features\u003Ca class=\"f-doc-anchor\" href=\"#features\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh3>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Feature\u003C\u002Fth>\n\u003Cth>Default\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>parallel\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Default\">on\u003C\u002Ftd>\n\u003Ctd data-label=\"Effect\">Compresses the page contents on rayon's global thread pool while later pages are drawn\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Without it (\u003Ccode>default-features = false\u003C\u002Fcode>), each document is written on one thread. With it,\n\u003Ccode>RAYON_NUM_THREADS\u003C\u002Fcode> or your own \u003Ccode>rayon::ThreadPoolBuilder::build_global()\u003C\u002Fcode> sets the size of the\npool; the \u003Ccode>fagus\u003C\u002Fcode> binary uses two threads.\u003C\u002Fp>\n\u003Ch2 id=\"the-engine\">The engine\u003Ca class=\"f-doc-anchor\" href=\"#the-engine\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>An \u003Ccode>Engine\u003C\u002Fcode> holds the fonts, the parsed default style sheet and caches: faces loaded through\n\u003Ccode>@font-face\u003C\u002Fcode> (up to 256 MiB), decoded images and parsed style sheets are kept for the next\ndocuments. Create one and render many documents with it.\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Method\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Engine::new()\u003C\u002Fcode>, \u003Ccode>Engine::default()\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">An engine with the built-in fonts (Inter regular and bold), which stand in where no other font fits\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>add_font_dir(&amp;mut self, dir) -&gt; Result&lt;usize, Error&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Adds the fonts (TTF, OTF, TTC, OTC, WOFF, WOFF2) in a directory and its subdirectories; returns the number of faces\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>add_font_data(&amp;mut self, Vec&lt;u8&gt;) -&gt; Result&lt;usize, Error&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Adds a font file's data (TTF, OTF, TTC, OTC, WOFF, WOFF2); returns the number of faces\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>add_system_fonts(&amp;mut self) -&gt; usize\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Adds the fonts installed on the machine, found as Chrome finds them; the output then depends on the machine\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>set_locale(&amp;mut self, Option&lt;String&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The language of the texts form controls show where the document gives no \u003Ccode>lang\u003C\u002Fcode> (\u003Ccode>&quot;de-DE&quot;\u003C\u002Fcode>); also the shaping language of text without \u003Ccode>lang\u003C\u002Fcode> and the PDF's language when \u003Ccode>&lt;html&gt;\u003C\u002Fcode> has none\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>set_generic_families(&amp;mut self, sans_serif, serif, monospace)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The families (\u003Ccode>Option&lt;String&gt;\u003C\u002Fcode> each) used for \u003Ccode>sans-serif\u003C\u002Fcode>, \u003Ccode>serif\u003C\u002Fcode> and \u003Ccode>monospace\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>render(&amp;self, &amp;Document) -&gt; Result&lt;Output, Error&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Renders a document to PDF\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>render_with_diagnostics(&amp;self, &amp;Document) -&gt; Result&lt;Output, Failure&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The same; a \u003Ccode>Failure\u003C\u002Fcode> has the \u003Ccode>error\u003C\u002Fcode> and the \u003Ccode>diagnostics\u003C\u002Fcode> found before it\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>Fonts, locale and generic families are described in \u003Ca href=\"\u002Fdocs\u002Ffonts\">fonts.md\u003C\u002Fa> and\n\u003Ca href=\"\u002Fdocs\u002Fphp\">php.md\u003C\u002Fa>; the Rust methods behave as the PHP options of the same name.\u003C\u002Fp>\n\u003Ch2 id=\"documents\">Documents\u003Ca class=\"f-doc-anchor\" href=\"#documents\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>A \u003Ccode>Document\u003C\u002Fcode> is built with methods that take and return it. It is \u003Ccode>Clone\u003C\u002Fcode>, so one prepared\ndocument can be rendered with variations.\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Method\u003C\u002Fth>\n\u003Cth>Description\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Document::html(impl Into&lt;String&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">An HTML document\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Document::xhtml(impl Into&lt;String&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">An XHTML document, parsed as XML\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>base_directory(impl Into&lt;PathBuf&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The directory relative URLs resolve against; files are only read inside it (or \u003Ccode>root\u003C\u002Fcode>). Without it, no files are read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>root(impl Into&lt;PathBuf&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">A larger directory files may be read from, which contains the base directory; URLs starting with \u003Ccode>\u002F\u003C\u002Fcode> resolve against it. It takes effect only with a base directory\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>stylesheet(name, css)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">A style sheet after the document's own; \u003Ccode>name\u003C\u002Fcode> appears in diagnostics\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>resource(url, Vec&lt;u8&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The data of a resource, by its URL as written in the document\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>loader(Arc&lt;dyn ResourceLoader&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">A loader for resources that are not handed over; asked before a file is read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>conformance(Conformance)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">PDF\u002FA\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>tagged(bool)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Whether the PDF is tagged (default \u003Ccode>true\u003C\u002Fcode>)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>accessible()\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">PDF\u002FUA-1\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>attach(Attachment)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">Attaches a file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>factur_x(Vec&lt;u8&gt;)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">A ZUGFeRD \u002F Factur-X invoice with this XML, its profile read from the XML\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>factur_x_profile(Vec&lt;u8&gt;, FacturXProfile)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The same with the profile given\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>created(Date)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Description\">The creation date (default: now), for reproducible output\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>What these options do to the PDF is described in \u003Ca href=\"\u002Fdocs\u002Fpdf\">pdf.md\u003C\u002Fa>, how resources are found in\n\u003Ca href=\"\u002Fdocs\u002Fresources\">resources.md\u003C\u002Fa>.\u003C\u002Fp>\n\u003Cp>The types they take:\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode>Conformance\u003C\u002Fcode>: \u003Ccode>PdfA2b\u003C\u002Fcode>, \u003Ccode>PdfA2u\u003C\u002Fcode>, \u003Ccode>PdfA2a\u003C\u002Fcode>, \u003Ccode>PdfA3b\u003C\u002Fcode>, \u003Ccode>PdfA3u\u003C\u002Fcode>, \u003Ccode>PdfA3a\u003C\u002Fcode>.\n\u003Ccode>Conformance::from_level(&quot;3b&quot;)\u003C\u002Fcode> parses a name, \u003Ccode>name()\u003C\u002Fcode> gives \u003Ccode>&quot;PDF\u002FA-3b&quot;\u003C\u002Fcode>, \u003Ccode>is_tagged()\u003C\u002Fcode> says\nwhether the level requires tags.\u003C\u002Fli>\n\u003Cli>\u003Ccode>Attachment { name, mime_type, description: Option&lt;String&gt;, relationship, data: Arc&lt;Vec&lt;u8&gt;&gt; }\u003C\u002Fcode>\nwith \u003Ccode>Relationship::{Source, Data, Alternative, Supplement, Unspecified}\u003C\u002Fcode>. PDF\u002FA-3 and PDF\u002FUA\nrequire a \u003Ccode>description\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Ccode>FacturXProfile\u003C\u002Fcode>: \u003Ccode>Minimum\u003C\u002Fcode>, \u003Ccode>BasicWl\u003C\u002Fcode>, \u003Ccode>Basic\u003C\u002Fcode>, \u003Ccode>En16931\u003C\u002Fcode>, \u003Ccode>Extended\u003C\u002Fcode>, \u003Ccode>XRechnung\u003C\u002Fcode>.\n\u003Ccode>FacturXProfile::detect(&amp;xml)\u003C\u002Fcode> reads the profile an XML declares.\u003C\u002Fli>\n\u003Cli>\u003Ccode>Date { year, month, day, hour, minute, second }\u003C\u002Fcode> in UTC. \u003Ccode>Date::now()\u003C\u002Fcode> and\n\u003Ccode>Date::from_unix(seconds)\u003C\u002Fcode> make one; convert a local time to UTC before.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>A document's metadata comes from its HTML (\u003Ccode>&lt;title&gt;\u003C\u002Fcode>, \u003Ccode>&lt;html lang&gt;\u003C\u002Fcode>, \u003Ccode>&lt;meta&gt;\u003C\u002Fcode>), see\n\u003Ca href=\"\u002Fdocs\u002Fpdf\">pdf.md\u003C\u002Fa>; there is no method to set it.\u003C\u002Fp>\n\u003Ch2 id=\"load-resources\">Load resources\u003Ca class=\"f-doc-anchor\" href=\"#load-resources\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>A resource is looked for as a \u003Ccode>data:\u003C\u002Fcode> URL, among the resources handed over with \u003Ccode>resource()\u003C\u002Fcode>,\nthrough the loader, and last as a file inside the base directory or root. Fagus itself never goes\nto the network. Implement \u003Ccode>ResourceLoader\u003C\u002Fcode> to serve resources from a database, a cache or the\nnetwork, under your own rules:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">use\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">sync\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Arc\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">use\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Document\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">ResourceLoader\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#8B949E\">\u002F\u002F\u002F Answers with the files of the application's storage.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">struct\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Storage\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">impl\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> ResourceLoader\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> for\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Storage\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    fn\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\"> load\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">self\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, url\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> &#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">str\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">->\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Option\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Vec\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">u8\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">>> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> key \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> url\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">strip_prefix\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"storage:\u002F\u002F\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FFA657\">        std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">read\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">path\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Path\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">new\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">join\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(key))\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">ok\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> document \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">html\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">r#\"&#x3C;img src=\"storage:\u002F\u002Flogo.svg\" alt=\"Logo\">\"#\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">loader\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Arc\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">new\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Storage\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">));\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>\u003Ccode>load\u003C\u002Fcode> gets the URL exactly as written in the document and returns the data or \u003Ccode>None\u003C\u002Fcode>. The\nloader must be \u003Ccode>Send + Sync\u003C\u002Fcode>: it is called from the engine's rendering thread. The documents of\nframes ask for their resources by their URLs resolved against the frame's URL.\u003C\u002Fp>\n\u003Ch2 id=\"the-output\">The output\u003Ca class=\"f-doc-anchor\" href=\"#the-output\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>\u003Ccode>render\u003C\u002Fcode> returns an \u003Ccode>Output\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Type\u003C\u002Fth>\n\u003Cth>Content\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>pdf\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Type\">\u003Ccode>Vec&lt;u8&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Content\">The PDF file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>pages\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Type\">\u003Ccode>usize\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Content\">The number of pages\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>diagnostics\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Type\">\u003Ccode>Vec&lt;Diagnostic&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Content\">CSS that was ignored, resources that are missing, warnings about the PDF\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>timings\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Type\">\u003Ccode>Timings\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"Content\">\u003Ccode>parse\u003C\u002Fcode>, \u003Ccode>style\u003C\u002Fcode>, \u003Ccode>layout\u003C\u002Fcode>, \u003Ccode>paint\u003C\u002Fcode> and \u003Ccode>pdf\u003C\u002Fcode>, each a \u003Ccode>Duration\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>A \u003Ccode>Diagnostic\u003C\u002Fcode> has a \u003Ccode>severity\u003C\u002Fcode> (\u003Ccode>Severity::Info\u003C\u002Fcode>, \u003Ccode>Warning\u003C\u002Fcode> or \u003Ccode>Error\u003C\u002Fcode>, ordered so that\n\u003Ccode>severity &gt;= Severity::Warning\u003C\u002Fcode> works), a stable \u003Ccode>code\u003C\u002Fcode> such as \u003Ccode>css.unknown-property\u003C\u002Fcode>, a\n\u003Ccode>message\u003C\u002Fcode>, a \u003Ccode>source\u003C\u002Fcode> (a file name, \u003Ccode>&lt;style&gt; 1\u003C\u002Fcode>, \u003Ccode>resources\u003C\u002Fcode>, \u003Ccode>pdf\u003C\u002Fcode>) and a 1-based \u003Ccode>line\u003C\u002Fcode> and\n\u003Ccode>column\u003C\u002Fcode>, 0 where unknown. Its \u003Ccode>Display\u003C\u002Fcode> writes it on one line:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>text\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan>&#x3C;style> 1:12:3: warning[css.unknown-property]: unknown property `colr`; the declaration is ignored\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>Diagnostics never make \u003Ccode>render\u003C\u002Fcode> fail. To treat them as errors, check \u003Ccode>output.diagnostics\u003C\u002Fcode>\nyourself.\u003C\u002Fp>\n\u003Ch2 id=\"errors\">Errors\u003Ca class=\"f-doc-anchor\" href=\"#errors\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>\u003Ccode>render\u003C\u002Fcode> fails with \u003Ccode>fagus::Error\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Ctable class=\"f-doc-table f-stack-table\">\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Variant\u003C\u002Fth>\n\u003Cth>When\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Error::Pdf\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"When\">The document does not meet PDF\u002FA or PDF\u002FUA (the message lists every problem), or the PDF could not be written\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Error::Font\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"When\">A font could not be read (also from \u003Ccode>add_font_dir\u003C\u002Fcode> and \u003Ccode>add_font_data\u003C\u002Fcode>)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Error::Internal(String)\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd data-label=\"When\">A bug in Fagus: rendering stopped with a panic, which the engine caught\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>The types inside are exported too: \u003Ccode>Error::Pdf\u003C\u002Fcode> holds a \u003Ccode>fagus::PdfError\u003C\u002Fcode>, either\n\u003Ccode>PdfError::Conformance { standard, problems }\u003C\u002Fcode> (the standard, like \u003Ccode>PDF\u002FUA-1\u003C\u002Fcode>, and the problems in\nwords, separated by semicolons) or \u003Ccode>PdfError::Write(String)\u003C\u002Fcode>; \u003Ccode>Error::Font\u003C\u002Fcode> holds a\n\u003Ccode>fagus::FontError\u003C\u002Fcode>, \u003Ccode>FontError::InvalidFont\u003C\u002Fcode> or \u003Ccode>FontError::Io(std::io::Error)\u003C\u002Fcode>. Their \u003Ccode>Display\u003C\u002Fcode>\ngives the whole message:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">match\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">accessible\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Ok\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(output) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">write\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"letter.pdf\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pdf)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Err\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Error\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">Pdf\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(error)) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\"> eprintln!\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"refused: {error}\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Err\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(error) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> return\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Err\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(error\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">into\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#8B949E\">\u002F\u002F refused: the document does not meet PDF\u002FUA-1: the document has no title (add a &#x3C;title>); …\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>\u003Ccode>render_with_diagnostics\u003C\u002Fcode> fails with a \u003Ccode>fagus::Failure\u003C\u002Fcode> instead, which keeps the diagnostics\nfound before the failure (an image that could not be loaded may explain why PDF\u002FUA refuses the\ndocument). Its \u003Ccode>error\u003C\u002Fcode> is the \u003Ccode>Error\u003C\u002Fcode> that \u003Ccode>render\u003C\u002Fcode> returns, and it displays as that error:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">match\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render_with_diagnostics\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">accessible\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Ok\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(output) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">write\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"letter.pdf\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pdf)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Err\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(failure) \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=>\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        for\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> diagnostic \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">in\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> &#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">failure\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">diagnostics {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#D2A8FF\">            eprintln!\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"{diagnostic}\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#E6EDF3\">        }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        return\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Err\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(failure\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">error\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">into\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">());\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Ch2 id=\"threads\">Threads\u003Ca class=\"f-doc-anchor\" href=\"#threads\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>\u003Ccode>Engine\u003C\u002Fcode>, \u003Ccode>Document\u003C\u002Fcode>, \u003Ccode>Output\u003C\u002Fcode>, \u003Ccode>Error\u003C\u002Fcode> and \u003Ccode>Failure\u003C\u002Fcode> are \u003Ccode>Send\u003C\u002Fcode> and \u003Ccode>Sync\u003C\u002Fcode>. \u003Ccode>render\u003C\u002Fcode> takes \u003Ccode>&amp;self\u003C\u002Fcode>, so one\nengine, shared by reference or in an \u003Ccode>Arc\u003C\u002Fcode>, renders documents from many threads at once:\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> pdfs \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">thread\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">scope\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">scope\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> handles\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Vec\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;_> \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> invoices\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">iter\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">map\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">html\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> scope\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">spawn\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">||\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">html\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(html\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">as_str\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()))))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">collect\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    handles\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">into_iter\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">map\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">handle\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> handle\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">join\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">expect\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"rendering thread\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">map\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">|\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pdf))\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">collect\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Result\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Vec\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;_>, _>>()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">})\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The engine renders each document on a thread of its own with a large stack (64 MiB, reserved,\nused as needed), since deeply nested documents need more than the threads of most programs have.\nIt keeps these threads for the next documents and adds one while all are busy, up to one per\nprocessor. \u003Ccode>render\u003C\u002Fcode> blocks until the document is done.\u003C\u002Fp>\n\u003Cp>The methods that change the engine take \u003Ccode>&amp;mut self\u003C\u002Fcode>: add fonts and settings before you share the\nengine. They apply to every document rendered after them.\u003C\u002Fp>\n\u003Ch2 id=\"a-complete-example\">A complete example\u003Ca class=\"f-doc-anchor\" href=\"#a-complete-example\" aria-label=\"Link to this section\">#\u003C\u002Fa>\u003C\u002Fh2>\n\u003Cp>An invoice with fonts of its own, an attachment and the Factur-X XML, as PDF\u002FA-3b with a fixed\ndate. \u003Ccode>assets\u002F\u003C\u002Fcode> holds \u003Ccode>invoice.html\u003C\u002Fcode>, \u003Ccode>invoice.xml\u003C\u002Fcode> and \u003Ccode>fonts\u002F\u003C\u002Fcode> (the HTML and XML of the example\nin \u003Ca href=\"\u002Fdocs\u002Fpdf#a-complete-example\">pdf.md\u003C\u002Fa> fit):\u003C\u002Fp>\n\u003Cdiv class=\"f-doc-code\">\u003Cdiv class=\"f-doc-code-bar\">\u003Cspan>rust\u003C\u002Fspan>\u003Cbutton type=\"button\" class=\"f-doc-copy\" data-copy aria-label=\"Copy code\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fsvg>\u003Cspan>Copy\u003C\u002Fspan>\u003C\u002Fbutton>\u003C\u002Fdiv>\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">use\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">sync\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Arc\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">use\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> fagus\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Attachment\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Date\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Document\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Engine\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Relationship\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Severity\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#FF7B72\">fn\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\"> main\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">() \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">->\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Result\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;(), \u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Box\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">dyn\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">error\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Error\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">>> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> mut\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">new\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">add_font_dir\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\u002Ffonts\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">set_locale\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Some\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"de-DE\"\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">to_owned\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()));\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> html \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">read_to_string\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\u002Finvoice.html\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> xml \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">read\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\u002Finvoice.xml\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> document \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Document\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">html\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(html)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">base_directory\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"assets\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">stylesheet\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"print.css\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"body { color: #000 }\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">factur_x\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(xml)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">attach\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Attachment\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#E6EDF3\">            name\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"timesheet.csv\"\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">to_owned\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#E6EDF3\">            mime_type\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\"> \"text\u002Fcsv\"\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">to_owned\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#E6EDF3\">            description\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Some\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"Stundenzettel\"\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">to_owned\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#E6EDF3\">            relationship\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Relationship\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Supplement\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#E6EDF3\">            data\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Arc\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">new\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">b\"date,hours\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">\\n\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">2026-09-30,6\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">\\n\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">to_vec\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">()),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#E6EDF3\">        })\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        .\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">created\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Date\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> { year\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 2026\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, month\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 11\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, day\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 1\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, hour\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 8\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, minute\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 0\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, second\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\"> 0\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> });\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    let\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> output \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">render\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">document)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FF7B72\">    for\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> diagnostic \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">in\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\"> &#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">diagnostics {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#FF7B72\">        if\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> diagnostic\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">severity \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">>=\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\"> Severity\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">Warning\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:14ch;text-indent:-14ch\">\u003Cspan style=\"color:#D2A8FF\">            eprintln!\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"{diagnostic}\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:10ch;text-indent:-10ch\">\u003Cspan style=\"color:#E6EDF3\">        }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#E6EDF3\">    }\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    std\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#FFA657\">fs\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">::\u003C\u002Fspan>\u003Cspan style=\"color:#D2A8FF\">write\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"invoice.pdf\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pdf)\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">?\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#D2A8FF\">    println!\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"{} pages, layout took {:?}\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">, output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">pages, output\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">timings\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">.\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">layout);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:6ch;text-indent:-6ch\">\u003Cspan style=\"color:#FFA657\">    Ok\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(())\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\" style=\"padding-left:2ch;text-indent:-2ch\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003C\u002Fdiv>\n\u003Cp>The command line tool in \u003Ccode>crates\u002Ffagus-cli\u003C\u002Fcode> is a larger example of the same API, and\n\u003Ca href=\"\u002Fdocs\u002Fcli\">cli.md\u003C\u002Fa> describes it.\u003C\u002Fp>\n",[85,89,93,96,99,102,105,108,111],{"id":86,"text":87,"level":88},"add-the-crate","Add the crate",2,{"id":90,"text":91,"level":92},"features","Features",3,{"id":94,"text":95,"level":88},"the-engine","The engine",{"id":97,"text":98,"level":88},"documents","Documents",{"id":100,"text":101,"level":88},"load-resources","Load resources",{"id":103,"text":104,"level":88},"the-output","The output",{"id":106,"text":107,"level":88},"errors","Errors",{"id":109,"text":110,"level":88},"threads","Threads",{"id":112,"text":113,"level":88},"a-complete-example","A complete example","https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fedit\u002Fmain\u002Fdocs\u002Frust.md","https:\u002F\u002Fgithub.com\u002Fnforst\u002Ffagus\u002Fblob\u002Fv0.1.0\u002Fdocs\u002Frust.md","\u002Fdocs\u002Frust.md",{"slug":56,"title":57},{"slug":62,"title":63}]