Types.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016-2020, NVIDIA CORPORATION. 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 NVIDIA CORPORATION 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 ``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.
 */

#ifndef _ARGUS_TYPES_H
#define _ARGUS_TYPES_H

#include <stdint.h>
#include <vector>
#include <string>
#include <assert.h>

#include <EGL/egl.h>
#include <EGL/eglext.h>

// Some versions of the Xlib.h header file define 'Status' to 'int'.
// This collides with the libargus 'Status' type.
// If 'Status' is defined then undefine it and use a typedef instead.
#ifdef Status
#undef Status
typedef int Status;
#endif // Status

namespace Argus
{

/*
 * Forward declaration of standard objects
 */
class CameraDevice;
class CameraProvider;
class CaptureSession;
class CaptureMetadata;
class CaptureMetadataContainer;
class Event;
class EventQueue;
class InputStream;
class OutputStream;
class OutputStreamSettings;
class Request;
class SensorMode;

/*
 * Forward declaration of standard interfaces
 */
class ICameraProperties;
class ICameraProvider;
class ICaptureSession;
class IAutoControlSettings;
class IRequest;
class IStream;
class IStreamSettings;

const uint64_t TIMEOUT_INFINITE = 0xFFFFFFFFFFFFFFFF;

enum Status
{
    STATUS_OK                 = 0,

    STATUS_INVALID_PARAMS     = 1,

    STATUS_INVALID_SETTINGS   = 2,

    STATUS_UNAVAILABLE        = 3,

    STATUS_OUT_OF_MEMORY      = 4,

    STATUS_UNIMPLEMENTED      = 5,

    STATUS_TIMEOUT            = 6,

    STATUS_CANCELLED          = 7,

    STATUS_DISCONNECTED       = 8,

    STATUS_END_OF_STREAM      = 9,

    // Number of elements in this enum.
    STATUS_COUNT
};

enum BayerChannel
{
    BAYER_CHANNEL_R,
    BAYER_CHANNEL_G_EVEN,
    BAYER_CHANNEL_G_ODD,
    BAYER_CHANNEL_B,

    BAYER_CHANNEL_COUNT
};

enum Coordinate
{
    COORDINATE_X,
    COORDINATE_Y,
    COORDINATE_Z,

    COORDINATE_2D_COUNT = 2,
    COORDINATE_3D_COUNT = 3
};

enum RGBChannel
{
    RGB_CHANNEL_R,
    RGB_CHANNEL_G,
    RGB_CHANNEL_B,

    RGB_CHANNEL_COUNT
};

DEFINE_NAMED_UUID_CLASS(AeAntibandingMode);
DEFINE_UUID(AeAntibandingMode, AE_ANTIBANDING_MODE_OFF,  AD1E5560,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeAntibandingMode, AE_ANTIBANDING_MODE_AUTO, AD1E5561,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeAntibandingMode, AE_ANTIBANDING_MODE_50HZ, AD1E5562,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeAntibandingMode, AE_ANTIBANDING_MODE_60HZ, AD1E5563,9C16,11E8,B568,18,00,20,0C,9A,66);

DEFINE_NAMED_UUID_CLASS(AeFlickerState);
DEFINE_UUID(AeFlickerState, AE_FLICKER_NONE,  AD1E5564,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeFlickerState, AE_FLICKER_50HZ, AD1E5565,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeFlickerState, AE_FLICKER_60HZ, AD1E5566,9C16,11E8,B568,18,00,20,0C,9A,66);

DEFINE_NAMED_UUID_CLASS(AeState);
DEFINE_UUID(AeState, AE_STATE_INACTIVE,       D2EBEA50,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeState, AE_STATE_SEARCHING,      D2EBEA51,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeState, AE_STATE_CONVERGED,      D2EBEA52,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeState, AE_STATE_FLASH_REQUIRED, D2EBEA53,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AeState, AE_STATE_TIMEOUT,        D2EBEA54,9C16,11E8,B568,18,00,20,0C,9A,66);

DEFINE_NAMED_UUID_CLASS(AwbMode);
DEFINE_UUID(AwbMode, AWB_MODE_OFF,              FB3F365A,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_AUTO,             FB3F365B,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_INCANDESCENT,     FB3F365C,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_FLUORESCENT,      FB3F365D,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_WARM_FLUORESCENT, FB3F365E,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_DAYLIGHT,         FB3F365F,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_CLOUDY_DAYLIGHT,  FB3F3660,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_TWILIGHT,         FB3F3661,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_SHADE,            FB3F3662,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(AwbMode, AWB_MODE_MANUAL,           20FB45DA,C49F,4293,AB02,13,3F,8C,CA,DD,69);

DEFINE_NAMED_UUID_CLASS(AwbState);
DEFINE_UUID(AwbState, AWB_STATE_INACTIVE,  E33CDB30,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AwbState, AWB_STATE_SEARCHING, E33CDB31,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AwbState, AWB_STATE_CONVERGED, E33CDB32,9C16,11E8,B568,18,00,20,0C,9A,66);
DEFINE_UUID(AwbState, AWB_STATE_LOCKED,    E33CDB33,9C16,11E8,B568,18,00,20,0C,9A,66);

DEFINE_NAMED_UUID_CLASS(CaptureIntent);
DEFINE_UUID(CaptureIntent, CAPTURE_INTENT_MANUAL,         FB3F3663,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(CaptureIntent, CAPTURE_INTENT_PREVIEW,        FB3F3664,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(CaptureIntent, CAPTURE_INTENT_STILL_CAPTURE,  FB3F3665,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(CaptureIntent, CAPTURE_INTENT_VIDEO_RECORD,   FB3F3666,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(CaptureIntent, CAPTURE_INTENT_VIDEO_SNAPSHOT, FB3F3667,CC62,11E5,9956,62,56,62,87,07,61);

DEFINE_NAMED_UUID_CLASS(DenoiseMode);
DEFINE_UUID(DenoiseMode, DENOISE_MODE_OFF,          FB3F3668,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(DenoiseMode, DENOISE_MODE_FAST,         FB3F3669,CC62,11E5,9956,62,56,62,87,07,61);
DEFINE_UUID(DenoiseMode, DENOISE_MODE_HIGH_QUALITY, FB3F366A,CC62,11E5,9956,62,56,62,87,07,61);

DEFINE_NAMED_UUID_CLASS(EdgeEnhanceMode);
DEFINE_UUID(EdgeEnhanceMode, EDGE_ENHANCE_MODE_OFF,          F7100B40,6A5F,11E6,BDF4,08,00,20,0C,9A,66);
DEFINE_UUID(EdgeEnhanceMode, EDGE_ENHANCE_MODE_FAST,         F7100B41,6A5F,11E6,BDF4,08,00,20,0C,9A,66);
DEFINE_UUID(EdgeEnhanceMode, EDGE_ENHANCE_MODE_HIGH_QUALITY, F7100B42,6A5F,11E6,BDF4,08,00,20,0C,9A,66);

DEFINE_NAMED_UUID_CLASS(ExtensionName);

DEFINE_NAMED_UUID_CLASS(PixelFormat);
DEFINE_UUID(PixelFormat, PIXEL_FMT_UNKNOWN,       00000000,93d5,11e5,0000,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_Y8,            569be14a,93d5,11e5,91bc,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_Y16,           56ddb19c,93d5,11e5,8e2c,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_YCbCr_420_888, 570c10e6,93d5,11e5,8ff3,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_YCbCr_422_888, 573a7940,93d5,11e5,99c2,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_YCbCr_444_888, 576043dc,93d5,11e5,8983,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_JPEG_BLOB,     578b08c4,93d5,11e5,9686,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_RAW16,         57b484d8,93d5,11e5,aeb6,1c,b7,2c,ef,d4,1e);
DEFINE_UUID(PixelFormat, PIXEL_FMT_P016,          57b484d9,93d5,11e5,aeb6,1c,b7,2c,ef,d4,1e);

DEFINE_NAMED_UUID_CLASS(SensorModeType);
DEFINE_UUID(SensorModeType, SENSOR_MODE_TYPE_DEPTH, 64483464,4b91,11e6,bbbd,40,16,7e,ab,86,92);
DEFINE_UUID(SensorModeType, SENSOR_MODE_TYPE_YUV,   6453e00c,4b91,11e6,871d,40,16,7e,ab,86,92);
DEFINE_UUID(SensorModeType, SENSOR_MODE_TYPE_RGB,   6463d4c6,4b91,11e6,88a3,40,16,7e,ab,86,92);
DEFINE_UUID(SensorModeType, SENSOR_MODE_TYPE_BAYER, 646f04ea,4b91,11e6,9c06,40,16,7e,ab,86,92);

DEFINE_NAMED_UUID_CLASS(SensorPlacement);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_REAR_OR_BOTTOM_OR_BOTTOM_LEFT, 01dba8b0,1946,11eb,8b6f,08,00,20,0c,9a,66);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_FRONT_OR_TOP_OR_CENTER_LEFT,   01dba8b1,1946,11eb,8b6f,08,00,20,0c,9a,66);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_CENTER_OR_CENTER_RIGHT,        01dba8b2,1946,11eb,8b6f,08,00,20,0c,9a,66);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_TOP_LEFT,                      01dba8b3,1946,11eb,8b6f,08,00,20,0c,9a,66);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_BOTTOM_RIGHT,                  01dba8b4,1946,11eb,8b6f,08,00,20,0c,9a,66);
DEFINE_UUID(SensorPlacement, SENSOR_PLACEMENT_TOP_RIGHT,                     01dba8b5,1946,11eb,8b6f,08,00,20,0c,9a,66);

class NonCopyable
{
protected:
    NonCopyable() {}

private:
    NonCopyable(NonCopyable& other);
    NonCopyable& operator=(NonCopyable& other);
};

class Interface : NonCopyable
{
protected:
    Interface() {}
    ~Interface() {}
};

class InterfaceID : public NamedUUID
{
public:
    InterfaceID(uint32_t time_low_
              , uint16_t time_mid_
              , uint16_t time_hi_and_version_
              , uint16_t clock_seq_
              , uint8_t c0, uint8_t c1, uint8_t c2, uint8_t c3, uint8_t c4, uint8_t c5
              , const char* name)
    : NamedUUID(time_low_, time_mid_, time_hi_and_version_, clock_seq_,
                c0, c1, c2, c3, c4, c5, name)
    {}

    InterfaceID()
    : NamedUUID(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, "IID_UNSPECIFIED")
    {}
};

class InterfaceProvider : NonCopyable
{
public:

    virtual Interface* getInterface(const InterfaceID& interfaceId) = 0;

protected:
    ~InterfaceProvider() {}
};

template <typename TheInterface>
inline TheInterface* interface_cast(InterfaceProvider* obj)
{
    return static_cast<TheInterface*>(obj ? obj->getInterface(TheInterface::id()): 0);
}

template <typename TheInterface>
inline TheInterface* interface_cast(const InterfaceProvider* obj)
{
    return static_cast<TheInterface*>(
        obj ? const_cast<const Interface*>(
                const_cast<InterfaceProvider*>(obj)->getInterface(TheInterface::id())): 0);
}

class Destructable
{
public:

    virtual void destroy() = 0;

protected:
    ~Destructable() {}
};

template<typename T>
class rv : public T
{
    rv();
    ~rv();
    rv(const rv&);
    void operator=(const rv&);
};

template<typename T>
    rv<T>& move(T& self)
{
    return *static_cast<rv<T>*>(&self);
}
template <typename T> struct remove_const;
template <typename T> struct remove_const<const T&>{ typedef T& type; };
template <typename T> struct remove_const<const T*>{ typedef T* type; };
template <typename T> struct remove_const<const T >{ typedef T  type; };
template <typename T> struct remove_const          { typedef T  type; };
template <typename T>
class UniqueObj : NonCopyable
{
public:
    explicit UniqueObj(T* obj=NULL): m_obj(obj) {}

    void reset(T* obj=NULL)
        { if (m_obj) const_cast<typename remove_const<T*>::type>(m_obj)->destroy(); m_obj = obj; }
    T* release()
        { T* obj = m_obj; m_obj = NULL; return obj; }

    UniqueObj( rv<UniqueObj>& moved ): m_obj(moved.release()) {}
    UniqueObj& operator=( rv<UniqueObj>& moved ){ reset( moved.release()); return *this; }

    ~UniqueObj() { reset(); }

    T& operator*() const { return *m_obj; }
    T* get() const { return m_obj; }

    operator bool() const { return !!m_obj; }

    operator       rv<UniqueObj>&()       { return *static_cast<      rv<UniqueObj>*>(this); }
    operator const rv<UniqueObj>&() const { return *static_cast<const rv<UniqueObj>*>(this); }

private:
    T* m_obj;

    T* operator->() const; // Prevent calling destroy() directly.
                           // Note: For getInterface functionality use interface_cast.
};

template <typename TheInterface, typename TObject>
inline TheInterface* interface_cast(const UniqueObj<TObject>& obj)
{
    return interface_cast<TheInterface>( obj.get());
}

template <unsigned int N, typename T>
class Tuple
{
public:
    Tuple() {}

    Tuple(T init)
    {
        for (unsigned int i = 0; i < N; i++)
            m_data[i] = init;
    }

    bool operator==(const Tuple<N,T>& rhs) const
    {
        return !memcmp(m_data, rhs.m_data, sizeof(m_data));
    }

    bool operator!=(const Tuple<N,T>& rhs) const
    {
        return !(*this == rhs);
    }

    Tuple<N, T>& operator+=(const Tuple<N, T>& rhs)
    {
        for (unsigned int i = 0; i < N; i++)
            m_data[i] += rhs.m_data[i];
        return *this;
    }

    Tuple<N, T>& operator-=(const Tuple<N, T>& rhs)
    {
        for (unsigned int i = 0; i < N; i++)
            m_data[i] -= rhs.m_data[i];
        return *this;
    }

    Tuple<N, T>& operator*=(const T& rhs)
    {
        for (unsigned int i = 0; i < N; i++)
            m_data[i] *= rhs;
        return *this;
    }

    Tuple<N, T>& operator/=(const T& rhs)
    {
        for (unsigned int i = 0; i < N; i++)
            m_data[i] /= rhs;
        return *this;
    }

    const Tuple<N, T> operator+(const Tuple<N, T>& rhs) const
    {
        return Tuple<N, T>(*this) += rhs;
    }

    const Tuple<N, T> operator-(const Tuple<N, T>& rhs) const
    {
        return Tuple<N, T>(*this) -= rhs;
    }

    const Tuple<N, T> operator*(const T& rhs) const
    {
        return Tuple<N, T>(*this) *= rhs;
    }

    const Tuple<N, T> operator/(const T& rhs) const
    {
        return Tuple<N, T>(*this) /= rhs;
    }

    T& operator[](unsigned int i)             { assert(i < N); return m_data[i]; }
    const T& operator[](unsigned int i) const { assert(i < N); return m_data[i]; }

    static unsigned int tupleSize() { return N; }

protected:
    T m_data[N];
};

template <typename T>
class BayerTuple : public Tuple<BAYER_CHANNEL_COUNT, T>
{
public:
    BayerTuple() {}
    BayerTuple(const Tuple<BAYER_CHANNEL_COUNT, T>& other) : Tuple<BAYER_CHANNEL_COUNT, T>(other) {}

    BayerTuple(T init)
    {
        r() = gEven() = gOdd() = b() = init;
    }

    BayerTuple(T _r, T _gEven, T _gOdd, T _b)
    {
        r() = _r;
        gEven() = _gEven;
        gOdd() = _gOdd;
        b() = _b;
    }

    T& r()                 { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_R]; }
    const T& r() const     { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_R]; }
    T& gEven()             { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_G_EVEN]; }
    const T& gEven() const { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_G_EVEN]; }
    T& gOdd()              { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_G_ODD]; }
    const T& gOdd() const  { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_G_ODD]; }
    T& b()                 { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_B]; }
    const T& b() const     { return Tuple<BAYER_CHANNEL_COUNT, T>::m_data[BAYER_CHANNEL_B]; }
};

template <typename T>
class RGBTuple : public Tuple<RGB_CHANNEL_COUNT, T>
{
public:
    RGBTuple() {}
    RGBTuple(const Tuple<RGB_CHANNEL_COUNT, T>& other) : Tuple<RGB_CHANNEL_COUNT, T>(other) {}

    RGBTuple(T init)
    {
        r() = g() = b() = init;
    }

    RGBTuple(T _r, T _g, T _b)
    {
        r() = _r;
        g() = _g;
        b() = _b;
    }

    T& r()             { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_R]; }
    const T& r() const { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_R]; }
    T& g()             { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_G]; }
    const T& g() const { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_G]; }
    T& b()             { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_B]; }
    const T& b() const { return Tuple<RGB_CHANNEL_COUNT, T>::m_data[RGB_CHANNEL_B]; }
};

template <typename T>
class Point2D : public Tuple<COORDINATE_2D_COUNT, T>
{
public:
    Point2D() {}
    Point2D(const Tuple<COORDINATE_2D_COUNT, T>& other) : Tuple<COORDINATE_2D_COUNT, T>(other) {}

    Point2D(T init)
    {
        x() = y() = init;
    }

    Point2D(T _x, T _y)
    {
        x() = _x;
        y() = _y;
    }

    T& x()             { return Tuple<COORDINATE_2D_COUNT, T>::m_data[COORDINATE_X]; }
    const T& x() const { return Tuple<COORDINATE_2D_COUNT, T>::m_data[COORDINATE_X]; }
    T& y()             { return Tuple<COORDINATE_2D_COUNT, T>::m_data[COORDINATE_Y]; }
    const T& y() const { return Tuple<COORDINATE_2D_COUNT, T>::m_data[COORDINATE_Y]; }
};


template <typename T>
class Point3D : public Tuple<COORDINATE_3D_COUNT, T>
{
public:
    Point3D() {}
    Point3D(const Tuple<COORDINATE_3D_COUNT, T>& other) : Tuple<COORDINATE_3D_COUNT, T>(other) {}

    Point3D(T init)
    {
        x() = y() = z() = init;
    }

    Point3D(T _x, T _y, T _z)
    {
        x() = _x;
        y() = _y;
        z() = _z;
    }

    T& x()             { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_X]; }
    const T& x() const { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_X]; }
    T& y()             { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_Y]; }
    const T& y() const { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_Y]; }
    T& z()             { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_Z]; }
    const T& z() const { return Tuple<COORDINATE_3D_COUNT, T>::m_data[COORDINATE_Z]; }
};

template <typename T>
class Size2D : public Tuple<2, T>
{
public:
    Size2D() {}
    Size2D(const Tuple<2, T>& other) : Tuple<2, T>(other) {}

    Size2D(T init)
    {
        width() = height() = init;
    }

    Size2D(T _width, T _height)
    {
        width() = _width;
        height() = _height;
    }

    T& width()              { return Tuple<2, T>::m_data[0]; }
    const T& width() const  { return Tuple<2, T>::m_data[0]; }
    T& height()             { return Tuple<2, T>::m_data[1]; }
    const T& height() const { return Tuple<2, T>::m_data[1]; }

    T area() const { return width() * height(); }
};

template <typename T>
class Rectangle : public Tuple<4, T>
{
public:
    Rectangle() {}
    Rectangle(const Tuple<4, T>& other) : Tuple<4, T>(other) {}

    Rectangle(T init)
    {
        left() = top() = right() = bottom() = init;
    }

    Rectangle(T _left, T _top, T _right, T _bottom)
    {
        left() = _left;
        top() = _top;
        right() = _right;
        bottom() = _bottom;
    }

    T& left()               { return Tuple<4, T>::m_data[0]; }
    const T& left() const   { return Tuple<4, T>::m_data[0]; }
    T& top()                { return Tuple<4, T>::m_data[1]; }
    const T& top() const    { return Tuple<4, T>::m_data[1]; }
    T& right()              { return Tuple<4, T>::m_data[2]; }
    const T& right() const  { return Tuple<4, T>::m_data[2]; }
    T& bottom()             { return Tuple<4, T>::m_data[3]; }
    const T& bottom() const { return Tuple<4, T>::m_data[3]; }

    T width() const  { return right() - left(); }

    T height() const { return bottom() - top(); }

    T area() const { return width() * height(); }
};

template <typename T>
class Range : public Tuple<2, T>
{
public:
    Range() {}
    Range(const Tuple<2, T>& other) : Tuple<2, T>(other) {}

    Range(T init)
    {
        min() = max() = init;
    }

    Range(T _min, T _max)
    {
        min() = _min;
        max() = _max;
    }

    T& min()             { return Tuple<2, T>::m_data[0]; }
    const T& min() const { return Tuple<2, T>::m_data[0]; }
    T& max()             { return Tuple<2, T>::m_data[1]; }
    const T& max() const { return Tuple<2, T>::m_data[1]; }

    bool empty() const   { return max() < min(); }
};

class AcRegion : public Rectangle<uint32_t>
{
public:
    AcRegion()
        : Rectangle<uint32_t>(0, 0, 0, 0)
        , m_weight(1.0f)
    {}

    AcRegion(uint32_t _left, uint32_t _top, uint32_t _right, uint32_t _bottom, float _weight)
        : Rectangle<uint32_t>(_left, _top, _right, _bottom)
        , m_weight(_weight)
    {}

    float& weight()             { return m_weight; }
    const float& weight() const { return m_weight; }

protected:
    float m_weight;
};

template <typename T>
class Array2D
{
public:
    // Iterator types.
    typedef T* iterator;
    typedef const T* const_iterator;

    Array2D() : m_size(0, 0) {}

    Array2D(const Size2D<uint32_t>& size) : m_size(size)
    {
        m_data.resize(size.width() * size.height());
    }

    Array2D(const Size2D<uint32_t>& size, const T& value) : m_size(size)
    {
        m_data.resize(size.width() * size.height(), value);
    }

    Array2D(const Array2D<T>& other)
    {
        m_data = other.m_data;
        m_size = other.m_size;
    }

    Array2D& operator= (const Array2D<T>& other)
    {
        m_data = other.m_data;
        m_size = other.m_size;
        return *this;
    }

    bool operator== (const Array2D<T>& other) const
    {
        return (m_size == other.m_size && m_data == other.m_data);
    }

    Size2D<uint32_t> size() const { return m_size; }

    bool resize(const Size2D<uint32_t>& size)
    {
        uint32_t s = size.width() * size.height();
        m_data.resize(s);
        if (m_data.size() != s)
            return false;
        m_size = size;
        return true;
    }

    inline const_iterator begin() const { return m_data.data(); }
    inline const_iterator end() const { return m_data.data() + m_data.size(); }
    inline iterator begin() { return m_data.data(); }
    inline iterator end() { return m_data.data() + m_data.size(); }

    T& operator[](unsigned int i) { return m_data[checkIndex(i)]; }
    const T& operator[](unsigned int i) const { return m_data[checkIndex(i)]; }

    inline const T& operator() (uint32_t i) const { return m_data[checkIndex(i)]; }
    inline const T& operator() (uint32_t x, uint32_t y) const { return m_data[checkIndex(x, y)]; }
    inline const T& operator() (const Point2D<uint32_t>& p) const
        { return m_data[checkIndex(p.x(), p.y())]; }
    inline T& operator() (uint32_t i) { return m_data[checkIndex(i)]; }
    inline T& operator() (uint32_t x, uint32_t y) { return m_data[checkIndex(x, y)]; }
    inline T& operator() (const Point2D<uint32_t>& p)
        { return m_data[checkIndex(p.x(), p.y())]; }

    // Get pointers to data.
    inline const T* data() const { return m_data.data(); }
    inline T* data() { return m_data.data(); }

private:
    inline uint32_t checkIndex(uint32_t i) const
    {
        assert(i < m_data.size());
        return i;
    }

    inline uint32_t checkIndex(uint32_t x, uint32_t y) const
    {
        assert(x < m_size.width());
        assert(y < m_size.height());
        return x + (y * m_size.width());
    }

    std::vector<T> m_data;
    Size2D<uint32_t> m_size;
};

typedef uint32_t AutoControlId;

} // namespace Argus

#endif // _ARGUS_TYPES_H