/// <summary> /// Provides high-level validation looking for obvious syntactic errors, throwing /// ArgumentException if found. Note that just because a string passes this function, /// that doesn't guarantee that it will work when used on a part module. That's /// because *real* validation needs the module as input, so it can hunt for fields, /// other modules, etc. This function's validation only covers the *syntax*, not /// the content. /// </summary> /// <param name="sourceID"></param> public static void Validate(string sourceID) { if (string.IsNullOrEmpty(sourceID)) { throw new ArgumentException("Null or empty color source"); } // Maybe it's a color string. if (Colors.IsColorString(sourceID)) { return; } // Is it a parameterized source? if (ParsedParameters.TryParse(sourceID) != null) { return; } // Is it an identifier? (e.g. module or field name) if (Identifiers.IsSimpleIdentifier(sourceID)) { return; } // Could it be a numeric value? try { double.Parse(sourceID); return; } catch (FormatException) { // nope, not a number } // If we made it this far, it doesn't appear to be syntactically valid. throw new ArgumentException("Invalid color source syntax: " + sourceID); }
/// <summary> /// Given a color source ID (which might be a literal color, the ID of a controller, /// or a parameterized source), try to find the appropriate source. If it can't /// be parsed or found, throws a ColorSourceException. private static IColorSource FindPrivate(PartModule module, string sourceID) { if (string.IsNullOrEmpty(sourceID)) { throw new ColorSourceException(module, "Null or empty color source"); } // Maybe it's a color string. if (Colors.IsColorString(sourceID)) { return(Constant(Colors.Parse(sourceID, Color.black))); } // Is it a parameterized source? ParsedParameters parsedParams = ParsedParameters.TryParse(sourceID); if (parsedParams != null) { // It has the right syntax for a parameterizeed source. Do we recognize it? for (int i = 0; i < PARSEABLE_SOURCES.Length; ++i) { IColorSource candidate = PARSEABLE_SOURCES[i](module, parsedParams); if (candidate != null) { return(candidate); } } throw new ColorSourceException(module, "Unknown function type '" + parsedParams.Identifier + "'"); } // Maybe it's another field on the module? for (int i = 0; i < module.Fields.Count; ++i) { BaseField field = module.Fields[i]; if (!sourceID.Equals(field.name)) { continue; } if (!ColorSourceIDField.Is(field)) { throw new ColorSourceException( module, sourceID + " field on " + module.ClassName + " of " + module.part.GetTitle() + " is not a color source ID field"); } return(Find(module, field.GetValue <string>(module))); } // Maybe it's a module on the part? for (int i = 0; i < module.part.Modules.Count; ++i) { IColorSource candidate = module.part.Modules[i] as IColorSource; if (candidate == null) { continue; } if (sourceID.Equals(candidate.ColorSourceID)) { return(candidate); } } // not found throw new ColorSourceException(module, "Can't find a color source named '" + sourceID + "'"); }