mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2026-05-24 22:58:11 +02:00
77afe8491e
As proof-of-principle add the nearly working demonstrations of using DRM to render directly with the GPU bypassing both RENDER and GL for performance whilst preserving high quality rendering. The basis behind developing these chip specific backends is that this is the idealised interface that we desire for this chips, and so a target for cairo-gl as we continue to develop both it and our GL stack. Note that this backends do not yet fully pass the test suite, so only use if you are brave and willing to help develop them further.
120 lines
3.9 KiB
C
120 lines
3.9 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
|
|
|
|
struct udev_device;
|
|
|
|
cairo_public cairo_device_t *
|
|
cairo_drm_device_get (struct udev_device *device);
|
|
|
|
cairo_public cairo_device_t *
|
|
cairo_drm_device_get_for_fd (int fd);
|
|
|
|
cairo_public cairo_device_t *
|
|
cairo_drm_device_default (void);
|
|
|
|
cairo_public int
|
|
cairo_drm_device_get_fd (cairo_device_t *device);
|
|
|
|
cairo_public void
|
|
cairo_drm_device_throttle (cairo_device_t *device);
|
|
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_create (cairo_device_t *device,
|
|
cairo_content_t content,
|
|
int width, int height);
|
|
|
|
cairo_public cairo_surface_t *
|
|
cairo_drm_surface_create_for_name (cairo_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_device_t *device,
|
|
cairo_surface_t *surface);
|
|
|
|
cairo_public cairo_status_t
|
|
cairo_drm_surface_enable_scan_out (cairo_surface_t *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 */
|