easitwo 26.0__tar.gz

easitwo-26.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Altaria
+
+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.

easitwo-26.0/PKG-INFO

@@ -0,0 +1,75 @@
+Metadata-Version: 2.4
+Name: easitwo
+Version: 26.0
+Summary: Used to easily create a 2D game
+Author-email: Altaria <1602422136@qq.com>
+License-Expression: MIT
+Keywords: easitwo,easy,2d,game
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygame
+Requires-Dist: Pillow
+Requires-Dist: winaccent
+Requires-Dist: pyvidplayer2
+Dynamic: license-file
+
+# easitwo
+
+> **26.0 — Omiga Edition**
+
+A simple framework for easily creating 2D games with Python.
+
+## Install
+
+```bash
+pip install easitwo
+```
+
+## Quick Start
+```python
+from easitwo import *
+
+window = display.Window(width=960, height=540, caption="Hello World")
+scene = display.Scene(window)
+scene.switch()
+
+img = image.Animation("your_image_path.gif")
+sprite = entity.Entity(scene, img, x=100, y=100)
+
+monitor = event.Monitor(window)
+monitor.on_each_frame(sprite.next_texture)
+
+window.run()
+```
+## Function
+| Module Names |          Functions         |
+|--------------|----------------------------|
+|    display   | Window and Scene Management|
+|    entity    |  Entity and Entity Group   |
+|    graphic   | Line segments, triangles, rectangles, circles, ellipses, polygons, Bézier curves, text |
+|    image     |  Static images, GIFs, frame animations, support scaling, rotation, filters, and color adjustments |
+|    event     | Keyboard, mouse, scroll wheel events, timers, broadcasts |
+|    media     | Sound and music |
+|    color     | RGB / Hex colors, with lots of built-in named colors |
+
+## System Requirements
+Python 3.11 or higher\
+Windows / macOS / Linux
+
+## Dependency
+pygame\
+Pillow\
+pyvidplayer2\
+winaccent（Only Windows）
+
+## License
+MIT
+
+## Dedication
+
+> To everyone who loves making games, but has ever felt frustrated by complicated engines and endless boilerplate.
+
+This release is the **"26.0 omiga"** edition — a tribute to **omiga**, a small library I wrote years ago.
+
+I hope easitwo can be of some help to you. If you run into any bugs, please don't hesitate to let me know. Your feedback means a lot to me.

easitwo-26.0/README.md

@@ -0,0 +1,59 @@
+# easitwo
+
+> **26.0 — Omiga Edition**
+
+A simple framework for easily creating 2D games with Python.
+
+## Install
+
+```bash
+pip install easitwo
+```
+
+## Quick Start
+```python
+from easitwo import *
+
+window = display.Window(width=960, height=540, caption="Hello World")
+scene = display.Scene(window)
+scene.switch()
+
+img = image.Animation("your_image_path.gif")
+sprite = entity.Entity(scene, img, x=100, y=100)
+
+monitor = event.Monitor(window)
+monitor.on_each_frame(sprite.next_texture)
+
+window.run()
+```
+## Function
+| Module Names |          Functions         |
+|--------------|----------------------------|
+|    display   | Window and Scene Management|
+|    entity    |  Entity and Entity Group   |
+|    graphic   | Line segments, triangles, rectangles, circles, ellipses, polygons, Bézier curves, text |
+|    image     |  Static images, GIFs, frame animations, support scaling, rotation, filters, and color adjustments |
+|    event     | Keyboard, mouse, scroll wheel events, timers, broadcasts |
+|    media     | Sound and music |
+|    color     | RGB / Hex colors, with lots of built-in named colors |
+
+## System Requirements
+Python 3.11 or higher\
+Windows / macOS / Linux
+
+## Dependency
+pygame\
+Pillow\
+pyvidplayer2\
+winaccent（Only Windows）
+
+## License
+MIT
+
+## Dedication
+
+> To everyone who loves making games, but has ever felt frustrated by complicated engines and endless boilerplate.
+
+This release is the **"26.0 omiga"** edition — a tribute to **omiga**, a small library I wrote years ago.
+
+I hope easitwo can be of some help to you. If you run into any bugs, please don't hesitate to let me know. Your feedback means a lot to me.

easitwo-26.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "easitwo"
+version = "26.0"
+description = "Used to easily create a 2D game"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Altaria", email = "1602422136@qq.com"}]
+requires-python = ">=3.8"
+dependencies = ["pygame", "Pillow", "winaccent", "pyvidplayer2"]
+keywords = ["easitwo", "easy", "2d", "game"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

easitwo-26.0/setup.cfg

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

easitwo-26.0/src/easitwo/__init__.py

@@ -0,0 +1,11 @@
+"""
+__init__.py of easitwo package
+"""
+
+from . import display
+from . import color
+from . import entity
+from . import image
+from . import event
+from . import media
+from . import graphic

easitwo-26.0/src/easitwo/color.py

@@ -0,0 +1,265 @@
+from typing import Self
+
+class Palette(object):
+    """
+    Palette
+    ---
+    Used to fetch an RGB or hexadecimal color.
+
+    Example:
+    ```
+        from easitwo import *
+        # (1)
+        print(color.Palette(255, 255, 255)) # -> [White] <easitwo.color.Palette object at 0x000001C9248FF5F0>
+        # (2)
+        print(color.Palette("#FFFFFF")) # -> [White] <easitwo.color.Palette object at 0x00000252E87A75F0>
+        ...
+    ```
+    """
+    def __init__(self, *args, **kwargs) -> None:
+        # 当传入三个数字时，默认传入255rgb值
+        if (len(args) == 3 and (isinstance(args[0], int) and isinstance(args[1], int) and isinstance(args[2], int))):
+            self._r = args[0]
+            self._g = args[1]
+            self._b = args[2]
+        # 当传入字符串时，默认传入16进制rgb值
+        if (len(args) == 1 and isinstance(args[0], str)):
+            self._rgb16 = args[0] # 保存为临时变量
+            self._hex_str = self._rgb16.lstrip("#")
+
+            self._r = int(self._hex_str[0: 2], 16)
+            self._g = int(self._hex_str[2: 4], 16)
+            self._b = int(self._hex_str[4: 6], 16) # 16进制 -> 10进制
+
+        return None
+        
+    def rgb(self) -> tuple[int]:
+        """
+        Palette.rgb
+        ---
+        Return the RGB values of this color as an integer tuple.
+
+        Example:
+        ```
+            ...
+            white = color.Palette("#FFFFFF")
+            print(white.rgb()) # -> (255, 255, 255)
+            ...
+        ```
+        """
+        return (self._r, self._g, self._b) #返回rgb数组
+    
+    def hex(self) -> str:
+        """
+        Palette.hex
+        ---
+        Return the hexadecimal representation of this color as a string.
+
+        Example:
+        ```
+            ...
+            white = color.Palette(255, 255, 255)
+            print(white.hex()) # -> "#FFFFFF"
+            ...
+        ```
+        """
+        self._hex_str = f"#{self._r:02X}{self._g:02X}{self._b:02X}"
+        return self._hex_str # 返回调整后的16进制表示法
+
+    def norm(self) -> tuple[float]:
+        """
+        Palette.norm
+        ---
+        Return the normal representation of the color as a tuple of floats.
+
+        Example:
+        ```
+            ...
+            white = color.Palette(255, 255, 255)
+            print(white.norm()) # -> (1.0, 1.0, 1.0)
+            ...
+        ```
+        """
+        # 返回normal颜色值
+        return (self._r / 255, self._g / 255, self._b / 255)
+
+    def inverse_color(self) -> Self:
+        """
+        Palette.inverse_color
+        ---
+        Return the opposite color of this color.
+
+        Example:
+        ```
+            ...
+            white = color.Palette(255, 255, 255)
+            print(white.inverse_color().rgb()) # -> (0, 0, 0)
+            ...
+        ```
+        """        
+        self._inverse_r = 255 - self._r
+        self._inverse_g = 255 - self._g
+        self._inverse_b = 255 - self._b # 获取三种颜色的反色
+
+        self._new_palette = Palette(self._inverse_r, self._inverse_g, self._inverse_b) # 设置返回值
+        return self._new_palette
+
+    def scale(self, k: int = 1) -> Self:
+        """
+        Palette.scale
+        ---
+        Scale the RGB values of the color by k times and return a new Palette object.
+
+        Example:
+        ```
+            ...
+            white = color.Palette(255, 255, 255)
+            gray = white.scale(0.8)
+            print(gray.rgb()) # -> (204, 204, 204)
+            ...
+        ```
+        """        
+        _new_r = int(self._r * k) if (int(self._r * k) < 255) else 255
+        _new_g = int(self._g * k) if (int(self._g * k) < 255) else 255
+        _new_b = int(self._b * k) if (int(self._b * k) < 255) else 255 # 等比例缩放三种原色
+
+        _new_palette = Palette(_new_r, _new_g, _new_b)
+        return _new_palette
+
+White: Palette = Palette(255, 255, 255) # 白色
+Black: Palette = Palette(0, 0, 0) # 黑色
+Red: Palette = Palette(255, 0, 0) # 红色
+Green: Palette = Palette(0, 255, 0) # 绿色
+Blue: Palette = Palette(0, 0, 255) # 蓝色
+Yellow: Palette = Palette(255, 255, 0) # 黄色
+Cyan: Palette = Palette(0, 255, 255) # 青色
+Magenta: Palette = Palette(255, 0, 255) # 品红
+
+Gray: Palette = Palette(128, 128, 128) # 灰色
+LightGray: Palette = Palette(211, 211, 211) # 浅灰色
+DarkGray: Palette = Palette(64, 64, 64) # 深灰色
+DimGray: Palette = Palette(105, 105, 105) # 暗灰色
+Silver: Palette = Palette(192, 192, 192) # 银色
+
+DarkRed: Palette = Palette(139, 0, 0) # 暗红色
+IndianRed: Palette = Palette(205, 92, 92) # 印度红
+LightCoral: Palette = Palette(240, 128, 128) # 淡珊瑚色
+Salmon: Palette = Palette(250, 128, 114) # 鲑鱼色
+DarkSalmon: Palette = Palette(233, 150, 122) # 暗鲑鱼色
+LightSalmon: Palette = Palette(255, 160, 122) # 亮鲑鱼色
+Crimson: Palette = Palette(220, 20, 60) # 深红色
+FireBrick: Palette = Palette(178, 34, 34) # 耐火砖色
+
+Pink: Palette = Palette(255, 192, 203) # 粉色
+LightPink: Palette = Palette(255, 182, 193) # 浅粉色
+HotPink: Palette = Palette(255, 105, 180) # 亮粉红
+DeepPink: Palette = Palette(255, 20, 147) # 深粉色
+MediumVioletRed: Palette = Palette(199, 21, 133) # 中紫罗兰红
+PaleVioletRed: Palette = Palette(219, 112, 147) # 苍紫罗兰红
+
+Orange: Palette = Palette(255, 165, 0) # 橙色
+DarkOrange: Palette = Palette(255, 140, 0) # 暗橙色
+Coral: Palette = Palette(255, 127, 80) # 珊瑚色
+Tomato: Palette = Palette(255, 99, 71) # 番茄色
+OrangeRed: Palette = Palette(255, 69, 0) # 橙红色
+Gold: Palette = Palette(255, 215, 0) # 金色
+
+LightYellow: Palette = Palette(255, 255, 224) # 浅黄色
+LemonChiffon: Palette = Palette(255, 250, 205) # 柠檬绸色
+LightGoldenrodYellow: Palette = Palette(250, 250, 210) # 浅金菊黄
+PapayaWhip: Palette = Palette(255, 239, 213) # 木瓜色
+Moccasin: Palette = Palette(255, 228, 181) # 鹿皮色
+PeachPuff: Palette = Palette(255, 218, 185) # 桃色
+PaleGoldenrod: Palette = Palette(238, 232, 170) # 苍麒麟色
+Khaki: Palette = Palette(240, 230, 140) # 卡其色
+DarkKhaki: Palette = Palette(189, 183, 107) # 暗卡其色
+
+Brown: Palette = Palette(165, 42, 42) # 棕色
+SaddleBrown: Palette = Palette(139, 69, 19) # 鞍棕色
+Sienna: Palette = Palette(160, 82, 45) # 赭色
+Chocolate: Palette = Palette(210, 105, 30) # 巧克力色
+Peru: Palette = Palette(205, 133, 63) # 秘鲁色
+SandyBrown: Palette = Palette(244, 164, 96) # 沙棕色
+BurlyWood: Palette = Palette(222, 184, 135) # 硬木色
+Tan: Palette = Palette(210, 180, 140) # 棕褐色
+RosyBrown: Palette = Palette(188, 143, 143) # 玫瑰棕色
+
+DarkGreen: Palette = Palette(0, 100, 0) # 暗绿色
+ForestGreen: Palette = Palette(34, 139, 34) # 森林绿
+LimeGreen: Palette = Palette(50, 205, 50) # 酸橙绿
+LightGreen: Palette = Palette(144, 238, 144) # 浅绿色
+PaleGreen: Palette = Palette(152, 251, 152) # 苍绿色
+SpringGreen: Palette = Palette(0, 255, 127) # 春绿色
+MediumSpringGreen: Palette = Palette(0, 250, 154) # 中春绿色
+LawnGreen: Palette = Palette(124, 252, 0) # 草坪绿
+Chartreuse: Palette = Palette(127, 255, 0) # 黄绿色
+GreenYellow: Palette = Palette(173, 255, 47) # 绿黄色
+OliveDrab: Palette = Palette(107, 142, 35) # 橄榄褐
+DarkOliveGreen: Palette = Palette(85, 107, 47) # 暗橄榄绿
+Olive: Palette = Palette(128, 128, 0) # 橄榄色
+YellowGreen: Palette = Palette(154, 205, 50) # 黄绿色
+SeaGreen: Palette = Palette(46, 139, 87) # 海绿色
+MediumSeaGreen: Palette = Palette(60, 179, 113) # 中海绿色
+LightSeaGreen: Palette = Palette(32, 178, 170) # 浅海绿色
+DarkSeaGreen: Palette = Palette(143, 188, 143) # 暗海绿色
+Teal: Palette = Palette(0, 128, 128) # 蓝绿色
+
+DarkBlue: Palette = Palette(0, 0, 139) # 暗蓝色
+MediumBlue: Palette = Palette(0, 0, 205) # 中蓝色
+Navy: Palette = Palette(0, 0, 128) # 海军蓝
+RoyalBlue: Palette = Palette(65, 105, 225) # 皇家蓝
+LightBlue: Palette = Palette(173, 216, 230) # 浅蓝色
+LightSteelBlue: Palette = Palette(176, 196, 222) # 亮钢蓝
+DodgerBlue: Palette = Palette(30, 144, 255) # 道奇蓝
+CornflowerBlue: Palette = Palette(100, 149, 237) # 矢车菊蓝
+SkyBlue: Palette = Palette(135, 206, 235) # 天蓝色
+DeepSkyBlue: Palette = Palette(0, 191, 255) # 深天蓝色
+MidnightBlue: Palette = Palette(25, 25, 112) # 午夜蓝
+SteelBlue: Palette = Palette(70, 130, 180) # 钢蓝色
+PowderBlue: Palette = Palette(176, 224, 230) # 粉蓝色
+CadetBlue: Palette = Palette(95, 158, 160) # 军校蓝
+AliceBlue: Palette = Palette(240, 248, 255) # 爱丽丝蓝
+
+Purple: Palette = Palette(128, 0, 128) # 紫色
+MediumPurple: Palette = Palette(147, 112, 219) # 中紫色
+Indigo: Palette = Palette(75, 0, 130) # 靛蓝色
+Violet: Palette = Palette(238, 130, 238) # 紫罗兰色
+DarkViolet: Palette = Palette(148, 0, 211) # 暗紫罗兰
+BlueViolet: Palette = Palette(138, 43, 226) # 蓝紫色
+Lavender: Palette = Palette(230, 230, 250) # 薰衣草色
+LavenderBlush: Palette = Palette(255, 240, 245) # 薰衣草腮红
+Thistle: Palette = Palette(216, 191, 216) # 蓟色
+Plum: Palette = Palette(221, 160, 221) # 李子色
+Orchid: Palette = Palette(218, 112, 214) # 兰花色
+MediumOrchid: Palette = Palette(186, 85, 211) # 中兰花色
+DarkOrchid: Palette = Palette(153, 50, 204) # 暗兰花色
+Fuchsia: Palette = Palette(255, 0, 255) # 紫红色
+
+Ivory: Palette = Palette(255, 255, 240) # 象牙色
+Beige: Palette = Palette(245, 245, 220) # 米色
+Wheat: Palette = Palette(245, 222, 179) # 小麦色
+Bisque: Palette = Palette(255, 228, 196) # 饼干色
+NavajoWhite: Palette = Palette(255, 222, 173) # 纳瓦霍白
+BlanchedAlmond: Palette = Palette(255, 235, 205) # 白杏仁色
+AntiqueWhite: Palette = Palette(250, 235, 215) # 古白色
+Linen: Palette = Palette(250, 240, 230) # 亚麻色
+FloralWhite: Palette = Palette(255, 250, 240) # 花白色
+OldLace: Palette = Palette(253, 245, 230) # 旧蕾丝色
+Cornsilk: Palette = Palette(255, 248, 220) # 玉米丝色
+MintCream: Palette = Palette(245, 255, 250) # 薄荷奶油色
+HoneyDew: Palette = Palette(240, 255, 240) # 蜜瓜色
+SeaShell: Palette = Palette(255, 245, 238) # 贝壳色
+Snow: Palette = Palette(255, 250, 250) # 雪白色
+GhostWhite: Palette = Palette(248, 248, 255) # 幽灵白
+WhiteSmoke: Palette = Palette(245, 245, 245) # 白烟色
+
+Aqua: Palette = Palette(0, 255, 255) # 水蓝色
+Aquamarine: Palette = Palette(127, 255, 212) # 碧绿色
+MediumAquamarine: Palette = Palette(102, 205, 170) # 中碧绿色
+Turquoise: Palette = Palette(64, 224, 208) # 绿松石色
+DarkTurquoise: Palette = Palette(0, 206, 209) # 暗绿松石
+MediumTurquoise: Palette = Palette(72, 209, 204) # 中绿松石
+PaleTurquoise: Palette = Palette(175, 238, 238) # 苍绿松石
+
+Gainsboro: Palette = Palette(220, 220, 220) # 庚斯博罗灰
+Azure: Palette = Palette(240, 255, 255) # 天蓝色