@libmedia/avutil 0.12.0 → 1.0.0

package/src/struct/avpacket.ts

@@ -0,0 +1,178 @@
+/*
+ * libmedia AVPacket defined
+ *
+ * 版权所有 (C) 2024 赵高兴
+ * Copyright (C) 2024 Gaoxing Zhao
+ *
+ * 此文件是 libmedia 的一部分
+ * This file is part of libmedia.
+ * 
+ * libmedia 是自由软件；您可以根据 GNU Lesser General Public License（GNU LGPL）3.1
+ * 或任何其更新的版本条款重新分发或修改它
+ * libmedia is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.1 of the License, or (at your option) any later version.
+ * 
+ * libmedia 希望能够为您提供帮助，但不提供任何明示或暗示的担保，包括但不限于适销性或特定用途的保证
+ * 您应自行承担使用 libmedia 的风险，并且需要遵守 GNU Lesser General Public License 中的条款和条件。
+ * libmedia 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
+ * Lesser General Public License for more details.
+ *
+ */
+
+import { AVPacketSideDataType } from '../codec'
+import { AV_TIME_BASE, NOPTS_VALUE, NOPTS_VALUE_BIGINT } from '../constant'
+import type { AVBufferRef } from './avbuffer'
+import { AVRational } from './rational'
+
+export const enum AVPacketType {
+  AUDIO,
+  VIDEO
+}
+
+export const enum AVPacketFlags {
+  /**
+   * The packet contains a keyframe
+   */
+  AV_PKT_FLAG_KEY = 1,
+  /**
+   * The packet content is corrupted
+   */
+  AV_PKT_FLAG_CORRUPT = 2,
+  /**
+   * Flag is used to discard packets which are required to maintain valid
+   * decoder state but are not required for output and should be dropped
+   * after decoding.
+   */
+  AV_PKT_FLAG_DISCARD = 4,
+  /**
+   * The packet comes from a trusted source.
+   *
+   * Otherwise-unsafe constructs such as arbitrary pointers to data
+   * outside the packet may be followed.
+   */
+  AV_PKT_FLAG_TRUSTED = 8,
+  /**
+   * Flag is used to indicate packets that contain frames that can
+   * be discarded by the decoder.  I.e. Non-reference frames.
+   */
+  AV_PKT_FLAG_DISPOSABLE = 16,
+
+  /**
+   * The stream is end
+   */
+  AV_PKT_FLAG_END = 32,
+
+  /**
+   * 对于 h264/h265/h266 标记是否是 annexb 码流格式，未置此标志则为 avcc 格式
+   */
+  AV_PKT_FLAG_H26X_ANNEXB = 64
+}
+
+@struct
+export class AVPacketSideData {
+  data: pointer<uint8> = nullptr
+
+  size: size = 0
+
+  type: AVPacketSideDataType = AVPacketSideDataType.AV_PKT_DATA_UNKNOWN
+}
+
+@struct
+export class AVProducerReferenceTime {
+  wallclock: int64
+  flags: int32
+}
+
+
+/**
+ * FFmpeg AVPacket 定义
+ */
+@struct
+export default class AVPacket {
+  /**
+   * A reference to the reference-counted buffer where the packet data is
+   * stored.
+   * May be NULL, then the packet data is not reference-counted.
+   */
+  buf: pointer<AVBufferRef> = nullptr
+
+  /**
+   * Presentation timestamp in AVStream->time_base units; the time at which
+   * the decompressed packet will be presented to the user.
+   * Can be AV_NOPTS_VALUE if it is not stored in the file.
+   * pts MUST be larger or equal to dts as presentation cannot happen before
+   * decompression, unless one wants to view hex dumps. Some formats misuse
+   * the terms dts and pts/cts to mean something different. Such timestamps
+   * must be converted to true pts/dts before they are stored in AVPacket.
+   */
+  pts: int64 = NOPTS_VALUE_BIGINT
+
+  /**
+   * Decompression timestamp in AVStream->time_base units; the time at which
+   * the packet is decompressed.
+   * Can be AV_NOPTS_VALUE if it is not stored in the file.
+   */
+  dts: int64 = NOPTS_VALUE_BIGINT
+
+  data: pointer<uint8> = nullptr
+
+  size: int32 = 0
+
+  streamIndex: int32 = NOPTS_VALUE
+
+  /**
+   * A combination of @AVPacketFlags values
+   */
+  flags: int32 = 0
+
+  /**
+   * Additional packet data that can be provided by the container.
+   * Packet can contain several types of side information.
+   */
+  sideData: pointer<AVPacketSideData> = nullptr
+  sideDataElems: int32 = 0
+
+  /**
+   * Duration of this packet in AVStream->time_base units, 0 if unknown.
+   * Equals next_pts - this_pts in presentation order.
+   */
+  duration: int64 = NOPTS_VALUE_BIGINT
+
+  pos: int64 = NOPTS_VALUE_BIGINT
+
+  /**
+   * for some private data of the user
+   */
+  opaque: pointer<void> = nullptr
+
+  /**
+   * AVBufferRef for free use by the API user. FFmpeg will never check the
+   * contents of the buffer ref. FFmpeg calls av_buffer_unref() on it when
+   * the packet is unreferenced. av_packet_copy_props() calls create a new
+   * reference with av_buffer_ref() for the target packet's opaque_ref field.
+   *
+   * This is unrelated to the opaque field, although it serves a similar
+   * purpose.
+   */
+  opaqueRef: pointer<AVBufferRef> = nullptr
+
+  /**
+   * Time base of the packet's timestamps.
+   */
+  timeBase: AVRational = new AVRational({ den: AV_TIME_BASE, num: 1 })
+
+}
+
+@struct
+export class AVPacketRef extends AVPacket {
+  refCount: atomic_int32
+}
+
+export interface AVPacketPool {
+  alloc: () => pointer<AVPacketRef>
+  release: (avpacket: pointer<AVPacketRef>) => void
+}

package/src/struct/avpcmbuffer.ts

@@ -0,0 +1,77 @@
+/*
+ * libmedia AVPCMBuffer defined
+ *
+ * 版权所有 (C) 2024 赵高兴
+ * Copyright (C) 2024 Gaoxing Zhao
+ *
+ * 此文件是 libmedia 的一部分
+ * This file is part of libmedia.
+ * 
+ * libmedia 是自由软件；您可以根据 GNU Lesser General Public License（GNU LGPL）3.1
+ * 或任何其更新的版本条款重新分发或修改它
+ * libmedia is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.1 of the License, or (at your option) any later version.
+ * 
+ * libmedia 希望能够为您提供帮助，但不提供任何明示或暗示的担保，包括但不限于适销性或特定用途的保证
+ * 您应自行承担使用 libmedia 的风险，并且需要遵守 GNU Lesser General Public License 中的条款和条件。
+ * libmedia 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
+ * Lesser General Public License for more details.
+ *
+ */
+
+import type { AVSampleFormat } from '../audiosamplefmt'
+
+@struct
+export default class AVPCMBuffer {
+  /**
+   * pcm 数据
+   * 可同时存放多个 channel 数据
+   */
+  data: pointer<pointer<uint8>>
+  /**
+   * data 每一个 channel 的缓冲区大小
+   */
+  linesize: int32
+  /**
+   * 当前存放了多少个采样点
+   */
+  nbSamples: int32
+  /**
+   * 当前 data 每个 channel 能存放的最大采样点数
+   */
+  maxnbSamples: int32
+  /**
+   * 声道数
+   */
+  channels: int32
+  /**
+   * 采样率
+   */
+  sampleRate: int32
+  /**
+   * pcm 格式
+   */
+  format: AVSampleFormat
+  /**
+   * pts
+   */
+  timestamp: int64
+  /**
+   * 时长
+   */
+  duration: double
+}
+
+@struct
+export class AVPCMBufferRef extends AVPCMBuffer {
+  refCount: atomic_int32
+}
+
+export interface AVPCMBufferPool {
+  alloc: () => pointer<AVPCMBufferRef>
+  release: (buffer: pointer<AVPCMBufferRef>) => void
+}

package/src/struct/avsubtitle.ts

@@ -0,0 +1,59 @@
+/*
+ * libmedia AVSubtitle defined
+ *
+ * 版权所有 (C) 2024 赵高兴
+ * Copyright (C) 2024 Gaoxing Zhao
+ *
+ * 此文件是 libmedia 的一部分
+ * This file is part of libmedia.
+ * 
+ * libmedia 是自由软件；您可以根据 GNU Lesser General Public License（GNU LGPL）3.1
+ * 或任何其更新的版本条款重新分发或修改它
+ * libmedia is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.1 of the License, or (at your option) any later version.
+ * 
+ * libmedia 希望能够为您提供帮助，但不提供任何明示或暗示的担保，包括但不限于适销性或特定用途的保证
+ * 您应自行承担使用 libmedia 的风险，并且需要遵守 GNU Lesser General Public License 中的条款和条件。
+ * libmedia 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
+ * Lesser General Public License for more details.
+ *
+ */
+
+import type { AVRational } from './rational'
+
+export const enum AVSubtitleType {
+  SUBTITLE_NONE,
+  /**
+   * Plain text, the text field must be set by the decoder and is
+   * authoritative. ass and pict fields may contain approximations.
+   */
+  SUBTITLE_TEXT,
+
+  /**
+   * Formatted webvtt, the ass field must be set by the decoder and is
+   * authoritative. pict and text fields may contain approximations.
+   */
+  SUBTITLE_WEBVTT,
+  /**
+   * Formatted text, the ass field must be set by the decoder and is
+   * authoritative. pict and text fields may contain approximations.
+   */
+  SUBTITLE_ASS
+}
+
+export interface AVSubtitleRect {
+  flags: int32
+  type: AVSubtitleType
+  text: string
+}
+
+export interface AVSubtitle {
+  pts: int64
+  duration: int64
+  timeBase: AVRational
+  rects: AVSubtitleRect[]
+}

package/src/struct/encryption.ts

@@ -0,0 +1,180 @@
+/*
+ * libmedia EncryptionInfo defined
+ *
+ * 版权所有 (C) 2024 赵高兴
+ * Copyright (C) 2024 Gaoxing Zhao
+ *
+ * 此文件是 libmedia 的一部分
+ * This file is part of libmedia.
+ * 
+ * libmedia 是自由软件；您可以根据 GNU Lesser General Public License（GNU LGPL）3.1
+ * 或任何其更新的版本条款重新分发或修改它
+ * libmedia is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.1 of the License, or (at your option) any later version.
+ * 
+ * libmedia 希望能够为您提供帮助，但不提供任何明示或暗示的担保，包括但不限于适销性或特定用途的保证
+ * 您应自行承担使用 libmedia 的风险，并且需要遵守 GNU Lesser General Public License 中的条款和条件。
+ * libmedia 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
+ * Lesser General Public License for more details.
+ *
+ */
+
+@struct
+export class AVSubsampleEncryptionInfo {
+  /**
+   * The number of bytes that are clear.
+   */
+  bytesOfClearData: uint32
+  /**
+   * The number of bytes that are protected.  If using pattern encryption,
+   * the pattern applies to only the protected bytes; if not using pattern
+   * encryption, all these bytes are encrypted.
+   */
+  bytesOfProtectedData: uint32
+}
+
+export interface EncryptionInfo {
+  /**
+   * The fourcc encryption scheme, in big-endian byte order.
+   */
+  scheme: uint32
+
+  /**
+   * Only used for pattern encryption.  This is the number of 16-byte blocks
+   * that are encrypted.
+   */
+  cryptByteBlock: uint32
+
+  /**
+   * Only used for pattern encryption.  This is the number of 16-byte blocks
+   * that are clear.
+   */
+  skipByteBlock: uint32
+
+  /**
+   * The ID of the key used to encrypt the packet.  This should always be
+   * 16 bytes long, but may be changed in the future.
+   */
+  keyId: Uint8Array
+
+  /**
+   * The initialization vector.  This may have been zero-filled to be the
+   * correct block size.  This should always be 16 bytes long, but may be
+   * changed in the future.
+   */
+  iv: Uint8Array
+
+  /**
+   * An array of subsample encryption info specifying how parts of the sample
+   * are encrypted.  If there are no subsamples, then the whole sample is
+   * encrypted.
+   */
+  subsamples: AVSubsampleEncryptionInfo[]
+}
+
+@struct
+export class AVEncryptionInfo {
+  /**
+   * The fourcc encryption scheme, in big-endian byte order.
+   */
+  scheme: uint32
+
+  /**
+   * Only used for pattern encryption.  This is the number of 16-byte blocks
+   * that are encrypted.
+   */
+  cryptByteBlock: uint32
+
+  /**
+   * Only used for pattern encryption.  This is the number of 16-byte blocks
+   * that are clear.
+   */
+  skipByteBlock: uint32
+
+  /**
+   * The ID of the key used to encrypt the packet.  This should always be
+   * 16 bytes long, but may be changed in the future.
+   */
+  keyId: pointer<uint8>
+  keyIdSize: uint32
+
+  /**
+   * The initialization vector.  This may have been zero-filled to be the
+   * correct block size.  This should always be 16 bytes long, but may be
+   * changed in the future.
+   */
+  iv: pointer<uint8>
+  ivSize: uint32
+
+  /**
+   * An array of subsample encryption info specifying how parts of the sample
+   * are encrypted.  If there are no subsamples, then the whole sample is
+   * encrypted.
+   */
+  subsamples: pointer<AVSubsampleEncryptionInfo>
+  subsampleCount: uint32
+}
+
+export interface EncryptionInitInfo {
+  /**
+    * A unique identifier for the key system this is for, can be NULL if it
+    * is not known.  This should always be 16 bytes, but may change in the
+    * future.
+    */
+  systemId: Uint8Array
+
+  /**
+   * An array of key IDs this initialization data is for.  All IDs are the
+   * same length.  Can be NULL if there are no known key IDs.
+   */
+  keyIds: Uint8Array[]
+
+  /**
+   * Key-system specific initialization data.  This data is copied directly
+   * from the file and the format depends on the specific key system.  This
+   * can be NULL if there is no initialization data; in that case, there
+   * will be at least one key ID.
+   */
+  data: Uint8Array
+}
+
+@struct
+export class AVEncryptionInitInfo {
+  /**
+    * A unique identifier for the key system this is for, can be NULL if it
+    * is not known.  This should always be 16 bytes, but may change in the
+    * future.
+    */
+  systemId: pointer<uint8>
+  systemIdSize: uint32
+
+  /**
+   * An array of key IDs this initialization data is for.  All IDs are the
+   * same length.  Can be NULL if there are no known key IDs.
+   */
+  keyIds: pointer<pointer<uint8>>
+  /** The number of key IDs. */
+  numKeyIds: uint32
+  /**
+   * The number of bytes in each key ID.  This should always be 16, but may
+   * change in the future.
+   */
+  keyIdSize: uint32
+
+  /**
+   * Key-system specific initialization data.  This data is copied directly
+   * from the file and the format depends on the specific key system.  This
+   * can be NULL if there is no initialization data; in that case, there
+   * will be at least one key ID.
+   */
+  data: pointer<uint8>
+  dataSize: uint32
+  /**
+   * An optional pointer to the next initialization info in the list.
+   */
+  next: pointer<AVEncryptionInitInfo>
+}

package/src/struct/rational.ts

@@ -0,0 +1,43 @@
+/*
+ * libmedia Rational defined
+ *
+ * 版权所有 (C) 2024 赵高兴
+ * Copyright (C) 2024 Gaoxing Zhao
+ *
+ * 此文件是 libmedia 的一部分
+ * This file is part of libmedia.
+ * 
+ * libmedia 是自由软件；您可以根据 GNU Lesser General Public License（GNU LGPL）3.1
+ * 或任何其更新的版本条款重新分发或修改它
+ * libmedia is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3.1 of the License, or (at your option) any later version.
+ * 
+ * libmedia 希望能够为您提供帮助，但不提供任何明示或暗示的担保，包括但不限于适销性或特定用途的保证
+ * 您应自行承担使用 libmedia 的风险，并且需要遵守 GNU Lesser General Public License 中的条款和条件。
+ * libmedia 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
+ * Lesser General Public License for more details.
+ *
+ */
+
+@struct
+export class AVRational {
+  /**
+   * 分子
+   */
+  num: int32 = 1
+  /**
+   * 分母
+   */
+  den: int32 = 1
+
+  constructor(init?: {den: number, num: number}) {
+    if (init) {
+      this.den = init.den
+      this.num = init.num
+    }
+  }
+}