目录

pyglet库

功能特点

安装和导入

安装

导入

基本代码框架

导入模块

创建窗口

创建控件

定义事件

运行应用  

程序界面

运行结果

完整代码

标签控件

常用事件

窗口事件

鼠标事件

键盘事件

文本事件

其它场景 

网页标签 

音乐播放

图片显示

祝大家新年快乐，龙行龘龘！

---

pyglet库

是一个跨平台的Python多媒体库，提供了一个简单易用的接口来创建窗口、加载图像和视频、播放音频、处理用户输入事件以及进行2D图形绘制。特别适合用于游戏开发、视听应用以及其它需要高效图形渲染和音频播放的项目。

功能特点

1. 跨平台支持：
   Pyglet 可以在 Windows、Mac OS X 和 Linux 平台上运行，得益于其对这些操作系统底层图形和音频API的良好封装。
2. 窗口与事件处理：
   创建窗口和全屏应用程序，并且能够轻松管理窗口的各种属性如大小、位置、标题等。
   提供全面的键盘、鼠标和其他输入设备事件处理机制，可以方便地编写交互式程序。
3. 图形绘制：
   支持OpenGL ES 2.0，可以在窗口中直接进行2D图形绘制，包括点、线、多边形、纹理贴图等。
   内置一套简单的图形API，可用于构建复杂的2D图形界面和动画。
4. 图像与媒体文件：
   能够加载和显示各种格式的图片（如PNG、JPG、GIF等）。
   支持播放多种音频格式，通过内部集成的音频解码器可以直接播放WAV、MP3、OGG等多种音频文件。
5. 文本渲染：
   提供基本的文本渲染能力，可以将文本转化为纹理并显示在屏幕上。
6. 异步I/O与定时器：
   内建了异步I/O的支持，允许开发者非阻塞地加载资源或执行其他后台任务。
   支持设置定时器，用于实现帧率控制、动画更新等功能。
7. 架构灵活性：
   Pyglet 没有采用严格的场景图结构或者游戏循环，而是给予开发者更大的自由度来设计自己的程序架构。
8. 轻量化与性能：
   相比于一些更大型的游戏开发框架，Pyglet 更为简洁和轻巧，启动速度快，内存占用相对较小。

安装和导入

安装

pip install pyglet

导入

import pyglet

---

基本代码框架

导入模块

import pyglet

创建窗口

window = pyglet.window.Window()  

创建控件

label = pyglet.text.Label('Hello, world',  
                          font_name='Times New Roman',  
                          font_size=36,  
                          x=window.width//2, y=window.height//2,  
                          anchor_x='center', anchor_y='center')

定义事件

@window.event  
def on_draw():  
    # 定义窗口的绘制事件处理函数
    window.clear()  #清除窗口 
    label.draw()   # 绘制标签

运行应用  

pyglet.app.run()

程序界面

运行结果

完整代码

import pyglet

window = pyglet.window.Window() 

label = pyglet.text.Label('Hello, world',  
                          font_name='Times New Roman',  
                          font_size=36,  
                          x=window.width//2, y=window.height//2,  
                          anchor_x='center', anchor_y='center')

@window.event  
def on_draw():
    window.clear()
    label.draw()

pyglet.app.run()

注：处理事件的函数装饰器为 @window.event 

标签控件

class Label(text='', font_name=None, font_size=None, bold=False, italic=False, 

stretch=False, color=(255, 255, 255, 255), x=0, y=0, z=0, width=None, height=None, 

anchor_x='left', anchor_y='baseline', rotation=0, align='left', multiline=False, 

dpi=None, batch=None, group=None, program=None)

---

常用事件

窗口事件

1. on_draw()：当窗口需要重绘时触发。这是最常用的事件之一，用于绘制图形、文本等到窗口上。
2. on_resize(width, height)：当窗口大小改变时触发。开发者可以在此事件中调整视图或重新布局界面元素。
3. on_close()：当用户尝试关闭窗口时触发。开发者可以在此事件中执行清理操作或询问用户是否真的想要退出。

鼠标事件

1. on_mouse_motion(x, y, dx, dy)：当鼠标在窗口内移动时触发。提供鼠标的当前位置。
2. on_mouse_press(x, y, button, modifiers)：当鼠标按钮按下时触发。提供鼠标的位置和按下的按钮。
3. on_mouse_release(x, y, button, modifiers)：当鼠标按钮释放时触发。类似于on_mouse_press，但表示按钮的释放动作。
4. on_mouse_drag(x, y, dx, dy, buttons, modifiers)：当鼠标按下并拖动时触发。提供鼠标的位置、移动的距离和按下的按钮。
5. on_mouse_enter(x, y)：当鼠标指针进入窗口时触发。
6. on_mouse_leave(x, y)：当鼠标指针离开窗口时触发。

键盘事件

1. on_key_press(symbol, modifiers)：当键盘上的键被按下时触发。提供按键的符号和任何修饰键（如Shift、Ctrl等）的状态。
2. on_key_release(symbol, modifiers)：当键盘上的键被释放时触发。类似于on_key_press，但表示按键的释放动作。

文本事件

1. on_text(text)：当可打印字符被输入时触发。这不同于键盘事件，因为它解释了键盘布局和修饰键，提供了实际的文本字符。
2. on_text_motion(motion)：当文本输入的光标或选择发生变化时触发（不常用）。
3. on_text_motion_select(motion)：当文本被选择时触发（不常用）。

例：增加一个按键事件 on_key_press

import pyglet

window = pyglet.window.Window()

pyglet.gl.glClearColor(200/255, 220/255, 220/255, 1)

label = pyglet.text.Label('Hello, world',  
                          font_name='Times New Roman',  
                          font_size=36,  
                          x=window.width//2, y=window.height//2,  
                          anchor_x='center', anchor_y='center',
                          color=(0, 0, 0, 255))

@window.event
def on_draw():
    window.clear()
    label.draw()

@window.event
def on_key_press(symbol, modifiers):
    if symbol == pyglet.window.key.ESCAPE:
        window.close()

pyglet.app.run()

另改变了窗口背景色(200,220,220) ，标签前景色改为黑色。

增加鼠标事件 on_mouse_press，同时引入key和mouse：

from pyglet.window import key
from pyglet.window import mouse

完整代码：

import pyglet
from pyglet.window import key
from pyglet.window import mouse

window = pyglet.window.Window()

pyglet.gl.glClearColor(200/255, 220/255, 220/255, 1)

label = pyglet.text.Label('Hello, world',  
                          font_name='Times New Roman',  
                          font_size=36,  
                          x=window.width//2, y=window.height//2,  
                          anchor_x='center', anchor_y='center',
                          color=(0, 0, 0, 255))

@window.event
def on_draw():
    window.clear()
    label.draw()

@window.event
def on_key_press(symbol, modifiers):
    if symbol in range(97,97+26):
        text = f'The {chr(symbol-32)} key was pressed.'
    elif symbol == key.LEFT:
        text = 'The left arrow key was pressed.'
    elif symbol == key.ENTER:
        text = 'The enter key was pressed.'
    label.text = text

@window.event
def on_mouse_press(x, y, button, modifiers):
    if button == mouse.LEFT:
        text = 'The left mouse button was pressed.'
    elif button == mouse.MIDDLE:
        text = 'The middle mouse button was pressed.'
    elif button == mouse.RIGHT:
        text = 'The right mouse button was pressed.'
    label.text = text

pyglet.app.run()

按键和鼠标点击的消息在标签中显示，直接改变标签.text属性即可：

其它场景 

网页标签 

class HTMLLabel(text='', location=None, x=0, y=0, z=0, width=None, height=None, 

anchor_x='left', anchor_y='baseline', rotation=0, multiline=False, dpi=None, 

batch=None, group=None, program=None)

注意参数设置：multiline=True 

import pyglet

window = pyglet.window.Window()

pyglet.gl.glClearColor(200/255, 220/255, 220/255, 1)


text = '''
<html>
<head>
<meta charset="utf-8">
<title>pyglet</title>
</head>
<body>
    <h1>第一级标题</h1>
    <p>我的<font color="red">第1个</font>段落。</p>
    <h2>第二级标题</h2>
    <p>我的<font color="blue">第2个</font>段落。</p>
</body>
</html>
'''
label = pyglet.text.HTMLLabel(text, x=10, y=window.height-10, width=500, anchor_y='top', multiline=True)

@window.event
def on_draw():
    window.clear()
    label.draw()

pyglet.app.run()

运行结果：

音乐播放

import pyglet

music = pyglet.resource.media('voice1.mp3')
music.play()

pyglet.app.run()

图片显示

import pyglet

window = pyglet.window.Window(width=1200, height=900)
image = pyglet.resource.image('lunar.jpg')

@window.event
def on_draw():
    window.clear()
    image.blit(0, 0)

pyglet.app.run()

祝大家新年快乐，龙行龘龘！