gstreamer/gst/accurip/gstaccurip.c
2021-04-11 16:16:55 +00:00

378 lines
11 KiB
C

/* GStreamer AccurateRip (TM) audio checksumming element
*
* Copyright (C) 2012 Christophe Fergeau <teuf@gnome.org>
*
* Based on the GStreamer chromaprint audio fingerprinting element
* Copyright (C) 2006 M. Derezynski
* Copyright (C) 2008 Eric Buehl
* Copyright (C) 2008 Sebastian Dröge <slomo@circular-chaos.org>
* Copyright (C) 2011 Lukáš Lalinský <lalinsky@gmail.com>
* Copyright (C) 2012 Collabora Ltd. <tim.muller@collabora.co.uk>
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
/*
* Based on the documentation from
* http://forum.dbpoweramp.com/showthread.php?20641-AccurateRip-CRC-Calculation
* and
* http://jonls.dk/2009/10/calculating-accuraterip-checksums/
*/
/**
* SECTION:element-accurip
* @title: accurip
* @short_desc: Computes an AccurateRip CRC
*
* The accurip element calculates a CRC for an audio stream which can be used
* to match the audio stream to a database hosted on
* [AccurateRip](http://accuraterip.com/). This database is used to check for a
* CD rip accuracy.
*
* ## Example launch line
* |[
* gst-launch-1.0 -m uridecodebin uri=file:///path/to/song.flac ! audioconvert ! accurip ! fakesink
* ]|
*
*/
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include "gstaccurip.h"
#define DEFAULT_MAX_DURATION 120
#define PAD_CAPS \
"audio/x-raw, " \
"format = (string) " GST_AUDIO_NE(S16) ", "\
"rate = (int) 44100, " \
"channels = (int) 2"
GST_DEBUG_CATEGORY_STATIC (gst_accurip_debug);
#define GST_CAT_DEFAULT gst_accurip_debug
enum
{
PROP_0,
PROP_FIRST_TRACK,
PROP_LAST_TRACK
};
static void gst_accurip_finalize (GObject * object);
static void gst_accurip_set_property (GObject * object, guint prop_id,
const GValue * value, GParamSpec * pspec);
static void gst_accurip_get_property (GObject * object, guint prop_id,
GValue * value, GParamSpec * pspec);
static GstFlowReturn gst_accurip_transform_ip (GstBaseTransform * trans,
GstBuffer * buf);
static gboolean gst_accurip_sink_event (GstBaseTransform * trans,
GstEvent * event);
static gboolean accurip_element_init (GstPlugin * plugin);
#define parent_class gst_accurip_parent_class
G_DEFINE_TYPE (GstAccurip, gst_accurip, GST_TYPE_AUDIO_FILTER);
GST_ELEMENT_REGISTER_DEFINE_CUSTOM (accurip, accurip_element_init);
static void
gst_accurip_class_init (GstAccuripClass * klass)
{
GObjectClass *gobject_class;
GstBaseTransformClass *gstbasetrans_class;
GstCaps *caps;
gobject_class = G_OBJECT_CLASS (klass);
gstbasetrans_class = GST_BASE_TRANSFORM_CLASS (klass);
gobject_class->set_property = gst_accurip_set_property;
gobject_class->get_property = gst_accurip_get_property;
g_object_class_install_property (gobject_class, PROP_FIRST_TRACK,
g_param_spec_boolean ("first-track", "First track",
"Indicate to the CRC calculation algorithm that this is the first track of a set",
FALSE, G_PARAM_READWRITE));
g_object_class_install_property (gobject_class, PROP_LAST_TRACK,
g_param_spec_boolean ("last-track", "Last track",
"Indicate to the CRC calculation algorithm that this is the last track of a set",
FALSE, G_PARAM_READWRITE));
gobject_class->finalize = GST_DEBUG_FUNCPTR (gst_accurip_finalize);
gstbasetrans_class->transform_ip =
GST_DEBUG_FUNCPTR (gst_accurip_transform_ip);
gstbasetrans_class->sink_event = GST_DEBUG_FUNCPTR (gst_accurip_sink_event);
gstbasetrans_class->passthrough_on_same_caps = TRUE;
gst_element_class_set_metadata (GST_ELEMENT_CLASS (klass),
"AccurateRip(TM) CRC element",
"Filter/Analyzer/Audio",
"Computes an AccurateRip CRC", "Christophe Fergeau <teuf@gnome.org>");
caps = gst_caps_from_string (PAD_CAPS);
gst_audio_filter_class_add_pad_templates (GST_AUDIO_FILTER_CLASS (klass),
caps);
gst_caps_unref (caps);
}
static void
ring_free (GstAccurip * accurip)
{
g_free (accurip->crcs_ring);
g_free (accurip->crcs_v2_ring);
accurip->crcs_ring = NULL;
accurip->crcs_v2_ring = NULL;
accurip->ring_samples = 0;
}
static void
gst_accurip_reset (GstAccurip * accurip)
{
if (accurip->num_samples != 0) {
/* Don't reset these values on the NEW_SEGMENT event we get when
* the pipeline starts playing, they may have been set by the
* element user while creating the pipeline
*/
accurip->is_first = FALSE;
accurip->is_last = FALSE;
ring_free (accurip);
}
accurip->crc = 0;
accurip->crc_v2 = 0;
accurip->num_samples = 0;
}
/* We must ignore the first and last 5 CD sectors. A CD sector is worth
* 2352 bytes of audio */
#define IGNORED_SAMPLES_COUNT (2352 * 5 / (2*2))
static void
gst_accurip_emit_tags (GstAccurip * accurip)
{
GstTagList *tags;
if (accurip->num_samples == 0)
return;
if (accurip->is_last) {
guint index;
if (accurip->ring_samples <= IGNORED_SAMPLES_COUNT) {
return;
}
index = accurip->ring_samples - IGNORED_SAMPLES_COUNT;
index %= (IGNORED_SAMPLES_COUNT + 1);
accurip->crc = accurip->crcs_ring[index];
accurip->crc_v2 = accurip->crcs_v2_ring[index];
}
GST_DEBUG_OBJECT (accurip,
"Generating CRC based on %" G_GUINT64_FORMAT " samples",
accurip->num_samples);
tags = gst_tag_list_new (GST_TAG_ACCURIP_CRC, accurip->crc,
GST_TAG_ACCURIP_CRC_V2, accurip->crc_v2, NULL);
GST_DEBUG_OBJECT (accurip, "Computed CRC=%08X and CRCv2=0x%08X",
accurip->crc, accurip->crc_v2);
gst_pad_push_event (GST_BASE_TRANSFORM_SRC_PAD (accurip),
gst_event_new_tag (tags));
}
static void
gst_accurip_init (GstAccurip * accurip)
{
gst_base_transform_set_passthrough (GST_BASE_TRANSFORM (accurip), TRUE);
}
static void
gst_accurip_finalize (GObject * object)
{
ring_free (GST_ACCURIP (object));
G_OBJECT_CLASS (parent_class)->finalize (object);
}
static GstFlowReturn
gst_accurip_transform_ip (GstBaseTransform * trans, GstBuffer * buf)
{
GstAccurip *accurip = GST_ACCURIP (trans);
GstAudioFilter *filter = GST_AUDIO_FILTER (trans);
guint32 *data;
GstMapInfo map_info;
guint nsamples;
gint channels;
guint i;
channels = GST_AUDIO_INFO_CHANNELS (&filter->info);
if (G_UNLIKELY (channels != 2))
return GST_FLOW_NOT_NEGOTIATED;
if (!gst_buffer_map (buf, &map_info, GST_MAP_READ))
return GST_FLOW_ERROR;
data = (guint32 *) map_info.data;
nsamples = map_info.size / (channels * 2);
for (i = 0; i < nsamples; i++) {
guint64 mult_sample;
/* the AccurateRip algorithm counts samples starting from 1 instead
* of 0, that's why we start by incrementing the number of samples
* before doing the calculations
*/
accurip->num_samples++;
/* On the first track, we have to ignore the first 5 CD sectors of
* audio data
*/
if (accurip->is_first && accurip->num_samples < IGNORED_SAMPLES_COUNT)
continue;
/* Actual CRC computation is here */
mult_sample = data[i] * accurip->num_samples;
accurip->crc += mult_sample;
accurip->crc_v2 += mult_sample & 0xffffffff;
accurip->crc_v2 += (mult_sample >> 32);
/* On the last track, we've got to ignore the last 5 CD sectors of
* audio data, since we cannot know in advance when the last buffer
* will be, we keep 5 CD sectors samples + 1 in memory so that we
* can rollback to the 'good' value when we reach the end of stream.
* This magic is only needed when the 'track-last' property is set.
*/
if (accurip->is_last) {
guint index = accurip->ring_samples % (IGNORED_SAMPLES_COUNT + 1);
accurip->ring_samples++;
accurip->crcs_ring[index] = accurip->crc;
accurip->crcs_v2_ring[index] = accurip->crc_v2;
}
}
gst_buffer_unmap (buf, &map_info);
return GST_FLOW_OK;
}
static gboolean
gst_accurip_sink_event (GstBaseTransform * trans, GstEvent * event)
{
GstAccurip *accurip = GST_ACCURIP (trans);
switch (GST_EVENT_TYPE (event)) {
case GST_EVENT_FLUSH_STOP:
case GST_EVENT_SEGMENT:
GST_DEBUG_OBJECT (trans, "Got %s event, clearing buffer",
GST_EVENT_TYPE_NAME (event));
gst_accurip_emit_tags (accurip);
gst_accurip_reset (accurip);
break;
case GST_EVENT_EOS:
gst_accurip_emit_tags (accurip);
break;
default:
break;
}
return GST_BASE_TRANSFORM_CLASS (parent_class)->sink_event (trans, event);
}
static void
gst_accurip_set_property (GObject * object, guint prop_id,
const GValue * value, GParamSpec * pspec)
{
GstAccurip *accurip = GST_ACCURIP (object);
switch (prop_id) {
case PROP_FIRST_TRACK:
accurip->is_first = g_value_get_boolean (value);
break;
case PROP_LAST_TRACK:
if (accurip->is_last != g_value_get_boolean (value)) {
ring_free (accurip);
}
accurip->is_last = g_value_get_boolean (value);
if (accurip->is_last) {
if (accurip->crcs_ring == NULL) {
accurip->crcs_ring = g_new0 (guint32, IGNORED_SAMPLES_COUNT + 1);
}
if (accurip->crcs_v2_ring == NULL) {
accurip->crcs_v2_ring = g_new0 (guint32, IGNORED_SAMPLES_COUNT + 1);
}
}
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
static void
gst_accurip_get_property (GObject * object, guint prop_id,
GValue * value, GParamSpec * pspec)
{
GstAccurip *accurip = GST_ACCURIP (object);
switch (prop_id) {
case PROP_FIRST_TRACK:
g_value_set_boolean (value, accurip->is_first);
break;
case PROP_LAST_TRACK:
g_value_set_boolean (value, accurip->is_last);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
}
}
static gboolean
accurip_element_init (GstPlugin * plugin)
{
gboolean ret;
GST_DEBUG_CATEGORY_INIT (gst_accurip_debug, "accurip", 0, "accurip element");
ret = gst_element_register (plugin, "accurip", GST_RANK_NONE,
GST_TYPE_ACCURIP);
if (ret) {
gst_tag_register (GST_TAG_ACCURIP_CRC, GST_TAG_FLAG_META,
G_TYPE_UINT, "accurip crc", "AccurateRip(TM) CRC", NULL);
gst_tag_register (GST_TAG_ACCURIP_CRC_V2, GST_TAG_FLAG_META,
G_TYPE_UINT, "accurip crc (v2)", "AccurateRip(TM) CRC (version 2)",
NULL);
}
return ret;
}
static gboolean
plugin_init (GstPlugin * plugin)
{
return GST_ELEMENT_REGISTER (accurip, plugin);
}
GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
GST_VERSION_MINOR,
accurip,
"Computes an AccurateRip CRC",
plugin_init, VERSION, "LGPL", GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN)