///////////////////////////////////////////////////////////////////////////////
#ifdef __GNUG__
-#pragma implementation "dnd.h"
+ #pragma implementation "dnd.h"
#endif
#include "wx/dnd.h"
#include "wx/intl.h"
#include "wx/utils.h"
-#include "gdk/gdk.h"
-#include "gtk/gtk.h"
-#include "gdk/gdkprivate.h"
+#include "wx/gtk/private.h"
-#include "gtk/gtkdnd.h"
-#include "gtk/gtkselection.h"
+#include <gdk/gdkprivate.h>
+
+#include <gtk/gtkdnd.h>
+#include <gtk/gtkselection.h>
//-----------------------------------------------------------------------------
// idle system
//-----------------------------------------------------------------------------
#if wxUSE_THREADS
-extern void wxapp_install_thread_wakeup();
-extern void wxapp_uninstall_thread_wakeup();
#endif
//----------------------------------------------------------------------------
extern bool g_blockEventsOnDrag;
+// the trace mask we use with wxLogTrace() - call
+// wxLog::AddTraceMask(TRACE_DND) to enable the trace messages from here
+// (there are quite a few of them, so don't enable this by default)
+static const wxChar *TRACE_DND = _T("dnd");
+
//----------------------------------------------------------------------------
// standard icons
//----------------------------------------------------------------------------
/* XPM */
-static char * gv_xpm[] = {
-"40 34 3 1",
-" s None c None",
-". c black",
-"X c white",
-" ",
-" ",
-" ...... ",
-" ..XXXXXX.. ",
-" .XXXXXXXXXX. ",
-" .XXXXXXXXXXXX. ",
-" .XXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXX. ",
-" .XXX..XXXX..XXX. ",
-" ....XX....XX....XX. ",
-" .XXX.XXX..XXXX..XXX.... ",
-" .XXXXXXXXXXXXXXXXXXX.XXX. ",
-" .XXXXXXXXXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXXXXXXXXX. ",
-" ..XXXXXXXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXXX... ",
-" ..XXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXXXXXXXXX. ",
-" .XXXXXXXXXXXXXX.XXXXXXX. ",
-" .XXXXXXX.XXXXXXX.XXXXXXX. ",
-" .XXXXXXXX.XXXXXXX.XXXXXXX. ",
-" .XXXXXXX...XXXXX...XXXXX. ",
-" .XXXXXXX. ..... ..... ",
-" ..XXXX.. ",
-" .... ",
-" ",
-" ",
-" "};
-
-/* XPM */
-static char * page_xpm[] = {
+static const char * page_xpm[] = {
/* width height ncolors chars_per_pixel */
"32 32 5 1",
/* colors */
this is only valid for the duration of this call */
drop_target->SetDragContext( context );
- bool ret = FALSE;
+ wxDragResult result;
+ if ( context->suggested_action == GDK_ACTION_COPY )
+ result = wxDragCopy;
+ else if ( context->suggested_action == GDK_ACTION_LINK )
+ result = wxDragLink;
+ else
+ result = wxDragMove;
if (drop_target->m_firstMotion)
{
/* the first "drag_motion" event substitutes a "drag_enter" event */
- ret = drop_target->OnEnter( x, y );
+ result = drop_target->OnEnter( x, y, result );
}
else
{
/* give program a chance to react (i.e. to say no by returning FALSE) */
- ret = drop_target->OnMove( x, y );
+ result = drop_target->OnDragOver( x, y, result );
}
- /* we don't yet handle which "actions" (i.e. copy or move)
- the target accepts. so far we simply accept the
- suggested action. TODO. */
+ bool ret = wxIsDragResultOk( result );
if (ret)
- gdk_drag_status( context, context->suggested_action, time );
+ {
+ GdkDragAction action;
+ if (result == wxDragCopy)
+ action = GDK_ACTION_COPY;
+ else if (result == wxDragLink)
+ action = GDK_ACTION_LINK;
+ else
+ action = GDK_ACTION_MOVE;
+
+ gdk_drag_status( context, action, time );
+ }
/* after this, invalidate the drop_target's GdkDragContext */
drop_target->SetDragContext( (GdkDragContext*) NULL );
this is only valid for the duration of this call */
drop_target->SetDragTime( time );
+/*
+ wxDragResult result = wxDragMove;
+ if (context->suggested_action == GDK_ACTION_COPY) result = wxDragCopy;
+*/
+
+ /* reset the block here as someone might very well
+ show a dialog as a reaction to a drop and this
+ wouldn't work without events */
+ g_blockEventsOnDrag = FALSE;
+
bool ret = drop_target->OnDrop( x, y );
if (!ret)
{
+ wxLogTrace(TRACE_DND, wxT( "Drop target: OnDrop returned FALSE") );
+
/* cancel the whole thing */
gtk_drag_finish( context,
FALSE, /* no success */
}
else
{
+ wxLogTrace(TRACE_DND, wxT( "Drop target: OnDrop returned TRUE") );
+
#if wxUSE_THREADS
/* disable GUI threads */
- wxapp_uninstall_thread_wakeup();
#endif
GdkAtom format = drop_target->GetMatchingPair();
- wxASSERT( format );
-
+ wxASSERT( format );
+
+/*
+ GdkDragAction action = GDK_ACTION_MOVE;
+ if (result == wxDragCopy) action == GDK_ACTION_COPY;
+ context->action = action;
+*/
/* this should trigger an "drag_data_received" event */
gtk_drag_get_data( widget,
context,
#if wxUSE_THREADS
/* re-enable GUI threads */
- wxapp_install_thread_wakeup();
#endif
}
/* Owen Taylor: "call gtk_drag_finish() with
success == TRUE" */
-
if ((data->length <= 0) || (data->format != 8))
{
/* negative data length and non 8-bit data format
return;
}
- wxLogDebug( wxT( "Drop target: data received") );
-
+ wxLogTrace(TRACE_DND, wxT( "Drop target: data received event") );
+
/* inform the wxDropTarget about the current GtkSelectionData.
this is only valid for the duration of this call */
drop_target->SetDragData( data );
- if (drop_target->OnData( x, y ))
+ wxDragResult result;
+ if ( context->suggested_action == GDK_ACTION_COPY )
+ result = wxDragCopy;
+ else if ( context->suggested_action == GDK_ACTION_LINK )
+ result = wxDragLink;
+ else
+ result = wxDragMove;
+
+ if ( wxIsDragResultOk( drop_target->OnData( x, y, result ) ) )
{
+ wxLogTrace(TRACE_DND, wxT( "Drop target: OnData returned TRUE") );
+
/* tell GTK that data transfer was successfull */
gtk_drag_finish( context, TRUE, FALSE, time );
}
else
{
+ wxLogTrace(TRACE_DND, wxT( "Drop target: OnData returned FALSE") );
+
/* tell GTK that data transfer was not successfull */
gtk_drag_finish( context, FALSE, FALSE, time );
}
//----------------------------------------------------------------------------
wxDropTarget::wxDropTarget( wxDataObject *data )
+ : wxDropTargetBase( data )
{
m_firstMotion = TRUE;
m_dragContext = (GdkDragContext*) NULL;
m_dragWidget = (GtkWidget*) NULL;
m_dragData = (GtkSelectionData*) NULL;
m_dragTime = 0;
- m_data = data;
}
-wxDropTarget::~wxDropTarget()
+wxDragResult wxDropTarget::OnDragOver( wxCoord WXUNUSED(x),
+ wxCoord WXUNUSED(y),
+ wxDragResult def )
{
-}
+ // GetMatchingPair() checks for m_dataObject too, no need to do it here
-bool wxDropTarget::OnEnter( int WXUNUSED(x), int WXUNUSED(y) )
-{
- if (!m_data)
- return FALSE;
-
- return (GetMatchingPair() != (GdkAtom) 0);
-}
+ // disable the debug message from GetMatchingPair() - there are too many
+ // of them otherwise
+#ifdef __WXDEBUG__
+ wxLogNull noLog;
+#endif // Debug
-void wxDropTarget::OnLeave()
-{
+ return (GetMatchingPair() != (GdkAtom) 0) ? def : wxDragNone;
}
-bool wxDropTarget::OnMove( int WXUNUSED(x), int WXUNUSED(y) )
+bool wxDropTarget::OnDrop( wxCoord WXUNUSED(x), wxCoord WXUNUSED(y) )
{
- if (!m_data)
+ if (!m_dataObject)
return FALSE;
-
- return (GetMatchingPair() != (GdkAtom) 0);
-}
-bool wxDropTarget::OnDrop( int WXUNUSED(x), int WXUNUSED(y) )
-{
- if (!m_data)
- return FALSE;
-
return (GetMatchingPair() != (GdkAtom) 0);
}
-bool wxDropTarget::OnData( int WXUNUSED(x), int WXUNUSED(y) )
+wxDragResult wxDropTarget::OnData( wxCoord WXUNUSED(x), wxCoord WXUNUSED(y),
+ wxDragResult def )
{
- if (!m_data)
- return FALSE;
-
+ if (!m_dataObject)
+ return wxDragNone;
+
if (GetMatchingPair() == (GdkAtom) 0)
- return FALSE;
-
- return GetData();
+ return wxDragNone;
+
+ return GetData() ? def : wxDragNone;
}
GdkAtom wxDropTarget::GetMatchingPair()
{
- if (!m_data)
+ if (!m_dataObject)
return (GdkAtom) 0;
- if (!m_dragContext)
+ if (!m_dragContext)
return (GdkAtom) 0;
GList *child = m_dragContext->targets;
while (child)
{
GdkAtom formatAtom = (GdkAtom) GPOINTER_TO_INT(child->data);
- wxDataFormat format( formatAtom );
+ wxDataFormat format( formatAtom );
#ifdef __WXDEBUG__
- char *name = gdk_atom_name( formatAtom );
- if (name) wxLogDebug( "Drop target: drag has format: %s", name );
-#endif
- if (m_data->IsSupportedFormat( format ))
- return formatAtom;
+ wxLogTrace(TRACE_DND, wxT("Drop target: drag has format: %s"),
+ format.GetId().c_str());
+#endif // Debug
+
+ if (m_dataObject->IsSupportedFormat( format ))
+ return formatAtom;
child = child->next;
}
bool wxDropTarget::GetData()
{
- if (!m_dragData)
+ if (!m_dragData)
return FALSE;
- if (!m_data)
+ if (!m_dataObject)
return FALSE;
wxDataFormat dragFormat( m_dragData->target );
-
- if (!m_data->IsSupportedFormat( dragFormat ))
- return FALSE;
- if (dragFormat.GetType() == wxDF_TEXT)
- {
- wxTextDataObject *text_object = (wxTextDataObject*)m_data;
- text_object->SetText( (const char*)m_dragData->data );
- return TRUE;
- }
+ if (!m_dataObject->IsSupportedFormat( dragFormat ))
+ return FALSE;
- if (dragFormat.GetType() == wxDF_FILENAME)
- {
- wxFileDataObject *file_object = (wxFileDataObject*)m_data;
- file_object->SetFiles( (const char*)m_dragData->data );
- return TRUE;
- }
+ m_dataObject->SetData( dragFormat, (size_t)m_dragData->length, (const void*)m_dragData->data );
- return FALSE;
+ return TRUE;
}
void wxDropTarget::UnregisterWidget( GtkWidget *widget )
static void
source_drag_data_get (GtkWidget *WXUNUSED(widget),
- GdkDragContext *context,
+ GdkDragContext *WXUNUSED(context),
GtkSelectionData *selection_data,
guint WXUNUSED(info),
guint WXUNUSED(time),
{
if (g_isIdle) wxapp_install_idle_handler();
-#ifdef __WXDEBUG__
- char *name = gdk_atom_name( selection_data->target );
- if (name) wxLogDebug( wxT("Drop source: format requested: %s"), name );
-#endif
+ wxDataFormat format( selection_data->target );
+
+ wxLogTrace(TRACE_DND, wxT("Drop source: format requested: %s"),
+ format.GetId().c_str());
drop_source->m_retValue = wxDragCancel;
-
- wxDataObject *data = drop_source->m_data;
-
+
+ wxDataObject *data = drop_source->GetDataObject();
+
if (!data)
- return;
+ {
+ wxLogTrace(TRACE_DND, wxT("Drop source: no data object") );
+ return;
+ }
- if (!data->IsSupportedFormat(selection_data->target))
- return;
+ if (!data->IsSupportedFormat(format))
+ {
+ wxLogTrace(TRACE_DND, wxT("Drop source: unsupported format") );
+ return;
+ }
- if (data->GetDataSize(selection_data->target) == 0)
- return;
-
- size_t size = data->GetDataSize(selection_data->target);
+ if (data->GetDataSize(format) == 0)
+ {
+ wxLogTrace(TRACE_DND, wxT("Drop source: empty data") );
+ return;
+ }
+
+ size_t size = data->GetDataSize(format);
// printf( "data size: %d.\n", (int)data_size );
guchar *d = new guchar[size];
-
- if (!data->GetDataHere( selection_data->target, (void*)d ))
+
+ if (!data->GetDataHere( format, (void*)d ))
{
- free( d );
- return;
+ delete[] d;
+ return;
}
#if wxUSE_THREADS
/* disable GUI threads */
- wxapp_uninstall_thread_wakeup();
#endif
gtk_selection_data_set( selection_data,
#if wxUSE_THREADS
/* enable GUI threads */
- wxapp_install_thread_wakeup();
#endif
- free( d );
-
- /* so far only copy, no moves. TODO. */
- drop_source->m_retValue = wxDragCopy;
+ delete[] d;
}
//----------------------------------------------------------------------------
// "drag_data_delete"
//----------------------------------------------------------------------------
-static void source_drag_data_delete( GtkWidget *WXUNUSED(widget),
- GdkDragContext *WXUNUSED(context),
- wxDropSource *drop_source )
+static void source_drag_data_delete( GtkWidget *WXUNUSED(widget),
+ GdkDragContext *context,
+ wxDropSource *WXUNUSED(drop_source) )
{
- if (g_isIdle) wxapp_install_idle_handler();
-
-// printf( "Delete the data!\n" );
+ if (g_isIdle)
+ wxapp_install_idle_handler();
- drop_source->m_retValue = wxDragMove;
+ // printf( "Drag source: drag_data_delete\n" );
}
//----------------------------------------------------------------------------
GdkDragContext *WXUNUSED(context),
wxDropSource *WXUNUSED(drop_source) )
{
- if (g_isIdle) wxapp_install_idle_handler();
+ if (g_isIdle)
+ wxapp_install_idle_handler();
-// printf( "drag_begin.\n" );
+ // printf( "Drag source: drag_begin.\n" );
}
//----------------------------------------------------------------------------
{
if (g_isIdle) wxapp_install_idle_handler();
-// printf( "drag_end.\n" );
+ // printf( "Drag source: drag_end.\n" );
drop_source->m_waiting = FALSE;
}
+//-----------------------------------------------------------------------------
+// "configure_event" from m_iconWindow
+//-----------------------------------------------------------------------------
+
+static gint
+gtk_dnd_window_configure_callback( GtkWidget *WXUNUSED(widget), GdkEventConfigure *WXUNUSED(event), wxDropSource *source )
+{
+ if (g_isIdle)
+ wxapp_install_idle_handler();
+
+ wxDragResult action = wxDragNone;
+ if (source->m_dragContext->action == GDK_ACTION_COPY) action = wxDragCopy;
+ if (source->m_dragContext->action == GDK_ACTION_LINK) action = wxDragLink;
+ if (source->m_dragContext->action == GDK_ACTION_MOVE) action = wxDragMove;
+
+ source->GiveFeedback( action );
+
+ return 0;
+}
+
//---------------------------------------------------------------------------
// wxDropSource
//---------------------------------------------------------------------------
-wxDropSource::wxDropSource( wxWindow *win, const wxIcon &go, const wxIcon &stop )
+wxDropSource::wxDropSource(wxWindow *win,
+ const wxIcon &iconCopy,
+ const wxIcon &iconMove,
+ const wxIcon &iconNone)
{
- g_blockEventsOnDrag = TRUE;
m_waiting = TRUE;
+ m_iconWindow = (GtkWidget*) NULL;
+
m_window = win;
m_widget = win->m_widget;
if (win->m_wxwindow) m_widget = win->m_wxwindow;
- m_data = (wxDataObject*) NULL;
m_retValue = wxDragCancel;
- m_defaultCursor = wxCursor( wxCURSOR_NO_ENTRY );
- m_goaheadCursor = wxCursor( wxCURSOR_HAND );
-
- m_goIcon = go;
- if (wxNullIcon == go) m_goIcon = wxIcon( page_xpm );
- m_stopIcon = stop;
- if (wxNullIcon == stop) m_stopIcon = wxIcon( gv_xpm );
+ SetIcons(iconCopy, iconMove, iconNone);
}
-wxDropSource::wxDropSource( wxDataObject& data, wxWindow *win,
- const wxIcon &go, const wxIcon &stop )
+wxDropSource::wxDropSource(wxDataObject& data,
+ wxWindow *win,
+ const wxIcon &iconCopy,
+ const wxIcon &iconMove,
+ const wxIcon &iconNone)
{
m_waiting = TRUE;
+ SetData( data );
+
+ m_iconWindow = (GtkWidget*) NULL;
+
m_window = win;
m_widget = win->m_widget;
if (win->m_wxwindow) m_widget = win->m_wxwindow;
- m_retValue = wxDragCancel;
- m_data = &data;
-
- m_defaultCursor = wxCursor( wxCURSOR_NO_ENTRY );
- m_goaheadCursor = wxCursor( wxCURSOR_HAND );
+ m_retValue = wxDragCancel;
- m_goIcon = go;
- if (wxNullIcon == go) m_goIcon = wxIcon( page_xpm );
- m_stopIcon = stop;
- if (wxNullIcon == stop) m_stopIcon = wxIcon( gv_xpm );
+ SetIcons(iconCopy, iconMove, iconNone);
}
-void wxDropSource::SetData( wxDataObject& data )
+void wxDropSource::SetIcons(const wxIcon &iconCopy,
+ const wxIcon &iconMove,
+ const wxIcon &iconNone)
{
- if (m_data)
- delete m_data;
-
- m_data = &data;
+ m_iconCopy = iconCopy;
+ m_iconMove = iconMove;
+ m_iconNone = iconNone;
+
+ if ( !m_iconCopy.Ok() )
+ m_iconCopy = wxIcon(page_xpm);
+ if ( !m_iconMove.Ok() )
+ m_iconMove = m_iconCopy;
+ if ( !m_iconNone.Ok() )
+ m_iconNone = m_iconCopy;
}
wxDropSource::~wxDropSource()
{
- if (m_data)
-// delete m_data;
+}
- g_blockEventsOnDrag = FALSE;
+void wxDropSource::PrepareIcon( int action, GdkDragContext *context )
+{
+ // get the right icon to display
+ wxIcon *icon = NULL;
+ if ( action & GDK_ACTION_MOVE )
+ icon = &m_iconMove;
+ else if ( action & GDK_ACTION_COPY )
+ icon = &m_iconCopy;
+ else
+ icon = &m_iconNone;
+
+ GdkBitmap *mask;
+ if ( icon->GetMask() )
+ mask = icon->GetMask()->GetBitmap();
+ else
+ mask = (GdkBitmap *)NULL;
+
+ GdkPixmap *pixmap = icon->GetPixmap();
+
+ gint width,height;
+ gdk_window_get_size (pixmap, &width, &height);
+
+ GdkColormap *colormap = gtk_widget_get_colormap( m_widget );
+#ifndef __WXGTK20__
+ gtk_widget_push_visual (gdk_colormap_get_visual (colormap));
+#endif
+ gtk_widget_push_colormap (colormap);
+
+ m_iconWindow = gtk_window_new (GTK_WINDOW_POPUP);
+ gtk_widget_set_events (m_iconWindow, GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK);
+ gtk_widget_set_app_paintable (GTK_WIDGET (m_iconWindow), TRUE);
+
+#ifndef __WXGTK20__
+ gtk_widget_pop_visual ();
+#endif
+ gtk_widget_pop_colormap ();
+
+ gtk_widget_set_usize (m_iconWindow, width, height);
+ gtk_widget_realize (m_iconWindow);
+
+ gtk_signal_connect( GTK_OBJECT(m_iconWindow), "configure_event",
+ GTK_SIGNAL_FUNC(gtk_dnd_window_configure_callback), (gpointer)this );
+
+ gdk_window_set_back_pixmap (m_iconWindow->window, pixmap, FALSE);
+
+ if (mask)
+ gtk_widget_shape_combine_mask (m_iconWindow, mask, 0, 0);
+
+ gtk_drag_set_icon_widget( context, m_iconWindow, 0, 0 );
}
-wxDragResult wxDropSource::DoDragDrop( bool WXUNUSED(bAllowMove) )
+wxDragResult wxDropSource::DoDragDrop( bool allowMove )
{
- wxASSERT_MSG( m_data, wxT("wxDragSource: no data") );
+ wxASSERT_MSG( m_data, wxT("Drop source: no data") );
+
+ if (!m_data)
+ return (wxDragResult) wxDragNone;
- if (!m_data)
+ if (m_data->GetFormatCount() == 0)
return (wxDragResult) wxDragNone;
- if (m_data->GetFormatCount() == 0)
+ // still in drag
+ if (g_blockEventsOnDrag)
return (wxDragResult) wxDragNone;
-
+
+ // disabled for now
g_blockEventsOnDrag = TRUE;
RegisterWindow();
m_waiting = TRUE;
GtkTargetList *target_list = gtk_target_list_new( (GtkTargetEntry*) NULL, 0 );
-
+
wxDataFormat *array = new wxDataFormat[ m_data->GetFormatCount() ];
- m_data->GetAllFormats( array, TRUE );
+ m_data->GetAllFormats( array );
for (size_t i = 0; i < m_data->GetFormatCount(); i++)
{
GdkAtom atom = array[i];
- wxLogDebug( wxT("Supported atom %s"), gdk_atom_name( atom ) );
+ wxLogTrace(TRACE_DND, wxT("Drop source: Supported atom %s"), gdk_atom_name( atom ));
gtk_target_list_add( target_list, atom, 0, 0 );
}
delete[] array;
event.x = x;
event.y = y;
event.state = state;
- event.time = GDK_CURRENT_TIME;
+ event.time = (guint32)GDK_CURRENT_TIME;
/* GTK wants to know which button was pressed which caused the dragging */
int button_number = 0;
#if wxUSE_THREADS
/* disable GUI threads */
- wxapp_uninstall_thread_wakeup();
#endif
/* don't start dragging if no button is down */
if (button_number)
{
+ int action = GDK_ACTION_COPY;
+ if ( allowMove )
+ action |= GDK_ACTION_MOVE;
GdkDragContext *context = gtk_drag_begin( m_widget,
- target_list,
- GDK_ACTION_COPY,
- button_number, /* number of mouse button which started drag */
- (GdkEvent*) &event );
-
- wxMask *mask = m_goIcon.GetMask();
- GdkBitmap *bm = (GdkBitmap *) NULL;
- if (mask) bm = mask->GetBitmap();
- GdkPixmap *pm = m_goIcon.GetPixmap();
-
- gtk_drag_set_icon_pixmap( context,
- gtk_widget_get_colormap( m_widget ),
- pm,
- bm,
- 0,
- 0 );
-
- while (m_waiting) gtk_main_iteration();;
+ target_list,
+ (GdkDragAction)action,
+ button_number, /* number of mouse button which started drag */
+ (GdkEvent*) &event );
+
+ m_dragContext = context;
+
+ PrepareIcon( action, context );
+
+ while (m_waiting) gtk_main_iteration();
+
+ if (context->action == GDK_ACTION_COPY)
+ m_retValue = wxDragCopy;
+ if (context->action == GDK_ACTION_LINK)
+ m_retValue = wxDragLink;
+ if (context->action == GDK_ACTION_MOVE)
+ m_retValue = wxDragMove;
}
#if wxUSE_THREADS
/* re-enable GUI threads */
- wxapp_install_thread_wakeup();
#endif
g_blockEventsOnDrag = FALSE;
}
#endif
-
// wxUSE_DRAG_AND_DROP
projects / wxWidgets.git / blobdiff