Merging development branch with the master. Updating the master branch to v1.1

Merging the developed version with the main branch

Author: LukovDev

src/gdf/__init__.py

@@ -12,7 +12,7 @@
 
 
 # Получить версию библиотеки:
-def get_version() -> str: return "v1.0-release"
+def get_version() -> str: return "v1.1-release"
 
 
 # Получить полное название системы:

src/gdf/audio/al.py

@@ -7,6 +7,18 @@
 import openal as al
 from openal import alc
 
+
+# Флаг о том, что openal был закрыт:
+_opengl_quited_ = False
+
+
+# Закрыть OpenAL:
+def al_quit() -> None:
+    global _opengl_quited_
+    if _opengl_quited_: return
+    _opengl_quited_ = True
+    al.oalQuit()
+
+
 # Если наша программа вылетит из за ошибки, то перед её завершением, выполним функцию ниже в любом случае:
-import atexit
-atexit.register(al.oalQuit)
+import atexit ; atexit.register(al_quit)

src/gdf/audio/environment.py

@@ -11,9 +11,10 @@
 
 # Класс звукового окружения:
 class SoundEnvironment:
-    def __init__(self, listener: Listener) -> None:
+    def __init__(self, listener: Listener, volume: float = 1.0) -> None:
         self.listener = listener  # Слушатель.
         self.sounds   = []        # Список звуков.
+        self.volume   = volume    # Громкость всех звуков в окружении.
 
     # Обновление среды:
     def update(self) -> "SoundEnvironment":
@@ -22,7 +23,8 @@ def update(self) -> "SoundEnvironment":
             distance = length(self.listener.position.xy-sound.get_position().xy)
             min_dst, max_dst, rolloff = sound.get_min_distance(), sound.get_max_distance(), sound.get_rolloff_factor()
             normal_val = (distance-max_dst)/(min_dst-max_dst) if min_dst != max_dst else distance-min_dst
-            sound.set_volume(smoothstep(0.0, 1.0, normal_val**rolloff if distance < max_dst else 0.0))
+            volume = smoothstep(0.0, 1.0, normal_val**rolloff if distance < max_dst else 0.0)
+            sound.set_volume(max(volume*float(self.volume), 0.0))
         return self
 
     # Добавить новый звук в окружающую среду:

src/gdf/audio/sound.py

@@ -10,16 +10,18 @@
 
 # Класс звука:
 class Sound:
-    def __init__(self) -> None:
+    def __init__(self, file_path: str = None) -> None:
+        self.path         = file_path
         self.sound        = None
         self._is_playing_ = False
         self._is_paused_  = False
         self._is_loop_    = False
 
     # Загрузить звук:
-    def load(self, file_path: str) -> "Sound":
+    def load(self, file_path: str = None) -> "Sound":
+        self.path = file_path if isinstance(file_path, str) else self.path
         # Пытаемся загрузить:
-        try: self.sound = al.oalOpen(file_path)
+        try: self.sound = al.oalOpen(file_path if isinstance(file_path, str) else self.path)
         except Exception as error:
             raise Exception(f"Error in \"Sound.load()\": {error}\n")
         self.set_min_distance(100.0)

src/gdf/setup.bat renamed to src/gdf/compile.bat

@@ -3,7 +3,7 @@
 echo COMPILING CYTHON FILES:
 echo.
 
-python setup.py build_ext --inplace
+python compile.py build_ext --inplace
 
 echo.
 pause

src/gdf/setup.py renamed to src/gdf/compile.py

@@ -1,5 +1,5 @@
 #
-# setup.py - В основном нужен для компиляции Cython файлов и для прочих настроек ядра.
+# compile.py - В основном нужен для компиляции Cython файлов и для прочих настроек ядра.
 #
 # Запуск этого скрипта: python setup.py build_ext --inplace
 #
@@ -8,6 +8,7 @@
 # Импортируем:
 import os
 import glob
+import numpy
 import shutil
 from setuptools import setup, Extension
 from Cython.Build import cythonize
@@ -40,15 +41,20 @@ def clear() -> None:
     pyx_file = file[:-4] + ".pyx"
     os.rename(file, pyx_file)  # Переименовать .cyt в .pyx
 
+
 # Устанавливаем ядро:
-setup(
-    ext_modules=cythonize([
-        Extension(
-            name=os.path.splitext(os.path.relpath(file))[0].replace(os.path.sep, "."),
-            sources=[file]
-        ) for file in find_files("pyx")
-    ])
-)
+try:
+    setup(
+        ext_modules=cythonize([
+            Extension(
+                name=os.path.splitext(os.path.relpath(file))[0].replace(os.path.sep, "."),
+                sources=[file],
+                include_dirs=[numpy.get_include()]
+            ) for file in find_files("pyx")
+        ])
+    )
+except Exception as error: pass
+
 
 # Переименовать файлы обратно из .pyx в .cyt:
 for file in find_files("pyx"):

src/gdf/files.py

@@ -5,6 +5,7 @@
 
 # Импортируем:
 import os
+import io
 import json
 import pygame
 import zipfile
@@ -39,7 +40,8 @@ def save_texture(file_path: str, texture: Texture) -> None:
 
 
 # Загружаем файл:
-def load_file(file_path: str, mode: str = "r+", encoding: str = "utf-8") -> str:
+def load_file(file_path: str | io.BytesIO, mode: str = "r+", encoding: str = "utf-8") -> str:
+    if isinstance(file_path, io.BytesIO): return file_path.getvalue().decode(encoding)
     with open(file_path, mode, encoding=encoding) as f: return str(f.read())
 
 
@@ -79,16 +81,20 @@ def load_font(file_path: str) -> FontFile:
 
 
 # Создаем zip-файл и добавляем файлы и папки из списка:
-def create_zip_file(file_path: str, file_folder_list: list) -> None:
-    with zipfile.ZipFile(file_path, "w") as zipf:
+def create_zip_file(file_path: str, file_folder_list: list | str) -> None:
+    if isinstance(file_folder_list, str): file_folder_list = [file_folder_list]
+
+    with zipfile.ZipFile(file_path, "w", zipfile.ZIP_DEFLATED) as zipf:
         for item in file_folder_list:
-            if os.path.isfile(item):
-                zipf.write(item, os.path.basename(item))
+            if os.path.isfile(item): zipf.write(item, os.path.basename(item))
             elif os.path.isdir(item):
+                # Обходим все подкаталоги и файлы:
                 for root, dirs, files in os.walk(item):
                     for file in files:
-                        file_path = os.path.join(root, file)
-                        zipf.write(file_path, os.path.relpath(file_path, os.path.join(item, "..")))
+                        current_file_path = os.path.join(root, file)
+                        # Проверяем, чтобы не добавлять сам архив в себя:
+                        if os.path.abspath(current_file_path) != os.path.abspath(file_path):
+                            zipf.write(current_file_path, os.path.relpath(current_file_path, os.path.join(item, "..")))
 
 
 # Извлекаем файлы из zip-файла:

src/gdf/graphics/__init__.py

@@ -11,7 +11,12 @@
 # Ускоренная функция поворота вершин полигона спрайта:
 try:
     # Импортируем скомпилированную библиотеку графических утилит:
-    from .graphics_utils import _rot2d_vertices_rectangle_, _convert_quads_to_triangles_
+    from .graphics_utils import (
+        _rot2d_vertices_rectangle_,
+        _convert_quads_to_triangles_,
+        _render_sprite_batch_2d_,
+        _render_atlas_texture_batch_2d_
+    )
 except (ModuleNotFoundError, ImportError) as error:
     raise Exception(f"The compiled module could not be imported: {error}")
 

src/gdf/graphics/batch.py

@@ -9,7 +9,7 @@
 from .sprite import Sprite2D
 from .texture import Texture
 from .atlas import AtlasTexture
-from . import _rot2d_vertices_rectangle_
+from . import _rot2d_vertices_rectangle_, _render_sprite_batch_2d_, _render_atlas_texture_batch_2d_
 from ..math import *
 from ..utils import *
 
@@ -38,8 +38,8 @@ def draw(self,
              sprite:       Sprite2D | Texture,
              x:            float,
              y:            float,
-             width:        int,
-             height:       int,
+             width:        float,
+             height:       float,
              angle:        float = 0.0,
              cull_sprites: bool  = False
              ) -> "SpriteBatch2D":
@@ -95,21 +95,8 @@ def render(self, color: list = None, clear_batch: bool = True) -> "SpriteBatch2D
 
         gl.glColor(*[1, 1, 1] if color is None else color)
 
-        gl.glEnable(gl.GL_TEXTURE_2D)
-        gl.glEnableClientState(gl.GL_VERTEX_ARRAY)
-        gl.glEnableClientState(gl.GL_TEXTURE_COORD_ARRAY)
-
-        # Пройдитесь по каждой текстуре и отрендерьте все квадраты с этой текстурой:
-        for texture, vertices in self.texture_batches.items():
-            gl.glBindTexture(gl.GL_TEXTURE_2D, texture)
-            gl.glVertexPointer(2, gl.GL_DOUBLE, 0, numpy.array(vertices))
-            gl.glTexCoordPointer(2, gl.GL_DOUBLE, 0, numpy.array([0, 1, 1, 1, 1, 0, 0, 0] * (len(vertices) // 8)))
-            gl.glDrawArrays(gl.GL_QUADS, 0, len(vertices) // 2)
-        gl.glBindTexture(gl.GL_TEXTURE_2D, 0)
-
-        gl.glDisableClientState(gl.GL_TEXTURE_COORD_ARRAY)
-        gl.glDisableClientState(gl.GL_VERTEX_ARRAY)
-        gl.glDisable(gl.GL_TEXTURE_2D)
+        # Рисуем пакет спрайтов через ускоренную функцию Cython:
+        _render_sprite_batch_2d_(self.texture_batches)
 
         if clear_batch: self.texture_batches.clear()
 
@@ -197,21 +184,8 @@ def render(self, color: list = None, clear_batch: bool = True) -> "AtlasTextureB
 
         gl.glColor(*[1, 1, 1] if color is None else color)
 
-        gl.glEnable(gl.GL_TEXTURE_2D)
-        gl.glEnableClientState(gl.GL_VERTEX_ARRAY)
-        gl.glEnableClientState(gl.GL_TEXTURE_COORD_ARRAY)
-
-        # Пройдитесь по каждой текстуре и отрендерьте все квадраты с этой текстурой:
-        for texture, (vertices, texcoords) in self.texture_batches.items():
-            gl.glBindTexture(gl.GL_TEXTURE_2D, texture)
-            gl.glVertexPointer(2, gl.GL_DOUBLE, 0, numpy.array(vertices))
-            gl.glTexCoordPointer(2, gl.GL_DOUBLE, 0, numpy.array(texcoords))
-            gl.glDrawArrays(gl.GL_QUADS, 0, len(vertices) // 2)
-        gl.glBindTexture(gl.GL_TEXTURE_2D, 0)
-
-        gl.glDisableClientState(gl.GL_TEXTURE_COORD_ARRAY)
-        gl.glDisableClientState(gl.GL_VERTEX_ARRAY)
-        gl.glDisable(gl.GL_TEXTURE_2D)
+        # Рисуем пакет спрайтов через ускоренную функцию Cython:
+        _render_atlas_texture_batch_2d_(self.texture_batches)
 
         if clear_batch: self.texture_batches.clear()
 

src/gdf/graphics/buffers.py

@@ -65,9 +65,14 @@ class FrameBuffer:
     def __init__(self, texture_id: int) -> None:
         self.id = gl.glGenFramebuffers(1)
         self._id_before_begin_ = gl.glGetIntegerv(gl.GL_FRAMEBUFFER_BINDING)
-        gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, self.id)
-        gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, gl.GL_COLOR_ATTACHMENT0, gl.GL_TEXTURE_2D, texture_id, 0)
-        gl.glBindFramebuffer(gl.GL_FRAMEBUFFER, self._id_before_begin_)
+        self.attach_texture(texture_id, gl.GL_COLOR_ATTACHMENT0)
+
+    # Привязать текстуру к фреймбуферу:
+    def attach_texture(self, texture_id: int, attach_type: int = gl.GL_COLOR_ATTACHMENT0) -> "FrameBuffer":
+        self.begin()
+        gl.glFramebufferTexture2D(gl.GL_FRAMEBUFFER, attach_type, gl.GL_TEXTURE_2D, texture_id, 0)
+        self.end()
+        return self
 
     # Использовать буфер:
     def begin(self) -> "FrameBuffer":