Pygame 官方文档 - pygame.surfarray

最新推荐文章于 2024-07-17 19:34:21 发布
最新推荐文章于 2024-07-17 19:34:21 发布
阅读量3.7k 收藏 13
点赞数 1
分类专栏： Pygame 官方文档 - 中译版 文章标签： Pygame 官方文档 中文版 中译版
Pygame.surfarray提供了一系列函数，如array2d、pixels2d等，用于在pygame surfaces和数组之间转换像素数据。这些函数允许直接读写Surface的像素，包括颜色通道和透明度。对于24位和32位Surface，可以创建直接引用像素值的2D或3D数组，而其他函数则用于处理特定颜色通道或透明度。
摘要由CSDN通过智能技术生成

pygame.surfarray

pygame模块用于使用数组接口访问surface像素数据
pygame.surfarray.array2d - 将像素复制到2d数组中
pygame.surfarray.pixels2d - 将像素引用到2d数组中
pygame.surfarray.array3d - 将像素复制到3d数组中
pygame.surfarray.pixels3d - 将像素引用到3d数组中
pygame.surfarray.array_alpha - 将像素alpha复制到2d数组中
pygame.surfarray.pixels_alpha - 将像素alpha引用到2d数组
pygame.surfarray.pixels_red - 将像素红色引用到2d数组
pygame.surfarray.pixels_green - 将像素绿色引用到2d数组
pygame.surfarray.pixels_blue - 将像素蓝色引用到2d数组
pygame.surfarray.array_colorkey - 将colorkey值复制到2d数组中
pygame.surfarray.make_surface - 将数组复制到新surface
pygame.surfarray.blit_array - 直接从数组值Blit
pygame.surfarray.map_array - 将3d数组映射到2d数组
pygame.surfarray.use_arraytype - 设置用于surface数组的数组系统
pygame.surfarray.get_arraytype - 获取当前活跃的数组类型
pygame.surfarray.get_arraytypes - 获取当前支持的数组系统类型

        在pygame的surfaces和数组之间转换像素数据的函数。 只有当pygame可以使用外部NumPy包时，此模块才会起作用。
        每个像素都存储为单个整数值，以表示红色，绿色和蓝色。 8位图像使用查看色彩映射的值。 具有更高深度的像素使用比特打包过程将三个或四个值放入单个数字中。
        数组首先由X轴索引，然后是Y轴。 将像素视为单个整数的数组称为2D数组。 此模块还可以将红色，绿色和蓝色值分隔为单独切片。 这些类型的数组称为3D数组，最后一个索引为0表示红色，1表示绿色，2表示蓝色。
 

pygame.surfarray.array2d() ↶

将像素复制到2d数组中
array2d(Surface) -> array
将映射（原始）像素从Surface复制到2D数组。 surface的位深度将控制整数值的大小，并适用于任何类型的像素格式。
此函数将在复制像素时暂时锁定Surface（请参阅pygame.Surface.lock() 锁定Surface存储器以进行像素访问 - 锁定Surface存储器以获取像素访问方法）。
搜索pygame.surfarray.array2d的示例

pygame.surfarray.pixels2d() ↶

将像素引用到2d数组中
pixels2d(Surface) -> array
创建一个直接引用Surface中像素值的新2D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
无法引用24位Surface的像素，但所有其他Surface位深度都可以。
Surface引用将在数组的生命周期内保持锁定状态（请参阅pygame.Surface.lock() 锁定Surface内存以进行像素访问 - 锁定Surface内存以获取像素访问方法）。
搜索pygame.surfarray.pixels2d的示例

pygame.surfarray.array3d() ↶

将像素复制到3d数组中
array3d(Surface) -> array
将像素从Surface复制到3D数组。 surface的位深度将控制整数值的大小，并适用于任何类型的像素格式。
此函数将在复制像素时暂时锁定Surface（请参阅pygame.Surface.lock() 锁定Surface存储器以进行像素访问 - 锁定Surface存储器以获取像素访问方法）。
搜索pygame.surfarray.array3d的示例

pygame.surfarray.pixels3d() ↶

将像素引用到3d数组中
pixels3d(Surface) -> array
创建一个直接引用Surface中像素值的新3D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
这仅适用于具有24位或32位格式的Surface。 不能引用较低的像素格式。
Surface引用将在数组的生命周期内保持锁定状态（请参阅pygame.Surface.lock() 锁定Surface内存以进行像素访问 - 锁定Surface内存以获取像素访问方法）。
搜索pygame.surfarray.pixels3d的示例

pygame.surfarray.array_alpha() ↶

将像素alpha复制到2d数组中
array_alpha(Surface) -> array
将像素alpha值（透明度）从Surface复制到2D数组。 这适用于任何类型的Surface格式。 没有像素alpha的surface将返回包含所有不透明值的数组。
此函数将在复制像素时暂时锁定Surface（请参阅pygame.Surface.lock（）锁定Surface存储器以进行像素访问 - 锁定Surface存储器以获取像素访问方法）。
搜索pygame.surfarray.array_alpha的示例

pygame.surfarray.pixels_alpha() ↶

将像素alpha引用到2d数组
pixels_alpha(Surface) -> array
创建一个直接引用Surface中Alpha值（透明度）的新2D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
这只适用于具有每像素alpha值的32位Surface。
此数组引用的Surface将在数组的生命周期内保持锁定状态。
搜索pygame.surfarray.pixels_alpha的示例

pygame.surfarray.pixels_red() ↶

将像素红色引用到2d数组
pixels_red (Surface) -> array
创建一个直接引用Surface中红色值的新2D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
这只适用于24位或32位Surface。
此数组引用的Surface将在数组的生命周期内保持锁定状态。
搜索pygame.surfarray.pixels_red的示例

pygame.surfarray.pixels_green() ↶

将像素绿色引用到2d数组
pixels_green (Surface) -> array
创建一个直接引用Surface中绿色值的新2D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
这只适用于24位或32位Surface。
此数组引用的Surface将在数组的生命周期内保持锁定状态。
搜索pygame.surfarray.pixels_green的示例

pygame.surfarray.pixels_blue() ↶

将像素蓝色引用到2d数组
pixels_blue (Surface) -> array
创建一个直接引用Surface中蓝色值的新2D数组。 对数组的任何更改都将影响Surface中的像素。 这是一个快速操作，因为没有数据被复制。
这只适用于24位或32位Surface。
此数组引用的Surface将在数组的生命周期内保持锁定状态。
搜索pygame.surfarray.pixels_blue的示例

pygame.surfarray.array_colorkey() ↶

将colorkey值复制到2d数组中
array_colorkey(Surface) -> array
使用每个像素的colorkey透明度值创建一个新数组。 如果像素与colorkey匹配，则它将完全透明; 否则它将是完全不透明的。
这适用于任何类型的Surface格式。 如果图像没有colorkey，则返回固定的不透明数组。
此功能将在复制像素时临时锁定Surface。
搜索pygame.surfarray.array_colorkey的示例

pygame.surfarray.make_surface() ↶

将数组复制到新surface
make_surface(array) -> Surface
创建一个最类似于数组上数据和格式的新Surface。 数组可以是2D或3D，具有任何大小的整数值。 函数make_surface使用数组结构接口来获取数组属性，因此不仅限于NumPy数组。 有关一般像素数组复制，请参阅pygame.pixelcopypygame模块。
pygame 1.9.2中的新功能：数组结构接口支持。
搜索pygame.surfarray.make_surface的示例

pygame.surfarray.blit_array() ↶

直接从数组值Blit
blit_array(Surface, array) -> None
直接将数组中的值复制到Surface中。 这比将数组转换为Surface和blitting更快。 该数组必须与Surface具有相同的尺寸，并将完全替换所有像素值。 只接受整数，ASCII字符和记录数组。
复制新值时，此函数将暂时锁定Surface。
搜索pygame.surfarray.blit_array的示例

pygame.surfarray.map_array() ↶

将3d数组映射到2d数组
map_array(Surface, array3d) -> array2d
将3D数组转换为2D数组。 这将使用给定的Surface格式来控制转换。 NumPy数组支持调色板surface格式。
搜索pygame.surfarray.map_array的示例

pygame.surfarray.use_arraytype() ↶

设置用于surface数组的数组系统
use_arraytype (arraytype) -> None
DEPRECATED：使用模块函数请求的数组类型。 唯一受支持的数组类型是’numpy’。 其他值将引发ValueError。
搜索pygame.surfarray.use_arraytype的示例

pygame.surfarray.get_arraytype() ↶

获取当前活跃的数组类型
get_arraytype () -> str
DEPRECATED：返回当前活跃的数组类型。 这将是get_arraytypes()元组的值，并指示用于数组创建的数组模块类型。
pygame 1.8的新特性。
搜索pygame.surfarray.get_arraytype的示例

pygame.surfarray.get_arraytypes() ↶

获取当前支持的数组系统类型
get_arraytypes () -> tuple
DEPRECATED：检查哪些数组系统可用并将它们作为字符串元组返回。 元组的值可以直接在pygame.surfarray.use_arraytype()方法中使用。 如果找不到支持的数组系统，则返回None。
pygame 1.8的新特性。
搜索pygame.surfarray.get_arraytypes的示例
 

以上文档，自己翻译，可能有误，可参考：pygame.surfarray

点我回顶部 ☚

 
 
 
 
 
 
Fin.

小黑LLB
关注
  • 1
    点赞
  • 踩
  • 13
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
pygame----Surfarray介绍
小小鸟的博客
05-15 636
Surfarray介绍 本教程将尝试向用户介绍NumPy和pygame surfarray模块。 对于初学者来说，使用surfarray的代码可能相当吓人。 但实际上只有几个概念需要理解，你就可以开始运行了。 使用surfarray模块，可以直接从python代码执行像素级操作。 性能可以非常接近用C编写代码的水平。 您可能只是想跳转到“示例”部分，以了解这个模块可能实现的功能，然后从这里的开头开始逐步进行。 我不会骗你，让你觉得一切都很容易。 通过修改像素值来获得更高级的效果是非常棘手的。 仅仅是掌握Nu
Pygame 官方文档 - Tutorials - Surfarray模块介绍（Surfarray Introduction）
Enderman_xiaohei的博客
03-23 2013
Surfarray模块介绍（Surfarray Introduction） Author: Pete Shinners Contact: pete@shinners.org 介绍（Introduction）         本教程将尝试向用户介绍NumPy和pygame surfarray模块。对于初学者来说，使用surfarray的代码可能非常令人生畏。...
PyGame安装入门指南
最新发布
s011803的专栏
07-17 1262
Pygame是一个开源的Python模块，专门用于开发2D游戏和多媒体应用程序。它是基于SDL（Simple DirectMedia Layer）库构建的，提供了对图像、声音、音乐、输入设备等多种资源的高效管理和操作。Pygame的设计宗旨是简化游戏开发过程，让开发者能够专注于游戏逻辑和玩法的实现，而不必过多地关注底层图形处理的细节。Pygame适合制作简单的2D游戏，并且是许多新手程序员进入游戏开发领域的跳板。
pygame.surfarray.array3d()的作用
大坡3D软件开发
03-17 3168
pygame.surfarray.array3d()Copy pixels into a 3d arrayarray3d(Surface) -> arrayCopy the pixels from a Surface into a 3D array. The bit depth of the surface will control the size of the integer values,
Pygame Surface创建图像——《Python游戏开发库Pygame》
Python老吕的博客
05-19 975
Pygame的Surface对象是一个功能强大的工具，它允许你在内存中创建和操作图像。通过掌握Surface的基本概念和操作，你可以开发出各种复杂的视觉效果和交互功能。Surface只是Pygame库中的一部分，Pygame还提供了许多其他的功能和组件，如事件处理、音频播放、碰撞检测等。为了充分利用Pygame的能力，建议你继续深入学习其他相关的知识和技术。随着游戏开发技术的不断发展，Pygame也在不断演进和完善。未来，我们可以期待Pygame在性能优化、功能扩展和易用性方面取得更多的进步。
Pygame 粒子物理：Numba实现同时渲染十万+像素
ChillingKangaroo的博客
12-18 425
图中同时渲染了十万个像素，没有明显掉帧。
Python库 | pygame-textinput-1.0.1.tar.gz
04-13
资源分类：Python库 所属语言：Python 资源全名：pygame-textinput-1.0.1.tar.gz 资源来源：官方 安装方法：https://lanzao.blog.csdn.net/article/details/101784059
pygame-2.5.0-cp312-cp312-win32.whl
02-24
py依赖包
pygame-1.9.6-cp36-cp36m-win32.whl
03-24
pygame-1.9.6-cp36-cp36m-win32 下载了巨久，发现只支持32位Windows系统 自身python解释器的类型 需要的可以下载，省去下载时间
pygame-1.9.6-cp37-cp37m-win32.whl
02-05
pygame for windows x32 , python 3.7 windows下pygame的32位安装包，适用于python 3.7
make-surface:矢量曲面创建例程
05-13
Makesurface cool-tools 栅格-> Python中的矢量曲面创建工具 安装 从GitHub： pip install -e git+git@github.com:mapbox/make-surface.git#egg=makesurface 从PyPI pip install makesurface --pre 手动的 安装依赖项： 'click> = 3.0'，'fiona'，'numpy'，'rasterio'，'shapely'，'scipy'，'mercantile'，'pyproj' 克隆此仓库： ：控制台： git clone git@github.com:mapbox/make-surface.git cd进入：console： make-surface然后pip install -e . 用法-矢量化 makesurface vecto
【译】使用“不安全“的Python加速100倍代码运行速度
一只大鸽子的博客
05-24 673
我们将使用“不安全”的Python将一些Numpy代码加速100倍。
Pygame库中Surface 对象介绍
cnds123的专栏
01-20 1991
Pygame库中Surface 对象介绍，并给出示例：使用Python的pygame库画花
Pygame基本函数库及其功能的快速查找
qq_41450585的博客
05-10 997
pygame模块用于使用数组接口访问surface像素数据 1. pygame.event 管理事件和事件队列 pygame.event.get()-从队列中获取事件 2. pygame.time 控制时间 pygame.time.Clock()- 创建一个对象来帮助跟踪时间 .tick():更新时钟. 3. pygame.display 控制显示窗口或屏幕 .init-初始化模块 .quit-取消初始化模块 .get_init-如果显示模块已初始化,则返回True .set_m..
Pygame详解（十二）：Surface 对象
热门推荐
来自江南的你的博客
01-12 4万+
pygame.Surface Pygame 中用于表示图像的对象。 Surface((width, height), flags=0, depth=0, masks=None) -> Surface Surface((width, height), flags=0, Surface) -> Surface 属性 & 方法 pygame.Surface.blit()  ...
pygame之Surface模块
河间老王的博客
01-23 7187
                          Surface-用于表示图像的Pygame对象 Surface((width, height), flags=0, depth=0, masks=None) -> Surface Surface((width, height), flags=0, Surface) -> Surface pygame.Surface.blit—将...
Pygame与OpenCV联合播放视频并尽量保证音画同步
h281001460的博客
06-29 2297
Pygame与OpenCV联合播放视频 Pygame是一个超好用的SDL绑定。自从有了Pygame，妈妈再也不用担心我内存泄漏了。 但是这里有一个问题，Pygame的Movie模块已经废弃多年，这次做课题项目却要在一个游戏中来段视频播放。有点蒙圈。Ren’py提供的解决方案是使用libav，我尝试了一早上也搞不明白pyav怎么用。后来干脆用手边的OpenCV硬读视频吧。 这里说下第三方库： pyg...
Pygame 官方文档 - pygame.pixelcopy
Enderman_xiaohei的博客
03-10 1093
pygame.pixelcopy pygame模块用于通用的像素数组复制 pygame.pixelcopy.surface_to_array - 将surface像素复制到数组对象 pygame.pixelcopy.array_to_surface - 将数组对象复制到surface pygame.pixelcopy.map_array - 使用surface格式将数组复制到另一个数组 py...
pygame.surfarray.array3d
03-31
The pygame.surfarray.array3d function returns a 3-dimensional NumPy array that represents the RGB color values of a pygame surface. The array has dimensions (height, width, 3), where the third dimension represents the red, green, and blue color channels. Each element of the array represents the color values of a single pixel in the surface. Here is an example usage of pygame.surfarray.array3d: ```python import pygame import numpy as np # create a pygame surface width, height = 100, 100 surface = pygame.Surface((width, height)) # fill the surface with a red color color = (255, 0, 0) surface.fill(color) # convert the surface to a 3D array arr = pygame.surfarray.array3d(surface) # print the shape of the array and the color values of the first pixel print(arr.shape) # (100, 100, 3) print(arr[0, 0]) # [255 0 0] ``` In this example, we create a 100x100 pygame surface and fill it with a red color. We then use pygame.surfarray.array3d to convert the surface to a 3D NumPy array. Finally, we print the shape of the array and the color values of the first pixel (which should be [255, 0, 0] for a red color).
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值