libcsound 1.0.0__tar.gz → 1.0.2__tar.gz

{libcsound-1.0.0 → libcsound-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcsound
-Version: 1.0.0
+Version: 1.0.2
 Summary: Python bindings to the Csound 7 API
 Author-email: Eduardo Moguillansky <eduardo.moguillansky@gmail.com>
 License:                   GNU LESSER GENERAL PUBLIC LICENSE

{libcsound-1.0.0 → libcsound-1.0.2}/libcsound/api7.py

@@ -301,6 +301,10 @@ def _declareAPI(libcsound):
                                               ct.c_char_p, ct.c_int32]
     libcsound.csoundGetChannelVarTypeName.restype = ct.c_char_p
     libcsound.csoundGetChannelVarTypeName.argtypes = [CSOUND_p, ct.c_char_p]
+    libcsound.csoundGetTypePool.restype = ct.c_void_p
+    libcsound.csoundGetTypePool.argtypes = [CSOUND_p]
+    libcsound.csoundGetTypeWithVarTypeName.restype = ct.c_void_p
+    libcsound.csoundGetTypeWithVarTypeName.argtypes = [ct.c_void_p, ct.c_char_p]
     libcsound.csoundListChannels.restype = ct.c_int32
     libcsound.csoundListChannels.argtypes = [CSOUND_p, ct.POINTER(ct.POINTER(ControlChannelInfo))]
     libcsound.csoundDeleteChannelList.argtypes = [CSOUND_p, ct.POINTER(ControlChannelInfo)]
@@ -600,7 +604,8 @@ class Csound:
         self._compilationStarted = False
 
         self._ugenFactory: UgenFactory | None = None
-
+        self._typePool: ct.c_void_p | None = None
+        self._cache: dict[str, _t.Any] = {}
         self._started = False
 
     def destroy(self):
@@ -1749,7 +1754,6 @@ class Csound:
             if chan_type == CSOUND_STRING_CHANNEL:
                 return ct.cast(ptr, STRINGDAT_p), err
             elif chan_type == CSOUND_ARRAY_CHANNEL:
-                # TODO: cast to a numpy array
                 return ct.cast(ptr, ARRAYDAT_p), err
             elif chan_type == CSOUND_PVS_CHANNEL:
                 return ct.cast(ptr, PVSDAT_p), err
@@ -1801,6 +1805,76 @@ class Csound:
             '[': 'array'
             }[ret]
 
+    def varTypePointer(self, typename: str) -> int | None:
+        """Returns the pointer to the canonical type for a variable type name.
+
+        The returned pointer is the same one that is passed as the last
+        argument (``channelType``) to the input/output channel callbacks set
+        with :meth:`setInputChannelCallback` / :meth:`setOutputChannelCallback`,
+        so it can be compared against it to find out the type of the value
+        passed to the callback.
+
+        For the standard types these correspond to the ``CS_VAR_TYPE_*``
+        objects in the Csound C API, i.e. ``varTypePointer('k')`` is
+        ``CS_VAR_TYPE_K`` and ``varTypePointer('S')`` is ``CS_VAR_TYPE_S``.
+
+        Args:
+            typename: the variable type name, e.g. 'k' (control), 'a' (audio),
+                'S' (string), 'i' (init), 'f' (pvs), '[' (array)
+
+        Returns:
+            the address of the canonical type as an int, or None if the type
+            name is unknown.
+
+        .. note::
+
+            The returned pointers are valid for the lifetime of the process and
+            are the same for every :class:`Csound` instance, so they only need
+            to be resolved once (before setting the callback).
+
+        .. rubric:: Example
+
+        Compare the type of a value received in an outvalue callback:
+
+        .. code-block:: python
+
+            cs = Csound()
+            cs.compileOrc(...)
+
+            ktype = cs.varTypePointer('k')
+            stype = cs.varTypePointer('S')
+
+            def outvalue(csnd, name, value_ptr, type_ptr):
+                if type_ptr == ktype:
+                    value = ct.c_double.from_address(value_ptr).value
+                elif type_ptr == stype:
+                    value = ct.cast(value_ptr, ct.c_char_p).value
+                else:
+                    value = None
+                print(name.decode(), value)
+
+            cs.setOutputChannelCallback(outvalue)
+        """
+        key = 'vartypeptr/' + typename
+        if ptr := self._cache.get(key):
+            return ptr
+        pool = self.getTypePool()
+        ptr = libcsound.csoundGetTypeWithVarTypeName(pool, cstring(typename))
+        self._cache[key] = ptr
+        return ptr
+
+    def getTypePool(self) -> ct.c_void_p:
+        """Returns the type pool for this Csound instance.
+
+        The type pool is used to resolve variable types by name, e.g. with
+        :meth:`varTypePointer()`.
+        """
+        if self._typePool is None:
+            self._typePool = pool = libcsound.csoundGetTypePool(self.cs)
+            return pool
+        else:
+            return self._typePool
+
     def allocatedChannels(self) -> list[ChannelInfo]:
         """
         Returns a list of allocated channels

{libcsound-1.0.0 → libcsound-1.0.2}/libcsound.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcsound
-Version: 1.0.0
+Version: 1.0.2
 Summary: Python bindings to the Csound 7 API
 Author-email: Eduardo Moguillansky <eduardo.moguillansky@gmail.com>
 License:                   GNU LESSER GENERAL PUBLIC LICENSE

libcsound-1.0.2/libcsound.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.0.2",
+  "distance": 0,
+  "node": "gd9fc7bc2c60734eea2e07b0c9d838e9c3b8e71bb",
+  "dirty": false,
+  "branch": "master",
+  "node_date": "2026-10-17"
+}

libcsound-1.0.0/libcsound.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.0.0",
-  "distance": 0,
-  "node": "g2b873675ba6b3be65e128f7809c44c965b25aec7",
-  "dirty": false,
-  "branch": "csound7-only",
-  "node_date": "2026-10-13"
-}