Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

:: com :: sun :: star :: rendering ::

unpublished interface XBitmap
Base Interfaces
XBitmap
┗ ::com::sun::star::uno::XInterface

::com::sun::star::uno::XInterface
Description
This is a generic interface to a bitmap.

This interface contains the generic functionality to be used on every XCanvas bitmap object. More format-specific methods can be found at the XIntegerBitmap , XIeeeDoubleBitmap , XIeeeFloatBitmap and XHalfFloatBitmap interfaces.

Since
OOo 2.0.0

Methods' Summary
getSize Query the size of the bitmap.  
hasAlpha Query transparency status of the bitmap.  
queryBitmapCanvas Query a canvas interface for this bitmap.  
getScaledBitmap Query a scaled version of the original bitmap.  
Methods' Details
getSize
::com::sun::star::geometry::IntegerSize2D
getSize();

Description
Query the size of the bitmap.

This method queries the bitmap size in pixel.

Returns
the bitmap size in pixel.
hasAlpha
boolean
hasAlpha();

Description
Query transparency status of the bitmap.

This method checks, whether the bitmap contains any alpha information.

Returns
, if the bitmap has alpha data, or if not.
queryBitmapCanvas
XBitmapCanvas
queryBitmapCanvas();

Description
Query a canvas interface for this bitmap.

This method queries a canvas interface for this bitmap, to which draw operations can then be issued. Please note that concurrent draw operations on that XBitmapCanvas interface and modifying operations on this bitmap interface might cause undesired effects. Although the implementations are required to not crash in this case, the result of such concurrent operations are undefined (i.e. anything else, including corruption of the bitmap data, or deadlocking, might actually happen). Thus, it is highly recommended to externally serialize the access here.

Returns
an XBitmapCanvas interface, whose rendering operations are directed into the bitmap.
getScaledBitmap
XBitmap
getScaledBitmap( [in] ::com::sun::star::geometry::RealSize2D  newSize,
[in] boolean  beFast )
raises( ::com::sun::star::lang::IllegalArgumentException,
VolatileContentDestroyedException );

Description
Query a scaled version of the original bitmap.
Parameter newSize
Requested size of the new bitmap. Both of the two size components must be greater than zero.
Parameter beFast
When set to true, this parameter advises getScaledBitmap to use the fastest available algorithm to scale the bitmap, which might cause visible artifacts.
Returns
the new scaled bitmap.
Throws
com::sun::star::lang::IllegalArgumentException if the size components are outside the specified range.
Throws
VolatileContentDestroyedException if the contents of a volatile bitmap have been destroyed, and thus cannot be read to generate the scaled bitmap.
Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.