1 /*****************************************************************************
2 * vmem.c: memory video driver for vlc
3 *****************************************************************************
4 * Copyright (C) 2008 VLC authors and VideoLAN
5 * Copyright (C) 2010 RĂ©mi Denis-Courmont
7 * Authors: Sam Hocevar <sam@zoy.org>
9 * This program is free software; you can redistribute it and/or modify it
10 * under the terms of the GNU Lesser General Public License as published by
11 * the Free Software Foundation; either version 2.1 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Lesser General Public License for more details.
19 * You should have received a copy of the GNU Lesser General Public License
20 * along with this program; if not, write to the Free Software Foundation,
21 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
22 *****************************************************************************/
24 /*****************************************************************************
26 *****************************************************************************/
34 #include <vlc_common.h>
35 #include <vlc_plugin.h>
36 #include <vlc_vout_display.h>
38 /*****************************************************************************
40 *****************************************************************************/
41 #define T_WIDTH N_("Width")
42 #define LT_WIDTH N_("Video memory buffer width.")
44 #define T_HEIGHT N_("Height")
45 #define LT_HEIGHT N_("Video memory buffer height.")
47 #define T_PITCH N_("Pitch")
48 #define LT_PITCH N_("Video memory buffer pitch in bytes.")
50 #define T_CHROMA N_("Chroma")
51 #define LT_CHROMA N_("Output chroma for the memory image as a 4-character " \
52 "string, eg. \"RV32\".")
54 static int Open(vout_display_t
*vd
, const vout_display_cfg_t
*cfg
,
55 video_format_t
*fmtp
, vlc_video_context
*context
);
56 static void Close(vout_display_t
*vd
);
59 set_description(N_("Video memory output"))
60 set_shortname(N_("Video memory"))
62 set_category(CAT_VIDEO
)
63 set_subcategory(SUBCAT_VIDEO_VOUT
)
65 add_integer("vmem-width", 320, T_WIDTH
, LT_WIDTH
, false)
67 add_integer("vmem-height", 200, T_HEIGHT
, LT_HEIGHT
, false)
69 add_integer("vmem-pitch", 640, T_PITCH
, LT_PITCH
, false)
71 add_string("vmem-chroma", "RV16", T_CHROMA
, LT_CHROMA
, true)
73 add_obsolete_string("vmem-lock") /* obsoleted since 1.1.1 */
74 add_obsolete_string("vmem-unlock") /* obsoleted since 1.1.1 */
75 add_obsolete_string("vmem-data") /* obsoleted since 1.1.1 */
77 set_callback_display(Open
, 0)
80 /*****************************************************************************
82 *****************************************************************************/
88 /* NOTE: the callback prototypes must match those of LibVLC */
89 struct vout_display_sys_t
{
92 void *(*lock
)(void *sys
, void **plane
);
93 void (*unlock
)(void *sys
, void *id
, void *const *plane
);
94 void (*display
)(void *sys
, void *id
);
95 void (*cleanup
)(void *sys
);
97 unsigned pitches
[PICTURE_PLANE_MAX
];
98 unsigned lines
[PICTURE_PLANE_MAX
];
101 typedef unsigned (*vlc_format_cb
)(void **, char *, unsigned *, unsigned *,
102 unsigned *, unsigned *);
104 static void Prepare(vout_display_t
*, picture_t
*, subpicture_t
*, vlc_tick_t
);
105 static void Display(vout_display_t
*, picture_t
*);
106 static int Control(vout_display_t
*, int);
108 static const struct vlc_display_operations ops
= {
109 Close
, Prepare
, Display
, Control
, NULL
, NULL
,
112 /*****************************************************************************
113 * Open: allocates video thread
114 *****************************************************************************
115 * This function allocates and initializes a vout method.
116 *****************************************************************************/
117 static int Open(vout_display_t
*vd
, const vout_display_cfg_t
*cfg
,
118 video_format_t
*fmtp
, vlc_video_context
*context
)
120 vout_display_sys_t
*sys
= malloc(sizeof(*sys
));
124 /* Get the callbacks */
125 vlc_format_cb setup
= var_InheritAddress(vd
, "vmem-setup");
127 sys
->lock
= var_InheritAddress(vd
, "vmem-lock");
128 if (sys
->lock
== NULL
) {
129 msg_Err(vd
, "missing lock callback");
133 sys
->unlock
= var_InheritAddress(vd
, "vmem-unlock");
134 sys
->display
= var_InheritAddress(vd
, "vmem-display");
135 sys
->cleanup
= var_InheritAddress(vd
, "vmem-cleanup");
136 sys
->opaque
= var_InheritAddress(vd
, "vmem-data");
138 /* Define the video format */
140 video_format_ApplyRotation(&fmt
, vd
->source
);
145 memcpy(chroma
, &fmt
.i_chroma
, 4);
147 memset(sys
->pitches
, 0, sizeof(sys
->pitches
));
148 memset(sys
->lines
, 0, sizeof(sys
->lines
));
150 unsigned widths
[2], heights
[2];
151 widths
[0] = fmt
.i_width
;
152 widths
[1] = fmt
.i_visible_width
;
154 heights
[0] = fmt
.i_height
;
155 heights
[1] = fmt
.i_visible_height
;
157 if (setup(&sys
->opaque
, chroma
, widths
, heights
,
158 sys
->pitches
, sys
->lines
) == 0) {
159 msg_Err(vd
, "video format setup failure (no pictures)");
163 fmt
.i_chroma
= vlc_fourcc_GetCodecFromString(VIDEO_ES
, chroma
);
164 fmt
.i_width
= widths
[0];
165 fmt
.i_height
= heights
[0];
168 char *chroma
= var_InheritString(vd
, "vmem-chroma");
169 fmt
.i_chroma
= vlc_fourcc_GetCodecFromString(VIDEO_ES
, chroma
);
172 fmt
.i_width
= var_InheritInteger(vd
, "vmem-width");
173 fmt
.i_height
= var_InheritInteger(vd
, "vmem-height");
174 sys
->pitches
[0] = var_InheritInteger(vd
, "vmem-pitch");
175 sys
->lines
[0] = fmt
.i_height
;
176 for (size_t i
= 1; i
< PICTURE_PLANE_MAX
; i
++)
178 sys
->pitches
[i
] = sys
->pitches
[0];
179 sys
->lines
[i
] = sys
->lines
[0];
183 fmt
.i_x_offset
= fmt
.i_y_offset
= 0;
184 fmt
.i_visible_width
= fmt
.i_width
;
185 fmt
.i_visible_height
= fmt
.i_height
;
188 msg_Err(vd
, "vmem-chroma should be 4 characters long");
193 /* Define the bitmasks */
194 switch (fmt
.i_chroma
)
196 case VLC_CODEC_RGB15
:
197 fmt
.i_rmask
= 0x001f;
198 fmt
.i_gmask
= 0x03e0;
199 fmt
.i_bmask
= 0x7c00;
201 case VLC_CODEC_RGB16
:
202 fmt
.i_rmask
= 0x001f;
203 fmt
.i_gmask
= 0x07e0;
204 fmt
.i_bmask
= 0xf800;
206 case VLC_CODEC_RGB24
:
207 case VLC_CODEC_RGB32
:
208 fmt
.i_rmask
= 0xff0000;
209 fmt
.i_gmask
= 0x00ff00;
210 fmt
.i_bmask
= 0x0000ff;
225 (void) cfg
; (void) context
;
229 static void Close(vout_display_t
*vd
)
231 vout_display_sys_t
*sys
= vd
->sys
;
234 sys
->cleanup(sys
->opaque
);
238 static void Prepare(vout_display_t
*vd
, picture_t
*pic
, subpicture_t
*subpic
,
242 vout_display_sys_t
*sys
= vd
->sys
;
243 picture_resource_t rsc
= { .p_sys
= NULL
};
244 void *planes
[PICTURE_PLANE_MAX
];
246 sys
->pic_opaque
= sys
->lock(sys
->opaque
, planes
);
248 picture_t
*locked
= picture_NewFromResource(vd
->fmt
, &rsc
);
249 if (likely(locked
!= NULL
)) {
250 for (unsigned i
= 0; i
< PICTURE_PLANE_MAX
; i
++) {
251 locked
->p
[i
].p_pixels
= planes
[i
];
252 locked
->p
[i
].i_lines
= sys
->lines
[i
];
253 locked
->p
[i
].i_pitch
= sys
->pitches
[i
];
256 picture_CopyPixels(locked
, pic
);
257 picture_Release(locked
);
260 if (sys
->unlock
!= NULL
)
261 sys
->unlock(sys
->opaque
, sys
->pic_opaque
, planes
);
266 static void Display(vout_display_t
*vd
, picture_t
*pic
)
268 vout_display_sys_t
*sys
= vd
->sys
;
271 if (sys
->display
!= NULL
)
272 sys
->display(sys
->opaque
, sys
->pic_opaque
);
275 static int Control(vout_display_t
*vd
, int query
)
280 case VOUT_DISPLAY_CHANGE_DISPLAY_SIZE
:
281 case VOUT_DISPLAY_CHANGE_DISPLAY_FILLED
:
282 case VOUT_DISPLAY_CHANGE_ZOOM
:
283 case VOUT_DISPLAY_CHANGE_SOURCE_ASPECT
:
284 case VOUT_DISPLAY_CHANGE_SOURCE_CROP
: