py3dbuilder 0.1.0a1__tar.gz

py3dbuilder-0.1.0a1/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: py3dbuilder
+Version: 0.1.0a1
+Summary: Simple 3D Builder for creating 2D and 3D games in Python.
+Author: Victor Zou
+License: MIT
+Keywords: game,pygame,3d,builder,engine,Victor Zou,vzpy,python
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pygame
+
+# py3dbuilder
+
+Simple 3D Builder for creating 2D and 3D games in Python.
+
+## Quick Start
+
+See `quickstart.py` in the project root directory.
+
+## Version
+
+Current version: `0.1.0a1` (Alpha 1)
+
+## Features
+
+- Screen
+- Scene
+- Surface
+- Vec2
+- Vec3
+
+## Links
+
+- [PyPI](https://pypi.org/project/py3dbuilder/)
+- [PyPI Stats](https://pypistats.org/packages/py3dbuilder)
+
+## License
+
+MIT License

py3dbuilder-0.1.0a1/ReadMe.md

@@ -0,0 +1,28 @@
+# py3dbuilder
+
+Simple 3D Builder for creating 2D and 3D games in Python.
+
+## Quick Start
+
+See `quickstart.py` in the project root directory.
+
+## Version
+
+Current version: `0.1.0a1` (Alpha 1)
+
+## Features
+
+- Screen
+- Scene
+- Surface
+- Vec2
+- Vec3
+
+## Links
+
+- [PyPI](https://pypi.org/project/py3dbuilder/)
+- [PyPI Stats](https://pypistats.org/packages/py3dbuilder)
+
+## License
+
+MIT License

py3dbuilder-0.1.0a1/py3dbuilder/__init__.py

@@ -0,0 +1,42 @@
+"""Build 3D Games."""
+from . import geometry
+from . import math
+import pygame as _pyg
+BlitAbleObject=geometry.Surface
+from . import scene
+from .scene import Scene
+
+_scr=None
+def _set_scr(screen:"Screen"):
+    global _scr
+    _scr=screen
+class Screen:
+    def __init__(self,size:geometry.Size2|math.Vec2|tuple[int,int]):
+        self.size=size
+        self.width,self.height=size
+        self._screen=_pyg.display.set_mode(tuple(size))
+        _set_scr(self)
+        self.last_scene=None
+    def show(self,scene:Scene):
+        scene.is_main_scene=True
+        scene.clear()
+        scene.set_newtitle(scene.title)
+        if self.last_scene is not None:
+            self.last_scene.is_main_scene=False
+        self.last_scene=scene
+    def blit(self,object:BlitAbleObject,pos:math.Vec2|geometry.Point2|None=None):
+        if pos is None:
+            pos=object.pos
+        self._screen.blit(object._obj,tuple(pos))
+    def fill(self,color:tuple[int,int,int]):
+        self._screen.fill(color)
+def quitted():
+    for event in _pyg.event.get():
+        if event.type==_pyg.QUIT:
+            return True
+    return False
+def quit():
+    _pyg.display.quit()
+    _pyg.quit()
+def update():
+    _pyg.display.update()

py3dbuilder-0.1.0a1/py3dbuilder/geometry.py

@@ -0,0 +1,86 @@
+from .math import Vec2 as _V2, Vec3 as _V3
+from typing import Literal as _Lit
+class Point2(_V2):pass
+class Size2(_V2):pass
+class Point3(_V3):pass
+class Size3(_V3):pass
+DEFAULT_POS=Point2(0,0)
+class Surface:
+    def __init__(self,size:Size2|_V2|tuple[int,int],pos:Point2|_V2|tuple[int,int]=DEFAULT_POS):
+        self._width,self._height=size
+        self.size=Point2(*size)
+        self.sizet=(size.x,size.y) if not isinstance(size,tuple) else size
+        self._x,self._y=pos
+        self.pos=Point2(*pos)
+        self.post=(pos.x,pos.y) if not isinstance(pos,tuple) else pos
+        from pygame import Surface
+        self._obj=Surface(size)
+    @property
+    def width(self):
+        return self._width
+    @width.setter
+    def width(self,newwidth):
+        self._width=newwidth
+        self.size.x=newwidth
+        self.sizet=(self.size.x,self.size.y)
+    @property
+    def height(self):
+        return self._width
+    @height.setter
+    def height(self,newheight):
+        self._height=newheight
+        self.size.y=newheight
+        self.sizet=(self.size.x,self.size.y)
+    @property
+    def x(self):
+        return self._x
+    @x.setter
+    def x(self,newx):
+        self._x=newx
+        self.pos.x=newx
+        self.post=(self.pos.x,self.pos.y)
+    @property
+    def y(self):
+        return self._y
+    @y.setter
+    def y(self,newy):
+        self._y=newy
+        self.pos.y=newy
+        self.post=(self.pos.x,self.pos.y)
+    @property
+    def area(self):
+        return self.width*self.height
+    def __repr__(self):
+        return f"Surface(size={self.sizet},pos={self.post})"
+
+def get_whxyscrface(w:int,h:int,x:int,y:int):
+    return Surface(Size2(w,h),Point2(x,y))
+def get_cornerssurface(lefttop: Point2 | _V2, rightbottom: Point2 | _V2):
+    size = abs(rightbottom - lefttop)
+    pos = (lefttop + rightbottom) / 2
+    return Surface(size, pos)
+def get_joinedsurface(surf1:Surface,surf2:Surface,addway:_Lit["horizontal","vertical"]="horizontal",alignway:_Lit["align_longer","align_shorter","align_average"]="align_average",new_pos:_V2|Point2=DEFAULT_POS):
+    wsum=surf1.width+surf2.width
+    hsum=surf1.height+surf2.height
+    if addway=="horizontal":
+        if alignway=="align_average":
+            height=round(hsum/2)
+        elif alignway=="align_longer":
+            height=surf1.height if surf1.height>surf2.height else surf2.height
+        elif alignway=="align_shorter":
+            height=surf1.height if surf1.height<surf2.height else surf2.height
+        else:
+            raise TypeError("Invalid key")
+        return Surface(Size2(wsum,height),new_pos)
+    elif addway=="vertical":
+        if alignway=="align_average":
+            width=round(wsum/2)
+        elif alignway=="align_longer":
+            width=surf1.width if surf1.width>surf2.width else surf2.width
+        elif alignway=="align_shorter":
+            width=surf1.width if surf1.width<surf2.width else surf2.width
+        else:
+            raise TypeError("Invalid key")
+        return Surface(Size2(width,hsum),new_pos)
+    else:
+        raise TypeError("Invalid add key")

py3dbuilder-0.1.0a1/py3dbuilder/math.py

@@ -0,0 +1,65 @@
+import math as _math
+from typing import Literal as _Lit
+from warnings import warn as _warn
+X=0
+Y=1
+Z=2
+class Vec2:
+    """A two-index vector."""
+    def __init__(self, x:int, y:int, *, readonly:bool=False):
+        self.__x=x
+        self.__y=y
+        self.__lck=readonly
+    @property
+    def x(self):
+        return self.__x
+    @x.setter
+    def x(self,x:int):
+        if not self.__lck:
+            self.__x=x
+        else:
+            _warn("Cannot revise a readonly vector",UserWarning)
+    @property
+    def y(self):
+        return self.__y
+    @y.setter
+    def y(self,y:int):
+        if not self.__lck:
+            self.__y=y
+        else:
+            _warn("Cannot revise a readonly vector",UserWarning)
+    def get(self,coord:int):
+        """
+        Get the X or Y coordinate of this vector. **coord** is coordinate type.
+
+        Example:
+            >>> from py3dbuilder.math import *
+            >>> vector = Vec2(66, 99)
+            >>> print(
+            ...     vector.get(X),
+            ...     vector.get(Y),
+            ...     vector.get(0),
+            ...     vector.get(1)
+            ... )
+            66 99 66 99
+        
+        If you want easier, use **vect[coord]** to get.
+        """
+        return (self.x,self.y)[coord]
+    def __add__(self,other:"Vec2"):
+        return Vec2(self.x+other.x,self.y+other.y)
+    def __sub__(self,other:"Vec2"):
+        return Vec2(self.x-other.x,self.y-other.y)
+    def __getitem__(self,coord:int):
+        """
+        Get the X or Y coordinate of this vector.
+        
+        More about it, see **Vec2.get** .
+        """
+        return self.get(coord)
+    def __iter__(self):
+        yield self.x
+        yield self.y
+class Vec3:
+    def __init__(self, x:int, y:int, z:int):
+        pass

py3dbuilder-0.1.0a1/py3dbuilder/scene.py

@@ -0,0 +1,35 @@
+from . import BlitAbleObject
+from . import _pyg
+from .geometry import Point2 as _P2
+from .math import Vec2 as _V2
+class Scene:
+    def __init__(self,color:tuple[int,int,int],title:str):
+        from . import _scr
+        from . import _set_scr
+        if _scr is None:
+            from . import Screen
+            self.screen=Screen((640,640))
+            _set_scr(self.screen)
+        else:
+            self.screen=_scr
+        self.bgcolor=color
+        self.title=title
+        self.is_main_scene=False
+    def set_newcolor(self,newcolor:tuple[int,int,int]):
+        self.bgcolor=newcolor
+        if self.is_main_scene:
+            self.screen._screen.fill(newcolor)
+    def set_newtitle(self,newtitle:str):
+        self.title=newtitle
+        if self.is_main_scene:
+            _pyg.display.set_caption(newtitle)
+    def show(self):
+        self.screen.show(self)
+    def blit(self,object:BlitAbleObject,pos:_P2|_V2):
+        if self.is_main_scene:
+            self.screen.blit(object,pos)
+    def clear(self,bgcolor:tuple[int,int,int]|None=None):
+        if self.is_main_scene:
+            if bgcolor is None:
+                bgcolor=self.bgcolor
+            self.set_newcolor(bgcolor)

py3dbuilder-0.1.0a1/py3dbuilder.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: py3dbuilder
+Version: 0.1.0a1
+Summary: Simple 3D Builder for creating 2D and 3D games in Python.
+Author: Victor Zou
+License: MIT
+Keywords: game,pygame,3d,builder,engine,Victor Zou,vzpy,python
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pygame
+
+# py3dbuilder
+
+Simple 3D Builder for creating 2D and 3D games in Python.
+
+## Quick Start
+
+See `quickstart.py` in the project root directory.
+
+## Version
+
+Current version: `0.1.0a1` (Alpha 1)
+
+## Features
+
+- Screen
+- Scene
+- Surface
+- Vec2
+- Vec3
+
+## Links
+
+- [PyPI](https://pypi.org/project/py3dbuilder/)
+- [PyPI Stats](https://pypistats.org/packages/py3dbuilder)
+
+## License
+
+MIT License

py3dbuilder-0.1.0a1/py3dbuilder.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+ReadMe.md
+pyproject.toml
+py3dbuilder/__init__.py
+py3dbuilder/geometry.py
+py3dbuilder/math.py
+py3dbuilder/scene.py
+py3dbuilder.egg-info/PKG-INFO
+py3dbuilder.egg-info/SOURCES.txt
+py3dbuilder.egg-info/dependency_links.txt
+py3dbuilder.egg-info/requires.txt
+py3dbuilder.egg-info/top_level.txt

py3dbuilder-0.1.0a1/py3dbuilder.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

py3dbuilder-0.1.0a1/py3dbuilder.egg-info/requires.txt

@@ -0,0 +1 @@
+pygame

py3dbuilder-0.1.0a1/py3dbuilder.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+py3dbuilder

py3dbuilder-0.1.0a1/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "py3dbuilder"
+version = "0.1.0a1"
+authors = [
+  { name="Victor Zou" }
+]
+description = "Simple 3D Builder for creating 2D and 3D games in Python."
+readme = "ReadMe.md"
+requires-python = ">=3.10"
+
+dependencies = [
+  "pygame"
+]
+license = {text = "MIT"}
+keywords = [
+  "game",
+  "pygame",
+  "3d",
+  "builder",
+  "engine",
+  "Victor Zou",
+  "vzpy",
+  "python"
+]
+[tool.setuptools.packages.find]
+where = ["."]

py3dbuilder-0.1.0a1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+