interface XImageConsumer in module com::sun::star::awt::

(Global Index)

Syntax

interface XImageConsumer : com::sun::star::uno::XInterface ;

Description

specifies a data sink for an image, or in other words, an interface for a component which wants to display or just receive an image from an image producer.

See also

XImageProducer

Method Summary

init This initializes the consumer with image dimensions.

setColorModel changes color model for next pixels typically called once after initialization.

setPixelsByBytes delivers a chunk of pixels as long values.

setPixelsByLongs delivers a chunk of pixels as byte values.

complete is called for the notification of the degree to which the image is delivered.

Method Details



init

Syntax

oneway void init (
long Width,
long Height );

Description

This initializes the consumer with image dimensions.


setColorModel

Syntax

oneway void setColorModel (
short BitCount,
sequence< long > RGBAPal,
long RedMask,
long GreenMask,
long BlueMask,
long AlphaMask );

Description

changes color model for next pixels typically called once after initialization.


setPixelsByBytes

Syntax

oneway void setPixelsByBytes (
long nX,
long nY,
long nWidth,
long nHeight,
sequence< byte > aProducerData,
long nOffset,
long nScanSize );

Description

delivers a chunk of pixels as long values.

The pixels of the image are delivered using one or more calls to this method. Each call specifies the location and size of the rectangle of source pixels that are contained in the array of pixels. The specified color model object should be used to convert the pixels into their corresponding color and alpha components. Pixel (m,n) is stored in the pixels array at index (n * nScanSize + m + nOffset).


setPixelsByLongs

Syntax

oneway void setPixelsByLongs (
long nX,
long nY,
long nWidth,
long nHeight,
sequence< long > aProducerData,
long nOffset,
long nScanSize );

Description

delivers a chunk of pixels as byte values.

The pixels of the image are delivered using one or more calls to this method. Each call specifies the location and size of the rectangle of source pixels that are contained in the array of pixels. The specified color model object should be used to convert the pixels into their corresponding color and alpha components. Pixel (m,n) is stored in the pixels array at index (n * nScanSize + m + nOffset).


complete

Syntax

oneway void complete (
long Status,
com::sun::star::awt::XImageProducer xProducer );

Description

is called for the notification of the degree to which the image is delivered.

The complete method is called when the image producer has finished delivering all of the pixels that the source image contains, or when a single frame of a multi-frame animation has been completed, or when an error in loading or producing the image has occurred. The image consumer should remove itself from the list of consumers registered with the image producer at this time, unless it is interested in successive frames.

Top of Page