Class: Glimmer::LibUI::Shape

Inherits:
Object
  • Object
show all
Includes:
DataBindable, Parent
Defined in:
lib/glimmer/libui/shape.rb,
lib/glimmer/libui/shape/arc.rb,
lib/glimmer/libui/shape/line.rb,
lib/glimmer/libui/shape/bezier.rb,
lib/glimmer/libui/shape/circle.rb,
lib/glimmer/libui/shape/figure.rb,
lib/glimmer/libui/shape/square.rb,
lib/glimmer/libui/shape/polygon.rb,
lib/glimmer/libui/shape/polyline.rb,
lib/glimmer/libui/shape/rectangle.rb,
lib/glimmer/libui/shape/polybezier.rb

Overview

Represents LibUI lightweight shape objects nested under path (e.g. line, rectangle, arc, bezier)

Direct Known Subclasses

Arc, Bezier, Circle, Figure, Line, Polybezier, Polygon, Polyline, Rectangle, Square

Defined Under Namespace

Classes: Arc, Bezier, Circle, Figure, Line, Polybezier, Polygon, Polyline, Rectangle, Square

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from DataBindable

#data_bind

Methods included from Parent

#children

Constructor Details

#initialize(keyword, parent, args, &block) ⇒ Shape

Returns a new instance of Shape.



72
73
74
75
76
77
78
79
80
 
# File 'lib/glimmer/libui/shape.rb', line 72

def initialize(keyword, parent, args, &block)
  @keyword = keyword
  @parent = parent
  @args = args
  @block = block
  set_parameter_defaults
  build_control if implicit_path?
  post_add_content if @block.nil?
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method_name, *args, &block) ⇒ Object 



152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
 
# File 'lib/glimmer/libui/shape.rb', line 152

def method_missing(method_name, *args, &block)
  method_name_parameter = method_name.to_s.sub(/=$/, '').sub(/^set_/, '').to_sym
  if self.class.parameters.include?(method_name_parameter)
    method_name = method_name.to_s
    parameter_index = self.class.parameters.index(method_name_parameter)
    if method_name.start_with?('set_') || method_name.end_with?('=') || !args.empty?
      args = [args] if args.size > 1
      if args.first != @args[parameter_index]
        @args[parameter_index] = args.first
        request_auto_redraw
      end
    else
      @args[parameter_index]
    end
  else # TODO consider if there is a need to redirect anything to path proxy or delete this TODO
    super
  end
end

Instance Attribute Details

#args ⇒ Object (readonly)

Returns the value of attribute args.



70
71
72
 
# File 'lib/glimmer/libui/shape.rb', line 70

def args
  @args
end

#block ⇒ Object (readonly)

Returns the value of attribute block.



70
71
72
 
# File 'lib/glimmer/libui/shape.rb', line 70

def block
  @block
end

#keyword ⇒ Object (readonly)

Returns the value of attribute keyword.



70
71
72
 
# File 'lib/glimmer/libui/shape.rb', line 70

def keyword
  @keyword
end

#parent ⇒ Object (readonly)

Returns the value of attribute parent.



70
71
72
 
# File 'lib/glimmer/libui/shape.rb', line 70

def parent
  @parent
end

Class Method Details

.constant_symbol(keyword) ⇒ Object 



62
63
64
 
# File 'lib/glimmer/libui/shape.rb', line 62

def constant_symbol(keyword)
  "#{keyword.camelcase(:upper)}".to_sym
end

.create(keyword, parent, args, &block) ⇒ Object 



38
39
40
 
# File 'lib/glimmer/libui/shape.rb', line 38

def create(keyword, parent, args, &block)
  shape_class(keyword).new(keyword, parent, args, &block)
end

.exists?(keyword) ⇒ Boolean

Returns:

  • (Boolean) 


32
33
34
35
36
 
# File 'lib/glimmer/libui/shape.rb', line 32

def exists?(keyword)
  Shape.constants.include?(constant_symbol(keyword)) and
    shape_class(keyword).respond_to?(:ancestors) and
    shape_class(keyword).ancestors.include?(Shape)
end

.parameter_defaults(*defaults) ⇒ Object 



54
55
56
57
58
59
60
 
# File 'lib/glimmer/libui/shape.rb', line 54

def parameter_defaults(*defaults)
  if defaults.empty?
    @parameter_defaults
  else
    @parameter_defaults = defaults
  end
end

.parameters(*params) ⇒ Object 



46
47
48
49
50
51
52
 
# File 'lib/glimmer/libui/shape.rb', line 46

def parameters(*params)
  if params.empty?
    @parameters
  else
    @parameters = params
  end
end

.shape_class(keyword) ⇒ Object 



42
43
44
 
# File 'lib/glimmer/libui/shape.rb', line 42

def shape_class(keyword)
  Shape.const_get(constant_symbol(keyword))
end

Instance Method Details

#area_proxy ⇒ Object 



121
122
123
 
# File 'lib/glimmer/libui/shape.rb', line 121

def area_proxy
  find_parent_in_ancestors { |parent| parent.nil? || parent.is_a?(ControlProxy::AreaProxy) }
end

#content(&block) ⇒ Object 



99
100
101
102
 
# File 'lib/glimmer/libui/shape.rb', line 99

def content(&block)
  Glimmer::DSL::Engine.add_content(self, Glimmer::DSL::Libui::ShapeExpression.new, @keyword, &block)
  request_auto_redraw
end

#destroy ⇒ Object 



117
118
119
 
# File 'lib/glimmer/libui/shape.rb', line 117

def destroy
  @parent.children.delete(self)
end

#draw(area_draw_params) ⇒ Object

Subclasses must override to perform draw work and call super afterwards to ensure calling destroy when semi-declarative in an on_draw method



105
106
107
 
# File 'lib/glimmer/libui/shape.rb', line 105

def draw(area_draw_params)
  destroy if area_proxy.nil?
end

#fill(*args) ⇒ Object Also known as: fill=, set_fill 



129
130
131
 
# File 'lib/glimmer/libui/shape.rb', line 129

def fill(*args)
  path_proxy.fill(*args)
end

#path_proxy ⇒ Object 



125
126
127
 
# File 'lib/glimmer/libui/shape.rb', line 125

def path_proxy
  find_parent_in_ancestors { |parent| parent.nil? || parent.is_a?(ControlProxy::PathProxy) }
end

#post_add_content ⇒ Object

Subclasses may override to perform post add_content work (normally must call super)



83
84
85
86
87
88
89
 
# File 'lib/glimmer/libui/shape.rb', line 83

def post_add_content
  unless @content_added
    @parent&.post_initialize_child(self)
    @parent.post_add_content if implicit_path? && dynamic?
    @content_added = true
  end
end

#post_initialize_child(child, add_child: true) ⇒ Object 



91
92
93
94
95
96
97
 
# File 'lib/glimmer/libui/shape.rb', line 91

def post_initialize_child(child, add_child: true)
  if child.is_a?(ControlProxy::MatrixProxy)
    path_proxy.post_initialize_child(child, add_child: add_child)
  else
    super(child, add_child: add_child)
  end
end

#redraw ⇒ Object 



109
110
111
 
# File 'lib/glimmer/libui/shape.rb', line 109

def redraw
  area_proxy&.redraw
end

#request_auto_redraw ⇒ Object 



113
114
115
 
# File 'lib/glimmer/libui/shape.rb', line 113

def request_auto_redraw
  area_proxy&.request_auto_redraw
end

#respond_to?(method_name, *args, &block) ⇒ Boolean

Returns:

  • (Boolean) 


147
148
149
150
 
# File 'lib/glimmer/libui/shape.rb', line 147

def respond_to?(method_name, *args, &block)
  self.class.parameters.include?(method_name.to_s.sub(/=$/, '').sub(/^set_/, '').to_sym) or
    super(method_name, true)
end

#stroke(*args) ⇒ Object Also known as: stroke=, set_stroke 



135
136
137
 
# File 'lib/glimmer/libui/shape.rb', line 135

def stroke(*args)
  path_proxy.stroke(*args)
end

#transform(matrix = nil) ⇒ Object Also known as: transform=, set_transform 



141
142
143
 
# File 'lib/glimmer/libui/shape.rb', line 141

def transform(matrix = nil)
  path_proxy.transform(matrix)
end