# GTC Pygame Runtime Support
集成 Pygame 应用开发支持
Finding an English version? [click here](https://github.com/GTC-Software-Studio/GTC-Pygame-Runtime-Support)
нашли русскую версию? [кликните сюда](https://github.com/GTC-Software-Studio/GTC-Pygame-Runtime-Support/blob/main/README-ru.md)
此软件包可用于 Pygame 应用开发，包括但不限于游戏、窗体应用，应于版本大于 3.4.0 的 Python 环境中运行。
## 软件包安装
向绝大多数软件包一样，本软件包也可使用 pip 下载并安装
```plain
pip install GTC_Pygame_Runtime_Support
```
如果 pip 不慎爆炸，您可以从 [Github](https://github.com/GTC-Byzantine/GTC-Pygame-Runtime-Support/) 处直接复制源码
## 使用示例
### 按钮
PRS 提供三种按钮类型，全部位于`button.py`文件内，此处以其中的`FeedbackButton`为例进行展示
```python
import pygame
import GTC_Pygame_Runtime_Support as gPRS
screen = pygame.display.set_mode((200, 200))
button = gPRS.button.FeedbackButton([40, 40], [20, 20], '114', 15, screen, bg_color=[0, 145, 220],
border_color=[209, 240, 255], text_color=[255, 255, 255],
change_color=((0, 145, 220), (0, 225, 0))) # 生成按钮
running = 1
clock = pygame.time.Clock()
while running: # 主循环
screen.fill((255, 255, 255))
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = 0
button.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3)) # 按钮贴图处
if button.on_click:
print("clicked")
pygame.display.flip()
clock.tick(60)
```
运行如上代码，你将能够创建一个显示文字为 114 的按钮，并且点击这个按钮后，控制台会输出"clicked"，并且根据用户的动作，按钮将会有不同的反馈。
### 页面
PRS 提供的页面类型位于`page.py`内，此处以`PlainPage`为例进行展示
```python
import sys
import pygame
import GTC_Pygame_Runtime_Support as gPRS
screen = pygame.display.set_mode((500, 500))
bp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)
if __name__ == '__main__':
clock = pygame.time.Clock()
bp.surface.fill((255, 255, 255))
for i in range(100):
pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])
bp.set_as_background()
mw = [False, False]
while True:
mw = [False, False]
for event in pygame.event.get():
if event.type == pygame.QUIT:
sys.exit()
elif event.type == pygame.MOUSEBUTTONDOWN:
if event.button == 4:
mw[1] = True
elif event.button == 5:
mw[0] = True
bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)
pygame.display.flip()
clock.tick(60)
```
运行上述代码，你将能够创建一个可由鼠标滚轮滚动和鼠标左键拖动的页面，你可以自行更换其背景，只要你在主循环前调用函数`bp.set_as_background()`
### PRS 中的嵌套操作
在 PRS 中，一切展示型组件都可通过托管 (trusteeship) 的方式进行嵌套。
#### 在页面中嵌套按钮
PRS 中所有组件托管按钮的方式均相同，就像下面展示的：
```python
import sys
import pygame
import GTC_Pygame_Runtime_Support as gPRS
screen = pygame.display.set_mode((500, 500))
bp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)
if __name__ == '__main__':
clock = pygame.time.Clock()
bp.surface.fill((255, 255, 255))
for i in range(100):
pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])
bp.set_as_background()
bt = gPRS.button.FeedbackButton([40, 40], [20, 20], '114', 10, bp.surface)
bp.add_button_trusteeship(bt)
mw = [False, False]
while True:
mw = [False, False]
for event in pygame.event.get():
if event.type == pygame.QUIT:
sys.exit()
elif event.type == pygame.MOUSEBUTTONDOWN:
if event.button == 4:
mw[1] = True
elif event.button == 5:
mw[0] = True
bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)
if bt.on_click:
print('clicked')
pygame.display.flip()
clock.tick(60)
```
PRS 通常通过`item.add_button_trusteeship(button)`的形式添加嵌套按钮，同时按钮声明时的目标 surface 应指向被嵌套对象的 surface，通常是`item.surface`。
#### 在页面中嵌套页面
原理基本同上。
```python
import sys
import pygame
import GTC_Pygame_Runtime_Support as gPRS
screen = pygame.display.set_mode((500, 500))
bp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)
if __name__ == '__main__':
clock = pygame.time.Clock()
bp.surface.fill((255, 255, 255))
for i in range(100):
pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])
bp.set_as_background()
inner_p = gPRS.page.PlainPage([100, 100], [100, 300], [50, 200], bp.surface, wheel_support=True)
inner_p.surface.fill((255, 255, 255))
for i in range(100):
pygame.draw.line(inner_p.surface, [0, 0, 255], [0, 9 * i], [300, 9 * i])
inner_p.set_as_background()
bp.add_page_trusteeship(inner_p)
mw = [False, False]
while True:
mw = [False, False]
for event in pygame.event.get():
if event.type == pygame.QUIT:
sys.exit()
elif event.type == pygame.MOUSEBUTTONDOWN:
if event.button == 4:
mw[1] = True
elif event.button == 5:
mw[0] = True
bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)
pygame.display.flip()
clock.tick(60)
```
通过以上介绍，您应该能对 PRS 的使用特点有大概的了解。
想要获取完整文档？点击前往[语雀文档](https://www.yuque.com/tdkjzx/gtc_prs)
Raw data
{
"_id": null,
"home_page": null,
"name": "GTC-Pygame-Runtime-Support",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "development, pygame, software",
"author": null,
"author_email": "GTC Byzantine <w1127inline@outlook.com>",
"download_url": null,
"platform": null,
"description": "# GTC Pygame Runtime Support\n\u96c6\u6210 Pygame \u5e94\u7528\u5f00\u53d1\u652f\u6301\n\nFinding an English version? [click here](https://github.com/GTC-Software-Studio/GTC-Pygame-Runtime-Support)\n\n\u043d\u0430\u0448\u043b\u0438 \u0440\u0443\u0441\u0441\u043a\u0443\u044e \u0432\u0435\u0440\u0441\u0438\u044e? [\u043a\u043b\u0438\u043a\u043d\u0438\u0442\u0435 \u0441\u044e\u0434\u0430](https://github.com/GTC-Software-Studio/GTC-Pygame-Runtime-Support/blob/main/README-ru.md)\n\n\u6b64\u8f6f\u4ef6\u5305\u53ef\u7528\u4e8e Pygame \u5e94\u7528\u5f00\u53d1\uff0c\u5305\u62ec\u4f46\u4e0d\u9650\u4e8e\u6e38\u620f\u3001\u7a97\u4f53\u5e94\u7528\uff0c\u5e94\u4e8e\u7248\u672c\u5927\u4e8e 3.4.0 \u7684 Python \u73af\u5883\u4e2d\u8fd0\u884c\u3002\n\n## \u8f6f\u4ef6\u5305\u5b89\u88c5\n\u5411\u7edd\u5927\u591a\u6570\u8f6f\u4ef6\u5305\u4e00\u6837\uff0c\u672c\u8f6f\u4ef6\u5305\u4e5f\u53ef\u4f7f\u7528 pip \u4e0b\u8f7d\u5e76\u5b89\u88c5\n\n```plain\npip install GTC_Pygame_Runtime_Support\n```\n\n\u5982\u679c pip \u4e0d\u614e\u7206\u70b8\uff0c\u60a8\u53ef\u4ee5\u4ece [Github](https://github.com/GTC-Byzantine/GTC-Pygame-Runtime-Support/) \u5904\u76f4\u63a5\u590d\u5236\u6e90\u7801\n\n## \u4f7f\u7528\u793a\u4f8b\n### \u6309\u94ae\nPRS \u63d0\u4f9b\u4e09\u79cd\u6309\u94ae\u7c7b\u578b\uff0c\u5168\u90e8\u4f4d\u4e8e`button.py`\u6587\u4ef6\u5185\uff0c\u6b64\u5904\u4ee5\u5176\u4e2d\u7684`FeedbackButton`\u4e3a\u4f8b\u8fdb\u884c\u5c55\u793a\n\n```python\nimport pygame\nimport GTC_Pygame_Runtime_Support as gPRS\nscreen = pygame.display.set_mode((200, 200))\nbutton = gPRS.button.FeedbackButton([40, 40], [20, 20], '114', 15, screen, bg_color=[0, 145, 220], \n border_color=[209, 240, 255], text_color=[255, 255, 255],\n change_color=((0, 145, 220), (0, 225, 0))) # \u751f\u6210\u6309\u94ae\nrunning = 1\nclock = pygame.time.Clock()\nwhile running: # \u4e3b\u5faa\u73af\n screen.fill((255, 255, 255))\n for event in pygame.event.get():\n if event.type == pygame.QUIT:\n running = 0\n button.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3)) # \u6309\u94ae\u8d34\u56fe\u5904\n if button.on_click:\n print(\"clicked\")\n pygame.display.flip()\n clock.tick(60)\n```\n\n\u8fd0\u884c\u5982\u4e0a\u4ee3\u7801\uff0c\u4f60\u5c06\u80fd\u591f\u521b\u5efa\u4e00\u4e2a\u663e\u793a\u6587\u5b57\u4e3a 114 \u7684\u6309\u94ae\uff0c\u5e76\u4e14\u70b9\u51fb\u8fd9\u4e2a\u6309\u94ae\u540e\uff0c\u63a7\u5236\u53f0\u4f1a\u8f93\u51fa\"clicked\"\uff0c\u5e76\u4e14\u6839\u636e\u7528\u6237\u7684\u52a8\u4f5c\uff0c\u6309\u94ae\u5c06\u4f1a\u6709\u4e0d\u540c\u7684\u53cd\u9988\u3002\n\n### \u9875\u9762\nPRS \u63d0\u4f9b\u7684\u9875\u9762\u7c7b\u578b\u4f4d\u4e8e`page.py`\u5185\uff0c\u6b64\u5904\u4ee5`PlainPage`\u4e3a\u4f8b\u8fdb\u884c\u5c55\u793a\n\n```python\nimport sys\nimport pygame\nimport GTC_Pygame_Runtime_Support as gPRS\n\nscreen = pygame.display.set_mode((500, 500))\nbp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)\n\nif __name__ == '__main__':\n clock = pygame.time.Clock()\n bp.surface.fill((255, 255, 255))\n for i in range(100):\n pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])\n bp.set_as_background()\n\n mw = [False, False]\n while True:\n mw = [False, False]\n for event in pygame.event.get():\n if event.type == pygame.QUIT:\n sys.exit()\n elif event.type == pygame.MOUSEBUTTONDOWN:\n if event.button == 4:\n mw[1] = True\n elif event.button == 5:\n mw[0] = True\n bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)\n pygame.display.flip()\n clock.tick(60)\n```\n\n\u8fd0\u884c\u4e0a\u8ff0\u4ee3\u7801\uff0c\u4f60\u5c06\u80fd\u591f\u521b\u5efa\u4e00\u4e2a\u53ef\u7531\u9f20\u6807\u6eda\u8f6e\u6eda\u52a8\u548c\u9f20\u6807\u5de6\u952e\u62d6\u52a8\u7684\u9875\u9762\uff0c\u4f60\u53ef\u4ee5\u81ea\u884c\u66f4\u6362\u5176\u80cc\u666f\uff0c\u53ea\u8981\u4f60\u5728\u4e3b\u5faa\u73af\u524d\u8c03\u7528\u51fd\u6570`bp.set_as_background()`\n\n### PRS \u4e2d\u7684\u5d4c\u5957\u64cd\u4f5c\n\u5728 PRS \u4e2d\uff0c\u4e00\u5207\u5c55\u793a\u578b\u7ec4\u4ef6\u90fd\u53ef\u901a\u8fc7\u6258\u7ba1 (trusteeship) \u7684\u65b9\u5f0f\u8fdb\u884c\u5d4c\u5957\u3002\n\n#### \u5728\u9875\u9762\u4e2d\u5d4c\u5957\u6309\u94ae\nPRS \u4e2d\u6240\u6709\u7ec4\u4ef6\u6258\u7ba1\u6309\u94ae\u7684\u65b9\u5f0f\u5747\u76f8\u540c\uff0c\u5c31\u50cf\u4e0b\u9762\u5c55\u793a\u7684\uff1a\n\n```python\nimport sys\nimport pygame\nimport GTC_Pygame_Runtime_Support as gPRS\n\nscreen = pygame.display.set_mode((500, 500))\nbp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)\n\nif __name__ == '__main__':\n clock = pygame.time.Clock()\n bp.surface.fill((255, 255, 255))\n for i in range(100):\n pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])\n bp.set_as_background()\n bt = gPRS.button.FeedbackButton([40, 40], [20, 20], '114', 10, bp.surface)\n bp.add_button_trusteeship(bt)\n\n mw = [False, False]\n while True:\n mw = [False, False]\n for event in pygame.event.get():\n if event.type == pygame.QUIT:\n sys.exit()\n elif event.type == pygame.MOUSEBUTTONDOWN:\n if event.button == 4:\n mw[1] = True\n elif event.button == 5:\n mw[0] = True\n bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)\n if bt.on_click:\n print('clicked')\n pygame.display.flip()\n clock.tick(60)\n```\n\nPRS \u901a\u5e38\u901a\u8fc7`item.add_button_trusteeship(button)`\u7684\u5f62\u5f0f\u6dfb\u52a0\u5d4c\u5957\u6309\u94ae\uff0c\u540c\u65f6\u6309\u94ae\u58f0\u660e\u65f6\u7684\u76ee\u6807 surface \u5e94\u6307\u5411\u88ab\u5d4c\u5957\u5bf9\u8c61\u7684 surface\uff0c\u901a\u5e38\u662f`item.surface`\u3002\n\n#### \u5728\u9875\u9762\u4e2d\u5d4c\u5957\u9875\u9762\n\u539f\u7406\u57fa\u672c\u540c\u4e0a\u3002\n\n```python\nimport sys\nimport pygame\nimport GTC_Pygame_Runtime_Support as gPRS\n\nscreen = pygame.display.set_mode((500, 500))\nbp = gPRS.page.PlainPage([300, 300], [300, 1000], [100, 100], screen, 1.4, True)\n\nif __name__ == '__main__':\n clock = pygame.time.Clock()\n bp.surface.fill((255, 255, 255))\n for i in range(100):\n pygame.draw.line(bp.surface, [0, 0, 0], [0, 10 * i], [300, 10 * i])\n bp.set_as_background()\n inner_p = gPRS.page.PlainPage([100, 100], [100, 300], [50, 200], bp.surface, wheel_support=True)\n inner_p.surface.fill((255, 255, 255))\n for i in range(100):\n pygame.draw.line(inner_p.surface, [0, 0, 255], [0, 9 * i], [300, 9 * i])\n inner_p.set_as_background()\n bp.add_page_trusteeship(inner_p)\n\n mw = [False, False]\n while True:\n mw = [False, False]\n for event in pygame.event.get():\n if event.type == pygame.QUIT:\n sys.exit()\n elif event.type == pygame.MOUSEBUTTONDOWN:\n if event.button == 4:\n mw[1] = True\n elif event.button == 5:\n mw[0] = True\n bp.operate(pygame.mouse.get_pos(), pygame.mouse.get_pressed(3), mw, True)\n pygame.display.flip()\n clock.tick(60)\n```\n\n\u901a\u8fc7\u4ee5\u4e0a\u4ecb\u7ecd\uff0c\u60a8\u5e94\u8be5\u80fd\u5bf9 PRS \u7684\u4f7f\u7528\u7279\u70b9\u6709\u5927\u6982\u7684\u4e86\u89e3\u3002\n\n\u60f3\u8981\u83b7\u53d6\u5b8c\u6574\u6587\u6863\uff1f\u70b9\u51fb\u524d\u5f80[\u8bed\u96c0\u6587\u6863](https://www.yuque.com/tdkjzx/gtc_prs)",
"bugtrack_url": null,
"license": null,
"summary": "Integrated Pygame application development support.",
"version": "0.0.20",
"project_urls": {
"Documentation": "https://www.yuque.com/tdkjzx/gtc_prs",
"Repository": "https://github.com/GTC-Software-Studio/GTC-Pygame-Runtime-Support/"
},
"split_keywords": [
"development",
" pygame",
" software"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6239b31e729882b240f52e42f8f70bb9c5fb06d1f889ee652288843d4baabd63",
"md5": "b8a8d03e446d666f137ddd9747e1cef7",
"sha256": "38f8f5694623b183d6275489b7f8f6ae6aad88d6c1568d814eb38e18bf2936ff"
},
"downloads": -1,
"filename": "gtc_pygame_runtime_support-0.0.20-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "b8a8d03e446d666f137ddd9747e1cef7",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 47777,
"upload_time": "2025-09-06T03:18:08",
"upload_time_iso_8601": "2025-09-06T03:18:08.592828Z",
"url": "https://files.pythonhosted.org/packages/62/39/b31e729882b240f52e42f8f70bb9c5fb06d1f889ee652288843d4baabd63/gtc_pygame_runtime_support-0.0.20-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-06 03:18:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GTC-Software-Studio",
"github_project": "GTC-Pygame-Runtime-Support",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "gtc-pygame-runtime-support"
}
JSON
