ntwain/NTwain/Triplets/DGImage/DGImage.GrayResponse.cs

using NTwain.Data;
using NTwain.Internals;

namespace NTwain.Triplets
{
    /// <summary>
    /// Represents <see cref="DataArgumentType.GrayResponse"/>.
    /// </summary>
	public sealed class GrayResponse : OpBase
	{
		internal GrayResponse(ITwainSessionInternal session) : base(session) { }

		/// <summary>
		/// The Reset operation causes the Source to use its "identity response curve." The identity
		/// curve causes no change in the values of the captured data when it is applied.
		/// </summary>
		/// <param name="response">The response.</param>
		/// <returns></returns>
        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1021:AvoidOutParameters", MessageId = "0#")]
        public ReturnCode Reset(out TWGrayResponse response)
		{
			Session.VerifyState(4, 4, DataGroups.Image, DataArgumentType.GrayResponse, Message.Reset);
			response = new TWGrayResponse();
			return Dsm.DsmEntry(Session.AppId, Session.CurrentSource.Identity, Message.Reset, response);
		}

		/// <summary>
		/// This operation causes the Source to transform any grayscale data according to the response
		/// curve specified.
		/// </summary>
		/// <param name="response">The response.</param>
		/// <returns></returns>
		public ReturnCode Set(TWGrayResponse response)
		{
			Session.VerifyState(4, 4, DataGroups.Image, DataArgumentType.GrayResponse, Message.Set);
			return Dsm.DsmEntry(Session.AppId, Session.CurrentSource.Identity, Message.Set, response);
		}
	}
}