Return a pointer to the image’s pixel data, if possible. This can involve allocating large amounts of memory and performing a long computation. Image pixels are laid out in band-packed rows.

Since this function modifies image, it is not threadsafe. Only call it on images which you are sure have not been shared with another thread.