output: don't call output_get_dpms in case of commit-per-vblank disabled
[platform/core/uifw/libtdm.git] / src / tdm_output.c
1 /**************************************************************************
2  *
3  * libtdm
4  *
5  * Copyright 2015 Samsung Electronics co., Ltd. All Rights Reserved.
6  *
7  * Contact: Eunchul Kim <chulspro.kim@samsung.com>,
8  *          JinYoung Jeon <jy0.jeon@samsung.com>,
9  *          Taeheon Kim <th908.kim@samsung.com>,
10  *          YoungJun Cho <yj44.cho@samsung.com>,
11  *          SooChan Lim <sc1.lim@samsung.com>,
12  *          Boram Park <sc1.lim@samsung.com>
13  *
14  * Permission is hereby granted, free of charge, to any person obtaining a
15  * copy of this software and associated documentation files (the
16  * "Software"), to deal in the Software without restriction, including
17  * without limitation the rights to use, copy, modify, merge, publish,
18  * distribute, sub license, and/or sell copies of the Software, and to
19  * permit persons to whom the Software is furnished to do so, subject to
20  * the following conditions:
21  *
22  * The above copyright notice and this permission notice (including the
23  * next paragraph) shall be included in all copies or substantial portions
24  * of the Software.
25  *
26  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
27  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
28  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
29  * IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
30  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
31  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
32  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
33  *
34 **************************************************************************/
35
36 #ifdef HAVE_CONFIG_H
37 #include "config.h"
38 #endif
39
40 #include "tdm.h"
41 #include "tdm_backend.h"
42 #include "tdm_private.h"
43 #include "tdm_helper.h"
44
45 #define COUNT_MAX   10
46
47 #define OUTPUT_FUNC_ENTRY() \
48         tdm_private_display *private_display; \
49         tdm_private_output *private_output; \
50         tdm_error ret = TDM_ERROR_NONE; /* default TDM_ERROR_NONE */\
51         TDM_RETURN_VAL_IF_FAIL(output != NULL, TDM_ERROR_INVALID_PARAMETER); \
52         private_output = (tdm_private_output*)output; \
53         private_display = private_output->private_display
54
55 #define OUTPUT_FUNC_ENTRY_ERROR() \
56         tdm_private_display *private_display; \
57         tdm_private_output *private_output; \
58         tdm_error ret = TDM_ERROR_NONE; /* default TDM_ERROR_NONE */\
59         TDM_RETURN_VAL_IF_FAIL_WITH_ERROR(output != NULL, TDM_ERROR_INVALID_PARAMETER, NULL); \
60         private_output = (tdm_private_output*)output; \
61         private_display = private_output->private_display
62
63 EXTERN tdm_error
64 tdm_output_get_model_info(tdm_output *output, const char **maker,
65                                                   const char **model, const char **name)
66 {
67         OUTPUT_FUNC_ENTRY();
68
69         _pthread_mutex_lock(&private_display->lock);
70
71         if (maker)
72                 *maker = private_output->caps.maker;
73         if (model)
74                 *model = private_output->caps.model;
75         if (name)
76                 *name = private_output->caps.name;
77
78         _pthread_mutex_unlock(&private_display->lock);
79
80         return ret;
81 }
82
83 EXTERN tdm_error
84 tdm_output_get_capabilities(tdm_output *output, tdm_output_capability *capabilities)
85 {
86         OUTPUT_FUNC_ENTRY();
87
88         TDM_RETURN_VAL_IF_FAIL(capabilities != NULL, TDM_ERROR_INVALID_PARAMETER);
89
90         _pthread_mutex_lock(&private_display->lock);
91
92         *capabilities = private_output->caps.capabilities;
93
94         _pthread_mutex_unlock(&private_display->lock);
95
96         return ret;
97 }
98
99 EXTERN tdm_error
100 tdm_output_get_conn_status(tdm_output *output, tdm_output_conn_status *status)
101 {
102         OUTPUT_FUNC_ENTRY();
103
104         TDM_RETURN_VAL_IF_FAIL(status != NULL, TDM_ERROR_INVALID_PARAMETER);
105
106         _pthread_mutex_lock(&private_display->lock);
107
108         *status = private_output->caps.status;
109
110         _pthread_mutex_unlock(&private_display->lock);
111
112         return ret;
113 }
114
115 static void
116 _tdm_output_update(tdm_output *output_backend, void *user_data)
117 {
118         tdm_private_display *private_display;
119         tdm_private_output *private_output = user_data;
120         tdm_error ret;
121
122         TDM_RETURN_IF_FAIL(private_output);
123
124         private_display = private_output->private_display;
125
126         ret = tdm_display_update_output(private_display, output_backend, private_output->pipe);
127         TDM_RETURN_IF_FAIL(ret == TDM_ERROR_NONE);
128 }
129
130 INTERN void
131 tdm_output_cb_status(tdm_output *output_backend, tdm_output_conn_status status,
132                                          void *user_data)
133 {
134         tdm_private_display *private_display;
135         tdm_private_output *private_output = user_data;
136         tdm_value value;
137
138         TDM_RETURN_IF_FAIL(TDM_MUTEX_IS_LOCKED());
139         TDM_RETURN_IF_FAIL(private_output);
140
141         private_display = private_output->private_display;
142
143         if (!tdm_thread_in_display_thread(syscall(SYS_gettid))) {
144                 tdm_thread_cb_output_status output_status;
145                 tdm_error ret;
146
147                 TDM_INFO("output(%d) %s", private_output->pipe, tdm_status_str(status));
148
149                 _tdm_output_update(output_backend, user_data);
150
151                 output_status.base.type = TDM_THREAD_CB_OUTPUT_STATUS;
152                 output_status.base.length = sizeof output_status;
153                 output_status.output_stamp = private_output->stamp;
154                 output_status.status = status;
155                 output_status.user_data = user_data;
156
157                 value.u32 = status;
158                 tdm_output_call_change_handler_internal(private_output,
159                                                                                                 &private_output->change_handler_list_sub,
160                                                                                                 TDM_OUTPUT_CHANGE_CONNECTION,
161                                                                                                 value, 0);
162
163                 ret = tdm_thread_send_cb(private_display->private_loop, &output_status.base);
164                 TDM_WARNING_IF_FAIL(ret == TDM_ERROR_NONE);
165
166                 return;
167         }
168
169         TDM_INFO("output(%d) %s", private_output->pipe, tdm_status_str(status));
170
171         if (!tdm_thread_is_running())
172                 _tdm_output_update(output_backend, user_data);
173
174         value.u32 = status;
175         tdm_output_call_change_handler_internal(private_output,
176                                                                                         &private_output->change_handler_list_main,
177                                                                                         TDM_OUTPUT_CHANGE_CONNECTION,
178                                                                                         value, 0);
179 }
180
181 EXTERN tdm_error
182 tdm_output_add_change_handler(tdm_output *output,
183                                                           tdm_output_change_handler func,
184                                                           void *user_data)
185 {
186         tdm_private_change_handler *change_handler;
187         OUTPUT_FUNC_ENTRY();
188
189         TDM_RETURN_VAL_IF_FAIL(func != NULL, TDM_ERROR_INVALID_PARAMETER);
190
191         pthread_mutex_lock(&private_display->lock);
192
193         change_handler = calloc(1, sizeof(tdm_private_change_handler));
194         if (!change_handler) {
195                 TDM_ERR("failed: alloc memory");
196                 _pthread_mutex_unlock(&private_display->lock);
197                 return TDM_ERROR_OUT_OF_MEMORY;
198         }
199
200         change_handler->private_output = private_output;
201         change_handler->func = func;
202         change_handler->user_data = user_data;
203         change_handler->owner_tid = syscall(SYS_gettid);
204
205         if (!tdm_thread_in_display_thread(change_handler->owner_tid))
206                 LIST_ADDTAIL(&change_handler->link, &private_output->change_handler_list_sub);
207         else
208                 LIST_ADDTAIL(&change_handler->link, &private_output->change_handler_list_main);
209
210         _pthread_mutex_unlock(&private_display->lock);
211
212         return ret;
213 }
214
215 EXTERN void
216 tdm_output_remove_change_handler(tdm_output *output,
217                                                                  tdm_output_change_handler func,
218                                                                  void *user_data)
219 {
220         tdm_private_display *private_display;
221         tdm_private_output *private_output;
222         tdm_private_change_handler *h = NULL, *hh = NULL;
223
224         TDM_RETURN_IF_FAIL(output != NULL);
225         TDM_RETURN_IF_FAIL(func != NULL);
226
227         private_output = (tdm_private_output*)output;
228         private_display = private_output->private_display;
229
230         _pthread_mutex_lock(&private_display->lock);
231
232         LIST_FOR_EACH_ENTRY_SAFE(h, hh, &private_output->change_handler_list_main, link) {
233                 if (h->func != func || h->user_data != user_data)
234                         continue;
235
236                 LIST_DEL(&h->link);
237                 free(h);
238
239                 _pthread_mutex_unlock(&private_display->lock);
240
241                 return;
242         }
243
244         LIST_FOR_EACH_ENTRY_SAFE(h, hh, &private_output->change_handler_list_sub, link) {
245                 if (h->func != func || h->user_data != user_data)
246                         continue;
247
248                 LIST_DEL(&h->link);
249                 free(h);
250
251                 _pthread_mutex_unlock(&private_display->lock);
252
253                 return;
254         }
255
256         _pthread_mutex_unlock(&private_display->lock);
257 }
258
259 EXTERN tdm_error
260 tdm_output_get_output_type(tdm_output *output, tdm_output_type *type)
261 {
262         OUTPUT_FUNC_ENTRY();
263
264         TDM_RETURN_VAL_IF_FAIL(type != NULL, TDM_ERROR_INVALID_PARAMETER);
265
266         _pthread_mutex_lock(&private_display->lock);
267
268         *type = private_output->caps.type;
269
270         _pthread_mutex_unlock(&private_display->lock);
271
272         return ret;
273 }
274
275 EXTERN tdm_error
276 tdm_output_get_layer_count(tdm_output *output, int *count)
277 {
278         tdm_private_layer *private_layer = NULL;
279
280         OUTPUT_FUNC_ENTRY();
281
282         TDM_RETURN_VAL_IF_FAIL(count != NULL, TDM_ERROR_INVALID_PARAMETER);
283
284         _pthread_mutex_lock(&private_display->lock);
285
286         *count = 0;
287         LIST_FOR_EACH_ENTRY(private_layer, &private_output->layer_list, link)
288         (*count)++;
289         if (*count == 0) {
290                 _pthread_mutex_unlock(&private_display->lock);
291                 return TDM_ERROR_NONE;
292         }
293
294         _pthread_mutex_unlock(&private_display->lock);
295
296         return ret;
297 }
298
299
300 EXTERN tdm_layer *
301 tdm_output_get_layer(tdm_output *output, int index, tdm_error *error)
302 {
303         tdm_private_layer *private_layer = NULL;
304
305         OUTPUT_FUNC_ENTRY_ERROR();
306
307         _pthread_mutex_lock(&private_display->lock);
308
309         if (error)
310                 *error = TDM_ERROR_NONE;
311
312         LIST_FOR_EACH_ENTRY(private_layer, &private_output->layer_list, link) {
313                 if (private_layer->index == index) {
314                         _pthread_mutex_unlock(&private_display->lock);
315                         return private_layer;
316                 }
317         }
318
319         _pthread_mutex_unlock(&private_display->lock);
320
321         return NULL;
322 }
323
324 EXTERN tdm_error
325 tdm_output_get_available_properties(tdm_output *output, const tdm_prop **props,
326                                                                         int *count)
327 {
328         OUTPUT_FUNC_ENTRY();
329
330         TDM_RETURN_VAL_IF_FAIL(props != NULL, TDM_ERROR_INVALID_PARAMETER);
331         TDM_RETURN_VAL_IF_FAIL(count != NULL, TDM_ERROR_INVALID_PARAMETER);
332
333         _pthread_mutex_lock(&private_display->lock);
334
335         *props = (const tdm_prop *)private_output->caps.props;
336         *count = private_output->caps.prop_count;
337
338         _pthread_mutex_unlock(&private_display->lock);
339
340         return ret;
341 }
342
343 EXTERN tdm_error
344 tdm_output_get_available_modes(tdm_output *output,
345                                                            const tdm_output_mode **modes, int *count)
346 {
347         OUTPUT_FUNC_ENTRY();
348
349         TDM_RETURN_VAL_IF_FAIL(modes != NULL, TDM_ERROR_INVALID_PARAMETER);
350         TDM_RETURN_VAL_IF_FAIL(count != NULL, TDM_ERROR_INVALID_PARAMETER);
351
352         _pthread_mutex_lock(&private_display->lock);
353
354         *modes = (const tdm_output_mode *)private_output->caps.modes;
355         *count = private_output->caps.mode_count;
356
357         _pthread_mutex_unlock(&private_display->lock);
358
359         return ret;
360 }
361
362 EXTERN tdm_error
363 tdm_output_get_available_size(tdm_output *output, int *min_w, int *min_h,
364                                                           int *max_w, int *max_h, int *preferred_align)
365 {
366         OUTPUT_FUNC_ENTRY();
367
368         _pthread_mutex_lock(&private_display->lock);
369
370         if (min_w)
371                 *min_w = TDM_FRONT_VALUE(private_output->caps.min_w);
372         if (min_h)
373                 *min_h = TDM_FRONT_VALUE(private_output->caps.min_h);
374         if (max_w)
375                 *max_w = TDM_FRONT_VALUE(private_output->caps.max_w);
376         if (max_h)
377                 *max_h = TDM_FRONT_VALUE(private_output->caps.max_h);
378         if (preferred_align)
379                 *preferred_align = TDM_FRONT_VALUE(private_output->caps.preferred_align);
380
381         _pthread_mutex_unlock(&private_display->lock);
382
383         return ret;
384 }
385
386 EXTERN tdm_error
387 tdm_output_get_cursor_available_size(tdm_output *output, int *min_w, int *min_h,
388                                                                          int *max_w, int *max_h, int *preferred_align)
389 {
390         OUTPUT_FUNC_ENTRY();
391
392         _pthread_mutex_lock(&private_display->lock);
393
394         if (!tdm_display_check_module_abi(private_display, 1, 5)) {
395
396                 if (min_w)
397                         *min_w = -1;
398                 if (min_h)
399                         *min_h = -1;
400                 if (max_w)
401                         *max_w = -1;
402                 if (max_h)
403                         *max_h = -1;
404                 if (preferred_align)
405                         *preferred_align = -1;
406
407                 _pthread_mutex_unlock(&private_display->lock);
408
409                 return TDM_ERROR_BAD_MODULE;
410         }
411
412         if (min_w)
413                 *min_w = TDM_FRONT_VALUE(private_output->caps.cursor_min_w);
414         if (min_h)
415                 *min_h = TDM_FRONT_VALUE(private_output->caps.cursor_min_h);
416         if (max_w)
417                 *max_w = TDM_FRONT_VALUE(private_output->caps.cursor_max_w);
418         if (max_h)
419                 *max_h = TDM_FRONT_VALUE(private_output->caps.cursor_max_h);
420         if (preferred_align)
421                 *preferred_align = TDM_FRONT_VALUE(private_output->caps.cursor_preferred_align);
422
423         _pthread_mutex_unlock(&private_display->lock);
424
425         return ret;
426 }
427
428 EXTERN tdm_error
429 tdm_output_get_physical_size(tdm_output *output, unsigned int *mmWidth,
430                                                          unsigned int *mmHeight)
431 {
432         OUTPUT_FUNC_ENTRY();
433
434         _pthread_mutex_lock(&private_display->lock);
435
436         if (mmWidth)
437                 *mmWidth = private_output->caps.mmWidth;
438         if (mmHeight)
439                 *mmHeight = private_output->caps.mmHeight;
440
441         _pthread_mutex_unlock(&private_display->lock);
442
443         return ret;
444 }
445
446 EXTERN tdm_error
447 tdm_output_get_subpixel(tdm_output *output, unsigned int *subpixel)
448 {
449         OUTPUT_FUNC_ENTRY();
450         TDM_RETURN_VAL_IF_FAIL(subpixel != NULL, TDM_ERROR_INVALID_PARAMETER);
451
452         _pthread_mutex_lock(&private_display->lock);
453
454         *subpixel = private_output->caps.subpixel;
455
456         _pthread_mutex_unlock(&private_display->lock);
457
458         return ret;
459 }
460
461 EXTERN tdm_error
462 tdm_output_get_pipe(tdm_output *output, unsigned int *pipe)
463 {
464         OUTPUT_FUNC_ENTRY();
465         TDM_RETURN_VAL_IF_FAIL(pipe != NULL, TDM_ERROR_INVALID_PARAMETER);
466
467         _pthread_mutex_lock(&private_display->lock);
468
469         *pipe = private_output->pipe;
470
471         _pthread_mutex_unlock(&private_display->lock);
472
473         return ret;
474 }
475
476 EXTERN tdm_error
477 tdm_output_get_primary_index(tdm_output *output, int *index)
478 {
479         tdm_private_layer *private_layer = NULL;
480
481         OUTPUT_FUNC_ENTRY();
482         TDM_RETURN_VAL_IF_FAIL(index != NULL, TDM_ERROR_INVALID_PARAMETER);
483
484         _pthread_mutex_lock(&private_display->lock);
485
486         LIST_FOR_EACH_ENTRY(private_layer, &private_output->layer_list, link) {
487                 if (private_layer->caps.capabilities & TDM_LAYER_CAPABILITY_PRIMARY) {
488                         *index = private_layer->index;
489                         break;
490                 }
491         }
492
493         _pthread_mutex_unlock(&private_display->lock);
494
495         return ret;
496 }
497
498 EXTERN tdm_error
499 tdm_output_set_property(tdm_output *output, unsigned int id, tdm_value value)
500 {
501         tdm_func_output *func_output;
502         OUTPUT_FUNC_ENTRY();
503
504         _pthread_mutex_lock(&private_display->lock);
505
506         func_output = &private_display->func_output;
507
508         if (!func_output->output_set_property) {
509                 _pthread_mutex_unlock(&private_display->lock);
510                 TDM_ERR("not implemented!!");
511                 return TDM_ERROR_NOT_IMPLEMENTED;
512         }
513
514         ret = func_output->output_set_property(private_output->output_backend, id,
515                                                                                    value);
516
517         _pthread_mutex_unlock(&private_display->lock);
518
519         return ret;
520 }
521
522 EXTERN tdm_error
523 tdm_output_get_property(tdm_output *output, unsigned int id, tdm_value *value)
524 {
525         tdm_func_output *func_output;
526         OUTPUT_FUNC_ENTRY();
527
528         TDM_RETURN_VAL_IF_FAIL(value != NULL, TDM_ERROR_INVALID_PARAMETER);
529
530         _pthread_mutex_lock(&private_display->lock);
531
532         func_output = &private_display->func_output;
533
534         if (!func_output->output_get_property) {
535                 _pthread_mutex_unlock(&private_display->lock);
536                 TDM_ERR("not implemented!!");
537                 return TDM_ERROR_NOT_IMPLEMENTED;
538         }
539
540         ret = func_output->output_get_property(private_output->output_backend, id,
541                                                                                    value);
542
543         _pthread_mutex_unlock(&private_display->lock);
544
545         return ret;
546 }
547
548 INTERN void
549 tdm_output_cb_vblank(tdm_output *output_backend, unsigned int sequence,
550                                          unsigned int tv_sec, unsigned int tv_usec, void *user_data)
551 {
552         tdm_private_vblank_handler *vblank_handler = user_data;
553         tdm_private_vblank_handler *v = NULL, *vv = NULL;
554         tdm_private_output *private_output;
555         tdm_private_display *private_display;
556         struct list_head clone_list;
557         int interval, sync;
558         pid_t tid = syscall(SYS_gettid);
559
560         TDM_RETURN_IF_FAIL(TDM_MUTEX_IS_LOCKED());
561         TDM_RETURN_IF_FAIL(vblank_handler);
562
563         private_output = vblank_handler->private_output;
564         private_display = private_output->private_display;
565
566         if (vblank_handler->owner_tid != tid) {
567                 tdm_thread_cb_output_vblank output_vblank;
568                 tdm_error ret;
569
570                 output_vblank.base.type = TDM_THREAD_CB_OUTPUT_VBLANK;
571                 output_vblank.base.length = sizeof output_vblank;
572                 output_vblank.output_stamp = vblank_handler->private_output->stamp;
573                 output_vblank.sequence = sequence;
574                 output_vblank.tv_sec = tv_sec;
575                 output_vblank.tv_usec = tv_usec;
576                 output_vblank.user_data = user_data;
577
578                 ret = tdm_thread_send_cb(private_display->private_loop, &output_vblank.base);
579                 TDM_WARNING_IF_FAIL(ret == TDM_ERROR_NONE);
580
581                 return;
582         }
583
584         if (vblank_handler->owner_tid != tid)
585                 TDM_NEVER_GET_HERE();
586
587         interval = vblank_handler->interval;
588         sync = vblank_handler->sync;
589
590         LIST_INITHEAD(&clone_list);
591
592         LIST_FOR_EACH_ENTRY_SAFE(v, vv, &private_output->vblank_handler_list, link) {
593                 if (v->interval != interval || v->sync != sync || v->owner_tid != tid)
594                         continue;
595
596                 LIST_DEL(&v->link);
597                 LIST_ADDTAIL(&v->link, &clone_list);
598         }
599
600         if (tdm_debug_module & TDM_DEBUG_COMMIT)
601                 TDM_INFO("----------------------------------------- output(%d) got vblank", private_output->pipe);
602
603         _pthread_mutex_unlock(&private_display->lock);
604         LIST_FOR_EACH_ENTRY_SAFE(v, vv, &clone_list, link) {
605                 if (tdm_debug_module & TDM_DEBUG_COMMIT)
606                         TDM_INFO("handler(%p)", v);
607
608                 if (v->func)
609                         v->func(v->private_output, sequence, tv_sec, tv_usec, v->user_data);
610                 LIST_DEL(&v->link);
611                 free(v);
612         }
613         _pthread_mutex_lock(&private_display->lock);
614
615         if (tdm_debug_module & TDM_DEBUG_COMMIT)
616                 TDM_INFO("-----------------------------------------...");
617 }
618
619 INTERN void
620 tdm_output_cb_commit(tdm_output *output_backend, unsigned int sequence,
621                                          unsigned int tv_sec, unsigned int tv_usec, void *user_data)
622 {
623         tdm_private_output_commit_handler *output_commit_handler = user_data;
624         tdm_private_display *private_display;
625         tdm_private_output *private_output;
626         tdm_private_layer *private_layer = NULL;
627
628         TDM_RETURN_IF_FAIL(TDM_MUTEX_IS_LOCKED());
629
630         if (!output_commit_handler)
631                 return;
632
633         private_output = output_commit_handler->private_output;
634         private_display = private_output->private_display;
635
636         if (output_commit_handler->owner_tid != syscall(SYS_gettid)) {
637                 tdm_thread_cb_output_commit output_commit;
638                 tdm_error ret;
639
640                 output_commit.base.type = TDM_THREAD_CB_OUTPUT_COMMIT;
641                 output_commit.base.length = sizeof output_commit;
642                 output_commit.output_stamp = private_output->stamp;
643                 output_commit.sequence = sequence;
644                 output_commit.tv_sec = tv_sec;
645                 output_commit.tv_usec = tv_usec;
646                 output_commit.user_data = user_data;
647
648                 ret = tdm_thread_send_cb(private_display->private_loop, &output_commit.base);
649                 TDM_WARNING_IF_FAIL(ret == TDM_ERROR_NONE);
650
651                 return;
652         }
653
654         if (tdm_debug_module & TDM_DEBUG_COMMIT) {
655                 TDM_INFO("----------------------------------------- output(%d) committed", private_output->pipe);
656                 TDM_INFO("handler(%p)", output_commit_handler);
657         }
658
659         if (private_display->commit_type == TDM_COMMIT_TYPE_OUTPUT) {
660                 /* In case of layer commit, the below will be handled in the layer commit callback */
661                 LIST_FOR_EACH_ENTRY(private_layer, &private_output->layer_list, link) {
662                         if (private_layer->committed_buffer)
663                                 tdm_layer_committed(private_layer, &private_layer->committed_buffer);
664                 }
665         }
666
667         if (output_commit_handler->func) {
668                 _pthread_mutex_unlock(&private_display->lock);
669                 output_commit_handler->func(private_output, sequence,
670                                                                         tv_sec, tv_usec, output_commit_handler->user_data);
671                 _pthread_mutex_lock(&private_display->lock);
672         }
673
674         LIST_DEL(&output_commit_handler->link);
675         free(output_commit_handler);
676
677         if (tdm_debug_module & TDM_DEBUG_COMMIT)
678                 TDM_INFO("-----------------------------------------...");
679 }
680
681 /* add_front: To distinguish between the user vblank handlers and the layer
682  *            commit vblank handlers. The layer commit handlers will be called
683  *            before calling the user vblank handlers.
684  */
685 static tdm_error
686 _tdm_output_wait_vblank(tdm_output *output, int interval, int sync,
687                                                 tdm_output_vblank_handler func, void *user_data,
688                                                 unsigned int add_front)
689 {
690         tdm_func_output *func_output;
691         tdm_private_vblank_handler *vblank_handler = NULL, *v = NULL;
692         unsigned int skip_request = 0;
693         pid_t tid = syscall(SYS_gettid);
694
695         OUTPUT_FUNC_ENTRY();
696
697         func_output = &private_display->func_output;
698
699         /* interval SHOULD be at least 1 */
700         if (interval <= 0)
701                 interval = 1;
702
703         if (!func_output->output_wait_vblank) {
704                 TDM_ERR("not implemented!!");
705                 return TDM_ERROR_NOT_IMPLEMENTED;
706         }
707
708         if (!private_output->regist_vblank_cb) {
709                 private_output->regist_vblank_cb = 1;
710                 ret = func_output->output_set_vblank_handler(private_output->output_backend,
711                                 tdm_output_cb_vblank);
712         }
713
714         vblank_handler = calloc(1, sizeof(tdm_private_vblank_handler));
715         if (!vblank_handler) {
716                 TDM_ERR("failed: alloc memory");
717                 return TDM_ERROR_OUT_OF_MEMORY;
718         }
719
720         if (tdm_debug_module & TDM_DEBUG_COMMIT)
721                 TDM_INFO("output(%d) wait_vblank: handler(%p)", private_output->pipe, vblank_handler);
722
723         LIST_FOR_EACH_ENTRY(v, &private_output->vblank_handler_list, link) {
724                 if (v->interval == interval && v->sync == sync && v->owner_tid == tid) {
725                         skip_request = 1;
726                         break;
727                 }
728         }
729
730         if (add_front)
731                 LIST_ADD(&vblank_handler->link, &private_output->vblank_handler_list);
732         else
733                 LIST_ADDTAIL(&vblank_handler->link, &private_output->vblank_handler_list);
734
735         vblank_handler->private_output = private_output;
736         vblank_handler->interval = interval;
737         vblank_handler->sync = sync;
738         vblank_handler->func = func;
739         vblank_handler->user_data = user_data;
740         vblank_handler->owner_tid = tid;
741
742         /* If there is the previous request, we can skip to call output_wait_vblank() */
743         if (!skip_request) {
744                 ret = func_output->output_wait_vblank(private_output->output_backend, interval,
745                                                                                           sync, vblank_handler);
746                 TDM_GOTO_IF_FAIL(ret == TDM_ERROR_NONE, wait_failed);
747
748                 if (tdm_debug_module & TDM_DEBUG_COMMIT)
749                         TDM_INFO("output(%d) backend wait_vblank", private_output->pipe);
750         }
751
752         return ret;
753
754 wait_failed:
755         if (vblank_handler) {
756                 LIST_DEL(&vblank_handler->link);
757                 free(vblank_handler);
758         }
759         return ret;
760 }
761
762 EXTERN tdm_error
763 tdm_output_wait_vblank(tdm_output *output, int interval, int sync,
764                                            tdm_output_vblank_handler func, void *user_data)
765 {
766         OUTPUT_FUNC_ENTRY();
767
768         _pthread_mutex_lock(&private_display->lock);
769
770         if (private_output->current_dpms_value > TDM_OUTPUT_DPMS_ON) {
771                 TDM_WRN("output(%d) dpms: %s", private_output->pipe,
772                                 tdm_dpms_str(private_output->current_dpms_value));
773                 _pthread_mutex_unlock(&private_display->lock);
774                 return TDM_ERROR_DPMS_OFF;
775         }
776
777         ret = _tdm_output_wait_vblank(output, interval, sync, func, user_data, 0);
778
779         _pthread_mutex_unlock(&private_display->lock);
780
781         return ret;
782 }
783
784 EXTERN tdm_error
785 tdm_output_wait_vblank_add_front(tdm_output *output, int interval, int sync,
786                                                                  tdm_output_vblank_handler func, void *user_data)
787 {
788         OUTPUT_FUNC_ENTRY();
789
790         _pthread_mutex_lock(&private_display->lock);
791
792         if (private_output->current_dpms_value > TDM_OUTPUT_DPMS_ON) {
793                 TDM_WRN("output(%d) dpms: %s", private_output->pipe,
794                                 tdm_dpms_str(private_output->current_dpms_value));
795                 _pthread_mutex_unlock(&private_display->lock);
796                 return TDM_ERROR_DPMS_OFF;
797         }
798
799         ret = _tdm_output_wait_vblank(output, interval, sync, func, user_data, 1);
800
801         _pthread_mutex_unlock(&private_display->lock);
802
803         return ret;
804 }
805
806 INTERN void
807 tdm_output_remove_vblank_handler_internal(tdm_output *output, tdm_output_vblank_handler func, void *user_data)
808 {
809         tdm_private_output *private_output = (tdm_private_output*)output;
810         tdm_private_vblank_handler *v = NULL;
811
812         TDM_RETURN_IF_FAIL(private_output != NULL);
813
814         LIST_FOR_EACH_ENTRY(v, &private_output->vblank_handler_list, link) {
815                 if (v->func == func && v->user_data == user_data) {
816                         /* only set func & user_data to NULL. It will be freed when an event occurs */
817                         v->func = NULL;
818                         v->user_data = NULL;
819                         break;
820                 }
821         }
822 }
823
824 INTERN void
825 tdm_output_remove_commit_handler_internal(tdm_output *output, tdm_output_commit_handler func, void *user_data)
826 {
827         tdm_private_output *private_output = (tdm_private_output*)output;
828         tdm_private_output_commit_handler *c = NULL;
829
830         TDM_RETURN_IF_FAIL(private_output != NULL);
831
832         LIST_FOR_EACH_ENTRY(c, &private_output->output_commit_handler_list, link) {
833                 if (c->func == func && c->user_data == user_data) {
834                         /* only set func & user_data to NULL. It will be freed when an event occurs */
835                         c->func = NULL;
836                         c->user_data = NULL;
837                         break;
838                 }
839         }
840 }
841
842 EXTERN tdm_error
843 tdm_output_remove_vblank_handler(tdm_output *output, tdm_output_vblank_handler func, void *user_data)
844 {
845         OUTPUT_FUNC_ENTRY();
846
847         _pthread_mutex_lock(&private_display->lock);
848
849         tdm_output_remove_vblank_handler_internal(output, func, user_data);
850
851         _pthread_mutex_unlock(&private_display->lock);
852
853         return ret;
854 }
855
856 EXTERN tdm_error
857 tdm_output_remove_commit_handler(tdm_output *output, tdm_output_commit_handler func, void *user_data)
858 {
859         OUTPUT_FUNC_ENTRY();
860
861         _pthread_mutex_lock(&private_display->lock);
862
863         tdm_output_remove_commit_handler_internal(output, func, user_data);
864
865         _pthread_mutex_unlock(&private_display->lock);
866
867         return ret;
868 }
869
870 INTERN tdm_error
871 tdm_output_commit_internal(tdm_output *output, int sync, tdm_output_commit_handler func, void *user_data)
872 {
873         tdm_func_output *func_output;
874         tdm_private_output_commit_handler *output_commit_handler = NULL;
875         tdm_private_layer *private_layer = NULL;
876         tdm_output_dpms dpms_value = TDM_OUTPUT_DPMS_ON;
877
878         OUTPUT_FUNC_ENTRY();
879
880         func_output = &private_display->func_output;
881
882         if (!func_output->output_commit) {
883                 TDM_ERR("not implemented!!");
884                 return TDM_ERROR_NOT_IMPLEMENTED;
885         }
886
887         /* TODO: this is ugly. But before using tdm_output_get_dpms_internal, we have
888          * to check if all backends's DPMS operation has no problem.
889          */
890         if (private_display->commit_per_vblank)
891                 tdm_output_get_dpms_internal(output, &dpms_value);
892         else
893                 dpms_value = private_output->current_dpms_value;
894
895         if (dpms_value == TDM_OUTPUT_DPMS_ON) {
896                 if (func) {
897                         if (!private_output->regist_commit_cb) {
898                                 private_output->regist_commit_cb = 1;
899                                 ret = func_output->output_set_commit_handler(private_output->output_backend,
900                                                         tdm_output_cb_commit);
901                                 TDM_GOTO_IF_FAIL(ret == TDM_ERROR_NONE, commit_failed);
902                         }
903
904                         output_commit_handler = calloc(1, sizeof(tdm_private_output_commit_handler));
905                         if (!output_commit_handler) {
906                                 TDM_ERR("failed: alloc memory");
907                                 return TDM_ERROR_OUT_OF_MEMORY;
908                         }
909
910                         LIST_ADDTAIL(&output_commit_handler->link, &private_output->output_commit_handler_list);
911                         output_commit_handler->private_output = private_output;
912                         output_commit_handler->func = func;
913                         output_commit_handler->user_data = user_data;
914                         output_commit_handler->owner_tid = syscall(SYS_gettid);
915                 }
916
917                 ret = func_output->output_commit(private_output->output_backend, sync,
918                                 output_commit_handler);
919                 TDM_GOTO_IF_FAIL(ret == TDM_ERROR_NONE, commit_failed);
920
921                 if (tdm_debug_module & TDM_DEBUG_COMMIT)
922                         TDM_INFO("output(%d) backend commit: handle(%p) func(%p) user_data(%p)",
923                                         private_output->pipe, output_commit_handler, func, user_data);
924         }
925
926         /* Even if DPMS is off, committed_buffer should be changed because it will be referred
927          * for tdm_layer_committed() function.
928          */
929         LIST_FOR_EACH_ENTRY(private_layer, &private_output->layer_list, link) {
930                 if (!private_layer->waiting_buffer)
931                         continue;
932
933                 private_layer->committed_buffer = private_layer->waiting_buffer;
934                 private_layer->waiting_buffer = NULL;
935                 if (tdm_debug_module & TDM_DEBUG_BUFFER)
936                         TDM_INFO("layer(%p) waiting_buffer(%p) committed_buffer(%p)",
937                                          private_layer, private_layer->waiting_buffer,
938                                          private_layer->committed_buffer->buffer);
939         }
940
941         if (dpms_value != TDM_OUTPUT_DPMS_ON) {
942                 TDM_WRN("TDM_OUTPUT_DPMS_OFF. Directly call commit handler instead of commit.");
943                 if (func)
944                         func(output, 0, 0, 0, user_data);
945         }
946
947         return ret;
948
949 commit_failed:
950         if (output_commit_handler) {
951                 LIST_DEL(&output_commit_handler->link);
952                 free(output_commit_handler);
953         }
954         return ret;
955 }
956
957 EXTERN tdm_error
958 tdm_output_commit(tdm_output *output, int sync, tdm_output_commit_handler func,
959                                   void *user_data)
960 {
961         OUTPUT_FUNC_ENTRY();
962
963         _pthread_mutex_lock(&private_display->lock);
964
965         if (private_display->commit_type == TDM_COMMIT_TYPE_NONE)
966                 private_display->commit_type = TDM_COMMIT_TYPE_OUTPUT;
967         else if (private_display->commit_type == TDM_COMMIT_TYPE_LAYER) {
968                 TDM_ERR("Can't supported. Use tdm_layer_commit");
969                 _pthread_mutex_unlock(&private_display->lock);
970                 return TDM_ERROR_BAD_REQUEST;
971         }
972
973         if (private_display->commit_per_vblank) {
974                 TDM_ERR("Use tdm_layer_commit");
975                 _pthread_mutex_unlock(&private_display->lock);
976                 return TDM_ERROR_BAD_REQUEST;
977         }
978
979         if (private_output->current_dpms_value > TDM_OUTPUT_DPMS_ON) {
980                 TDM_ERR("output(%d) dpms: %s", private_output->pipe,
981                                 tdm_dpms_str(private_output->current_dpms_value));
982                 _pthread_mutex_unlock(&private_display->lock);
983                 return TDM_ERROR_DPMS_OFF;
984         }
985
986         if (tdm_debug_module & TDM_DEBUG_COMMIT)
987                 TDM_INFO("output(%d) commit", private_output->pipe);
988
989         ret = tdm_output_commit_internal(output, sync, func, user_data);
990
991         _pthread_mutex_unlock(&private_display->lock);
992
993         return ret;
994 }
995
996 EXTERN tdm_error
997 tdm_output_set_mode(tdm_output *output, const tdm_output_mode *mode)
998 {
999         tdm_func_output *func_output;
1000         OUTPUT_FUNC_ENTRY();
1001
1002         TDM_RETURN_VAL_IF_FAIL(mode != NULL, TDM_ERROR_INVALID_PARAMETER);
1003
1004         _pthread_mutex_lock(&private_display->lock);
1005
1006         func_output = &private_display->func_output;
1007
1008         if (!func_output->output_set_mode) {
1009                 _pthread_mutex_unlock(&private_display->lock);
1010                 TDM_ERR("not implemented!!");
1011                 return TDM_ERROR_NOT_IMPLEMENTED;
1012         }
1013
1014         ret = func_output->output_set_mode(private_output->output_backend, mode);
1015         if (ret == TDM_ERROR_NONE)
1016                 private_output->current_mode = mode;
1017         _pthread_mutex_unlock(&private_display->lock);
1018
1019         return ret;
1020 }
1021
1022 EXTERN tdm_error
1023 tdm_output_get_mode(tdm_output *output, const tdm_output_mode **mode)
1024 {
1025         OUTPUT_FUNC_ENTRY();
1026
1027         TDM_RETURN_VAL_IF_FAIL(mode != NULL, TDM_ERROR_INVALID_PARAMETER);
1028
1029         _pthread_mutex_lock(&private_display->lock);
1030
1031         *mode = private_output->current_mode;
1032
1033         _pthread_mutex_unlock(&private_display->lock);
1034
1035         return ret;
1036 }
1037
1038 static tdm_error
1039 _tdm_output_dpms_changed_timeout(void *user_data)
1040 {
1041         tdm_private_output *private_output = user_data;
1042         tdm_value value;
1043
1044         value.u32 = private_output->current_dpms_value;
1045         tdm_output_call_change_handler_internal(private_output,
1046                                                                                         &private_output->change_handler_list_sub,
1047                                                                                         TDM_OUTPUT_CHANGE_DPMS,
1048                                                                                         value, 0);
1049
1050         return TDM_ERROR_NONE;
1051 }
1052
1053 INTERN void
1054 tdm_output_cb_dpms(tdm_output *output_backend, tdm_output_dpms dpms, void *user_data)
1055 {
1056         tdm_private_display *private_display;
1057         tdm_private_output *private_output = user_data;
1058         tdm_value value;
1059
1060         TDM_RETURN_IF_FAIL(TDM_MUTEX_IS_LOCKED());
1061         TDM_RETURN_IF_FAIL(private_output);
1062
1063         private_display = private_output->private_display;
1064
1065         if (!tdm_thread_in_display_thread(syscall(SYS_gettid))) {
1066                 tdm_thread_cb_output_dpms output_dpms;
1067                 tdm_error ret;
1068
1069                 _tdm_output_update(output_backend, user_data);
1070
1071                 output_dpms.base.type = TDM_THREAD_CB_OUTPUT_DPMS;
1072                 output_dpms.base.length = sizeof output_dpms;
1073                 output_dpms.output_stamp = private_output->stamp;
1074                 output_dpms.dpms = dpms;
1075                 output_dpms.user_data = user_data;
1076
1077                 value.u32 = dpms;
1078                 tdm_output_call_change_handler_internal(private_output,
1079                                                                                                 &private_output->change_handler_list_sub,
1080                                                                                                 TDM_OUTPUT_CHANGE_DPMS,
1081                                                                                                 value, 0);
1082
1083                 ret = tdm_thread_send_cb(private_display->private_loop, &output_dpms.base);
1084                 TDM_WARNING_IF_FAIL(ret == TDM_ERROR_NONE);
1085
1086                 return;
1087         }
1088
1089         private_output->current_dpms_value = dpms;
1090
1091         TDM_INFO("output(%d) dpms %s", private_output->pipe, tdm_dpms_str(dpms));
1092
1093         value.u32 = dpms;
1094         tdm_output_call_change_handler_internal(private_output,
1095                                                                                         &private_output->change_handler_list_main,
1096                                                                                         TDM_OUTPUT_CHANGE_DPMS,
1097                                                                                         value, 0);
1098 }
1099
1100 EXTERN tdm_error
1101 tdm_output_set_dpms(tdm_output *output, tdm_output_dpms dpms_value)
1102 {
1103         tdm_func_output *func_output;
1104         OUTPUT_FUNC_ENTRY();
1105
1106         if (dpms_value > TDM_OUTPUT_DPMS_OFF)
1107                 dpms_value = TDM_OUTPUT_DPMS_OFF;
1108
1109         _pthread_mutex_lock(&private_display->lock);
1110
1111         if (private_output->current_dpms_value == dpms_value) {
1112                 _pthread_mutex_unlock(&private_display->lock);
1113                 return TDM_ERROR_NONE;
1114         }
1115
1116         /** Use timer to call the output change callback of the sub-thread.
1117          * The output change callback of tdm_server and tdm_vblank was called
1118          * in the main thread. And it made the multi thread issue. If we use
1119          * the timer, we can call the sub-thread's output change callback in
1120          * sub-thread.
1121          */
1122         if (!private_output->dpms_changed_timer) {
1123                 private_output->dpms_changed_timer =
1124                         tdm_event_loop_add_timer_handler(private_output->private_display,
1125                                                                                          _tdm_output_dpms_changed_timeout, private_output, NULL);
1126                 if (!private_output->dpms_changed_timer) {
1127                         TDM_ERR("can't create dpms timer!!");
1128                         _pthread_mutex_unlock(&private_display->lock);
1129                         return TDM_ERROR_OUT_OF_MEMORY;
1130                 }
1131         }
1132
1133         func_output = &private_display->func_output;
1134
1135         if (!func_output->output_set_dpms) {
1136                 _pthread_mutex_unlock(&private_display->lock);
1137                 private_output->current_dpms_value = dpms_value;
1138                 TDM_INFO("output(%d) dpms %s", private_output->pipe, tdm_dpms_str(dpms_value));
1139                 TDM_WRN("not implemented!!");
1140                 return TDM_ERROR_NONE;
1141         }
1142
1143         if (func_output->output_set_dpms_handler) {
1144                 if (!private_output->regist_dpms_cb) {
1145                         private_output->regist_dpms_cb = 1;
1146                         ret = func_output->output_set_dpms_handler(private_output->output_backend,
1147                                         tdm_output_cb_dpms, private_output);
1148                         if (ret != TDM_ERROR_NONE) {
1149                                 _pthread_mutex_unlock(&private_display->lock);
1150                                 TDM_ERR("Can't set the dpms handler!!");
1151                                 return ret;
1152                         }
1153                 }
1154         }
1155
1156         ret = func_output->output_set_dpms(private_output->output_backend, dpms_value);
1157
1158         if (ret == TDM_ERROR_NONE && !func_output->output_set_dpms_handler) {
1159                 tdm_value value;
1160
1161                 private_output->current_dpms_value = dpms_value;
1162                 TDM_INFO("output(%d) dpms %s", private_output->pipe, tdm_dpms_str(dpms_value));
1163
1164                 value.u32 = dpms_value;
1165                 tdm_output_call_change_handler_internal(private_output,
1166                                                                                                 &private_output->change_handler_list_main,
1167                                                                                                 TDM_OUTPUT_CHANGE_DPMS,
1168                                                                                                 value, 0);
1169
1170                 if (!LIST_IS_EMPTY(&private_output->change_handler_list_sub)) {
1171                         ret = tdm_event_loop_source_timer_update(private_output->dpms_changed_timer, 1);
1172                         if (ret != TDM_ERROR_NONE)
1173                                 TDM_NEVER_GET_HERE();
1174                 }
1175         }
1176
1177         _pthread_mutex_unlock(&private_display->lock);
1178
1179         return ret;
1180 }
1181
1182 INTERN tdm_error
1183 tdm_output_get_dpms_internal(tdm_output *output, tdm_output_dpms *dpms_value)
1184 {
1185         tdm_func_output *func_output;
1186         OUTPUT_FUNC_ENTRY();
1187
1188         TDM_RETURN_VAL_IF_FAIL(private_output != NULL, TDM_ERROR_INVALID_PARAMETER);
1189
1190         func_output = &private_display->func_output;
1191
1192         if (!func_output->output_get_dpms) {
1193                 *dpms_value = private_output->current_dpms_value;
1194                 TDM_WRN("not implemented!!");
1195                 return TDM_ERROR_NONE;
1196         }
1197
1198         ret = func_output->output_get_dpms(private_output->output_backend, dpms_value);
1199         if (ret != TDM_ERROR_NONE) {
1200                 TDM_ERR("output_get_dpms failed");
1201                 *dpms_value = TDM_OUTPUT_DPMS_OFF;
1202         }
1203
1204         if (*dpms_value != private_output->current_dpms_value) {
1205                 private_output->current_dpms_value = *dpms_value;
1206                 TDM_ERR("output(%d) dpms changed suddenly: %s", private_output->pipe, tdm_dpms_str(*dpms_value));
1207         }
1208
1209         return ret;
1210 }
1211
1212 EXTERN tdm_error
1213 tdm_output_get_dpms(tdm_output *output, tdm_output_dpms *dpms_value)
1214 {
1215         OUTPUT_FUNC_ENTRY();
1216
1217         TDM_RETURN_VAL_IF_FAIL(dpms_value != NULL, TDM_ERROR_INVALID_PARAMETER);
1218
1219         _pthread_mutex_lock(&private_display->lock);
1220
1221         ret = tdm_output_get_dpms_internal(output, dpms_value);
1222
1223         _pthread_mutex_unlock(&private_display->lock);
1224
1225         return ret;
1226 }
1227
1228 EXTERN tdm_capture *
1229 tdm_output_create_capture(tdm_output *output, tdm_error *error)
1230 {
1231         tdm_capture *capture = NULL;
1232
1233         OUTPUT_FUNC_ENTRY_ERROR();
1234
1235         _pthread_mutex_lock(&private_display->lock);
1236
1237         capture = (tdm_capture *)tdm_capture_create_output_internal(private_output, error);
1238
1239         _pthread_mutex_unlock(&private_display->lock);
1240
1241         return capture;
1242 }
1243
1244 INTERN void
1245 tdm_output_call_change_handler_internal(tdm_private_output *private_output,
1246                                                                                 struct list_head *change_handler_list,
1247                                                                                 tdm_output_change_type type,
1248                                                                                 tdm_value value,
1249                                                                                 int no_check_thread_id)
1250 {
1251         tdm_private_display *private_display;
1252         tdm_private_change_handler *change_handler = NULL;
1253
1254         TDM_RETURN_IF_FAIL(TDM_MUTEX_IS_LOCKED());
1255         TDM_RETURN_IF_FAIL(private_output);
1256
1257         private_display = private_output->private_display;
1258         if (!tdm_thread_in_display_thread(syscall(SYS_gettid))) {
1259                 if (type & TDM_OUTPUT_CHANGE_CONNECTION)
1260                         TDM_INFO("output(%d) changed: %s (%d)",
1261                                          private_output->pipe, tdm_status_str(value.u32), value.u32);
1262                 if (type & TDM_OUTPUT_CHANGE_DPMS)
1263                         TDM_INFO("output(%d) changed: dpms %s (%d)",
1264                                          private_output->pipe, tdm_dpms_str(value.u32), value.u32);
1265         }
1266
1267         if (LIST_IS_EMPTY(change_handler_list))
1268                 return;
1269
1270         LIST_FOR_EACH_ENTRY(change_handler, change_handler_list, link) {
1271                 if (!no_check_thread_id && change_handler->owner_tid != syscall(SYS_gettid))
1272                         TDM_NEVER_GET_HERE();
1273
1274                 _pthread_mutex_unlock(&private_display->lock);
1275                 change_handler->func(private_output, type,
1276                                                          value, change_handler->user_data);
1277                 _pthread_mutex_lock(&private_display->lock);
1278         }
1279 }