yta-video-frame-time 0.0.7__tar.gz → 0.0.8__tar.gz

{yta_video_frame_time-0.0.7 → yta_video_frame_time-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: yta-video-frame-time
-Version: 0.0.7
+Version: 0.0.8
 Summary: Youtube Autonomous Video Frame Time Module
 Author: danialcala94
 Author-email: danielalcalavalera@gmail.com

{yta_video_frame_time-0.0.7 → yta_video_frame_time-0.0.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "yta-video-frame-time"
-version = "0.0.7"
+version = "0.0.8"
 description = "Youtube Autonomous Video Frame Time Module"
 authors = [
     {name = "danialcala94",email = "danielalcalavalera@gmail.com"}

{yta_video_frame_time-0.0.7 → yta_video_frame_time-0.0.8}/src/yta_video_frame_time/t_fraction.py

@@ -238,6 +238,8 @@ def round_pts(
     and 'time_base', but here is an easier
     example using the time moments.
 
+    (!) This is valid only for video.
+
     Examples below, with `time_base = 1/5`:
     - `t = 0.25` => `0.2` (truncated or rounded)
     - `t = 0.35` => `0.2` (truncated)
@@ -256,8 +258,6 @@ def round_pts(
     
     return int(frame_index * ticks_per_frame)
 
-# TODO: Create a 'round_pts'
-
 """
 When we are working with the 't' time
 moment we need to use the fps, and when
@@ -306,6 +306,18 @@ class _T:
         The formula:
         - `pts * time_base`
         """
+        t = Fraction(pts * self._t_handler.time_base)
+
+        return (
+            self._t_handler.t.truncated(t)
+            if do_truncate is True else
+            self._t_handler.t.rounded(t)
+            if do_truncate is False else
+            t # if None
+        )
+
+        # TODO: Remove this below in the next
+        # commit
         pts = (
             self._t_handler.pts.truncated(pts)
             if do_truncate is True else
@@ -552,6 +564,16 @@ class _Pts:
             t = self._t_handler.t.from_index(index),
             do_truncate = True
         )
+    
+    """
+    This about the pts is not 100% sure as it
+    is only a value to display the frames but
+    not accurate and depends on the encoder.
+
+    Maybe we don't want all this functionality
+    but only the one that is 100% sure its
+    working properly.
+    """
 
     def truncated(
         self,
@@ -563,6 +585,8 @@ class _Pts:
         This means that if 't' is in a
         [start, end) range, we will obtain the
         'start' value always.
+
+        (!) This is valid only for video
         """
         return round_pts(
             pts = pts,
@@ -583,6 +607,8 @@ class _Pts:
         the 'start' or the 'end' value according
         to which one is closer to the that 't'
         value provided.
+
+        (!) This is valid only for video.
         """
         return round_pts(
             pts = pts,
@@ -591,7 +617,7 @@ class _Pts:
             do_truncate = False
         )
     
-    def next(
+    def next_video(
         self,
         pts: int,
         n: int = 1,
@@ -606,6 +632,8 @@ class _Pts:
         Useful when you need the next value for a
         range in an iteration or similar.
 
+        (!) This is valid only for video.
+
         The formula:
         - `pts + n * ticks_per_frame`
         """
@@ -617,7 +645,32 @@ class _Pts:
 
         return pts + n * get_ticks_per_frame(self._t_handler.fps, self._t_handler.time_base)
     
-    def previous(
+    def next_audio(
+        self,
+        pts: int,
+        samples_per_frame: int,
+        n: int = 1
+    ) -> int:
+        """
+        Get the value that is 'n' times ahead of
+        the 'pts' value provided according to the
+        number of 'samples_per_frame' each frame
+        has.
+
+        TODO: Are we sure that the number of 
+        samples per frame is always the same (?)
+
+        Useful when you need the next value for a
+        range in an iteration or similar.
+
+        (!) This is valid only for audio.
+
+        The formula:
+        - `pts + (n * samples_per_frame)`
+        """
+        return pts + (n * samples_per_frame)
+    
+    def previous_video(
         self,
         pts: int,
         n: int = 1,
@@ -637,6 +690,8 @@ class _Pts:
         this will give you an unexpected negative
         value.
 
+        (!) This is valid only for video.
+
         The formula:
         - `pts - n * ticks_per_frame`
         """
@@ -647,6 +702,31 @@ class _Pts:
         )
 
         return pts - n * get_ticks_per_frame(self._t_handler.fps, self._t_handler.time_base)
+    
+    def previous_audio(
+        self,
+        pts: int,
+        samples_per_frame: int,
+        n: int = 1
+    ) -> int:
+        """
+        Get the value that is 'n' times before
+        the 'pts' value provided according to the
+        number of 'samples_per_frame' each frame
+        has.
+
+        TODO: Are we sure that the number of 
+        samples per frame is always the same (?)
+
+        Useful when you need the next value for a
+        range in an iteration or similar.
+
+        (!) This is valid only for audio.
+
+        The formula:
+        - `pts - (n * samples_per_frame)`
+        """
+        return pts - (n * samples_per_frame)
 
 class THandler:
     """
@@ -745,6 +825,8 @@ def frame_t_to_pts(
     moment provided, based on the also provided
     'fps' and 'time_base'.
 
+    (!) This is valid only for videos.
+
     The formula:
     - `frame_index * ticks_per_frame`
     """
@@ -764,6 +846,20 @@ def frame_pts_to_t(
     - `pts * time_base`
     """
     return parse_fraction(pts * time_base)
+
+def get_audio_frame_duration(
+    samples: int,
+    fps: Fraction
+) -> Fraction:
+    """
+    Get the audio frame duration by giving the
+    number of '.samples' and also the rate (that
+    we call 'fps').
+
+    This is useful when trying to guess the next
+    pts or t.
+    """
+    return Fraction(samples / fps)
     
 def get_ticks_per_frame(
     fps: Union[float, int, Fraction],