Class: CyberarmEngine::Element::Container

Inherits:
CyberarmEngine::Element show all
Includes:
Common
Defined in:
lib/cyberarm_engine/ui/elements/container.rb

Direct Known Subclasses

Flow, Slider, Stack

Constant Summary

Constants included from Theme

Theme::THEME

Instance Attribute Summary collapse

Attributes inherited from CyberarmEngine::Element

#background_canvas, #border_canvas, #element_visible, #event_handler, #options, #parent, #style, #tip, #x, #y, #z

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Common

#alt_down?, #control_down?, #current_state, #darken, #draw_rect, #fill, #find_element_by_tag, #get_asset, #get_image, #get_sample, #get_song, #lighten, #opacity, #pop_state, #previous_state, #push_state, #shift_down?, #shift_state, #show_cursor, #show_cursor=, #window

Methods inherited from CyberarmEngine::Element

#background=, #background_image=, #background_nine_slice=, #blur, #button_down, #button_up, #child_of?, #clicked_left_mouse_button, #content_height, #content_width, #default_events, #dimensional_size, #draggable?, #draw, #element_visible?, #enabled=, #enabled?, #enter, #focus, #focused?, #height, #hide, #hit?, #inner_height, #inner_width, #inspect, #is_root?, #leave, #left_mouse_button, #max_scroll_height, #max_scroll_width, #noncontent_height, #noncontent_width, #outer_height, #outer_width, #parent_of?, #recalculate_if_size_changed, #released_left_mouse_button, #reposition, #root, #safe_style_fetch, #scroll_height, #scroll_width, #set_background, #set_background_image, #set_background_nine_slice, #set_border_color, #set_border_thickness, #set_color, #set_font, #set_margin, #set_padding, #set_static_position, #show, #space_available_height, #space_available_width, #stylize, #toggle, #update_background, #update_background_image, #update_background_nine_slice, #update_styles, #value=, #visible?, #width

Methods included from CyberarmEngine::Event

#event, #publish, #subscribe, #unsubscribe

Methods included from Theme

#deep_merge, #default, #theme_defaults

Constructor Details

#initialize(options = {}, block = nil) ⇒ Container

Returns a new instance of Container.



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 19

def initialize(options = {}, block = nil)
  @gui_state = options.delete(:gui_state)
  super

  @last_scroll_position = Vector.new(0, 0)
  @scroll_position = Vector.new(0, 0)
  @scroll_target_position = Vector.new(0, 0)
  @scroll_chunk = 120
  @scroll_speed = 40

  if @gui_state
    @width = window.width
    @height = window.height
  end

  @text_color = options[:color]

  @children = []

  event(:window_size_changed)
end

Instance Attribute Details

#children ⇒ Object (readonly)

Returns the value of attribute children.



7
8
9
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 7

def children
  @children
end

#fill_color ⇒ Object

Returns the value of attribute fill_color.



6
7
8
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 6

def fill_color
  @fill_color
end

#gui_state ⇒ Object (readonly)

Returns the value of attribute gui_state.



7
8
9
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 7

def gui_state
  @gui_state
end

#scroll_position ⇒ Object (readonly)

Returns the value of attribute scroll_position.



7
8
9
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 7

def scroll_position
  @scroll_position
end

#scroll_target_position ⇒ Object (readonly)

Returns the value of attribute scroll_target_position.



7
8
9
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 7

def scroll_target_position
  @scroll_target_position
end

#stroke_color ⇒ Object

Returns the value of attribute stroke_color.



6
7
8
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 6

def stroke_color
  @stroke_color
end

Class Method Details

.current_container ⇒ Object 



9
10
11
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 9

def self.current_container
  @current_container
end

.current_container=(container) ⇒ Object

Raises:

  • (ArgumentError) 


13
14
15
16
17
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 13

def self.current_container=(container)
  raise ArgumentError, "Expected container to an an instance of CyberarmEngine::Element::Container, got #{container.class}" unless container.is_a?(CyberarmEngine::Element::Container)

  @current_container = container
end

Instance Method Details

#add(element) ⇒ Object 



47
48
49
50
51
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 47

def add(element)
  @children << element

  root.gui_state.request_recalculate_for(self)
end

#append(&block) ⇒ Object 



57
58
59
60
61
62
63
64
65
66
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 57

def append(&block)
  old_container = CyberarmEngine::Element::Container.current_container

  CyberarmEngine::Element::Container.current_container = self
  block&.call(self)

  CyberarmEngine::Element::Container.current_container = old_container

  root.gui_state.request_recalculate_for(self)
end

#build ⇒ Object 



41
42
43
44
45
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 41

def build
  @block&.call(self)

  root.gui_state.request_recalculate_for(self)
end

#clear(&block) ⇒ Object 



68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 68

def clear(&block)
  @children.clear

  old_container = CyberarmEngine::Element::Container.current_container

  CyberarmEngine::Element::Container.current_container = self
  block&.call(self)

  CyberarmEngine::Element::Container.current_container = old_container

  root.gui_state.request_recalculate_for(self)
end

#debug_draw ⇒ Object 



94
95
96
97
98
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 94

def debug_draw
  super

  @children.each(&:debug_draw)
end

#fits_on_line?(element) ⇒ Boolean

Flow

Returns:

  • (Boolean) 


262
263
264
265
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 262

def fits_on_line?(element) # Flow
  @current_position.x + element.outer_width <= max_width &&
    @current_position.x + element.outer_width <= window.width
end

#hit_element?(x, y) ⇒ Boolean

Returns:

  • (Boolean) 


105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 105

def hit_element?(x, y)
  return unless hit?(x, y)

  # Offset child hit point by scroll position/offset
  child_x = x - @scroll_position.x
  child_y = y - @scroll_position.y

  @children.reverse_each do |child|
    next unless child.visible?

    case child
    when Container
      if (element = child.hit_element?(child_x, child_y))
        return element
      end
    else
      return child if child.hit?(child_x, child_y)
    end
  end

  self if hit?(x, y)
end

#layout ⇒ Object 



247
248
249
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 247

def layout
  raise "Not overridden"
end

#max_width ⇒ Object 



251
252
253
254
255
256
257
258
259
260
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 251

def max_width
  # _width = dimensional_size(@style.width, :width)
  # if _width
  #   outer_width
  # else
  #   window.width - (@parent ? @parent.style.margin_right + @style.margin_right : @style.margin_right)
  # end

  outer_width
end

#mouse_wheel_down(sender, x, y) ⇒ Object 



316
317
318
319
320
321
322
323
324
325
326
327
328
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 316

def mouse_wheel_down(sender, x, y)
  return unless @style.scroll

  return unless height < scroll_height

  if @scroll_target_position.y.positive?
    @scroll_target_position.y = -@scroll_chunk
  else
    @scroll_target_position.y -= @scroll_chunk
  end

  :handled
end

#mouse_wheel_up(sender, x, y) ⇒ Object 



301
302
303
304
305
306
307
308
309
310
311
312
313
314
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 301

def mouse_wheel_up(sender, x, y)
  return unless @style.scroll

  # Allow overscrolling UP, only if one can scroll DOWN
  return unless height < scroll_height

  if @scroll_target_position.y.positive?
    @scroll_target_position.y = @scroll_chunk
  else
    @scroll_target_position.y += @scroll_chunk
  end

  :handled
end

#move_to_next_line(element) ⇒ Object

Stack



294
295
296
297
298
299
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 294

def move_to_next_line(element) # Stack
  element.x = element.style.margin_left + @current_position.x
  element.y = element.style.margin_top  + @current_position.y

  @current_position.y += element.outer_height
end

#position_on_current_line(element) ⇒ Object

Flow



267
268
269
270
271
272
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 267

def position_on_current_line(element) # Flow
  element.x = element.style.margin_left + @current_position.x
  element.y = element.style.margin_top  + @current_position.y

  @current_position.x += element.outer_width
end

#position_on_next_line(element) ⇒ Object

Flow



284
285
286
287
288
289
290
291
292
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 284

def position_on_next_line(element) # Flow
  @current_position.x = @style.margin_left + @style.padding_left
  @current_position.y += tallest_neighbor(element, @current_position.y).outer_height

  element.x = element.style.margin_left + @current_position.x
  element.y = element.style.margin_top  + @current_position.y

  @current_position.x += element.outer_width
end

#recalculate ⇒ Object 



156
157
158
159
160
161
162
163
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
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 156

def recalculate
  @current_position = Vector.new(@style.margin_left + @style.padding_left, @style.margin_top + @style.padding_top)

  return unless visible?

  Stats.frame&.increment(:gui_recalculations)

  # s = Gosu.milliseconds

  stylize
  layout

  # Old sizes MUST be determined AFTER call to layout
  old_width = width
  old_height = height

  @cached_scroll_width = nil
  @cached_scroll_height = nil

  if is_root?
    @width  = @style.width  = window.width
    @height = @style.height = window.height
  else
    @width = 0
    @height = 0

    _width = dimensional_size(@style.width, :width)
    _height = dimensional_size(@style.height, :height)

    @width  = _width  || (@children.map { |c| c.x + c.outer_width }.max || 0).floor
    @height = _height || (@children.map { |c| c.y + c.outer_height }.max || 0).floor
  end

  # FIXME: Correctly handle alignment when element has siblings
  # FIXME: Enable alignment for any element, not just containers
  if @style.v_align
    space = space_available_height

    case @style.v_align
    when :center
      @y = parent.height / 2 - height / 2
    when :bottom
      @y = parent.height - height
    end
  end

  if @style.h_align
    space = space_available_width

    case @style.h_align
    when :center
      @x = parent.width / 2 - width / 2
    when :right
      @x = parent.width - width
    end
  end

  # t = Gosu.milliseconds
  # Move children to parent after positioning
  @children.each do |child|
    child.x += (@x + @style.border_thickness_left) - style.margin_left
    child.y += (@y + @style.border_thickness_top) - style.margin_top

    child.stylize
    child.recalculate
    child.reposition # TODO: Implement top,bottom,left,center, and right positioning

    Stats.frame&.increment(:gui_recalculations)

    update_child_element_visibity(child)
  end
  # puts "TOOK: #{Gosu.milliseconds - t}ms to recalculate #{self.class}:0x#{object_id.to_s(16)}'s #{@children.count} children" if is_root?

  update_background

  # Fixes resized container scrolled past bottom
  if old_height != @height
    self.scroll_top = -@scroll_position.y
    @scroll_target_position.y = @scroll_position.y
  end

  # Fixes resized container that is scrolled down from being stuck overscrolled when resized
  if scroll_height < height
    @scroll_target_position.y = 0
  end

  recalculate_if_size_changed

  # puts "TOOK: #{Gosu.milliseconds - s}ms to recalculate #{self.class}:0x#{self.object_id.to_s(16)}"
end

#remove(element) ⇒ Object 



53
54
55
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 53

def remove(element)
  root.gui_state.request_recalculate_for(self) if @children.delete(element)
end

#render ⇒ Object 



81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 81

def render
  Gosu.clip_to(
    @x + @style.border_thickness_left + @style.padding_left,
    @y + @style.border_thickness_top + @style.padding_top,
    content_width + 1,
    content_height + 1
  ) do
    Gosu.translate(@scroll_position.x, @scroll_position.y) do
      @children.each(&:draw)
    end
  end
end

#scroll_jump_to_end(sender, x, y) ⇒ Object 



339
340
341
342
343
344
345
346
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 339

def scroll_jump_to_end(sender, x, y)
  return unless @style.scroll

  @scroll_position.y = -max_scroll_height
  @scroll_target_position.y = -max_scroll_height

  :handled
end

#scroll_jump_to_top(sender, x, y) ⇒ Object 



330
331
332
333
334
335
336
337
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 330

def scroll_jump_to_top(sender, x, y)
  return unless @style.scroll

  @scroll_position.y = 0
  @scroll_target_position.y = 0

  :handled
end

#scroll_page_down(sender, x, y) ⇒ Object 



358
359
360
361
362
363
364
365
366
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 358

def scroll_page_down(sender, x, y)
  return unless @style.scroll

  @scroll_position.y -= height
  @scroll_position.y = -max_scroll_height if @scroll_position.y < -max_scroll_height
  @scroll_target_position.y = @scroll_position.y

  :handled
end

#scroll_page_up(sender, x, y) ⇒ Object 



348
349
350
351
352
353
354
355
356
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 348

def scroll_page_up(sender, x, y)
  return unless @style.scroll

  @scroll_position.y += height
  @scroll_position.y = 0 if @scroll_position.y > 0
  @scroll_target_position.y = @scroll_position.y

  :handled
end

#scroll_top ⇒ Object 



368
369
370
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 368

def scroll_top
  @scroll_position.y
end

#scroll_top=(n) ⇒ Object 



372
373
374
375
376
377
378
379
380
381
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 372

def scroll_top=(n)
  n = 0 if n <= 0
  @scroll_position.y = -n

  if max_scroll_height.positive?
    @scroll_position.y = -max_scroll_height if @scroll_position.y.abs > max_scroll_height
  else
    @scroll_position.y = 0
  end
end

#tallest_neighbor(querier, _y_position) ⇒ Object

Flow



274
275
276
277
278
279
280
281
282
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 274

def tallest_neighbor(querier, _y_position) # Flow
  response = querier
  @children.each do |child|
    response = child if child.outer_height > response.outer_height
    break if child == querier
  end

  response
end

#to_s ⇒ Object 



387
388
389
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 387

def to_s
  "#{self.class} x=#{x} y=#{y} width=#{width} height=#{height} children=#{@children.size}"
end

#update ⇒ Object 



100
101
102
103
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 100

def update
  update_scroll if @style.scroll
  @children.each(&:update)
end

#update_child_element_visibity(child) ⇒ Object 



128
129
130
131
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 128

def update_child_element_visibity(child)
  child.element_visible = child.x >= (@x - @scroll_position.x) - child.width && child.x <= (@x - @scroll_position.x) + width &&
                          child.y >= (@y - @scroll_position.y) - child.height && child.y <= (@y - @scroll_position.y) + height
end

#update_scroll ⇒ Object 



133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 133

def update_scroll
  dt = window.dt.clamp(0.000001, 0.025)
  @scroll_position.x += (((@scroll_target_position.x - @scroll_position.x) * (@scroll_speed / 4.0) * 0.98) * dt).round
  @scroll_position.y += (((@scroll_target_position.y - @scroll_position.y) * (@scroll_speed / 4.0) * 0.98) * dt).round

  # Scrolled PAST top
  if @scroll_position.y > 0
    @scroll_target_position.y = 0

  # Scrolled PAST bottom
  elsif @scroll_position.y < -max_scroll_height
    @scroll_target_position.y = -max_scroll_height
  end

  if @last_scroll_position != @scroll_position
    @children.each { |child| update_child_element_visibity(child) }
    root.gui_state.request_repaint
  end

  @last_scroll_position.x = @scroll_position.x
  @last_scroll_position.y = @scroll_position.y
end

#value ⇒ Object 



383
384
385
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 383

def value
  @children.map(&:class).join(", ")
end

#write_tree(indent = "", _index = 0) ⇒ Object 



391
392
393
394
395
396
397
398
399
400
401
402
403
404
 
# File 'lib/cyberarm_engine/ui/elements/container.rb', line 391

def write_tree(indent = "", _index = 0)
  puts self

  indent += "  "
  @children.each_with_index do |child, i|
    print "#{indent}#{i}: "

    if child.is_a?(Container)
      child.write_tree(indent)
    else
      puts child
    end
  end
end