Class: Sevgi::Graphics::Canvas

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Defined in:
lib/sevgi/graphics/auxiliary/canvas.rb

Overview

SVG canvas size, margins, viewport, and viewBox.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(width:, height:, unit: "mm", name: :custom, margins: []) ⇒ void

Creates a canvas.

Parameters:

  • width (Numeric) —

    canvas width

  • height (Numeric) —

    canvas height

  • unit (Symbol, String) (defaults to: "mm") —

    SVG unit

  • name (Symbol, String) (defaults to: :custom) —

    paper name

  • margins (Array<Numeric>) (defaults to: []) —

    margin shorthand values

Raises:

  • (Sevgi::ArgumentError) —

    when margins or numeric dimensions are invalid



71
72
73
74
75
76
77
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 71

def initialize(width:, height:, unit: "mm", name: :custom, margins: [])
  @size = Paper[width, height, unit, name]
  @margin = Margin[*margins]

  compute
  freeze
end

Instance Attribute Details

#inner ⇒ Object (readonly)

Returns the value of attribute inner.



61
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 61

attr_reader :size, :margin, :inner

#margin ⇒ Sevgi::Graphics::Margin (readonly)

Returns canvas margins.

Returns:



61
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 61

attr_reader :size, :margin, :inner

#size ⇒ Sevgi::Graphics::Paper (readonly)

Returns paper size object.

Returns:



61
62
63
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 61

def size
  @size
end

Class Method Details

.call(arg = Undefined, **kwargs) ⇒ Sevgi::Graphics::Canvas

Builds a canvas from a paper profile or explicit size.

Parameters:

  • arg (Sevgi::Graphics::Paper, Symbol, String, Sevgi::Undefined) (defaults to: Undefined) —

    paper profile or paper object

  • kwargs (Hash) —

    canvas keyword arguments

Returns:

Raises:

  • (Sevgi::ArgumentError) —

    when the paper profile is unknown



19
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 19

def self.call(...) = from_paper(...)

.from_paper(arg = Undefined, **kwargs) ⇒ Sevgi::Graphics::Canvas

Builds a canvas from a paper profile or explicit size.

Parameters:

  • arg (Sevgi::Graphics::Paper, Symbol, String, Sevgi::Undefined) (defaults to: Undefined) —

    paper profile or paper object

  • kwargs (Hash) —

    canvas keyword arguments

Returns:

Raises:

  • (Sevgi::ArgumentError) —

    when the paper profile is unknown



26
27
28
29
30
31
32
33
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 26

def self.from_paper(arg = Undefined, **kwargs)
  case arg
  when Undefined
    new(**kwargs)
  else
    new(**paper(arg).to_h, **kwargs)
  end
end

Instance Method Details

#attributes(origin = Undefined) ⇒ Hash

Returns SVG root viewport attributes.

Parameters:

  • origin (Numeric, Array<Numeric>, nil, Sevgi::Undefined) (defaults to: Undefined) —

    viewBox origin

Returns:

  • (Hash)

Raises:

  • (Sevgi::ArgumentError) —

    when origin is invalid



84
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 84

def attributes(...) = {**viewport, viewBox: viewbox(...)}

#viewbox(origin = Undefined) ⇒ String

Returns the SVG viewBox string.

Parameters:

  • origin (Numeric, Array<Numeric>, nil, Sevgi::Undefined) (defaults to: Undefined) —

    viewBox origin

Returns:

  • (String)

Raises:

  • (Sevgi::ArgumentError) —

    when origin is invalid



94
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 94

def viewbox(origin = Undefined) = prettify(*originate(origin), width, height).join(" ")

#viewport ⇒ Hash

Returns SVG width and height attributes.

Returns:

  • (Hash) 


88
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 88

def viewport = {width: "#{width}#{unit}", height: "#{height}#{unit}"}

#with(**kwargs) ⇒ Sevgi::Graphics::Canvas

Returns a canvas with selected fields replaced.

Parameters:

  • kwargs (Hash) —

    replacement options

Options Hash (**kwargs):

  • :width (Numeric) —

    replacement canvas width

  • :height (Numeric) —

    replacement canvas height

  • :unit (Symbol, String) —

    replacement SVG unit

  • :name (Symbol, String) —

    replacement paper name

  • :margins (Array<Numeric>) —

    replacement margin shorthand values

Returns:

Raises:

  • (Sevgi::ArgumentError) —

    when an unknown option is supplied

  • (Sevgi::ArgumentError) —

    when a replacement value is invalid



106
107
108
109
110
111
112
113
114
115
 
# File 'lib/sevgi/graphics/auxiliary/canvas.rb', line 106

def with(**kwargs)
  unknown = kwargs.keys - REPLACEMENTS

  ArgumentError.("Unknown canvas option: #{unknown.first}") unless unknown.empty?

  margins = kwargs.fetch(:margins, margin.to_a)
  replacements = kwargs.dup.tap { it.delete(:margins) }

  self.class.new(**size.to_h, **replacements, margins:)
end