1/* SPDX-License-Identifier: MIT */
2/*
3 * Copyright © 2019 Intel Corporation
4 */
5
6#ifndef __INTEL_PLANE_H__
7#define __INTEL_PLANE_H__
8
9#include <linux/types.h>
10
11struct drm_plane;
12struct drm_property;
13struct drm_rect;
14struct intel_atomic_state;
15struct intel_crtc;
16struct intel_crtc_state;
17struct intel_dsb;
18struct intel_plane;
19struct intel_plane_state;
20enum plane_id;
21
22struct intel_plane *
23intel_crtc_get_plane(struct intel_crtc *crtc, enum plane_id plane_id);
24bool intel_plane_can_async_flip(struct intel_plane *plane, u32 format,
25 u64 modifier);
26unsigned int intel_adjusted_rate(const struct drm_rect *src,
27 const struct drm_rect *dst,
28 unsigned int rate);
29unsigned int intel_plane_pixel_rate(const struct intel_crtc_state *crtc_state,
30 const struct intel_plane_state *plane_state);
31
32unsigned int intel_plane_data_rate(const struct intel_crtc_state *crtc_state,
33 const struct intel_plane_state *plane_state,
34 int color_plane);
35void intel_plane_copy_uapi_to_hw_state(struct intel_plane_state *plane_state,
36 const struct intel_plane_state *from_plane_state,
37 struct intel_crtc *crtc);
38void intel_plane_copy_hw_state(struct intel_plane_state *plane_state,
39 const struct intel_plane_state *from_plane_state);
40void intel_plane_async_flip(struct intel_dsb *dsb,
41 struct intel_plane *plane,
42 const struct intel_crtc_state *crtc_state,
43 const struct intel_plane_state *plane_state,
44 bool async_flip);
45void intel_plane_update_noarm(struct intel_dsb *dsb,
46 struct intel_plane *plane,
47 const struct intel_crtc_state *crtc_state,
48 const struct intel_plane_state *plane_state);
49void intel_plane_update_arm(struct intel_dsb *dsb,
50 struct intel_plane *plane,
51 const struct intel_crtc_state *crtc_state,
52 const struct intel_plane_state *plane_state);
53void intel_plane_disable_arm(struct intel_dsb *dsb,
54 struct intel_plane *plane,
55 const struct intel_crtc_state *crtc_state);
56struct intel_plane *intel_plane_alloc(void);
57void intel_plane_free(struct intel_plane *plane);
58void intel_plane_destroy(struct drm_plane *plane);
59struct drm_plane_state *intel_plane_duplicate_state(struct drm_plane *plane);
60void intel_plane_destroy_state(struct drm_plane *plane,
61 struct drm_plane_state *state);
62void intel_crtc_planes_update_noarm(struct intel_dsb *dsb,
63 struct intel_atomic_state *state,
64 struct intel_crtc *crtc);
65void intel_crtc_planes_update_arm(struct intel_dsb *dsbx,
66 struct intel_atomic_state *state,
67 struct intel_crtc *crtc);
68int intel_plane_atomic_check_with_state(const struct intel_crtc_state *old_crtc_state,
69 struct intel_crtc_state *crtc_state,
70 const struct intel_plane_state *old_plane_state,
71 struct intel_plane_state *intel_state);
72int intel_plane_calc_min_cdclk(struct intel_atomic_state *state,
73 struct intel_plane *plane,
74 bool *need_cdclk_calc);
75int intel_plane_check_clipping(struct intel_plane_state *plane_state,
76 struct intel_crtc_state *crtc_state,
77 int min_scale, int max_scale,
78 bool can_position);
79int intel_plane_check_src_coordinates(struct intel_plane_state *plane_state);
80void intel_plane_set_invisible(struct intel_crtc_state *crtc_state,
81 struct intel_plane_state *plane_state);
82void intel_plane_helper_add(struct intel_plane *plane);
83bool intel_plane_needs_physical(struct intel_plane *plane);
84void intel_plane_init_cursor_vblank_work(struct intel_plane_state *old_plane_state,
85 struct intel_plane_state *new_plane_state);
86int intel_plane_add_affected(struct intel_atomic_state *state,
87 struct intel_crtc *crtc);
88int intel_plane_atomic_check(struct intel_atomic_state *state);
89
90bool intel_plane_format_mod_supported_async(struct drm_plane *plane,
91 u32 format,
92 u64 modifier);
93
94#endif /* __INTEL_PLANE_H__ */
95