/usr/include/mirclient/mir_toolkit/debug/surface.h is in libmirclient-debug-extension-dev 0.21.0+16.04.20160330-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 | /*
* Copyright © 2013 Canonical Ltd.
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version 3,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
#ifndef MIR_CLIENT_LIBRARY_DEBUG_H
#define MIR_CLIENT_LIBRARY_DEBUG_H
#include <mir_toolkit/mir_client_library.h>
/* This header defines debug interfaces that aren't expected to be generally useful
* and do not have the same API-stability guarantees that the main API has */
#ifdef __cplusplus
extern "C" {
#endif
/**
* Return the ID of a surface (only useful for debug output).
* \pre The surface is valid
* \param [in] surface The surface
* \return An internal ID that identifies the surface
*/
int mir_debug_surface_id(MirSurface *surface);
/**
* Get the ID of the surface's current buffer (only useful for debug purposes)
* \pre The surface is valid
* \param [in] surface The surface
* \return The internal buffer ID of the surface's current buffer.
* This is the buffer that is currently being drawn to,
* and would be returned by mir_surface_get_current_buffer.
*/
uint32_t mir_debug_surface_current_buffer_id(MirSurface *surface);
/**
* Get the screen coordinates corresponding to a pair of surface coordinates
* \pre The surface is valid
* \param [in] surface The surface
* \param [in] x, y Surface coordinates to map to screen coordinates
* \param [out] screen_x, screen_y The screen coordinates corresponding to x, y.
* \return True if screen_x and screen_y contain values
* \note There are many cases where such a mapping does not exist or would be expensive
* to calculate. Only Mir servers started with the --debug option will ever return
* values for this call, and even when --debug is enabled servers are free to
* return nothing.
*
* This call will only be interesting for automated testing, where both the client
* and shell state is known and constrained.
*/
bool mir_debug_surface_coords_to_screen(MirSurface* surface,
int x, int y,
int* screen_x, int* screen_y);
#ifdef __cplusplus
}
#endif
#endif /* MIR_CLIENT_LIBRARY_DEBUG_H */
|