module CyberarmEngine class Element include Theme include Event include Common attr_accessor :x, :y, :z, :tip, :element_visible attr_reader :parent, :options, :style, :event_handler, :background_canvas, :border_canvas def initialize(options = {}, block = nil) @parent = options.delete(:parent) # parent Container (i.e. flow/stack) options = theme_defaults(options) @options = options @block = block @focus = !@options.key?(:focus) ? false : @options[:focus] @enabled = !@options.key?(:enabled) ? true : @options[:enabled] @visible = !@options.key?(:visible) ? true : @options[:visible] @tip = @options[:tip] || "" @debug_color = @options[:debug_color].nil? ? Gosu::Color::RED : @options[:debug_color] @style = Style.new(options) @root ||= nil @gui_state ||= nil @element_visible = true @x = @style.x @y = @style.y @z = @style.z @old_width = 0 @old_height = 0 @width = 0 @height = 0 @style.width = default(:width) || nil @style.height = default(:height) || nil @style.background_canvas = Background.new @style.background_nine_slice_canvas = BackgroundNineSlice.new @style.background_image_canvas = BackgroundImage.new @style.border_canvas = BorderCanvas.new(element: self) @style_event = :default stylize default_events root.gui_state.request_focus(self) if @options[:autofocus] end def stylize set_static_position set_color set_font set_padding set_margin set_background set_background_nine_slice set_background_image set_border_thickness set_border_color root.gui_state.request_repaint end def safe_style_fetch(key, fallback_key = nil) # Attempt to return value for requested key v = @style.hash.dig(@style_event, key) return v if v # Attempt to return overriding value if fallback_key v = @style.hash.dig(@style_event, fallback_key) return v if v end # Fallback to default style @style.hash.dig(:default, key) || default(key) end def set_static_position @x = @style.x if @style.x != 0 @y = @style.y if @style.y != 0 end def set_color @style.color = safe_style_fetch(:color) @text&.color = @style.color end def set_font @text&.swap_font(safe_style_fetch(:text_size), safe_style_fetch(:font)) end def set_background @style.background = safe_style_fetch(:background) @style.background_canvas.background = @style.background end def set_background_nine_slice @style.background_nine_slice = safe_style_fetch(:background_nine_slice) @style.background_nine_slice_mode = safe_style_fetch(:background_nine_slice_mode) || :stretch @style.background_nine_slice_color = safe_style_fetch(:background_nine_slice_color) || Gosu::Color::WHITE @style.background_nine_slice_canvas.color = @style.background_nine_slice_color @style.background_nine_slice_from_edge = safe_style_fetch(:background_nine_slice_from_edge) @style.background_nine_slice_left = safe_style_fetch(:background_nine_slice_left, :background_nine_slice_from_edge) @style.background_nine_slice_top = safe_style_fetch(:background_nine_slice_top, :background_nine_slice_from_edge) @style.background_nine_slice_right = safe_style_fetch(:background_nine_slice_right, :background_nine_slice_from_edge) @style.background_nine_slice_bottom = safe_style_fetch(:background_nine_slice_bottom, :background_nine_slice_from_edge) end def set_background_image @style.background_image = safe_style_fetch(:background_image) @style.background_image_mode = safe_style_fetch(:background_image_mode) || :stretch @style.background_image_color = safe_style_fetch(:background_image_color) || Gosu::Color::WHITE @style.background_image_canvas.mode = @style.background_image_mode @style.background_image_canvas.color = @style.background_image_color end def set_border_thickness @style.border_thickness = safe_style_fetch(:border_thickness) @style.border_thickness_left = safe_style_fetch(:border_thickness_left, :border_thickness) @style.border_thickness_right = safe_style_fetch(:border_thickness_right, :border_thickness) @style.border_thickness_top = safe_style_fetch(:border_thickness_top, :border_thickness) @style.border_thickness_bottom = safe_style_fetch(:border_thickness_bottom, :border_thickness) end def set_border_color @style.border_color = safe_style_fetch(:border_color) @style.border_color_left = safe_style_fetch(:border_color_left, :border_color) @style.border_color_right = safe_style_fetch(:border_color_right, :border_color) @style.border_color_top = safe_style_fetch(:border_color_top, :border_color) @style.border_color_bottom = safe_style_fetch(:border_color_bottom, :border_color) @style.border_canvas.color = [ @style.border_color_top, @style.border_color_right, @style.border_color_bottom, @style.border_color_left ] end def set_padding @style.padding = safe_style_fetch(:padding) @style.padding_left = safe_style_fetch(:padding_left, :padding) @style.padding_right = safe_style_fetch(:padding_right, :padding) @style.padding_top = safe_style_fetch(:padding_top, :padding) @style.padding_bottom = safe_style_fetch(:padding_bottom, :padding) end def set_margin @style.margin = safe_style_fetch(:margin) @style.margin_left = safe_style_fetch(:margin_left, :margin) @style.margin_right = safe_style_fetch(:margin_right, :margin) @style.margin_top = safe_style_fetch(:margin_top, :margin) @style.margin_bottom = safe_style_fetch(:margin_bottom, :margin) end def update_styles(event = :default) old_width = width old_height = height @style_event = event return if self.is_a?(ToolTip) root.gui_state.request_recalculate if old_width != width || old_height != height stylize end def default_events %i[left middle right].each do |button| event(:"#{button}_mouse_button") event(:"released_#{button}_mouse_button") event(:"clicked_#{button}_mouse_button") event(:"holding_#{button}_mouse_button") end event(:mouse_wheel_up) event(:mouse_wheel_down) event(:scroll_jump_to_top) event(:scroll_jump_to_end) event(:scroll_page_up) event(:scroll_page_down) event(:enter) event(:hover) event(:leave) event(:focus) event(:blur) event(:changed) end def enter(_sender) @focus = false unless Gosu.button_down?(Gosu::MS_LEFT) if !@enabled update_styles(:disabled) elsif @focus update_styles(:active) else update_styles(:hover) end :handled end def left_mouse_button(_sender, _x, _y) @focus = true unless @enabled update_styles(:disabled) else update_styles(:active) end window.current_state.focus = self :handled end def released_left_mouse_button(sender, _x, _y) enter(sender) :handled end def clicked_left_mouse_button(_sender, _x, _y) @block&.call(self) if @enabled && !self.is_a?(Container) :handled end def leave(_sender) if @enabled update_styles else update_styles(:disabled) end :handled end def blur(_sender) @focus = false if @enabled update_styles else update_styles(:disabled) end :handled end def enabled=(boolean) root.gui_state.request_repaint if @enabled != boolean @enabled = boolean recalculate @enabled end def enabled? @enabled end def focused? @focus end def visible? @visible end def element_visible? @element_visible end def toggle @visible = !@visible root.gui_state.request_recalculate root.gui_state.request_repaint end def show bool = visible? @visible = true root.gui_state.request_recalculate unless bool root.gui_state.request_repaint unless bool end def hide bool = visible? @visible = false root.gui_state.request_recalculate if bool root.gui_state.request_repaint if bool end def draw return unless visible? return unless element_visible? @style.background_canvas.draw @style.background_nine_slice_canvas.draw @style.background_image_canvas.draw @style.border_canvas.draw render end def debug_draw return if CyberarmEngine.const_defined?("GUI_DEBUG_ONLY_ELEMENT") && self.class == GUI_DEBUG_ONLY_ELEMENT Gosu.draw_line( x, y, @debug_color, x + outer_width, y, @debug_color, Float::INFINITY ) Gosu.draw_line( x + outer_width, y, @debug_color, x + outer_width, y + outer_height, @debug_color, Float::INFINITY ) Gosu.draw_line( x + outer_width, y + outer_height, @debug_color, x, y + outer_height, @debug_color, Float::INFINITY ) Gosu.draw_line( x, y + outer_height, @debug_color, x, y, @debug_color, Float::INFINITY ) end def update recalculate_if_size_changed end def button_down(id) end def button_up(id) end def draggable?(_button) false end def render end def hit?(x, y) x.between?(@x, @x + width) && y.between?(@y, @y + height) end def width if visible? inner_width + @width else 0 end end def content_width @width end def noncontent_width (inner_width + outer_width) - width end def outer_width @style.margin_left + width + @style.margin_right end def inner_width (@style.border_thickness_left + @style.padding_left) + (@style.padding_right + @style.border_thickness_right) end def height if visible? inner_height + @height else 0 end end def content_height @height end def noncontent_height (inner_height + outer_height) - height end def outer_height @style.margin_top + height + @style.margin_bottom end def inner_height (@style.border_thickness_top + @style.padding_top) + (@style.padding_bottom + @style.border_thickness_bottom) end def scroll_width return @cached_scroll_width if @cached_scroll_width && is_a?(Container) @cached_scroll_width = @children.sum(&:outer_width) end def scroll_height return @cached_scroll_height if @cached_scroll_height && is_a?(Container) if is_a?(CyberarmEngine::Element::Flow) return 0 if @children.size.zero? pairs_ = [] sorted_children_ = @children.sort_by(&:y) a_ = [] y_position_ = sorted_children_.first.y sorted_children_.each do |child| unless child.y == y_position_ y_position_ = child.y pairs_ << a_ a_ = [] end a_ << child end pairs_ << a_ unless pairs_.last == a_ @cached_scroll_height = pairs_.sum { |pair| + @style.padding_top + @style.border_thickness_top + pair.map(&:outer_height).max } + @style.padding_bottom + @style.border_thickness_bottom else @cached_scroll_height = @style.padding_top + @style.border_thickness_top + @children.sum(&:outer_height) + @style.padding_bottom + @style.border_thickness_bottom end end def max_scroll_width (scroll_width - outer_width).positive? ? scroll_width - outer_width : scroll_width end def max_scroll_height (scroll_height - outer_height).positive? ? scroll_height - outer_height : scroll_height end def dimensional_size(size, dimension) raise "dimension must be either :width or :height" unless %i[width height].include?(dimension) new_size = if size.is_a?(Float) && size.between?(0.0, 1.0) (@parent.send(:"content_#{dimension}") * size).floor - send(:"noncontent_#{dimension}").floor else size end # Handle fill behavior if @parent && @style.fill && (dimension == :width && @parent.is_a?(Flow) || dimension == :height && @parent.is_a?(Stack)) new_size = space_available_width - noncontent_width if dimension == :width && @parent.is_a?(Flow) new_size = space_available_height - noncontent_height if dimension == :height && @parent.is_a?(Stack) end return @style.send(:"min_#{dimension}") if @style.send(:"min_#{dimension}") && new_size.to_f < @style.send(:"min_#{dimension}") return @style.send(:"max_#{dimension}") if @style.send(:"max_#{dimension}") && new_size.to_f > @style.send(:"max_#{dimension}") new_size end def space_available_width # TODO: This may get expensive if there are a lot of children, probably should cache it somehow fill_siblings = @parent.children.select { |c| c.style.fill }.count.to_f # include self since we're dividing available_space = ((@parent.content_width - (@parent.children.reject { |c| c.style.fill }).map(&:outer_width).sum) / fill_siblings) (available_space.nan? || available_space.infinite?) ? 0 : available_space.floor # The parent element might not have its dimensions, yet. end def space_available_height # TODO: This may get expensive if there are a lot of children, probably should cache it somehow fill_siblings = @parent.children.select { |c| c.style.fill }.count.to_f # include self since we're dividing available_space = ((@parent.content_height - (@parent.children.reject { |c| c.style.fill }).map(&:outer_height).sum) / fill_siblings) (available_space.nan? || available_space.infinite?) ? 0 : available_space.floor # The parent element might not have its dimensions, yet. end def background=(_background) root.gui_state.request_repaint @style.background_canvas.background = _background update_background end def update_background @style.background_canvas.x = @x @style.background_canvas.y = @y @style.background_canvas.z = @z @style.background_canvas.width = width @style.background_canvas.height = height @style.background_canvas.update update_background_nine_slice update_background_image @style.border_canvas.update end def background_nine_slice=(_image_path) root.gui_state.request_repaint @style.background_nine_slice_canvas.image = _image_path update_background_nine_slice end def update_background_nine_slice @style.background_nine_slice_canvas.x = @x @style.background_nine_slice_canvas.y = @y @style.background_nine_slice_canvas.z = @z @style.background_nine_slice_canvas.width = width @style.background_nine_slice_canvas.height = height @style.background_nine_slice_canvas.mode = @style.background_nine_slice_mode @style.background_nine_slice_canvas.color = @style.background_nine_slice_color @style.background_nine_slice_canvas.left = @style.background_nine_slice_left @style.background_nine_slice_canvas.top = @style.background_nine_slice_top @style.background_nine_slice_canvas.right = @style.background_nine_slice_right @style.background_nine_slice_canvas.bottom = @style.background_nine_slice_bottom @style.background_nine_slice_canvas.image = @style.background_nine_slice end def background_image=(image_path) root.gui_state.request_repaint @style.background_image = image_path.is_a?(Gosu::Image) ? image_path : get_image(image_path) update_background_image end def update_background_image @style.background_image_canvas.x = @x @style.background_image_canvas.y = @y @style.background_image_canvas.z = @z @style.background_image_canvas.width = width @style.background_image_canvas.height = height @style.background_image_canvas.mode = @style.background_image_mode @style.background_image_canvas.color = @style.background_image_color @style.background_image_canvas.image = @style.background_image end def recalculate_if_size_changed if @parent && !is_a?(ToolTip) && (@old_width != width || @old_height != height) root.gui_state.request_recalculate @old_width = width @old_height = height end end def root return self if is_root? unless @root && @root.parent.nil? @root = parent loop do break unless @root&.parent @root = @root.parent end end @root end def is_root? @gui_state != nil end def child_of?(element) return element == self if is_root? return false unless element.is_a?(Container) return true if element.children.find { |child| child == self } element.children.find { |child| child.child_of?(element) if child.is_a?(Container) } end def parent_of?(element) return false if element == self return false unless is_a?(Container) return true if @children.find { |child| child == element } @children.find { |child| child.parent_of?(element) if child.is_a?(Container) } end def focus(_) warn "#{self.class}#focus was not overridden!" :handled end def recalculate old_width = width old_height = height stylize layout root.gui_state.request_recalculate if @parent && !is_a?(ToolTip) && (width != old_width || height != old_height) root.gui_state.request_repaint if width != old_width || height != old_height root.gui_state.menu.recalculate if root.gui_state.menu && root.gui_state.menu.parent == self end def layout end def reposition end def value raise "#{self.class}#value was not overridden!" end def value=(_value) raise "#{self.class}#value= was not overridden!" end def to_s "#{self.class} x=#{x} y=#{y} width=#{width} height=#{height} value=#{value.is_a?(String) ? "\"#{value}\"" : value}" end def inspect to_s end end end