Module: RQRCode::Export::SVG

Defined in:
lib/rqrcode/export/svg.rb

Defined Under Namespace

Classes: BaseOutputSVG, Edge, Path, Rect

Constant Summary collapse

DEFAULT_SVG_ATTRIBUTES = 
[
  %(version="1.1"),
  %(xmlns="http://www.w3.org/2000/svg"),
  %(xmlns:xlink="http://www.w3.org/1999/xlink"),
  %(xmlns:ev="http://www.w3.org/2001/xml-events")
]
SVG_PATH_COMMANDS = 
{
  move: "M",
  up: "v-",
  down: "v",
  left: "h-",
  right: "h",
  close: "z"
}

Instance Method Summary collapse

Instance Method Details

#as_svg(options = {}) ⇒ Object

Render the SVG from the Qrcode.

Options: offset - Padding around the QR Code in pixels

(default 0)

fill - Background color e.g “ffffff”

(default none)

color - Foreground color e.g “000”

(default "000")

module_size - The Pixel size of each module

(defaults 11)

shape_rendering - SVG Attribute: auto | optimizeSpeed | crispEdges | geometricPrecision

(defaults crispEdges)

standalone - Whether to make this a full SVG file, or only an svg to embed in other svg

(default true)

use_path - Use <path> to render SVG rather than <rect> to significantly reduce size

and quality. This will become the default in future versions.
(default false)

viewbox - replace ‘width` and `height` in <svg> with a viewBox, allows CSS scaling

(default false)

svg_attributes - A optional hash of custom <svg> attributes. Existing attributes will remain.

(default {})



164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
 
# File 'lib/rqrcode/export/svg.rb', line 164

def as_svg(options = {})
  fill = options[:fill]
  use_path = options[:use_path]
  offset = options[:offset].to_i || 0
  color = options[:color] || "000"
  shape_rendering = options[:shape_rendering] || "crispEdges"
  module_size = options[:module_size] || 11
  standalone = options[:standalone].nil? ? true : options[:standalone]
  viewbox = options[:viewbox].nil? ? false : options[:viewbox]
  svg_attributes = options[:svg_attributes] || {}

  # height and width dependent on offset and QR complexity
  dimension = (@qrcode.module_count * module_size) + (2 * offset)
  # use dimensions differently if we are using a viewBox
  dimensions_attr = viewbox ? %(viewBox="0 0 #{dimension} #{dimension}") : %(width="#{dimension}" height="#{dimension}")

  svg_tag_attributes = (DEFAULT_SVG_ATTRIBUTES + [
    dimensions_attr,
    %(shape-rendering="#{shape_rendering}")
  ] + svg_attributes.map { |k, v| %(#{k}="#{v}") }).join(" ")

  xml_tag = %(<?xml version="1.0" standalone="yes"?>)
  open_tag = %(<svg #{svg_tag_attributes}>)
  close_tag = "</svg>"

  output_tag = (use_path ? Path : Rect).new(@qrcode)
  output_tag.build(module_size, offset, color)

  if fill
    # Prefix hexadecimal colors unless using a named color (symbol)
    fill = "##{fill}" unless fill.is_a?(Symbol)
    output_tag.result.unshift %(<rect width="#{dimension}" height="#{dimension}" x="0" y="0" fill="#{fill}"/>)
  end

  if standalone
    output_tag.result.unshift(xml_tag, open_tag)
    output_tag.result << close_tag
  end

  output_tag.result.join
end