Interface to a class representing a JPEG (.jpg or .jpeg) image. More...

#include <idomimageresource.h>

Inheritance diagram for IDOMJPEGImage:

[legend]

Static Public Member Functions
static EDL_API IDOMJPEGImagePtr	create (IEDLClassFactory *pFactory, const IInputStreamPtr &stream)
	Create a JPEG Image resource with the given JPEG stream.

static EDL_API IDOMImagePtr	createWriterAndImage (const ISessionPtr &session, IImageFrameWriterPtr &frame, const IDOMColorSpacePtr &colorSpace, uint32 width, uint32 height, uint8 bitsPerComponent=8, double xResolution=96.0, double yResolution=96.0, uint8 quality=3, const IInputStreamPtr &inStream=IInputStreamPtr(), const IOutputStreamPtr &outStream=IOutputStreamPtr())
	Create an IDOMJPEGImage and frame that can be used to populate same.

static EDL_API void	encode (const ISessionPtr &pSession, const IDOMImagePtr &image, const IOutputStreamPtr &stream, uint8 quality=3, bool allowCmyk=false, bool invertCmyk=true)
	Encode an image as a JPEG stream. This routine may convert the source image into a form that may be encoded as JPEG, such as by stripping alpha channels or converting to a supported color space.

static EDL_API void	encode (const ISessionPtr &pSession, const IImageFramePtr &frame, const IOutputStreamPtr &stream, uint8 quality=3, bool allowCmyk=false, bool invertCmyk=true)
	Encode the contents of an IImageFrame as a JPEG stream, returning the stream. This routine may convert the source image into a form that may be encoded as JPEG, such as by stripping alpha channels or converting to a supported color space.

static const CClassID &	classID ()
	Retrieves class id of IDOMJPEGImage.

Additional Inherited Members
Public Member Functions inherited from IDOMImage
virtual IImageDecoderPtr	createImageDecoder (IEDLClassFactory *factory, const IDOMImagePropertiesPtr &imageProperties)=0
	Creates a properly initialized image decoder object that reads from an inputstream that is specific to that image format.

virtual IImageFramePtr	getImageFrame (IEDLClassFactory *factory)
	Fetch the image frame; convenience.

virtual IImageEncoderPtr	createImageEncoder (const ISessionPtr &session, const IOutputStreamPtr &imageDest, const IDOMImagePropertiesPtr &imageProperties)=0
	Creates a properly initialized image encoder object that writes to an outputstream that is specific to that image format.

virtual IDOMImagePropertiesPtr	getImageProperties ()=0
	Returns an object that stores the properties for this image object. The properties can then be inspected (or more added) by clients that need to manipulate the image resource.

virtual eDOMImageType	getImageType ()=0
	Retrieves the image type.

virtual bool	getIsRendered ()=0
	Determine if the image is as a result of rendering. This is indicated if the image type is eDITRendered or if the image explicitly notes this is the case (such as for IDOMPDFImage).

virtual IDOMImagePtr	getImageWithSubstitutedColorSpace (IEDLClassFactory *factory, const IDOMColorSpacePtr &colorSpace)
	Obtain an image that is the same as this image, but with the colorspace substituted for another.

Public Member Functions inherited from IDOMResource
virtual IInputStreamPtr	getStream () const =0
	Retrieves the resource stream.

virtual void	setStream (const IInputStreamPtr &stream)=0
	Sets the resource stream for the node.

virtual uint64	getStreamLength () const =0
	Retrieves the stream length, if it is available.

virtual const EDLSysString &	getUri () const =0
	Retrieves the resource URI.

virtual void	setUri (const EDLSysString &uri)=0
	Sets the resource URI.

Public Member Functions inherited from IEDLObject
virtual const CClassID &	getClassID () const =0
	Returns class ID of IEDLObject.

virtual bool	init (CClassParams *pData)
	The init() method is called to perform any post-construction initialization of an IEDLObject that has been created by the EDL class factory, before it is actually returned by the factory.

virtual bool	clone (IEDLObjectPtr &ptrObject, IEDLClassFactory *pFactory)
	Create a copy of EDLObject.

Public Member Functions inherited from IRCObject
virtual void	addRef () const =0
	Increases the reference count of the actual object pointed to. This would take place during an assignment or copying.

virtual bool	decRef () const =0
	Decreases the reference count of the actual object pointed to. When the reference count falls to Zero, it deletes the actual object pointed to.

virtual int32	getRefCount () const =0
	Retrieve the current reference count of the actual object pointed to.

Public Member Functions inherited from IDOMHashable
virtual	~IDOMHashable ()
	Virtual destructor.

virtual bool	hash (uint64 &hash)=0
	Retrieve a hash for this object.

virtual uint64	hashE ()
	As hash(), but throws an exception if the operation fails.

Protected Member Functions inherited from IRCObject
virtual	~IRCObject ()
	Virtual destructor.

Detailed Description

Interface to a class representing a JPEG (.jpg or .jpeg) image.

Member Function Documentation

◆ classID()

static const CClassID & IDOMJPEGImage::classID ( )

inlinestatic

Retrieves class id of IDOMJPEGImage.

Returns: CClassID Class id of the element

◆ create()

static EDL_API IDOMJPEGImagePtr IDOMJPEGImage::create	(	IEDLClassFactory *	pFactory,
		const IInputStreamPtr &	stream )

static

Create a JPEG Image resource with the given JPEG stream.

Parameters

pFactory	The EDL Class factory to use.
stream	The stream containing the JPEG image.

Returns: IDOMImagePtr The new image.

◆ createWriterAndImage()

static EDL_API IDOMImagePtr IDOMJPEGImage::createWriterAndImage	(	const ISessionPtr &	session,
		IImageFrameWriterPtr &	frame,
		const IDOMColorSpacePtr &	colorSpace,
		uint32	width,
		uint32	height,
		uint8	bitsPerComponent = 8,
		double	xResolution = 96.0,
		double	yResolution = 96.0,
		uint8	quality = 3,
		const IInputStreamPtr &	inStream = IInputStreamPtr(),
		const IOutputStreamPtr &	outStream = IOutputStreamPtr() )

static

Create an IDOMJPEGImage and frame that can be used to populate same.

Parameters

session	The session to use
frame	On exit, this is populated with a frame ready to receive image data via frame->writeScanLine(). Use frame->flushData() to complete the encoding process.
colorSpace	The color space to use. Must be compatible with the JPEG format.
width	The width of the image, in pixels.
height	The height of the image, in pixels.
bitsPerComponent	The number of bits per color component, either 8 or 16. Default is 8.
xResolution	The x resolution, in pixels-per-inch.
yResolution	The y resolution, in pixels-per-inch.
quality	The desired quality in the range 1 through 5, with 1 being lowest and 5 being highest. Default is 3.
inStream	Optional. The first in a pair of streams used to read and write the raw image data if an external stream is desired. If NULL, a temporary store stream will be created. If non NULL, outStream must also be provided.
outStream	Optional. The second in a pair of streams used to read and write the raw image data if an external stream is desired. If NULL, a temporary store stream will be created. If non NULL, inStream must also be provided.

Returns: IDOMImagePtr The resulting image. Not valid until the frame is flushed.

◆ encode() [1/2]

static EDL_API void IDOMJPEGImage::encode	(	const ISessionPtr &	pSession,
		const IDOMImagePtr &	image,
		const IOutputStreamPtr &	stream,
		uint8	quality = 3,
		bool	allowCmyk = false,
		bool	invertCmyk = true )

static

Encode an image as a JPEG stream. This routine may convert the source image into a form that may be encoded as JPEG, such as by stripping alpha channels or converting to a supported color space.

Parameters

pSession	The relevant EDL session
image	The image to be encoded
stream	The stream to use to store the image data.
quality	The desired quality in the range 1 through 5, with 1 being lowest and 5 being highest. Default is 3.
allowCmyk	Whether or not CMYK encoding should be allowed. CMYK JPEGs are not universally supported, and so are not generated by default.
invertCmyk	If CMYK data is encoded, this controls whether or not the image data is inverted. If inverted, it is likely that the CMYK image will view correctly in more viewers. However, doing this will result in inverted results when the image is used with Mako.

◆ encode() [2/2]

static EDL_API void IDOMJPEGImage::encode	(	const ISessionPtr &	pSession,
		const IImageFramePtr &	frame,
		const IOutputStreamPtr &	stream,
		uint8	quality = 3,
		bool	allowCmyk = false,
		bool	invertCmyk = true )

static

Encode the contents of an IImageFrame as a JPEG stream, returning the stream. This routine may convert the source image into a form that may be encoded as JPEG, such as by stripping alpha channels or converting to a supported color space.

Parameters

pSession	The relevant EDL session
frame	The frame providing the source image data
stream	The stream to use to store the image data.
quality	The desired quality in the range 1 through 5, with 1 being lowest and 5 being highest. Default is 3.
allowCmyk	Whether or not CMYK encoding should be allowed. CMYK JPEGs are not universally supported, and so are not generated by default.
invertCmyk	If CMYK data is encoded, this controls whether or not the image data is inverted. If inverted, it is likely that the CMYK image will view correctly in more viewers. However, doing this will result in inverted results when the image is used with Mako.

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

idomimageresource.h

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ classID()

◆ create()

◆ createWriterAndImage()

◆ encode() [1/2]

◆ encode() [2/2]