nfde 0.0.9

Rust bindings for Native File Dialog Extended
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

#![allow(non_camel_case_types)]
#![allow(non_upper_case_globals)]

use std::os::raw::c_char;
use std::os::raw::c_uint;
use std::os::raw::c_void;

#[cfg(target_os = "windows")]
pub type nfdnchar_t = u16; // Windows

#[cfg(not(target_os = "windows"))]
pub type nfdnchar_t = c_char; // non-Windows

pub type nfdfiltersize_t = c_uint;

pub type nfdpathset_t = c_void;

#[repr(C)]
#[allow(dead_code)]
pub enum nfdresult_t {
    NFD_ERROR,
    NFD_OKAY,
    NFD_CANCEL,
}

#[repr(C)]
#[allow(dead_code)]
pub struct nfdnfilteritem_t {
    pub name: *mut nfdnchar_t, // note: the C API actually has *const nfdnchar_t, but we use *mut to avoid const casts here
    pub spec: *mut nfdnchar_t,
}

// We are using ptr==NULL to represent the lack of an enum (i.e. we already iterated to the end, or acquiring the enum failed).
// For Linux, it automatically becomes NULL when we reach the end, but we don't need to free the enum in Linux so it is okay.
#[repr(C)]
#[allow(dead_code)]
pub struct nfdpathsetenum_t {
    pub ptr: *mut c_void,
}

extern "C" {
    pub fn NFD_Init() -> nfdresult_t;
    pub fn NFD_Quit();
    pub fn NFD_GetError() -> *const c_char;
    pub fn NFD_FreePathN(filePath: *mut nfdnchar_t);
    pub fn NFD_OpenDialogN(
        outPath: *mut *mut nfdnchar_t,
        filterList: *const nfdnfilteritem_t,
        filterCount: nfdfiltersize_t,
        defaultPath: *const nfdnchar_t,
    ) -> nfdresult_t;
    pub fn NFD_OpenDialogMultipleN(
        outPaths: *mut *mut nfdpathset_t,
        filterList: *const nfdnfilteritem_t,
        filterCount: nfdfiltersize_t,
        defaultPath: *const nfdnchar_t,
    ) -> nfdresult_t;
    pub fn NFD_SaveDialogN(
        outPath: *mut *mut nfdnchar_t,
        filterList: *const nfdnfilteritem_t,
        filterCount: nfdfiltersize_t,
        defaultPath: *const nfdnchar_t,
        defaultName: *const nfdnchar_t,
    ) -> nfdresult_t;
    pub fn NFD_PickFolderN(
        outPath: *mut *mut nfdnchar_t,
        defaultPath: *const nfdnchar_t,
    ) -> nfdresult_t;
    pub fn NFD_PathSet_Free(pathSet: *mut nfdpathset_t);
    pub fn NFD_PathSet_GetEnum(
        pathSet: *mut nfdpathset_t,
        outEnumerator: *mut nfdpathsetenum_t,
    ) -> nfdresult_t;

    #[cfg(not(target_os = "linux"))]
    pub fn NFD_PathSet_FreeEnum(enumerator: *mut nfdpathsetenum_t);

    pub fn NFD_PathSet_EnumNextN(
        enumerator: *mut nfdpathsetenum_t,
        outPath: *mut *mut nfdnchar_t,
    ) -> nfdresult_t;
    #[cfg_attr(not(target_os = "linux"), link_name = "NFD_FreePathN")]
    pub fn NFD_PathSet_FreePathN(filePath: *mut nfdnchar_t);
}