Interface XBitmapCanvas

Devguide

Index

Methods' Summary

Methods' Details

Attributes' Summary

Attributes' Details

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

unpublished

interface XBitmapCanvas

Base Interfaces

XBitmapCanvas
┗ XCanvas
   ┗ ::com::sun::star::uno::XInterface

XCanvas

(referenced interface's summary:): Central interface for rendering.

Description

This is a specialization of the canvas interface for bitmapped canvases.

This interface is a specialization of the canvas interface for bitmapped canvases, where additional methods for accessing and moving of bitmap content are provided.

Since

OOo 2.0.0

Methods' Summary
copyRect	This method copies a rectangular area from a place of one canvas to a place on another.

Methods' Details

copyRect

void
copyRect(	[in] XBitmapCanvas	sourceCanvas,
	[in] ::com::sun::star::geometry::RealRectangle2D	sourceRect,
	[in] ViewState	sourceViewState,
	[in] RenderState	sourceRenderState,
	[in] ::com::sun::star::geometry::RealRectangle2D	destRect,
	[in] ViewState	destViewState,
	[in] RenderState	destRenderState )
raises(	::com::sun::star::lang::IllegalArgumentException, VolatileContentDestroyedException );

Description

This method copies a rectangular area from a place of one canvas to a place on another.

This method copies a rectangular area from a place of one canvas to a place on another. Source and destination areas are permitted to overlap. If the source view or render state has a clipping set, the regions clipped away from the source rectangle are regarded fully transparent for the copy operation. The device color for both source and destination render state is ignored, the compositing mode only for the source render state.

Parameter sourceCanvas

Canvas from which to copy the bitmap data. Can be identical to the canvas this method is called on, but must be valid.

Parameter sourceRect

Rectangle from which to copy the bitmap data. This rectangle is subject to both view and render transformation, before being applied. Thus, on screen, it does not necessarily resemble a rectangle any more. The rectangle must be non-empty, see ::com::sun::star::geometry::RealRectangle2D for details.

Parameter sourceViewState

The view state to apply to the source of this copy operation. The view transformation must be non-singular.

Parameter sourceRenderState

The render state to apply to the source of this copy operation. The render transformation must be non-singular, and the compositing mode must be one of the ::CompositingOperation values.

Parameter destRect

Rectangle into which to copy the bitmap data. This rectangle is subject to both view and render transformation, before being applied. Thus, on screen, it does not necessarily resemble a rectangle any more. The rectangle must be non-empty, see ::com::sun::star::geometry::RealRectangle2D for details.

Parameter destViewState

The view state to apply to the destination of this copy operation. The view transformation must be non-singular.

Parameter destRenderState

The render state to apply to the destination of this copy operation. The render transformation must be non-singular, and the compositing mode must be one of the ::CompositingOperation values.

Throws

com::sun::star::lang::IllegalArgumentException if one of the parameters are not within the specified range.

Top of Page