/*
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
 * All rights reserved.
 */

/** \file ghost/intern/GHOST_EventDragnDrop.h
 *  \ingroup GHOST
 */


#ifndef __GHOST_EVENTDRAGNDROP_H__
#define __GHOST_EVENTDRAGNDROP_H__

#include "GHOST_Event.h"
extern "C" {
#include "IMB_imbuf.h"
#include "IMB_imbuf_types.h"
};

/**
 * Drag & drop event
 *
 * The dragging sequence is performed in four phases:
 *
 * <li> Start sequence (GHOST_kEventDraggingEntered) that tells a drag'n'drop operation has started.
 * Already gives the object data type, and the entering mouse location
 *
 * <li> Update mouse position (GHOST_kEventDraggingUpdated) sent upon each mouse move until the drag'n'drop operation
 * stops, to give the updated mouse position. Useful to highlight a potential destination, and update the status
 * (through GHOST_setAcceptDragOperation) telling if the object can be dropped at
 * the current cursor position.
 *
 * <li> Abort drag'n'drop sequence (GHOST_kEventDraggingExited) sent when the user moved the mouse outside the window.
 *
 * <li> Send the dropped data (GHOST_kEventDraggingDropDone)
 *
 * <li> Outside of the normal sequence, dropped data can be sent (GHOST_kEventDraggingDropOnIcon).
 * This can happen when the user drops an object on the application icon.
 * (Also used in OSX to pass the filename of the document the user doubled-clicked in the finder)
 *
 * <br><br>Note that the mouse positions are given in Blender coordinates (y=0 at bottom)
 *
 * <br>Currently supported object types :
 * <li>UTF-8 string
 * <li>array of strings representing filenames (GHOST_TStringArray)
 * <li>bitmap ImBuf
 */
class GHOST_EventDragnDrop : public GHOST_Event
{
public:
	/**
	 * Constructor.
	 * \param time      The time this event was generated.
	 * \param type      The type of this event.
	 * \param dataType  The type of the drop candidate object
	 * \param window    The window where the event occurred
	 * \param x         The x-coordinate of the location the cursor was at at the time of the event.
	 * \param y         The y-coordinate of the location the cursor was at at the time of the event.
	 * \param data      The "content" dropped in the window
	 */
	GHOST_EventDragnDrop(GHOST_TUns64 time,
	                     GHOST_TEventType type,
	                     GHOST_TDragnDropTypes dataType,
	                     GHOST_IWindow *window,
	                     int x, int y, GHOST_TEventDataPtr data)
		: GHOST_Event(time, type, window)
	{
		m_dragnDropEventData.x = x;
		m_dragnDropEventData.y = y;
		m_dragnDropEventData.dataType = dataType;
		m_dragnDropEventData.data = data;
		m_data = &m_dragnDropEventData;
	}

	~GHOST_EventDragnDrop()
	{
		//Free the dropped object data
		if (m_dragnDropEventData.data == NULL)
			return;

		switch (m_dragnDropEventData.dataType) {
			case GHOST_kDragnDropTypeBitmap:
				IMB_freeImBuf((ImBuf *)m_dragnDropEventData.data);
				break;
			case GHOST_kDragnDropTypeFilenames:
			{
				GHOST_TStringArray *strArray = (GHOST_TStringArray *)m_dragnDropEventData.data;
				int i;

				for (i = 0; i < strArray->count; i++)
					free(strArray->strings[i]);

				free(strArray->strings);
				free(strArray);
			}
			break;
			case GHOST_kDragnDropTypeString:
				free(m_dragnDropEventData.data);
				break;

			default:
				break;
		}
	}



protected:
	/** The x,y-coordinates of the cursor position. */
	GHOST_TEventDragnDropData m_dragnDropEventData;
};

#endif // __GHOST_EVENTDRAGNDROP_H__