yta-video-frame-time 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

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],

{yta_video_frame_time-0.0.7.dist-info → yta_video_frame_time-0.0.8.dist-info}/METADATA

@@ -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.8.dist-info/RECORD

@@ -0,0 +1,6 @@
+yta_video_frame_time/__init__.py,sha256=-YOa7lOKdiA3FwDEHHU1tHobnmhjFpTaVLfJQLZqoMI,22252
+yta_video_frame_time/t_fraction.py,sha256=RQwZ2-ko0m4HIbf35bV107I9k2n-C0qWv-pJGmvNUOI,24799
+yta_video_frame_time-0.0.8.dist-info/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
+yta_video_frame_time-0.0.8.dist-info/METADATA,sha256=VpvV6zRnEK5B0y37UYdH7U94iLtATHwsEAhYARkqVnw,515
+yta_video_frame_time-0.0.8.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+yta_video_frame_time-0.0.8.dist-info/RECORD,,

yta_video_frame_time-0.0.7.dist-info/RECORD

@@ -1,6 +0,0 @@
-yta_video_frame_time/__init__.py,sha256=-YOa7lOKdiA3FwDEHHU1tHobnmhjFpTaVLfJQLZqoMI,22252
-yta_video_frame_time/t_fraction.py,sha256=hsCNZajG98XGnWYI0T6wSfBnAK3vf7ZiFI_GZHO8yRI,22254
-yta_video_frame_time-0.0.7.dist-info/LICENSE,sha256=6kbiFSfobTZ7beWiKnHpN902HgBx-Jzgcme0SvKqhKY,1091
-yta_video_frame_time-0.0.7.dist-info/METADATA,sha256=ooHYnwkytyyjpKRKLKakXhDJJD-HAmpXxvWuaXfVrZo,515
-yta_video_frame_time-0.0.7.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-yta_video_frame_time-0.0.7.dist-info/RECORD,,