2 * Copyright (C) 2014 Red Hat
3 * Copyright (C) 2014 Intel Corp.
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
19 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
20 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
21 * OTHER DEALINGS IN THE SOFTWARE.
24 * Rob Clark <robdclark@gmail.com>
25 * Daniel Vetter <daniel.vetter@ffwll.ch>
31 #include <drm/drm_crtc.h>
33 struct drm_atomic_state
* __must_check
34 drm_atomic_state_alloc(struct drm_device
*dev
);
35 void drm_atomic_state_clear(struct drm_atomic_state
*state
);
36 void drm_atomic_state_free(struct drm_atomic_state
*state
);
39 drm_atomic_state_init(struct drm_device
*dev
, struct drm_atomic_state
*state
);
40 void drm_atomic_state_default_clear(struct drm_atomic_state
*state
);
41 void drm_atomic_state_default_release(struct drm_atomic_state
*state
);
43 struct drm_crtc_state
* __must_check
44 drm_atomic_get_crtc_state(struct drm_atomic_state
*state
,
45 struct drm_crtc
*crtc
);
46 int drm_atomic_crtc_set_property(struct drm_crtc
*crtc
,
47 struct drm_crtc_state
*state
, struct drm_property
*property
,
49 struct drm_plane_state
* __must_check
50 drm_atomic_get_plane_state(struct drm_atomic_state
*state
,
51 struct drm_plane
*plane
);
52 int drm_atomic_plane_set_property(struct drm_plane
*plane
,
53 struct drm_plane_state
*state
, struct drm_property
*property
,
55 struct drm_connector_state
* __must_check
56 drm_atomic_get_connector_state(struct drm_atomic_state
*state
,
57 struct drm_connector
*connector
);
58 int drm_atomic_connector_set_property(struct drm_connector
*connector
,
59 struct drm_connector_state
*state
, struct drm_property
*property
,
63 * drm_atomic_get_existing_crtc_state - get crtc state, if it exists
64 * @state: global atomic state object
67 * This function returns the crtc state for the given crtc, or NULL
68 * if the crtc is not part of the global atomic state.
70 static inline struct drm_crtc_state
*
71 drm_atomic_get_existing_crtc_state(struct drm_atomic_state
*state
,
72 struct drm_crtc
*crtc
)
74 return state
->crtcs
[drm_crtc_index(crtc
)].state
;
78 * drm_atomic_get_existing_plane_state - get plane state, if it exists
79 * @state: global atomic state object
80 * @plane: plane to grab
82 * This function returns the plane state for the given plane, or NULL
83 * if the plane is not part of the global atomic state.
85 static inline struct drm_plane_state
*
86 drm_atomic_get_existing_plane_state(struct drm_atomic_state
*state
,
87 struct drm_plane
*plane
)
89 return state
->planes
[drm_plane_index(plane
)].state
;
93 * drm_atomic_get_existing_connector_state - get connector state, if it exists
94 * @state: global atomic state object
95 * @connector: connector to grab
97 * This function returns the connector state for the given connector,
98 * or NULL if the connector is not part of the global atomic state.
100 static inline struct drm_connector_state
*
101 drm_atomic_get_existing_connector_state(struct drm_atomic_state
*state
,
102 struct drm_connector
*connector
)
104 int index
= drm_connector_index(connector
);
106 if (index
>= state
->num_connector
)
109 return state
->connectors
[index
].state
;
113 * __drm_atomic_get_current_plane_state - get current plane state
114 * @state: global atomic state object
115 * @plane: plane to grab
117 * This function returns the plane state for the given plane, either from
118 * @state, or if the plane isn't part of the atomic state update, from @plane.
119 * This is useful in atomic check callbacks, when drivers need to peek at, but
120 * not change, state of other planes, since it avoids threading an error code
121 * back up the call chain.
125 * Note that this function is in general unsafe since it doesn't check for the
126 * required locking for access state structures. Drivers must ensure that it is
127 * save to access the returned state structure through other means. One commone
128 * example is when planes are fixed to a single CRTC, and the driver knows that
129 * the CRTC locks is held already. In that case holding the CRTC locks gives a
130 * read-lock on all planes connected to that CRTC. But if planes can be
131 * reassigned things get more tricky. In that case it's better to use
132 * drm_atomic_get_plane_state and wire up full error handling.
136 * Read-only pointer to the current plane state.
138 static inline const struct drm_plane_state
*
139 __drm_atomic_get_current_plane_state(struct drm_atomic_state
*state
,
140 struct drm_plane
*plane
)
142 if (state
->planes
[drm_plane_index(plane
)].state
)
143 return state
->planes
[drm_plane_index(plane
)].state
;
149 drm_atomic_set_mode_for_crtc(struct drm_crtc_state
*state
,
150 struct drm_display_mode
*mode
);
152 drm_atomic_set_mode_prop_for_crtc(struct drm_crtc_state
*state
,
153 struct drm_property_blob
*blob
);
155 drm_atomic_set_crtc_for_plane(struct drm_plane_state
*plane_state
,
156 struct drm_crtc
*crtc
);
157 void drm_atomic_set_fb_for_plane(struct drm_plane_state
*plane_state
,
158 struct drm_framebuffer
*fb
);
160 drm_atomic_set_crtc_for_connector(struct drm_connector_state
*conn_state
,
161 struct drm_crtc
*crtc
);
163 drm_atomic_add_affected_connectors(struct drm_atomic_state
*state
,
164 struct drm_crtc
*crtc
);
166 drm_atomic_add_affected_planes(struct drm_atomic_state
*state
,
167 struct drm_crtc
*crtc
);
169 void drm_atomic_legacy_backoff(struct drm_atomic_state
*state
);
172 drm_atomic_clean_old_fb(struct drm_device
*dev
, unsigned plane_mask
, int ret
);
174 int __must_check
drm_atomic_check_only(struct drm_atomic_state
*state
);
175 int __must_check
drm_atomic_commit(struct drm_atomic_state
*state
);
176 int __must_check
drm_atomic_nonblocking_commit(struct drm_atomic_state
*state
);
178 #define for_each_connector_in_state(__state, connector, connector_state, __i) \
180 (__i) < (__state)->num_connector && \
181 ((connector) = (__state)->connectors[__i].ptr, \
182 (connector_state) = (__state)->connectors[__i].state, 1); \
184 for_each_if (connector)
186 #define for_each_crtc_in_state(__state, crtc, crtc_state, __i) \
188 (__i) < (__state)->dev->mode_config.num_crtc && \
189 ((crtc) = (__state)->crtcs[__i].ptr, \
190 (crtc_state) = (__state)->crtcs[__i].state, 1); \
192 for_each_if (crtc_state)
194 #define for_each_plane_in_state(__state, plane, plane_state, __i) \
196 (__i) < (__state)->dev->mode_config.num_total_plane && \
197 ((plane) = (__state)->planes[__i].ptr, \
198 (plane_state) = (__state)->planes[__i].state, 1); \
200 for_each_if (plane_state)
202 drm_atomic_crtc_needs_modeset(struct drm_crtc_state
*state
)
204 return state
->mode_changed
|| state
->active_changed
||
205 state
->connectors_changed
;
209 #endif /* DRM_ATOMIC_H_ */
This page took 0.04476 seconds and 6 git commands to generate.