ProcessorParameter.cs

// MonoGame - Copyright (C) MonoGame Foundation, Inc
// This file is subject to the terms and conditions defined in
// file 'LICENSE.txt', which is part of this source code package.

using System.Collections.ObjectModel;
using System.Reflection;

namespace Microsoft.Xna.Framework.Content.Pipeline
{
    /// <summary>
    /// Represents a processor parameter. Processor parameters are automatically discovered by the content pipeline. Therefore, only custom processor developers should use this class directly.
    /// </summary>
    [Serializable]
    public sealed class ProcessorParameter
    {
        private PropertyInfo _propInfo;

        /// <summary>
        /// Constructs a ProcessorParameter instance.
        /// </summary>
        /// <param name="propertyInfo">The info for the property.</param>
        internal ProcessorParameter(PropertyInfo propertyInfo)
        {
            _propInfo = propertyInfo;
            if (_propInfo.PropertyType.IsEnum)
                PossibleEnumValues = new ReadOnlyCollection<string>(_propInfo.PropertyType.GetEnumNames());
        }

        /// <summary>
        /// Default value of the processor parameter.
        /// </summary>
        public object? DefaultValue { get; set; }

        /// <summary>
        /// Description of the parameter, as specified by the [Description] attribute.
        /// </summary>
        public string Description { get; set; } = "";

        /// <summary>
        /// Name of the parameter displayed in the designer, as specified by the [DisplayName] attribute.
        /// </summary>
        public string DisplayName { get; set; } = "";

        /// <summary>
        /// Gets a value indicating whether the parameter is an enumeration.
        /// </summary>
        public bool IsEnum => PossibleEnumValues != null;

        /// <summary>
        /// Available options for enumerated type parameters. For parameters of other types, this value is null.
        /// </summary>
        public ReadOnlyCollection<string>? PossibleEnumValues { get; }

        /// <summary>
        /// Name of the property, as defined in the C# code.
        /// </summary>
        public string PropertyName => _propInfo.Name;

        /// <summary>
        /// Type of the parameter.
        /// </summary>
        public string PropertyType => _propInfo.PropertyType.Name;
    }
}