1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Copyright (C) 2016 Noralf Trønnes
4 */
5
6#ifndef __LINUX_DRM_FORMAT_HELPER_H
7#define __LINUX_DRM_FORMAT_HELPER_H
8
9#include <linux/types.h>
10
11struct drm_device;
12struct drm_format_info;
13struct drm_framebuffer;
14struct drm_rect;
15
16struct iosys_map;
17
18/**
19 * struct drm_format_conv_state - Stores format-conversion state
20 *
21 * DRM helpers for format conversion store temporary state in
22 * struct drm_xfrm_buf. The buffer's resources can be reused
23 * among multiple conversion operations.
24 *
25 * All fields are considered private.
26 */
27struct drm_format_conv_state {
28 struct {
29 void *mem;
30 size_t size;
31 bool preallocated;
32 } tmp;
33};
34
35#define __DRM_FORMAT_CONV_STATE_INIT(_mem, _size, _preallocated) { \
36 .tmp = { \
37 .mem = (_mem), \
38 .size = (_size), \
39 .preallocated = (_preallocated), \
40 } \
41 }
42
43/**
44 * DRM_FORMAT_CONV_STATE_INIT - Initializer for struct drm_format_conv_state
45 *
46 * Initializes an instance of struct drm_format_conv_state to default values.
47 */
48#define DRM_FORMAT_CONV_STATE_INIT \
49 __DRM_FORMAT_CONV_STATE_INIT(NULL, 0, false)
50
51/**
52 * DRM_FORMAT_CONV_STATE_INIT_PREALLOCATED - Initializer for struct drm_format_conv_state
53 * @_mem: The preallocated memory area
54 * @_size: The number of bytes in _mem
55 *
56 * Initializes an instance of struct drm_format_conv_state to preallocated
57 * storage. The caller is responsible for releasing the provided memory range.
58 */
59#define DRM_FORMAT_CONV_STATE_INIT_PREALLOCATED(_mem, _size) \
60 __DRM_FORMAT_CONV_STATE_INIT(_mem, _size, true)
61
62void drm_format_conv_state_init(struct drm_format_conv_state *state);
63void drm_format_conv_state_copy(struct drm_format_conv_state *state,
64 const struct drm_format_conv_state *old_state);
65void *drm_format_conv_state_reserve(struct drm_format_conv_state *state,
66 size_t new_size, gfp_t flags);
67void drm_format_conv_state_release(struct drm_format_conv_state *state);
68
69unsigned int drm_fb_clip_offset(unsigned int pitch, const struct drm_format_info *format,
70 const struct drm_rect *clip);
71
72void drm_fb_memcpy(struct iosys_map *dst, const unsigned int *dst_pitch,
73 const struct iosys_map *src, const struct drm_framebuffer *fb,
74 const struct drm_rect *clip);
75void drm_fb_swab(struct iosys_map *dst, const unsigned int *dst_pitch,
76 const struct iosys_map *src, const struct drm_framebuffer *fb,
77 const struct drm_rect *clip, bool cached,
78 struct drm_format_conv_state *state);
79void drm_fb_xrgb8888_to_rgb332(struct iosys_map *dst, const unsigned int *dst_pitch,
80 const struct iosys_map *src, const struct drm_framebuffer *fb,
81 const struct drm_rect *clip, struct drm_format_conv_state *state);
82void drm_fb_xrgb8888_to_rgb565(struct iosys_map *dst, const unsigned int *dst_pitch,
83 const struct iosys_map *src, const struct drm_framebuffer *fb,
84 const struct drm_rect *clip, struct drm_format_conv_state *state,
85 bool swab);
86void drm_fb_xrgb8888_to_xrgb1555(struct iosys_map *dst, const unsigned int *dst_pitch,
87 const struct iosys_map *src, const struct drm_framebuffer *fb,
88 const struct drm_rect *clip, struct drm_format_conv_state *state);
89void drm_fb_xrgb8888_to_argb1555(struct iosys_map *dst, const unsigned int *dst_pitch,
90 const struct iosys_map *src, const struct drm_framebuffer *fb,
91 const struct drm_rect *clip, struct drm_format_conv_state *state);
92void drm_fb_xrgb8888_to_rgba5551(struct iosys_map *dst, const unsigned int *dst_pitch,
93 const struct iosys_map *src, const struct drm_framebuffer *fb,
94 const struct drm_rect *clip, struct drm_format_conv_state *state);
95void drm_fb_xrgb8888_to_rgb888(struct iosys_map *dst, const unsigned int *dst_pitch,
96 const struct iosys_map *src, const struct drm_framebuffer *fb,
97 const struct drm_rect *clip, struct drm_format_conv_state *state);
98void drm_fb_xrgb8888_to_argb8888(struct iosys_map *dst, const unsigned int *dst_pitch,
99 const struct iosys_map *src, const struct drm_framebuffer *fb,
100 const struct drm_rect *clip, struct drm_format_conv_state *state);
101void drm_fb_xrgb8888_to_xrgb2101010(struct iosys_map *dst, const unsigned int *dst_pitch,
102 const struct iosys_map *src, const struct drm_framebuffer *fb,
103 const struct drm_rect *clip,
104 struct drm_format_conv_state *state);
105void drm_fb_xrgb8888_to_argb2101010(struct iosys_map *dst, const unsigned int *dst_pitch,
106 const struct iosys_map *src, const struct drm_framebuffer *fb,
107 const struct drm_rect *clip,
108 struct drm_format_conv_state *state);
109void drm_fb_xrgb8888_to_gray8(struct iosys_map *dst, const unsigned int *dst_pitch,
110 const struct iosys_map *src, const struct drm_framebuffer *fb,
111 const struct drm_rect *clip, struct drm_format_conv_state *state);
112
113int drm_fb_blit(struct iosys_map *dst, const unsigned int *dst_pitch, uint32_t dst_format,
114 const struct iosys_map *src, const struct drm_framebuffer *fb,
115 const struct drm_rect *clip, struct drm_format_conv_state *state);
116
117void drm_fb_xrgb8888_to_mono(struct iosys_map *dst, const unsigned int *dst_pitch,
118 const struct iosys_map *src, const struct drm_framebuffer *fb,
119 const struct drm_rect *clip, struct drm_format_conv_state *state);
120
121size_t drm_fb_build_fourcc_list(struct drm_device *dev,
122 const u32 *native_fourccs, size_t native_nfourccs,
123 u32 *fourccs_out, size_t nfourccs_out);
124
125#endif /* __LINUX_DRM_FORMAT_HELPER_H */
126

source code of linux/include/drm/drm_format_helper.h