libcsound 1.0.2__tar.gz → 1.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcsound
-Version: 1.0.2
+Version: 1.0.3
 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-1.0.3}/libcsound/api7.py

@@ -551,6 +551,37 @@ _scoreEventToTypenum = {
     'e': CS_END_EVENT}
 
 
+def channelCallbackValue(value_ptr: int, type_ptr: int) -> float | str | None:
+    """Convert a value received in a channel callback to a Python value.
+
+    This is the module-level counterpart of
+    :meth:`Csound.channelCallbackValue` and does not require a
+    :class:`Csound` instance: the type of the value is read from the type
+    structure pointed to by ``type_ptr``.
+
+    - control ('k') and init ('i') values are returned as a ``float``
+    - string ('S') values are returned as a ``str``
+    - any other type (e.g. audio vectors or arrays, which are not passed by
+      the ``invalue``/``outvalue`` opcodes) returns ``None``
+
+    Args:
+        value_ptr: the value pointer passed to the callback
+        type_ptr: the channel type pointer passed to the callback
+
+    Returns:
+        the value as a Python object, or None if the type is unsupported
+    """
+    # CS_TYPE starts with its var type name ("k", "i", "S", ...); read it
+    # directly so that no Csound instance / type pool lookup is needed.
+    typename = ct.c_char_p.from_address(type_ptr).value
+    if typename in (b'k', b'i'):
+        return ct.cast(value_ptr, MYFLT_p).contents.value
+    if typename == b'S':
+        s = ct.cast(value_ptr, ct.c_char_p).value
+        return pstring(s) if s else ''
+    return None
+
+
 # --------------------------------------------------------------------------------
 
 
@@ -2283,6 +2314,51 @@ class Csound:
         self._outputChannelCallback = CHANNELFUNC(function)
         libcsound.csoundSetOutputChannelCallback(self.cs, self._outputChannelCallback)
 
+    def channelCallbackValue(self, value_ptr: int, type_ptr: int) -> float | str | None:
+        """Convert a value received in a channel callback to a Python value.
+
+        The input/output channel callbacks set with
+        :meth:`setInputChannelCallback` / :meth:`setOutputChannelCallback`
+        receive, besides the channel name, a pointer to the value
+        (``value_ptr``) and a pointer to the type of that value
+        (``type_ptr``). This method converts that pair to the corresponding
+        Python value:
+
+        - control ('k') and init ('i') values are returned as a ``float``
+        - string ('S') values are returned as a ``str``
+
+        Any other type (e.g. audio vectors or arrays, which are not passed by
+        the ``invalue``/``outvalue`` opcodes) is not supported and ``None`` is
+        returned.
+
+        Args:
+            value_ptr: the value pointer passed to the callback
+            type_ptr: the channel type pointer passed to the callback
+
+        Returns:
+            the value as a Python object, or None if the type is unsupported
+
+        .. note::
+
+            This is a thin wrapper around the module-level
+            :func:`channelCallbackValue`, which can be used when no
+            :class:`Csound` instance is at hand.
+
+        .. rubric:: Example
+
+        .. code-block:: python
+
+            cs = Csound()
+            cs.compileOrc(...)
+
+            def outvalue(csnd, name, value_ptr, type_ptr):
+                value = cs.channelCallbackValue(value_ptr, type_ptr)
+                print(name.decode(), repr(value))
+
+            cs.setOutputChannelCallback(outvalue)
+        """
+        return channelCallbackValue(value_ptr, type_ptr)
+
     def event(self, kind: str, pfields: _t.Sequence[float] | np.ndarray, block=True) -> None:
         """
         Send a new event.

{libcsound-1.0.2 → libcsound-1.0.3}/libcsound/common.py

@@ -13,6 +13,7 @@ BUILDING_DOCS = 'sphinx' in sys.modules
 
 
 MYFLT = ct.c_double
+MYFLT_p = ct.POINTER(MYFLT)
 
 #
 # Opaque pointers for Csound structs

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: libcsound
-Version: 1.0.2
+Version: 1.0.3
 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-1.0.3}/libcsound.egg-info/scm_version.json

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