JarCastinggdx-nativefilechooser
Choose files with LibGDX. Just like in the title. Natively. Also, asynchronously.
This library allows you to asynchronously browse files with the native file chooser available on the platform.
Stuff is asynchronous.
Setup
Add the pretty bold parts into your build.gradle file:
project(":desktop") {
...
dependencies {
compile project(":core")
...
compile "games.spooky.gdx:gdx-nativefilechooser-desktop:1.0.0"
}
}
project(":android") {
...
dependencies {
compile project(":core")
...
compile "games.spooky.gdx:gdx-nativefilechooser-android:1.0.0"
}
}
project(":core") {
...
dependencies {
...
compile "games.spooky.gdx:gdx-nativefilechooser:1.0.0"
}
}
Usage
Add a NativeFileChooser
A more detailed version of this can be found in libGDX documentation.
It is assumed here that your project follows the basic structure of a libGDX project. You should then have a core project and as many platform-specific projects as intended.
Core
In the central class of your core project, the one that implements ApplicationListener, add a property of type NativeFileChooser like so:
public class MyAwesomeGame implements ApplicationListener {
NativeFileChooser fileChooser;
public MyAwesomeGame(NativeFileChooser fileChooser) {
super();
this.fileChooser = fileChooser;
}
...
}
Platform-specific
In the launcher class of your platform-specific project, pass the implementation of NativeFileChooser for this platform to the core class constructor.
On Android, it gives:
public class MyAwesomeGameAndroid extends AndroidApplication {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
...
initialize(new MyAwesomeGame(new AndroidFileChooser(this)), new AndroidApplicationConfiguration());
}
}
Use it
- Create a (mandatory)
NativeFileChooserConfigurationobject, stuff it with configuration details if you like. - Create a (also mandatory)
NativeFileChooserCallbackobject ready to react to anything that may happen. - Call the
chooseFilemethod from yourNativeFileChooser, giving the two objects above as arguments. - Live a fulfilling life.
Example - go get me some oggs
// Configure
NativeFileChooserConfiguration conf = new NativeFileChooserConfiguration();
// Starting from user's dir
conf.directory = Gdx.files.absolute(System.getProperty("user.home"));
// Filter out all files which do not have the .ogg extension and are not of an audio MIME type - belt and braces
conf.mimeFilter = "audio/*";
conf.nameFilter = new FilenameFilter() {
@Override
public boolean accept(File dir, String name) {
return name.endsWith("ogg");
}
};
// Add a nice title
conf.title = "Choose audio file";
fileChooser.chooseFile(conf, new NativeFileChooserCallback() {
@Override
public void onFileChosen(FileHandle file) {
// Do stuff with file, yay!
}
@Override
public void onCancellation() {
// Warn user how rude it can be to cancel developer's effort
}
@Override
public void onError(Exception exception) {
// Handle error (hint: use exception type)
}
});
Platform support
- Desktop (awt)
- Android
- iOS
- HTML
Moar 2 com plz?
Nope.
