2 * Copyright (C) 2007 Haakon Sporsheim <hakon.sporsheim@tandberg.com>
3 * 2008 Ole André Vadla Ravnås <ole.andre.ravnas@tandberg.com>
4 * 2009 Knut Inge Hvidsten <knut.inge.hvidsten@tandberg.com>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Library General Public
8 * License as published by the Free Software Foundation; either
9 * version 2 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Library General Public License for more details.
16 * You should have received a copy of the GNU Library General Public
17 * License along with this library; if not, write to the
18 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
19 * Boston, MA 02110-1301, USA.
22 #include "ksvideohelpers.h"
26 #include "kshelpers.h"
28 GST_DEBUG_CATEGORY_EXTERN (gst_ks_debug);
29 #define GST_CAT_DEFAULT gst_ks_debug
31 static const GUID MEDIASUBTYPE_FOURCC =
32 { 0x0 /* FourCC here */ , 0x0000, 0x0010, {0x80, 0x00, 0x00, 0xAA, 0x00,
36 typedef struct _KsVideoDeviceEntry KsVideoDeviceEntry;
38 struct _KsVideoDeviceEntry
40 KsDeviceEntry *device;
45 ks_video_device_entry_decide_priority (KsVideoDeviceEntry * videodevice)
49 videodevice->priority = 0;
51 filter_handle = CreateFile (videodevice->device->path,
52 GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING,
53 FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED, NULL);
54 if (ks_is_valid_handle (filter_handle)) {
55 GUID *propsets = NULL;
58 if (ks_object_get_supported_property_sets (filter_handle, &propsets,
62 for (i = 0; i < propsets_len; i++) {
63 if (memcmp (&propsets[i], &PROPSETID_VIDCAP_CAMERACONTROL,
64 sizeof (GUID)) == 0) {
65 videodevice->priority++;
74 CloseHandle (filter_handle);
78 ks_video_device_entry_compare (gconstpointer a, gconstpointer b)
80 const KsVideoDeviceEntry *videodevice_a = a;
81 const KsVideoDeviceEntry *videodevice_b = b;
83 if (videodevice_a->priority > videodevice_b->priority)
85 else if (videodevice_a->priority == videodevice_b->priority)
92 ks_video_device_list_sort_cameras_first (GList * devices)
94 GList *videodevices = NULL, *walk;
97 for (walk = devices; walk != NULL; walk = walk->next) {
98 KsDeviceEntry *device = walk->data;
99 KsVideoDeviceEntry *videodevice;
101 videodevice = g_new (KsVideoDeviceEntry, 1);
102 videodevice->device = device;
103 ks_video_device_entry_decide_priority (videodevice);
105 videodevices = g_list_append (videodevices, videodevice);
108 videodevices = g_list_sort (videodevices, ks_video_device_entry_compare);
110 g_list_free (devices);
113 for (walk = videodevices, i = 0; walk != NULL; walk = walk->next, i++) {
114 KsVideoDeviceEntry *videodevice = walk->data;
116 videodevice->device->index = i;
117 devices = g_list_append (devices, videodevice->device);
119 g_free (videodevice);
122 g_list_free (videodevices);
127 static GstStructure *
128 ks_video_format_to_structure (GUID subtype_guid, GUID format_guid)
130 GstStructure *structure = NULL;
131 const gchar *media_type = NULL, *format = NULL;
133 if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_MJPG) || IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_TVMJ) || /* FIXME: NOT tested */
134 IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_WAKE) || /* FIXME: NOT tested */
135 IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_CFCC) || /* FIXME: NOT tested */
136 IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_IJPG)) { /* FIXME: NOT tested */
137 media_type = "image/jpeg";
138 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_RGB555)) {
139 media_type = "video/x-raw";
141 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_RGB565)) {
142 media_type = "video/x-raw";
144 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_RGB24)) {
145 media_type = "video/x-raw";
147 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_RGB32)) {
148 media_type = "video/x-raw";
150 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_ARGB32)) {
151 media_type = "video/x-raw";
153 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_ARGB1555)) {
154 GST_WARNING ("Unsupported video format ARGB15555");
155 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_ARGB4444)) {
156 GST_WARNING ("Unsupported video format ARGB4444");
157 } else if (memcmp (&subtype_guid.Data2, &MEDIASUBTYPE_FOURCC.Data2,
158 sizeof (subtype_guid) - sizeof (subtype_guid.Data1)) == 0) {
159 guint8 *p = (guint8 *) & subtype_guid.Data1;
160 gchar *format = g_strdup_printf ("%c%c%c%c", p[0], p[1], p[2], p[3]);
161 structure = gst_structure_new ("video/x-raw", "format",
162 G_TYPE_STRING, format, NULL);
164 } else if (IsEqualGUID (&subtype_guid, &MEDIASUBTYPE_dvsd)) {
165 if (IsEqualGUID (&format_guid, &FORMAT_DvInfo)) {
166 structure = gst_structure_new ("video/x-dv",
167 "systemstream", G_TYPE_BOOLEAN, TRUE, NULL);
168 } else if (IsEqualGUID (&format_guid, &FORMAT_VideoInfo)) {
169 structure = gst_structure_new ("video/x-dv",
170 "systemstream", G_TYPE_BOOLEAN, FALSE,
171 "format", G_TYPE_STRING, "dvsd", NULL);
176 structure = gst_structure_new_empty (media_type);
178 gst_structure_set (structure, "format", G_TYPE_STRING, format, NULL);
183 GST_DEBUG ("Unknown DirectShow Video GUID "
184 "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x",
185 subtype_guid.Data1, subtype_guid.Data2, subtype_guid.Data3,
186 subtype_guid.Data4[0], subtype_guid.Data4[1], subtype_guid.Data4[2],
187 subtype_guid.Data4[3], subtype_guid.Data4[4], subtype_guid.Data4[5],
188 subtype_guid.Data4[6], subtype_guid.Data4[7]);
195 guess_aspect (gint width, gint height, gint * par_width, gint * par_height)
198 * As we dont have access to the actual pixel aspect, we will try to do a
199 * best-effort guess. The guess is based on most sensors being either 4/3
200 * or 16/9, and most pixel aspects being close to 1/1.
202 if ((width == 768) && (height == 448)) { /* special case for w448p */
206 if (((float) width / (float) height) < 1.2778) {
216 /* NOTE: would probably be better to use a continued fractions approach here */
218 compress_fraction (gint64 in_num, gint64 in_den, gint64 * out_num,
221 gdouble on, od, orig;
222 guint denominators[] = { 1, 2, 3, 5, 7 }, i;
223 const gdouble max_loss = 0.1;
229 for (i = 0; i < G_N_ELEMENTS (denominators); i++) {
233 cur_n = floor ((on / (od / (gdouble) denominators[i])) + 0.5);
234 cur_d = denominators[i];
235 cur = (gdouble) cur_n / (gdouble) cur_d;
236 loss = fabs (cur - orig);
238 if (loss <= max_loss) {
251 ks_video_append_video_stream_cfg_fields (GstStructure * structure,
252 const KS_VIDEO_STREAM_CONFIG_CAPS * vscc)
258 g_return_val_if_fail (structure, FALSE);
259 g_return_val_if_fail (vscc, FALSE);
262 if (vscc->MinOutputSize.cx == vscc->MaxOutputSize.cx) {
263 gst_structure_set (structure,
264 "width", G_TYPE_INT, vscc->MaxOutputSize.cx, NULL);
266 gst_structure_set (structure,
267 "width", GST_TYPE_INT_RANGE,
268 vscc->MinOutputSize.cx, vscc->MaxOutputSize.cx, NULL);
272 if (vscc->MinOutputSize.cy == vscc->MaxOutputSize.cy) {
273 gst_structure_set (structure,
274 "height", G_TYPE_INT, vscc->MaxOutputSize.cy, NULL);
276 gst_structure_set (structure,
277 "height", GST_TYPE_INT_RANGE,
278 vscc->MinOutputSize.cy, vscc->MaxOutputSize.cy, NULL);
282 compress_fraction (NANOSECONDS, vscc->MinFrameInterval, &min_n, &min_d);
283 compress_fraction (NANOSECONDS, vscc->MaxFrameInterval, &max_n, &max_d);
285 if (min_n == max_n && min_d == max_d) {
286 g_value_init (&val, GST_TYPE_FRACTION);
287 gst_value_set_fraction (&val, max_n, max_d);
289 g_value_init (&val, GST_TYPE_FRACTION_RANGE);
290 gst_value_set_fraction_range_full (&val, max_n, max_d, min_n, min_d);
293 gst_structure_set_value (structure, "framerate", &val);
294 g_value_unset (&val);
297 gint par_width, par_height;
299 guess_aspect (vscc->MaxOutputSize.cx, vscc->MaxOutputSize.cy,
300 &par_width, &par_height);
302 gst_structure_set (structure,
303 "pixel-aspect-ratio", GST_TYPE_FRACTION, par_width, par_height, NULL);
310 ks_video_media_type_dup (KsVideoMediaType * media_type)
312 KsVideoMediaType *result = g_new (KsVideoMediaType, 1);
314 memcpy (result, media_type, sizeof (KsVideoMediaType));
316 result->range = g_malloc (media_type->range->FormatSize);
317 memcpy ((gpointer) result->range, media_type->range,
318 media_type->range->FormatSize);
320 result->format = g_malloc (media_type->format_size);
321 memcpy (result->format, media_type->format, media_type->format_size);
323 result->translated_caps = gst_caps_ref (media_type->translated_caps);
329 ks_video_media_type_free (KsVideoMediaType * media_type)
331 if (media_type == NULL)
334 g_free ((gpointer) media_type->range);
336 g_free (media_type->format);
338 if (media_type->translated_caps != NULL)
339 gst_caps_unref (media_type->translated_caps);
345 ks_video_media_type_list_remove_duplicates (GList * media_types)
347 GList *master, *duplicates;
352 master = duplicates = NULL;
354 /* Find the first set of duplicates and their master */
355 for (entry = media_types; entry != NULL && duplicates == NULL;
356 entry = entry->next) {
357 KsVideoMediaType *mt = entry->data;
360 for (other_entry = media_types; other_entry != NULL;
361 other_entry = other_entry->next) {
362 KsVideoMediaType *other_mt = other_entry->data;
367 if (gst_caps_is_equal (mt->translated_caps, other_mt->translated_caps))
368 duplicates = g_list_prepend (duplicates, other_mt);
371 if (duplicates != NULL)
375 if (duplicates != NULL) {
376 KsVideoMediaType *selected_mt = master->data;
379 * Pick a FORMAT_VideoInfo2 if present, if not we just stay with the
382 for (entry = duplicates; entry != NULL; entry = entry->next) {
383 KsVideoMediaType *mt = entry->data;
385 if (IsEqualGUID (&mt->range->Specifier, &FORMAT_VideoInfo2)) {
386 ks_video_media_type_free (selected_mt);
389 ks_video_media_type_free (mt);
392 /* Remove the dupe from the main list */
393 media_types = g_list_remove (media_types, mt);
396 /* Update master node with the selected MediaType */
397 master->data = selected_mt;
399 g_list_free (duplicates);
402 while (master != NULL);
408 ks_video_probe_filter_for_caps (HANDLE filter_handle)
414 if (!ks_filter_get_pin_property (filter_handle, 0, KSPROPSETID_Pin,
415 KSPROPERTY_PIN_CTYPES, &pin_count, sizeof (pin_count), NULL))
418 GST_DEBUG ("pin_count = %lu", pin_count);
420 for (pin_id = 0; pin_id < pin_count; pin_id++) {
421 KSPIN_COMMUNICATION pin_comm;
422 KSPIN_DATAFLOW pin_flow;
425 if (!ks_filter_get_pin_property (filter_handle, pin_id, KSPROPSETID_Pin,
426 KSPROPERTY_PIN_COMMUNICATION, &pin_comm, sizeof (pin_comm), NULL))
429 if (!ks_filter_get_pin_property (filter_handle, pin_id, KSPROPSETID_Pin,
430 KSPROPERTY_PIN_DATAFLOW, &pin_flow, sizeof (pin_flow), NULL))
433 if (!ks_filter_get_pin_property (filter_handle, pin_id, KSPROPSETID_Pin,
434 KSPROPERTY_PIN_CATEGORY, &pin_cat, sizeof (pin_cat), NULL))
437 GST_DEBUG ("pin[%u]: pin_comm=%d, pin_flow=%d", pin_id, pin_comm, pin_flow);
439 if (pin_flow == KSPIN_DATAFLOW_OUT &&
440 memcmp (&pin_cat, &PINNAME_CAPTURE, sizeof (GUID)) == 0) {
441 KSMULTIPLE_ITEM *items;
443 if (ks_filter_get_pin_property_multi (filter_handle, pin_id,
444 KSPROPSETID_Pin, KSPROPERTY_PIN_DATARANGES, &items, NULL)) {
445 KSDATARANGE *range = (KSDATARANGE *) (items + 1);
448 for (i = 0; i < items->Count; i++) {
449 if (IsEqualGUID (&range->MajorFormat, &KSDATAFORMAT_TYPE_VIDEO)) {
450 KsVideoMediaType *entry;
451 gpointer src_vscc, src_format;
452 GstStructure *media_structure;
454 entry = g_new0 (KsVideoMediaType, 1);
455 entry->pin_id = pin_id;
457 entry->range = g_malloc (range->FormatSize);
458 memcpy ((gpointer) entry->range, range, range->FormatSize);
460 if (IsEqualGUID (&range->Specifier, &FORMAT_VideoInfo)) {
461 KS_DATARANGE_VIDEO *vr = (KS_DATARANGE_VIDEO *) entry->range;
463 src_vscc = &vr->ConfigCaps;
464 src_format = &vr->VideoInfoHeader;
466 entry->format_size = sizeof (vr->VideoInfoHeader);
467 entry->sample_size = vr->VideoInfoHeader.bmiHeader.biSizeImage;
468 } else if (IsEqualGUID (&range->Specifier, &FORMAT_VideoInfo2)) {
469 KS_DATARANGE_VIDEO2 *vr = (KS_DATARANGE_VIDEO2 *) entry->range;
471 src_vscc = &vr->ConfigCaps;
472 src_format = &vr->VideoInfoHeader;
474 entry->format_size = sizeof (vr->VideoInfoHeader);
475 entry->sample_size = vr->VideoInfoHeader.bmiHeader.biSizeImage;
476 } else if (IsEqualGUID (&range->Specifier, &FORMAT_MPEGVideo)) {
477 /* Untested and probably wrong... */
478 KS_DATARANGE_MPEG1_VIDEO *vr =
479 (KS_DATARANGE_MPEG1_VIDEO *) entry->range;
481 src_vscc = &vr->ConfigCaps;
482 src_format = &vr->VideoInfoHeader;
484 entry->format_size = sizeof (vr->VideoInfoHeader);
486 vr->VideoInfoHeader.hdr.bmiHeader.biSizeImage;
487 } else if (IsEqualGUID (&range->Specifier, &FORMAT_MPEG2Video)) {
488 /* Untested and probably wrong... */
489 KS_DATARANGE_MPEG2_VIDEO *vr =
490 (KS_DATARANGE_MPEG2_VIDEO *) entry->range;
492 src_vscc = &vr->ConfigCaps;
493 src_format = &vr->VideoInfoHeader;
495 entry->format_size = sizeof (vr->VideoInfoHeader);
497 vr->VideoInfoHeader.hdr.bmiHeader.biSizeImage;
501 guid_str = ks_guid_to_string (&range->Specifier);
502 GST_DEBUG ("pin[%u]: ignoring unknown specifier GUID %s",
506 ks_video_media_type_free (entry);
511 g_assert (entry->sample_size != 0);
513 memcpy ((gpointer) & entry->vscc, src_vscc, sizeof (entry->vscc));
515 entry->format = g_malloc (entry->format_size);
516 memcpy (entry->format, src_format, entry->format_size);
519 ks_video_format_to_structure (range->SubFormat,
522 if (media_structure == NULL) {
523 g_warning ("ks_video_format_to_structure returned NULL");
524 ks_video_media_type_free (entry);
526 } else if (ks_video_append_video_stream_cfg_fields
527 (media_structure, &entry->vscc)) {
528 entry->translated_caps = gst_caps_new_empty ();
529 gst_caps_append_structure (entry->translated_caps,
532 gst_structure_free (media_structure);
533 ks_video_media_type_free (entry);
538 ret = g_list_prepend (ret, entry);
542 /* REVISIT: Each KSDATARANGE should start on a 64-bit boundary */
543 range = (KSDATARANGE *) (((guchar *) range) + range->FormatSize);
552 ret = g_list_reverse (ret);
553 ret = ks_video_media_type_list_remove_duplicates (ret);
561 ks_video_create_pin_conn_from_media_type (KsVideoMediaType * media_type)
563 KSPIN_CONNECT *conn = NULL;
564 KSDATAFORMAT *format = NULL;
567 conn = g_malloc0 (sizeof (KSPIN_CONNECT) + sizeof (KSDATAFORMAT) +
568 media_type->format_size);
570 conn->Interface.Set = KSINTERFACESETID_Standard;
571 conn->Interface.Id = KSINTERFACE_STANDARD_STREAMING;
572 conn->Interface.Flags = 0;
574 conn->Medium.Set = KSMEDIUMSETID_Standard;
575 conn->Medium.Id = KSMEDIUM_TYPE_ANYINSTANCE;
576 conn->Medium.Flags = 0;
578 conn->PinId = media_type->pin_id;
579 conn->PinToHandle = NULL;
580 conn->Priority.PriorityClass = KSPRIORITY_NORMAL;
581 conn->Priority.PrioritySubClass = KSPRIORITY_NORMAL;
583 format = (KSDATAFORMAT *) (conn + 1);
584 memcpy (format, media_type->range, sizeof (KSDATAFORMAT));
585 format->FormatSize = sizeof (KSDATAFORMAT) + media_type->format_size;
587 vih = (guint8 *) (format + 1);
588 memcpy (vih, media_type->format, media_type->format_size);
594 ks_video_fixate_media_type (const KSDATARANGE * range,
595 guint8 * format, gint width, gint height, gint fps_n, gint fps_d)
597 KS_DATARANGE_VIDEO *vr;
598 KS_VIDEOINFOHEADER *vih;
599 KS_BITMAPINFOHEADER *bih;
602 g_return_val_if_fail (format != NULL, FALSE);
604 if (IsEqualGUID (&range->Specifier, &FORMAT_VideoInfo)) {
605 bih = &((KS_VIDEOINFOHEADER *) format)->bmiHeader;
606 } else if (IsEqualGUID (&range->Specifier, &FORMAT_VideoInfo2)) {
607 bih = &((KS_VIDEOINFOHEADER2 *) format)->bmiHeader;
608 } else if (IsEqualGUID (&range->Specifier, &FORMAT_MPEGVideo)) {
609 bih = &((KS_MPEG1VIDEOINFO *) format)->hdr.bmiHeader;
610 } else if (IsEqualGUID (&range->Specifier, &FORMAT_MPEG2Video)) {
611 bih = &((KS_MPEGVIDEOINFO2 *) format)->hdr.bmiHeader;
616 /* These formats' structures share the most basic stuff */
617 vr = (KS_DATARANGE_VIDEO *) range;
618 vih = (KS_VIDEOINFOHEADER *) format;
620 /* FIXME: Need to figure out how to properly handle ranges */
621 if (bih->biWidth != width || bih->biHeight != height)
624 /* Framerate, clamped because of fraction conversion rounding errors */
625 vih->AvgTimePerFrame =
626 gst_util_uint64_scale_int_round (NANOSECONDS, fps_d, fps_n);
627 vih->AvgTimePerFrame =
628 MAX (vih->AvgTimePerFrame, vr->ConfigCaps.MinFrameInterval);
629 vih->AvgTimePerFrame =
630 MIN (vih->AvgTimePerFrame, vr->ConfigCaps.MaxFrameInterval);
632 /* Bitrate, clamped for the same reason as framerate */
633 dwRate = (width * height * fps_n) / fps_d;
634 vih->dwBitRate = dwRate * bih->biBitCount;
635 vih->dwBitRate = MAX (vih->dwBitRate, vr->ConfigCaps.MinBitsPerSecond);
636 vih->dwBitRate = MIN (vih->dwBitRate, vr->ConfigCaps.MaxBitsPerSecond);
641 static GstStructure *
642 ks_video_append_var_video_fields (GstStructure * structure)
645 gst_structure_set (structure,
646 "width", GST_TYPE_INT_RANGE, 1, G_MAXINT,
647 "height", GST_TYPE_INT_RANGE, 1, G_MAXINT,
648 "framerate", GST_TYPE_FRACTION_RANGE, 0, 1, G_MAXINT, 1, NULL);
655 ks_video_get_all_caps (void)
657 static GstCaps *caps = NULL;
660 GstStructure *structure;
661 caps = gst_caps_new_empty ();
663 /* from Windows SDK 6.0 uuids.h */
666 ks_video_append_var_video_fields (ks_video_format_to_structure
667 (MEDIASUBTYPE_RGB555, FORMAT_VideoInfo));
668 gst_caps_append_structure (caps, structure);
671 ks_video_append_var_video_fields (ks_video_format_to_structure
672 (MEDIASUBTYPE_RGB565, FORMAT_VideoInfo));
673 gst_caps_append_structure (caps, structure);
676 ks_video_append_var_video_fields (ks_video_format_to_structure
677 (MEDIASUBTYPE_RGB24, FORMAT_VideoInfo));
678 gst_caps_append_structure (caps, structure);
681 ks_video_append_var_video_fields (ks_video_format_to_structure
682 (MEDIASUBTYPE_RGB32, FORMAT_VideoInfo));
683 gst_caps_append_structure (caps, structure);
687 ks_video_append_var_video_fields (gst_structure_new_empty
689 gst_caps_append_structure (caps, structure);
693 ks_video_append_var_video_fields (ks_video_format_to_structure
694 (MEDIASUBTYPE_MJPG, FORMAT_VideoInfo));
695 gst_caps_append_structure (caps, structure);
698 ks_video_append_var_video_fields (ks_video_format_to_structure
699 (MEDIASUBTYPE_dvsd, FORMAT_VideoInfo));
700 gst_caps_append_structure (caps, structure);
702 structure = /* no variable video fields (width, height, framerate) */
703 ks_video_format_to_structure (MEDIASUBTYPE_dvsd, FORMAT_DvInfo);
704 gst_caps_append_structure (caps, structure);