format_parser 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04e71e127d550feb0a5aaa54a27cb68c1671e034a5d309c520e4b81ea385e865
-  data.tar.gz: 4617b5ea41651af01635d16dfba8de00f9765d1f3a092c7ec56170dd0d607495
+  metadata.gz: e49394510e191185e3be1f3560ca182a103b9446225a1163294f2db6a912ae76
+  data.tar.gz: 4f52d761857020a0957711528ad4d10ee885c74745897fa14a5e69292abf0cc2
 SHA512:
-  metadata.gz: f6d059459bcc4813a657bbe6b4eebdbd667d7fb15497ea1cfad2e92e355a68388fd558cc28af4e383f8d909e4a4735d4a485e34d26f1bef7b02e2420650ee0a9
-  data.tar.gz: 990f6e2490a1c38b60e1ce0fcc8f9b3e0b5471ac429a04277171e59a61b0d60d2998834792a7ea124fe474f94446f411620539018ee15bfe176a4d767e1d5919
+  metadata.gz: 829bd488d021cb0db5ce2b718aa661bdf3d4f86a55e55808c8279367e955d35b2bdccdd2bdf805ff736cef6d49f8c0f425c1ec65c0d7f07ada2db684581d4c1f
+  data.tar.gz: ed76f04c157a865de03df0d614d0d353b53e1e9c9b0a164ac6b2a6612a358643ae210b00fd92b91fec6cefd8c8c71e6ff559e63df3343b13ce161175425dbd3a

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.1.0
+* Add support for `frame_rate` in moov_parser
+
 ## 1.0.0
 * Dropping support for Ruby 2.2.X, 2.3.X and 2.4.X
 * MP3: Fix negative length reads in edge cases by bumping `id3tag` version to `v0.14.2`

data/Gemfile

@@ -1,4 +1,8 @@
 source 'https://rubygems.org'
 
+gem 'ruby-debug-ide'
+gem 'debase'
+gem 'solargraph', group: :development
+
 # Gem dependencies specified in the gemspec
 gemspec

data/lib/format_parser/version.rb

@@ -1,3 +1,3 @@
 module FormatParser
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/lib/parsers/moov_parser/decoder.rb

@@ -72,6 +72,7 @@ class FormatParser::MOOVParser::Decoder
 
     trak_atoms.find do |trak_atom|
       hdlr_atom = find_first_atom_by_path([trak_atom], 'trak', 'mdia', 'hdlr')
+      next if hdlr_atom.nil?
       hdlr_atom.atom_fields[:component_type] == 'mhlr' && hdlr_atom.atom_fields[:component_subtype] == 'vide'
     end
   end
@@ -111,6 +112,24 @@ class FormatParser::MOOVParser::Decoder
     }
   end
 
+  def parse_stts_atom(io, _)
+    version = read_byte_value(io)
+    is_v1 = version == 1
+    stts = {
+      version: version,
+      flags: read_bytes(io, 3),
+      number_of_entries: is_v1 ? read_64bit_uint(io) : read_32bit_uint(io),
+      entries: []
+    }
+    stts[:number_of_entries].times {
+      stts[:entries] << {
+        sample_count: read_32bit_uint(io),
+        sample_duration: read_32bit_uint(io)
+      }
+    }
+    stts
+  end
+
   def parse_mdhd_atom(io, _)
     version = read_byte_value(io)
     is_v1 = version == 1

data/lib/parsers/moov_parser.rb

@@ -48,9 +48,9 @@ class FormatParser::MOOVParser
     width, height = parse_dimensions(decoder, atom_tree)
 
     # Try to find the "topmost" duration (respecting edits)
-    if mdhd = decoder.find_first_atom_by_path(atom_tree, 'moov', 'mvhd')
-      timescale = mdhd.field_value(:tscale)
-      duration = mdhd.field_value(:duration)
+    if mvhd = decoder.find_first_atom_by_path(atom_tree, 'moov', 'mvhd')
+      timescale = mvhd.field_value(:tscale)
+      duration = mvhd.field_value(:duration)
       media_duration_s = duration / timescale.to_f
     end
 
@@ -64,13 +64,15 @@ class FormatParser::MOOVParser
         intrinsics: atom_tree,
       )
     else
+      frame_rate = parse_sample_atom(decoder, atom_tree)&.truncate(2)
       FormatParser::Video.new(
         format: format_from_moov_type(file_type),
         width_px: width,
         height_px: height,
+        frame_rate: frame_rate,
         media_duration_seconds: media_duration_s,
         content_type: MP4_MIXED_MIME_TYPE,
-        intrinsics: atom_tree,
+        intrinsics: atom_tree
       )
     end
   end
@@ -115,5 +117,35 @@ class FormatParser::MOOVParser
     maybe_atom_size >= minimum_ftyp_atom_size && maybe_ftyp_atom_signature == 'ftyp'
   end
 
+  # Sample information is found in the 'time-to-sample' stts atom.
+  # The media atom mdhd is needed too in order to get the movie timescale
+  def parse_sample_atom(decoder, atom_tree)
+    video_trak_atom = decoder.find_video_trak_atom(atom_tree)
+
+    stts = if video_trak_atom
+      decoder.find_first_atom_by_path([video_trak_atom], 'trak', 'mdia', 'minf', 'stbl', 'stts')
+    else
+      decoder.find_first_atom_by_path(atom_tree, 'moov', 'trak', 'mdia', 'minf', 'stbl', 'stts')
+    end
+
+    mdhd = if video_trak_atom
+      decoder.find_first_atom_by_path([video_trak_atom], 'trak', 'mdia', 'mdhd')
+    else
+      decoder.find_first_atom_by_path(atom_tree, 'moov', 'trak', 'mdia', 'mdhd')
+    end
+
+    if stts && mdhd
+      timescale = mdhd.atom_fields[:tscale]
+      sample_duration = stts.field_value(:entries).first[:sample_duration]
+      if timescale.nil? || timescale == 0 || sample_duration.nil? || sample_duration == 0
+        nil
+      else
+        timescale.to_f / sample_duration
+      end
+    else
+      nil
+    end
+  end
+
   FormatParser.register_parser new, natures: :video, formats: FTYP_MAP.values, priority: 1
 end

data/lib/video.rb

@@ -8,6 +8,8 @@ module FormatParser
 
     attr_accessor :height_px
 
+    attr_accessor :frame_rate
+
     # Type of the file (e.g :mp3)
     attr_accessor :format
 

data/spec/parsers/moov_parser_spec.rb

@@ -106,6 +106,7 @@ describe FormatParser::MOOVParser do
     expect(result.format).to eq(:mov)
     expect(result.width_px).to eq(160)
     expect(result.height_px).to eq(90)
+    expect(result.frame_rate).to eq(14.98)
   end
 
   it 'provides filename hints' do
@@ -122,6 +123,7 @@ describe FormatParser::MOOVParser do
     expect(result.format).to eq(:mov)
     expect(result.width_px).to eq(640)
     expect(result.height_px).to eq(360)
+    expect(result.frame_rate).to eq(30)
   end
 
   it 'does not raise error when a meta atom has size 0' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: format_parser
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Noah Berman
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-04-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ks
@@ -315,7 +315,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: A library for efficient parsing of file metadata