Class RRegionBuf

class RRegionBuf : public RRegion;

Description

Region with pre-allocated buffer.

This class provides the functionality of an RRegion, but in addition, for optimisation purposes, uses a buffer containing pre-allocated space for as many rectangles as are specified in the granularity.

When this buffer is full, cell allocation takes place as for an RRegion, and the RRegionBuf effectively becomes an RRegion. In this case, the region does not revert to using the buffer, even if the region were to shrink so that the buffer could, once again, contain the region. When the region is no longer required, call Close(), defined in the base class RRegion, to free up all memory.

Derivation

• TRegion - Clipping region - abstract base class

• RRegion - Expandable region

• RRegionBuf - Region with pre-allocated buffer

Members

Defined in RRegionBuf:
RRegionBuf(), RRegionBuf(), RRegionBuf(), RRegionBuf()

Inherited from RRegion:
CheckSpare(), Close(), Destroy()

Inherited from TRegion:
AddRect(), BoundingRect(), CheckError(), Clear(), ClipRect(), Contains(), Copy(), Count(), ERRegionBuf, ForceError(), Intersect(), Intersection(), Intersects(), IsContainedBy(), IsEmpty(), Offset(), RectangleList(), RectangleListW(), Sort(), SubRect(), SubRegion(), Tidy(), Union(), anonymous, iAllocedRects, iCount, iError, operator[]()

inline RRegionBuf();

Description

Constructs a default object.

The granularity is the value of the template parameter.

inline RRegionBuf(const RRegion &aRegion);

Description

Constructs this object from the specified RRegion.

Parameters

const RRegion &aRegion The region to assign to this RRegionBuf.

inline RRegionBuf(const RRegionBuf< S > &aRegion);

Description

Copy constructs from an existing RRegionBuf object.

Parameters

const RRegionBuf< S > &aRegion The RRegionBuf to be copied.

inline RRegionBuf(const TRect &aRect);

Description

Constructs an RRegionBuf with a TRect.

Its granularity is initialised to the value contained in the template argument. The resulting region consists of the specified single rectangle.

Parameters

const TRect &aRect The single rectangle with which to initialise the region.