#include <vpImageIo.h>

Static Public Member Functions
static void	read (vpImage< unsigned char > &I, const char *filename)

static void	read (vpImage< unsigned char > &I, const std::string filename)

static void	read (vpImage< vpRGBa > &I, const char *filename)

static void	read (vpImage< vpRGBa > &I, const std::string filename)

static void	write (const vpImage< unsigned char > &I, const char *filename)

static void	write (const vpImage< unsigned char > &I, const std::string filename)

static void	write (const vpImage< vpRGBa > &I, const char *filename)

static void	write (const vpImage< vpRGBa > &I, const std::string filename)

static void	readPFM (vpImage< float > &I, const char *filename)

static void	readPGM (vpImage< unsigned char > &I, const char *filename)

static void	readPGM (vpImage< unsigned char > &I, const std::string filename)

static void	readPGM (vpImage< vpRGBa > &I, const char *filename)

static void	readPGM (vpImage< vpRGBa > &I, const std::string filename)

static void	readPPM (vpImage< unsigned char > &I, const char *filename)

static void	readPPM (vpImage< unsigned char > &I, const std::string filename)

static void	readPPM (vpImage< vpRGBa > &I, const char *filename)

static void	readPPM (vpImage< vpRGBa > &I, const std::string filename)

static void	readJPEG (vpImage< unsigned char > &I, const char *filename)

static void	readJPEG (vpImage< unsigned char > &I, const std::string filename)

static void	readJPEG (vpImage< vpRGBa > &I, const char *filename)

static void	readJPEG (vpImage< vpRGBa > &I, const std::string filename)

static void	readPNG (vpImage< unsigned char > &I, const char *filename)

static void	readPNG (vpImage< unsigned char > &I, const std::string filename)

static void	readPNG (vpImage< vpRGBa > &I, const char *filename)

static void	readPNG (vpImage< vpRGBa > &I, const std::string filename)

static void	writePFM (const vpImage< float > &I, const char *filename)

static void	writePGM (const vpImage< unsigned char > &I, const char *filename)

static void	writePGM (const vpImage< unsigned char > &I, const std::string filename)

static void	writePGM (const vpImage< short > &I, const char *filename)

static void	writePGM (const vpImage< short > &I, const std::string filename)

static void	writePGM (const vpImage< vpRGBa > &I, const char *filename)

static void	writePGM (const vpImage< vpRGBa > &I, const std::string filename)

static void	writePPM (const vpImage< unsigned char > &I, const char *filename)

static void	writePPM (const vpImage< unsigned char > &I, const std::string filename)

static void	writePPM (const vpImage< vpRGBa > &I, const char *filename)

static void	writePPM (const vpImage< vpRGBa > &I, const std::string filename)

static void	writeJPEG (const vpImage< unsigned char > &I, const char *filename)

static void	writeJPEG (const vpImage< unsigned char > &I, const std::string filename)

static void	writeJPEG (const vpImage< vpRGBa > &I, const char *filename)

static void	writeJPEG (const vpImage< vpRGBa > &I, const std::string filename)

static void	writePNG (const vpImage< unsigned char > &I, const char *filename)

static void	writePNG (const vpImage< unsigned char > &I, const std::string filename)

static void	writePNG (const vpImage< vpRGBa > &I, const char *filename)

static void	writePNG (const vpImage< vpRGBa > &I, const std::string filename)

Detailed Description

Read/write images with various image format.

The code below shows how to convert an PPM P6 image file format into a PGM P5 image file format. The extension of the filename is here used in read() and write() functions to set the image file format (".pgm" for PGM P5 and ".ppm" for PPM P6).

#include <visp/vpImage.h>
#include <visp/vpImageIo.h>
int main()
{
  vpImage<unsigned char> I;
#if defined(_WIN32)
  std::string filename("C:/temp/ViSP-images/Klimt/Klimt.ppm");
#else // UNIX
  std::string filename("/local/soft/ViSP/ViSP-images/Klimt/Klimt.ppm");
#endif
  vpImageIo::read(I, filename); // Convert the color image in a gray level image
  vpImageIo::write(I, "Klimt.pgm"); // Write the image in a PGM P5 image file format 
}

This other example available in tutorial-image-reader.cpp shows how to read/write jpeg images. It supposes that libjpeg is installed.

#include <visp/vpImageIo.h>
int main()
{
  try {
    vpImage<vpRGBa> I;
    vpImageIo::read(I, "lena.jpg");
    vpImageIo::write(I, "lena.png");
  }
  catch(vpException e) {
    std::cout << e.getMessage() << std::endl;
  }
  catch(...) {
    std::cout << "Unsupported image format" << std::endl;
  }
}

Definition at line 108 of file vpImageIo.h.

Member Function Documentation

void vpImageIo::read	(	vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Read the contents of the image filename, allocate memory for the corresponding greyscale image, update its content, and return a reference to the image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Examples:: displayD3D.cpp, displayGTK.cpp, displayOpenCV.cpp, displaySequence.cpp, displayX.cpp, displayXMulti.cpp, fernClassifier.cpp, histogram.cpp, imageDiskRW.cpp, keyPointSurf.cpp, manDisplay.cpp, photometricVisualServoing.cpp, planarObjectDetector.cpp, poseVirtualVS.cpp, testClick.cpp, testConversion.cpp, testCreateSubImage.cpp, testIoPGM.cpp, testIoPPM.cpp, testMouseEvent.cpp, testReadImage.cpp, testSurfKeyPoint.cpp, testTrackDot.cpp, testUndistortImage.cpp, testVideoDevice.cpp, trackDot.cpp, trackDot2.cpp, trackDot2WithAutoDetection.cpp, trackKltOpencv.cpp, trackMeCircle.cpp, trackMeEllipse.cpp, trackMeLine.cpp, tutorial-blob-auto-tracker.cpp, tutorial-ibvs-4pts-image-tracking.cpp, tutorial-image-filter.cpp, tutorial-image-reader.cpp, tutorial-image-simulator.cpp, tutorial-image-viewer.cpp, tutorial-mb-edge-tracker.cpp, tutorial-mb-hybrid-tracker.cpp, tutorial-mb-klt-tracker.cpp, tutorial-pose-from-points-image.cpp, tutorial-undistort.cpp, and tutorial-viewer.cpp.

Definition at line 278 of file vpImageIo.cpp.

References vpIoTools::checkFilename(), vpImageConvert::convert(), vpImageException::ioError, readJPEG(), readPGM(), readPNG(), and readPPM().

Referenced by vpDiskGrabber::acquire(), vpImageSimulator::init(), vpMbTracker::initClick(), read(), and vpVirtualGrabber::vpVirtualGrabber().

void vpImageIo::read	(	vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Read the contents of the image filename, allocate memory for the corresponding greyscale image, update its content, and return a reference to the image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 345 of file vpImageIo.cpp.

References read().

void vpImageIo::read	(	vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Read the contents of the image filename, allocate memory for the corresponding color image, update its content, and return a reference to the image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 366 of file vpImageIo.cpp.

References vpIoTools::checkFilename(), vpImageConvert::convert(), vpImageException::ioError, readJPEG(), readPGM(), readPNG(), and readPPM().

void vpImageIo::read	(	vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Read the contents of the image filename, allocate memory for the corresponding color image, update its content, and return a reference to the image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 434 of file vpImageIo.cpp.

References read().

void vpImageIo::readJPEG	(	vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Read the contents of the JPEG file, allocate memory for the corresponding gray level image, if necessary convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. If necessary, the quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1905 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImageConvert::convert(), vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpImage< Type >::resize(), and vpERROR_TRACE.

Referenced by read(), and readJPEG().

void vpImageIo::readJPEG	(	vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Read the contents of the JPEG file, allocate memory for the corresponding gray level image, if necessary convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. If necessary, the quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1993 of file vpImageIo.cpp.

References readJPEG().

void vpImageIo::readJPEG	(	vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Read a JPEG file and initialize a scalar image.

Read the contents of the JPEG file, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

If the file corresponds to a grayscaled image, a conversion is done to deal with I which is a color image.

Parameters

I	: Color image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 2018 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImageConvert::convert(), vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpImage< Type >::resize(), and vpERROR_TRACE.

void vpImageIo::readJPEG	(	vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Read a JPEG file and initialize a scalar image.

Read the contents of the JPEG file, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

If the file corresponds to a grayscaled image, a conversion is done to deal with I which is a color image.

Parameters

I	: Color image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 2113 of file vpImageIo.cpp.

References readJPEG().

void vpImageIo::readPFM	(	vpImage< float > &	I,
		const char *	filename
	)

static

Read a PFM P8 file and initialize a float image.

Read the contents of the portable gray pixmap (PFM P8) filename, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 803 of file vpImageIo.cpp.

References vpException::badValue, vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpImage< Type >::resize(), and vpERROR_TRACE.

Referenced by vpDiskGrabber::acquire().

void vpImageIo::readPGM	(	vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Read a PGM P5 file and initialize a scalar image.

Read the contents of the portable gray pixmap (PGM P5) filename, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Examples:: tutorial-template-tracker.cpp.

Definition at line 972 of file vpImageIo.cpp.

References vpException::badValue, vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpImage< Type >::resize().

Referenced by read(), and readPGM().

void vpImageIo::readPGM	(	vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Read a PGM P5 file and initialize a scalar image.

Read the contents of the portable gray pixmap (PGM P5) filename, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1575 of file vpImageIo.cpp.

References readPGM().

void vpImageIo::readPGM	(	vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Read a PGM P5 file and initialize a scalar image.

Read the contents of the portable gray pixmap (PGM P5) filename, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

The gray level image contained in the filename is converted in a color image in I.

Parameters

I	: Color image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1181 of file vpImageIo.cpp.

References vpImageConvert::convert(), readPGM(), and vpERROR_TRACE.

void vpImageIo::readPGM	(	vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Read a PGM P5 file and initialize a scalar image.

Read the contents of the portable gray pixmap (PGM P5) filename, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1596 of file vpImageIo.cpp.

References readPGM().

void vpImageIo::readPNG	(	vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Read the contents of the PNG file, allocate memory for the corresponding gray level image, if necessary convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. If necessary, the quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 2630 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImageConvert::convert(), vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpImage< Type >::resize(), and vpERROR_TRACE.

Referenced by read(), and readPNG().

void vpImageIo::readPNG	(	vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Read the contents of the PNG file, allocate memory for the corresponding gray level image, if necessary convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. If necessary, the quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 2823 of file vpImageIo.cpp.

References readPNG().

void vpImageIo::readPNG	(	vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Read a PNG file and initialize a scalar image.

Read the contents of the PNG file, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

If the file corresponds to a grayscaled image, a conversion is done to deal with I which is a color image.

Parameters

I	: Color image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 2848 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImageConvert::convert(), vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpImage< Type >::resize(), and vpERROR_TRACE.

void vpImageIo::readPNG	(	vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Read a PNG file and initialize a scalar image.

Read the contents of the PNG file, allocate memory for the corresponding image, and set the bitmap whith the content of the file.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

If the file corresponds to a grayscaled image, a conversion is done to deal with I which is a color image.

Parameters

I	: Color image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 3044 of file vpImageIo.cpp.

References readPNG().

void vpImageIo::readPPM	(	vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Read the contents of the portable pixmap (PPM P6) filename, allocate memory for the corresponding gray level image, convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. The quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1221 of file vpImageIo.cpp.

References vpImageConvert::convert(), and vpERROR_TRACE.

Referenced by read(), and readPPM().

void vpImageIo::readPPM	(	vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Read the contents of the portable pixmap (PPM P6) filename, allocate memory for the corresponding gray level image, convert the data in gray level, and set the bitmap whith the gray level data. That means that the image I is a "black and white" rendering of the original image in filename, as in a black and white photograph. The quantization formula used is $0,299 r + 0,587 g + 0,114 b$ .

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1669 of file vpImageIo.cpp.

References readPPM().

void vpImageIo::readPPM	(	vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Read the contents of the portable pixmap (PPM P6) filename, allocate memory for the corresponding vpRGBa image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1252 of file vpImageIo.cpp.

References vpRGBa::B, vpException::badValue, vpRGBa::G, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpRGBa::R, and vpImage< Type >::resize().

void vpImageIo::readPPM	(	vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Read the contents of the portable pixmap (PPM P6) filename, allocate memory for the corresponding vpRGBa image.

If the image has been already initialized, memory allocation is done only if the new image size is different, else we re-use the same memory space.

Parameters

I	: Image to set with the filename content.
filename	: Name of the file containing the image.

Definition at line 1686 of file vpImageIo.cpp.

References readPPM().

void vpImageIo::write	(	const vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Write the content of the image in the file which name is given by filename.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to write.
filename	: Name of the file containing the image.

Examples:: displayD3D.cpp, displayGTK.cpp, displayOpenCV.cpp, displayX.cpp, displayXMulti.cpp, grab1394CMU.cpp, grab1394Two.cpp, grabDirectShow.cpp, grabDirectShowMulti.cpp, grabOpenCV.cpp, grabV4l2.cpp, imageDiskRW.cpp, manDisplay.cpp, manGeometricFeatures.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, SickLDMRS-Process.cpp, sonarPioneerReader.cpp, test1394TwoGrabber.cpp, testConversion.cpp, testCreateSubImage.cpp, testIoPGM.cpp, testIoPPM.cpp, testUndistortImage.cpp, tutorial-image-converter.cpp, tutorial-image-reader.cpp, tutorial-image-simulator.cpp, tutorial-image-viewer.cpp, and tutorial-undistort.cpp.

Definition at line 452 of file vpImageIo.cpp.

References vpImageConvert::convert(), vpImageException::ioError, vpCERROR, writeJPEG(), writePGM(), writePNG(), and writePPM().

Referenced by vpVideoWriter::saveFrame(), write(), and vpSimulator::write().

void vpImageIo::write	(	const vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Write the content of the image in the file which name is given by filename.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to write.
filename	: Name of the file containing the image.

Definition at line 512 of file vpImageIo.cpp.

References write().

void vpImageIo::write	(	const vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Write the content of the image in the file which name is given by filename.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to write.
filename	: Name of the file containing the image.

Definition at line 529 of file vpImageIo.cpp.

References vpImageConvert::convert(), vpImageException::ioError, vpCERROR, writeJPEG(), writePGM(), writePNG(), and writePPM().

void vpImageIo::write	(	const vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Write the content of the image in the file which name is given by filename.

Always supported formats are *.pgm and *.ppm. If libjpeg 3rd party is used, we support also *.jpg and *.jpeg files. If libpng 3rd party is used, we support also *.png files. If OpenCV 3rd party is used, we support *.jpg, *.jpeg, *.jp2, *.rs, *.ras, *.tiff, *.tif, *.png, *.bmp, *.pbm files.

Parameters

I	: Image to write.
filename	: Name of the file containing the image.

Definition at line 589 of file vpImageIo.cpp.

References write().

void vpImageIo::writeJPEG	(	const vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a JPEG file.

Parameters

I	: Image to save as a JPEG file.
filename	: Name of the file containing the image.

Definition at line 1736 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

Referenced by write(), and writeJPEG().

void vpImageIo::writeJPEG	(	const vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a JPEG file.

Parameters

I	: Image to save as a JPEG file.
filename	: Name of the file containing the image.

Definition at line 1801 of file vpImageIo.cpp.

References writeJPEG().

void vpImageIo::writeJPEG	(	const vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a JPEG file.

Parameters

I	: Image to save as a JPEG file.
filename	: Name of the file containing the image.

Definition at line 1815 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

void vpImageIo::writeJPEG	(	const vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a JPEG file.

Parameters

I	: Image to save as a JPEG file.
filename	: Name of the file containing the image.

Definition at line 1882 of file vpImageIo.cpp.

References writeJPEG().

void vpImageIo::writePFM	(	const vpImage< float > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function is built like portable gray pixmap (eg PGM P5) file. but considers float image data.

Parameters

I	: Image to save as a (PFM P8) file.
filename	: Name of the file containing the image.

Definition at line 607 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

void vpImageIo::writePGM	(	const vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 663 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

Referenced by write(), and writePGM().

void vpImageIo::writePGM	(	const vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 1611 of file vpImageIo.cpp.

References writePGM().

void vpImageIo::writePGM	(	const vpImage< short > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 714 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImage< Type >::resize(), and writePGM().

void vpImageIo::writePGM	(	const vpImage< short > &	I,
		const std::string	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 1626 of file vpImageIo.cpp.

References writePGM().

void vpImageIo::writePGM	(	const vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file. Color image is converted into a grayscale image.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 739 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImageConvert::convert(), vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

void vpImageIo::writePGM	(	const vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PGM P5) file. Color image is converted into a grayscale image.

Parameters

I	: Image to save as a (PGM P5) file.
filename	: Name of the file containing the image.

Definition at line 1643 of file vpImageIo.cpp.

References writePGM().

void vpImageIo::writePNG	(	const vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a PNG file.

Parameters

I	: Image to save as a PNG file.
filename	: Name of the file containing the image.

Definition at line 2316 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

Referenced by write(), and writePNG().

void vpImageIo::writePNG	(	const vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a PNG file.

Parameters

I	: Image to save as a PNG file.
filename	: Name of the file containing the image.

Definition at line 2454 of file vpImageIo.cpp.

References writePNG().

void vpImageIo::writePNG	(	const vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a PNG file.

Parameters

I	: Image to save as a PNG file.
filename	: Name of the file containing the image.

Definition at line 2468 of file vpImageIo.cpp.

References vpImage< Type >::bitmap, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, and vpERROR_TRACE.

void vpImageIo::writePNG	(	const vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Write the content of the image bitmap in the file which name is given by filename. This function writes a PNG file.

Parameters

I	: Image to save as a PNG file.
filename	: Name of the file containing the image.

Definition at line 2608 of file vpImageIo.cpp.

References writePNG().

void vpImageIo::writePPM	(	const vpImage< unsigned char > &	I,
		const char *	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PPM P6) file. grayscale image is converted into a color image vpRGBa.

Parameters

I	: Image to save as a (PPM P6) file.
filename	: Name of the file containing the image.

Definition at line 1462 of file vpImageIo.cpp.

References vpImageConvert::convert(), and vpERROR_TRACE.

Referenced by write(), and writePPM().

void vpImageIo::writePPM	(	const vpImage< unsigned char > &	I,
		const std::string	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PPM P6) file. grayscale image is converted into a color image vpRGBa.

Parameters

I	: Image to save as a (PPM P6) file.
filename	: Name of the file containing the image.

Definition at line 1702 of file vpImageIo.cpp.

References writePPM().

void vpImageIo::writePPM	(	const vpImage< vpRGBa > &	I,
		const char *	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PPM P6) file.

Parameters

I	: Image to save as a (PPM P6) file.
filename	: Name of the file containing the image.

Definition at line 1489 of file vpImageIo.cpp.

References vpRGBa::B, vpRGBa::G, vpImage< Type >::getHeight(), vpImage< Type >::getWidth(), vpImageException::ioError, vpRGBa::R, and vpERROR_TRACE.

void vpImageIo::writePPM	(	const vpImage< vpRGBa > &	I,
		const std::string	filename
	)

static

Write the content of the bitmap in the file which name is given by filename. This function writes a portable gray pixmap (PPM P6) file.

Parameters

I	: Image to save as a (PPM P6) file.
filename	: Name of the file containing the image.

Definition at line 1716 of file vpImageIo.cpp.

References writePPM().

Static Public Member Functions

Detailed Description

Member Function Documentation