LibreOffice
LibreOffice 24.2 SDK API Reference
|
This interface provides access to a graphic device, such as a printer, or a screen device. More...
import"XGraphicDevice.idl";
Public Member Functions | |
XBufferController | getBufferController () |
Query the controller for multi buffering functionality on this graphic device. More... | |
XColorSpace | getDeviceColorSpace () |
Query the color space interface for this graphic device. More... | |
::com::sun::star::geometry::RealSize2D | getPhysicalResolution () |
Query the physical resolution of the device in pixel per millimeter. More... | |
::com::sun::star::geometry::RealSize2D | getPhysicalSize () |
Query the physical dimensions of the device in millimeter. More... | |
XLinePolyPolygon2D | createCompatibleLinePolyPolygon ([in] sequence< sequence< ::com::sun::star::geometry::RealPoint2D > > points) |
Create a line poly-polygon which can internally use device-optimized representations already. More... | |
XBezierPolyPolygon2D | createCompatibleBezierPolyPolygon ([in] sequence< sequence< ::com::sun::star::geometry::RealBezierSegment2D > > points) |
Create a Bezier poly-polygon which can internally use device-optimized representations already. More... | |
XBitmap | createCompatibleBitmap ([in] ::com::sun::star::geometry::IntegerSize2D size) raises (com::sun::star::lang::IllegalArgumentException) |
Create a bitmap whose memory layout and sample model is compatible to the graphic device. More... | |
XVolatileBitmap | createVolatileBitmap ([in] ::com::sun::star::geometry::IntegerSize2D size) raises (com::sun::star::lang::IllegalArgumentException) |
Create a volatile bitmap that is usable with this graphic device. More... | |
XBitmap | createCompatibleAlphaBitmap ([in] ::com::sun::star::geometry::IntegerSize2D size) raises (com::sun::star::lang::IllegalArgumentException) |
Create a bitmap with alpha channel whose memory layout and sample model is compatible to the graphic device. More... | |
XVolatileBitmap | createVolatileAlphaBitmap ([in] ::com::sun::star::geometry::IntegerSize2D size) raises (com::sun::star::lang::IllegalArgumentException) |
Create a volatile bitmap with alpha channel that is usable with this graphic device. More... | |
com::sun::star::lang::XMultiServiceFactory | getParametricPolyPolygonFactory () |
Get a reference to this device's parametric polygon factory. More... | |
boolean | hasFullScreenMode () |
Tells whether this graphic device has a full screen mode, i.e. More... | |
boolean | enterFullScreenMode ([in] boolean bEnter) |
Enter or leave the fullscreen mode, if possible. More... | |
Public Member Functions inherited from XInterface | |
any | queryInterface ([in] type aType) |
queries for a new interface to an existing UNO object. More... | |
void | acquire () |
increases the reference counter by one. More... | |
void | release () |
decreases the reference counter by one. More... | |
This interface provides access to a graphic device, such as a printer, or a screen device.
Every canvas (
For a typical windowing system, the graphic device is equivalent to a distinct OS window, with its own clipped output area, fullscreen and double-buffering attributes. That is, even if one can have multiple canvases per system window, they all share the same graphic device and thus e.g. fullscreen state. If the OS restrictions are in such a way that fullscreen or double-buffering is screen-exclusive, i.e. that per screen, only one object can have this state, it might even be that all windows on the screen share a common graphic device.
XBitmap createCompatibleAlphaBitmap | ( | [in] ::com::sun::star::geometry::IntegerSize2D | size | ) | |
raises | ( | com::sun::star::lang::IllegalArgumentException | |||
) |
Create a bitmap with alpha channel whose memory layout and sample model is compatible to the graphic device.
size | Size of the requested bitmap in pixel. Both components of the size must be greater than 0 |
XBezierPolyPolygon2D createCompatibleBezierPolyPolygon | ( | [in] sequence< sequence< ::com::sun::star::geometry::RealBezierSegment2D > > | points | ) |
Create a Bezier poly-polygon which can internally use device-optimized representations already.
points | The points of the poly-polygon, in a separate array for every polygon. |
XBitmap createCompatibleBitmap | ( | [in] ::com::sun::star::geometry::IntegerSize2D | size | ) | |
raises | ( | com::sun::star::lang::IllegalArgumentException | |||
) |
Create a bitmap whose memory layout and sample model is compatible to the graphic device.
size | Size of the requested bitmap in pixel. Both components of the size must be greater than 0 |
XLinePolyPolygon2D createCompatibleLinePolyPolygon | ( | [in] sequence< sequence< ::com::sun::star::geometry::RealPoint2D > > | points | ) |
Create a line poly-polygon which can internally use device-optimized representations already.
points | The points of the poly-polygon, in a separate array for every polygon. |
XVolatileBitmap createVolatileAlphaBitmap | ( | [in] ::com::sun::star::geometry::IntegerSize2D | size | ) | |
raises | ( | com::sun::star::lang::IllegalArgumentException | |||
) |
Create a volatile bitmap with alpha channel that is usable with this graphic device.
A volatile bitmap's difference in comparison to a plain bitmap (e.g. generated via createCompatibleBitmap()) is the fact that its content might vanish at any point in time (making any operation with them produce a VolatileContentDestroyedException). The benefit, on the other hand, is that they might be easy to hardware-accelerate on certain platforms, without the need to keep a safety copy of the content internally.
size | Size of the requested bitmap in pixel. Both components of the size must be greater than 0 |
XVolatileBitmap createVolatileBitmap | ( | [in] ::com::sun::star::geometry::IntegerSize2D | size | ) | |
raises | ( | com::sun::star::lang::IllegalArgumentException | |||
) |
Create a volatile bitmap that is usable with this graphic device.
A volatile bitmap's difference in comparison to a plain bitmap (e.g. generated via createCompatibleBitmap()) is the fact that its content might vanish at any point in time (making any operation with them produce a VolatileContentDestroyedException). The benefit, on the other hand, is that they might be easy to hardware-accelerate on certain platforms, without the need to keep a safety copy of the content internally.
size | Size of the requested bitmap in pixel. Both components of the size must be greater than 0 |
boolean enterFullScreenMode | ( | [in] boolean | bEnter | ) |
Enter or leave the fullscreen mode, if possible.
The return value denotes the success of the operation.
XBufferController getBufferController | ( | ) |
Query the controller for multi buffering functionality on this graphic device.
If there is no such functionality available, the NULL reference is returned.
XColorSpace getDeviceColorSpace | ( | ) |
Query the color space interface for this graphic device.
This is to be used when interpreting or setting device color values.
com::sun::star::lang::XMultiServiceFactory getParametricPolyPolygonFactory | ( | ) |
Get a reference to this device's parametric polygon factory.
Available services (all canvas implementations should provide this minimal set, though are free to add more; just check the getAvailableServiceNames() on the returned interface):
sequence< Color >
and "Stops" being a sequence< double >
. Both must have the same length, and at least two elements. See http://www.w3.org/TR/SVG11/pservers.html#GradientStops for the semantics of gradient stops and colors. Required gradient services:::com::sun::star::geometry::RealSize2D getPhysicalResolution | ( | ) |
Query the physical resolution of the device in pixel per millimeter.
A special floating point value of +infinity here indicates "unknown", i.e. at the time of rendering undetermined or possibly infinite resolution along the corresponding direction.
::com::sun::star::geometry::RealSize2D getPhysicalSize | ( | ) |
Query the physical dimensions of the device in millimeter.
A special floating point value of +infinity here indicates "unknown", i.e. at the time of rendering undetermined or possibly infinite resolution along the corresponding direction.
boolean hasFullScreenMode | ( | ) |
Tells whether this graphic device has a full screen mode, i.e.
whether a window can cover the whole screen exclusively.