Regular API function

simSaveImage / sim.saveImage

Description Saves an image to file or to memory. See also sim.loadImage, sim.getScaledImage and sim.getVisionSensorCharImage.
C/C++
synopsis
simSaveImage(const simUChar* image,const simInt* resolution,simInt options,const simChar* filename,simInt quality,simVoid* reserved)
C/C++
parameters
image: a pointer to rgb, rgba or greyscale values.
resolution: the x/y resolution of the provided image.
options: bit-coded. If bit0 and bit1 represent the format of the provided image (0=rgb, 1=rgba, 2=greyscale).
filename: the name of the file to write. The file extension indicates the format.
quality: the quality of the written image: 0 for best compression, 100 for largest file. Use -1 for default behaviour.
reserved: Reserved for future extension. Set to nullptr.
C/C++
return value
-1 if operation was not successful.
Lua synopsis
string imgBuffer=sim.saveImage(string image,table[2] resolution,int options,string filename,int quality)
Lua parameters
image: the image (in rgb, rgba or greyscale format)
resolution: the x/y resolution of the provided image.
options: bit-coded. If bit0 and bit1 represent the format of the provided image (0=rgb, 1=rgba, 2=greyscale).
filename: the name of the file to write. The file extension indicates the format. If the filename only contains '.xxx', where xxx represents the file format, then the image will be saved to memory
quality: the quality of the written image: 0 for best compression, 100 for largest file. Use -1 for default behaviour.
Lua return values
imgBuffer: a buffer containing the image in packed format (e.g. png, jpg, etc.), if the image was specified to be saved to memory.
Python synopsis bytes imgBuffer=sim.saveImage(bytes image,list resolution,int options,string filename,int quality)