Class: MtgCardMaker::BaseCard

Inherits:
Object
  • Object
show all
Defined in:
lib/mtg_card_maker/base_card.rb

Overview

Base class for all Magic: The Gathering card types that provides common functionality with simplified configuration. This class handles the creation of complete MTG cards with all necessary layers (frames, text, art, etc.) using predefined dimensions and layouts.

Examples:

card = MtgCardMaker::BaseCard.new(
  name: "Lightning Bolt",
  mana_cost: "R",
  type_line: "Instant",
  rules_text: "Lightning Bolt deals 3 damage to any target.",
  color_scheme: :red
)
card.save("lightning_bolt.svg")

Since:

  • 0.1.0

Constant Summary collapse

DEFAULTS =

Fixed defaults for card layout and dimensions

Returns:

  • (Hash) —

    the default configuration for card layers and dimensions

Since:

  • 0.1.0

{
  layers: {
    border: {
      x: 0,
      y: 0,
      width: 630,
      height: 880
    },
    frame: {
      x: 10,
      y: 10,
      width: 610,
      height: 860
    },
    name_area: {
      x: 30,
      y: 40,
      width: 570,
      height: 50
    },
    art_layer: {
      x: 40,
      y: 95,
      width: 550,
      height: 400,
      corner_radius: { x: 5, y: 5 }
    },
    type_area: {
      x: 30,
      y: 500,
      width: 570,
      height: 40
    },
    text_box: {
      x: 40,
      y: 545,
      width: 550,
      height: 265
    },
    power_area: {
      x: 455,
      y: 790,
      width: 140,
      height: 40
    }
  },
  mask_id: 'artWindowMask',
  frame_stroke_width: 2
}.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(config) ⇒ BaseCard

Initialize a new card with the given configuration

Parameters:

  • config (Hash) —

    the card configuration

Options Hash (config):

  • :name (String) —

    the card name

  • :mana_cost (String) —

    the mana cost in MTG notation

  • :type_line (String) —

    the card type

  • :rules_text (String) —

    the card rules text

  • :flavor_text (String) —

    the flavor text

  • :power (String) —

    the power value for creatures

  • :toughness (String) —

    the toughness value for creatures

  • :border_color (String) —

    the border color

  • :color (Symbol, String) —

    the color scheme

  • :art (String) —

    the URL or path for card artwork

Since:

  • 0.1.0



124
125
126
127
128
 
# File 'lib/mtg_card_maker/base_card.rb', line 124

def initialize(config)
  assign_attributes(config)
  @template = Template.new
  add_layers
end

Instance Attribute Details

#art ⇒ String? (readonly)

Returns the URL or path for the card artwork.

Returns:

  • (String, nil) —

    the URL or path for the card artwork

Since:

  • 0.1.0



109
110
111
 
# File 'lib/mtg_card_maker/base_card.rb', line 109

def art
  @art
end

#border_color ⇒ String? (readonly)

Returns the border color.

Returns:

  • (String, nil) —

    the border color

Since:

  • 0.1.0



103
104
105
 
# File 'lib/mtg_card_maker/base_card.rb', line 103

def border_color
  @border_color
end

#color_scheme ⇒ ColorScheme (readonly)

Returns the color scheme for the card.

Returns:

  • (ColorScheme) —

    the color scheme for the card

Since:

  • 0.1.0



106
107
108
 
# File 'lib/mtg_card_maker/base_card.rb', line 106

def color_scheme
  @color_scheme
end

#flavor_text ⇒ String? (readonly)

Returns the flavor text (italic text at bottom).

Returns:

  • (String, nil) —

    the flavor text (italic text at bottom)

Since:

  • 0.1.0



94
95
96
 
# File 'lib/mtg_card_maker/base_card.rb', line 94

def flavor_text
  @flavor_text
end

#mana_cost ⇒ String? (readonly)

Returns the mana cost in MTG notation (e.g., “R”, “1U”).

Returns:

  • (String, nil) —

    the mana cost in MTG notation (e.g., “R”, “1U”)

Since:

  • 0.1.0



85
86
87
 
# File 'lib/mtg_card_maker/base_card.rb', line 85

def mana_cost
  @mana_cost
end

#name ⇒ String? (readonly)

Returns the card name.

Returns:

  • (String, nil) —

    the card name

Since:

  • 0.1.0



82
83
84
 
# File 'lib/mtg_card_maker/base_card.rb', line 82

def name
  @name
end

#power ⇒ String? (readonly)

Returns the power value for creatures.

Returns:

  • (String, nil) —

    the power value for creatures

Since:

  • 0.1.0



97
98
99
 
# File 'lib/mtg_card_maker/base_card.rb', line 97

def power
  @power
end

#rules_text ⇒ String? (readonly)

Returns the card description/rules text.

Returns:

  • (String, nil) —

    the card description/rules text

Since:

  • 0.1.0



91
92
93
 
# File 'lib/mtg_card_maker/base_card.rb', line 91

def rules_text
  @rules_text
end

#toughness ⇒ String? (readonly)

Returns the toughness value for creatures.

Returns:

  • (String, nil) —

    the toughness value for creatures

Since:

  • 0.1.0



100
101
102
 
# File 'lib/mtg_card_maker/base_card.rb', line 100

def toughness
  @toughness
end

#type_line ⇒ String? (readonly)

Returns the card type (e.g., “Instant”, “Creature”).

Returns:

  • (String, nil) —

    the card type (e.g., “Instant”, “Creature”)

Since:

  • 0.1.0



88
89
90
 
# File 'lib/mtg_card_maker/base_card.rb', line 88

def type_line
  @type_line
end

Instance Method Details

#art_window_config ⇒ Object

Since:

  • 0.1.0



164
165
166
 
# File 'lib/mtg_card_maker/base_card.rb', line 164

def art_window_config
  DEFAULTS[:layers][:art_layer]
end

#card_height ⇒ Object

Since:

  • 0.1.0



154
155
156
 
# File 'lib/mtg_card_maker/base_card.rb', line 154

def card_height
  CARD_HEIGHT
end

#card_width ⇒ Object

Delegate dimension methods to DEFAULTS for LayerFactory compatibility

Since:

  • 0.1.0



149
150
151
 
# File 'lib/mtg_card_maker/base_card.rb', line 149

def card_width
  CARD_WIDTH
end

#dimensions_for_layer(layer_name) ⇒ Object

Since:

  • 0.1.0



159
160
161
 
# File 'lib/mtg_card_maker/base_card.rb', line 159

def dimensions_for_layer(layer_name)
  DEFAULTS[:layers][layer_name.to_sym] || {}
end

#frame_stroke_width ⇒ Object

Since:

  • 0.1.0



169
170
171
 
# File 'lib/mtg_card_maker/base_card.rb', line 169

def frame_stroke_width
  DEFAULTS[:frame_stroke_width]
end

#save(filename) ⇒ void

This method returns an undefined value.

Save the card to an SVG file

Parameters:

  • filename (String) —

    the filename to save to

Since:

  • 0.1.0



134
135
136
 
# File 'lib/mtg_card_maker/base_card.rb', line 134

def save(filename)
  @template.save(filename)
end

#use_color_scheme(color) ⇒ Object

Since:

  • 0.1.0



139
140
141
142
143
144
145
 
# File 'lib/mtg_card_maker/base_card.rb', line 139

def use_color_scheme(color)
  if color
    ColorScheme.new(color)
  else
    DEFAULT_COLOR_SCHEME
  end
end