~ubuntu-branches/ubuntu/wily/python-pyo/wily-proposed

"""

Play soundfiles from the disk.

 

an AIFF file to create more specific reading patterns.

 

"""

"""

 

This file is part of pyo, a python module to help digital signal

processing script creation.

 

pyo is free software: you can redistribute it and/or modify

 

pyo is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 

"""

from _core import *

from _maps import *

class SfPlayer(PyoObject):

    """

    Soundfile player.

    types. User can alter its pitch with the `speed` attribute. The object

    rate setting.

    :Parent: :py:class:`PyoObject`

    :Args:

        path : string

            Full path name of the sound to read.

        speed : float or PyoObject, optional

            Defaults to 1.

            Although the `speed` attribute accepts audio

            rate signal, its value is updated only once per buffer size.

        loop : bool, optional

            If set to True, sound will play in loop. Defaults to False.

            Defaults to 0.

        interp : int, optional

            Interpolation type. Defaults to 2.

                4. cubic

 

    .. note::

        retrieve the trigger streams by calling obj['trig']:

        >>> sf = SfPlayer(SNDS_PATH + "/transparent.aif").out()

        >>> trig = TrigRand(sf['trig'])

    >>> s = Server().boot()

    >>> s.start()

    >>> snd = SNDS_PATH + "/transparent.aif"

    >>> sf = SfPlayer(snd, speed=[.75,.8], loop=True, mul=.3).out()

    """

    def __init__(self, path, speed=1, loop=False, offset=0, interp=2, mul=1, add=0):

        PyoObject.__init__(self, mul, add)

    def setPath(self, path):

        """

        Sets a new sound to read.

        of the sound loaded at initialization time.

        :Args:

            path : string

                Full path of the new sound.

 

        if _snd_chnls != curNchnls:

            print "Soundfile must contains exactly %d channels." % curNchnls

            return

        self._path = path

        path, lmax = convertArgsToLists(path)

        [obj.setSound(wrap(path,i)) for i, obj in enumerate(self._base_players)]

    def setSound(self, path):

        """

        Sets a new sound to read.

        of the sound loaded at initialization time.

        :Args:

            path : string

                Full path of the new sound.

 

    def setSpeed(self, x):

        """

        Replace the `speed` attribute.

        :Args:

 

            x : float or PyoObject

                new `speed` attribute.

        """

        self._speed = x

        x, lmax = convertArgsToLists(x)

    def setLoop(self, x):

        """

        Replace the `loop` attribute.

        :Args:

 

            x : bool {True, False}

                new `loop` attribute.

        """

        self._loop = x

        x, lmax = convertArgsToLists(x)

    def setOffset(self, x):

        """

        Replace the `offset` attribute.

        :Args:

 

            x : float

                new `offset` attribute.

        """

        self._offset = x

        x, lmax = convertArgsToLists(x)

    def setInterp(self, x):

        """

        Replace the `interp` attribute.

        :Args:

 

            x : int {1, 2, 3, 4}

                new `interp` attribute.

        """

        self._interp = x

        x, lmax = convertArgsToLists(x)

        [obj.setInterp(wrap(x,i)) for i, obj in enumerate(self._base_players)]

 

    def ctrl(self, map_list=None, title=None, wxnoserver=False):

                          SLMap(1, 4, 'lin', 'interp', self._interp, res="int", dataOnly=True),

                          SLMapMul(self._mul)]

        PyoObject.ctrl(self, map_list, title, wxnoserver)

 

    @property

        """string. Full path of the sound."""

        return self._path

    @path.setter

    def path(self, x): self.setPath(x)

    @property

        """string. Alias to the `path` attribute."""

        return self._path

    @sound.setter

    def sound(self, x): self.setPath(x)

    @property

        """float or PyoObject. Transposition factor."""

        return self._speed

    @speed.setter

    def speed(self, x): self.setSpeed(x)

 

    @property

        """bool. Looping mode."""

        return self._loop

    @loop.setter

    def loop(self, x): self.setLoop(x)

 

    @property

        """float. Time, in seconds, of the first sample to read."""

        return self._offset

    @offset.setter

    def offset(self, x): self.setOffset(x)

 

    @property

        """int {1, 2, 3, 4}. Interpolation method."""

        return self._interp

    @interp.setter

class SfMarkerShuffler(PyoObject):

    """

    AIFF with markers soundfile shuffler.

    The reading pointer randomly choose a marker (from the MARK chunk

    another marker and reads from the new position and so on...

    :Parent: :py:class:`PyoObject`

    :Args:

        path : string

            Full path name of the sound to read. Can't e changed after

            initialization.

        speed : float or PyoObject, optional

            Defaults to 1.

            Although the `speed` attribute accepts audio

            rate signal, its value is updated only once per buffer size.

        interp : int, optional

    >>> s = Server().boot()

    >>> s.start()

    >>> sf = SfMarkerShuffler(SNDS_PATH + "/transparent.aif", speed=[1,1], mul=.3).out()

    """

    def __init__(self, path, speed=1, interp=2, mul=1, add=0):

        PyoObject.__init__(self, mul, add)

                sf.close()

                self._markers = [m[1] for m in markerstmp]

            except:

            self._base_players.append(SfMarkerShuffler_base(wrap(path,i), self._markers, wrap(speed,i), wrap(interp,i)))

        for i in range(lmax * self._snd_chnls):

            j = i / self._snd_chnls

    def setSpeed(self, x):

        """

        Replace the `speed` attribute.

        :Args:

 

            x : float or PyoObject

                new `speed` attribute.

        """

        self._speed = x

        x, lmax = convertArgsToLists(x)

    def setInterp(self, x):

        """

        Replace the `interp` attribute.

        :Args:

 

            x : int {1, 2, 3, 4}

                new `interp` attribute.

        """

        self._interp = x

        x, lmax = convertArgsToLists(x)

    def getMarkers(self):

        """

        Returns a list of marker time values in samples.

        """

        return self._markers

    def ctrl(self, map_list=None, title=None, wxnoserver=False):

                          SLMap(1, 4, 'lin', 'interp', self._interp, res="int", dataOnly=True),

                          SLMapMul(self._mul)]

        PyoObject.ctrl(self, map_list, title, wxnoserver)

    @property

        """float or PyoObject. Transposition factor."""

        return self._speed

    @speed.setter

    def speed(self, x): self.setSpeed(x)

 

    @property

        """int {1, 2, 3, 4}. Interpolation method."""

        return self._interp

    @interp.setter

    """

    AIFF with markers soundfile looper.

 

    interpolation types. User can alter its pitch with the `speed`

    The reading pointer loops a specific marker (from the MARK chunk

    in the `mark` attribute.

 

    :Parent: :py:class:`PyoObject`

        path : string

            Full path name of the sound to read.

        speed : float or PyoObject, optional

            Defaults to 1.

            Although the `speed` attribute accepts audio

            rate signal, its value is updated only once per buffer size.

        mark : float or PyoObject, optional

            0 -> len(getMarkers()). Defaults to 0.

        interp : int, optional

            Choice of the interpolation method. Defaults to 2.

                sf.close()

                self._markers = [m[1] for m in markerstmp]

            except:

            self._base_players.append(SfMarkerLooper_base(wrap(path,i), self._markers, wrap(speed,i), wrap(mark,i), wrap(interp,i)))

        for i in range(lmax * self._snd_chnls):

            j = i / self._snd_chnls

        return self._markers

 

    def ctrl(self, map_list=None, title=None, wxnoserver=False):

                          SLMap(0, len(self._markers)-1, 'lin', 'mark', self._mark, 'int'),

                          SLMap(1, 4, 'lin', 'interp', self._interp, res="int", dataOnly=True),

                          SLMapMul(self._mul)]

        PyoObject.ctrl(self, map_list, title, wxnoserver)

 

    @property

        """float or PyoObject. Transposition factor."""

        return self._speed

    @speed.setter

    def speed(self, x): self.setSpeed(x)

 

    @property

        """float or PyoObject. Marker to loop."""

        return self._marker

    @mark.setter

    def mark(self, x): self.setMark(x)

 

    @property

        """int {1, 2, 3, 4}. Interpolation method."""

        return self._interp

    @interp.setter