// The project, which uses this code, must have references to the following assemblies:
// - Vintasoft.Twain

namespace TwainExamples_CSharp
{
    public partial class How_to_process_acquired_image : System.Windows.Forms.Form
    {

        /// <summary>
        /// TWAIN device manager.
        /// </summary>
        Vintasoft.Twain.DeviceManager _deviceManager;



        public How_to_process_acquired_image()
        {
            InitializeComponent();

            // create and open device manager
            _deviceManager = new Vintasoft.Twain.DeviceManager(this);
            _deviceManager.Open();
        }



        /// <summary>
        /// Acquire images asynchronously.
        /// </summary>
        public void AcquireImagesAsynchronously()
        {
            try
            {
                // get reference to the default device
                Vintasoft.Twain.Device device = _deviceManager.DefaultDevice;

                // subscribe to the device events
                device.ImageAcquired += new System.EventHandler<Vintasoft.Twain.ImageAcquiredEventArgs>(device_ImageAcquired);
                device.ScanCanceled += new System.EventHandler(device_ScanCanceled);
                device.ScanFailed += new System.EventHandler<Vintasoft.Twain.ScanFailedEventArgs>(device_ScanFailed);
                device.ScanFinished += new System.EventHandler(device_ScanFinished);

                // set scanning settings
                device.TransferMode = Vintasoft.Twain.TransferMode.Memory;
                device.ShowUI = false;

                // acquire images asynchronously
                device.Acquire();
            }
            catch (Vintasoft.Twain.TwainException ex)
            {
                System.Windows.Forms.MessageBox.Show(ex.Message);
            }
        }

        /// <summary>
        /// Image is acquired.
        /// </summary>
        private void device_ImageAcquired(object sender, Vintasoft.Twain.ImageAcquiredEventArgs e)
        {
            Vintasoft.Twain.AcquiredImage acquiredImage = e.Image;

            // despeckle/deskew/detect border
            ProcessAcquiredImage(acquiredImage);
            // add image to multipage TIFF file if image is not blank
            if (!acquiredImage.IsBlank(0.01f))
                acquiredImage.Save(@"d:\test.tif");

            // dispose the acquired image
            acquiredImage.Dispose();
        }

        /// <summary>
        /// Scan is canceled.
        /// </summary>
        private void device_ScanCanceled(object sender, System.EventArgs e)
        {
            System.Windows.Forms.MessageBox.Show("Scan is canceled.");
        }

        /// <summary>
        /// Scan is failed.
        /// </summary>
        private void device_ScanFailed(object sender, Vintasoft.Twain.ScanFailedEventArgs e)
        {
            System.Windows.Forms.MessageBox.Show("Scan is failed: " + e.ErrorString);
        }

        /// <summary>
        /// Scan is finished.
        /// </summary>
        void device_ScanFinished(object sender, System.EventArgs e)
        {
            Vintasoft.Twain.Device device = (Vintasoft.Twain.Device)sender;

            // unsubscribe from device events
            device.ImageAcquired -= new System.EventHandler<Vintasoft.Twain.ImageAcquiredEventArgs>(device_ImageAcquired);
            device.ScanCanceled -= new System.EventHandler(device_ScanCanceled);
            device.ScanFailed -= new System.EventHandler<Vintasoft.Twain.ScanFailedEventArgs>(device_ScanFailed);
            device.ScanFinished -= new System.EventHandler(device_ScanFinished);

            // if device is not closed
            if (device.State != Vintasoft.Twain.DeviceState.Closed)
                // close the device
                device.Close();

            System.Windows.Forms.MessageBox.Show("Scan is finished.");
        }


        /// <summary>
        /// Process the acquired image.
        /// </summary>
        private void ProcessAcquiredImage(Vintasoft.Twain.AcquiredImage acquiredImage)
        {
            System.Console.WriteLine(string.Format("Image ({0})", acquiredImage.ImageInfo));

            try
            {
                // subscribe to the processing events
                acquiredImage.Processing += new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingEventArgs>(acquiredImage_Processing);
                acquiredImage.Progress += new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingProgressEventArgs>(acquiredImage_Progress);
                acquiredImage.Processed += new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessedEventArgs>(acquiredImage_Processed);

                // despeckle image
                acquiredImage.Despeckle(8, 25, 30, 400);
                // deskew image
                acquiredImage.Deskew(Vintasoft.Twain.BorderColor.AutoDetect, 1, 1);
                // detect border of image
                acquiredImage.DetectBorder(5);
            }
            catch (Vintasoft.Twain.ImagingException ex)
            {
                System.Console.WriteLine("Error: " + ex.Message);
            }
            finally
            {
                // unsubscribe from the processing events
                acquiredImage.Processing -= new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingEventArgs>(acquiredImage_Processing);
                acquiredImage.Progress -= new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingProgressEventArgs>(acquiredImage_Progress);
                acquiredImage.Processed -= new System.EventHandler<Vintasoft.Twain.ImageProcessing.AcquiredImageProcessedEventArgs>(acquiredImage_Processed);
            }
        }

        /// <summary>
        /// Image processing is started.
        /// </summary>
        private void acquiredImage_Processing(object sender, Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingEventArgs e)
        {
            System.Console.Write(e.Action.ToString() + " ");
        }

        /// <summary>
        /// Image processing is in progress.
        /// </summary>
        private void acquiredImage_Progress(object sender, Vintasoft.Twain.ImageProcessing.AcquiredImageProcessingProgressEventArgs e)
        {
            System.Console.Write(".");
        }

        /// <summary>
        /// Image processing is finished.
        /// </summary>
        private void acquiredImage_Processed(object sender, Vintasoft.Twain.ImageProcessing.AcquiredImageProcessedEventArgs e)
        {
            System.Console.WriteLine(" finished");
        }

    }
}