mirror of
https://github.com/raysan5/raygui.git
synced 2025-12-25 10:22:33 -05:00
Updated to version 2.4.3 (June 2016)
This commit is contained in:
raysan5
996
styler/external/tinyfiledialogs.c
vendored
996
styler/external/tinyfiledialogs.c
vendored
File diff suppressed because it is too large
Load Diff
175
styler/external/tinyfiledialogs.h
vendored
175
styler/external/tinyfiledialogs.h
vendored
@ -1,20 +1,28 @@
|
||||
/*
|
||||
tinyfiledialogs.h
|
||||
unique header file of "tiny file dialogs" created [November 9, 2014]
|
||||
Copyright (c) 2014 - 2015 Guillaume Vareille http://ysengrin.com
|
||||
http://tinyfiledialogs.sourceforge.net
|
||||
_________
|
||||
/ \ tinyfiledialogs.h
|
||||
|tiny file| Unique header file of "tiny file dialogs" created [November 9, 2014]
|
||||
| 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.
|
||||
- and please, leave a review on Sourceforge. Thanks.
|
||||
- If you are using it on different hardware / OS / compiler.
|
||||
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
|
||||
v2.2 [July 9, 2015] zlib licence.
|
||||
Native dialog library for WINDOWS MAC OSX (10.4~10.11) GTK+ QT CONSOLE & more
|
||||
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
|
||||
or any GUI-less program, there is NO INIT & NO MAIN LOOP.
|
||||
The dialogs can be forced into console mode.
|
||||
Complement to OpenGL GLFW GLUT GLUI
|
||||
VTK SFML SDL Ogre Unity CEGUI ION MathGL
|
||||
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
|
||||
rather than with a C compiler, you need to comment out:
|
||||
if tinydialogs.c is compiled with a C++ compiler rather than with a C compiler
|
||||
(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 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 */
|
||||
char const * const aTitle , /* "" */
|
||||
char const * const aMessage , /* "" may contain \n \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 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 aDefaultPathAndFile , /* "" */
|
||||
int const aNumOfFilterPatterns , /* 0 */
|
||||
char const * const * const aFilterPatterns , /* NULL or {"*.jpg","*.png"} */
|
||||
char const * const aSingleFilterDescription ) ; /* NULL or "image files" */
|
||||
char const * const aTitle , /* "" */
|
||||
char const * const aDefaultPathAndFile , /* "" */
|
||||
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 , /* "" */
|
||||
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 or 1 */
|
||||
char const * const aTitle , /* "" */
|
||||
char const * const aDefaultPathAndFile , /* "" */
|
||||
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 , /* "" */
|
||||
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
|
||||
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,
|
||||
if the package dialog (and a console is present) or dialog.exe is installed.
|
||||
on windows it only make sense for console applications */
|
||||
|
||||
/* #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 */
|
||||
|
||||
/* not cross platform - zenity only */
|
||||
char const * tinyfd_arrayDialog (
|
||||
char const * const aTitle , /* "" */
|
||||
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"} */
|
||||
|
||||
#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
|
||||
or dialog (will open a terminal if running without console);
|
||||
- On unix you need applescript, zenity, matedialog, 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.
|
||||
@ -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.
|
||||
|
||||
- Here is the Hello World (and a bit more):
|
||||
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)
|
||||
- You can query the type of dialog that will be use.
|
||||
- There is the Hello World (and a bit more) on the sourceforge site:
|
||||
*/
|
||||
|
||||
|
||||
126
styler/external/tinyfiledialogs_readme.txt
vendored
126
styler/external/tinyfiledialogs_readme.txt
vendored
@ -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)
|
||||
Reference in New Issue
Block a user