aether-engine 1.8.0__tar.gz → 1.8.1__tar.gz

{aether_engine-1.8.0 → aether_engine-1.8.1}/MANIFEST.in

@@ -1,13 +1,16 @@
 include README.md
 include LICENSE
 include pyproject.toml
+include docs/GUIDE.md
 
 recursive-include aether *.py
 recursive-include aether *.glsl
 recursive-include aether *.vert
 recursive-include aether *.frag
 recursive-include aether *.json
+recursive-include aether *.md
 recursive-include aether/assets *
+recursive-include aether/docs *
 
 recursive-include examples *.py
 

{aether_engine-1.8.0/aether_engine.egg-info → aether_engine-1.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aether-engine
-Version: 1.8.0
+Version: 1.8.1
 Summary: 3D/2D game engine by entiti937 — OpenGL, physics, FPS, mandatory branding splash
 Home-page: https://pypi.org/project/aether-engine/
 Author: entiti937
@@ -31,13 +31,13 @@ Requires-Dist: trimesh>=3.21; extra == "models"
 Provides-Extra: build
 Requires-Dist: pyinstaller>=6.0; extra == "build"
 Provides-Extra: full
-Requires-Dist: pygame-ce>=2.5; extra == "full"
-Requires-Dist: trimesh>=3.21; extra == "full"
+Requires-Dist: pymunk>=6.0; extra == "full"
 Requires-Dist: imageio>=2.31; extra == "full"
-Requires-Dist: pyinstaller>=6.0; extra == "full"
 Requires-Dist: pyyaml>=6.0; extra == "full"
-Requires-Dist: pymunk>=6.0; extra == "full"
+Requires-Dist: pyinstaller>=6.0; extra == "full"
 Requires-Dist: freetype-py>=2.4; extra == "full"
+Requires-Dist: trimesh>=3.21; extra == "full"
+Requires-Dist: pygame-ce>=2.5; extra == "full"
 Dynamic: author
 Dynamic: classifier
 Dynamic: description
@@ -52,7 +52,7 @@ Dynamic: summary
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.8.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.8.1 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
 > Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md) · сайт: `aether website`
@@ -70,6 +70,12 @@ import aether          # правильно
 # import aether_engine  # НЕПРАВИЛЬНО — такого модуля нет
 ```
 
+## Что нового в 1.8.1
+
+- `Hud.draw_bar(x, y, w, h, value, max_value, color)` — простой и понятный вызов
+- `aether docs` печатает **полный** GUIDE.md (гайд вшит в пакет)
+- Координаты HUD явно: (0,0) = центр экрана
+
 ## Что нового в 1.8.0
 
 - `Scene.remove()` / `despawn()` / `find()`

{aether_engine-1.8.0 → aether_engine-1.8.1}/README.md

@@ -1,7 +1,7 @@
 # Aether Engine
 
 **3D / 2D игровой движок на Python + OpenGL**  
-**Разработчик:** entiti937 · **Версия:** 1.8.0 · **Лицензия:** MIT  
+**Разработчик:** entiti937 · **Версия:** 1.8.1 · **Лицензия:** MIT  
 **PyPI:** https://pypi.org/project/aether-engine/
 
 > Полное руководство: [`docs/GUIDE.md`](docs/GUIDE.md) · сайт: `aether website`
@@ -19,6 +19,12 @@ import aether          # правильно
 # import aether_engine  # НЕПРАВИЛЬНО — такого модуля нет
 ```
 
+## Что нового в 1.8.1
+
+- `Hud.draw_bar(x, y, w, h, value, max_value, color)` — простой и понятный вызов
+- `aether docs` печатает **полный** GUIDE.md (гайд вшит в пакет)
+- Координаты HUD явно: (0,0) = центр экрана
+
 ## Что нового в 1.8.0
 
 - `Scene.remove()` / `despawn()` / `find()`

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/__init__.py

@@ -31,7 +31,7 @@ from aether.audio.sfx import SfxBank
 from aether.resources.save_load import save_json, load_json
 from aether.physics.raycast import Raycaster
 
-__version__ = "1.8.0"
+__version__ = "1.8.1"
 
 from aether.graphics.voxel_mesh import ChunkedVoxelMesher
 from aether.accelerators import is_native_available, backend_name

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/cli.py

@@ -60,10 +60,15 @@ TRANSFORM
   tf.set_position(x,y,z) / set_rotation / set_scale
   tf.translate(dx,dy,dz)
 
-HUD
+HUD (координаты: 0,0 = ЦЕНТР экрана, +Y вверх; текста нет — пишите в title)
+  from aether import Hud
   engine.draw_hud = True
   hud = Hud(engine.renderer2d)
-  hud.clear(); hud.draw_crosshair(); hud.draw_bar(...); hud.draw_hotbar(...)
+  hud.clear()
+  # draw_bar(x, y, width, height, value, max_value, color)
+  hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
+  hud.draw_crosshair()
+  engine.window.set_title(f"HP {{hp}}")
 
 FPS / КАМЕРА
   engine.enable_first_person(camera, eye_height=1.7, walk_speed=6)
@@ -109,13 +114,13 @@ NPC / НАГРАДЫ (RUST, опционально)
   aether build my_game.py --name MyGame --console
 
 ИНСТРУМЕНТЫ
-  aether help          — эта справка
-  aether docs          — краткий гайд по API
-  aether website       — documentation site (domain in bell notifications)
+  aether help          — краткая шпаргалка
+  aether docs          — ПОЛНЫЙ гайд (весь GUIDE.md в терминал)
+  aether website       — HTML-сайт документации
   python -m aether website
   python games/aether_craft.py
 
-ПОЛНАЯ ДОКУМЕНТАЦИЯ: docs/GUIDE.md
+ПОЛНАЯ ДОКУМЕНТАЦИЯ: aether docs   |   сайт: aether website
 PyPI: https://pypi.org/project/aether-engine/
 """
 
@@ -126,12 +131,29 @@ def cmd_help(_args):
 
 
 def cmd_docs(_args):
-    guide = Path(__file__).resolve().parents[2] / "docs" / "GUIDE.md"
-    if guide.exists():
-        print(guide.read_text(encoding="utf-8"))
-    else:
-        print(QUICK_REFERENCE)
-    return 0
+    """Print the full bundled developer guide."""
+    here = Path(__file__).resolve().parent
+    candidates = [
+        here / "docs" / "GUIDE.md",
+        here.parents[1] / "docs" / "GUIDE.md",
+        here.parents[0] / "docs" / "GUIDE.md",
+    ]
+    for guide in candidates:
+        if guide.exists():
+            text = guide.read_text(encoding="utf-8")
+            try:
+                sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+            except Exception:
+                pass
+            try:
+                print(text)
+            except UnicodeEncodeError:
+                sys.stdout.buffer.write(text.encode("utf-8", errors="replace"))
+                sys.stdout.buffer.write(b"\n")
+            return 0
+    print(QUICK_REFERENCE)
+    print("\n[aether docs] GUIDE.md not found in package — reinstall: pip install -U aether-engine")
+    return 1
 
 
 def cmd_build(args):
@@ -161,8 +183,8 @@ def main(argv=None):
 
     sub = parser.add_subparsers(dest="command")
 
-    sub.add_parser("help", help="Краткая справка по API и командам").set_defaults(func=cmd_help)
-    sub.add_parser("docs", help="Полная документация").set_defaults(func=cmd_docs)
+    sub.add_parser("help", help="Краткая шпаргалка").set_defaults(func=cmd_help)
+    sub.add_parser("docs", help="Полный гайд разработчика (весь GUIDE.md)").set_defaults(func=cmd_docs)
 
     p_build = sub.add_parser("build", help="Собрать игру в .exe (PyInstaller)")
     p_build.add_argument("script", help="Путь к main.py игры")

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/core/_identity.py

@@ -20,7 +20,7 @@ _B = {
     ]),
     "sig": bytes([
         230, 194, 211, 207, 194, 213, 135, 226, 201, 192, 206, 201, 194,
-        135, 150, 137, 159, 137, 151,
+        135, 150, 137, 159, 137, 150,
     ]),
 }
 

aether_engine-1.8.1/aether/docs/GUIDE.md

@@ -0,0 +1,270 @@
+# Aether Engine — Full Developer Guide
+
+**Version:** 1.8.1 · **Author:** entiti937 · **License:** MIT  
+**PyPI package:** `aether-engine`  
+**Python import:** `import aether`  ← NEVER `import aether_engine`
+
+Commands:
+- `aether help` — short cheat sheet
+- `aether docs` — **this full guide** (printed to terminal)
+- `aether website` — local HTML docs (+ `/plain/all` for AI)
+
+---
+
+## 0. Exact package names
+
+```bash
+pip install -U "aether-engine[full]"
+```
+
+```python
+from aether import Engine, Scene, Entity, Transform, MeshRenderer
+from aether import MeshFactory, Material, Camera, Hud, HudBar, Sprite, AssetLoader
+```
+
+---
+
+## 1. Minimal 3D game
+
+```python
+from aether import (
+    Engine, Scene, Entity, Transform, MeshRenderer,
+    MeshFactory, Material, Camera,
+)
+
+engine = Engine(1280, 720, "My Game")
+scene = Scene("Main")
+camera = Camera(position=(0, 2, 8), yaw=-90, pitch=-15)
+scene.set_main_camera(camera)
+
+cube = Entity("Cube")
+cube.add_component(Transform(position=(0, 1, 0)))
+mat = Material("green")
+mat.albedo[:] = (0.2, 0.9, 0.4)
+cube.add_component(MeshRenderer(mesh=MeshFactory.create_cube(), material=mat))
+scene.spawn(cube)
+
+engine.load_scene(scene)
+engine.enable_first_person(camera)
+engine.run()  # blocks until ESC
+```
+
+---
+
+## 2. Scene — add / remove objects
+
+```python
+scene.spawn(entity)          # add
+scene.remove(entity)         # REMOVE from scene + destroy()  ← use this to delete
+scene.despawn(entity)        # same as remove
+found = scene.find("Player") # Entity or None
+```
+
+**Important:** `entity.destroy()` alone does NOT remove it from `scene.entities`. Always prefer `scene.remove(entity)`.
+
+---
+
+## 3. Transform
+
+`position`, `rotation`, `scale` = **numpy float32 arrays** length 3. Rotation in **degrees**.
+
+```python
+tf = Transform(position=(0, 1, 0), rotation=(0, 45, 0), scale=(1, 1, 1))
+tf.set_position(x, y, z)
+tf.position[:] = (1, 2, 3)
+tf.position[1] += 0.1
+tf.translate(dx, dy, dz)
+tf.set_rotation(rx, ry, rz)
+tf.rotate(0, 90 * dt, 0)
+tf.set_scale(sx, sy, sz)
+```
+
+---
+
+## 4. Camera
+
+```python
+cam = Camera(position=(0, 5, 10), yaw=-90, pitch=-20, fov=60)
+cam.position = (x, y, z)     # tuple OK
+cam.yaw = -45
+cam.pitch = -15
+cam.look_at(target)          # world point or player_tf.position
+cam.rotate(dx, dy)           # mouse deltas
+```
+
+Third-person follow:
+
+```python
+engine.free_camera = False   # REQUIRED when you move the camera yourself
+target = player_tf.position
+cam.position = (target[0], target[1] + 6, target[2] + 10)
+cam.look_at(target)
+```
+
+FPS: `engine.enable_first_person(camera, eye_height=1.7, walk_speed=6)`
+
+---
+
+## 5. MeshFactory — ALL primitives
+
+| Method | Signature |
+|--------|-----------|
+| cube | `create_cube(size=1.0)` |
+| plane | `create_plane(size=10.0)` |
+| sphere | `create_sphere(radius=1.0, sectors=24, stacks=16)` |
+| cylinder | `create_cylinder(radius=0.5, height=1.0, segments=24, capped=True)` |
+| pyramid | `create_pyramid(size=1.0, height=1.0)` |
+
+```python
+MeshFactory.create_cylinder(radius=0.8, height=3.0, segments=24)
+```
+
+---
+
+## 6. Material
+
+```python
+mat = Material("metal")
+mat.albedo[:] = (0.9, 0.2, 0.2)  # RGB 0..1 numpy
+mat.metallic = 0.8
+mat.roughness = 0.3
+mat.ao = 1.0
+```
+
+---
+
+## 7. HUD — exact API (read carefully)
+
+Enable overlay:
+
+```python
+from aether import Hud, HudBar
+
+engine.draw_hud = True
+hud = Hud(engine.renderer2d)
+```
+
+**Coordinates:** origin `(0,0)` = **center of the window**, +X right, +Y up.  
+Not top-left pixels. On 1280×720, top-left area ≈ `(-500, 300)`.
+
+**No bitmap text yet.** Put strings in the window title:
+
+```python
+engine.window.set_title(f"HP {hp} | score {score}")
+```
+
+### draw_bar — exact signatures
+
+```python
+# RECOMMENDED — current value + max value + color
+hud.draw_bar(x, y, width, height, value, max_value, color)
+hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
+
+# Fraction 0..1 only
+hud.draw_bar(-500, 300, 200, 20, 0.75)
+
+# HudBar object
+hud.draw_bar(-500, 300, 200, 20, HudBar("hp", value=0.75, color=(0.8, 0.2, 0.2, 1.0)))
+```
+
+### Other HUD methods
+
+```python
+hud.clear()                              # call every frame before drawing
+hud.draw_crosshair(size=10, thickness=2)
+hud.draw_hotbar(slots=7, selected=0, colors=[(1,0,0), (0,1,0)], y=-220)
+hud.draw_rect(x, y, width, height, color=(1,1,1,1), layer=70)
+hud.draw_panel(x, y, width, height)
+```
+
+Full frame example:
+
+```python
+def update(dt):
+    hud.clear()
+    hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
+    hud.draw_crosshair()
+    engine.window.set_title(f"HP {hp}")
+```
+
+---
+
+## 8. Assets
+
+```python
+from aether import AssetLoader, Sprite
+
+mesh = AssetLoader.load_model("hero.glb")
+sprite = Sprite.from_image("icon.png", x=0, y=0)
+tex_id = AssetLoader.load_texture("wall.jpg")
+```
+
+---
+
+## 9. Physics
+
+**2D (ready):** `engine.physics2d` (pymunk) — see `examples/04_physics2d.py`
+
+```python
+engine.set_mode("2d")
+pw = engine.physics2d
+ground = pw.create_box(0, -200, 600, 40, static=True)
+ball = pw.create_circle(0, 0, 20, mass=1.0)
+sprite.x, sprite.y = ball.x, ball.y   # Y-up, same space
+```
+
+**3D:** lightweight built-in solver. PyBullet/Jolt planned later.
+
+```python
+from aether import BoxCollider
+body = engine.physics3d.create_body_for_entity(ent, mass=1.0, collider=BoxCollider(size=(1,1,1)))
+```
+
+---
+
+## 10. Input / update
+
+```python
+import glfw
+
+def update(dt):
+    if engine.input.get_key(glfw.KEY_W):
+        ...
+    if engine.input.get_key_down(glfw.KEY_SPACE):
+        ...
+
+engine.on_update(update)
+```
+
+---
+
+## 11. Window vs audio
+
+- **GLFW** — window, input, OpenGL 4.6  
+- **pygame-ce** — sound mixer only (display never initialized)
+
+---
+
+## 12. CLI
+
+```bash
+aether help
+aether docs          # full guide (this file)
+aether website       # HTML docs on localhost
+aether build game.py --name MyGame
+```
+
+---
+
+## 13. Examples
+
+| File | Topic |
+|------|--------|
+| `examples/01_hello_cube.py` | Basics |
+| `examples/02_sphere_scene.py` | Materials |
+| `examples/03_first_person.py` | FPS |
+| `examples/04_physics2d.py` | 2D physics |
+
+---
+
+Aether Engine © entiti937

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/ui/hud.py

@@ -2,21 +2,40 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import List, Tuple
+from typing import List, Optional, Tuple, Union
 
 from aether.graphics2d import Sprite
 
+Color = Tuple[float, float, float, float]
+
 
 @dataclass
 class HudBar:
-    label: str
-    value: float  # 0..1
-    color: Tuple[float, float, float, float] = (0.2, 0.85, 0.35, 0.95)
-    back: Tuple[float, float, float, float] = (0.1, 0.1, 0.12, 0.7)
+    """Progress bar data. value is 0..1 (fraction filled)."""
+
+    label: str = ""
+    value: float = 1.0  # 0..1
+    color: Color = (0.2, 0.85, 0.35, 0.95)
+    back: Color = (0.1, 0.1, 0.12, 0.7)
 
 
 class Hud:
-    """Build sprites for a simple game HUD (hotbar, bars, crosshair)."""
+    """
+    Immediate-mode HUD (colored rectangles only — no TrueType text yet).
+
+    Coordinate system (IMPORTANT):
+      Origin (0, 0) = CENTER of the window.
+      +X right, +Y up. Same as engine 2D mode.
+      Example top-left HP bar on 1280x720: draw_bar(-500, 300, 200, 20, hp, 100)
+
+    Typical usage each frame:
+      engine.draw_hud = True
+      hud = Hud(engine.renderer2d)
+      hud.clear()
+      hud.draw_bar(-500, 300, 200, 20, hp, max_hp, (0.8, 0.2, 0.2, 1.0))
+      hud.draw_crosshair()
+      engine.window.set_title(f"HP {hp}")  # text goes here for now
+    """
 
     def __init__(self, renderer2d):
         self.r = renderer2d
@@ -24,6 +43,7 @@ class Hud:
         self._owned: List[Sprite] = []
 
     def clear(self):
+        """Remove HUD sprites from last frame. Call once at the start of each update."""
         for s in self._owned:
             if s in self.r.sprites:
                 self.r.sprites.remove(s)
@@ -35,11 +55,13 @@ class Hud:
         return sprite
 
     def draw_crosshair(self, size: float = 10.0, thickness: float = 2.0):
+        """White crosshair at screen center."""
         c = (1, 1, 1, 0.9)
         self._add(Sprite(0, 0, size, thickness, color=c, layer=100))
         self._add(Sprite(0, 0, thickness, size, color=c, layer=100))
 
     def draw_hotbar(self, slots: int, selected: int, colors, y: float = -220):
+        """Inventory-style slots along the bottom."""
         slot_w, slot_h, gap = 44, 44, 6
         total = slots * slot_w + (slots - 1) * gap
         start_x = -total * 0.5 + slot_w * 0.5
@@ -50,7 +72,40 @@ class Hud:
             col = colors[i] if i < len(colors) else (0.4, 0.4, 0.4, 1)
             self._add(Sprite(x, y, slot_w - 6, slot_h - 6, color=(*col[:3], 1.0), layer=91))
 
-    def draw_bar(self, x: float, y: float, width: float, height: float, bar: HudBar):
+    def draw_bar(
+        self,
+        x: float,
+        y: float,
+        width: float,
+        height: float,
+        value: Union[float, HudBar],
+        max_value: Optional[float] = None,
+        color: Color = (0.8, 0.2, 0.2, 1.0),
+        back: Color = (0.1, 0.1, 0.12, 0.7),
+    ):
+        """
+        Draw a horizontal progress bar. Center of the bar is at (x, y).
+
+        Easy form (recommended):
+            hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
+            #               x    y    w   h   cur max  RGBA color
+
+        With fraction 0..1:
+            hud.draw_bar(-500, 300, 200, 20, 0.75)
+
+        With HudBar object:
+            hud.draw_bar(-500, 300, 200, 20, HudBar("hp", value=0.75, color=(...)))
+        """
+        if isinstance(value, HudBar):
+            bar = value
+        else:
+            cur = float(value)
+            if max_value is None or float(max_value) <= 0:
+                frac = cur if 0.0 <= cur <= 1.0 else 0.0
+            else:
+                frac = cur / float(max_value)
+            bar = HudBar(value=frac, color=color, back=back)
+
         self._add(Sprite(x, y, width, height, color=bar.back, layer=80))
         fill = max(0.0, min(1.0, bar.value)) * (width - 4)
         self._add(
@@ -70,10 +125,10 @@ class Hud:
         y: float,
         width: float,
         height: float,
-        color=(1.0, 1.0, 1.0, 1.0),
+        color: Color = (1.0, 1.0, 1.0, 1.0),
         layer: int = 70,
     ):
-        """Draw a solid screen-space rectangle (center at x,y)."""
+        """Solid rectangle. Center at (x, y)."""
         self._add(Sprite(x, y, width, height, color=color, layer=layer))
 
     def draw_panel(
@@ -82,11 +137,11 @@ class Hud:
         y: float,
         width: float,
         height: float,
-        fill=(0.05, 0.06, 0.08, 0.75),
-        border=(0.9, 0.9, 0.95, 0.9),
+        fill: Color = (0.05, 0.06, 0.08, 0.75),
+        border: Color = (0.9, 0.9, 0.95, 0.9),
         border_thickness: float = 2.0,
     ):
-        """Draw a simple bordered panel (no text — use window title / print for text)."""
+        """Bordered panel. No text — use engine.window.set_title(...) for strings."""
         self.draw_rect(x, y, width, height, color=fill, layer=70)
         t = border_thickness
         self.draw_rect(x, y + height * 0.5, width, t, color=border, layer=71)

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/web/content.py

@@ -247,16 +247,19 @@ mat.metallic = 0.8
 mat.roughness = 0.3</code></pre>
 
   <h2>Hud</h2>
-  <p>Colored quads only — <strong>no bitmap text yet</strong>. Use window title for scores.</p>
-  <pre><code>from aether import Hud, HudBar
+  <p><strong>Coords:</strong> (0,0) = center of window, +Y up. No text — use <code>engine.window.set_title(...)</code>.</p>
+  <pre><code>from aether import Hud
+
 engine.draw_hud = True
 hud = Hud(engine.renderer2d)
 hud.clear()
+# draw_bar(x, y, width, height, value, max_value, color)
+hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
 hud.draw_crosshair()
-hud.draw_bar(-400, 300, 200, 18, HudBar("hp", value=0.75))
 hud.draw_hotbar(7, 0, colors=[(1,0,0),(0,1,0)])
 hud.draw_rect(0, -250, 120, 40, color=(0,0,0,0.5))
-hud.draw_panel(0, 250, 300, 60)</code></pre>
+hud.draw_panel(0, 250, 300, 60)
+engine.window.set_title(f"HP {hp}")</code></pre>
 </section>
 """,
     "api-3d": """
@@ -322,8 +325,8 @@ hero = Sprite.from_image("sprites/hero.png", x=0, y=0)
 engine.renderer2d.add_sprite(hero)</code></pre>
 
   <h2>HUD on top of 3D</h2>
-  <p>Colored quads only (no TrueType text yet). Use window title for scores.</p>
-  <pre><code>from aether import Hud, HudBar
+  <p>Coords: (0,0)=screen center. Exact bar API:</p>
+  <pre><code>from aether import Hud
 
 engine.draw_hud = True
 hud = Hud(engine.renderer2d)
@@ -331,7 +334,7 @@ hud = Hud(engine.renderer2d)
 def update(dt):
     hud.clear()
     hud.draw_crosshair(size=12)
-    hud.draw_bar(-500, 320, 220, 16, HudBar("hp", value=0.75))
+    hud.draw_bar(-500, 320, 220, 16, hp, 100, (0.8, 0.2, 0.2, 1.0))
     engine.window.set_title(f"Score {score}")
 
 engine.on_update(update)</code></pre>

{aether_engine-1.8.0 → aether_engine-1.8.1}/aether/web/plain_content.py

@@ -133,9 +133,13 @@ MATERIAL
 - albedo (np.array RGB), metallic, roughness, ao
 
 HUD (engine.draw_hud=True; no text rendering yet)
-- clear(), draw_crosshair(), draw_bar(x,y,w,h,HudBar), draw_hotbar(...)
-- draw_rect(...), draw_panel(...)
-- Use engine.window.set_title(...) for score text
+- Coords: (0,0)=CENTER of window, +Y up
+- clear() every frame
+- draw_bar(x, y, width, height, value, max_value, color)
+  Example: hud.draw_bar(-500, 300, 200, 20, hp, 100, (0.8, 0.2, 0.2, 1.0))
+- Also: draw_bar(..., 0.75) fraction, or draw_bar(..., HudBar(...))
+- draw_crosshair(), draw_hotbar(...), draw_rect(...), draw_panel(...)
+- Text: engine.window.set_title(f"HP {hp}")
 """,
     "api-3d": """
 Engine(width, height, title)
@@ -150,7 +154,8 @@ scene.remove(entity)
 engine.set_mode("2d")
 engine.renderer2d.add_sprite(Sprite(x, y, w, h, color=(r,g,b,a)))
 Sprite.from_image("icon.png")
-Hud: draw_crosshair, draw_bar, draw_hotbar, draw_rect, draw_panel (no text)
+Hud: draw_bar(x,y,w,h, value, max_value, color) — also fraction or HudBar
+Coords (0,0)=screen center. draw_crosshair, draw_hotbar, draw_rect, draw_panel (no text)
 """,
     "physics": """
 2D PHYSICS — AVAILABLE NOW (pymunk via engine.physics2d)