diff options
author | Daniel Vetter <daniel.vetter@ffwll.ch> | 2014-03-26 09:06:11 +0100 |
---|---|---|
committer | Daniel Vetter <daniel.vetter@ffwll.ch> | 2014-03-26 18:50:27 +0100 |
commit | 57d7db8cf8c407541d1ed57348a6f468c2b73577 (patch) | |
tree | daaf3e01b66f806d350ebe74b2fe23eaa13492d2 /lib/igt_fb.h | |
parent | 0b3019733bce0eb7ec4bce39e4ee470f98639c36 (diff) |
lib: extract igt_fb library
Stuff all the framebuffer creation, cairo and drm fourcc format
handling in there. This gives us a very clear cut in the headers where
igt_fb.c only needs to include igt_fb.h, and igt_kms.c includes both
(well igt_kms.h pulls in igt_fb.h since we always need this).
The aim here is to add api docs for igt_fb since that part of the kms
library seems fairly stable already, while all the mode setting and
iteration is still a bit in flux.
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Diffstat (limited to 'lib/igt_fb.h')
-rw-r--r-- | lib/igt_fb.h | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/lib/igt_fb.h b/lib/igt_fb.h new file mode 100644 index 00000000..efa54989 --- /dev/null +++ b/lib/igt_fb.h @@ -0,0 +1,89 @@ +/* + * Copyright © 2013,2014 Intel Corporation + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice (including the next + * paragraph) shall be included in all copies or substantial portions of the + * Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS + * IN THE SOFTWARE. + * + * Authors: + * Daniel Vetter <daniel.vetter@ffwll.ch> + * Damien Lespiau <damien.lespiau@intel.com> + */ + +#ifndef __IGT_FB_H__ +#define __IGT_FB_H__ + +#include <cairo.h> + +#include <drm_fourcc.h> +#include <xf86drmMode.h> + +/* helpers to create nice-looking framebuffers */ +struct kmstest_fb { + uint32_t fb_id; + uint32_t gem_handle; + uint32_t drm_format; + int width; + int height; + int depth; + unsigned stride; + unsigned tiling; + unsigned size; + cairo_surface_t *cairo_surface; +}; + +enum kmstest_text_align { + align_left, + align_bottom = align_left, + align_right = 0x01, + align_top = 0x02, + align_vcenter = 0x04, + align_hcenter = 0x08, +}; + +int kmstest_cairo_printf_line(cairo_t *cr, enum kmstest_text_align align, + double yspacing, const char *fmt, ...) + __attribute__((format (printf, 4, 5))); + +unsigned int kmstest_create_fb(int fd, int width, int height, uint32_t format, + bool tiled, struct kmstest_fb *fb); +unsigned int kmstest_create_color_fb(int fd, int width, int height, + uint32_t format, bool tiled, + double r, double g, double b, + struct kmstest_fb *fb /* out */); +void kmstest_remove_fb(int fd, struct kmstest_fb *fb_info); +cairo_t *kmstest_get_cairo_ctx(int fd, struct kmstest_fb *fb); +void kmstest_paint_color(cairo_t *cr, int x, int y, int w, int h, + double r, double g, double b); +void kmstest_paint_color_alpha(cairo_t *cr, int x, int y, int w, int h, + double r, double g, double b, double a); +void kmstest_paint_color_gradient(cairo_t *cr, int x, int y, int w, int h, + int r, int g, int b); +void kmstest_paint_test_pattern(cairo_t *cr, int width, int height); +void kmstest_paint_image(cairo_t *cr, const char *filename, + int dst_x, int dst_y, int dst_width, int dst_height); +void kmstest_write_fb(int fd, struct kmstest_fb *fb, const char *filename); + +/* helpers to handle drm fourcc codes */ +uint32_t bpp_depth_to_drm_format(int bpp, int depth); +uint32_t drm_format_to_bpp(uint32_t drm_format); +const char *kmstest_format_str(uint32_t drm_format); +void kmstest_get_all_formats(const uint32_t **formats, int *format_count); + +#endif /* __IGT_FB_H__ */ + |