Description

Copy in the entire region access area from a source region access.

Return Type

None  

Syntax

object.CopyInEntireArea SourceRegionAccess

The CopyInEntireArea Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McRegionAccess.
SourceRegionAccessRequired. A McRegionAccess object.

McRegionAccess* : The source region access. This must have the same bounds as the current region access and also be of a “compatible” image type.

Remarks

This routine encapsulates the common task of copying the entire bounds of one region access to another. Here, this region access is the destination, while the argument is the source. If a RegionMask property is set, the copy is masked.

You should use this method rather than Src.GetArea followed by a Dst.PutArea, because this method does the copy in strips, so that the full image does not have to be in memory all at once. This is critical to avoid thrashing for images that are larger than about one half the size of installed physical memory.