juce::JPEGImageFormat Class Reference

A subclass of ImageFileFormat for reading and writing JPEG files. More...

#include "juce_ImageFileFormat.h"

Inheritance diagram for juce::JPEGImageFormat:

Public Member Functions
void	setQuality (float newQuality)
	Specifies the quality to be used when writing a JPEG file.
String	getFormatName () override
	Returns a description of this file format.
bool	usesFileExtension (const File &) override
	Returns true if this format uses the file extension of the given file.
bool	canUnderstand (InputStream &) override
	Returns true if the given stream seems to contain data that this format understands.
Image	decodeImage (InputStream &) override
	Tries to decode and return an image from the given stream.
bool	writeImageToStream (const Image &, OutputStream &) override
	Attempts to write an image to a stream.
Public Member Functions inherited from juce::ImageFileFormat
virtual	~ImageFileFormat ()=default
	Destructor.

Additional Inherited Members
Static Public Member Functions inherited from juce::ImageFileFormat
static ImageFileFormat *	findImageFormatForStream (InputStream &input)
	Tries the built-in formats to see if it can find one to read this stream.
static ImageFileFormat *	findImageFormatForFileExtension (const File &file)
	Looks for a format that can handle the given file extension.
static Image	loadFrom (InputStream &input)
	Tries to load an image from a stream.
static Image	loadFrom (const File &file)
	Tries to load an image from a file.
static Image	loadFrom (const void *rawData, size_t numBytesOfData)
	Tries to load an image from a block of raw image data.
Protected Member Functions inherited from juce::ImageFileFormat
	ImageFileFormat ()=default
	Creates an ImageFormat.

Detailed Description

A subclass of ImageFileFormat for reading and writing JPEG files.

See also

ImageFileFormat, PNGImageFormat

@tags{Graphics}

Definition at line 174 of file juce_ImageFileFormat.h.

Constructor & Destructor Documentation

JPEGImageFormat()

juce::JPEGImageFormat::JPEGImageFormat

(

)

Definition at line 212 of file juce_JPEGLoader.cpp.

~JPEGImageFormat()

juce::JPEGImageFormat::~JPEGImageFormat ( )

override

Definition at line 217 of file juce_JPEGLoader.cpp.

Member Function Documentation

canUnderstand()

bool juce::JPEGImageFormat::canUnderstand ( InputStream &  input )

overridevirtual

Returns true if the given stream seems to contain data that this format understands.

The format class should only read the first few bytes of the stream and sniff for header bytes that it understands.

Note that this will advance the stream and leave it in a new position, so if you're planning on re-using it, you may want to rewind it after calling this method.

See also

decodeImage

Implements juce::ImageFileFormat.

Definition at line 227 of file juce_JPEGLoader.cpp.

decodeImage()

Image juce::JPEGImageFormat::decodeImage ( InputStream &  input )

overridevirtual

Tries to decode and return an image from the given stream.

This will be called for an image format after calling its canUnderStand() method to see if it can handle the stream.

Parameters

input

the stream to read the data from. The stream will be positioned at the start of the image data (but this may not necessarily be position 0)

Returns

the image that was decoded, or an invalid image if it fails.

See also

loadFrom

Implements juce::ImageFileFormat.

Definition at line 252 of file juce_JPEGLoader.cpp.

getFormatName()

String juce::JPEGImageFormat::getFormatName ( )

overridevirtual

Returns a description of this file format.

E.g. "JPEG", "PNG"

Implements juce::ImageFileFormat.

Definition at line 224 of file juce_JPEGLoader.cpp.

setQuality()

void juce::JPEGImageFormat::setQuality

(

float

newQuality

)

Specifies the quality to be used when writing a JPEG file.

Parameters

newQuality

a value 0 to 1.0, where 0 is low quality, 1.0 is best, or any negative value is "default" quality

Definition at line 219 of file juce_JPEGLoader.cpp.

usesFileExtension()

bool juce::JPEGImageFormat::usesFileExtension ( const File &  possibleFile )

overridevirtual

Returns true if this format uses the file extension of the given file.

Implements juce::ImageFileFormat.

Definition at line 225 of file juce_JPEGLoader.cpp.

writeImageToStream()

bool juce::JPEGImageFormat::writeImageToStream ( const Image &  sourceImage, OutputStream &  destStream  )

overridevirtual

Attempts to write an image to a stream.

To specify extra information like encoding quality, there will be appropriate parameters in the subclasses of the specific file types.

Returns

true if it nothing went wrong.

Implements juce::ImageFileFormat.

Definition at line 362 of file juce_JPEGLoader.cpp.

---

The documentation for this class was generated from the following files:

• juce_graphics/images/juce_ImageFileFormat.h
• juce_graphics/image_formats/juce_JPEGLoader.cpp