1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
#require 'app/ECS/base_component.rb'
#require 'app/ECS/components/00_test_component.rb'
#require 'app/ECS/components/01_based.rb'
class FelFlame
class Components
@component_map = []
class <<self
include Enumerable
# Creates a new component manager.
#
# @param component_name [String] Name of your new component manager. Must be stylized in the format of constants in Ruby
# @param attrs [:Symbols] New components made with this manager will include these symbols as accessors, the values of these accessors will default to nil
# @param attrs_with_defaults [Keywords] New components made with this manager will include these keywords as accessors, their defaults set to the values given to the keywords
def new(component_name, *attrs, **attrs_with_defaults)
const_set(component_name, Class.new(FelFlame::Helper::ComponentManagerTemplate) {})
attrs.each do |attr|
FelFlame::Components.const_get(component_name).attr_accessor attr
end
attrs_with_defaults.each do |attr, _default|
FelFlame::Components.const_get(component_name).attr_accessor attr
end
FelFlame::Components.const_get(component_name).define_method(:initialize) do
attrs_with_defaults.each do |attr, default|
instance_variable_set("@#{attr}", default)
end
end
end
# Iterate over all existing component managers. You also call other enumerable methods instead of each, such as `each_with_index` or `select`
# @return [Enumerator]
def each(&block)
constants.each(&block)
end
end
end
# Namespace for helper functions and inheritance classes
class Helper
# Component Managers are what is used to create individual components which can be attached to entities.
# When a Component is created from a Component Manager that has accessors given to it, you can set or get the values of those accessors using standard ruby message sending (e.g `@component.var = 5`), or by using the {#attrs} and {#update_attrs} methods instead.
class ComponentManagerTemplate
# Holds the {id unique ID} of a component. The {id ID} is only unique within the scope of the component manager it was created from.
attr_accessor :id
class <<self
# @return [Array] Array of all Components that belong to a given component manager
# @!visibility private
def data
@data ||= []
end
# Gets a Component from the given {id unique ID}. Usage is simular to how an Array lookup works.
# @param component_id [Integer]
# @return [Component] Returns the Component that uses the given unique {id ID}, nil if there is no Component associated with the given {id ID}
def [](component_id)
data[component_id]
end
# Creates a new component and sets the values of the attributes given to it. If an attritbute is not passed then it will remain as the default.
def new(**attrs)
new_component = super
# Generate ID
new_id = self.data.find_index { |i| i.nil? }
new_id = self.data.size if new_id.nil?
new_component.id = new_id
# Fill params
attrs.each do |key, value|
new_component.send "#{key}=", value
end
# Save Component
data[new_id] = new_component
end
# Iterates over all components within the component manager
# @return [Enumerator]
def each
data.each do |component|
yield component
end
end
end
# An alias for the ID reader
# @return [Integer]
def to_i
id
end
# A list of components that are linked to the component
# @return [Array]
def linked_entities
@linked_entities ||= []
end
# Update attribute values using a hash or keywords.
# @return Hash of updated attributes
def update_attrs(**opts)
opts.each do |key, value|
send "#{key}=", value
end
end
# Removes this component from the list and purges all references to this Component from other Entities, as well as its {id ID} and data.
# @return [Boolean] true.
def delete
linked_entities.each do |entity_id|
FelFlame::Entities[entity_id].remove self
end
self.class.data[id] = nil
@linked_entities = nil
instance_variables.each do |var|
instance_variable_set(var, nil)
end
true
end
# @return [Hash] Returns a hash, where all the keys are attributes linked to their respective values.
def attrs
instance_variables.each_with_object({}) do |key, final|
final[key.to_s.delete_prefix('@').to_sym] = instance_variable_get(key)
end
end
# Export all data into a JSON String, which could then later be loaded or saved to a file
# TODO: This function is not yet complete
# @return [String] a JSON formatted String
def to_json
# should return a json or hash of all data in this component
end
end
end
end
|
