Updated to version 2.4.3 (June 2016)

styler/external/tinyfiledialogs.h

@@ -1,20 +1,28 @@
 /*
-tinyfiledialogs.h
+ _________
-unique header file of "tiny file dialogs" created [November 9, 2014]
+/         \ tinyfiledialogs.h
-Copyright (c) 2014 - 2015 Guillaume Vareille http://ysengrin.com
+|tiny file| Unique header file of "tiny file dialogs" created [November 9, 2014]
-http://tinyfiledialogs.sourceforge.net
+| dialogs | Copyright (c) 2014 - 2016 Guillaume Vareille http://ysengrin.com
+\____  ___/ http://tinyfiledialogs.sourceforge.net
+     \|           	                     mailto:tinfyfiledialogs@ysengrin.com
 
- Let me know here mailto:tinfyfiledialogs@ysengrin.com
+A big thank you to Don Heyse http://ldglite.sf.net for
+                   his code contributions, bug corrections & thorough testing!
+		
+            git://git.code.sf.net/p/tinyfiledialogs/code
+
+Please
+	1) let me know
 	- if you are including tiny file dialogs,
 	  I'll be happy to add your link to the list of projects using it.
-	- If you are using it on not listed here hardware / OS / compiler.
+	- If you are using it on different hardware / OS / compiler.
-	- and please, leave a review on Sourceforge. Thanks.
+	2) Be the first to leave a review on Sourceforge. Thanks.
 
 tiny file dialogs (cross-platform C C++)
 InputBox PasswordBox MessageBox ColorPicker
 OpenFileDialog SaveFileDialog SelectFolderDialog
-Native dialog library for WINDOWS MAC OSX GTK+ QT CONSOLE & more
+Native dialog library for WINDOWS MAC OSX (10.4~10.11) GTK+ QT CONSOLE & more
-v2.2 [July 9, 2015] zlib licence.
+v2.4.3 [Juin 11, 2016] zlib licence
 
 A single C file (add it to your C or C++ project) with 6 modal function calls:
 - message box & question box
@@ -24,9 +32,13 @@ A single C file (add it to your C or C++ project) with 6 modal function calls:
 - select folder dialog
 - color picker.
 
-Complement to OpenGL GLFW GLUT GLUI VTK SDL Ogre3D Unity3D
+Complement to OpenGL GLFW GLUT GLUI
-or any GUI-less program, there is NO INIT & NO MAIN LOOP.
+VTK SFML SDL Ogre Unity CEGUI ION MathGL
-The dialogs can be forced into console mode.
+CPW GLOW GLT NGL STB & GUI less programs
+
+NO INIT & NO MAIN LOOP
+
+The dialogs can be forced into console mode
 
 On Windows:
 - native code & some vbs create the graphic dialogs
@@ -46,9 +58,9 @@ On Unix (command line call attempts):
 The same executable can run across desktops & distributions.
 
 tested with C & C++ compilers
-on Windows Visual Studio MinGW Mac OSX LINUX FREEBSD ILLUMOS SOLARIS
+on Visual Studio MinGW OSX LINUX FREEBSD ILLUMOS SOLARIS MINIX RASPBIAN
 using Gnome Kde Enlightenment Mate Cinnamon Unity
-Lxde Lxqt Xfce WindowMaker IceWm Cde Jds
+Lxde Lxqt Xfce WindowMaker IceWm Cde Jds OpenBox
  
 - License -
 
@@ -73,8 +85,8 @@ misrepresented as being the original software.
 #define TINYFILEDIALOGS_H
 
 /*
-if tinydialogs.c is compiled with a C++ compiler
+if tinydialogs.c is compiled with a C++ compiler rather than with a C compiler
-rather than with a C compiler, you need to comment out:
+(ie. you change the extension from .c to .cpp), you need to comment out:
 extern "C" {
 and the corresponding closing bracket:
 }
@@ -86,40 +98,40 @@ extern "C" {
 
 
 int tinyfd_messageBox (
-    char const * const aTitle , /* "" */
+  char const * const aTitle , /* "" */
-    char const * const aMessage , /* "" may contain \n and \t */
+  char const * const aMessage , /* "" may contain \n \t */
-    char const * const aDialogType , /* "ok" "okcancel" "yesno" */
+  char const * const aDialogType , /* "ok" "okcancel" "yesno" */
-    char const * const aIconType , /* "info" "warning" "error" "question" */
+  char const * const aIconType , /* "info" "warning" "error" "question" */
-    int const aDefaultButton ) ; /* 0 for cancel/no , 1 for ok/yes */
+  int const aDefaultButton ) ; /* 0 for cancel/no , 1 for ok/yes */
 	/* returns 0 for cancel/no , 1 for ok/yes */
 
 char const * tinyfd_inputBox (
 	char const * const aTitle , /* "" */
-	char const * const aMessage , /* "" may NOT contain \n nor \t on windows */
+	char const * const aMessage , /* "" may NOT contain \n \t on windows */
 	char const * const aDefaultInput ) ;  /* "" , if NULL it's a passwordBox */
 	/* returns NULL on cancel */
 
 char const * tinyfd_saveFileDialog (
-    char const * const aTitle , /* "" */
+  char const * const aTitle , /* "" */
-    char const * const aDefaultPathAndFile , /* "" */
+  char const * const aDefaultPathAndFile , /* "" */
-    int const aNumOfFilterPatterns , /* 0 */
+  int const aNumOfFilterPatterns , /* 0 */
-    char const * const * const aFilterPatterns , /* NULL or {"*.jpg","*.png"} */
+  char const * const * const aFilterPatterns , /* NULL | {"*.jpg","*.png"} */
-    char const * const aSingleFilterDescription ) ; /* NULL or "image files" */
+  char const * const aSingleFilterDescription ) ; /* NULL | "text files" */
 	/* returns NULL on cancel */
 
 char const * tinyfd_openFileDialog (
-    char const * const aTitle , /* "" */
+  char const * const aTitle , /* "" */
-    char const * const aDefaultPathAndFile , /* "" */
+  char const * const aDefaultPathAndFile , /* "" */
-    int const aNumOfFilterPatterns , /* 0 */
+  int const aNumOfFilterPatterns , /* 0 */
-    char const * const * const aFilterPatterns , /* NULL or {"*.jpg","*.png"} */
+  char const * const * const aFilterPatterns , /* NULL {"*.jpg","*.png"} */
-    char const * const aSingleFilterDescription , /* NULL or "image files" */
+  char const * const aSingleFilterDescription , /* NULL | "image files" */
-    int const aAllowMultipleSelects ) ; /* 0 or 1 */
+  int const aAllowMultipleSelects ) ; /* 0 or 1 */
 	/* in case of multiple files, the separator is | */
 	/* returns NULL on cancel */
 
 char const * tinyfd_selectFolderDialog (
 	char const * const aTitle , /* "" */
-    char const * const aDefaultPath ) ; /* "" */
+  char const * const aDefaultPath ) ; /* "" */
 	/* returns NULL on cancel */
 
 char const * tinyfd_colorChooser(
@@ -133,46 +145,71 @@ char const * tinyfd_colorChooser(
 	/* aDefaultRGB and aoResultRGB can be the same array */
 	/* returns NULL on cancel */
 
-extern int tinyfd_forceConsole ;  /* 0 (default) or 1
+/* not cross platform - zenity only */
-can be modified at run time.
+char const * tinyfd_arrayDialog (
-for unix & windows: 0 (graphic mode) or 1 (console mode).
+	char const * const aTitle , /* "" */
-0: try to use a graphic solution, if it fails then it uses console mode.
+	int const aNumOfColumns , /* 2 */
-1: forces all dialogs into console mode even when the X server is present,
+	char const * const * const aColumns , /* {"Column 1","Column 2"} */
-   if the package dialog (and a console is present) or dialog.exe is installed.
+	int const aNumOfRows , /* 2*/
-on windows it only make sense for console applications */
+	char const * const * const aCells ) ;
-
+		/* {"Row1 Col1","Row1 Col2","Row2 Col1","Row2 Col2"} */
-/* #define TINYFD_WIN_CONSOLE_ONLY //*/
-/* On windows, Define this if you don't want to include the code
-creating the GUI dialogs. Then you don't need link against Comdlg32.lib */
-
 
 #ifdef	__cplusplus
 }
 #endif /* __cplusplus */
 
-#endif /* TINYFILEDIALOGS_H */
+extern char tinyfd_version [ 8 ] ;
 
+extern int tinyfd_forceConsole;  /* 0 (default) or 1
+can be modified at run time.
+for unix & windows: 0 (graphic mode) or 1 (console mode).
+0: try to use a graphic solution, if it fails then it uses console mode.
+1: forces all dialogs into console mode even when the X server is present.
+   it will use the package dialog or dialog.exe if installed.
+on windows it only make sense for console applications */
+
+extern char tinyfd_response [ 1024 ] ;
+/* if you pass "tinyfd_query" as aTitle,
+the functions will not display the dialogs
+but will fill tinyfd_response with
+the retain solution and return:
+0 for console mode, 1 for graphic mode
+possible values for tinyfd_response are (all lowercase)
+for the graphic mode:
+	windows applescript zenity zenity3 matedialog kdialog
+	xdialog tkinter gdialog gxmessage xmessage
+for the console mode:
+	dialog whiptail basicinput */
+
+/* On windows, define TINYFD_WIN_CONSOLE_ONLY in the c file
+if you don't want to include the code creating the g raphic dialogs.
+Then you won't need to link against Comdlg32.lib and Ole32.lib */
+
+#endif /* TINYFILEDIALOGS_H */
 
 /*
 - This is not for android nor ios.
 - The code is pure C, perfectly compatible with C++.
+- AVOID USING " AND ' IN TITLES AND MESSAGES.
 - There's one file filter only, it may contain several patterns.
 - If no filter description is provided,
   the list of patterns will become the description.
 - char const * filterPatterns[3] = { "*.obj" , "*.stl" , "*.dxf" } ;
 - On windows, inputbox and passwordbox are not as smooth as they should be:
   they open a console window for a few seconds.
-- On windows link against Comdlg32.lib
+- On visual studio:
+      set Properties/Configuration Properties/General
+			Character Set to "Multi-Byte" or "Not Set"
+- On windows link against Comdlg32.lib and Ole32.lib
   This linking is not compulsary for console mode (see above).
 - On unix: it tries command line calls, so no such need.
-- On unix you need applescript, zenity, kdialog, Xdialog, python2/tkinter
+- On unix you need applescript, zenity, matedialog, kdialog, Xdialog,
-  or dialog (will open a terminal if running without console);
+  python2/tkinter or dialog (will open a terminal if running without console).
 - One of those is already included on most (if not all) desktops.
 - In the absence of those it will use gdialog, gxmessage or whiptail
   with a textinputbox.
 - If nothing is found, it switches to basic console input,
   it opens a console if needed.
-- Avoid using " and ' in titles and messages.
 - Use windows separators on windows and unix separators on unix.
 - String memory is preallocated statically for all the returned values.
 - File and path names are tested before return, they are valid.
@@ -189,37 +226,7 @@ creating the GUI dialogs. Then you don't need link against Comdlg32.lib */
   It can be found at the bottom of the following page:
   http://andrear.altervista.org/home/cdialog.php
 - If dialog is missing, it will switch to basic console input.
-
+- You can query the type of dialog that will be use.
-- Here is the Hello World (and a bit more):
+- There is the Hello World (and a bit more) on the sourceforge site:
-    if a console is missing, it will use graphic dialogs
-    if a graphical display is absent, it will use console dialogs
-
-#include <stddef.h>
-#include "tinyfiledialogs.h"
-int main()
-{
-  tinyfd_forceConsole = tinyfd_messageBox("Hello World",
-    "force dialogs into console mode?\
-    \n\t(it's better if dialog is installed)",
-    "yesno", "question", 0);
-
-  char const * lThePassword =  tinyfd_inputBox(
-    "a password box","your password will be revealed",NULL);
-
-  if ( lThePassword )
-    tinyfd_messageBox("your password is", lThePassword, "ok", "info", 1);
-}
-
-OSX :
-$ gcc -o main.app main.c tinyfiledialogs.c
- 
-UNIX :
-$ gcc -o main main.c tinyfiledialogs.c
-
-MinGW :
-> gcc -o main.exe main.c tinyfiledialogs.c -LC:/mingw/lib -lcomdlg32
- 
-VisualStudio :
-  create a console application project
-  (by default it links against Comdlg32.lib)
 */
+

styler/external/tinyfiledialogs_readme.txt

@@ -1,126 +0,0 @@
-tiny file dialogs (cross-platform C C++)
-InputBox PasswordBox MessageBox ColorPicker
-OpenFileDialog SaveFileDialog SelectFolderDialog
-Native dialog library for WINDOWS MAC OSX GTK+ QT CONSOLE & more
-tested with C & C++ compilers
-on Visual Studio 2013 MinGW OSX LINUX FREEBSD ILLUMOS SOLARIS
-using Gnome Kde Enlightenment Mate Cinnamon Unity
-Lxde Lxqt Xfce WindowMaker IceWm Cde Jds
-v2.2 [July 9, 2015] zlib licence.
-
-int tinyfd_messageBox (
-    char const * const aTitle , // ""
-    char const * const aMessage , // "" may contain \n and \t
-    char const * const aDialogType , // "ok" "okcancel" "yesno"
-    char const * const aIconType , // "info" "warning" "error" "question"
-    int const aDefaultButton ) ; // 0 for cancel/no , 1 for ok/yes
-        // returns 0 for cancel/no , 1 for ok/yes
-
-char const * tinyfd_inputBox (
-    char const * const aTitle , // ""
-    char const * const aMessage , // "" may NOT contain \n nor \t on windows
-    char const * const aDefaultInput ) ; // "" , if NULL it's a passwordBox
-        // returns NULL on cancel
-
-char const * tinyfd_saveFileDialog (
-    char const * const aTitle , // ""
-    char const * const aDefaultPathAndFile , // ""
-    int const aNumOfFilterPatterns , // 0
-    char const * const * const aFilterPatterns , // NULL or {"*.txt"}
-    char const * const aSingleFilterDescription ) ; // NULL or "image files"
-        // returns NULL on cancel
-
-char const * tinyfd_openFileDialog (
-    char const * const aTitle , // ""
-    char const * const aDefaultPathAndFile , // ""
-    int const aNumOfFilterPatterns , // 0
-    char const * const * const aFilterPatterns , // NULL or {"*.jpg","*.png"}
-    char const * const aSingleFilterDescription , // NULL or "image files"
-    int const aAllowMultipleSelects ) ; // 0
-        // in case of multiple files, the separator is |
-        // returns NULL on cancel
-
-char const * tinyfd_selectFolderDialog (
-    char const * const aTitle , // ""
-    char const * const aDefaultPath ) ; // ""
-        // returns NULL on cancel
-
-char const * tinyfd_colorChooser(
-    char const * const aTitle , // ""
-    char const * const aDefaultHexRGB , // NULL or "#FF0000”
-    unsigned char const aDefaultRGB[3] , // { 0 , 255 , 255 }
-    unsigned char aoResultRGB[3] ) ; // { 0 , 0 , 0 }
-        // returns the hexcolor as a string "#FF0000"
-        // aoResultRGB also contains the result
-        // aDefaultRGB is used only if aDefaultHexRGB is NULL
-        // aDefaultRGB and aoResultRGB can be the same array
-        // returns NULL on cancel
-
-- This is not for android nor ios.
-- The code is pure C, perfectly compatible with C++.
-- There's one file filter only, it may contain several patterns.
-- If no filter description is provided,
-  the list of patterns will become the description.
-- char const * filterPatterns[3] = { "*.obj" , "*.stl" , "*.dxf" } ;
-- On windows, inputbox and passwordbox are not as smooth as they should be:
-  they open a console window for a few seconds.
-- On windows link against Comdlg32.lib
-  This linking is not compulsary for console mode (see header file).
-- On unix: it tries command line calls, so no such need.
-- On unix you need applescript, zenity, kdialog, Xdialog, python2/tkinter
-  or dialog (will open a terminal if running without console);
-- One of those is already included on most (if not all) desktops.
-- In the absence of those it will use gdialog, gxmessage or whiptail
-  with a textinputbox.
-- If nothing is found, it switches to basic console input,
-  it opens a console if needed.
-- Avoid using " and ' in titles and messages.
-- Use windows separators on windows and unix separators on unix.
-- String memory is preallocated statically for all the returned values.
-- File and path names are tested before return, they are valid.
-- If you pass only a path instead of path + filename,
-  make sure it ends with a separator.
-- tinyfd_forceConsole=1; at run time, forces dialogs into console mode.
-- On windows, console mode only make sense for console applications.
-- Mutiple selects are not allowed in console mode.
-- The package dialog must be installed to run in enhanced console mode.
-  It is already installed on most unix systems.
-- On osx, the package dialog can be installed via http://macports.org
-- On windows, for enhanced console mode,
-  dialog.exe should be copied somewhere on your executable path.
-  It can be found at the bottom of the following page:
-  http://andrear.altervista.org/home/cdialog.php
-- If dialog is missing, it will switch to basic console input.
-
-- Here is the Hello World:
-    if a console is missing, it will use graphic dialogs
-    if a graphical display is absent, it will use console dialogs
-
-#include <stddef.h>
-#include "tinyfiledialogs.h"
-int main()
-{
-  tinyfd_forceConsole = tinyfd_messageBox("Hello World",
-    "force dialogs into console mode?\
-    \n\t(it's better if dialog is installed)",
-    "yesno", "question", 0);
-
-  char const * lThePassword =  tinyfd_inputBox(
-    "a password box","your password will be revealed",NULL);
-
-  if ( lThePassword )
-    tinyfd_messageBox("your password is", lThePassword, "ok", "info", 1);
-}
-
-OSX :
-$ gcc -o main.app main.c tinyfiledialogs.c
-
-UNIX :
-$ gcc -o main main.c tinyfiledialogs.c
-
-MinGW :
-> gcc -o main.exe main.c tinyfiledialogs.c -LC:/mingw/lib -lcomdlg32
-
-VisualStudio :
-  create a console application project
-  (by default it links against Comdlg32.lib)