mirror of
https://github.com/tildearrow/furnace.git
synced 2024-12-30 03:21:27 +00:00
64 lines
3.1 KiB
Markdown
64 lines
3.1 KiB
Markdown
# Portable File Dialogs
|
|
|
|
A free C++11 file dialog library.
|
|
|
|
- works on Windows, Mac OS X, Linux
|
|
- **single-header**, no extra library dependencies
|
|
- **synchronous *or* asynchronous** (does not block the rest of your program!)
|
|
- **cancelable** (kill asynchronous dialogues without user interaction)
|
|
- **secure** (immune to shell-quote vulnerabilities)
|
|
|
|
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/a25d3fd6959a4333871f630ac70b6e09)](https://www.codacy.com/manual/samhocevar/portable-file-dialogs?utm_source=github.com&utm_medium=referral&utm_content=samhocevar/portable-file-dialogs&utm_campaign=Badge_Grade)
|
|
|
|
## Status
|
|
|
|
The library is now pretty robust. It is not as feature-complete as
|
|
[Tiny File Dialogs](https://sourceforge.net/projects/tinyfiledialogs/),
|
|
but has asynchonous dialogs, more maintainable code, and fewer potential
|
|
security issues.
|
|
|
|
The currently available backends are:
|
|
|
|
- Win32 API (all known versions of Windows)
|
|
- Mac OS X (using AppleScript)
|
|
- GNOME desktop (using [Zenity](https://en.wikipedia.org/wiki/Zenity) or its clones Matedialog and Qarma)
|
|
- KDE desktop (using [KDialog](https://github.com/KDE/kdialog))
|
|
|
|
Experimental support for Emscripten is on its way.
|
|
|
|
## Documentation
|
|
|
|
- [`pfd`](doc/pfd.md) general documentation
|
|
- [`pfd::message`](doc/message.md) message box
|
|
- [`pfd::notify`](doc/notify.md) notification
|
|
- [`pfd::open_file`](doc/open_file.md) file open
|
|
- [`pfd::save_file`](doc/save_file.md) file save
|
|
- [`pfd::select_folder`](doc/select_folder.md) folder selection
|
|
|
|
## History
|
|
|
|
- 0.1.0 (July 16, 2020): first public release
|
|
|
|
## Screenshots (Windows 10)
|
|
|
|
![warning-win32](https://user-images.githubusercontent.com/245089/47136607-76919a00-d2b4-11e8-8f42-e2d62c4f9570.png)
|
|
![notify-win32](https://user-images.githubusercontent.com/245089/47142453-2ff76c00-d2c3-11e8-871a-1a110ac91eb2.png)
|
|
![open-win32](https://user-images.githubusercontent.com/245089/47155865-0f8cd900-d2e6-11e8-8041-1e20b6f77dee.png)
|
|
|
|
## Screenshots (Mac OS X, dark theme)
|
|
|
|
![warning-osxdark](https://user-images.githubusercontent.com/245089/56053001-22dba700-5d53-11e9-8233-ca7a2c58188d.png)
|
|
![notify-osxdark](https://user-images.githubusercontent.com/245089/56053188-bc0abd80-5d53-11e9-8298-68aa96315c6c.png)
|
|
![open-osxdark](https://user-images.githubusercontent.com/245089/56053378-39363280-5d54-11e9-9583-9f1c978fa0db.png)
|
|
|
|
## Screenshots (Linux, GNOME desktop)
|
|
|
|
![warning-gnome](https://user-images.githubusercontent.com/245089/47136608-772a3080-d2b4-11e8-9e1d-60a7e743e908.png)
|
|
![notify-gnome](https://user-images.githubusercontent.com/245089/47142455-30900280-d2c3-11e8-8b76-ea16c7e502d4.png)
|
|
![open-gnome](https://user-images.githubusercontent.com/245089/47155867-0f8cd900-d2e6-11e8-93af-275636491ec4.png)
|
|
|
|
## Screenshots (Linux, KDE Plasma desktop)
|
|
|
|
![warning-kde](https://user-images.githubusercontent.com/245089/47149255-4dcccd00-d2d3-11e8-84c9-f85612784680.png)
|
|
![notify-kde](https://user-images.githubusercontent.com/245089/47149206-27a72d00-d2d3-11e8-8f1b-96e462f08c2b.png)
|
|
![open-kde](https://user-images.githubusercontent.com/245089/47155866-0f8cd900-d2e6-11e8-8006-f14b948afc55.png)
|