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 --- offapi/com/sun/star/rendering/XIntegerBitmap.idl | 127 +++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 offapi/com/sun/star/rendering/XIntegerBitmap.idl (limited to 'offapi/com/sun/star/rendering/XIntegerBitmap.idl') diff --git a/offapi/com/sun/star/rendering/XIntegerBitmap.idl b/offapi/com/sun/star/rendering/XIntegerBitmap.idl new file mode 100644 index 000000000..2f4c6ae92 --- /dev/null +++ b/offapi/com/sun/star/rendering/XIntegerBitmap.idl @@ -0,0 +1,127 @@ +/* -*- 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_XIntegerBitmap_idl__ +#define __com_sun_star_rendering_XIntegerBitmap_idl__ + +#include +#include +#include +#include +#include +#include + + +module com { module sun { module star { module rendering { + +/** This is a specialized interface for bitmaps having integer color + channels.

+ + @since OOo 2.0 + */ +interface XIntegerBitmap : XIntegerReadOnlyBitmap +{ + + /** Set raw data of a bitmap.

+ + Set raw data of a bitmap, in the format as defined by + getMemoryLayout(). With the given rectangle, a subset of the + bitmap can be changed. If the internal data format's pixel are + not integer multiples of bytes (i.e. if one pixel occupies + less than a byte), the leftover content of the bytes at the + right of each scanline is ignored and left unchanged in the + bitmap. When setting subsets of the bitmap, the same scanline + padding takes place as when the whole bitmap is changed.

+ + When setting data on volatile bitmaps, always call isValid() + before, and retrieve a new memory layout via + getMemoryLayout(). At least under Windows, the memory layout + can change for the same bitmap, if the user e.g. switches the + screen resolution. Thus, this method will throw an + IllegalArgumentException, if the memory layout changed between + a call to getMemoryLayout() and setData(). + + @param data + Data to set + + @param bitmapLayout + Layout of the data to set. Must match this bitmap's current + layout. + + @param rect + Destination rectangle, within the bounds of the bitmap, to set + the data in. + + @throws com::sun::star::lang::IndexOutOfBoundsException + if parts of the given rectangle are outside the permissible + bitmap area. + + @throws com::sun::star::lang::IllegalArgumentException + if the given memory layout does not match this bitmap's + layout, or if the given data sequence has too few or too many + elements. + */ + void setData( [in] sequence data, [in] IntegerBitmapLayout bitmapLayout, [in] ::com::sun::star::geometry::IntegerRectangle2D rect ) + raises (com::sun::star::lang::IllegalArgumentException, + com::sun::star::lang::IndexOutOfBoundsException); + + + /** Set a single pixel of the bitmap with the given color + value.

+ + If the internal data format's pixel are not integer multiples + of bytes (i.e. if one pixel occupies less than a byte), the + color value is expected in the least significant bits of the + single byte given as the color.

+ + When setting data on volatile bitmaps, always call isValid() + before, and retrieve a new memory layout via + getMemoryLayout(). At least under Windows, the memory layout + can change for the same bitmap, if the user e.g. switches the + screen resolution. Thus, this method will throw an + IllegalArgumentException, if the memory layout changed between + a call to getMemoryLayout() and setPixel(). + + @param color + The color value(s) to set + + @param bitmapLayout + Layout of the color elements to set. Must match this bitmap's + current layout. + + @param pos + Pixel position with the bounds of the bitmap to set. + + @throws com::sun::star::lang::IndexOutOfBoundsException + if the given point is outside the permissible bitmap area. + + @throws com::sun::star::lang::IllegalArgumentException + if the given memory layout does not match this bitmap's + layout, or if the given data sequence has too few or too many + elements. + */ + void setPixel( [in] sequence color, [in] IntegerBitmapLayout bitmapLayout, [in] ::com::sun::star::geometry::IntegerPoint2D pos ) + raises (com::sun::star::lang::IllegalArgumentException, + com::sun::star::lang::IndexOutOfBoundsException); +}; + +}; }; }; }; + +#endif + +/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ -- cgit v1.2.3