FLU - FLTK Utility Widgets

About   ::   Download   ::   Demos   ::   Screenshots/Description   ::   Documentation  ::  Todo

About

Download

Screenshots/Descriptions/Demos

• choose single/multiple files OR directories
• choose single/multiple files AND directories
• chooser is resizable (unlike windows counterpart)
• forward/back directory history
• directory favorites (stored to disk)
• delete or rename files and create new directories (deleting in windows moves to recyle bin by default, unless you SHIFT-DEL then it is deleted explicitly)
• preview mode
• programmable preview capability
• view files in: list mode (normal), wide list mode (each entry takes up the visible width of the chooser), and details mode
• each column is sortable/resizable in details mode
• programmable sorting routine can be provided instead of default lexigraphic sort by filename
• tab-completion. if tabbing matches exactly one directory, a second tab will cd to it. otherwise all matches are displayed, and exact matches are copied into the filename input area
• can also enter absolute paths and "../"
• can filter files dynamically by typing a series of '|' and ';' delimited patterns (e.g. "*.cpp;*.h") in the filename input area. can even use more regexp-like filters (e.g. "file*.img.[1-4]?")
• programmable pattern filters "Description (pattern)" or just "pattern" where "pattern" is either "*.xxx" or "*.{xxx,yyy,zzz}" (just like Fl_File_Chooser). each pattern filter can be delimited by a tab character '\t', or '|' or ';'
• Right-click context menu for renaming or deleting files/directories and creating new directories
• context menu is programmable so you can add handlers for different files
• file icons/descriptions are programmable

• Flu_Button - Just like Fl_Button except the button face color gets lighter when the mouse enters, and its image is automatically desaturated when the button is disabled.
• Flu_Return_Button - Just like Fl_Return_Button except with all the benefits of Flu_Button.
• Flu_Link_Button - This is a button that looks/acts like a hyperlink on a web page. The cursor changes to a hand when the mouse hovers over the link, and clicking invokes the regular FLTK callback.

• Flu_Combo_List - Just like Fl_Choice except the input area is editable.
• Flu_Combo_Tree - Just like Flu_Combo_List except you can display a tree instead of a list (using Flu_Tree_Browser).

   

• Flu_Simple_Group - Fl_Group...but with a spiffed up aesthetic appeal.
• Flu_Toggle_Group - Looks like Flu_Simple_Group with an Fl_Check_Button as the title. Toggling the title will activate/deactivate all children.
• Flu_Choice_Group - Looks like Flu_Simple_Group with an Fl_Choice as the title. Works like Fl_Tabs but looks more like its Windows/OSX counterparts.
• Flu_Collapsable_Group - Looks like Flu_Simple_Group with an Fl_Button as the title. Clicking the button will expand/collapse the group. Frame rate and collapse time are customizable.
• Flu_Wrap_Group - This class provides an alternative to Fl_Group that automatically arranges the children either left to right and top to bottom, or top to bottom and left to right, within the available size of the group, with a scrollbar turning on if they don't all fit. Best used with fixed and equally sized children.

• Flu_Enumerations.h - Your vanilla enumerations file. I follow the FLTK convention of int-enums in the global scope (consistency - not personal preference ;-).
  
• flu_export.h - Stupid Windows DLL macros
  
• Flu_Helpers.h - A few functions that have come in handy:
• fl_exit() - Convenience routine to hide all open windows. This will (eventually) cause FLTK to exit
• fl_Full_Find_In_Menu - Searches an Fl_Menu for an entry with a given path name (e.g. /path/to/menu/entry), returning its index or -1 if it's not there
• fl_Find_In_Menu - Similar to the above, but doesn't use a full path name, and returns the first match
• fl_Show_Window_Callback - Convenience callback for an Fl_Widget to show an Fl_Window. Pretty common thing to do actually...
• fl_Hide_Window_Callback - I'm sure you can figure out what this one does
• fl_Hide_Window_And_Set_User_Data_Callback - Useful when writing compact dialogs in-line. Convenience callback for an Fl_Widget to hide an Fl_Window.  Before the window is hidden, its user_data() field is set to the widget that invoked the callback. The user_data() can then be used to determine which widget closed the window.
  
• Flu_Int_Input - This widget simply extends Fl_Int_Input to allow getting/setting the widget value as integers instead of strings. e.g. input->ivalue(27)
  
• Flu_Float_Input - This widget simply extends Fl_Float_Input to allow getting/setting the widget value as floats instead of just strings. e.g. input->fvalue(3.1415926)
• Flu_GL_Window - This widget is derived from Fl_Gl_Window, and makes some GL things easier. For example, you can register GLUT-like callbacks to the widget, and opt for mouse coordinates to be reported in cartesian coordinates instead of window coordinates. There is also a static callback invoked for each new GL context which is useful for some API things, such as making sure each context has the entry points for GL extensions in Windows.
  
• Flu_Label - This widget just makes it easier to make stand-alone labels. Setting the value() copies the text to a local buffer, so you don't need to worry about aliasing.
  
• Flu_Output - This widget simply extends Fl_Output to allow getting/setting the widget value as integers and floats in addition to strings. e.g. ivalue() and fvalue().
  
• flu_pixmaps.h - A few XPM images compatible with Fl_Pixmap. Nothing special.
  
• Flu_Separator - A simple widget that draws a separator line using the current box type. You can choose horizontal or vertical.
  

Documentation