moonfire-nvr/ui-src/lib/models/Recording.js

// vim: set et sw=2 ts=2:
//
// This file is part of Moonfire NVR, a security camera network video recorder.
// Copyright (C) 2018-2020 The Moonfire NVR Authors
//
// 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.
//
// In addition, as a special exception, the copyright holders give
// permission to link the code of portions of this program with the
// OpenSSL library under certain conditions as described in each
// individual source file, and distribute linked combinations including
// the two.
//
// You must obey the GNU General Public License in all respects for all
// of the code used other than OpenSSL. If you modify file(s) with this
// exception, you may extend this exception to your version of the
// file(s), but you are not obligated to do so. If you do not wish to do
// so, delete this exception statement from your version. If you delete
// this exception statement from all source files in the program, then
// also delete it here.
//
// 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 <http://www.gnu.org/licenses/>.

import Range90k from '../models/Range90k';

/**
 * Class to encapsulate recording JSON data.
 */
export default class Recording {
  /**
   * Accept JSON data to be encapsulated
   *
   * @param {object} recordingJson JSON for a recording
   * @param {object} videoSampleEntryJson JSON for a video sample entry
   */
  constructor(recordingJson, videoSampleEntryJson) {
    /** @const {!number} */
    this.startId = recordingJson.startId;

    /** @const {?number} */
    this.endId = recordingJson.endId !== undefined ? recordingJson.endId : null;

    /** @const {!number} */
    this.openId = recordingJson.openId;

    /** @const {?number} */
    this.firstUncommitted = recordingJson.firstUncommitted !== undefined ?
        recordingJson.firstUncommitted : null;

    /** @const {!boolean} */
    this.growing = recordingJson.growing || false;

    /** @const {!number} */
    this.startTime90k = recordingJson.startTime90k;

    /** @const {!number} */
    this.endTime90k = recordingJson.endTime90k;

    /** @const {!number} */
    this.sampleFileBytes = recordingJson.sampleFileBytes;

    /** @const {!number} */
    this.videoSamples = recordingJson.videoSamples;

    /** @const {!string} */
    this.videoSampleEntrySha1 = videoSampleEntryJson.sha1;

    /** @const {!number} */
    this.videoSampleEntryWidth = videoSampleEntryJson.width;

    /** @const {!number} */
    this.videoSampleEntryHeight = videoSampleEntryJson.height;

    /** @const {!number} */
    this.videoSampleEntryPaspHSpacing = videoSampleEntryJson.paspHSpacing;

    /** @const {!number} */
    this.videoSampleEntryPaspVSpacing = videoSampleEntryJson.paspVSpacing;
  }

  /**
   * Return duration of recording in 90k units.
   * @return {Number} Time in units of 90k parts of a second
   */
  get duration90k() {
    return this.endTime90k - this.startTime90k;
  }

  /**
   * Compute the range of the recording in 90k timestamp units,
   * optionally trimmed by another range.
   *
   * @param  {Range90k} trimmedAgainst Optional range to trim against
   * @return {Range90k}                Resulting range
   */
  range90k(trimmedAgainst = null) {
    const result = new Range90k(this.startTime90k, this.endTime90k);
    return trimmedAgainst ? result.trimmed(trimmedAgainst) : result;
  }
  /**
   * Return duration of recording in seconds.
   * @return {Number} Time in units of seconds.
   */
  get duration() {
    return this.duration90k / 90000;
  }
}