< Previous | Contents | Next >
This function will sample an area of the image, using the coordinates specified by the first two arguments, and fill the Pixel object p with the average of the pixels within the area. If the coordinates provided include pixels outside the actual bounds of the image, the pixels will be sampled from the opposite side of the image.
See SampleAreaB and SampleAreaD for functions that treat out of bound sampling in different ways.
Before using the SampleArea methods, initial setup must be done, which pre-calculates values needed by the area sampling functions. Be aware however area sampling is a very memory intensive approach and should only be used if "full quality" is required. The setup is done using the UseSAT()function. This maintains a reference count, and so an equivalent RecycleSAT() must be done once you’re finished area sampling. Without the RecycleSAT(), Fusion will not be able to free up the pre-calculated values until the whole Image itself is destroyed.