# ----------------------------------------------------------------------------
#
#  Copyright (C) 2015-2022 Fons Adriaensen <fons@linuxaudio.org>
#    
#  This program is free software; you can redistribute it and/or modify
#  it under the terms of the GNU General Public License as published by
#  the Free Software Foundation; either version 3 of the License, or
#  (at your option) any later version.
#
#  This program 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
#  GNU General Public License for more details.
#
#  You should have received a copy of the GNU General Public License
#  along with this program.  If not, see <http:#www.gnu.org/licenses/>.
#
# ----------------------------------------------------------------------------


from zita_jacktools.jackclient import JackClient
from zita_jacktools import jackambbin_ext


class JackAmbbin(JackClient):
    """
    Ambisonic to binaural rendering with head tracking.

    ACN, SN3D, up to degree 8.
    """

    def __init__(self, degree, maxlen, client_name, server_name = None):
        """
        Create a new JackAmbbin instance. 

        The result should be checked using get_state().
        The optional 'server_name' allows to select between running
        Jack servers.
        """
        assert (degree >= 1)
        assert (degree <= 8)
        self._jambbin, base = jackambbin_ext.makecaps (self, client_name, server_name, maxlen, degree)
        super().__init__(base)


    def set_nfcomp (self, distance):
        """
        Set near-field compensation distance (in meter).
        """
        jackambbin_ext.set_nfcomp (self._jambbin, distance)
    

    def set_filter (self, harm, data):
        """
        Set convolution filter for given harmonic.
        """
        jackambbin_ext.set_filter (self._jambbin, harm, data)
    

    def set_rotation (self, a, x, y, z, t = 0.1) :
        """
        Set rotation angle 'a' (rad) and axis 'x,y,z'.

        The axis vector magnitude must not be zero.
        The rotation matrix will be interpolated linearly
        over min (t,1) seconds.
        """
        return jackambbin_ext.set_rotation (self._jambbin, a, x, y, z, t)

    
    def set_quaternion(self, w, x, y, z, t = 0.1) :
        """
        Set rotation quaternion.

        The quaternion will be normalised to a unit quaternion.
        The rotation matrix will be interpolated linearly over
        min (t,1) seconds.
        """
        return jackambbin_ext.set_quaternion (self._jambbin, w, x, y, z, t)

    

