kivygradient 0.1.0__tar.gz

kivygradient-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kenechukwu Akubue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kivygradient-0.1.0/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: kivygradient
+Version: 0.1.0
+Summary: KivyGradient allows you to add a gradient color to your Kivy Widget
+Author: Kenechukwu Akubue
+Author-email: Kenechukwu Akubue <kengoon19@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: Android
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: BSD :: FreeBSD
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: iOS
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Scientific/Engineering :: Human Machine Interfaces
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Dist: kivy>=2.3.1
+Requires-Python: >=3.9
+Project-URL: Homepage, https://github.com/kengoon/KivyGradient
+Project-URL: Repository, https://github.com/kengoon/KivyGradient.git
+Project-URL: Documentation, https://github.com/kengoon/KivyGradient/blob/master/README.md
+Description-Content-Type: text/markdown
+
+# KivyGradient
+[![Verified on Openbase](https://badges.openbase.com/python/verified/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&amp;utm_medium=badge&amp;utm_campaign=rate-badge)
+[![Featured on Openbase](https://badges.openbase.com/python/featured/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&amp;utm_medium=badge&amp;utm_campaign=rate-badge)
+[![KivyGradient Versions](https://badges.openbase.com/python/versions/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&amp;utm_medium=badge&amp;utm_campaign=rate-badge)
+
+KivyGradient allows you to add a gradient color to your Kivy Widget
+
+## Install
+`pip install kivygradient`
+
+### Example Code
+
+```python
+from kivy.app import App
+from kivy.lang import Builder
+
+
+kv = """
+#:import get_color_from_hex kivy.utils.get_color_from_hex
+#:import Gradient kivy_gradient.Gradient
+RelativeLayout:
+    BoxLayout
+        id: box
+        on_kv_post: print(get_color_from_hex("E91E63"))
+        canvas:
+            Rectangle:
+                size: self.size
+                pos: self.pos
+                texture: Gradient.horizontal(get_color_from_hex("E91E63"), get_color_from_hex("FCE4EC"))
+"""
+
+
+class Test(App):
+    def build(self):
+        return Builder.load_string(kv)
+
+    def on_stop(self):
+        self.root.ids.box.export_to_png("gradient.png")
+        
+
+Test().run()
+```
+![gradient](https://user-images.githubusercontent.com/42192162/132244508-113ea626-371f-486f-9702-fdea0f4214a7.png)
+
+
+```python
+from kivy.app import App
+from kivy.lang import Builder
+
+
+kv = """
+#:import get_color_from_hex kivy.utils.get_color_from_hex
+#:import Gradient kivy_gradient.Gradient
+RelativeLayout:
+    BoxLayout
+        id: box
+        canvas:
+            Rectangle:
+                size: self.size
+                pos: self.pos
+                texture: 
+                    Gradient.horizontal(
+                    get_color_from_hex("E91E63"), 
+                    get_color_from_hex("FCE4EC"), 
+                    get_color_from_hex("2962FF")
+                    )
+"""
+
+
+class Test(App):
+    def build(self):
+        return Builder.load_string(kv)
+
+    def on_stop(self):
+        self.root.ids.box.export_to_png("gradient.png")
+        
+
+Test().run()
+
+```
+
+![gradient](https://user-images.githubusercontent.com/42192162/132247485-bb48a2ed-ff48-4388-8fff-68a7eb11f69e.png)

kivygradient-0.1.0/README.md

@@ -0,0 +1,82 @@
+# KivyGradient
+[![Verified on Openbase](https://badges.openbase.com/python/verified/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge)
+[![Featured on Openbase](https://badges.openbase.com/python/featured/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge)
+[![KivyGradient Versions](https://badges.openbase.com/python/versions/KivyGradient.svg?token=uB6Wpsv+XO63mMbzByWnKIP6GTMZsQ5CXr4PQvqrqU8=)](https://openbase.com/python/KivyGradient?utm_source=embedded&utm_medium=badge&utm_campaign=rate-badge)
+
+KivyGradient allows you to add a gradient color to your Kivy Widget
+
+## Install
+`pip install kivygradient`
+
+### Example Code
+
+```python
+from kivy.app import App
+from kivy.lang import Builder
+
+
+kv = """
+#:import get_color_from_hex kivy.utils.get_color_from_hex
+#:import Gradient kivy_gradient.Gradient
+RelativeLayout:
+    BoxLayout
+        id: box
+        on_kv_post: print(get_color_from_hex("E91E63"))
+        canvas:
+            Rectangle:
+                size: self.size
+                pos: self.pos
+                texture: Gradient.horizontal(get_color_from_hex("E91E63"), get_color_from_hex("FCE4EC"))
+"""
+
+
+class Test(App):
+    def build(self):
+        return Builder.load_string(kv)
+
+    def on_stop(self):
+        self.root.ids.box.export_to_png("gradient.png")
+        
+
+Test().run()
+```
+![gradient](https://user-images.githubusercontent.com/42192162/132244508-113ea626-371f-486f-9702-fdea0f4214a7.png)
+
+
+```python
+from kivy.app import App
+from kivy.lang import Builder
+
+
+kv = """
+#:import get_color_from_hex kivy.utils.get_color_from_hex
+#:import Gradient kivy_gradient.Gradient
+RelativeLayout:
+    BoxLayout
+        id: box
+        canvas:
+            Rectangle:
+                size: self.size
+                pos: self.pos
+                texture: 
+                    Gradient.horizontal(
+                    get_color_from_hex("E91E63"), 
+                    get_color_from_hex("FCE4EC"), 
+                    get_color_from_hex("2962FF")
+                    )
+"""
+
+
+class Test(App):
+    def build(self):
+        return Builder.load_string(kv)
+
+    def on_stop(self):
+        self.root.ids.box.export_to_png("gradient.png")
+        
+
+Test().run()
+
+```
+
+![gradient](https://user-images.githubusercontent.com/42192162/132247485-bb48a2ed-ff48-4388-8fff-68a7eb11f69e.png)

kivygradient-0.1.0/kivy_gradient/__init__.py

@@ -0,0 +1,153 @@
+from itertools import chain
+
+from kivy.graphics.texture import Texture
+
+
+class Gradient(object):
+    """
+    Utility class for creating horizontal and vertical gradient textures.
+
+    This class provides static methods to generate gradient textures either
+    horizontally or vertically, based on the provided colors. It is primarily
+    used in graphical rendering contexts where gradient textures are needed.
+    """
+    @staticmethod
+    def horizontal(*args):
+        """
+        Generates a horizontal gradient texture using the provided colors.
+
+        This method creates a gradient based on the RGBA values provided as arguments.
+        Each color should be represented as a tuple of four floats in the range [0, 1],
+        corresponding to red, green, blue, and alpha channels. The resulting texture
+        is configured to display the gradient horizontally.
+
+        :param args: The colors to use for the gradient, each represented as a tuple
+            of four floats (red, green, blue, alpha). At least one color must be provided.
+        :type args: tuple[float, float, float, float]
+        :raises ValueError: If no colors are provided in the arguments.
+        :return: A `Texture` object containing the horizontal gradient.
+        :rtype: Texture
+        """
+        if not args:
+            raise ValueError('Gradient.horizontal() requires at least one color')
+        size = len(args)
+        texture = Texture.create(size=(size, 1), colorfmt='rgba')
+        buf = bytes([int(v * 255) for v in chain(*args)])  # flattens
+
+        texture.blit_buffer(buf, colorfmt='rgba', bufferfmt='ubyte')
+
+        if size < 2:
+            return texture
+
+        texture.uvpos = (0.5 / size, 0)
+        texture.uvsize = ((size - 1) / size, 1)
+        return texture
+
+    @staticmethod
+    def vertical(*args):
+        """
+        Creates a vertical gradient texture from the provided colors. The gradient is composed
+        of the colors given as arguments and interpolates between them vertically.
+
+        :param args: A variable number of colors specified as tuples of RGBA values
+                     (each component should be in the range [0.0, 1.0]). A minimum of
+                     one color is required. If multiple colors are provided, the gradient
+                     will interpolate between them.
+        :type args: tuple
+        :return: A Texture object representing the vertical gradient. The texture will
+                 have interpolated UV position and size based on the number of colors
+                 provided.
+        :rtype: Texture
+        :raises ValueError: If no colors are provided.
+        """
+        if not args:
+            raise ValueError('Gradient.vertical() requires at least one color')
+        size = len(args)
+        texture = Texture.create(size=(1, size), colorfmt='rgba')
+        buf = bytes([int(v * 255) for v in chain(*args)])  # flattens
+
+        texture.blit_buffer(buf, colorfmt='rgba', bufferfmt='ubyte')
+
+        if size < 2:
+            return texture
+
+        texture.uvpos = (0, 0.5 / size)
+        texture.uvsize = (1, (size - 1) / size)
+        return texture
+
+
+def save_pixel_as_png(width, height, pixel_data, filename=None):
+    """
+    Generates a PNG image byte sequence based on given pixel data and saves it to
+    a file if a filename is provided.
+
+    This function constructs a PNG image file by assembling the required PNG
+    chunks: IHDR, IDAT, and IEND. It generates the image bytes and writes them
+    to a specified file if a valid filename is provided.
+
+    :param width: The width of the image in pixels.
+    :type width: int
+    :param height: The height of the image in pixels.
+    :type height: int
+    :param pixel_data: A byte sequence containing the pixel data of the image.
+        Each pixel should be represented by four bytes (RGBA format).
+    :type pixel_data: bytes
+    :param filename: The optional filename where the PNG file will be saved. If
+        not provided, the generated PNG data will not be saved to disk.
+    :type filename: str or None
+    :return: A byte sequence representing the constructed PNG image.
+    :rtype: bytes
+
+    """
+    # Prepare PNG header
+    png_header = b'\x89PNG\r\n\x1a\n'
+
+    # IHDR chunk
+    ihdr = (
+            struct.pack(">I", width)
+            + struct.pack(">I", height)
+            + b'\x08\x06\x00\x00\x00'
+    )
+    ihdr_crc = struct.pack(
+        ">I",
+        zlib.crc32(b'IHDR' + ihdr) & 0xffffffff
+    )
+    ihdr_chunk = (
+            struct.pack(">I", len(ihdr))
+            + b'IHDR' + ihdr + ihdr_crc
+    )
+
+    # IDAT chunk
+    # Rearrange the pixels into scanlines
+    scanlines = b''.join(
+        b'\x00' + pixel_data[4 * i * width: 4 * (i + 1) * width]
+        for i in range(height)
+    )
+    compressed_data = zlib.compress(scanlines)
+    idat_crc = struct.pack(
+        ">I",
+        zlib.crc32(b'IDAT' + compressed_data) & 0xffffffff
+    )
+    idat_chunk = (
+            struct.pack(">I", len(compressed_data))
+            + b'IDAT' + compressed_data + idat_crc
+    )
+
+    # IEND chunk
+    iend_chunk = (
+            struct.pack(">I", 0)
+            + b'IEND'
+            + struct.pack(">I", zlib.crc32(b'IEND') & 0xffffffff)
+    )
+
+    image_byte = png_header + ihdr_chunk + idat_chunk + iend_chunk
+
+    # Write all chunks to the file
+    if filename:
+        with open(filename, 'wb') as f:
+            f.write(png_header)
+            f.write(ihdr_chunk)
+            f.write(idat_chunk)
+            f.write(iend_chunk)
+
+    return image_byte

kivygradient-0.1.0/kivy_gradient/gradient.py

@@ -0,0 +1,129 @@
+__all__ = ("Gradient",)
+
+from kivy.app import App
+from kivy.uix.boxlayout import BoxLayout
+from kivy.uix.widget import Widget
+from kivy.graphics import RenderContext
+from kivy.core.window import Window
+from kivy.clock import mainthread
+from kivy.properties import NumericProperty, ListProperty, BooleanProperty, ColorProperty
+
+shader_code = '''
+#ifdef GL_ES
+    precision highp float;
+#endif
+
+uniform vec2 u_resolution;
+uniform vec2 u_position;
+uniform float u_angle;
+uniform bool u_circular;
+uniform vec4 u_color_start;
+uniform vec4 u_color_end;
+
+void main() {
+    // Normalized coordinates (0–1)
+    vec2 uv = (gl_FragCoord.xy - u_position) / u_resolution;
+
+    // Convert angle to radians
+    float rad = radians(u_angle);
+
+    // Move origin to center and fix aspect ratio
+    vec2 centered = uv - 0.5;
+    float mixValue;
+
+    if (!u_circular) {
+        centered.x *= u_resolution.x / u_resolution.y;
+
+        // Direction vector of gradient
+        vec2 direction = vec2(cos(rad), sin(rad));
+
+        // Linear projection onto gradient direction
+        mixValue = dot(centered, direction) + 0.5;
+    } else {
+        // Rotation matrix
+        mat2 rotation = mat2(cos(rad), -sin(rad),
+                             sin(rad),  cos(rad));
+        vec2 rotated = rotation * centered + 0.5;
+        mixValue = distance(rotated, vec2(0.0, 1.0));
+    }
+
+    // Blend the colors
+    vec4 finalColor = mix(u_color_start, u_color_end, clamp(mixValue, 0.0, 1.0));
+
+    gl_FragColor = finalColor;
+}
+'''
+
+
+class Gradient(Widget):
+    """
+    Represents a gradient widget capable of rendering a smooth transition between
+    two colors, either linearly or circularly. This class provides fine-grained
+    control over the gradient's appearance through adjustable properties such
+    as angle, start color, end color, and whether the gradient should be circular.
+
+    The class uses a custom `RenderContext` for rendering, enabling the application
+    of fragment shaders to create high-performance gradient effects.
+
+    :ivar angle: The angle of the gradient in degrees. Defaults to 90 degrees.
+    :type angle: float
+    :ivar color_start: The RGBA start color of the gradient. Defaults to [0, 0, 0, 0].
+    :type color_start: list[float]
+    :ivar color_end: The RGBA end color of the gradient. Defaults to [0, 0, 0, 0].
+    :type color_end: list[float]
+    :ivar circular: Indicates whether the gradient is circular. Defaults to False.
+    :type circular: bool
+    """
+    angle = NumericProperty(90)
+    color_start = ColorProperty([0, 0, 0, 0])
+    color_end = ColorProperty([0, 0, 0, 0])
+    circular = BooleanProperty(False)
+
+    def __init__(self, **kwargs):
+        # Use a RenderContext instead of normal canvas
+        super().__init__(**kwargs)
+        self.canvas = RenderContext(
+            use_parent_projection=True,
+            use_parent_modelview=True,
+            fs=shader_code,
+        )
+        fbind = self.fbind
+        fbind("angle", self._update_shader)
+        fbind("color_start", self._update_shader)
+        fbind("color_end", self._update_shader)
+        fbind("circular", self._update_shader)
+        fbind("size", self._update_shader)
+        fbind("pos", self._update_shader)
+
+        # with self.canvas:
+        #     self.rect = Triangle(points=[0, 0, Window.width/2, Window.height, Window.width, 0])
+        self._setup()
+
+    @mainthread
+    def _setup(self, *args):
+        self._update_shader()
+
+    # def on_size(self, *args):
+    #     self.canvas['u_resolution'] = list(map(float, self.size))
+
+    def _update_shader(self, *args):
+        self.canvas['u_angle'] = float(self.angle)
+        self.canvas['u_color_start'] = list(map(float, self.color_start))
+        self.canvas['u_color_end'] = list(map(float, self.color_end))
+        self.canvas['u_circular'] = int(self.circular)
+        self.canvas['u_resolution'] = list(map(float, self.size))
+        self.canvas['u_position'] = list(map(float, self.pos))
+
+
+if __name__ == '__main__':
+    from kivy.graphics import Rectangle
+
+    class ShaderGradientApp(App):
+        def build(self):
+            d = Gradient()
+            with d.canvas:
+                rect = Rectangle(size=Window.size, pos=(0, 0))
+            Window.bind(size=lambda _, s: setattr(rect, 'size', s))
+            return d
+
+    ShaderGradientApp().run()

kivygradient-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[project]
+name = "kivygradient"
+version = "0.1.0"
+description = "KivyGradient allows you to add a gradient color to your Kivy Widget"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = ["kivy>=2.3.1"]
+classifiers = [
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Operating System :: Android",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: POSIX :: BSD :: FreeBSD",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: iOS",
+    "Operating System :: MacOS",
+    "Operating System :: MacOS :: MacOS X",
+    "Environment :: MacOS X",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Science/Research",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Scientific/Engineering :: Human Machine Interfaces",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[[project.authors]]
+name = "Kenechukwu Akubue"
+email = "kengoon19@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/kengoon/KivyGradient"
+Repository = "https://github.com/kengoon/KivyGradient.git"
+Documentation = "https://github.com/kengoon/KivyGradient/blob/master/README.md"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "kivy_gradient"
+module-root = ""

kivygradient-0.1.0/pyproject.toml.orig

@@ -0,0 +1,56 @@
+[project]
+name = "kivygradient"
+version = "0.1.0"
+description = "KivyGradient allows you to add a gradient color to your Kivy Widget"
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "kivy>=2.3.1",
+]
+authors = [
+    { name = "Kenechukwu Akubue", email = "kengoon19@gmail.com" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Operating System :: Android",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: POSIX :: BSD :: FreeBSD",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: iOS",
+    "Operating System :: MacOS",
+    "Operating System :: MacOS :: MacOS X",
+    "Environment :: MacOS X",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: Science/Research",
+    "Topic :: Software Development :: User Interfaces",
+    "Topic :: Scientific/Engineering :: Human Machine Interfaces",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+Homepage = "https://github.com/kengoon/KivyGradient"
+Repository = "https://github.com/kengoon/KivyGradient.git"
+Documentation = "https://github.com/kengoon/KivyGradient/blob/master/README.md"
+
+[build-system]
+requires = ["uv_build>=0.12.17,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "kivy_gradient"
+module-root = ""