drm_format_helper.h

  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	/* private: */
 29	struct {
 30		void *mem;
 31		size_t size;
 32		bool preallocated;
 33	} tmp;
 34};
 35
 36#define __DRM_FORMAT_CONV_STATE_INIT(_mem, _size, _preallocated) { \
 37		.tmp = { \
 38			.mem = (_mem), \
 39			.size = (_size), \
 40			.preallocated = (_preallocated), \
 41		} \
 42	}
 43
 44/**
 45 * DRM_FORMAT_CONV_STATE_INIT - Initializer for struct drm_format_conv_state
 46 *
 47 * Initializes an instance of struct drm_format_conv_state to default values.
 48 */
 49#define DRM_FORMAT_CONV_STATE_INIT \
 50	__DRM_FORMAT_CONV_STATE_INIT(NULL, 0, false)
 51
 52/**
 53 * DRM_FORMAT_CONV_STATE_INIT_PREALLOCATED - Initializer for struct drm_format_conv_state
 54 * @_mem: The preallocated memory area
 55 * @_size: The number of bytes in _mem
 56 *
 57 * Initializes an instance of struct drm_format_conv_state to preallocated
 58 * storage. The caller is responsible for releasing the provided memory range.
 59 */
 60#define DRM_FORMAT_CONV_STATE_INIT_PREALLOCATED(_mem, _size) \
 61	__DRM_FORMAT_CONV_STATE_INIT(_mem, _size, true)
 62
 63void drm_format_conv_state_init(struct drm_format_conv_state *state);
 64void drm_format_conv_state_copy(struct drm_format_conv_state *state,
 65				const struct drm_format_conv_state *old_state);
 66void *drm_format_conv_state_reserve(struct drm_format_conv_state *state,
 67				    size_t new_size, gfp_t flags);
 68void drm_format_conv_state_release(struct drm_format_conv_state *state);
 69
 70unsigned int drm_fb_clip_offset(unsigned int pitch, const struct drm_format_info *format,
 71				const struct drm_rect *clip);
 72
 73void drm_fb_memcpy(struct iosys_map *dst, const unsigned int *dst_pitch,
 74		   const struct iosys_map *src, const struct drm_framebuffer *fb,
 75		   const struct drm_rect *clip);
 76void drm_fb_swab(struct iosys_map *dst, const unsigned int *dst_pitch,
 77		 const struct iosys_map *src, const struct drm_framebuffer *fb,
 78		 const struct drm_rect *clip, bool cached,
 79		 struct drm_format_conv_state *state);
 80void drm_fb_xrgb8888_to_rgb332(struct iosys_map *dst, const unsigned int *dst_pitch,
 81			       const struct iosys_map *src, const struct drm_framebuffer *fb,
 82			       const struct drm_rect *clip, struct drm_format_conv_state *state);
 83void drm_fb_xrgb8888_to_rgb565(struct iosys_map *dst, const unsigned int *dst_pitch,
 84			       const struct iosys_map *src, const struct drm_framebuffer *fb,
 85			       const struct drm_rect *clip, struct drm_format_conv_state *state);
 86void drm_fb_xrgb8888_to_rgb565be(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_xrgb1555(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_argb1555(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_rgba5551(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_rgb888(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_bgr888(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, struct drm_format_conv_state *state);
104void drm_fb_xrgb8888_to_argb8888(struct iosys_map *dst, const unsigned int *dst_pitch,
105				 const struct iosys_map *src, const struct drm_framebuffer *fb,
106				 const struct drm_rect *clip, struct drm_format_conv_state *state);
107void drm_fb_xrgb8888_to_abgr8888(struct iosys_map *dst, const unsigned int *dst_pitch,
108				 const struct iosys_map *src, const struct drm_framebuffer *fb,
109				 const struct drm_rect *clip, struct drm_format_conv_state *state);
110void drm_fb_xrgb8888_to_xbgr8888(struct iosys_map *dst, const unsigned int *dst_pitch,
111				 const struct iosys_map *src, const struct drm_framebuffer *fb,
112				 const struct drm_rect *clip, struct drm_format_conv_state *state);
113void drm_fb_xrgb8888_to_bgrx8888(struct iosys_map *dst, const unsigned int *dst_pitch,
114				 const struct iosys_map *src, const struct drm_framebuffer *fb,
115				 const struct drm_rect *clip, struct drm_format_conv_state *state);
116void drm_fb_xrgb8888_to_xrgb2101010(struct iosys_map *dst, const unsigned int *dst_pitch,
117				    const struct iosys_map *src, const struct drm_framebuffer *fb,
118				    const struct drm_rect *clip,
119				    struct drm_format_conv_state *state);
120void drm_fb_xrgb8888_to_argb2101010(struct iosys_map *dst, const unsigned int *dst_pitch,
121				    const struct iosys_map *src, const struct drm_framebuffer *fb,
122				    const struct drm_rect *clip,
123				    struct drm_format_conv_state *state);
124void drm_fb_xrgb8888_to_gray8(struct iosys_map *dst, const unsigned int *dst_pitch,
125			      const struct iosys_map *src, const struct drm_framebuffer *fb,
126			      const struct drm_rect *clip, struct drm_format_conv_state *state);
127void drm_fb_argb8888_to_argb4444(struct iosys_map *dst, const unsigned int *dst_pitch,
128				 const struct iosys_map *src, const struct drm_framebuffer *fb,
129				 const struct drm_rect *clip, struct drm_format_conv_state *state);
130
131void drm_fb_xrgb8888_to_mono(struct iosys_map *dst, const unsigned int *dst_pitch,
132			     const struct iosys_map *src, const struct drm_framebuffer *fb,
133			     const struct drm_rect *clip, struct drm_format_conv_state *state);
134
135void drm_fb_xrgb8888_to_gray2(struct iosys_map *dst, const unsigned int *dst_pitch,
136			      const struct iosys_map *src, const struct drm_framebuffer *fb,
137			      const struct drm_rect *clip, struct drm_format_conv_state *state);
138
139#endif /* __LINUX_DRM_FORMAT_HELPER_H */