lv_rectangle.h

/* Libvisual - The audio visualisation framework.
 *
 * Copyright (C) 2012      Libvisual team
 *               2004-2006 Dennis Smit
 *
 * Authors: Chong Kai Xiong <kaixiong@codeleft.sg>
 *          Dennis Smit <ds@nerds-incorporated.org>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation; either version 2.1
 * 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 */

#ifndef _LV_RECTANGLE_H
#define _LV_RECTANGLE_H

#ifdef __cplusplus

#include <libvisual/lv_math.h>

namespace LV {

  class LV_API Rect
  {
  public:

      int x;
      int y;
      int width;
      int height;

      Rect ()
          : x (0), y (0), width (0), height (0)
      {}

      Rect (int x_, int y_, int width_, int height_)
          : x (x_), y (y_), width (width_), height (height_)
      {}

      Rect (int width_, int height_)
          : x (0), y (0), width (width_), height (height_)
      {}

      void set (int x_, int y_, int width_, int height_)
      {
          x = x_; y = y_; width = width_; height = height_;
      }

      bool empty () const
      {
          return ( width <= 0 || height <= 0 );
      }

      bool contains (int x_, int y_) const
      {
          return ( x_ >= x && x_ <= x + width && y_ >= y && y_ <= y + height );
      }

      bool contains (Rect const& r) const;

      bool intersects (Rect const& r) const;

      Rect clip (Rect const& r) const;

      void normalize ()
      {
          x = y = 0;
      }

      void normalize_to (Rect const& r)
      {
          x = r.x; y = r.y;
      }

      void denormalize_point (float fx, float fy, int32_t& x_, int32_t& y_) const
      {
          fx = clamp (fx, 0.0f, 1.0f);
          fy = clamp (fx, 0.0f, 1.0f);

          x_ = x + fx * width;
          y_ = y + fy * height;
      }

      void denormalize_points (float const* fxlist, float const* fylist, int32_t* xlist, int32_t* ylist, unsigned int size) const;

      void denormalize_point_neg (float fx, float fy, int32_t& x_, int32_t& y_) const
      {
          fx = clamp (fx, -1.0f, 1.0f) * 0.5f + 0.5f;
          fy = clamp (fy, -1.0f, 1.0f) * 0.5f + 0.5f;

          x_ = x + fx * width;
          y_ = y + fy * height;
      }

      void denormalize_points_neg (float const* fxlist, float const* fylist, int32_t* xlist, int32_t* ylist, unsigned int size) const;
  };

} // LV namespace

#endif /* __cplusplus */

#ifdef __cplusplus
typedef ::LV::Rect VisRectangle;
#else
typedef struct _VisRectangle VisRectangle;
struct _VisRectangle;
#endif

LV_BEGIN_DECLS

LV_API VisRectangle *visual_rectangle_new (int x, int y, int width, int height);
LV_API VisRectangle *visual_rectangle_new_empty (void);

LV_API void visual_rectangle_free (VisRectangle *rect);

LV_API void visual_rectangle_set  (VisRectangle *rect, int x, int y, int width, int height);
LV_API void visual_rectangle_copy (VisRectangle *dest, VisRectangle *src);

LV_API VisRectangle *visual_rectangle_clone (VisRectangle *rect);

LV_API void visual_rectangle_set_x      (VisRectangle *rect, int x);
LV_API int  visual_rectangle_get_x      (VisRectangle *rect);
LV_API void visual_rectangle_set_y      (VisRectangle *rect, int y);
LV_API int  visual_rectangle_get_y      (VisRectangle *rect);
LV_API void visual_rectangle_set_width  (VisRectangle *rect, int width);
LV_API int  visual_rectangle_get_width  (VisRectangle *rect);
LV_API void visual_rectangle_set_height (VisRectangle *rect, int height);
LV_API int  visual_rectangle_get_height (VisRectangle *rect);

LV_API int  visual_rectangle_is_empty       (VisRectangle *rect);
LV_API int  visual_rectangle_intersects     (VisRectangle *dest, VisRectangle *src);
LV_API int  visual_rectangle_contains_point (VisRectangle *rect, int x, int y);
LV_API int  visual_rectangle_contains_rect  (VisRectangle *dest, VisRectangle *src);
LV_API void visual_rectangle_clip           (VisRectangle *dest, VisRectangle *within, VisRectangle *src);

LV_API void visual_rectangle_normalize    (VisRectangle *rect);
LV_API void visual_rectangle_normalize_to (VisRectangle *dest, VisRectangle *src);

LV_API void visual_rectangle_denormalize_point  (VisRectangle *rect, float fx, float fy, int32_t *x, int32_t *y);
LV_API void visual_rectangle_denormalize_points (VisRectangle *rect, const float *fxlist, const float *fylist, int32_t *xlist, int32_t *ylist, unsigned int size);

LV_API void visual_rectangle_denormalize_point_neg  (VisRectangle *rect, float fx, float fy, int32_t *x, int32_t *y);
LV_API void visual_rectangle_denormalize_points_neg (VisRectangle *rect, const float *fxlist, const float *fylist, int32_t *xlist, int32_t *ylist, unsigned int size);

LV_END_DECLS

#endif /* _LV_RECTANGLE_H */