Back to index

lightning-sunbird  0.9+nobinonly
Public Member Functions | Public Attributes
gfxIImageFrame Interface Reference

gfxIImageFrame interface More...

import "gfxIImageFrame.idl";

Inheritance diagram for gfxIImageFrame:
Inheritance graph
[legend]
Collaboration diagram for gfxIImageFrame:
Collaboration graph
[legend]

List of all members.

Public Member Functions

void init (in PRInt32 aX, in PRInt32 aY, in PRInt32 aWidth, in PRInt32 aHeight, in gfx_format aFormat, in gfx_depth aDepth)
 Create a new aWidth x aHeight sized image.
void getRect (in nsRectRef rect)
 The rectangle this frame ocupies.
void getImageData ([array, size_is(length)] out PRUint8 bits, out unsigned long length)
void setImageData ([array, size_is(length), const ] in PRUint8 data, in unsigned long length, in long offset)
 Sets length bytes of data in this object.
void lockImageData ()
 Lock image pixels before addressing the data directly.
void unlockImageData ()
 Unlock image pixels.
void getAlphaData ([array, size_is(length)] out PRUint8 bits, out unsigned long length)
void setAlphaData ([array, size_is(length), const ] in PRUint8 data, in unsigned long length, in long offset)
 Sets length bytes of data in this object.
void lockAlphaData ()
 Lock alpha pixels before addressing the data directly.
void unlockAlphaData ()
 Unlock alpha pixels.
void drawTo (in gfxIImageFrame aDst, in PRInt32 aDX, in PRInt32 aDY, in PRInt32 aDWidth, in PRInt32 aDHeight)
 Blit this frame into another frame.

Public Attributes

attribute boolean mutable
 TRUE by default.
readonly attribute PRInt32 x
 The x-offset of the image.
readonly attribute PRInt32 y
 The y-offset of the image.
readonly attribute PRInt32 width
 The width of the image.
readonly attribute PRInt32 height
 The height of the image.
readonly attribute gfx_format format
 The image data format the image was created with.
readonly attribute boolean needsBackground
 returns whether the image requires the background to be painted
readonly attribute unsigned long imageBytesPerRow
readonly attribute unsigned long imageDataLength
 returns the number of bytes allocated for the image
readonly attribute unsigned long alphaBytesPerRow
readonly attribute unsigned long alphaDataLength
 returns the number of bytes allocated for the alpha mask
attribute long timeout
 Represents the number of milliseconds until the next frame should be displayed.
attribute long frameDisposalMethod
attribute gfx_color backgroundColor

Detailed Description

gfxIImageFrame interface

All x, y, width, height values are in pixels.

Author:
Tim Rowley tor@c.nosp@m.s.br.nosp@m.own.e.nosp@m.du
Stuart Parmenter pavlo.nosp@m.v@ne.nosp@m.tscap.nosp@m.e.co.nosp@m.m
Version:
0.1

Definition at line 61 of file gfxIImageFrame.idl.


Member Function Documentation

void gfxIImageFrame::drawTo ( in gfxIImageFrame  aDst,
in PRInt32  aDX,
in PRInt32  aDY,
in PRInt32  aDWidth,
in PRInt32  aDHeight 
)

Blit this frame into another frame.

Used for GIF animation compositing

void gfxIImageFrame::getAlphaData ( [array, size_is(length)] out PRUint8  bits,
out unsigned long  length 
)
void gfxIImageFrame::getImageData ( [array, size_is(length)] out PRUint8  bits,
out unsigned long  length 
)

The rectangle this frame ocupies.

Parameters:
rectthis is really an out parameter.
void gfxIImageFrame::init ( in PRInt32  aX,
in PRInt32  aY,
in PRInt32  aWidth,
in PRInt32  aHeight,
in gfx_format  aFormat,
in gfx_depth  aDepth 
)

Create a new aWidth x aHeight sized image.

Parameters:
aXThe x-offset from the origin of the gfxIImageContainer parent.
aYThe y-offset from the origin of the gfxIImageContainer parent.
aWidthThe width of the image to create.
aHeightThe height of the image to create.
aFormatthe width of the image to create.
Note:
The data of a new image is unspecified (Whats the word i'm looking for here?).

Lock alpha pixels before addressing the data directly.

Lock image pixels before addressing the data directly.

void gfxIImageFrame::setAlphaData ( [array, size_is(length), const ] in PRUint8  data,
in unsigned long  length,
in long  offset 
)

Sets length bytes of data in this object.

void gfxIImageFrame::setImageData ( [array, size_is(length), const ] in PRUint8  data,
in unsigned long  length,
in long  offset 
)

Sets length bytes of data in this object.

Parameters:
offsetThe offset from the first pixel in bytes. To set data beginning with the first (top left) pixel in the image, offset should be 0; to set data beginning with, for example, the sixth pixel in the first row of a RGBA32 image, the offset should be 20. should we use PRUint32 instead?

Unlock alpha pixels.

Unlock image pixels.


Member Data Documentation

Definition at line 160 of file gfxIImageFrame.idl.

returns the number of bytes allocated for the alpha mask

Definition at line 165 of file gfxIImageFrame.idl.

Definition at line 215 of file gfxIImageFrame.idl.

The image data format the image was created with.

See also:
gfxIFormats

Definition at line 117 of file gfxIImageFrame.idl.

Definition at line 210 of file gfxIImageFrame.idl.

The height of the image.

Definition at line 105 of file gfxIImageFrame.idl.

Definition at line 125 of file gfxIImageFrame.idl.

returns the number of bytes allocated for the image

Definition at line 130 of file gfxIImageFrame.idl.

TRUE by default.

When set to FALSE, you will no longer be able to make any modifications to the data of the image. Any attempts will fail.

Definition at line 85 of file gfxIImageFrame.idl.

returns whether the image requires the background to be painted

Definition at line 122 of file gfxIImageFrame.idl.

Represents the number of milliseconds until the next frame should be displayed.

Note:
-1 means that this frame should be displayed forever.

Definition at line 204 of file gfxIImageFrame.idl.

The width of the image.

Definition at line 100 of file gfxIImageFrame.idl.

The x-offset of the image.

Definition at line 90 of file gfxIImageFrame.idl.

The y-offset of the image.

Definition at line 95 of file gfxIImageFrame.idl.


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