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)

offset_x - X Padding around the QR Code in pixels

(default offset)

offset_y - Y Padding around the QR Code in pixels

(default offset)

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 {})


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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
# File 'lib/rqrcode/export/svg.rb', line 178

def as_svg(options = {})
  fill = options[:fill]
  use_path = options[:use_path]
  offset = options[:offset].to_i
  offset_x = options.key?(:offset_x) ? options[:offset_x].to_i : offset
  offset_y = options.key?(:offset_y) ? options[:offset_y].to_i : offset
  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
  width = (@qrcode.module_count * module_size) + (2 * offset_x)
  height = (@qrcode.module_count * module_size) + (2 * offset_y)
  dimension = [width, height].max
  # use dimensions differently if we are using a viewBox
  dimensions_attr = viewbox ? %(viewBox="0 0 #{width} #{height}") : %(width="#{width}" height="#{height}")

  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_x: offset_x, offset_y: offset_y, color: 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