< Previous | Contents | Next >
This function will sample an arbitrary position from the coordinates specified by the first two arguments, and fill the Pixel object p with values from the sampled pixels. The X and Y arguments are floating-point pixel coordinates, with 0,0 being the bottom-left corner and <width-1>,<height-1> being the top-right corner. Unlike GetPixel, if the coordinates do not align exactly with a pixel then bilinear filtering will be performed with neighbouring pixels.
If the coordinates provided are outside the actual bounds of the image, the coordinates will wrap around the image. For example, if sampling a pixel at coordinates (-30.0, 50.0) the actual pixel sampled would be (width-30.0, 50.0). See SamplePixelD and SamplePixelB for functions that treat out of bound sampling in different ways.