cyfaust 0.1.0__cp311-cp311-macosx_15_0_arm64.whl

cyfaust/common.pxd

@@ -0,0 +1,5 @@
+
+
+cdef class ParamArray:
+    cdef const char ** argv
+    cdef int argc

cyfaust/common.pyx

@@ -0,0 +1,61 @@
+# distutils: language = c++
+
+import os
+
+from libc.stdlib cimport malloc, free
+
+## ---------------------------------------------------------------------------
+## python c-api functions
+##
+
+cdef extern from "Python.h":
+    char* PyUnicode_AsUTF8(object unicode)
+
+## ---------------------------------------------------------------------------
+## common utility functions
+##
+
+def get_package_resources() -> tuple[str, str, str, str]:
+    """provides the paths of package architecture and library files."""
+    resources = os.path.join(os.path.dirname(__file__), "resources")
+    archs = os.path.join(resources, "architecture")
+    libs = os.path.join(resources, "libraries")
+    return ("-A", archs, "-I", libs)
+
+PACKAGE_RESOURCES = get_package_resources()
+
+## ---------------------------------------------------------------------------
+## common utility classes
+##
+
+cdef class ParamArray:
+    """wrapper classs around a faust parameter array.
+    
+    Automatically adds `PACKAGE_RESOURCES` paths (faust stdlibs and architecture) 
+    to the params.
+    """
+    # cdef const char ** argv
+    # cdef int argc
+
+    def __cinit__(self, tuple ptuple):
+        ptuple = ptuple + PACKAGE_RESOURCES
+        self.argc = len(ptuple)
+        self.argv = <const char **>malloc(self.argc * sizeof(char *))
+        for i in range(self.argc):
+            self.argv[i] = PyUnicode_AsUTF8(ptuple[i])
+
+    def __iter__(self):
+        for i in range(self.argc):
+            yield self.argv[i].decode()
+
+    def dump(self):
+        for i in self:
+            print(i)
+
+    def as_list(self):
+        return list(self)
+
+    def __dealloc__(self):
+        if self.argv:
+            free(self.argv)
+

cyfaust/faust_box.pxd

@@ -0,0 +1,298 @@
+# distutils: language = c++
+
+from libcpp.string cimport string
+from libcpp.vector cimport vector
+
+cdef extern from "faust/dsp/libfaust-box.h":
+    cdef cppclass CTreeBase
+    ctypedef vector[CTreeBase*] tvec
+    ctypedef CTreeBase* Signal
+    ctypedef CTreeBase* Box
+    ctypedef CTreeBase* Tree
+
+    ctypedef Tree (*prim0)()
+    ctypedef Tree (*prim1)(Tree x)
+    ctypedef Tree (*prim2)(Tree x, Tree y)
+    ctypedef Tree (*prim3)(Tree x, Tree y, Tree z)
+    ctypedef Tree (*prim4)(Tree w, Tree x, Tree y, Tree z)
+    ctypedef Tree (*prim5)(Tree v, Tree w, Tree x, Tree y, Tree z)
+
+    const char* prim0name(prim0)
+    const char* prim1name(prim1)
+    const char* prim2name(prim2)
+    const char* prim3name(prim3)
+    const char* prim4name(prim4)
+    const char* prim5name(prim5)
+
+    # Return the name parameter of a foreign function
+    const char* ffname(Signal s)
+
+    # Return the arity of a foreign function.
+    int ffarity(Signal s)
+
+    cpdef enum SType:
+        kSInt
+        kSReal
+
+    ctypedef vector[SType] svec
+    ctypedef vector[string] nvec
+
+    cpdef enum SOperator:
+        kAdd
+        kSub
+        kMul
+        kDiv
+        kRem
+        kLsh
+        kARsh
+        kLRsh
+        kGT
+        kLT
+        kGE
+        kLE
+        kEQ
+        kNE
+        kAND
+        kOR
+        kXOR
+
+    cdef cppclass dsp_factory_base
+
+    # Print the box
+    string printBox(Box box, bint shared, int max_size)
+
+    # Print the signal
+    string printSignal(Signal sig, bint shared, int max_size)
+
+
+    bint getDefNameProperty(Box b, Box& id)
+    string extractName(Box full_label)
+    void createLibContext()
+    void destroyLibContext()
+
+    bint isNil(Box b)
+    const char* tree2str(Box b)
+    int tree2int(Box b)
+    void* getUserData(Box b)
+    Box boxInt(int n)
+    Box boxReal(double n)
+    Box boxWire()
+    Box boxCut()
+    Box boxSeq(Box x, Box y)
+    Box boxPar(Box x, Box y)
+    Box boxPar3(Box x, Box y, Box z)
+    Box boxPar4(Box a, Box b, Box c, Box d)
+    Box boxPar5(Box a, Box b, Box c, Box d, Box e)
+    Box boxSplit(Box x, Box y)
+    Box boxMerge(Box x, Box y)
+    Box boxRec(Box x, Box y)
+    Box boxRoute(Box n, Box m, Box r)
+    Box boxDelay()
+    Box boxDelay(Box b, Box del_)
+    Box boxIntCast()
+    Box boxIntCast(Box b)
+    Box boxFloatCast()
+    Box boxFloatCast(Box b)
+    Box boxReadOnlyTable()
+    Box boxReadOnlyTable(Box n, Box init, Box ridx)
+    Box boxWriteReadTable()
+    Box boxWriteReadTable(Box n, Box init, Box widx, Box wsig, Box ridx)
+
+    Box boxWaveform(const tvec& wf)
+    Box boxSoundfile(const string& label, Box chan)
+    Box boxSoundfile(const string& label, Box chan, Box part, Box ridx)
+    Box boxSelect2()
+    Box boxSelect2(Box selector, Box b1, Box b2)
+    Box boxSelect3()
+    Box boxSelect3(Box selector, Box b1, Box b2, Box b3)
+    Box boxFFun(SType rtype, nvec names, svec atypes, const string& incfile, const string& libfile)
+    Box boxFConst(SType type, const string& name, const string& incfile)
+    Box boxFVar(SType type, const string& name, const string& incfile)
+    Box boxBinOp(SOperator op)
+    Box boxBinOp(SOperator op, Box b1, Box b2)
+    Box boxAdd()
+    Box boxAdd(Box b1, Box b2)
+    Box boxSub()
+    Box boxSub(Box b1, Box b2)
+    Box boxMul()
+    Box boxMul(Box b1, Box b2)
+    Box boxDiv()
+    Box boxDiv(Box b1, Box b2)
+    Box boxRem()
+    Box boxRem(Box b1, Box b2)
+
+    Box boxLeftShift()
+    Box boxLeftShift(Box b1, Box b2)
+    Box boxLRightShift()
+    Box boxLRightShift(Box b1, Box b2)
+    Box boxARightShift()
+    Box boxARightShift(Box b1, Box b2)
+
+    Box boxGT()
+    Box boxGT(Box b1, Box b2)
+    Box boxLT()
+    Box boxLT(Box b1, Box b2)
+    Box boxGE()
+    Box boxGE(Box b1, Box b2)
+    Box boxLE()
+    Box boxLE(Box b1, Box b2)
+    Box boxEQ()
+    Box boxEQ(Box b1, Box b2)
+    Box boxNE()
+    Box boxNE(Box b1, Box b2)
+
+    Box boxAND()
+    Box boxAND(Box b1, Box b2)
+    Box boxOR()
+    Box boxOR(Box b1, Box b2)
+    Box boxXOR()
+    Box boxXOR(Box b1, Box b2)
+
+    Box boxAbs()
+    Box boxAbs(Box x)
+    Box boxAcos()
+    Box boxAcos(Box x)
+    Box boxTan()
+    Box boxTan(Box x)
+    Box boxSqrt()
+    Box boxSqrt(Box x)
+    Box boxSin()
+    Box boxSin(Box x)
+    Box boxRint()
+    Box boxRint(Box x)
+    Box boxRound()
+    Box boxRound(Box x)
+    Box boxLog()
+    Box boxLog(Box x)
+    Box boxLog10()
+    Box boxLog10(Box x)
+    Box boxFloor()
+    Box boxFloor(Box x)
+    Box boxExp()
+    Box boxExp(Box x)
+    Box boxExp10()
+    Box boxExp10(Box x)
+    Box boxCos()
+    Box boxCos(Box x)
+    Box boxCeil()
+    Box boxCeil(Box x)
+    Box boxAtan()
+    Box boxAtan(Box x)
+    Box boxAsin()
+    Box boxAsin(Box x)
+
+    Box boxRemainder()
+    Box boxRemainder(Box b1, Box b2)
+    Box boxPow()
+    Box boxPow(Box b1, Box b2)
+    Box boxMin()
+    Box boxMin(Box b1, Box b2)
+    Box boxMax()
+    Box boxMax(Box b1, Box b2)
+    Box boxFmod()
+    Box boxFmod(Box b1, Box b2)
+    Box boxAtan2()
+    Box boxAtan2(Box b1, Box b2)
+
+    Box boxButton(const string& label)
+    Box boxCheckbox(const string& label)
+    Box boxVSlider(const string& label, Box init, Box min, Box max, Box step)
+    Box boxHSlider(const string& label, Box init, Box min, Box max, Box step)
+    Box boxNumEntry(const string& label, Box init, Box min, Box max, Box step)
+    Box boxVBargraph(const string& label, Box min, Box max)
+    Box boxVBargraph(const string& label, Box min, Box max, Box x)
+    Box boxHBargraph(const string& label, Box min, Box max)
+    Box boxHBargraph(const string& label, Box min, Box max, Box x)
+    Box boxVGroup(const string& label, Box group)
+    Box boxHGroup(const string& label, Box group)
+    Box boxTGroup(const string& label, Box group)
+    Box boxAttach()
+    Box boxAttach(Box b1, Box b2)
+    Box boxPrim2(prim2 foo)
+
+    bint isBoxAbstr(Box t)
+    bint isBoxAbstr(Box t, Box& x, Box& y)
+    bint isBoxAccess(Box t, Box& exp, Box& id)
+    bint isBoxAppl(Box t)
+    bint isBoxAppl(Box t, Box& x, Box& y)
+    bint isBoxButton(Box b)
+    bint isBoxButton(Box b, Box& lbl)
+    bint isBoxCase(Box b)
+    bint isBoxCase(Box b, Box& rules)
+    bint isBoxCheckbox(Box b)
+    bint isBoxCheckbox(Box b, Box& lbl)
+    bint isBoxComponent(Box b, Box& filename)
+    bint isBoxCut(Box t)
+    bint isBoxEnvironment(Box b)
+    bint isBoxError(Box t)
+    bint isBoxFConst(Box b)
+    bint isBoxFConst(Box b, Box& type, Box& name, Box& file)
+    bint isBoxFFun(Box b)
+    bint isBoxFFun(Box b, Box& ff)
+    bint isBoxFVar(Box b)
+    bint isBoxFVar(Box b, Box& type, Box& name, Box& file)
+    bint isBoxHBargraph(Box b)
+    bint isBoxHBargraph(Box b, Box& lbl, Box& min, Box& max)
+    bint isBoxHGroup(Box b)
+    bint isBoxHGroup(Box b, Box& lbl, Box& x)
+    bint isBoxHSlider(Box b)
+    bint isBoxHSlider(Box b, Box& lbl, Box& cur, Box& min, Box& max, Box& step)
+    bint isBoxIdent(Box t)
+    bint isBoxIdent(Box t, const char** str)
+    bint isBoxInputs(Box t, Box& x)
+    bint isBoxInt(Box t)
+    bint isBoxInt(Box t, int* i)
+    bint isBoxIPar(Box t, Box& x, Box& y, Box& z)
+    bint isBoxIProd(Box t, Box& x, Box& y, Box& z)
+    bint isBoxISeq(Box t, Box& x, Box& y, Box& z)
+    bint isBoxISum(Box t, Box& x, Box& y, Box& z)
+    bint isBoxLibrary(Box b, Box& filename)
+    bint isBoxMerge(Box t, Box& x, Box& y)
+    bint isBoxMetadata(Box b, Box& exp, Box& mdlist)
+    bint isBoxNumEntry(Box b)
+    bint isBoxNumEntry(Box b, Box& lbl, Box& cur, Box& min, Box& max, Box& step)
+    bint isBoxOutputs(Box t, Box& x)
+    bint isBoxPar(Box t, Box& x, Box& y)
+    bint isBoxPrim0(Box b)
+    bint isBoxPrim1(Box b)
+    bint isBoxPrim2(Box b)
+    bint isBoxPrim3(Box b)
+    bint isBoxPrim4(Box b)
+    bint isBoxPrim5(Box b)
+    bint isBoxPrim0(Box b, prim0* p)
+    bint isBoxPrim1(Box b, prim1* p)
+    bint isBoxPrim2(Box b, prim2* p)
+    bint isBoxPrim3(Box b, prim3* p)
+    bint isBoxPrim4(Box b, prim4* p)
+    bint isBoxPrim5(Box b, prim5* p)
+    bint isBoxReal(Box t)
+    bint isBoxReal(Box t, double* r)
+    bint isBoxRec(Box t, Box& x, Box& y)
+    bint isBoxRoute(Box b, Box& n, Box& m, Box& r)
+    bint isBoxSeq(Box t, Box& x, Box& y)
+    bint isBoxSlot(Box t)
+    bint isBoxSlot(Box t, int* id)
+    bint isBoxSoundfile(Box b)
+    bint isBoxSoundfile(Box b, Box& label, Box& chan)
+    bint isBoxSplit(Box t, Box& x, Box& y)
+    bint isBoxSymbolic(Box t)
+    bint isBoxSymbolic(Box t, Box& slot, Box& body)
+    bint isBoxTGroup(Box b)
+    bint isBoxTGroup(Box b, Box& lbl, Box& x)
+    bint isBoxVBargraph(Box b)
+    bint isBoxVBargraph(Box b, Box& lbl, Box& min, Box& max)
+    bint isBoxVGroup(Box b)
+    bint isBoxVGroup(Box b, Box& lbl, Box& x)
+    bint isBoxVSlider(Box b)
+    bint isBoxVSlider(Box b, Box& lbl, Box& cur, Box& min, Box& max, Box& step)
+    bint isBoxWaveform(Box b)
+    bint isBoxWire(Box t)
+    bint isBoxWithLocalDef(Box t, Box& body, Box& ldef)
+
+    Box DSPToBoxes(const string& name_app, const string& dsp_content, int argc, const char* argv[], int* inputs, int* outputs, string& error_msg)
+    bint getBoxType(Box box, int* inputs, int* outputs)
+    tvec boxesToSignals(Box box, string& error_msg)
+    string createSourceFromBoxes(const string& name_app, Box box, const string& lang, int argc, const char* argv[], string& error_msg)
+
+
+

cyfaust/faust_box_oo.pyx

@@ -0,0 +1,66 @@
+
+cdef class Button(Box):
+    cdef string label
+
+    def __cinit__(self, str lbl):
+        self.ptr = <fb.Box>fb.boxButton(lbl.encode('utf8'))
+
+    @staticmethod
+    cdef Button from_ptr(fb.Box ptr, bint ptr_owner=False):
+        """Wrap external button from pointer"""
+        cdef Button box = Button.__new__(Button)
+        box.ptr = ptr
+        return box
+
+    @property
+    def name(self):
+        return self.label.decode()
+
+    def is_button(self) -> bool:
+        return fb.isBoxButton(self.ptr)
+
+    def update(self):
+        cdef fb.Box lbl = NULL
+        if fb.isBoxButton(self.ptr, lbl):
+            self.label = fb.extractName(lbl)
+
+
+cdef class Int(Box):
+
+    def __cinit__(self, int value):
+        self.ptr = <fb.Box>fb.boxInt(value)
+
+    @staticmethod
+    cdef Int from_ptr(fb.Box ptr, bint ptr_owner=False):
+        """Wrap external factory from pointer"""
+        cdef Int box = Int.__new__(Int)
+        box.ptr = ptr
+        return box
+
+
+cdef class Int:
+    cdef fb.Box ptr
+
+    def __cinit__(self, int value):
+        self.ptr = <fb.Box>fb.boxInt(value)
+
+    @staticmethod
+    cdef Int from_ptr(fb.Box ptr, bint ptr_owner=False):
+        """Wrap external factory from pointer"""
+        cdef Int box = Int.__new__(Int)
+        box.ptr = ptr
+        return box
+
+    def print(self, shared: bool = False, max_size: int = 256):
+        """Print this box."""
+        print(fb.printBox(self.ptr, shared, max_size).decode())
+
+    def __add__(self, Box other):
+        """Add this box to another."""
+        cdef fb.Box b = fb.boxAdd(self.ptr, other.ptr)
+        return Box.from_ptr(b)
+
+    def __radd__(self, Box other):
+        """Reverse add this box to another."""
+        cdef fb.Box b = fb.boxAdd(self.ptr, other.ptr)
+        return Box.from_ptr(b)

cyfaust/faust_gui.pxd

@@ -0,0 +1,261 @@
+"""
+Provides cython header interface to some faust/gui/*.h files
+
+"""
+from libcpp.string cimport string
+from libcpp.vector cimport vector
+from libcpp.map cimport map
+
+# DEF INCLUDE_SNDFILE = True
+
+# Forward declaration - will be fully defined in faust_interp.pxd
+cdef extern from "faust/dsp/dsp.h":
+    cdef cppclass dsp
+
+cdef extern from "faust/gui/CInterface.h":
+    ctypedef float FAUSTFLOAT
+    
+    # Function pointer types for UI interface
+    ctypedef void (*openTabBoxFun)(void* ui_interface, const char* label)
+    ctypedef void (*openHorizontalBoxFun)(void* ui_interface, const char* label)
+    ctypedef void (*openVerticalBoxFun)(void* ui_interface, const char* label)
+    ctypedef void (*closeBoxFun)(void* ui_interface)
+    ctypedef void (*addButtonFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone)
+    ctypedef void (*addCheckButtonFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone)
+    ctypedef void (*addVerticalSliderFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+    ctypedef void (*addHorizontalSliderFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+    ctypedef void (*addNumEntryFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+    ctypedef void (*addHorizontalBargraphFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone, FAUSTFLOAT min, FAUSTFLOAT max)
+    ctypedef void (*addVerticalBargraphFun)(void* ui_interface, const char* label, FAUSTFLOAT* zone, FAUSTFLOAT min, FAUSTFLOAT max)
+    ctypedef void (*addSoundfileFun)(void* ui_interface, const char* label, const char* url, void** sf_zone)
+    ctypedef void (*declareFun)(void* ui_interface, FAUSTFLOAT* zone, const char* key, const char* value)
+    
+    # UIGlue structure for C interface
+    ctypedef struct UIGlue:
+        void* uiInterface
+        openTabBoxFun openTabBox
+        openHorizontalBoxFun openHorizontalBox
+        openVerticalBoxFun openVerticalBox
+        closeBoxFun closeBox
+        addButtonFun addButton
+        addCheckButtonFun addCheckButton
+        addVerticalSliderFun addVerticalSlider
+        addHorizontalSliderFun addHorizontalSlider
+        addNumEntryFun addNumEntry
+        addHorizontalBargraphFun addHorizontalBargraph
+        addVerticalBargraphFun addVerticalBargraph
+        addSoundfileFun addSoundfile
+        declareFun declare
+    
+    # Function pointer types for Meta interface
+    ctypedef void (*metaDeclareFun)(void* ui_interface, const char* key, const char* value)
+    
+    # MetaGlue structure for C interface
+    ctypedef struct MetaGlue:
+        void* metaInterface
+        metaDeclareFun declare
+    
+    # DSP interface function pointer types
+    ctypedef char dsp_imp
+    ctypedef dsp_imp* (*newDspFun)()
+    ctypedef void (*destroyDspFun)(dsp_imp* dsp)
+    ctypedef int (*getNumInputsFun)(dsp_imp* dsp)
+    ctypedef int (*getNumOutputsFun)(dsp_imp* dsp)
+    ctypedef void (*buildUserInterfaceFun)(dsp_imp* dsp, UIGlue* ui)
+    ctypedef int (*getSampleRateFun)(dsp_imp* dsp)
+    ctypedef void (*initFun)(dsp_imp* dsp, int sample_rate)
+    ctypedef void (*classInitFun)(int sample_rate)
+    ctypedef void (*staticInitFun)(dsp_imp* dsp, int sample_rate)
+    ctypedef void (*instanceInitFun)(dsp_imp* dsp, int sample_rate)
+    ctypedef void (*instanceConstantsFun)(dsp_imp* dsp, int sample_rate)
+    ctypedef void (*instanceResetUserInterfaceFun)(dsp_imp* dsp)
+    ctypedef void (*instanceClearFun)(dsp_imp* dsp)
+    ctypedef void (*computeFun)(dsp_imp* dsp, int len, FAUSTFLOAT** inputs, FAUSTFLOAT** outputs)
+    ctypedef void (*metadataFun)(MetaGlue* meta)
+    
+    # Memory manager function pointer types
+    ctypedef void* (*allocateFun)(void* manager_interface, size_t size)
+    ctypedef void (*destroyFun)(void* manager_interface, void* ptr)
+    
+    # MemoryManagerGlue structure for C interface
+    ctypedef struct MemoryManagerGlue:
+        void* managerInterface
+        allocateFun allocate
+        destroyFun destroy
+
+cdef extern from "faust/gui/meta.h":
+    cdef cppclass Meta:
+        void declare(const char* key, const char* value)
+
+cdef extern from *:
+    """
+    #include <map>
+    #include <string>
+    #include "faust/gui/meta.h"
+
+    // MetaCollector: A Meta implementation that collects metadata into a map
+    class MetaCollector : public Meta {
+    private:
+        std::map<std::string, std::string> fMeta;
+    public:
+        MetaCollector() {}
+        virtual ~MetaCollector() {}
+
+        void declare(const char* key, const char* value) override {
+            fMeta[key] = value;
+        }
+
+        const std::map<std::string, std::string>& getMeta() const {
+            return fMeta;
+        }
+    };
+    """
+    cdef cppclass MetaCollector(Meta):
+        MetaCollector() except +
+        void declare(const char* key, const char* value)
+        const map[string, string]& getMeta()
+
+cdef extern from "faust/gui/UI.h":
+    cdef cppclass UIReal[REAL]:
+        UIReal() except +
+        # widget's layouts
+        void openTabBox(const char* label)
+        void openHorizontalBox(const char* label)
+        void openVerticalBox(const char* label)
+        void closeBox()
+        # active widgets
+        void addButton(const char* label, REAL* zone)
+        void addCheckButton(const char* label, REAL* zone)
+        void addVerticalSlider(const char* label, REAL* zone, REAL init, REAL min, REAL max, REAL step)
+        void addHorizontalSlider(const char* label, REAL* zone, REAL init, REAL min, REAL max, REAL step)
+        void addNumEntry(const char* label, REAL* zone, REAL init, REAL min, REAL max, REAL step)
+        # passive widgets
+        void addHorizontalBargraph(const char* label, REAL* zone, REAL min, REAL max)
+        void addVerticalBargraph(const char* label, REAL* zone, REAL min, REAL max)
+        # soundfiles - excluded because UIReal is a template base class not directly exposed
+        # Use SoundUI class instead (see below) for soundfile functionality
+        # void addSoundfile(const char* label, const char* filename, Soundfile** sf_zone)
+        # metadata declarations
+        void declare(REAL* zone, const char* key, const char* value)
+
+    cdef cppclass UI(UIReal[FAUSTFLOAT]):
+        UI() except +
+        # void declare(const char* key, const char* value)
+
+cdef extern from "faust/gui/GUI.h":
+    cdef cppclass GUI:
+        GUI()
+        void addCallback(FAUSTFLOAT* zone, void* foo, void* data)
+        void removeCallback(FAUSTFLOAT* zone)
+        void updateAllGuis()
+        void updateAllZones()
+        void updateAll()
+        bint isRunning()
+        void run()
+        void stop()
+        void declare(FAUSTFLOAT* zone, const char* key, const char* val)
+
+cdef extern from "faust/gui/PrintUI.h":
+    cdef cppclass PrintUI:
+        PrintUI() except +
+        void openTabBox(const char* label)
+        void openHorizontalBox(const char* label)
+        void openVerticalBox(const char* label)
+        void closeBox()
+        void addButton(const char* label, FAUSTFLOAT* zone)
+        void addCheckButton(const char* label, FAUSTFLOAT* zone)
+        void addVerticalSlider(const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+        void addHorizontalSlider(const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+        void addNumEntry(const char* label, FAUSTFLOAT* zone, FAUSTFLOAT init, FAUSTFLOAT min, FAUSTFLOAT max, FAUSTFLOAT step)
+        void addHorizontalBargraph(const char* label, FAUSTFLOAT* zone, FAUSTFLOAT min, FAUSTFLOAT max)
+        void addVerticalBargraph(const char* label, FAUSTFLOAT* zone, FAUSTFLOAT min, FAUSTFLOAT max)
+        # soundfiles - excluded because PrintUI is for debugging/inspection only
+        # Use SoundUI class instead (see below) for actual soundfile functionality
+        # void addSoundfile(const char* label, const char* filename,  Soundfile** sf_zone)
+        void declare(FAUSTFLOAT* zone, const char* key, const char* val)
+
+# Soundfile functionality - always included for full functionality
+cdef extern from "faust/gui/Soundfile.h":
+    # Constants from Soundfile.h
+    int BUFFER_SIZE
+    int SAMPLE_RATE  
+    int MAX_CHAN
+    int MAX_SOUNDFILE_PARTS
+    
+    cdef cppclass Soundfile:
+        # Type alias for sound directories
+        ctypedef vector[string] Directories
+
+        void* fBuffers # will correspond to a double** or float** pointer chosen at runtime
+        int* fLength   # length of each part (so fLength[P] contains the length in frames of part P)
+        int* fSR       # sample rate of each part (so fSR[P] contains the SR of part P)
+        int* fOffset   # offset of each part in the global buffer (so fOffset[P] contains the offset in frames of part P)
+        int fChannels  # max number of channels of all concatenated files
+        int fParts     # the total number of loaded parts
+        bint fIsDouble # keep the sample format (float or double)
+
+        Soundfile(int cur_chan, int length, int max_chan, int total_parts, bint is_double)
+        void* allocBufferReal[REAL](int cur_chan, int length, int max_chan)            
+        void copyToOut(int size, int channels, int max_channels, int offset, void* buffer)
+        void shareBuffers(int cur_chan, int max_chan)
+        void copyToOutReal[REAL](int size, int channels, int max_channels, int offset, void* buffer)
+        void getBuffersOffsetReal[REAL](void* buffers, int offset)
+        void emptyFile(int part, int& offset)
+
+    cdef cppclass SoundfileReader:
+        SoundfileReader() except +
+        void setSampleRate(int sample_rate)   
+        Soundfile* createSoundfile(const vector[string]& path_name_list, int max_chan, bint is_double)
+        vector[string] checkFiles(const vector[string]& sound_directories, const vector[string]& file_name_list)
+        string checkFile(const vector[string]& sound_directories, const string& file_name)
+        bint isResampling(int sample_rate)
+        
+    # Global soundfile support
+    vector[string] gPathNameList
+    Soundfile* defaultsound
+        
+cdef extern from "faust/gui/SoundUI.h":
+    cdef cppclass SoundUI:
+        # Constructor with single directory
+        SoundUI(const string& sound_directory, int sample_rate, SoundfileReader* reader, bint is_double) except +
+        # Constructor with multiple directories
+        SoundUI(const vector[string]& sound_directories, int sample_rate, SoundfileReader* reader, bint is_double) except +
+        void addSoundfile(const char* label, const char* url, Soundfile** sf_zone)
+        @staticmethod
+        string getBinaryPath()
+        @staticmethod
+        string getBinaryPathFrom(const string& path)
+        @staticmethod
+        vector[string] getSoundfilePaths(dsp* dsp)
+        
+    # SoundUI interface for DSP classes
+    cdef cppclass SoundUIInterface:
+        void addSoundfile(const char* label, const char* filename, Soundfile** sf_zone)
+
+cdef extern from "faust/gui/PathBuilder.h":
+    cdef cppclass PathBuilder:
+        PathBuilder() except +
+        string buildPath(const string& label)
+        string buildLabel(const string& label)
+        void pushLabel(const string& label)
+        bint popLabel()
+        void computeShortNames()
+
+cdef extern from "faust/gui/MapUI.h":
+    cdef cppclass MapUI(UI, PathBuilder):
+        MapUI() except +
+        # Parameter access by path/label/shortname
+        void setParamValue(const string& str, FAUSTFLOAT value)
+        FAUSTFLOAT getParamValue(const string& str)
+        int getParamsCount()
+        string getParamAddress(int index)
+        const char* getParamAddress1(int index)
+        string getParamShortname(int index)
+        const char* getParamShortname1(int index)
+        string getParamLabel(int index)
+        const char* getParamLabel1(int index)
+        string getParamAddress(FAUSTFLOAT* zone)
+        FAUSTFLOAT* getParamZone(const string& str)
+        FAUSTFLOAT* getParamZone(int index)
+        @staticmethod
+        bint endsWith(const string& str, const string& end)