/* ----------------------------------------------------------------- */
/*                                                                   */
/*  Copyright (c) 2010-2013  hkrn                                    */
/*                                                                   */
/* All rights reserved.                                              */
/*                                                                   */
/* Redistribution and use in source and binary forms, with or        */
/* without modification, are permitted provided that the following   */
/* conditions are met:                                               */
/*                                                                   */
/* - Redistributions of source code must retain the above copyright  */
/*   notice, this list of conditions and the following disclaimer.   */
/* - Redistributions in binary form must reproduce the above         */
/*   copyright notice, this list of conditions and the following     */
/*   disclaimer in the documentation and/or other materials provided */
/*   with the distribution.                                          */
/* - Neither the name of the MMDAI project team nor the names of     */
/*   its contributors may be used to endorse or promote products     */
/*   derived from this software without specific prior written       */
/*   permission.                                                     */
/*                                                                   */
/* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND            */
/* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,       */
/* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF          */
/* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE          */
/* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS */
/* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,          */
/* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED   */
/* TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,     */
/* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON */
/* ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,   */
/* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY    */
/* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE           */
/* POSSIBILITY OF SUCH DAMAGE.                                       */
/* ----------------------------------------------------------------- */

#pragma once
#ifndef VPVL2_ICAMERAKEYFRAME_H_
#define VPVL2_ICAMERAKEYFRAME_H_

#include "vpvl2/IKeyframe.h"

namespace vpvl2
{

/**
 * カメラのキーフレームをあらわすインターフェースです。
 *
 */
class VPVL2_API ICameraKeyframe : public IKeyframe
{
public:
    struct InterpolationParameter
    {
        QuadWord x;
        QuadWord y;
        QuadWord z;
        QuadWord rotation;
        QuadWord distance;
        QuadWord fov;
    };
    enum InterpolationType
    {
        kCameraLookAtX = 0,
        kCameraLookAtY,
        kCameraLookAtZ,
        kCameraAngle,
        kCameraDistance,
        kCameraFov,
        kCameraMaxInterpolationType
    };
    virtual ~ICameraKeyframe() {}

    /**
     * ICameraKeyframe のインスタンスの完全なコピーを返します.
     *
     * @return ICameraKeyframe
     */
    virtual ICameraKeyframe *clone() const = 0;

    /**
     * 補間パラメータを初期状態に設定します.
     *
     * @sa setInterpolationParameter
     * @sa getInterpolationParameter
     */
    virtual void setDefaultInterpolationParameter() = 0;

    /**
     * 指定された型の補間パラメータを設定します.
     *
     * 第２引数は以下で解釈されます。第２引数の値はそれぞれ 0 以上かつ 128 未満でなければなりません。
     * - x = x1
     * - y = y1
     * - z = x2
     * - w = y2
     *
     * @param InterpolationType
     * @param QuadWord
     * @sa getInterpolationParameter
     */
    virtual void setInterpolationParameter(InterpolationType type, const QuadWord &value) = 0;

    /**
     * 指定された型の補間パラメータを第二引数にコピーします.
     *
     * 第２引数にコピーされる値の設定順は setInterpolationParameter と同じです。
     *
     * @param InterpolationType
     * @param QuadWord
     * @sa setInterpolationParameter
     */
    virtual void getInterpolationParameter(InterpolationType type, QuadWord &value) const = 0;

    /**
     * カメラの注視点を返します.
     *
     * @return Vector3
     * @sa setPosition
     */
    virtual Vector3 lookAt() const = 0;

    /**
     * カメラのアングル（オイラー角）を返します.
     *
     * @return Vector3
     * @sa setAngle
     */
    virtual Vector3 angle() const = 0;

    /**
     * カメラの視野距離を返します.
     *
     * @return float
     * @sa setDistance
     */
    virtual Scalar distance() const = 0;

    /**
     * カメラの視野角を返します.
     *
     * @return float
     * @sa setFovy
     */
    virtual Scalar fov() const = 0;

    /**
     * カメラが透視であるかを返します.
     *
     * @return bool
     * @sa setPerspective
     */
    virtual bool isPerspective() const = 0;

    /**
     * カメラの注視点を設定します.
     *
     * @param Vector3
     * @sa position
     */
    virtual void setLookAt(const Vector3 &value) = 0;

    /**
     * カメラのアングル（オイラー角）を設定します.
     *
     * @param Vector3
     * @sa angle
     */
    virtual void setAngle(const Vector3 &value) = 0;

    /**
     * カメラの視野距離を設定します.
     *
     * @param Vector3
     * @sa distance
     */
    virtual void setDistance(const Scalar &value) = 0;

    /**
     * カメラの視野角を設定します.
     *
     * @param Vector3
     * @sa fovy
     */
    virtual void setFov(const Scalar &value) = 0;

    /**
     * 透視にするかを設定します.
     *
     * @param bool
     * @sa isPerspective
     */
    virtual void setPerspective(bool value) = 0;
};

}

#endif

