public Class TinyFileDialogs

Curses dialogs are difficult to use, on windows they are only ascii and uses the unix backslash

0 (default) or 1.

Some systems don't set the environment variable DISPLAY even when a graphic display is present. Set this to 1 to tell tinyfiledialogs to assume the existence of a graphic display.

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, it can use the package dialog or dialog.exe. On windows it only make sense for console applications

Contains info about requirements.

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_wchar windows applescript kdialog zenity zenity3 matedialog
shellementary qarma yad python2-tkinter python3-tkinter python-dbus
perl-dbus gxmessage gmessage xmessage xdialog gdialog

For the console mode:

dialog whiptail basicinput no_solution

1 (default) or 0 : on unix, hide errors and warnings from called dialogs

0 (default) or 1 : on unix, prints the command line calls

Contains tinyfd current version number.

On windows, set to 1 if you want to use UTF-8.

LWJGL note: this is automatically set to 1.

Unsafe version of: colorChooser

Unsafe version of: getGlobalChar

Unsafe version of: getGlobalInt

Unsafe version of: inputBox

Unsafe version of: messageBox

Unsafe version of: notifyPopup

Unsafe version of: openFileDialog

Parameters

aNumOfFilterPatterns:int

the number of patterns in aFilterPatterns

Unsafe version of: saveFileDialog

Parameters

aNumOfFilterPatterns:int

the number of patterns in aFilterPatterns

Unsafe version of: selectFolderDialog

Unsafe version of: setGlobalInt

Displays a color chooser dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aDefaultHexRGB:ByteBuffer

NULL or "#FF0000"

aDefaultRGB:ByteBuffer

{ 0 , 255 , 255 }. Used only if aDefaultHexRGB is NULL.

aoResultRGB:ByteBuffer

returns the selected color. aDefaultRGB and aoResultRGB can be the same array.

Returns:String

the selected hexcolor as a string "#FF0000" or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Displays a color chooser dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aDefaultHexRGB:CharSequence

NULL or "#FF0000"

aDefaultRGB:ByteBuffer

{ 0 , 255 , 255 }. Used only if aDefaultHexRGB is NULL.

aoResultRGB:ByteBuffer

returns the selected color. aDefaultRGB and aoResultRGB can be the same array.

Returns:String

the selected hexcolor as a string "#FF0000" or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Parameters

aCharVariableName:ByteBuffer

one of:

version

needs

response

Returns:String

NULL on error

Annotations

@Nullable

@NativeType:char const *

Parameters

aCharVariableName:CharSequence

one of:

version

needs

response

Returns:String

NULL on error

Annotations

@Nullable

@NativeType:char const *

Parameters

aIntVariableName:ByteBuffer

one of:

verbose

silent

allowCursesDialogs

forceConsole

assumeGraphicDisplay

winUtf8

Returns:int

-1 on error

Parameters

aIntVariableName:CharSequence

one of:

verbose

silent

allowCursesDialogs

forceConsole

assumeGraphicDisplay

winUtf8

Returns:int

-1 on error

Displays an input dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aMessage:ByteBuffer

the message or NULL. May NOT contain \n and \t characters on Windows.

aDefaultInput:ByteBuffer

if NULL it's a password box

Returns:String

the input value or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Displays an input dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aMessage:CharSequence

the message or NULL. May NOT contain \n and \t characters on Windows.

aDefaultInput:CharSequence

if NULL it's a password box

Returns:String

the input value or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Displays a message dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aMessage:ByteBuffer

the message or NULL. It may contain \n and \t characters.

aDialogType:ByteBuffer

the dialog type. One of:

"ok"

"okcancel"

"yesno"

"yesnocancel"

aIconType:ByteBuffer

the icon type. One of:

"info"

"warning"

"error"

"question"

aDefaultButton:boolean

0 for cancel/no, 1 for ok/yes

Returns:boolean

0 for cancel/no, 1 for ok/yes, 2 for no in yesnocancel

Annotations

@NativeType:int

Displays a message dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aMessage:CharSequence

the message or NULL. It may contain \n and \t characters.

aDialogType:CharSequence

the dialog type. One of:

"ok"

"okcancel"

"yesno"

"yesnocancel"

aIconType:CharSequence

the icon type. One of:

"info"

"warning"

"error"

"question"

aDefaultButton:boolean

0 for cancel/no, 1 for ok/yes

Returns:boolean

0 for cancel/no, 1 for ok/yes, 2 for no in yesnocancel

Annotations

@NativeType:int

Displays a notification popup.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aMessage:ByteBuffer

the message or NULL. It may contain \n and \t characters.

aIconType:ByteBuffer

the icon type. One of:

"info"

"warning"

"error"

Displays a notification popup.

Parameters

aTitle:CharSequence

the dialog title or NULL

aMessage:CharSequence

the message or NULL. It may contain \n and \t characters.

aIconType:CharSequence

the icon type. One of:

"info"

"warning"

"error"

Displays a file open dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aDefaultPathAndFile:ByteBuffer

the default path and/or file or NULL

aFilterPatterns:PointerBuffer

an array of file type patterns (NULL or {"*.jpg","*.png"}

aSingleFilterDescription:ByteBuffer

NULL or "image files"

aAllowMultipleSelects:boolean

if true, multiple selections are allowed

Returns:String

the file(s) selected or NULL on cancel. In case of multiple files, the separator is '|'.

Annotations

@Nullable

@NativeType:char const *

Displays a file open dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aDefaultPathAndFile:CharSequence

the default path and/or file or NULL

aFilterPatterns:PointerBuffer

an array of file type patterns (NULL or {"*.jpg","*.png"}

aSingleFilterDescription:CharSequence

NULL or "image files"

aAllowMultipleSelects:boolean

if true, multiple selections are allowed

Returns:String

the file(s) selected or NULL on cancel. In case of multiple files, the separator is '|'.

Annotations

@Nullable

@NativeType:char const *

Displays a file save dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aDefaultPathAndFile:ByteBuffer

the default path and/or file or NULL

aFilterPatterns:PointerBuffer

an array of file type patterns (NULL or {"*.jpg","*.png"}

aSingleFilterDescription:ByteBuffer

NULL or "image files"

Returns:String

the selected file path or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Displays a file save dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aDefaultPathAndFile:CharSequence

the default path and/or file or NULL

aFilterPatterns:PointerBuffer

an array of file type patterns (NULL or {"*.jpg","*.png"}

aSingleFilterDescription:CharSequence

NULL or "image files"

Returns:String

the selected file path or NULL on cancel

Annotations

@Nullable

@NativeType:char const *

Displays a folder selection dialog.

Parameters

aTitle:ByteBuffer

the dialog title or NULL

aDefaultPath:ByteBuffer

the default path or NULL

Annotations

@Nullable

@NativeType:char const *

Displays a folder selection dialog.

Parameters

aTitle:CharSequence

the dialog title or NULL

aDefaultPath:CharSequence

the default path or NULL

Annotations

@Nullable

@NativeType:char const *

Parameters

aIntVariableName:ByteBuffer

one of:

verbose

silent

allowCursesDialogs

forceConsole

assumeGraphicDisplay

winUtf8

Returns:int

-1 on error

Parameters

aIntVariableName:CharSequence

one of:

verbose

silent

allowCursesDialogs

forceConsole

assumeGraphicDisplay

winUtf8

Returns:int

-1 on error