File Listener.h¶

// Copyright (c) 2021-present Sparky Studios. All rights reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#pragma once

#ifndef _AM_CORE_LISTENER_H
#define _AM_CORE_LISTENER_H

#include <SparkyStudios/Audio/Amplitude/Math/Orientation.h>

namespace SparkyStudios::Audio::Amplitude
{
    class ListenerInternalState;

    class AM_API_PUBLIC Listener
    {
    public:
        Listener();

        explicit Listener(ListenerInternalState* state);

        void Clear();

        [[nodiscard]] bool Valid() const;

        [[nodiscard]] AmListenerID GetId() const;

        [[nodiscard]] const AmVector3& GetVelocity() const;

        [[nodiscard]] const AmVector3& GetLocation() const;

        void SetLocation(const AmVector3& location) const;

        [[nodiscard]] AmVector3 GetDirection() const;

        [[nodiscard]] AmVector3 GetUp() const;

        void SetOrientation(const Orientation& orientation) const;

        [[nodiscard]] Orientation GetOrientation() const;

        void SetDirectivity(AmReal32 directivity, AmReal32 sharpness) const;

        [[nodiscard]] AmReal32 GetDirectivity() const;

        [[nodiscard]] AmReal32 GetDirectivitySharpness() const;

        [[nodiscard]] const AmMatrix4& GetInverseMatrix() const;

        void Update() const;

        [[nodiscard]] ListenerInternalState* GetState() const;

    private:
        ListenerInternalState* _state;
    };
} // namespace SparkyStudios::Audio::Amplitude

#endif // _AM_CORE_LISTENER_H