mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2026-01-23 11:40:29 +01:00
c3f2db4f73
Use the DRM interface to h/w accelerate composition on image surfaces. The purpose of the backend is simply to explore what such a hardware interface might look like and what benefits we might expect. The use case that might justify writing such custom backends are embedded devices running a drm compositor like wayland - which would, for example, allow one to write applications that seamlessly integrated accelerated, dynamic, high quality 2D graphics using Cairo with advanced interaction (e.g. smooth animations in the UI) driven by a clutter framework... In this first step we introduce the fundamental wrapping of GEM for intel and radeon chipsets, and, for comparison, gallium. No acceleration, all we do is use buffer objects (that is use the kernel memory manager) to allocate images and simply use the fallback mechanism. This provides a suitable base to start writing chip specific drivers.
135 lines
4.3 KiB
C
135 lines
4.3 KiB
C
/* Cairo - a vector graphics library with display and print output
|
|
*
|
|
* Copyright © 2009 Chris Wilson
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it either under the terms of the GNU Lesser General Public
|
|
* License version 2.1 as published by the Free Software Foundation
|
|
* (the "LGPL") or, at your option, under the terms of the Mozilla
|
|
* Public License Version 1.1 (the "MPL"). If you do not alter this
|
|
* notice, a recipient may use your version of this file under either
|
|
* the MPL or the LGPL.
|
|
*
|
|
* You should have received a copy of the LGPL along with this library
|
|
* in the file COPYING-LGPL-2.1; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
* You should have received a copy of the MPL along with this library
|
|
* in the file COPYING-MPL-1.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License
|
|
* Version 1.1 (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.mozilla.org/MPL/
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
|
|
* OF ANY KIND, either express or implied. See the LGPL or the MPL for
|
|
* the specific language governing rights and limitations.
|
|
*
|
|
* The Original Code is the cairo graphics library.
|
|
*
|
|
* The Initial Developer of the Original Code is Chris Wilson.
|
|
*/
|
|
|
|
#ifndef CAIRO_DRM_H
|
|
#define CAIRO_DRM_H
|
|
|
|
#include "cairo.h"
|
|
|
|
#if CAIRO_HAS_DRM_SURFACE
|
|
|
|
CAIRO_BEGIN_DECLS
|
|
|
|
typedef struct _cairo_drm_device cairo_drm_device_t;
|
|
|
|
struct udev_device;
|
|
|
|
cairo_public cairo_drm_device_t *
|
|
cairo_drm_device_get (struct udev_device *device);
|
|
|
|
cairo_public cairo_drm_device_t *
|
|
cairo_drm_device_get_for_fd (int fd);
|
|
|
|
cairo_public cairo_drm_device_t *
|
|
cairo_drm_device_default (void);
|
|
|
|
cairo_public cairo_drm_device_t *
|
|
cairo_drm_device_reference (cairo_drm_device_t *device);
|
|
|
|
cairo_public cairo_status_t
|
|
cairo_drm_device_status (cairo_drm_device_t *device);
|
|
|
|
cairo_public int
|
|
cairo_drm_device_get_fd (cairo_drm_device_t *device);
|
|
|
|
cairo_public void
|
|
cairo_drm_device_throttle (cairo_drm_device_t *device);
|
|
|
|
cairo_public void
|
|
cairo_drm_device_destroy (cairo_drm_device_t *device);
|
|
|
|
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_create (cairo_drm_device_t *device,
|
|
cairo_content_t content,
|
|
int width, int height);
|
|
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_create_for_name (cairo_drm_device_t *device,
|
|
unsigned int name,
|
|
cairo_format_t format,
|
|
int width, int height, int stride);
|
|
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_create_from_cacheable_image (cairo_drm_device_t *device,
|
|
cairo_surface_t *surface);
|
|
|
|
cairo_public cairo_status_t
|
|
cairo_drm_surface_enable_scan_out (cairo_surface_t *surface);
|
|
|
|
cairo_public cairo_drm_device_t *
|
|
cairo_drm_surface_get_device (cairo_surface_t *abstract_surface);
|
|
|
|
cairo_public unsigned int
|
|
cairo_drm_surface_get_handle (cairo_surface_t *surface);
|
|
|
|
cairo_public unsigned int
|
|
cairo_drm_surface_get_name (cairo_surface_t *surface);
|
|
|
|
cairo_public cairo_format_t
|
|
cairo_drm_surface_get_format (cairo_surface_t *surface);
|
|
|
|
cairo_public int
|
|
cairo_drm_surface_get_width (cairo_surface_t *surface);
|
|
|
|
cairo_public int
|
|
cairo_drm_surface_get_height (cairo_surface_t *surface);
|
|
|
|
cairo_public int
|
|
cairo_drm_surface_get_stride (cairo_surface_t *surface);
|
|
|
|
/* XXX map/unmap, general surface layer? */
|
|
|
|
/* Rough outline, culled from a conversation on IRC:
|
|
* map() returns an image-surface representation of the drm-surface,
|
|
* which you unmap() when you are finished, i.e. map() pulls the buffer back
|
|
* from the GPU, maps it into the CPU domain and gives you direct access to
|
|
* the pixels. With the unmap(), the buffer is ready to be used again by the
|
|
* GPU and *until* the unmap(), all operations will be done in software.
|
|
*
|
|
* (Technically calling cairo_surface_flush() on the underlying drm-surface
|
|
* will also disassociate the mapping.)
|
|
*/
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_map (cairo_surface_t *surface);
|
|
|
|
cairo_public void
|
|
cairo_drm_surface_unmap (cairo_surface_t *drm_surface,
|
|
cairo_surface_t *image_surface);
|
|
|
|
CAIRO_END_DECLS
|
|
|
|
#else /* CAIRO_HAS_DRM_SURFACE */
|
|
# error Cairo was not compiled with support for the DRM backend
|
|
#endif /* CAIRO_HAS_DRM_SURFACE */
|
|
|
|
#endif /* CAIRO_DRM_H */
|