用于 Prawn Ruby PDF 库的 SVG 渲染器
An SVG renderer for the Prawn PDF library.
This will take an SVG document as input and render it into your PDF, along with whatever else you build with Prawn.
prawn-svg is compatible with all versions of Prawn from 0.11.1 onwards, including the 1.x and 2.x series, although you'll need version 2.2.0 onwards if you want color gradients. The minimum Ruby version required is 2.7.
Prawn::Document.generate("test.pdf") do
svg ''
endprawn-svg will do something sensible if you call it with only an SVG document, but you can also pass the following options to tailor its operation:
| Option | Data type | Description |
|---|---|---|
| :at | [integer, integer] | Specify the location on the page you want the SVG to appear. |
| :position | :left, :center, :right, integer | If :at not specified, specifies the horizontal position to show the SVG. Defaults to :left. |
| :vposition | :top, :center, :bottom, integer | If :at not specified, specifies the vertical position to show the SVG. Defaults to current cursor position. |
| :width | integer | Desired width of the SVG. Defaults to horizontal space available. |
| :height | integer | Desired height of the SVG. Defaults to vertical space available. |
| :enable_web_requests | boolean | If true, prawn-svg will make http and https requests to fetch images, @font-face fonts, and external `` references. |
Defaults to true, but will default to false in the upcoming 1.0 release. It's recommended you explicitly set this option for now.
:enable_file_requests_with_root | string | If not nil, prawn-svg will serve file: URLs and relative paths from your local disk if the file is located under the specified directory. Required for @font-face fonts and external `` references loaded via file paths.
It is very dangerous to specify the root path ("/") if you're not fully in control of your input SVG. Defaults to nil (off).
:cache_images | boolean | If true, prawn-svg will cache the result of all URL requests. Defaults to false.
:fallback_font_name | string | A font name which will override the default fallback font of Times-Roman. If this value is set to nil, prawn-svg will ignore a request for an unknown font and log a warning.
:color_mode | :rgb, :cmyk | Output color mode. Defaults to :rgb.
:language | string | BCP 47 language tag for `` systemLanguage matching. Defaults to "en".
:log_warnings | boolean | If true, warnings that occur when parsing/rendering the SVG are output to stderr via warn. Use this when you're not getting the output you expect. Defaults to false.
# Render the logo contained in the file logo.svg at 100, 100 with a width of 300
svg IO.read("logo.svg"), at: [100, 100], width: 300
# Render the logo at the current Y cursor position, centered in the current bounding box
svg IO.read("logo.svg"), position: :center
# Render the logo at the current Y cursor position, and serve file: links relative to its directory
root_path = "/apps/myapp/current/images"
svg IO.read("#{root_path}/logo.svg"), enable_file_requests_with_root: root_path, log_warnings: trueprawn-svg supports almost all of the full SVG 1.1 specification:
, , , , and
``
, , and with attributes x, y, dx, dy, rotate, textLength,
lengthAdjust, and with extra properties text-anchor, text-decoration, font, font-size, font-family,
font-weight, font-style, font-stretch, kerning, letter-spacing, word-spacing, dominant-baseline, alignment-baseline, baseline-shift.
`` supports href/xlink:href and startOffset.
, and ``
`` with local and external references (e.g. other.svg#elementId), subject to enable_web_requests and enable_file_requests_with_root
`` (see CSS section below)
`` referencing a JPEG, PNG, or SVG image, with http:, https:, data:image/jpeg;base64,
data:image/png;base64, data:image/svg+xml;base64 and file: schemes (file: is disabled by default for
security reasons, see Options section above)
`` with clipPathUnits attribute and text content
`` with attributes maskUnits and maskContentUnits
``
and are implemented on Prawn 2.2.0+ with attributes gradientUnits and
gradientTransform
`` with attributes patternUnits, patternContentUnits, patternTransform, viewBox,
preserveAspectRatio, and href inheritance. Patterns can be used for both fill and stroke.
Nested patterns (a pattern whose content references another pattern) are not supported.
with conditional processing (`requiredFeatures`, `requiredExtensions`, `systemLanguage`). tags are always ignored as prawn-svg cannot handle non-SVG data.
element for defining named views. Fragment identifiers (`#viewId` and `#svgView(...)`) on hrefs select which view to render an external SVG with.
properties: clip-path, clip-rule, color, display, fill, fill-opacity, fill-rule, opacity, overflow,
stroke, stroke-dasharray, stroke-dashoffset, stroke-linecap, stroke-linejoin, stroke-miterlimit, stroke-opacity, stroke-width,
visibility
properties on lines, polylines, polygons and paths: marker, marker-end, marker-mid, marker-start
attributes on all elements: class, id, style, transform, xml:space
the viewBox attribute on and elements
the preserveAspectRatio attribute on , and `` elements
transform methods: translate, translateX, translateY, rotate, scale, skewX, skewY, matrix
colors: HTML standard names, #xxx, #xxxxxx, rgb(1, 2, 3), rgb(1%, 2%, 3%), and also the non-standard
device-cmyk(1, 2, 3, 4) for CMYK colors
measurements specified in pt, cm, dm, ft, in, m, mm, yd, pc, %
fonts: generic CSS fonts, built-in PDF fonts, and any TTF or TTC fonts in your fonts path, specified in any of
the measurements above plus em or rem
@font-face in `` blocks: url() sources (TTF/OTF formats) and local() references, with font-weight,
font-style and font-stretch descriptors. Font loading is subject to the enable_web_requests and
enable_file_requests_with_root options.
prawn-svg fully supports CSS2, both in `` blocks and style attributes.
@import rules are supported for loading external stylesheets (requires enable_web_requests or
enable_file_requests_with_root options enabled).
In CSS selectors you can use element names, IDs, classes, attributes (existence, =, ^=, $=, *=, ~=, |=)
and all combinators ( , >, +, ~). The pseudo-classes :first-child, :last-child, :link, :nth-child()
and :lang() also work. :visited, :hover, :active, and :focus are never matched. !important is
supported.
We made the call to ignore @media because it's not clear whether you're making a PDF to print it or show it on
the screen.
prawn-svg does not support filters, as rasterised effects is not something the PDF format was designed to handle.
writing-mode is partially supported: vertical-rl and vertical-lr rotate the text 90 degrees, which handles the common case of sideways Latin text. CJK upright glyph orientation is not supported.
direction and unicode-bidi are not supported.
Features that will probably never be supported because either they don't make sense for PDF, they were deprecated in SVG 2, and/or they are rarely used: filters, SVG fonts, altGlyph, font-size-adjust, glyph-orientation, rendering hints, ICC color profiles, color-interpolation, enable-background, deprecated CSS clip, @media.
By default, prawn-svg has a fonts path of ["/Library/Fonts", "/System/Library/Fonts", "#{ENV["HOME"]}/Library/Fonts", "/usr/share/fonts/truetype"] to catch MacOS and Debian Linux users. You can add
to the font path:
Prawn::SVG::FontRegistry.font_path << "/my/font/directory"In your Gemfile, put gem 'prawn-svg' before gem 'prawn-rails' so that prawn-rails can see the prawn-svg extension.
MIT licence. Copyright Mog Nesbitt.
暂无开放 Issues,或尚未同步最近议题。