yta-video-opengl 0.0.9__tar.gz → 0.0.10__tar.gz

{yta_video_opengl-0.0.9 → yta_video_opengl-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: yta-video-opengl
-Version: 0.0.9
+Version: 0.0.10
 Summary: Youtube Autonomous Video OpenGL Module
 Author: danialcala94
 Author-email: danielalcalavalera@gmail.com

{yta_video_opengl-0.0.9 → yta_video_opengl-0.0.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "yta-video-opengl"
-version = "0.0.9"
+version = "0.0.10"
 description = "Youtube Autonomous Video OpenGL Module"
 authors = [
     {name = "danialcala94",email = "danielalcalavalera@gmail.com"}

{yta_video_opengl-0.0.9 → yta_video_opengl-0.0.10}/src/yta_video_opengl/classes.py

@@ -132,6 +132,7 @@ class _Uniforms:
         for key, value in self.uniforms.items():
             print(f'"{key}": {str(value)}')
 
+# TODO: Moved to 'nodes.opengl.py'
 class BaseNode:
     """
     The basic class of a node to manipulate frames

yta_video_opengl-0.0.10/src/yta_video_opengl/nodes/__init__.py

@@ -0,0 +1,119 @@
+from yta_validation.parameter import ParameterValidator
+from typing import Union
+from abc import ABC, abstractmethod
+
+import av
+import moderngl
+
+
+class Node(ABC):
+    """
+    Base class to represent a node, which
+    is an entity that processes frames
+    individually.
+
+    This class must be inherited by any 
+    video or audio node class.
+    """
+
+    # TODO: What about the types?
+    @abstractmethod
+    def process(
+        frame: Union[av.VideoFrame, av.AudioFrame, moderngl.Texture],
+        t: float
+        # TODO: Maybe we need 'fps' and 'number_of_frames'
+        # to calculate progressions or similar...
+    ) -> Union[av.VideoFrame, av.AudioFrame, moderngl.Texture]:
+        pass
+
+class TimedNode:
+    """
+    Class to represent a Node wrapper to
+    be able to specify the time range in
+    which we want the node to be applied.
+
+    If the 't' time moment is not inside
+    this range, the frame will be returned
+    as it is, with no change.
+
+    A 't' time moment inside the range has
+    this condition:
+    - `start <= t < end`
+
+    We are not including the end because
+    the next TimedNode could start on that
+    specific value, and remember that the
+    first time moment is 0.
+
+    This is the class that has to be applied
+    when working with videos and not a Node
+    directly.
+
+    The 'start' and 'end' values by default
+    """
+
+    def __init__(
+        self,
+        node: Node,
+        start: float = 0.0,
+        end: Union[float, None] = None
+    ):
+        ParameterValidator.validate_mandatory_positive_number('start', start, do_include_zero = True)
+        ParameterValidator.validate_positive_number('end', end, do_include_zero = False)
+
+        if (
+            end is not None and
+            end < start
+        ):
+            raise Exception('The "end" parameter provided must be greater or equal to the "start" parameter.')
+
+        self.node: Node = node
+        """
+        The node we are wrapping and we want to
+        apply as a modification of the frame in
+        which we are in a 't' time moment.
+        """
+        self.start: float = start
+        """
+        The 't' time moment in which the Node must
+        start being applied (including it).
+        """
+        self.end: Union[float, None] = end
+        """
+        The 't' time moment in which the Node must
+        stop being applied (excluding it).
+        """
+
+    def is_within_time(
+        self,
+        t: float
+    ) -> bool:
+        """
+        Flag to indicate if the 't' time moment provided
+        is in the range of this TimedNode instance, 
+        which means that it fits this condition:
+        - `start <= t < end`
+        """
+        return (
+            self.start <= t < self.end
+            if self.end is not None else
+            self.start <= t
+        )
+
+    def process(
+        self,
+        frame: Union[av.VideoFrame, av.AudioFrame, moderngl.Texture],
+        t: float
+        # TODO: Maybe we need 'fps' and 'number_of_frames'
+        # to calculate progressions or similar...
+    ) -> Union['VideoFrame', 'AudioFrame', 'Texture']:
+        """
+        Process the frame if the provided 't' time
+        moment is in the range of this TimedNode
+        instance.
+        """
+        return (
+            self.node.process(frame, t)
+            if self.is_within_time(t) else
+            frame
+        )

yta_video_opengl-0.0.10/src/yta_video_opengl/nodes/audio/__init__.py

@@ -0,0 +1,115 @@
+"""
+When working with audio frames, we don't need
+to use the GPU because audios are 1D and the
+information can be processed perfectly with
+a library like numpy.
+
+If we need a very intense calculation for an
+audio frame (FFT, convolution, etc.) we can
+use CuPy or some DPS specific libraries, but
+90% is perfectly done with numpy.
+
+If you want to modify huge amounts of audio
+(some seconds at the same time), you can use
+CuPy, that has the same API as numpy but
+working in GPU. Doing this below most of the
+changes would work:
+- `import numpy as np` → `import cupy as np`
+"""
+from yta_video_opengl.nodes import TimedNode
+from abc import abstractmethod
+from typing import Union
+
+import numpy as np
+import av
+
+
+class AudioNode:
+    """
+    Base audio node class to implement a
+    change in an audio frame by using the
+    numpy library.
+    """
+
+    @abstractmethod
+    def process(
+        self,
+        frame: av.AudioFrame,
+        t: float
+    ):
+        """
+        Process the provided audio 'frame' that
+        is played on the given 't' time moment.
+        """
+        pass
+
+"""
+Here you have an example. The 'private'
+node class is the modifier, that we don't
+want to expose, and the 'public' class is
+the one that inherits from TimedNode and
+wraps the 'private' class to build the
+functionality.
+"""
+class VolumeAudioNode(TimedNode):
+    """
+    TimedNode to set the audio volume of a video
+    in a specific frame.
+    """
+
+    def __init__(
+        self,
+        factor_fn,
+        start: float = 0.0,
+        end: Union[float, None] = None
+    ):
+        super().__init__(
+            node = _SetVolumeAudioNode(factor_fn),
+            start = start,
+            end = end
+        )
+
+class _SetVolumeAudioNode(AudioNode):
+    """
+    Audio node to change the volume of an
+    audio frame.
+    """
+
+    def __init__(
+        self,
+        factor_fn
+    ):
+        """
+        factor_fn: function (t, index) -> factor volumen
+        """
+        self.factor_fn = factor_fn
+
+    def process(
+        self,
+        frame: av.AudioFrame,
+        t: float,
+    ) -> av.AudioFrame:
+        # TODO: Why index (?) Maybe 'total_frames'
+        factor = self.factor_fn(t, 0)
+
+        samples = frame.to_ndarray().astype(np.float32)
+        samples *= factor
+
+        # Determine dtype according to format
+        samples = (
+            samples.astype(np.int16)
+            # 'fltp', 's16', 's16p'
+            if 's16' in frame.format.name else
+            samples.astype(np.float32)
+        )
+
+        new_frame = av.AudioFrame.from_ndarray(
+            samples,
+            format = frame.format.name,
+            layout = frame.layout.name
+        )
+        new_frame.sample_rate = frame.sample_rate
+        new_frame.pts = frame.pts
+        new_frame.time_base = frame.time_base
+
+        return new_frame

yta_video_opengl-0.0.10/src/yta_video_opengl/nodes/video/__init__.py

@@ -0,0 +1,5 @@
+"""
+Working with video frames has to be done
+with nodes that use OpenGL because this
+way, by using the GPU, is the best way.
+"""

yta_video_opengl-0.0.10/src/yta_video_opengl/nodes/video/opengl.py

@@ -0,0 +1,309 @@
+from yta_video_opengl.utils import frame_to_texture, get_fullscreen_quad_vao
+from yta_video_opengl.nodes import Node
+from yta_validation.parameter import ParameterValidator
+from yta_validation import PythonValidator
+from abc import abstractmethod
+from typing import Union
+
+import numpy as np
+import moderngl
+
+
+class _Uniforms:
+    """
+    Class to wrap the functionality related to
+    handling the opengl program uniforms.
+    """
+
+    @property
+    def uniforms(
+        self
+    ) -> dict:
+        """
+        The uniforms in the program, as a dict, in
+        the format `{key, value}`.
+        """
+        return {
+            key: self.program[key].value
+            for key in self.program
+            if PythonValidator.is_instance_of(self.program[key], moderngl.Uniform)
+        }
+
+    def __init__(
+        self,
+        program: moderngl.Program
+    ):
+        self.program: moderngl.Program = program
+        """
+        The program instance this handler class
+        belongs to.
+        """
+
+    def get(
+        self,
+        name: str
+    ) -> Union[any, None]:
+        """
+        Get the value of the uniform with the
+        given 'name'.
+        """
+        return self.uniforms.get(name, None)
+
+    # TODO: I need to refactor these method to
+    # accept a **kwargs maybe, or to auto-detect
+    # the type and add the uniform as it must be
+    # done
+    def set(
+        self,
+        name: str,
+        value
+    ) -> '_Uniforms':
+        """
+        Set the provided 'value' to the normal type
+        uniform with the given 'name'. Here you have
+        some examples of defined uniforms we can set
+        with this method:
+        - `uniform float name;`
+
+        TODO: Add more examples
+        """
+        if name in self.program:
+            self.program[name].value = value
+
+        return self
+    
+    def set_vec(
+        self,
+        name: str,
+        values
+    ) -> '_Uniforms':
+        """
+        Set the provided 'value' to the normal type
+        uniform with the given 'name'. Here you have
+        some examples of defined uniforms we can set
+        with this method:
+        - `uniform vec2 name;`
+
+        TODO: Is this example ok? I didn't use it yet
+        """
+        if name in self.program:
+            self.program[name].write(np.array(values, dtype = 'f4').tobytes())
+
+        return self
+
+    def set_mat(
+        self,
+        name: str,
+        value
+    ) -> '_Uniforms':
+        """
+        Set the provided 'value' to a `matN` type
+        uniform with the given 'name'. The 'value'
+        must be a NxN matrix (maybe numpy array)
+        transformed to bytes ('.tobytes()').
+        
+        This uniform must be defined in the vertex
+        like this:
+        - `uniform matN name;`
+
+        TODO: Maybe we can accept a NxN numpy 
+        array and do the .tobytes() by ourselves...
+        """
+        if name in self.program:
+            self.program[name].write(value)
+
+        return self
+    
+    def print(
+        self
+    ) -> '_Uniforms':
+        """
+        Print the defined uniforms in console.
+        """
+        for key, value in self.uniforms.items():
+            print(f'"{key}": {str(value)}')
+
+class OpenglNode(Node):
+    """
+    The basic class of a node to manipulate frames
+    as opengl textures. This node will process the
+    frame as an input texture and will generate 
+    also a texture as the output.
+
+    Nodes can be chained and the result from one
+    node can be applied on another node.
+    """
+
+    @property
+    @abstractmethod
+    def vertex_shader(
+        self
+    ) -> str:
+        """
+        The code of the vertex shader.
+        """
+        pass
+
+    @property
+    @abstractmethod
+    def fragment_shader(
+        self
+    ) -> str:
+        """
+        The code of the fragment shader.
+        """
+        pass
+
+    def __init__(
+        self,
+        context: moderngl.Context,
+        size: tuple[int, int],
+        **kwargs
+    ):
+        ParameterValidator.validate_mandatory_instance_of('context', context, moderngl.Context)
+        # TODO: Validate size
+
+        self.context: moderngl.Context = context
+        """
+        The context of the program.
+        """
+        self.size: tuple[int, int] = size
+        """
+        The size we want to use for the frame buffer
+        in a (width, height) format.
+        """
+        # Compile shaders within the program
+        self.program: moderngl.Program = self.context.program(
+            vertex_shader = self.vertex_shader,
+            fragment_shader = self.fragment_shader
+        )
+
+        # Create the fullscreen quad
+        self.quad = get_fullscreen_quad_vao(
+            context = self.context,
+            program = self.program
+        )
+
+        # Create the output fbo
+        self.output_tex = self.context.texture(self.size, 4)
+        self.output_tex.filter = (moderngl.LINEAR, moderngl.LINEAR)
+        self.fbo = self.context.framebuffer(color_attachments = [self.output_tex])
+
+        self.uniforms: _Uniforms = _Uniforms(self.program)
+        """
+        Shortcut to the uniforms functionality.
+        """
+        # Auto set uniforms dynamically if existing
+        for key, value in kwargs.items():
+            self.uniforms.set(key, value)
+
+    def process(
+        self,
+        input: Union[moderngl.Texture, 'VideoFrame', 'np.ndarray']
+    ) -> moderngl.Texture:
+        """
+        Apply the shader to the 'input', that
+        must be a frame or a texture, and return
+        the new resulting texture.
+
+        We use and return textures to maintain
+        the process in GPU and optimize it.
+        """
+        if PythonValidator.is_instance_of(input, ['VideoFrame', 'ndarray']):
+            # TODO: What about the numpy format (?)
+            input = frame_to_texture(input, self.context)
+
+        self.fbo.use()
+        self.context.clear(0.0, 0.0, 0.0, 0.0)
+
+        input.use(location = 0)
+
+        if 'texture' in self.program:
+            self.program['texture'] = 0
+
+        self.quad.render()
+
+        return self.output_tex
+    
+class WavingNode(OpenglNode):
+    """
+    Just an example, without the shaders code
+    actually, to indicate that we can use
+    custom parameters to make it work.
+    """
+
+    @property
+    def vertex_shader(
+        self
+    ) -> str:
+        return (
+            '''
+            #version 330
+            in vec2 in_vert;
+            in vec2 in_texcoord;
+            out vec2 v_uv;
+            void main() {
+                v_uv = in_texcoord;
+                gl_Position = vec4(in_vert, 0.0, 1.0);
+            }
+            '''
+        )
+
+    @property
+    def fragment_shader(
+        self
+    ) -> str:
+        return (
+            '''
+            #version 330
+            uniform sampler2D tex;
+            uniform float time;
+            uniform float amplitude;
+            uniform float frequency;
+            uniform float speed;
+            in vec2 v_uv;
+            out vec4 f_color;
+            void main() {
+                float wave = sin(v_uv.x * frequency + time * speed) * amplitude;
+                vec2 uv = vec2(v_uv.x, v_uv.y + wave);
+                f_color = texture(tex, uv);
+            }
+            '''
+        )
+
+    def __init__(
+        self,
+        context: moderngl.Context,
+        size: tuple[int, int],
+        amplitude: float = 0.05,
+        frequency: float = 10.0,
+        speed: float = 2.0
+    ):
+        super().__init__(
+            context = context,
+            size = size,
+            amplitude = amplitude,
+            frequency = frequency,
+            speed = speed
+        )
+
+    # This is just an example and we are not
+    # using the parameters actually, but we
+    # could set those specific uniforms to be
+    # processed by the code
+    def process(
+        self,
+        input: Union[moderngl.Texture, 'VideoFrame', 'np.ndarray'],
+        t: float = 0.0,
+    ) -> moderngl.Texture:
+        """
+        Apply the shader to the 'input', that
+        must be a frame or a texture, and return
+        the new resulting texture.
+
+        We use and return textures to maintain
+        the process in GPU and optimize it.
+        """
+        self.uniforms.set('time', t)
+
+        return super().process(input)

{yta_video_opengl-0.0.9 → yta_video_opengl-0.0.10}/src/yta_video_opengl/video.py

@@ -22,6 +22,9 @@ class Video:
         """
         The start packet time stamp (pts), needed 
         to optimize the packet iteration process.
+
+        This timestamp is used to read the video
+        file source.
         """
         return int(self.start / self.reader.time_base)
     
@@ -32,6 +35,9 @@ class Video:
         """
         The end packet time stamp (pts), needed to
         optimize the packet iteration process.
+
+        This timestamp is used to read the video
+        file source.
         """
         return (
             int(self.end / self.reader.time_base)
@@ -73,6 +79,15 @@ class Video:
         The duration of the video.
         """
         return self.end - self.start
+    
+    @property
+    def number_of_frames(
+        self
+    ):
+        """
+        The number of frames of the video.
+        """
+        return self.reader.number_of_frames
 
     @property
     def frames(
@@ -84,6 +99,10 @@ class Video:
         'start' and 'end' parameters provided when
         instantiating it.
 
+        The iterator will iterate first over the
+        video frames, and once finished over the
+        audio frames.
+
         This method returns a tuple of 3 elements:
         - `frame` as a `VideoFrame` instance
         - `t` as the frame time moment
@@ -95,17 +114,6 @@ class Video:
         for frame in self.reader.get_audio_frames(self.start, self.end):
             yield frame
 
-        # for frame in iterate_stream_frames_demuxing(
-        #     container = self.reader.container,
-        #     video_stream = self.reader.video_stream,
-        #     audio_stream = self.reader.audio_stream,
-        #     video_start_pts = self.start_pts,
-        #     video_end_pts = self.end_pts,
-        #     audio_start_pts = self.audio_start_pts,
-        #     audio_end_pts = self.audio_end_pts
-        # ):
-        #     yield frame
-
     def __init__(
         self,
         filename: str,
@@ -143,25 +151,46 @@ class Video:
         filename: str
     ) -> 'Video':
         writer =  VideoWriter(filename)
-        #writer.set_video_stream(self.reader.video_stream.codec.name, self.reader.fps, self.reader.size, PIXEL_FORMAT)
         writer.set_video_stream_from_template(self.reader.video_stream)
         writer.set_audio_stream_from_template(self.reader.audio_stream)
 
-        # TODO: I need to process the audio also, so
-        # build a method that do the same but for 
-        # both streams at the same time
+        from yta_video_opengl.nodes.audio import VolumeAudioNode
+        # Audio from 0 to 1
+        # TODO: This effect 'fn' is shitty
+        def fade_in_fn(t, index, start=0.5, end=1.0):
+            if t < start or t > end:
+                # fuera de la franja: no tocar nada → volumen original (1.0)
+                progress = 1.0
+            else:
+                # dentro de la franja: interpolar linealmente entre 0 → 1
+                progress = (t - start) / (end - start)
+
+            return progress
+
+        #fade_in = SetVolumeAudioNode(lambda t, i: min(1, t / self.duration))
+        fade_in = VolumeAudioNode(lambda t, i: fade_in_fn(t, i, 0.5, 1.0))
+
         for frame, t, index in self.frames:
             if PythonValidator.is_instance_of(frame, 'VideoFrame'):
                 print(f'Saving video frame {str(index)}, with t = {str(t)}')
+
+                # TODO: Process any video frame change
+
                 writer.mux_video_frame(
                     frame = frame
                 )
             else:
                 print(f'Saving audio frame {str(index)} ({str(round(float(t * self.reader.fps), 2))}), with t = {str(t)}')
+
+                # TODO: Process any audio frame change
+                # Test setting audio
+                frame = fade_in.process(frame, t)
+
                 writer.mux_audio_frame(
                     frame = frame
                 )
 
+        # Flush the remaining frames to write
         writer.mux_audio_frame(None)
         writer.mux_video_frame(None)