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
136
137
138
139
140
141
142
143
144
145
146
147
|
module FelFlame
class Entities
# Creating a new Entity
# @param components [Components] Can be any number of components, identical duplicates will be automatically purged however different components from the same component manager are allowed.
# @return [Entity]
def initialize(*components)
# Add each component
add(*components)
# Fancy method redirection for when the `component` method is called
@component_redirect = Object.new
@component_redirect.instance_variable_set(:@entity, self)
@component_redirect.define_singleton_method(:[]) do |component_manager|
instance_variable_get(:@entity).component(component_manager)
end
self.class._data.push self
end
# A hash that uses component manager constant names as keys, and where the values of those keys are arrays that contain the the components attached to this entity.
# @return [Hash<Component_Manager, Array<Integer>>]
def components
@components ||= {}
end
# A single component from a component manager. Use this if you expect the component to only belong to one entity and you want to access it. Access the component using either parameter notation or array notation.
# @example
# @entity.component[@component_manager] # array notation
# @entity.component(@component_manager) # method notation
# @param manager [ComponentManager] If you pass nil you can then use array notation to access the same value.
# @return [Component]
def component(manager = nil)
if manager.nil?
@component_redirect
else
if components[manager].nil?
raise "This entity(#{self}) doesnt have any components of this type: #{manager}"
elsif components[manager].length > 1
Warning.warn("This entity has MANY of this component but you called the method that is intended for having a single of this component type.\nYou may have a bug in your logic.")
end
components[manager].first
end
end
# Removes this Entity from the list and purges all references to this Entity from other Components, as well as its data.
# @return [Boolean] +true+
def delete
components.each do |component_manager, component_array|
component_array.reverse_each do |component|
component.entities.delete(self)
end
end
FelFlame::Entities._data.delete self
@components = {}
true
end
# Add any number components to the Entity.
# @param components_to_add [Component] Any number of components created from any component manager
# @return [Boolean] +true+
def add(*components_to_add)
components_to_add.each do |component|
if components[component.class].nil?
components[component.class] = [component]
component.entities.push self
check_systems component, :addition_triggers
elsif !components[component.class].include? component
components[component.class].push component
component.entities.push self
check_systems component, :addition_triggers
end
end
true
end
# triggers every system associated with this component's trigger
# @return [Boolean] +true+
# @!visibility private
def check_systems(component, trigger_type)
component_calls = component.class.send(trigger_type)
component.send(trigger_type).each do |system|
component_calls |= [system]
end
component_calls.sort_by(&:priority).reverse.each(&:call)
true
end
# Remove a component from the Entity
# @param components_to_remove [Component] A component created from any component manager
# @return [Boolean] +true+
def remove(*components_to_remove)
components_to_remove.each do |component|
check_systems component, :removal_triggers if component.entities.include? self
component.entities.delete self
components[component.class].delete component
if components[component.class].empty?
components.delete component.class
end
end
true
end
# Export all data into a JSON String which can then be saved into a file
# TODO: This function is not yet complete
# @return [String] A JSON formatted String
#def to_json() end
class <<self
# Makes component managers behave like arrays with additional
# methods for managing the array
# @!visibility private
def respond_to_missing?(method, *)
if self._data.respond_to? method
true
else
super
end
end
# Makes component managers behave like arrays with additional
# methods for managing the array
# @!visibility private
def method_missing(method, *args, **kwargs, &block)
if self._data.respond_to? method
self._data.send(method, *args, **kwargs, &block)
else
super
end
end
# @return [Array<Entity>] Array of all Entities that exist
# @!visibility private
def _data
@data ||= []
end
# Creates a new entity using the data from a JSON string
# TODO: This function is not yet complete
# @param json_string [String] A string that was exported originally using the {FelFlame::Entities#to_json to_json} function
# @param opts [Keywords] What values(its {FelFlame::Entities#id ID} or the {FelFlame::ComponentManager#id component IDs}) should be overwritten TODO: this might change
#def from_json(json_string, **opts) end
end
end
end
|
