@lumen5/beamcoder 0.0.1

package/src/packet.h

@@ -0,0 +1,49 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+#ifndef PACKET_H
+#define PACKET_H
+
+#include "node_api.h"
+#include "beamcoder_util.h"
+
+extern "C" {
+  #include <libavcodec/avcodec.h>
+}
+
+void packetFinalizer(napi_env env, void* data, void* hint);
+void packetDataFinalizer(napi_env env, void* data, void* hint);
+void packetBufferFinalizer(napi_env env, void* data, void* hint);
+void packetBufferFree(void* opaque, uint8_t* data);
+
+struct packetData {
+  AVPacket* packet = nullptr;
+  napi_ref dataRef = nullptr;
+  int32_t extSize = 0;
+  ~packetData() {
+    av_packet_free(&packet);
+  }
+};
+
+napi_value makePacket(napi_env env, napi_callback_info info);
+napi_status fromAVPacket(napi_env env, packetData* packet, napi_value* result);
+
+#endif // PACKET_H

package/test/codecParamsSpec.js

@@ -0,0 +1,148 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+const test = require('tape');
+const beamcoder = require('../index.js');
+
+test('Creating codec parameters', t => {
+  let cps = beamcoder.codecParameters();
+  t.ok(cps, 'is truthy.');
+  t.equal(cps.name, 'none', 'has no name.');
+  t.equal(cps.codec_type, 'data', 'has data type.');
+  t.equal(cps.codec_id, 0, 'zero coded id.');
+  cps = beamcoder.codecParameters({ name: 'aac' });
+  t.equal(cps.name, 'aac', 'has expected name aac.');
+  t.equal(cps.codec_type, 'audio', 'has expected type.');
+  t.equal(cps.codec_id, 86018, 'zero coded id.');
+  cps = beamcoder.codecParameters({ name: 'h264', width: 1920 });
+  t.equal(cps.width, 1920, 'constructor parameter set ok.');
+  t.end();
+});
+
+test('Minimal JSON serialization', t => {
+  let cp = beamcoder.codecParameters();
+  let cps = JSON.stringify(cp);
+  t.equal(typeof cps, 'string', 'stringify creates a string.');
+  let cpj = JSON.parse(cps);
+  t.deepEqual(cpj, { type: 'CodecParameters', codec_type: 'data',
+    codec_id: 0, name: 'none'}, 'is minimal.');
+  let rcp = beamcoder.codecParameters(cps);
+  t.ok(rcp, 'roundtrip parameters are truthy.');
+  t.deepEqual(rcp, { type: 'CodecParameters',
+    codec_type: 'data',
+    codec_id: 0,
+    name: 'none',
+    codec_tag: 0,
+    extradata: null,
+    format: null,
+    bit_rate: 0,
+    bits_per_coded_sample: 0,
+    bits_per_raw_sample: 0,
+    profile: -99,
+    level: -99,
+    width: 0,
+    height: 0,
+    sample_aspect_ratio: [ 0, 1 ],
+    field_order: 'unknown',
+    color_range: 'unknown',
+    color_primaries: 'unknown',
+    color_trc: 'unknown',
+    color_space: 'unknown',
+    chroma_location: 'unspecified',
+    video_delay: 0,
+    channel_layout: '0 channels',
+    channels: 0,
+    sample_rate: 0,
+    block_align: 0,
+    frame_size: 0,
+    initial_padding: 0,
+    trailing_padding: 0,
+    seek_preroll: 0 }, 'has expected value.');
+  t.end();
+});
+
+test('Maximal JSON serialization', t=> {
+  let cp = beamcoder.codecParameters({
+    codec_type: 'video',
+    codec_id: 27,
+    codec_tag: 'avc1',
+    name: 'h264',
+    extradata: Buffer.from('wibble'),
+    format: 'yuv422p',
+    bit_rate: 12345,
+    bits_per_coded_sample: 42,
+    bits_per_raw_sample: 43,
+    profile: 3,
+    level: 4,
+    width: 44,
+    height: 45,
+    sample_aspect_ratio: [ 46, 47 ],
+    field_order: 'progressive',
+    color_range: 'pc',
+    color_primaries: 'bt709',
+    color_trc: 'bt709',
+    color_space: 'bt709',
+    chroma_location: 'left',
+    video_delay: 48,
+    channel_layout: 'stereo',
+    channels: 2,
+    sample_rate: 48000,
+    block_align: 8,
+    frame_size: 1920,
+    initial_padding: 48,
+    trailing_padding: 49,
+    seek_preroll: 50 });
+  let cps = JSON.stringify(cp);
+  t.equal(typeof cps, 'string', 'stringify makes a string.');
+  let rcp = beamcoder.codecParameters(cps);
+  t.ok(rcp, 'roundtrip value is truthy.');
+  t.deepEqual(rcp, { type: 'CodecParameters',
+    codec_type: 'video',
+    codec_id: 27,
+    codec_tag: 'avc1',
+    name: 'h264',
+    extradata: Buffer.from('wibble'),
+    format: 'yuv422p',
+    bit_rate: 12345,
+    bits_per_coded_sample: 42,
+    bits_per_raw_sample: 43,
+    profile: 3,
+    level: 4,
+    width: 44,
+    height: 45,
+    sample_aspect_ratio: [ 46, 47 ],
+    field_order: 'progressive',
+    color_range: 'pc',
+    color_primaries: 'bt709',
+    color_trc: 'bt709',
+    color_space: 'bt709',
+    chroma_location: 'left',
+    video_delay: 48,
+    channel_layout: 'stereo',
+    channels: 2,
+    sample_rate: 48000,
+    block_align: 8,
+    frame_size: 1920,
+    initial_padding: 48,
+    trailing_padding: 49,
+    seek_preroll: 50 }, 'has expected value.');
+  t.end();
+});

package/test/decoderSpec.js

@@ -0,0 +1,56 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+const test = require('tape');
+const beamcoder = require('../index.js');
+
+test('Creating a decoder', t => {
+  let dec = beamcoder.decoder({ name: 'h264' });
+  t.ok(dec, 'is truthy.');
+  t.equal(dec.name, 'h264', 'has the expected name.');
+  t.equal(dec.codec_id, 27, 'has the expected codec_id.');
+  t.ok(typeof dec._CodecContext == 'object', 'external value present.');
+  t.equal(dec.type, 'decoder', 'has expected type name.');
+  t.end();
+});
+
+test('Checking the A properties:', t => {
+  let dec = beamcoder.decoder({ name: 'h264' });
+
+  t.deepEqual(dec.active_thread_type, { FRAME: false, SLICE: false},
+    'active_thread_type has expected default.');
+  t.throws(() => { dec.active_thread_type = { FRAME: true }; }, /User cannot/,
+    'active_thread_type cannot be set.');
+
+  t.equals(dec.apply_cropping, 1, 'apply_cropping has exepceted default.');
+  t.doesNotThrow(() => { dec.apply_cropping = 0; },
+    'apply_cropping setting does not throw.');
+  t.equals(dec.apply_cropping, 0, 'value has been updated.');
+
+  t.equals(dec.audio_service_type, 'main',
+    'audio_service_type has expected default value.');
+  t.throws(() => { dec.audio_service_type = 'dialogue'; },
+    /decoding/, 'cannot be updated when deocoding.');
+
+  t.end();
+});
+
+// TODO properties B to Z

package/test/demuxerSpec.js

@@ -0,0 +1,41 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+const test = require('tape');
+const beamcoder = require('../index.js');
+
+test('Creating a demuxer', async t => {
+  let dm = await beamcoder.demuxer('https://www.elecard.com/storage/video/bbb_1080p_c.ts');
+  t.ok(dm, 'is truthy.');
+  t.equal(dm.type, 'demuxer', 'type name says demuxer.');
+  t.equal(typeof dm.oformat, 'undefined', 'output format is undefined.');
+  t.ok(dm.iformat, 'has an input format.');
+  t.equal(dm.iformat.name, 'mpegts', 'input format is mpegts.');
+  t.equal(dm.streams.length, 2, 'has 2 streams.');
+  try {
+    await beamcoder.demuxer('file:jaberwocky.junk');
+    t.fail('Did not throw when opening non-existant file.');
+  } catch(e) {
+    console.log(e.message);
+    t.ok(e.message.match(/Problem opening/), 'throws opening non-existant file.');
+  }
+  t.end();
+});

package/test/encoderSpec.js

@@ -0,0 +1,69 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+const test = require('tape');
+const beamcoder = require('../index.js');
+
+test('Creating a video encoder', t => {
+  let enc = beamcoder.encoder({ name: 'h264' });
+  t.ok(enc, 'is truthy.');
+  t.equal(enc.name, 'libx264', 'has the expected name.');
+  t.equal(enc.codec_id, 27, 'has the expected codec_id.');
+  t.ok(typeof enc._CodecContext == 'object', 'external value present.');
+  t.equal(enc.type, 'encoder', 'has expected type name.');
+  t.end();
+});
+
+test('Creating an audio encoder', t => {
+  let enc = beamcoder.encoder({ name: 'aac' });
+  t.ok(enc, 'is truthy.');
+  t.equal(enc.name, 'aac', 'has the expected name.');
+  t.equal(enc.codec_id, 86018, 'has the expected codec_id.');
+  t.ok(typeof enc._CodecContext == 'object', 'external value present.');
+  t.equal(enc.type, 'encoder', 'has expected type name.');
+  t.end();
+});
+
+test('Checking the A properties:', t => {
+  let enc = beamcoder.encoder({ name: 'h264' });
+
+  t.deepEqual(enc.active_thread_type, { FRAME: false, SLICE: false},
+    'active_thread_type has expected default.');
+  t.throws(() => { enc.active_thread_type = { FRAME: true }; }, /User cannot/,
+    'active_thread_type cannot be set.');
+
+  t.notOk(enc.apply_cropping, 'apply_cropping not defined for encoding.');
+  t.throws(() => { enc.apply_cropping = 0; }, /encoding/,
+    'apply_cropping setting does not throw.');
+
+  t.equals(enc.audio_service_type, 'main',
+    'audio_service_type has expected default value.');
+  t.doesNotThrow(() => { enc.audio_service_type = 'dialogue'; },
+    'audio_service_type can be updated.');
+  t.equals(enc.audio_service_type, 'dialogue',
+    'audio_service_type has been updated.');
+  t.throws(() => { enc.audio_service_type = 'wibble'; },
+    'audio_service_type throws with unknown value.');
+
+  t.end();
+});
+
+// TODO properties B to Z

package/test/filtererSpec.js

@@ -0,0 +1,47 @@
+/*
+  Aerostat Beam Coder - Node.js native bindings for FFmpeg.
+  Copyright (C) 2019  Streampunk Media Ltd.
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program 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 General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  https://www.streampunk.media/ mailto:furnace@streampunk.media
+  14 Ormiscaig, Aultbea, Achnasheen, IV22 2JJ  U.K.
+*/
+
+const test = require('tape');
+const beamcoder = require('../index.js');
+
+test('Create a filterer', async t => {
+  let flt = await beamcoder.filterer({
+    filterType: 'audio',
+    inputParams: [
+      {
+        sampleRate: 48000,
+        sampleFormat: 's16',
+        channelLayout: 'mono',
+        timeBase: [1, 48000]
+      }
+    ],
+    outputParams: [
+      {
+        sampleRate: 8000,
+        sampleFormat: 's16',
+        channelLayout: 'mono'
+      }
+    ],
+    filterSpec: 'aresample=8000, aformat=sample_fmts=s16:channel_layouts=mono'
+  });
+  t.ok(flt, 'is truthy.');
+  t.end();
+});