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

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

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

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

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

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

@@ -354,7 +354,7 @@ class _T:
         variation.
 
         The formula:
-        - `int(t * fps)`
+        - `int(round(t * fps))`
         """
         t = (
             self.truncated(t)
@@ -542,7 +542,7 @@ class _Pts:
         variation.
 
         The formula:
-        - `int((pts * time_base) * fps)`
+        - `int(round((pts * time_base) * fps))`
         """
         return self._t_handler.t.to_index(
             self.to_t(pts, do_truncate = None),
@@ -566,13 +566,18 @@ class _Pts:
         )
     
     """
-    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.
+    These 2 methods below are here because they
+    seem to work for videos, but I think they
+    could work not if the video has dynamic frame
+    rate or in some other situations, thats why
+    this is here as a reminder.
 
-    Maybe we don't want all this functionality
-    but only the one that is 100% sure its
-    working properly.
+    I found one video that had audio_fps=44100
+    and time_base=256/11025, so it was impossible
+    to make a conversion using this formula with
+    the audio. With video seems to be ok, but...
+
+    Use these methods below at your own risk.
     """
 
     def truncated(
@@ -580,13 +585,15 @@ class _Pts:
         pts: int
     ):
         """
+        (!) This is valid only for video and/or 
+        could work not properly. Use it at your
+        own risk.
+
         Get the 'pts' value provided but truncated.
 
         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,
@@ -600,6 +607,10 @@ class _Pts:
         pts: int
     ) -> int:
         """
+        (!) This is valid only for video and/or 
+        could work not properly. Use it at your
+        own risk.
+
         Get the 'pts' value provided but rounded.
 
         This means that if 't' is in a
@@ -607,8 +618,6 @@ 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,
@@ -617,13 +626,17 @@ class _Pts:
             do_truncate = False
         )
     
-    def next_video(
+    def next(
         self,
         pts: int,
         n: int = 1,
         do_truncate: bool = True
     ) -> int:
         """
+        (!) This is valid only for video and/or 
+        could work not properly. Use it at your
+        own risk.
+
         Get the value that is 'n' times ahead of
         the 'pts' value provided (truncated or
         rounded according to the 'do_truncate'
@@ -632,8 +645,6 @@ 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`
         """
@@ -645,38 +656,17 @@ class _Pts:
 
         return pts + n * get_ticks_per_frame(self._t_handler.fps, self._t_handler.time_base)
     
-    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(
+    def previous(
         self,
         pts: int,
         n: int = 1,
         do_truncate: bool = True
     ) -> int:
         """
+        (!) This is valid only for video and/or 
+        could work not properly. Use it at your
+        own risk.
+
         Get the value that is 'n' times before
         the 't' property of this instance 
         (truncated or rounded according to the
@@ -690,8 +680,6 @@ class _Pts:
         this will give you an unexpected negative
         value.
 
-        (!) This is valid only for video.
-
         The formula:
         - `pts - n * ticks_per_frame`
         """
@@ -703,31 +691,6 @@ 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:
     """
     Class to simplify the way we work with
@@ -795,9 +758,9 @@ def frame_t_to_index(
     also provided 'fps'.
 
     The formula:
-    - `int(t * fps)`
+    - `int(round(t * fps))`
     """
-    return int(parse_fraction(t) * fps)
+    return int(round(t * fps))
 
 def frame_index_to_t(
     index: int,
@@ -849,17 +812,20 @@ def frame_pts_to_t(
 
 def get_audio_frame_duration(
     samples: int,
-    fps: Fraction
+    audio_fps: Fraction
 ) -> Fraction:
     """
     Get the audio frame duration by giving the
     number of '.samples' and also the rate (that
-    we call 'fps').
+    we call 'audio_fps').
 
     This is useful when trying to guess the next
     pts or t.
+
+    The formula:
+    - `samples / audio_fps`
     """
-    return Fraction(samples / fps)
+    return Fraction(samples / audio_fps)
     
 def get_ticks_per_frame(
     fps: Union[float, int, Fraction],