/// <summary>
/// Performs Set negation between this DrawableSet and the DrawabelSet specified in the parameter. While
/// two sets should never share the same GameDrawableInstance, they may share the same IGameDrawable which would
/// be wrapped by an GameDrawableInstance. If the DrawableSet specified in the parameter contains IGameDrawables
/// within the same state as this DrawableSet, then associated GameDrawableInstance's are removed.
/// </summary>
public void Remove(DrawableSet drawableSet)
{
foreach (string state in drawableSet.GetStates())
{
foreach (GameDrawableInstance instance in drawableSet.GetByState(state))
{
Remove(instance.Drawable, state);
}
}
}
/// <summary>
/// Performs a Set union operation between this DrawableSet and the DrawableSet specified in the parameter.
/// It is important to note that any IGameDrawables newly created in this DrawableSet are wrapped around a
/// *new* GameDrawableInstance in order to allow properties to be set independently for each one.
/// </summary>
public void Union(DrawableSet drawableSet)
{
foreach (string state in drawableSet.GetStates())
{
foreach (GameDrawableInstance instance in drawableSet.GetByState(state))
{
GameDrawableInstance copiedInstance = Add(state, instance.Drawable, instance._associatedGroup);
copiedInstance.Layer = instance.Layer;
copiedInstance.Offset = instance.Offset;
copiedInstance.Rotation = instance.Rotation;
copiedInstance.Visible = instance.Visible;
}
}
}
/// <summary>
/// Loads a DrawableSet file into a specified DrawableSet object.
/// The method requires the string path to the xml file containing the drawable data and a reference to the
/// ContentManager. An optional Layer value can be specified for the ordering of the drawables in the
/// DrawableSet. Currently only supports loading of Animation objects.
/// </summary>
/// <param name="drawableSet">DrawableSet object to load the animations into.</param>
/// <param name="path">String path to the XML formatted .anim file</param>
/// <param name="content">Reference to the ContentManager instance being used in the application</param>
public static void LoadDrawableSetXml(DrawableSet drawableSet, string path, ContentManager content, double startTimeMS = 0)
{
XmlDocument document = new XmlDocument();
document.Load(path);
foreach (XmlNode animNode in document.SelectNodes("Animations/Animation"))
{
int frameDelay = XmlExtensions.GetAttributeValue<int>(animNode, "FrameDelay", 90);
bool loop = XmlExtensions.GetAttributeValue<bool>(animNode, "Loop", true);
int layer = XmlExtensions.GetAttributeValue<int>(animNode, "Layer", 0);
string state = XmlExtensions.GetAttributeValue(animNode, "State");
string group = XmlExtensions.GetAttributeValue(animNode, "Group", "");
string spriteSheet = XmlExtensions.GetAttributeValue(animNode, "SpriteSheet");
string[] offset = XmlExtensions.GetAttributeValue(animNode, "Offset", "0, 0").Split(',');
string[] origin = XmlExtensions.GetAttributeValue(animNode, "Origin", "0.5, 1.0").Split(',');
Vector2 offsetVector = new Vector2((float)Convert.ToDouble(offset[0]), (float)Convert.ToDouble(offset[1]));
Vector2 originVector = new Vector2((float)Convert.ToDouble(origin[0]), (float)Convert.ToDouble(origin[1]));
XmlNodeList frameNodes = animNode.SelectNodes("Frames/Frame");
Rectangle[] frames = new Rectangle[frameNodes.Count];
for (int i = 0; i < frameNodes.Count; i++)
{
string[] tokens = frameNodes[i].InnerText.Split(',');
if (tokens.Length != 4)
throw new FormatException("Expected 4 Values for Frame Definition: X, Y, Width, Height");
int x = Convert.ToInt32(tokens[0]);
int y = Convert.ToInt32(tokens[1]);
int width = Convert.ToInt32(tokens[2]);
int height = Convert.ToInt32(tokens[3]);
frames[i] = new Rectangle(x, y, width, height);
}
Animation animation = new Animation(content.Load<Texture2D>(spriteSheet), frames, frameDelay, loop);
animation.Origin = originVector;
// TODO: Requires possible revision of code.
// Allow support for specifying glob patterns in the case of state names.
if (state.Contains("*"))
{
// Use Glob patterns in favour of regular expressions.
state = Regex.Escape(state).Replace(@"\*", ".*").Replace(@"\?", ".");
Regex regexMatcher = new Regex(state);
foreach (string drawableSetState in drawableSet.GetStates())
{
if (regexMatcher.IsMatch(drawableSetState))
{
GameDrawableInstance instance = drawableSet.Add(drawableSetState, animation, group);
instance.StartTimeMS = startTimeMS;
instance.Layer = layer;
instance.Offset = offsetVector;
}
}
}
else
{
GameDrawableInstance instance = drawableSet.Add(state, animation, group);
instance.StartTimeMS = startTimeMS;
instance.Layer = layer;
instance.Offset = offsetVector;
}
}
}
/// <summary>
/// Performs a Set union operation between this DrawableSet and the DrawableSet specified in the parameter.
/// It is important to note that any IGameDrawables newly created in this DrawableSet are wrapped around a
/// *new* GameDrawableInstance in order to allow properties to be set independently for each one.
/// </summary>
public void Union(DrawableSet drawableSet)
{
foreach (string state in drawableSet.GetStates())
{
foreach (GameDrawableInstance instance in drawableSet.GetByState(state))
{
GameDrawableInstance copiedInstance = Add(state, instance.Drawable, instance._associatedGroup);
copiedInstance.Layer = instance.Layer;
copiedInstance.Offset = instance.Offset;
copiedInstance.Rotation = instance.Rotation;
copiedInstance.Visible = instance.Visible;
}
}
}
/// <summary>
/// Performs Set negation between this DrawableSet and the DrawabelSet specified in the parameter. While
/// two sets should never share the same GameDrawableInstance, they may share the same IGameDrawable which would
/// be wrapped by an GameDrawableInstance. If the DrawableSet specified in the parameter contains IGameDrawables
/// within the same state as this DrawableSet, then associated GameDrawableInstance's are removed.
/// </summary>
public void Remove(DrawableSet drawableSet)
{
foreach (string state in drawableSet.GetStates())
foreach (GameDrawableInstance instance in drawableSet.GetByState(state))
Remove(instance.Drawable, state);
}
/// <summary>
/// Loads a DrawableSet file into a specified DrawableSet object.
/// The method requires the string path to the xml file containing the drawable data and a reference to the
/// ContentManager. An optional Layer value can be specified for the ordering of the drawables in the
/// DrawableSet. Currently only supports loading of Animation objects.
/// </summary>
/// <param name="drawableSet">DrawableSet object to load the animations into.</param>
/// <param name="path">String path to the XML formatted .anim file</param>
/// <param name="content">Reference to the ContentManager instance being used in the application</param>
public static void LoadDrawableSetXml(DrawableSet drawableSet, string path, ContentManager content, double startTimeMS = 0)
{
XmlDocument document = new XmlDocument();
document.Load(path);
foreach (XmlNode animNode in document.SelectNodes("Animations/Animation"))
{
int frameDelay = XmlExtensions.GetAttributeValue <int>(animNode, "FrameDelay", 90);
bool loop = XmlExtensions.GetAttributeValue <bool>(animNode, "Loop", true);
int layer = XmlExtensions.GetAttributeValue <int>(animNode, "Layer", 0);
string state = XmlExtensions.GetAttributeValue(animNode, "State");
string group = XmlExtensions.GetAttributeValue(animNode, "Group", "");
string spriteSheet = XmlExtensions.GetAttributeValue(animNode, "SpriteSheet");
string[] offset = XmlExtensions.GetAttributeValue(animNode, "Offset", "0, 0").Split(',');
string[] origin = XmlExtensions.GetAttributeValue(animNode, "Origin", "0.5, 1.0").Split(',');
Vector2 offsetVector = new Vector2((float)Convert.ToDouble(offset[0]), (float)Convert.ToDouble(offset[1]));
Vector2 originVector = new Vector2((float)Convert.ToDouble(origin[0]), (float)Convert.ToDouble(origin[1]));
XmlNodeList frameNodes = animNode.SelectNodes("Frames/Frame");
Rectangle[] frames = new Rectangle[frameNodes.Count];
for (int i = 0; i < frameNodes.Count; i++)
{
string[] tokens = frameNodes[i].InnerText.Split(',');
if (tokens.Length != 4)
{
throw new FormatException("Expected 4 Values for Frame Definition: X, Y, Width, Height");
}
int x = Convert.ToInt32(tokens[0]);
int y = Convert.ToInt32(tokens[1]);
int width = Convert.ToInt32(tokens[2]);
int height = Convert.ToInt32(tokens[3]);
frames[i] = new Rectangle(x, y, width, height);
}
Animation animation = new Animation(content.Load <Texture2D>(spriteSheet), frames, frameDelay, loop);
animation.Origin = originVector;
// TODO: Requires possible revision of code.
// Allow support for specifying glob patterns in the case of state names.
if (state.Contains("*"))
{
// Use Glob patterns in favour of regular expressions.
state = Regex.Escape(state).Replace(@"\*", ".*").Replace(@"\?", ".");
Regex regexMatcher = new Regex(state);
foreach (string drawableSetState in drawableSet.GetStates())
{
if (regexMatcher.IsMatch(drawableSetState))
{
GameDrawableInstance instance = drawableSet.Add(drawableSetState, animation, group);
instance.StartTimeMS = startTimeMS;
instance.Layer = layer;
instance.Offset = offsetVector;
}
}
}
else
{
GameDrawableInstance instance = drawableSet.Add(state, animation, group);
instance.StartTimeMS = startTimeMS;
instance.Layer = layer;
instance.Offset = offsetVector;
}
}
}