Add t35_identifier_length and move descr to hrsd

Author: y-guyon

IsoLib/isoiff_tool/w32/isoiff/isoiff.dsp

@@ -71,6 +71,7 @@ add_library(
     src/H263SpecificInfoAtom.c
     src/HandlerAtom.c
     src/HEVCConfigAtom.c
+    src/HumanReadableStreamDescriptionAtom.c
     src/LHEVCConfigAtom.c
     src/VVCConfigAtom.c
     src/VVCNALUConfigAtom.c

IsoLib/libisomediafile/CMakeLists.txt

@@ -158,6 +158,7 @@ sources = \
 	TextMetaSampleEntry.c \
 	XMLMetaSampleEntry.c \
 	BitRateAtom.c \
+	HumanReadableStreamDescriptionAtom.c \
 	AMRWPSpecificInfoAtom.c \
 	AMRSpecificInfoAtom.c \
 	H263SpecificInfoAtom.c \

IsoLib/libisomediafile/linux/libisomediafile/Makefile

@@ -158,6 +158,7 @@ sources = \
 	TextMetaSampleEntry.c \
 	XMLMetaSampleEntry.c \
 	BitRateAtom.c \
+	HumanReadableStreamDescriptionAtom.c \
 	AMRWPSpecificInfoAtom.c \
 	AMRSpecificInfoAtom.c \
 	H263SpecificInfoAtom.c \

IsoLib/libisomediafile/macosx/libisomediafile/Makefile

@@ -0,0 +1,172 @@
+/*
+This software module was originally developed by Google LLC.
+in the course of development of MPEG-4.
+This software module is an implementation of a part of one or
+more MPEG-4 tools as specified by MPEG-4.
+ISO/IEC gives users of MPEG-4 free license to this
+software module or modifications thereof for use in hardware
+or software products claiming conformance to MPEG-4.
+Those intending to use this software module in hardware or software
+products are advised that its use may infringe existing patents.
+The original developer of this software module and his/her company,
+the subsequent editors and their companies, and ISO/IEC have no
+liability for use of this software module or modifications thereof
+in an implementation.
+Copyright is not released for non MPEG-4 conforming
+products. Google LLC retains full right to use the code for its own
+purpose, assign or donate the code to a third party and to
+inhibit third parties from using the code for non
+MPEG-4 conforming products.
+This copyright notice must be included in all copies or
+derivative works. Copyright (c) 2026.
+*/
+
+#include "MP4Atoms.h"
+#include <stdlib.h>
+#include <stdint.h>
+
+static void destroy(MP4AtomPtr s)
+{
+  MP4HumanReadableStreamDescriptionAtomPtr self;
+  self = (MP4HumanReadableStreamDescriptionAtomPtr)s;
+  if(self == NULL) return;
+
+  if(self->description)
+  {
+    free(self->description);
+    self->description = NULL;
+  }
+
+  if(self->super) self->super->destroy(s);
+}
+
+static MP4Err serialize(struct MP4Atom *s, char *buffer)
+{
+  MP4Err err                                    = MP4NoErr;
+  MP4HumanReadableStreamDescriptionAtomPtr self = (MP4HumanReadableStreamDescriptionAtomPtr)s;
+  size_t len;
+
+  err = MP4SerializeCommonBaseAtomFields(s, buffer);
+  if(err) goto bail;
+  buffer += self->bytesWritten;
+  assert(self->type == MP4HumanReadableStreamDescriptionAtomType);
+
+  len = strlen(self->description);
+  if(self->description == NULL || len == 0 || len >= UINT32_MAX - 1)
+  {
+    err = MP4BadParamErr;
+    goto bail;
+  }
+  /* Write description as null-terminated UTF-8 string */
+  PUTBYTES(self->description, (u32)len + 1); /* Include null terminator */
+
+  assert(self->bytesWritten == self->size);
+bail:
+  TEST_RETURN(err);
+
+  return err;
+}
+
+static MP4Err calculateSize(struct MP4Atom *s)
+{
+  MP4Err err;
+  MP4HumanReadableStreamDescriptionAtomPtr self = (MP4HumanReadableStreamDescriptionAtomPtr)s;
+  err                                           = MP4NoErr;
+
+  err = MP4CalculateBaseAtomFieldSize(s);
+  if(err) goto bail;
+
+  if(self->description == NULL || strlen(self->description) == 0)
+  {
+    err = MP4BadParamErr;
+    goto bail;
+  }
+  /* Add description size (null-terminated string) */
+  self->size += (u32)strlen(self->description) + 1; /* Including '\0' */
+
+bail:
+  TEST_RETURN(err);
+
+  return err;
+}
+
+static MP4Err createFromInputStream(MP4AtomPtr s, MP4AtomPtr proto, MP4InputStreamPtr inputStream)
+{
+  MP4Err err;
+  MP4HumanReadableStreamDescriptionAtomPtr self = (MP4HumanReadableStreamDescriptionAtomPtr)s;
+  s64 bytesToRead;
+  u32 nullPos;
+  u32 descLen;
+  u8 *buf = NULL;
+  u32 i;
+
+  if(self == NULL) BAILWITHERROR(MP4BadParamErr)
+  err = self->super->createFromInputStream(s, proto, (char *)inputStream);
+  if(err) goto bail;
+
+  /* Read all remaining bytes into a flat buffer, then split on the first null byte.
+   * Scanning byte-by-byte and "rewinding" by adjusting only bytesRead (while leaving
+   * the stream cursor in place) does not work — readData always reads from the current
+   * stream position. */
+  bytesToRead = (s64)(self->size - self->bytesRead);
+  if(bytesToRead < 0) BAILWITHERROR(MP4BadDataErr);
+
+  if(bytesToRead > 0)
+  {
+    buf = (u8 *)calloc((u32)bytesToRead, 1);
+    TESTMALLOC(buf);
+    err = inputStream->readData(inputStream, (u32)bytesToRead, (char *)buf, NULL);
+    if(err) goto bail;
+    self->bytesRead += (u32)bytesToRead;
+
+    /* Find the null terminator that ends the description field */
+    nullPos = (u32)bytesToRead; /* default: no null found */
+    for(i = 0; i < (u32)bytesToRead; i++)
+    {
+      if(buf[i] == 0)
+      {
+        nullPos = i;
+        break;
+      }
+    }
+
+    /* Description: bytes [0 .. nullPos] (including the null terminator) */
+    descLen           = nullPos + 1; /* length including null */
+    self->description = (char *)calloc(descLen, 1);
+    TESTMALLOC(self->description);
+    memcpy(self->description, buf, descLen);
+  }
+
+bail:
+  free(buf);
+  TEST_RETURN(err);
+  return err;
+}
+
+MP4Err
+MP4CreateHumanReadableStreamDescriptionAtom(MP4HumanReadableStreamDescriptionAtomPtr *outAtom)
+{
+  MP4Err err;
+  MP4HumanReadableStreamDescriptionAtomPtr self;
+
+  self = (MP4HumanReadableStreamDescriptionAtomPtr)calloc(
+    1, sizeof(MP4HumanReadableStreamDescriptionAtom));
+  TESTMALLOC(self);
+
+  err = MP4CreateBaseAtom((MP4AtomPtr)self);
+  if(err) goto bail;
+  self->type                  = MP4HumanReadableStreamDescriptionAtomType;
+  self->name                  = "HumanReadableStreamDescription";
+  self->createFromInputStream = (cisfunc)createFromInputStream;
+  self->destroy               = destroy;
+  self->calculateSize         = calculateSize;
+  self->serialize             = serialize;
+
+  self->description = NULL;
+
+  *outAtom = self;
+bail:
+  TEST_RETURN(err);
+
+  return err;
+}

IsoLib/libisomediafile/src/HumanReadableStreamDescriptionAtom.c

@@ -877,20 +877,16 @@ extern "C"
    * @ingroup SampleDescr
    *
    * Properly deserializes the handle returned by MP4GetMediaSampleDescription() and extracts
-   * the T.35 identifier bytes and optional description string. The caller is responsible for
-   * freeing *outIdentifier and *outDescription with free().
+   * the T.35 identifier bytes. The caller is responsible for freeing *outIdentifier with free().
    *
    * @param sampleEntryH  Handle containing the serialized 'it35' sample entry.
    * @param outIdentifier Output; receives a newly allocated copy of the t35_identifier bytes.
-   * @param outIdentifierSize Output; receives the number of bytes in *outIdentifier.
-   * @param outDescription Optional output; receives a newly allocated description string, or NULL
-   *                       if no description is present. Pass NULL to ignore.
+   * @param outIdentifierLength Output; receives the number of bytes in *outIdentifier.
    * @return MP4NoErr on success, MP4NotFoundErr if no identifier is present, MP4BadParamErr on
    *         invalid input.
    */
   ISO_EXTERN(ISOErr)
-  ISOGetT35SampleEntryFields(MP4Handle sampleEntryH, u8 **outIdentifier, u32 *outIdentifierSize,
-                             char **outDescription);
+  ISOGetT35SampleEntryFields(MP4Handle sampleEntryH, u8 **outIdentifier, u32 *outIdentifierLength);
 
   /*************************************************************************************************
    * VVC Sample descriptions