Crystal Image Toolkit: thumbnail image control and picture viewing.

#region gnu_license

/*
    Crystal Controls - C# control library containing the following tools:
        CrystalControl - base class
        CrystalGradientControl - a control that can either have a gradient background or be totally transparent.
        CrystalLabel - a homegrown label that can have a gradient or transparent background.
        CrystalPanel - a panel that can have a gradient or transparent background.
        CrystalTrackBar - a homegrown trackbar that can have a gradient or transparent background.
        CrystalToolStripTrackBar - a host for CrystalTrackBar that allows it to work in a ToolStrip.
        
        CrystalImageGridView - a control that hosts thumbnail images in a virtual grid.
        CrystalImageGridModel - a data model that holds a collection of CrystalImageItems
                                to feed to CrystalImageGridView.
        CrystalImageItem - a class that describes an Image file.
        CrystalThumbnailer - provides thumbnailing methods for images.

        CrystalCollector - a base class for a controller that links 
                            CrystalImageGridView to the CrystalImageGridModel.
        CrystalFileCollector - a controller that works on disk-based Image files.
        CrystalDesignCollector - a controller that works in Visual Studio toolbox designer.
        CrystalMemoryCollector - a controller that can be used to add images from memory.
        CrystalMemoryZipCollector - a controller that accesses images in zip files by streaming them into memory.
        CrystalZipCollector - a controller that accesses images in zip files by unpacking them.
        CrystalRarCollector - a controller that accesses images in rar files by unpacking them.

        CrystalPictureBox - a picture box control, derived from CrystalGradientControl.
        CrystalPictureShow - a control for viewing images and processing slideshows.
        CrystalComicShow - a control for viewing comic-book images in the CDisplay format.
 
    Copyright (C) 2006, 2008 Richard Guion
    Attilan Software Factory: http://www.attilan.com
    Contact: richard@attilan.com

    Version 0.76, Alpha build release
        This is a work in progress: USE AT YOUR OWN RISK!  Interfaces/Methods may change!
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library 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
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 */

#endregion

using System;

namespace Attilan.Crystal.Controls
{
    /// <summary>
    /// ICrystalWaitUnpack is an interface to be implemented by "Wait" style Forms that display a slide show using a CrystalCollector object.
    /// </summary>
    public interface ICrystalWaitUnpack
    {
        #region Events

        /// <summary>
        /// Event that gets fired when user cancels the unpack operation.
        /// </summary>
        event EventHandler UnpackTerminated;

        #endregion

        #region Properties

        /// <summary>
        /// Collector used to display a slideshow of images during the unpack operation.
        /// </summary>
        CrystalCollector ImageCollector { get; set; }

        /// <summary>
        /// Name of the Image compressed file that is getting unpacked.
        /// </summary>
        string ImageName { get; set; }

        #endregion

        #region Methods

        /// <summary>
        /// Starts the mini-slideshow on the wait form.
        /// </summary>
        void StartShow();

        /// <summary>
        /// Ends the mini-slideshow on the wait form.
        /// </summary>
        void EndShow();

        #endregion
    }
}