#region ================== Copyright (c) 2007 Pascal vd Heiden /* * Copyright (c) 2007 Pascal vd Heiden, www.codeimp.com * This program is released under GNU General Public License * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * */ #endregion #region ================== Namespaces using System; using System.Collections.Generic; using System.Globalization; using System.IO; #endregion namespace CodeImp.DoomBuilder.ZDoom { public sealed class DecorateParser : ZDTextParser { #region ================== Delegates public delegate void IncludeDelegate(DecorateParser parser, string includefile); public IncludeDelegate OnInclude; #endregion #region ================== Constants #endregion #region ================== Variables // These are actors we want to keep private Dictionary actors; // These are all parsed actors, also those from other games private Dictionary archivedactors; //mxd. Includes tracking private readonly HashSet parsedlumps; #endregion #region ================== Properties /// /// All actors that are supported by the current game. /// public ICollection Actors { get { return actors.Values; } } /// /// All actors defined in the loaded DECORATE structures. This includes actors not supported in the current game. /// public ICollection AllActors { get { return archivedactors.Values; } } /// /// mxd. All actors that are supported by the current game. /// internal Dictionary ActorsByClass { get { return actors; } } /// /// mxd. All actors defined in the loaded DECORATE structures. This includes actors not supported in the current game. /// internal Dictionary AllActorsByClass { get { return archivedactors; } } #endregion #region ================== Constructor / Disposer // Constructor public DecorateParser() { // Syntax whitespace = "\n \t\r\u00A0"; //mxd. non-breaking space is also space :) specialtokens = ":{}+-\n;,"; // Initialize actors = new Dictionary(StringComparer.Ordinal); archivedactors = new Dictionary(StringComparer.Ordinal); parsedlumps = new HashSet(StringComparer.OrdinalIgnoreCase); //mxd } // Disposer public void Dispose() { foreach(KeyValuePair a in archivedactors) a.Value.Dispose(); actors = null; archivedactors = null; } #endregion #region ================== Parsing // This parses the given decorate stream // Returns false on errors public override bool Parse(Stream stream, string sourcefilename, bool clearerrors) { if(!base.Parse(stream, sourcefilename, clearerrors)) return false; // Keep local data Stream localstream = datastream; string localsourcename = sourcename; BinaryReader localreader = datareader; // Continue until at the end of the stream while(SkipWhitespace(true)) { // Read a token string objdeclaration = ReadToken(); if(!string.IsNullOrEmpty(objdeclaration)) { objdeclaration = objdeclaration.ToLowerInvariant(); switch(objdeclaration) { case "actor": { // Read actor structure ActorStructure actor = new ActorStructure(this); if(this.HasError) return false; // Add the actor archivedactors[actor.ClassName.ToLowerInvariant()] = actor; if(actor.CheckActorSupported()) actors[actor.ClassName.ToLowerInvariant()] = actor; // Replace an actor? if(actor.ReplacesClass != null) { if(GetArchivedActorByName(actor.ReplacesClass) != null) archivedactors[actor.ReplacesClass.ToLowerInvariant()] = actor; else LogWarning("Unable to find '" + actor.ReplacesClass + "' class to replace, while parsing '" + actor.ClassName + "'"); if(actor.CheckActorSupported() && GetActorByName(actor.ReplacesClass) != null) actors[actor.ReplacesClass.ToLowerInvariant()] = actor; } } break; case "#include": { //INFO: ZDoom DECORATE include paths can't be relative ("../actor.txt") //or absolute ("d:/project/actor.txt") //or have backward slashes ("info\actor.txt") //include paths are relative to the first parsed entry, not the current one //also include paths may or may not be quoted SkipWhitespace(true); string filename = StripTokenQuotes(ReadToken(false)); //mxd. Don't skip newline //mxd. Sanity checks if(string.IsNullOrEmpty(filename)) { ReportError("Expected file name to include"); return false; } //mxd. Check invalid path chars if (!CheckInvalidPathChars(filename)) return false; //mxd. Absolute paths are not supported... if (Path.IsPathRooted(filename)) { ReportError("Absolute include paths are not supported by ZDoom"); return false; } //mxd. Relative paths are not supported if(filename.StartsWith(RELATIVE_PATH_MARKER) || filename.StartsWith(CURRENT_FOLDER_PATH_MARKER) || filename.StartsWith(ALT_RELATIVE_PATH_MARKER) || filename.StartsWith(ALT_CURRENT_FOLDER_PATH_MARKER)) { ReportError("Relative include paths are not supported by ZDoom"); return false; } //mxd. Backward slashes are not supported if(filename.Contains(Path.DirectorySeparatorChar.ToString(CultureInfo.InvariantCulture))) { ReportError("Only forward slashes are supported by ZDoom"); return false; } //mxd. Already parsed? if(parsedlumps.Contains(filename)) { ReportError("Already parsed '" + filename + "'. Check your include directives"); return false; } //mxd. Add to collection parsedlumps.Add(filename); // Callback to parse this file now if(OnInclude != null) OnInclude(this, filename); //mxd. Bail out on error if(this.HasError) return false; // Set our buffers back to continue parsing datastream = localstream; datareader = localreader; sourcename = localsourcename; } break; case "enum": case "native": case "const": while(SkipWhitespace(true)) { string t = ReadToken(); if(string.IsNullOrEmpty(t) || t == ";") break; } break; case "$gzdb_skip": break; default: { // Unknown structure! // Best we can do now is just find the first { and then // follow the scopes until the matching } is found string token2; do { if(!SkipWhitespace(true)) break; token2 = ReadToken(); if(string.IsNullOrEmpty(token2)) break; } while(token2 != "{"); int scopelevel = 1; do { if(!SkipWhitespace(true)) break; token2 = ReadToken(); if(string.IsNullOrEmpty(token2)) break; if(token2 == "{") scopelevel++; if(token2 == "}") scopelevel--; } while(scopelevel > 0); } break; } } } // Return true when no errors occurred return (ErrorDescription == null); } #endregion #region ================== Methods /// /// This returns a supported actor by name. Returns null when no supported actor with the specified name can be found. This operation is of O(1) complexity. /// public ActorStructure GetActorByName(string name) { name = name.ToLowerInvariant(); return actors.ContainsKey(name) ? actors[name] : null; } /// /// This returns a supported actor by DoomEdNum. Returns null when no supported actor with the specified name can be found. Please note that this operation is of O(n) complexity! /// public ActorStructure GetActorByDoomEdNum(int doomednum) { foreach(ActorStructure a in actors.Values) if(a.DoomEdNum == doomednum) return a; return null; } // This returns an actor by name // Returns null when actor cannot be found internal ActorStructure GetArchivedActorByName(string name) { name = name.ToLowerInvariant(); return (archivedactors.ContainsKey(name) ? archivedactors[name] : null); } //mxd protected override string GetLanguageType() { return "DECORATE"; } #endregion } }