|
|
|
|
@ -0,0 +1,326 @@
|
|
|
|
|
/*_________
|
|
|
|
|
/ \ tinyfiledialogs.h v3.3.8 [Nov 4, 2018] zlib licence
|
|
|
|
|
|tiny file| Unique header file created [November 9, 2014]
|
|
|
|
|
| dialogs | Copyright (c) 2014 - 2018 Guillaume Vareille http://ysengrin.com
|
|
|
|
|
\____ ___/ http://tinyfiledialogs.sourceforge.net
|
|
|
|
|
\| git clone http://git.code.sf.net/p/tinyfiledialogs/code tinyfd
|
|
|
|
|
____________________________________________
|
|
|
|
|
| |
|
|
|
|
|
| email: tinyfiledialogs at ysengrin.com |
|
|
|
|
|
|____________________________________________|
|
|
|
|
|
________________________________________________________________________
|
|
|
|
|
| |
|
|
|
|
|
| the windows only wchar_t UTF-16 prototypes are at the end of this file |
|
|
|
|
|
|________________________________________________________________________|
|
|
|
|
|
|
|
|
|
|
Please upvote my stackoverflow answer https://stackoverflow.com/a/47651444
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
SSH supported via automatic switch to console mode or X11 forwarding
|
|
|
|
|
|
|
|
|
|
one C file + a header (add them to your C or C++ project) with 8 functions:
|
|
|
|
|
- beep
|
|
|
|
|
- notify popup (tray)
|
|
|
|
|
- message & question
|
|
|
|
|
- input & password
|
|
|
|
|
- save file
|
|
|
|
|
- open file(s)
|
|
|
|
|
- select folder
|
|
|
|
|
- color picker
|
|
|
|
|
|
|
|
|
|
Complements OpenGL Vulkan GLFW GLUT GLUI VTK SFML TGUI
|
|
|
|
|
SDL Ogre Unity3d ION OpenCV CEGUI MathGL GLM CPW GLOW
|
|
|
|
|
Open3D IMGUI MyGUI GLT NGL STB & GUI less programs
|
|
|
|
|
|
|
|
|
|
NO INIT
|
|
|
|
|
NO MAIN LOOP
|
|
|
|
|
NO LINKING
|
|
|
|
|
NO INCLUDE
|
|
|
|
|
|
|
|
|
|
The dialogs can be forced into console mode
|
|
|
|
|
|
|
|
|
|
Windows (XP to 10) ASCII MBCS UTF-8 UTF-16
|
|
|
|
|
- native code & vbs create the graphic dialogs
|
|
|
|
|
- enhanced console mode can use dialog.exe from
|
|
|
|
|
http://andrear.altervista.org/home/cdialog.php
|
|
|
|
|
- basic console input
|
|
|
|
|
|
|
|
|
|
Unix (command line calls) ASCII UTF-8
|
|
|
|
|
- applescript, kdialog, zenity
|
|
|
|
|
- python (2 or 3) + tkinter + python-dbus (optional)
|
|
|
|
|
- dialog (opens a console if needed)
|
|
|
|
|
- basic console input
|
|
|
|
|
The same executable can run across desktops & distributions
|
|
|
|
|
|
|
|
|
|
C89 & C++98 compliant: tested with C & C++ compilers
|
|
|
|
|
VisualStudio MinGW-gcc GCC Clang TinyCC OpenWatcom-v2 BorlandC SunCC ZapCC
|
|
|
|
|
on Windows Mac Linux Bsd Solaris Minix Raspbian
|
|
|
|
|
using Gnome Kde Enlightenment Mate Cinnamon Budgie Unity Lxde Lxqt Xfce
|
|
|
|
|
WindowMaker IceWm Cde Jds OpenBox Awesome Jwm Xdm
|
|
|
|
|
|
|
|
|
|
Bindings for LUA and C# dll, Haskell
|
|
|
|
|
Included in LWJGL(java), Rust, Allegrobasic
|
|
|
|
|
|
|
|
|
|
- License -
|
|
|
|
|
|
|
|
|
|
This software is provided 'as-is', without any express or implied
|
|
|
|
|
warranty. In no event will the authors be held liable for any damages
|
|
|
|
|
arising from the use of this software.
|
|
|
|
|
|
|
|
|
|
Permission is granted to anyone to use this software for any purpose,
|
|
|
|
|
including commercial applications, and to alter it and redistribute it
|
|
|
|
|
freely, subject to the following restrictions:
|
|
|
|
|
|
|
|
|
|
1. The origin of this software must not be misrepresented; you must not
|
|
|
|
|
claim that you wrote the original software. If you use this software
|
|
|
|
|
in a product, an acknowledgment in the product documentation would be
|
|
|
|
|
appreciated but is not required.
|
|
|
|
|
2. Altered source versions must be plainly marked as such, and must not be
|
|
|
|
|
misrepresented as being the original software.
|
|
|
|
|
3. This notice may not be removed or altered from any source distribution.
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef TINYFILEDIALOGS_H
|
|
|
|
|
#define TINYFILEDIALOGS_H
|
|
|
|
|
|
|
|
|
|
/* #define TINYFD_NOLIB */
|
|
|
|
|
/* On windows, define TINYFD_NOLIB here
|
|
|
|
|
if you don't want to include the code creating the graphic dialogs.
|
|
|
|
|
Then you won't need to link against Comdlg32.lib and Ole32.lib */
|
|
|
|
|
|
|
|
|
|
/* if tinydialogs.c is compiled as C++ code rather than C code,
|
|
|
|
|
you may need to comment out:
|
|
|
|
|
extern "C" {
|
|
|
|
|
and the corresponding closing bracket near the end of this file:
|
|
|
|
|
}
|
|
|
|
|
*/
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C" {
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
extern char const tinyfd_version[8]; /* contains tinyfd current version number */
|
|
|
|
|
extern char const tinyfd_needs[]; /* info about requirements */
|
|
|
|
|
extern int tinyfd_verbose; /* 0 (default) or 1 : on unix, prints the command line calls */
|
|
|
|
|
extern int tinyfd_silent; /* 1 (default) or 0 : on unix,
|
|
|
|
|
hide errors and warnings from called dialog*/
|
|
|
|
|
|
|
|
|
|
#ifdef _WIN32
|
|
|
|
|
/* for UTF-16 use the functions at the end of this files */
|
|
|
|
|
extern int tinyfd_winUtf8; /* 0 (default MBCS) or 1 (UTF-8)*/
|
|
|
|
|
/* on windows string char can be 0:MBCS or 1:UTF-8
|
|
|
|
|
unless your code is really prepared for UTF-8 on windows, leave this on MBSC.
|
|
|
|
|
Or you can use the UTF-16 (wchar) prototypes at the end of ths file.*/
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
extern int tinyfd_forceConsole; /* 0 (default) or 1 */
|
|
|
|
|
/* 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 an X server is present,
|
|
|
|
|
if the package dialog (and a console is present) or dialog.exe is 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 return 0 for console mode, 1 for graphic mode.
|
|
|
|
|
tinyfd_response is then filled with the retain solution.
|
|
|
|
|
possible values for tinyfd_response are (all lowercase)
|
|
|
|
|
for graphic mode:
|
|
|
|
|
windows_wchar windows
|
|
|
|
|
applescript kdialog zenity zenity3 matedialog qarma
|
|
|
|
|
python2-tkinter python3-tkinter python-dbus perl-dbus
|
|
|
|
|
gxmessage gmessage xmessage xdialog gdialog
|
|
|
|
|
for console mode:
|
|
|
|
|
dialog whiptail basicinput no_solution */
|
|
|
|
|
|
|
|
|
|
void tinyfd_beep();
|
|
|
|
|
|
|
|
|
|
int tinyfd_notifyPopup(
|
|
|
|
|
char const * const aTitle, /* NULL or "" */
|
|
|
|
|
char const * const aMessage, /* NULL or "" may contain \n \t */
|
|
|
|
|
char const * const aIconType); /* "info" "warning" "error" */
|
|
|
|
|
/* return has only meaning for tinyfd_query */
|
|
|
|
|
|
|
|
|
|
int tinyfd_messageBox(
|
|
|
|
|
char const * const aTitle , /* NULL or "" */
|
|
|
|
|
char const * const aMessage , /* NULL or "" may contain \n \t */
|
|
|
|
|
char const * const aDialogType , /* "ok" "okcancel" "yesno" "yesnocancel" */
|
|
|
|
|
char const * const aIconType , /* "info" "warning" "error" "question" */
|
|
|
|
|
int const aDefaultButton ) ;
|
|
|
|
|
/* 0 for cancel/no , 1 for ok/yes , 2 for no in yesnocancel */
|
|
|
|
|
|
|
|
|
|
char const * tinyfd_inputBox(
|
|
|
|
|
char const * const aTitle , /* NULL or "" */
|
|
|
|
|
char const * const aMessage , /* NULL or "" 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 , /* NULL or "" */
|
|
|
|
|
char const * const aDefaultPathAndFile , /* NULL or "" */
|
|
|
|
|
int const aNumOfFilterPatterns , /* 0 */
|
|
|
|
|
char const * const * const aFilterPatterns , /* NULL | {"*.jpg","*.png"} */
|
|
|
|
|
char const * const aSingleFilterDescription ) ; /* NULL | "text files" */
|
|
|
|
|
/* returns NULL on cancel */
|
|
|
|
|
|
|
|
|
|
char const * tinyfd_openFileDialog(
|
|
|
|
|
char const * const aTitle , /* NULL or "" */
|
|
|
|
|
char const * const aDefaultPathAndFile , /* NULL or "" */
|
|
|
|
|
int const aNumOfFilterPatterns , /* 0 */
|
|
|
|
|
char const * const * const aFilterPatterns , /* NULL | {"*.jpg","*.png"} */
|
|
|
|
|
char const * const aSingleFilterDescription , /* NULL | "image files" */
|
|
|
|
|
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 , /* NULL or "" */
|
|
|
|
|
char const * const aDefaultPath ) ; /* NULL or "" */
|
|
|
|
|
/* returns NULL on cancel */
|
|
|
|
|
|
|
|
|
|
char const * tinyfd_colorChooser(
|
|
|
|
|
char const * const aTitle , /* NULL or "" */
|
|
|
|
|
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 */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/************ NOT CROSS PLATFORM SECTION STARTS HERE ************************/
|
|
|
|
|
#ifdef _WIN32
|
|
|
|
|
#ifndef TINYFD_NOLIB
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
int tinyfd_notifyPopupW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aMessage, /* NULL or L"" may contain \n \t */
|
|
|
|
|
wchar_t const * const aIconType); /* L"info" L"warning" L"error" */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
int tinyfd_messageBoxW(
|
|
|
|
|
wchar_t const * const aTitle , /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aMessage, /* NULL or L"" may contain \n \t */
|
|
|
|
|
wchar_t const * const aDialogType, /* L"ok" L"okcancel" L"yesno" */
|
|
|
|
|
wchar_t const * const aIconType, /* L"info" L"warning" L"error" L"question" */
|
|
|
|
|
int const aDefaultButton ); /* 0 for cancel/no , 1 for ok/yes */
|
|
|
|
|
/* returns 0 for cancel/no , 1 for ok/yes */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
wchar_t const * tinyfd_inputBoxW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aMessage, /* NULL or L"" may NOT contain \n nor \t */
|
|
|
|
|
wchar_t const * const aDefaultInput ); /* L"" , if NULL it's a passwordBox */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
wchar_t const * tinyfd_saveFileDialogW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aDefaultPathAndFile, /* NULL or L"" */
|
|
|
|
|
int const aNumOfFilterPatterns, /* 0 */
|
|
|
|
|
wchar_t const * const * const aFilterPatterns, /* NULL or {L"*.jpg",L"*.png"} */
|
|
|
|
|
wchar_t const * const aSingleFilterDescription); /* NULL or L"image files" */
|
|
|
|
|
/* returns NULL on cancel */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
wchar_t const * tinyfd_openFileDialogW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aDefaultPathAndFile, /* NULL or L"" */
|
|
|
|
|
int const aNumOfFilterPatterns , /* 0 */
|
|
|
|
|
wchar_t const * const * const aFilterPatterns, /* NULL {L"*.jpg",L"*.png"} */
|
|
|
|
|
wchar_t const * const aSingleFilterDescription, /* NULL or L"image files" */
|
|
|
|
|
int const aAllowMultipleSelects ) ; /* 0 or 1 */
|
|
|
|
|
/* in case of multiple files, the separator is | */
|
|
|
|
|
/* returns NULL on cancel */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
wchar_t const * tinyfd_selectFolderDialogW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aDefaultPath); /* NULL or L"" */
|
|
|
|
|
/* returns NULL on cancel */
|
|
|
|
|
|
|
|
|
|
/* windows only - utf-16 version */
|
|
|
|
|
wchar_t const * tinyfd_colorChooserW(
|
|
|
|
|
wchar_t const * const aTitle, /* NULL or L"" */
|
|
|
|
|
wchar_t const * const aDefaultHexRGB, /* NULL or L"#FF0000" */
|
|
|
|
|
unsigned char const aDefaultRGB[3] , /* { 0 , 255 , 255 } */
|
|
|
|
|
unsigned char aoResultRGB[3] ) ; /* { 0 , 0 , 0 } */
|
|
|
|
|
/* returns the hexcolor as a string L"#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 */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#endif /*TINYFD_NOLIB*/
|
|
|
|
|
#else /*_WIN32*/
|
|
|
|
|
|
|
|
|
|
/* unix zenity only */
|
|
|
|
|
char const * tinyfd_arrayDialog(
|
|
|
|
|
char const * const aTitle , /* NULL or "" */
|
|
|
|
|
int const aNumOfColumns , /* 2 */
|
|
|
|
|
char const * const * const aColumns, /* {"Column 1","Column 2"} */
|
|
|
|
|
int const aNumOfRows, /* 2 */
|
|
|
|
|
char const * const * const aCells);
|
|
|
|
|
/* {"Row1 Col1","Row1 Col2","Row2 Col1","Row2 Col2"} */
|
|
|
|
|
|
|
|
|
|
#endif /*_WIN32 */
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif /* TINYFILEDIALOGS_H */
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
|
- This is not for android nor ios.
|
|
|
|
|
- The code is pure C, perfectly compatible with C++.
|
|
|
|
|
- the windows only wchar_t (utf-16) prototypes are in the header file
|
|
|
|
|
- windows is fully supported from XP to 10 (maybe even older versions)
|
|
|
|
|
- C# & LUA via dll, see example files
|
|
|
|
|
- OSX supported from 10.4 to latest (maybe even older versions)
|
|
|
|
|
- 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 char defaults to MBCS, set tinyfd_winUtf8=1 to use UTF-8
|
|
|
|
|
- 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 one of the following:
|
|
|
|
|
applescript, kdialog, zenity, matedialog, shellementary, qarma,
|
|
|
|
|
python (2 or 3)/tkinter/python-dbus (optional), Xdialog
|
|
|
|
|
or dialog (opens terminal if running without console) or xterm.
|
|
|
|
|
- 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 (requires xterm + bash).
|
|
|
|
|
- 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.
|
|
|
|
|
- On windows, Console mode is not implemented for wchar_T UTF-16.
|
|
|
|
|
- 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://macappstore.org/dialog or 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.
|
|
|
|
|
- You can query the type of dialog that will be use.
|
|
|
|
|
- MinGW needs gcc >= v4.9 otherwise some headers are incomplete.
|
|
|
|
|
- The Hello World (and a bit more) is on the sourceforge site:
|
|
|
|
|
*/
|
Christopher Mosher