openshot-audio  0.1.2
Public Types | Public Member Functions | List of all members
RectangleList< ValueType > Class Template Reference

#include <juce_RectangleList.h>

Public Types

typedef Rectangle< ValueType > RectangleType
 

Public Member Functions

 RectangleList () noexcept
 
 RectangleList (const RectangleList &other)
 
 RectangleList (const RectangleType &rect)
 
RectangleListoperator= (const RectangleList &other)
 
bool isEmpty () const noexcept
 
int getNumRectangles () const noexcept
 
RectangleType getRectangle (int index) const noexcept
 
void clear ()
 
void add (const RectangleType &rect)
 
void add (ValueType x, ValueType y, ValueType width, ValueType height)
 
void addWithoutMerging (const RectangleType &rect)
 
void add (const RectangleList &other)
 
void subtract (const RectangleType &rect)
 
bool subtract (const RectangleList &otherList)
 
bool clipTo (const RectangleType &rect)
 
template<typename OtherValueType >
bool clipTo (const RectangleList< OtherValueType > &other)
 
bool getIntersectionWith (const RectangleType &rect, RectangleList &destRegion) const
 
void swapWith (RectangleList &otherList) noexcept
 
bool containsPoint (Point< ValueType > point) const noexcept
 
bool containsPoint (ValueType x, ValueType y) const noexcept
 
bool containsRectangle (const RectangleType &rectangleToCheck) const
 
bool intersectsRectangle (const RectangleType &rectangleToCheck) const noexcept
 
bool intersects (const RectangleList &other) const noexcept
 
RectangleType getBounds () const noexcept
 
void consolidate ()
 
void offsetAll (Point< ValueType > offset) noexcept
 
void offsetAll (ValueType dx, ValueType dy) noexcept
 
template<typename ScaleType >
void scaleAll (ScaleType scaleFactor) noexcept
 
void transformAll (const AffineTransform &transform) noexcept
 
Path toPath () const
 
const RectangleTypebegin () const noexcept
 
const RectangleTypeend () const noexcept
 
void ensureStorageAllocated (int minNumRectangles)
 

Detailed Description

template<typename ValueType>
class RectangleList< ValueType >

Maintains a set of rectangles as a complex region.

This class allows a set of rectangles to be treated as a solid shape, and can add and remove rectangular sections of it, and simplify overlapping or adjacent rectangles.

See also
Rectangle

Member Typedef Documentation

template<typename ValueType>
typedef Rectangle<ValueType> RectangleList< ValueType >::RectangleType

Constructor & Destructor Documentation

template<typename ValueType>
RectangleList< ValueType >::RectangleList ( )
inlinenoexcept

Creates an empty RectangleList

template<typename ValueType>
RectangleList< ValueType >::RectangleList ( const RectangleList< ValueType > &  other)
inline

Creates a copy of another list

template<typename ValueType>
RectangleList< ValueType >::RectangleList ( const RectangleType rect)
inline

Creates a list containing just one rectangle.

Member Function Documentation

template<typename ValueType>
void RectangleList< ValueType >::add ( const RectangleType rect)
inline

Merges a new rectangle into the list.

The rectangle being added will first be clipped to remove any parts of it that overlap existing rectangles in the list, and adjacent rectangles will be merged into it.

The rectangle can have any size and may be empty, but if it's floating point then it's expected to not contain any INF values.

template<typename ValueType>
void RectangleList< ValueType >::add ( ValueType  x,
ValueType  y,
ValueType  width,
ValueType  height 
)
inline

Merges a new rectangle into the list.

The rectangle being added will first be clipped to remove any parts of it that overlap existing rectangles in the list.

template<typename ValueType>
void RectangleList< ValueType >::add ( const RectangleList< ValueType > &  other)
inline

Merges another rectangle list into this one.

Any overlaps between the two lists will be clipped, so that the result is the union of both lists.

template<typename ValueType>
void RectangleList< ValueType >::addWithoutMerging ( const RectangleType rect)
inline

Dumbly adds a rectangle to the list without checking for overlaps.

This simply adds the rectangle to the end, it doesn't merge it or remove any overlapping bits.

The rectangle can have any size and may be empty, but if it's floating point then it's expected to not contain any INF values.

template<typename ValueType>
const RectangleType* RectangleList< ValueType >::begin ( ) const
inlinenoexcept

Standard method for iterating the rectangles in the list.

template<typename ValueType>
void RectangleList< ValueType >::clear ( )
inline

Removes all rectangles to leave an empty region.

template<typename ValueType>
bool RectangleList< ValueType >::clipTo ( const RectangleType rect)
inline

Removes any areas of the region that lie outside a given rectangle.

Any rectangles in the list which overlap this will be clipped and subdivided if necessary.

Returns true if the resulting region is not empty, false if it is empty.

See also
getIntersectionWith
template<typename ValueType>
template<typename OtherValueType >
bool RectangleList< ValueType >::clipTo ( const RectangleList< OtherValueType > &  other)
inline

Removes any areas of the region that lie outside a given rectangle list.

Any rectangles in this object which overlap the specified list will be clipped and subdivided if necessary.

Returns true if the resulting region is not empty, false if it is empty.

See also
getIntersectionWith
template<typename ValueType>
void RectangleList< ValueType >::consolidate ( )
inline

Optimises the list into a minimum number of constituent rectangles.

This will try to combine any adjacent rectangles into larger ones where possible, to simplify lists that might have been fragmented by repeated add/subtract calls.

template<typename ValueType>
bool RectangleList< ValueType >::containsPoint ( Point< ValueType >  point) const
inlinenoexcept

Checks whether the region contains a given point.

Returns
true if the point lies within one of the rectangles in the list
template<typename ValueType>
bool RectangleList< ValueType >::containsPoint ( ValueType  x,
ValueType  y 
) const
inlinenoexcept

Checks whether the region contains a given point.

Returns
true if the point lies within one of the rectangles in the list
template<typename ValueType>
bool RectangleList< ValueType >::containsRectangle ( const RectangleType rectangleToCheck) const
inline

Checks whether the region contains the whole of a given rectangle.

Returns
true all parts of the rectangle passed in lie within the region defined by this object
See also
intersectsRectangle, containsPoint
template<typename ValueType>
const RectangleType* RectangleList< ValueType >::end ( ) const
inlinenoexcept

Standard method for iterating the rectangles in the list.

template<typename ValueType>
void RectangleList< ValueType >::ensureStorageAllocated ( int  minNumRectangles)
inline

Increases the internal storage to hold a minimum number of rectangles. Calling this before adding a large number of rectangles means that the array won't have to keep dynamically resizing itself as the elements are added, and it'll therefore be more efficient.

See also
Array::ensureStorageAllocated
template<typename ValueType>
RectangleType RectangleList< ValueType >::getBounds ( ) const
inlinenoexcept

Returns the smallest rectangle that can enclose the whole of this region.

template<typename ValueType>
bool RectangleList< ValueType >::getIntersectionWith ( const RectangleType rect,
RectangleList< ValueType > &  destRegion 
) const
inline

Creates a region which is the result of clipping this one to a given rectangle.

Unlike the other clipTo method, this one doesn't affect this object - it puts the resulting region into the list whose reference is passed-in.

Returns true if the resulting region is not empty, false if it is empty.

See also
clipTo
template<typename ValueType>
int RectangleList< ValueType >::getNumRectangles ( ) const
inlinenoexcept

Returns the number of rectangles in the list.

template<typename ValueType>
RectangleType RectangleList< ValueType >::getRectangle ( int  index) const
inlinenoexcept

Returns one of the rectangles at a particular index.

Returns
the rectangle at the index, or an empty rectangle if the index is out-of-range.
template<typename ValueType>
bool RectangleList< ValueType >::intersects ( const RectangleList< ValueType > &  other) const
inlinenoexcept

Checks whether this region intersects any part of another one.

See also
intersectsRectangle
template<typename ValueType>
bool RectangleList< ValueType >::intersectsRectangle ( const RectangleType rectangleToCheck) const
inlinenoexcept

Checks whether the region contains any part of a given rectangle.

Returns
true if any part of the rectangle passed in lies within the region defined by this object
See also
containsRectangle
template<typename ValueType>
bool RectangleList< ValueType >::isEmpty ( ) const
inlinenoexcept

Returns true if the region is empty.

template<typename ValueType>
void RectangleList< ValueType >::offsetAll ( Point< ValueType >  offset)
inlinenoexcept

Adds an x and y value to all the coordinates.

template<typename ValueType>
void RectangleList< ValueType >::offsetAll ( ValueType  dx,
ValueType  dy 
)
inlinenoexcept

Adds an x and y value to all the coordinates.

template<typename ValueType>
RectangleList& RectangleList< ValueType >::operator= ( const RectangleList< ValueType > &  other)
inline

Copies this list from another one.

template<typename ValueType>
template<typename ScaleType >
void RectangleList< ValueType >::scaleAll ( ScaleType  scaleFactor)
inlinenoexcept

Scales all the coordinates.

template<typename ValueType>
void RectangleList< ValueType >::subtract ( const RectangleType rect)
inline

Removes a rectangular region from the list.

Any rectangles in the list which overlap this will be clipped and subdivided if necessary.

template<typename ValueType>
bool RectangleList< ValueType >::subtract ( const RectangleList< ValueType > &  otherList)
inline

Removes all areas in another RectangleList from this one.

Any rectangles in the list which overlap this will be clipped and subdivided if necessary.

Returns
true if the resulting list is non-empty.
template<typename ValueType>
void RectangleList< ValueType >::swapWith ( RectangleList< ValueType > &  otherList)
inlinenoexcept

Swaps the contents of this and another list.

This swaps their internal pointers, so is hugely faster than using copy-by-value to swap them.

template<typename ValueType>
Path RectangleList< ValueType >::toPath ( ) const
inline

Creates a Path object to represent this region.

template<typename ValueType>
void RectangleList< ValueType >::transformAll ( const AffineTransform transform)
inlinenoexcept

Applies a transform to all the rectangles. Obviously this will create a mess if the transform involves any rotation or skewing.


The documentation for this class was generated from the following file: