2 * Copyright (C) <2008> Wim Taymans <wim.taymans@gmail.com>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
17 * Boston, MA 02110-1301, USA.
26 #include <gst/rtp/gstrtpbuffer.h>
28 #include "gstrtpvrawpay.h"
30 GST_DEBUG_CATEGORY_STATIC (rtpvrawpay_debug);
31 #define GST_CAT_DEFAULT (rtpvrawpay_debug)
33 static GstStaticPadTemplate gst_rtp_vraw_pay_sink_template =
34 GST_STATIC_PAD_TEMPLATE ("sink",
37 GST_STATIC_CAPS ("video/x-raw, "
38 "format = (string) { RGB, RGBA, BGR, BGRA, AYUV, UYVY, I420, Y41B, UYVP }, "
39 "width = (int) [ 1, 32767 ], " "height = (int) [ 1, 32767 ]; ")
42 static GstStaticPadTemplate gst_rtp_vraw_pay_src_template =
43 GST_STATIC_PAD_TEMPLATE ("src",
46 GST_STATIC_CAPS ("application/x-rtp, "
47 "media = (string) \"video\", "
48 "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
49 "clock-rate = (int) 90000, "
50 "encoding-name = (string) \"RAW\","
51 "sampling = (string) { \"RGB\", \"RGBA\", \"BGR\", \"BGRA\", "
52 "\"YCbCr-4:4:4\", \"YCbCr-4:2:2\", \"YCbCr-4:2:0\", "
54 /* we cannot express these as strings
55 * "width = (string) [1 32767],"
56 * "height = (string) [1 32767],"
58 "depth = (string) { \"8\", \"10\", \"12\", \"16\" },"
59 "colorimetry = (string) { \"BT601-5\", \"BT709-2\", \"SMPTE240M\" }"
63 * chroma-position = (string)
69 static gboolean gst_rtp_vraw_pay_setcaps (GstRTPBasePayload * payload,
71 static GstFlowReturn gst_rtp_vraw_pay_handle_buffer (GstRTPBasePayload *
72 payload, GstBuffer * buffer);
74 G_DEFINE_TYPE (GstRtpVRawPay, gst_rtp_vraw_pay, GST_TYPE_RTP_BASE_PAYLOAD)
76 static void gst_rtp_vraw_pay_class_init (GstRtpVRawPayClass * klass)
78 GstRTPBasePayloadClass *gstrtpbasepayload_class;
79 GstElementClass *gstelement_class;
81 gstelement_class = (GstElementClass *) klass;
82 gstrtpbasepayload_class = (GstRTPBasePayloadClass *) klass;
84 gstrtpbasepayload_class->set_caps = gst_rtp_vraw_pay_setcaps;
85 gstrtpbasepayload_class->handle_buffer = gst_rtp_vraw_pay_handle_buffer;
87 gst_element_class_add_pad_template (gstelement_class,
88 gst_static_pad_template_get (&gst_rtp_vraw_pay_src_template));
89 gst_element_class_add_pad_template (gstelement_class,
90 gst_static_pad_template_get (&gst_rtp_vraw_pay_sink_template));
92 gst_element_class_set_static_metadata (gstelement_class,
93 "RTP Raw Video payloader", "Codec/Payloader/Network/RTP",
94 "Payload raw video as RTP packets (RFC 4175)",
95 "Wim Taymans <wim.taymans@gmail.com>");
97 GST_DEBUG_CATEGORY_INIT (rtpvrawpay_debug, "rtpvrawpay", 0,
98 "Raw video RTP Payloader");
102 gst_rtp_vraw_pay_init (GstRtpVRawPay * rtpvrawpay)
107 gst_rtp_vraw_pay_setcaps (GstRTPBasePayload * payload, GstCaps * caps)
109 GstRtpVRawPay *rtpvrawpay;
111 gint pgroup, xinc, yinc;
112 const gchar *depthstr, *samplingstr, *colorimetrystr;
117 rtpvrawpay = GST_RTP_VRAW_PAY (payload);
119 if (!gst_video_info_from_caps (&info, caps))
122 rtpvrawpay->vinfo = info;
124 if (gst_video_colorimetry_matches (&info.colorimetry,
125 GST_VIDEO_COLORIMETRY_BT601)) {
126 colorimetrystr = "BT601-5";
127 } else if (gst_video_colorimetry_matches (&info.colorimetry,
128 GST_VIDEO_COLORIMETRY_BT709)) {
129 colorimetrystr = "BT709-2";
130 } else if (gst_video_colorimetry_matches (&info.colorimetry,
131 GST_VIDEO_COLORIMETRY_SMPTE240M)) {
132 colorimetrystr = "SMPTE240M";
134 colorimetrystr = "SMPTE240M";
139 /* these values are the only thing we can do */
143 switch (GST_VIDEO_INFO_FORMAT (&info)) {
144 case GST_VIDEO_FORMAT_RGBA:
145 samplingstr = "RGBA";
148 case GST_VIDEO_FORMAT_BGRA:
149 samplingstr = "BGRA";
152 case GST_VIDEO_FORMAT_RGB:
156 case GST_VIDEO_FORMAT_BGR:
160 case GST_VIDEO_FORMAT_AYUV:
161 samplingstr = "YCbCr-4:4:4";
164 case GST_VIDEO_FORMAT_UYVY:
165 samplingstr = "YCbCr-4:2:2";
169 case GST_VIDEO_FORMAT_Y41B:
170 samplingstr = "YCbCr-4:1:1";
174 case GST_VIDEO_FORMAT_I420:
175 samplingstr = "YCbCr-4:2:0";
179 case GST_VIDEO_FORMAT_UYVP:
180 samplingstr = "YCbCr-4:2:2";
191 if (GST_VIDEO_INFO_IS_INTERLACED (&info)) {
195 rtpvrawpay->pgroup = pgroup;
196 rtpvrawpay->xinc = xinc;
197 rtpvrawpay->yinc = yinc;
198 rtpvrawpay->depth = depth;
200 GST_DEBUG_OBJECT (payload, "width %d, height %d, sampling %s",
201 GST_VIDEO_INFO_WIDTH (&info), GST_VIDEO_INFO_HEIGHT (&info), samplingstr);
202 GST_DEBUG_OBJECT (payload, "xinc %d, yinc %d, pgroup %d", xinc, yinc, pgroup);
204 wstr = g_strdup_printf ("%d", GST_VIDEO_INFO_WIDTH (&info));
205 hstr = g_strdup_printf ("%d", GST_VIDEO_INFO_HEIGHT (&info));
207 gst_rtp_base_payload_set_options (payload, "video", TRUE, "RAW", 90000);
208 if (GST_VIDEO_INFO_IS_INTERLACED (&info)) {
209 res = gst_rtp_base_payload_set_outcaps (payload, "sampling", G_TYPE_STRING,
210 samplingstr, "depth", G_TYPE_STRING, depthstr, "width", G_TYPE_STRING,
211 wstr, "height", G_TYPE_STRING, hstr, "colorimetry", G_TYPE_STRING,
212 colorimetrystr, "interlace", G_TYPE_STRING, "true", NULL);
214 res = gst_rtp_base_payload_set_outcaps (payload, "sampling", G_TYPE_STRING,
215 samplingstr, "depth", G_TYPE_STRING, depthstr, "width", G_TYPE_STRING,
216 wstr, "height", G_TYPE_STRING, hstr, "colorimetry", G_TYPE_STRING,
217 colorimetrystr, NULL);
227 GST_ERROR_OBJECT (payload, "could not parse caps");
232 GST_ERROR_OBJECT (payload, "unknown caps format");
238 gst_rtp_vraw_pay_handle_buffer (GstRTPBasePayload * payload, GstBuffer * buffer)
240 GstRtpVRawPay *rtpvrawpay;
241 GstFlowReturn ret = GST_FLOW_OK;
243 guint8 *p0, *yp, *up, *vp;
244 guint ystride, uvstride;
251 GstRTPBuffer rtp = { NULL, };
253 rtpvrawpay = GST_RTP_VRAW_PAY (payload);
255 gst_video_frame_map (&frame, &rtpvrawpay->vinfo, buffer, GST_MAP_READ);
257 GST_LOG_OBJECT (rtpvrawpay, "new frame of %" G_GSIZE_FORMAT " bytes",
258 gst_buffer_get_size (buffer));
260 /* get pointer and strides of the planes */
261 p0 = GST_VIDEO_FRAME_PLANE_DATA (&frame, 0);
262 yp = GST_VIDEO_FRAME_COMP_DATA (&frame, 0);
263 up = GST_VIDEO_FRAME_COMP_DATA (&frame, 1);
264 vp = GST_VIDEO_FRAME_COMP_DATA (&frame, 2);
266 ystride = GST_VIDEO_FRAME_COMP_STRIDE (&frame, 0);
267 uvstride = GST_VIDEO_FRAME_COMP_STRIDE (&frame, 1);
269 mtu = GST_RTP_BASE_PAYLOAD_MTU (payload);
271 /* amount of bytes for one pixel */
272 pgroup = rtpvrawpay->pgroup;
273 width = GST_VIDEO_INFO_WIDTH (&rtpvrawpay->vinfo);
274 height = GST_VIDEO_INFO_HEIGHT (&rtpvrawpay->vinfo);
276 interlaced = GST_VIDEO_INFO_IS_INTERLACED (&rtpvrawpay->vinfo);
278 /* start with line 0, offset 0 */
279 for (field = 0; field < 1 + interlaced; field++) {
283 /* write all lines */
284 while (line < height) {
287 guint8 *outdata, *headers;
289 guint length, cont, pixels;
291 /* get the max allowed payload length size, we try to fill the complete MTU */
292 left = gst_rtp_buffer_calc_payload_len (mtu, 0, 0);
293 out = gst_rtp_buffer_new_allocate (left, 0, 0);
296 GST_BUFFER_TIMESTAMP (out) = GST_BUFFER_TIMESTAMP (buffer);
298 GST_BUFFER_TIMESTAMP (out) = GST_BUFFER_TIMESTAMP (buffer) +
299 GST_BUFFER_DURATION (buffer) / 2;
302 gst_rtp_buffer_map (out, GST_MAP_WRITE, &rtp);
303 outdata = gst_rtp_buffer_get_payload (&rtp);
305 GST_LOG_OBJECT (rtpvrawpay, "created buffer of size %u for MTU %u", left,
310 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
311 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
312 * | Extended Sequence Number | Length |
313 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
314 * |F| Line No |C| Offset |
315 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
316 * | Length |F| Line No |
317 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
319 * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ .
321 * . Two (partial) lines of video data .
323 * +---------------------------------------------------------------+
326 /* need 2 bytes for the extended sequence number */
331 /* the headers start here */
334 /* make sure we can fit at least *one* header and pixel */
335 if (!(left > (6 + pgroup))) {
336 gst_rtp_buffer_unmap (&rtp);
337 gst_buffer_unref (out);
341 /* while we can fit at least one header and one pixel */
342 while (left > (6 + pgroup)) {
343 /* we need a 6 bytes header */
346 /* get how may bytes we need for the remaining pixels */
347 pixels = width - offset;
348 length = (pixels * pgroup) / rtpvrawpay->xinc;
350 if (left >= length) {
351 /* pixels and header fit completely, we will write them and skip to the
355 /* line does not fit completely, see how many pixels fit */
356 pixels = (left / pgroup) * rtpvrawpay->xinc;
357 length = (pixels * pgroup) / rtpvrawpay->xinc;
360 GST_LOG_OBJECT (rtpvrawpay, "filling %u bytes in %u pixels", length,
365 *outdata++ = (length >> 8) & 0xff;
366 *outdata++ = length & 0xff;
369 *outdata++ = ((line >> 8) & 0x7f) | ((field << 7) & 0x80);
370 *outdata++ = line & 0xff;
373 /* go to next line we do this here to make the check below easier */
374 line += rtpvrawpay->yinc;
377 /* calculate continuation marker */
378 cont = (left > (6 + pgroup) && line < height) ? 0x80 : 0x00;
380 /* write offset and continuation marker */
381 *outdata++ = ((offset >> 8) & 0x7f) | cont;
382 *outdata++ = offset & 0xff;
387 GST_LOG_OBJECT (rtpvrawpay, "go to next line %u", line);
390 GST_LOG_OBJECT (rtpvrawpay, "next offset %u", offset);
396 GST_LOG_OBJECT (rtpvrawpay, "consumed %u bytes",
397 (guint) (outdata - headers));
399 /* second pass, read headers and write the data */
403 /* read length and cont */
404 length = (headers[0] << 8) | headers[1];
405 lin = ((headers[2] & 0x7f) << 8) | headers[3];
406 offs = ((headers[4] & 0x7f) << 8) | headers[5];
407 cont = headers[4] & 0x80;
408 pixels = length / pgroup;
411 GST_LOG_OBJECT (payload,
412 "writing length %u, line %u, offset %u, cont %d", length, lin, offs,
415 switch (GST_VIDEO_INFO_FORMAT (&rtpvrawpay->vinfo)) {
416 case GST_VIDEO_FORMAT_RGB:
417 case GST_VIDEO_FORMAT_RGBA:
418 case GST_VIDEO_FORMAT_BGR:
419 case GST_VIDEO_FORMAT_BGRA:
420 case GST_VIDEO_FORMAT_UYVY:
421 case GST_VIDEO_FORMAT_UYVP:
422 offs /= rtpvrawpay->xinc;
423 memcpy (outdata, p0 + (lin * ystride) + (offs * pgroup), length);
426 case GST_VIDEO_FORMAT_AYUV:
431 datap = p0 + (lin * ystride) + (offs * 4);
433 for (i = 0; i < pixels; i++) {
434 *outdata++ = datap[2];
435 *outdata++ = datap[1];
436 *outdata++ = datap[3];
441 case GST_VIDEO_FORMAT_I420:
445 guint8 *yd1p, *yd2p, *udp, *vdp;
447 yd1p = yp + (lin * ystride) + (offs);
448 yd2p = yd1p + ystride;
450 (lin / rtpvrawpay->yinc * uvstride) + (offs / rtpvrawpay->xinc);
454 for (i = 0; i < pixels; i++) {
455 *outdata++ = *yd1p++;
456 *outdata++ = *yd1p++;
457 *outdata++ = *yd2p++;
458 *outdata++ = *yd2p++;
464 case GST_VIDEO_FORMAT_Y41B:
468 guint8 *ydp, *udp, *vdp;
470 ydp = yp + (lin * ystride) + offs;
472 (lin / rtpvrawpay->yinc * uvstride) + (offs / rtpvrawpay->xinc);
476 for (i = 0; i < pixels; i++) {
487 gst_rtp_buffer_unmap (&rtp);
488 gst_buffer_unref (out);
489 goto unknown_sampling;
496 if (line >= height) {
497 GST_LOG_OBJECT (rtpvrawpay, "field/frame complete, set marker");
498 gst_rtp_buffer_set_marker (&rtp, TRUE);
500 gst_rtp_buffer_unmap (&rtp);
502 GST_LOG_OBJECT (rtpvrawpay, "we have %u bytes left", left);
503 gst_buffer_resize (out, 0, gst_buffer_get_size (out) - left);
507 ret = gst_rtp_base_payload_push (payload, out);
512 gst_video_frame_unmap (&frame);
513 gst_buffer_unref (buffer);
520 GST_ELEMENT_ERROR (payload, STREAM, FORMAT,
521 (NULL), ("unimplemented sampling"));
522 gst_video_frame_unmap (&frame);
523 gst_buffer_unref (buffer);
524 return GST_FLOW_NOT_SUPPORTED;
528 GST_ELEMENT_ERROR (payload, RESOURCE, NO_SPACE_LEFT,
529 (NULL), ("not enough space to send at least one pixel"));
530 gst_video_frame_unmap (&frame);
531 gst_buffer_unref (buffer);
532 return GST_FLOW_NOT_SUPPORTED;
537 gst_rtp_vraw_pay_plugin_init (GstPlugin * plugin)
539 return gst_element_register (plugin, "rtpvrawpay",
540 GST_RANK_SECONDARY, GST_TYPE_RTP_VRAW_PAY);