From 940b4d1848e8c70ab7642901a68594e8016caffc Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 27 Apr 2024 18:51:28 +0200 Subject: Adding upstream version 1:7.0.4. Signed-off-by: Daniel Baumann --- .../com/sun/star/rendering/XBufferController.idl | 121 +++++++++++++++++++++ 1 file changed, 121 insertions(+) create mode 100644 offapi/com/sun/star/rendering/XBufferController.idl (limited to 'offapi/com/sun/star/rendering/XBufferController.idl') diff --git a/offapi/com/sun/star/rendering/XBufferController.idl b/offapi/com/sun/star/rendering/XBufferController.idl new file mode 100644 index 000000000..b9ddcf001 --- /dev/null +++ b/offapi/com/sun/star/rendering/XBufferController.idl @@ -0,0 +1,121 @@ +/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ +/* + * This file is part of the LibreOffice project. + * + * This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (the "License"); you may not use this file + * except in compliance with the License. You may obtain a copy of + * the License at http://www.apache.org/licenses/LICENSE-2.0 . + */ +#ifndef __com_sun_star_rendering_XBufferController_idl__ +#define __com_sun_star_rendering_XBufferController_idl__ + +#include +#include + +module com { module sun { module star { module rendering { + +/** Interface providing access to double/multi-buffer facilities of + screen devices.

+ + This interface provides methods to enable and control + double/multi-buffering facilities on screen devices.

+ + @since OOo 2.0 + */ +interface XBufferController : ::com::sun::star::uno::XInterface +{ + /** Create the given number of background buffers.

+ + There's one buffer implicitly available, which is the canvas + surface itself. Thus, calling createBuffers(1) + creates a double-buffered object.

+ + @param nBuffers + The number of background<buffers requested. Must be greater + than 0. + + @return the number of actually generated buffers, which might + be between 0 (no double-buffering available) and nBuffers. + + @throws com::sun::star::lang::IllegalArgumentException + if nBuffers is smaller than one. + */ + long createBuffers( [in] long nBuffers ) + raises (com::sun::star::lang::IllegalArgumentException); + + + /** Destroy all buffers generated via this object. + */ + void destroyBuffers(); + + + /** Switch the display to show the specified buffer.

+ + The method returns, when the switch is performed and the + selected buffer is shown on screen, or immediately when an + error occurs. If the switch was successful, subsequent render + operations will be directed to the new backbuffer.

+ + Use this method if you need your screen display to be in sync + with other things, e.g. sound playback.

+ + @param bUpdateAll + When `TRUE`, update the whole screen. When `FALSE`, + implementation is permitted to restrict update to areas the + canvas itself changed (e.g. because of render operations, or + changes on the sprites). The former is useful for updates + after window expose events, the latter for animation display. + + @return whether the switch was performed successfully. + + @throws com::sun::star::lang::IllegalArgumentException + if nBuffer is outside the permissible range. + */ + boolean showBuffer( [in] boolean bUpdateAll ); + + + /** Schedule the display of the specified buffer.

+ + The method returns, when the switching of the buffer is + successfully scheduled, or immediately when an error + occurs. If the switch was successful, subsequent render + operations will be directed to the new backbuffer. Note that, + if the buffer switching is exceedingly slow, or the frequency + of switchBuffer() is exceedingly high, the buffer scheduled + for display here might become the current render target + before it is fully displayed on screen. In this case, + any rendering operation to this buffer will block, until it is + safe to perform the operation without visible cluttering.

+ + Use this method if you favor maximal render speed, but don't + necessarily require your screen display to be in sync with + other things, e.g. sound playback.

+ + @param bUpdateAll + When `TRUE`, update the whole screen. When `FALSE`, + implementation is permitted to restrict update to areas the + canvas itself changed (e.g. because of render operations, or + changes on the sprites). The former is useful for updates + after window expose events, the latter for animation display. + + @return whether the switch was performed successfully. + */ + boolean switchBuffer( [in] boolean bUpdateAll ); + +}; + +}; }; }; }; + +#endif + +/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ -- cgit v1.2.3