1 简介
WxGL是一个基于PyOpenGL的跨平台三维数据快速可视化工具包,提供类似Matplotlib风格的应用方式。WxGL也可以集成到wxPython或PyQt6中实现更多的功能和控制。
WxGL提供了一套简洁易用、对用户友好的API,将OpenGL的复杂概念封装起来,使得用户可以更加专注于数据的处理,而无需在3D显示方面耗费精力。WxGL还提供了着色器语言接口,允许用户定制着色器,以应对特殊的应用需求。
作为开源项目,WxGL遵循MIT开源软件许可协议。使用、复制、修改本软件以及出版发行、再授权、贩售本软件,须以接受MIT授权协议的约束为前提。
项目地址
中文文档
2 安装
WxGL模块使用pip命令安装。
pip install wxgl
以下模块为WxGL所依赖,如果当前系统没有安装或者版本不满足要求,安装过程将同时安装或更新它们。
- pyopengl - 推荐版本:3.1.5或更高
- numpy - 推荐版本:1.18.2或更高
- matplotlib - 推荐版本:3.1.2或更高
- pyqt6 - 推荐版本:6.3.0或更高
- pillow - 推荐版本:8.2.0或更高
- freetype-py - 推荐版本:2.2.0或更高
- imageio - 推荐版本:2.22.0或更高
- imageio-ffmpeg - 推荐版本:0.4.8或更高
- webp - 推荐版本:0.1.5或更高
WxGL使用WxPython或PyQt6作为显示后端,上述安装过程自动安装了PyQt6模块。如果想使用WxPython作为显示后端,请自行安装。
在Windows和macOS平台上,可使用如下命令WxPython模块。
pip install -U wxPython
在Linux平台上,以Ubuntu为例,可使用如下命令WxPython模块。
pip install -U -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-20.04 wxPython
3 快速体验
3.1 熟悉的风格
下面这几行代码,绘制了一个中心在三维坐标系原点半径为1的纯色圆球。忽略模块名的话,这些代码和Matplotlib的风格非常相似。
import wxgl
app = wxgl.App()
app.sphere((0,0,0), 1, color='cyan')
app.title('快速体验:$x^2+y^2+z^2=1$')
app.show()
3.2 Colorbar
对于数据快速可视化工具来说,Colorbar是必不可少的。下面的代码演示了Colorbar最简单的用法。
import numpy as np
import wxgl
z, x = np.mgrid[-np.pi:np.pi:51j, -np.pi:np.pi:51j]
y = np.sin(x) + np.cos(z)
cm = 'viridis' # WxGL的颜色映射方案继承自Matplotlib
app = wxgl.App()
app.title('网格曲面')
app.mesh(x, y, z, data=y, cm=cm, fill=False)
app.colorbar((y.min(), y.max()), cm=cm, ff=lambda v:'%.2f'%v) # ff用于设置ColorBar刻度标注的格式化函数
app.show()
3.3 光照和材质
WxGL提供了BaseLight(基础光照模式)、SunLight(太阳光照模式)、LampLight(点光源光照模式)、SkyLight(户外光照模式)、SphereLight(球谐光照模式)等多种光照方案。即使不设置light参数,WxGL的模型也都使用了默认的光照模式。下面的代码使用light参数演示了不同光照模式下的球环模型。
import wxgl
app = wxgl.App()
app.text('太阳光', (-5,7.5,0), align='center')
app.torus((-5,4,0), 1, 3, vec=(0,1,1), light=wxgl.SunLight())
app.text('灯光', (5,7.5,0), align='center')
app.torus((5,4,0), 1, 3, vec=(0,1,1), light=wxgl.LampLight())
app.text('户外光', (-5,-0.5,0), align='center')
app.torus((-5,-4,0), 1, 3, vec=(0,1,1), light=wxgl.SkyLight())
app.text('球谐光', (5,-0.5,0), align='center')
app.torus((5,-4,0), 1, 3, vec=(0,1,1), light=wxgl.SphereLight(5))
app.show()
光照模式配合漫反射系数、镜面反射系数、高光系数、透光系数等参数,可模拟出不同的材质。这几个参数的默认值和值域范围请参考本文档的API部分。下面的代码绘制了塑料质感的分子3D模型。
import wxgl
c1, c2, c3, c4, c5 = '#d8d8d8', '#00d0d0', '#6060f0', '#903030', '#90C090'
light = wxgl.SunLight(direction=(0.5,-0.5,-1.0), diffuse=0.7, specular=0.98, shiny=100, pellucid=0.9)
app = wxgl.App(bg='#f0f0f0', azim=-30, elev=20, fovy=40)
app.sphere((-2,0,0), 0.35, color=c1, light=light)
app.sphere((0,0,0), 0.35, color=c1, light=light)
app.sphere((2,0,0), 0.35, color=c1, light=light)
app.sphere((-1,-1,0), 0.35, color=c1, light=light)
app.sphere((1,-1,0), 0.35, color=c1, light=light)
app.cylinder((-2,0,0), (-1,-1,0), 0.17, color=c2, light=light)
app.cylinder((0,0,0), (-1,-1,0), 0.17, color=c2, light=light)
app.cylinder((0,0,0), (1,-1,0), 0.17, color=c2, light=light)
app.cylinder((2,0,0), (1,-1,0), 0.17, color=c2, light=light)
app.sphere((-2,1.2,-0.6), 0.35, color=c3, light=light)
app.sphere((-3,-0.6,0.6), 0.35, color=c3, light=light)
app.sphere((2.6,0.5,1), 0.35, color=c3, light=light)
app.sphere((2.6,0.5,-1), 0.35, color=c3, light=light)
app.sphere((1,-1.5,1), 0.35, color=c5, light=light)
app.cylinder((-2,0,0), (-2,1.2,-0.6), 0.17, color=c4, light=light)
app.cylinder((-2,0,0), (-3,-0.6,0.6), 0.17, color=c2, light=light)
app.cylinder((2,0,0), (2.6,0.5,1), 0.17, color=c4, light=light)
app.cylinder((2,0,0), (2.6,0.5,-1), 0.17, color=c2, light=light)
app.cylinder((1,-1,0), (1,-1.5,1), 0.17, color=c2, light=light)
app.sphere((0,0.7,-0.8), 0.15, color=c2, light=light)
app.sphere((0,0.7,0.8), 0.15, color=c2, light=light)
app.sphere((-1,-1.7,-0.8), 0.15, color=c2, light=light)
app.sphere((-1,-1.7,0.8), 0.15, color=c2, light=light)
app.cylinder((0,0,0), (0,0.7,-0.8), 0.08, color=c2, light=light)
app.cylinder((0,0,0), (0,0.7,0.8), 0.08, color=c2, light=light)
app.cylinder((-1,-1,0), (-1,-1.7,-0.8), 0.08, color=c2, light=light)
app.cylinder((-1,-1,0), (-1,-1.7,0.8), 0.08, color=c2, light=light)
app.show()
3.4 让模型动起来
通过transform参数传递一个以渲染时长为参数的函数给模型,可以实现复杂的模型动画。该函数返回一个由一系列旋转、位移和缩放动作组成的元组:
- 旋转用4元组表示,前3个元素是旋转轴,第4个元素是旋转角度,旋转方向遵从右手定则
- 位移用3元组表示,分别表示模型在xyz轴上的位移距离
- 缩放系数用数值表示
下面这几行代码,绘制了一个半径为1的地球,并以20°/s的角速度绕地轴自转。配合太阳光照效果和模型动画,可以清晰地看到晨昏分界线的变化。
import numpy as np
import wxgl
r = 1 # 地球半径
gv, gu = np.mgrid[np.pi/2:-np.pi/2:91j, 0:2*np.pi:361j] # 纬度和经度网格
xs = r * np.cos(gv)*np.cos(gu)
ys = r * np.cos(gv)*np.sin(gu)
zs = r * np.sin(gv)
light = wxgl.SunLight(direction=(-1,1,0), ambient=(0.1,0.1,0.1)) # 太阳光照向左前方,暗环境光
tf = lambda t : ((0, 0, 1, (0.02*t)%360), ) # 以20°/s的角速度绕y逆时针轴旋转(t是以毫秒为单位的渲染时长)
app = wxgl.App(haxis='z') # 以z轴为高度轴
app.title('自转的地球')
app.mesh(xs, ys, zs, texture='res/earth.jpg', light=light, transform=tf)
app.show()
3.5 定制着色器
除了内置的绘图函数,WxGL还提供了GLSL接口,允许用户定制着色器代码。下面的代码演示了使用定制的顶点着色器和片元着色器的基本流程。
import numpy as np
import wxgl
vshader = """
#version 330 core
in vec4 a_Position;
in vec3 a_Normal;
uniform mat4 u_ProjMatrix;
uniform mat4 u_ViewMatrix;
uniform mat4 u_ModelMatrix;
out vec3 v_Normal;
void main() {
gl_Position = u_ProjMatrix * u_ViewMatrix * u_ModelMatrix * a_Position;
mat4 NormalMatrix = transpose(inverse(u_ModelMatrix));
v_Normal = normalize(vec3(NormalMatrix * vec4(a_Normal, 1.0)));
}
"""
fshader = """
#version 330 core
uniform vec3 u_LightDir;
uniform sampler1D u_Texture;
in vec3 v_Normal;
void main() {
vec3 lightDir = normalize(u_LightDir);
float diffuseCos = max(0.0, dot(lightDir, v_Normal));
gl_FragColor = texture1D(u_Texture, diffuseCos);
}
"""
r, R = 1, 3
gv, gu = np.mgrid[180:-180:181j, 0:360:181j]
gv, gu = np.radians(gv), np.radians(gu)
xs = (R + r * np.cos(gv)) * np.cos(gu)
zs = -(R + r * np.cos(gv)) * np.sin(gu)
ys = r * np.sin(gv)
vs = np.dstack((xs, ys, zs))
rows, cols = vs.shape[:2]
vs = vs.reshape(-1, 3)
idx = np.arange(rows*cols).reshape(rows, cols)
idx_a, idx_b, idx_c, idx_d = idx[:-1,:-1], idx[1:,:-1], idx[1:,1:], idx[:-1, 1:]
idx = np.int32(np.dstack((idx_a, idx_b, idx_d, idx_c, idx_d, idx_b)).ravel())
vs = vs[idx]
a, b, c = vs[::3], vs[1::3], vs[2::3]
n = np.repeat(np.cross(b-a, a-c), 3, axis=0)
normal = np.zeros((rows*cols, 3), dtype=np.float32)
idx_arg = np.argsort(idx)
rise = np.where(np.diff(idx[idx_arg])==1)[0] + 1
rise = np.hstack((0,rise,len(idx)))
for i in range(rows*cols):
normal[i] = np.sum(n[idx_arg[rise[i]:rise[i+1]]], axis=0)
normal = normal.reshape(rows, cols, -1)
normal[0] += normal[-1]
normal[-1] = normal[0]
normal[:,0] += normal[:,-1]
normal[:,-1] = normal[:,0]
normal = normal.reshape(-1, 3)[idx]
im = np.uint8(np.stack((np.arange(256), np.zeros(256), np.zeros(256)), axis=1))
texture = wxgl.Texture(im, ttype=wxgl.TEXTURE_1D, s_tile=wxgl.GL_CLAMP_TO_EDGE)
m = wxgl.Model(wxgl.TRIANGLES, vshader, fshader)
m.set_vertex('a_Position', vs)
m.set_normal('a_Normal', normal)
m.set_argument('u_LightDir', (-5,-1,-5))
m.add_texture('u_Texture', texture)
m.set_proj_matrix('u_ProjMatrix')
m.set_view_matrix('u_ViewMatrix')
m.set_model_matrix('u_ModelMatrix')
m.set_cull_mode('back')
app = wxgl.App(elev=20, bg='#d0d0d0')
app.title('以法向量和光线向量的点积作为1D纹理坐标')
app.model(m)
app.show()
3.6 三维曲面重建
WxGL实现了基于MarchingCube算法的三维曲面重建。下面例子中使用GitHub本项目example路径下的头部CT图片完成头部三维重建。
import numpy as np
from PIL import Image
import wxgl
layers = list()
for i in range(109): # 读取109张头部CT断层扫描片,只保留透明通道
im = np.array(Image.open('res/headCT/head%d.png'%i))
layers.append(np.fliplr(im[...,3]))
data = np.stack(layers, axis=0)
app = wxgl.App(haxis='z', bg='#60e0f0')
app.isosurface(data, data.max()/8, color='#CCC6B0', xr=(-0.65,0.65), yr=(-1,1), zr=(-1,1))
app.title('基于MarchingCube算法的三维重建演示')
app.grid() # 显示网格
app.cruise(lambda t : {'azim':(0.02*t)%360}) # 相机以20°/s的角速度逆时针环绕模型
app.show()
3.7 绘制点云
只需要一个点云数据文件名(支持.ply和.pcd格式),即可绘制点云模型。此外,WxGL还提供了读取点云数据文件的函数wxgl.read_pcfile,返回一个PointCloudData类实例。
import wxgl
app = wxgl.App(haxis='z')
app.pointcloud('res/pointcloud/3.pcd')
app.show()
3.8 生成动画或视频文件
除了显示画布的show方法,wxgl.App还提供了保存画布的savefig方法。savefig不仅可以将当前OpengGL缓冲区的内容保存为.png或.jpg类型的图像文件,还可以生成.gif/.webp/.mp4/.avi等动画或视频文件。
下面这段代码绘制了一大一小两个自转的圆球,小球同时围绕大球公转。运行代码,将会生成每秒25帧共计200帧的mp4格式的视频文件。
import wxgl
tf_1 = lambda t:((0, 1, 0, (0.01*t)%360),) # 大球自转速度10°/s
def tf_2(t):
theta = -(0.05*t)%360 # 小球公转和自转都是-50°/s
rotate = (0, 1, 0, theta) # 小球自转
theta = np.radians(theta) # 角度转弧度
r = 1 # 小球公转半径
shift = (r*np.cos(theta), 0, -r*np.sin(theta)) # 小球公转
return (rotate, shift)
app = wxgl.App()
app.sphere((0,0,0), 0.8, fill=False, transform=tf_1)
app.sphere((0,0,0), 0.2, fill=False, transform=tf_2)
app.savefig('capture/revolve.mp4', fps=25, frames=200)
4 在其他GUI库中使用WxGL
WxGL提供了wxgl.wxscene.WxScene和wxgl.qtscene.QtScene两个三维场景类,分别用于在wxPython和PyQt中集成WxGL。
4.1 与wxPython集成
场景类wxgl.wxscene.WxScene是wx.glcanvas.GLCanvas的派生类,因此可以无缝地在wxPython中使用该类。三维绘图功能封装在wxgl.Scheme中,只需要将一个Scheme类实例传到场景类中即可显示三维绘图结果。
import os
import wx
import numpy as np
import wxgl
class MainFrame(wx.Frame):
"""桌面程序主窗口类"""
def __init__(self):
"""构造函数"""
wx.Frame.__init__(self, None, -1, '在WxPython中使用WxGL', size=(1200,800), style=wx.DEFAULT_FRAME_STYLE)
self.Center()
self.SetBackgroundColour((224, 224, 224))
self.scene = wxgl.wxscene.WxScene(self, self.draw())
self.visible = True
btn_home = wx.Button(self, -1, '复位', size=(100, -1))
btn_animate = wx.Button(self, -1, '启动/停止', size=(100, -1))
btn_visible = wx.Button(self, -1, '隐藏/显示', size=(100, -1))
btn_save = wx.Button(self, -1, '保存', size=(100, -1))
sizer_btn = wx.BoxSizer(wx.VERTICAL)
sizer_btn.Add(btn_home, 0, wx.TOP|wx.BOTTOM, 20)
sizer_btn.Add(btn_animate, 0, wx.TOP|wx.BOTTOM, 20)
sizer_btn.Add(btn_visible, 0, wx.TOP|wx.BOTTOM, 20)
sizer_btn.Add(btn_save, 0, wx.TOP|wx.BOTTOM, 20)
sizer_max = wx.BoxSizer()
sizer_max.Add(self.scene, 1, wx.EXPAND|wx.LEFT|wx.TOP|wx.BOTTOM, 5)
sizer_max.Add(sizer_btn, 0, wx.ALL, 20)
self.SetAutoLayout(True)
self.SetSizer(sizer_max)
self.Layout()
self.Bind(wx.EVT_BUTTON, self.on_home, btn_home)
self.Bind(wx.EVT_BUTTON, self.on_animate, btn_animate)
self.Bind(wx.EVT_BUTTON, self.on_visible, btn_visible)
self.Bind(wx.EVT_BUTTON, self.on_save, btn_save)
def draw(self):
"""绘制网格球和圆柱的组合体"""
tf = lambda t : ((0, 1, 0, (0.03*t)%360), )
sch = wxgl.Scheme()
sch.sphere((0,0,0), 1, fill=False)
sch.cylinder((-1.2,0,0), (1.2,0,0), 0.3, color='cyan', transform=tf, name='cudgel')
sch.circle((-1.2,0,0), 0.3, vec=(-1,0,0), color='cyan', transform=tf, name='cudgel')
sch.circle((1.2,0,0), 0.3, vec=(1,0,0), color='cyan', transform=tf, name='cudgel')
sch.axes()
return sch
def on_home(self, evt):
"""点击复位按钮"""
self.scene.home()
def on_animate(self, evt):
"""点击启动/停止按钮"""
self.scene.pause()
def on_visible(self, evt):
"""点击隐藏/显示按钮"""
self.visible = not self.visible
self.scene.set_visible('cudgel', self.visible)
def on_save(self, evt):
"""点击保存按钮"""
im = self.scene.get_buffer()
wildcard = 'PNG files (*.png)|*.png|JPEG file (*.jpg)|*.jpg'
dlg = wx.FileDialog(self, message='保存为文件', wildcard=wildcard, style=wx.FD_SAVE|wx.FD_OVERWRITE_PROMPT)
dlg.SetFilterIndex(0)
if dlg.ShowModal() == wx.ID_OK:
fn = dlg.GetPath()
name, ext = os.path.splitext(fn)
if ext != '.png' and ext != '.jpg':
ext = ['.png', '.jpg'][dlg.GetFilterIndex()]
if ext == '.jpg':
im.convert('RGB').save('%s%s'%(name, ext))
else:
im.save('%s%s'%(name, ext))
dlg.Destroy()
if __name__ == '__main__':
app = wx.App()
frame = MainFrame()
frame.Show()
app.MainLoop()
4.2 与PyQt集成
场景类wxgl.qtscene.QtScene是PyQt6.QtOpenGLWidgets.QOpenGLWidget的派生类,因此可以无缝地在PyQt6中使用该类。三维绘图功能封装在wxgl.Scheme中,只需要将一个Scheme类实例传到场景类中即可显示三维绘图结果。
import sys
import os, sys
import numpy as np
from PyQt6.QtWidgets import QApplication, QWidget, QPushButton, QHBoxLayout, QVBoxLayout, QFileDialog
from PyQt6.QtCore import Qt
import wxgl
class MyWindow(QWidget):
"""从QWidget类派生的桌面应用程序窗口类"""
def __init__(self):
"""构造函数"""
super().__init__()
self.setWindowTitle('在PyQt中使用WxGL')
self.setGeometry(0, 0, 1200, 800) # 设置窗位置和大小
self.scene = wxgl.qtscene.QtScene(self, self.draw())
self.visible = True
btn_home = QPushButton('复位')
btn_animate = QPushButton('启动/停止')
btn_visible = QPushButton('隐藏/显示')
btn_save = QPushButton('保存')
vbox = QVBoxLayout()
vbox.addSpacing(40)
vbox.addWidget(btn_home)
vbox.addSpacing(40)
vbox.addWidget(btn_animate)
vbox.addSpacing(40)
vbox.addWidget(btn_visible)
vbox.addSpacing(40)
vbox.addWidget(btn_save)
vbox.addStretch(1)
hbox = QHBoxLayout()
hbox.setSpacing(20)
hbox.setContentsMargins(10,10,20,10)
hbox.addWidget(self.scene, stretch=1)
hbox.addLayout(vbox)
self.setLayout(hbox)
self.show()
btn_home.clicked.connect(self.on_home)
btn_animate.clicked.connect(self.on_animate)
btn_visible.clicked.connect(self.on_visible)
btn_save.clicked.connect(self.on_save)
def closeEvent(self, evt):
self.scene.clear_buffer()
def draw(self):
"""绘制网格球和圆柱的组合体"""
tf = lambda t : ((0, 1, 0, (0.03*t)%360), )
sch = wxgl.Scheme()
sch.sphere((0,0,0), 1, fill=False)
sch.cylinder((-1.2,0,0), (1.2,0,0), 0.3, color='cyan', transform=tf, name='cudgel')
sch.circle((-1.2,0,0), 0.3, vec=(-1,0,0), color='cyan', transform=tf, name='cudgel')
sch.circle((1.2,0,0), 0.3, vec=(1,0,0), color='cyan', transform=tf, name='cudgel')
sch.axes()
return sch
def on_home(self):
"""点击复位按钮"""
self.scene.home()
def on_animate(self):
"""点击启动/停止按钮"""
self.scene.pause()
def on_visible(self):
"""点击隐藏/显示按钮"""
self.visible = not self.visible
self.scene.set_visible('cudgel', self.visible)
def on_save(self):
"""点击保存按钮"""
self.scene.stop_idle()
im = self.scene.get_buffer()
file_type = 'PNG files (*.png);;JPEG file (*.jpg)'
fname, fext = QFileDialog.getSaveFileName(self, '保存文件', directory=os.getcwd(), filter=file_type)
name, ext = os.path.splitext(fname)
if name:
if ext != '.png' and ext != '.jpg':
ext = '.png' if fext == 'PNG files (*.png)' else '.jpg'
if ext == '.jpg':
im.convert('RGB').save('%s%s'%(name, ext))
else:
im.save('%s%s'%(name, ext))
self.scene.start_idle()
if __name__ == '__main__':
app = QApplication(sys.argv)
win = MyWindow()
sys.exit(app.exec())
5 API Reference
5.1 常量
WxGL内置了常用的OpenGL常量。
- wxgl.VERTEX_SHADER
- wxgl.TESS_CONTROL_SHADER
- wxgl.TESS_EVALUATION_SHADER
- wxgl.GEOMETRY_SHADER
- wxgl.FRAGMENT_SHADER
- wxgl.COMPUTE_SHADER
- wxgl.POINTS
- wxgl.LINES
- wxgl.LINE_STRIP
- wxgl.LINE_LOOP
- wxgl.TRIANGLES
- wxgl.TRIANGLE_STRIP
- wxgl.TRIANGLE_FAN
- wxgl.QUADS
- wxgl.QUAD_STRIP
- wxgl.TEXTURE_1D
- wxgl.TEXTURE_1D_ARRAY
- wxgl.TEXTURE_2D
- wxgl.TEXTURE_2D_ARRAY
- wxgl.TEXTURE_3D
- wxgl.TEXTURE_RECTANGLE
- wxgl.TEXTURE_CUBE_MAP
- wxgl.TEXTURE_CUBE_MAP_ARRAY
- wxgl.TEXTURE_BUFFER
- wxgl.NEAREST
- wxgl.LINEAR
- wxgl.NEAREST_MIPMAP_NEAREST
- wxgl.LINEAR_MIPMAP_NEAREST
- wxgl.NEAREST_MIPMAP_LINEAR
- wxgl.LINEAR_MIPMAP_LINEAR
- wxgl.REPEAT
- wxgl.MIRRORED_REPEAT
- wxgl.CLAMP_TO_EDGE
5.2 函数
wxgl.font_list
wxgl.font_list()
返回可用字体列表。
wxgl.color_list
wxgl.color_list()
返回可用颜色列表。
wxgl.cm_list
wxgl.cm_list()
返回颜色映射方案(调色板)列表。
wxgl.cmap
wxgl.cmap(data, cm, drange=None, alpha=None, invalid=np.nan, invalid_c=(0,0,0,0))
数据映射为颜色。
data - 数据
cm - 颜色映射方案(调色板)
drange - 数据动态范围,None表示使用data的动态范围
alpha - 透明度,None表示不改变当前透明度
invalid - 无效数据的标识,默认nan
invalid_c - 无效数据的颜色,默认(0,0,0,0)
wxgl.read_pcfile
wxgl.read_pcfile(pcfile)
读取.ply和.pcd格式的点云文件,返回一个PointCloudData类实例,该实例有以下属性:
- PointCloudData.ok - 数据是否可用,布尔型
- PointCloudData.info - 数据可用性说明,字符串
- PointCloudData.raw - 解读出来的原始数据,字典
- PointCloudData.fields - 数据字段(项)名称,列表
- PointCloudData.xyz - 点的坐标数据,None或者numpy数组(ndarray)
- PointCloudData.rgb - 点的颜色数据,None或者numpy数组(ndarray)
- PointCloudData.intensity - 点的强度数据,None或者numpy数组(ndarray)
5.3 光照情景模式
wxgl.BaseLight
wxgl.BaseLight(ambient=(1.0,1.0,1.0))
基础光照情景模式。
ambient - 环境光颜色,默认(1.0,1.0,1.0)
wxgl.SunLight
wxgl.SunLight(direction=(0.0,0.0,-1.0), lightcolor=(1.0,1.0,1.0), ambient=(0.3,0.3,0.3), **kwds)
太阳光照情景模式。
direction - 太阳光方向
lightcolor - 太阳光颜色
ambient - 环境光颜色
kwds - 关键字参数
diffuse - 漫反射系数:值域范围[0.0, 1.0],数值越大,表面越亮。默认值0.8
specular - 镜面反射系数:值域范围[0.0, 1.0],数值越大,高光越亮。默认值0.6
shiny - 高光系数:值域范围[1, 3000],数值越大,高光区域越小。默认值50
pellucid - 透光系数:值域范围[0.0,1.0],数值越大,背面越亮。默认值0.5
wxgl.LampLight
wxgl.LampLight(lamp=(0.0,0.0,2.0), lightcolor=(1.0,1.0,1.0), ambient=(0.5,0.5,0.5), **kwds)
定位光照情景模式。
lamp - 光源位置
lightcolor - 光源颜色
ambient - 环境光颜色
kwds - 关键字参数
diffuse - 漫反射系数:值域范围[0.0, 1.0],数值越大,表面越亮。默认值0.8
specular - 镜面反射系数:值域范围[0.0, 1.0],数值越大,高光越亮。默认值0.6
shiny - 高光系数:值域范围[1, 3000],数值越大,高光区域越小。默认值50
pellucid - 透光系数:值域范围[0.0,1.0],数值越大,背面越亮。默认值0.5
wxgl.SkyLight
wxgl.SkyLight(direction=(0.0,-1.0,0.0), sky=(1.0,1.0,1.0), ground=(0.3,0.3,0.3))
户外光照情景模式。
direction - 主光方向
sky - 天光颜色
ground - 地光颜色
wxgl.SphereLight
wxgl.SphereLight(style=0, factor=0.8)
球谐光照情景模式。
style - 情景序号,0~9,默认0
factor - 反射衰减因子,值域范围(0.0,1.0],默认0.8
5.4 wxgl.Texture
wxgl.Texture(tsrc, ttype=wxgl.GL_TEXTURE_2D, **kwds)
WxGL纹理类。
tsrc - 图像文件,或图像文件列表,或np.array数组
ttype - 纹理类型,可选项
- wxgl.TEXTURE_1D
- wxgl.TEXTURE_2D(默认)
- wxgl.TEXTURE_2D_ARRAY
- wxgl.TEXTURE_3D
kwds - 关键字参数
level - 纹理分级数,默认1
min_filter - 纹理缩小滤波器,可选项:
- wxgl.GL_NEAREST
- wxgl.GL_LINEAR
- wxgl.GL_NEAREST_MIPMAP_NEAREST(默认)
- wxgl.GL_LINEAR_MIPMAP_NEAREST
- wxgl.GL_NEAREST_MIPMAP_LINEAR
- wxgl.GL_LINEAR_MIPMAP_LINEAR
mag_filter - 纹理放大滤波器,可选项:
- wxgl.GL_NEAREST
- wxgl.GL_LINEAR(默认)
s_tile - S方向纹理铺贴方式,可选项:wxgl.GL_REPEAT(默认)|wxgl.GL_MIRRORED_REPEAT|wxgl.GL_CLAMP_TO_EDGE
t_tile - T方向纹理铺贴方式,可选项:wxgl.GL_REPEAT(默认)|wxgl.GL_MIRRORED_REPEAT|wxgl.GL_CLAMP_TO_EDGE
r_tile - R方向纹理铺贴方式,可选项:wxgl.GL_REPEAT(默认)|wxgl.GL_MIRRORED_REPEAT|wxgl.GL_CLAMP_TO_EDGE
xflip - 左右翻转,默认False
yflip - 上下翻转,默认False
wxgl.Texture.create_texture
wxgl.Texture.create_texture()
创建纹理对象。该方法通常无需用户显式调用。
5.5 wxgl.Model
wxgl.Model(gltype, vshader, fshader, **kwds)
WxGL模型类。
gltype - GL基本图元
vshader - 顶点着色器源码
fshader - 片元着色器源码
kwds - 关键字参数
visible - 模型可见性,默认True
opacity - 模型不透明,默认True
inside - 模型显示在视锥体内,默认True
sprite - 开启点精灵,默认False
alive - 启动渲染计时器,默认False
wxgl.Model.add_shader
wxgl.Model.add_shader(shader_src, shader_type)
添加着色器。
shader_src - 着色器源码
shader_type - 着色器类型
wxgl.Model.add_texture
wxgl.Model.add_texture(var_name, texture)
添加纹理。
var_name - 纹理在着色器中的变量名
texture - wxgl.Texture对象
wxgl.Model.set_ae
wxgl.Model.set_ae(var_name)
设置相机方位角和高度角。
var_name - 相机方位角和高度角在着色器中的变量名
wxgl.Model.set_argument
wxgl.Model.set_argument(var_name, var_value)
设置变量。
var_name - 变量在着色器中的变量名
var_value - 变量值或生成变量值的函数
wxgl.Model.set_cam_pos
wxgl.Model.set_cam_pos(var_name)
设置相机位置。
var_name - 相机位置在着色器中的变量名
wxgl.Model.set_color
wxgl.Model.set_color(var_name, data)
设置顶点颜色。
var_name - 顶点颜色在着色器中的变量名
data - 顶点颜色数据
wxgl.Model.set_cull_mode
wxgl.Model.set_cull_mode(mode)
设置面剔除方式。
mode - 剔除的面:'front'|'back'
wxgl.Model.set_fill_mode
wxgl.Model.set_fill_mode(mode)
设置填充方式。
mode - 填充模式:布尔型,或'FCBC'|'FLBC'|'FCBL'|'FLBL'
wxgl.Model.set_line_style
wxgl.Model.set_line_style(width=None, stipple=None)
设置线宽和线型。
width - 线宽
stipple - 线型,重复因子(整数)和模式(16位二进制)组成的元组
wxgl.Model.set_model_matrix
wxgl.Model.set_model_matrix(var_name, mmatrix=None)
设置模型矩阵。
var_name - 模型矩阵在着色器中的变量名
mmatrix - 模型矩阵或生成模型矩阵的函数,None表示模型无几何变换
wxgl.Model.set_normal
wxgl.Model.set_normal(var_name, data)
设置顶点法向量。
var_name - 顶点法向量在着色器中的变量名
data - 顶点法向量数据
wxgl.Model.set_picked
wxgl.Model.set_picked(var_name)
设置拾取状态。
var_name - 拾取状态在着色器中的变量名
wxgl.Model.set_proj_matrix
wxgl.Model.set_proj_matrix(var_name, pmatrix=None)
设置投影矩阵。
var_name - 投影矩阵在着色器中的变量名
mmatrix - 投影矩阵或生成投影矩阵的函数,None表示使用当前投影矩阵
wxgl.Model.set_psize
wxgl.Model.set_psize(var_name, data)
设置顶点大小。
var_name - 顶点大小在着色器中的变量名
data - 顶点大小数据
wxgl.Model.set_slide
wxgl.Model.set_slide(slide)
设置幻灯片函数。
slide - 以渲染时长(ms)为参数的函数,该函数返回布尔值
wxgl.Model.set_texcoord
wxgl.Model.set_texcoord(var_name, data)
设置顶点纹理坐标。
var_name - 顶点纹理坐标在着色器中的变量名
data - 顶点纹理坐标数据
wxgl.Model.set_text_size
wxgl.Model.set_text_size(var_name, size)
设置2D文本的宽度和高度。
var_name - 变量在着色器中的变量名
size - 2D文本的宽度和高度
wxgl.Model.set_timestamp
wxgl.Model.set_timestamp(var_name)
设置渲染时间戳(以毫秒为单位的浮点数)。
var_name - 渲染时间戳在着色器中的变量名
wxgl.Model.set_vertex
wxgl.Model.set_vertex(var_name, data, indices=None)
设置顶点。
var_name - 顶点在着色器中的变量名
data - 顶点数据
indices - 顶点索引数据
wxgl.Model.set_view_matrix
wxgl.Model.set_view_matrix(var_name, vmatrix=None)
设置视点矩阵。
var_name - 视点矩阵在着色器中的变量名
vmatrix - 视点矩阵或生成视点矩阵的函数,None表示使用当前视点矩阵
wxgl.Model.verify
wxgl.Model.verify()
验证模型数据、检查着色器源码。该方法通常无需用户显式调用。
5.6 wxgl.Scheme
wxgl.Scheme(haxis=‘y’, bg=(0.0,0.0,0.0)
应用于三维场景中的展示方案类。
haxis - 高度轴,默认y轴,可选z轴,不支持x轴
bg - 背景色,默认0.0, 0.0, 0.0)
wxgl.Scheme.axes
wxgl.Scheme.axes(name=None)
绘制三维坐标轴。
name - 部件名
wxgl.Scheme.circle
wxgl.Scheme.circle(center, r, **kwds)
绘制圆面或扇面。
center - 圆心:元组、列表或numpy数组
r - 半径:浮点型
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
arc - 弧度角范围:默认0°~360°
cell - 圆周分片精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.colorbar
wxgl.Scheme.colorbar(data, cm=‘viridis’, ff=str, endpoint=True)
绘制调色板。
data - 值域范围或刻度序列:长度大于1的元组或列表
cm - 调色板名称
kwds - 关键字参数
ff - 刻度标注格式化函数
endpoint - 刻度是否包含值域范围的两个端点值
wxgl.Scheme.cone
wxgl.Scheme.cone(spire, center, r, **kwds)
绘制圆锥。
spire - 锥尖:元组、列表或numpy数组
center - 锥底圆心:元组、列表或numpy数组
r - 锥底半径:浮点型
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
arc - 弧度角范围:默认0°~360°
cell - 圆周分片精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.cruise
wxgl.Scheme.cruise(func)
设置相机巡航函数。
func - 以时间t(毫秒)为参数的函数,返回包含下述key的字典
azim - 方位角:None或表达式
elev - 高度角:None或表达式
dist - 相机到OES坐标系原定的距离:None或表达式
wxgl.Scheme.cube
wxgl.Scheme.cube(center, side, **kwds)
绘制立方体。
center - 中心坐标,元组、列表或numpy数组
side - 棱长:数值或长度为3的元组、列表、numpy数组
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
vec - 立方体上表面法向量
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.cylinder
wxgl.Scheme.cylinder(c1, c2, r, **kwds)
绘制圆柱。
c1 - 圆柱端面圆心:元组、列表或numpy数组
c2 - 圆柱端面圆心:元组、列表或numpy数组
r - 圆柱半径:浮点型
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
arc - 弧度角范围:默认0°~360°
cell - 圆周分片精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.grid
wxgl.Scheme.grid(**kwds)
绘制网格和刻度。
kwds - 关键字参数
size - 文本字号,默认32
xlabel - x轴名称
ylabel - y轴名称
zlabel - z轴名称
xf - x轴标注格式化函数
yf - y轴标注格式化函数
zf - z轴标注格式化函数
name - 部件名
wxgl.Scheme.isosurface
wxgl.Scheme.isosurface(data, level, **kwds)
绘制基于MarchingCube算法的三维等值面。
data - 数据集:三维numpy数组
level - 阈值:浮点型
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
xr - 数据集对应的点的x轴的动态范围
yr - 数据集对应的点的y轴的动态范围
zr - 数据集对应的点的z轴的动态范围
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.line
wxgl.Scheme.line(vs, **kwds)
连点成线。
vs - 顶点集:元组、列表或numpy数组,shape=(n,2|3)
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
data - 数据集:元组、列表或numpy数组,shape=(n,)
cm - 调色板
width - 线宽:0.0~10.0之间,None使用默认设置
stipple - 线型
'solid' - 实线(默认)
'dashed' - 虚线
'doted' - 点线
'dash-dot' - 点虚线
loop - 首尾闭合,默认False
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列,默认None
ambient - 环境光,默认(1.0,1.0,1.0)
name - 模型或部件名
wxgl.Scheme.lines
wxgl.Scheme.lines(vs, **kwds)
绘制多条线段。
vs - 顶点集:元组、列表或numpy数组,shape=(n,2|3)
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
data - 数据集:元组、列表或numpy数组,shape=(n,)
cm - 调色板
width - 线宽:0.0~10.0之间,None使用默认设置
stipple - 线型
'solid' - 实线(默认)
'dashed' - 虚线
'doted' - 点线
'dash-dot' - 点虚线
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列,默认None
ambient - 环境光,默认(1.0,1.0,1.0)
name - 模型或部件名
wxgl.Scheme.mesh
wxgl.Scheme.mesh(xs, ys, zs, **kwds)
绘制网格面。
xs/ys/zs - 顶点坐标集:元组、列表或numpy数组,shape=(m,n),m为网格行数,n为网格列数
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
data - 数据集:元组、列表或numpy数组,shape=(m,n)
cm - 调色板
texture - 纹理图片,或2D纹理对象
quad - 使用四角图元绘制:布尔型,默认False(使用三角图元绘制)
ccw - 顶点逆时针排序的面为正面,默认True
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.model
wxgl.Scheme.model(m, name=None)
添加模型。
m - wxgl.Model类的实例
name - 模型或部件名
wxgl.Scheme.pipe
wxgl.Scheme.pipe(vs, r, **kwds)
绘制圆管。
vs - 圆管中心线顶点集:元组、列表或numpy数组,shape=(n,3)
r - 圆管半径:浮点型
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
data - 数据集:元组、列表或numpy数组,shape=(n,)
cm - 调色板
cell - 圆周分片精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.pointcloud
wxgl.Scheme.pointcloud(pcfile, cm=‘viridis’, size=1)
读点云文件并绘制模型。
pcfile - 点云文件,支持ply、pcd等格式
cm - 调色板。若文件无颜色数据但包含强度数据,则使用调色板将强度映射为颜色
size - 点的大小
wxgl.Scheme.scatter
wxgl.Scheme.scatter(vs, **kwds)
绘制散列点。
vs - 顶点集:元组、列表或numpy数组,shape=(n,2|3)
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
size - 点的大小:数值或数值型元组、列表或numpy数组
data - 数据集:元组、列表或numpy数组,shape=(n,)
cm - 调色板
texture - 纹理图片,或2D纹理对象
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列,默认None
ambient - 环境光,默认(1.0,1.0,1.0)
name - 模型或部件名
wxgl.Scheme.sphere
wxgl.Scheme.sphere(center, r, **kwds)
绘制由经纬度网格生成的球。
center - 锥底圆心坐标:元组、列表或numpy数组
r - 锥底半径:浮点型
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
vec - 指向北极的向量
uarc - u方向范围:默认0°~360°
varc - v方向范围:默认-90°~90°
cell - 网格精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.surface
wxgl.Scheme.surface(vs, **kwds)
绘制由三角面(默认)或四角面构成的曲面。
vs - 顶点集:元组、列表或numpy数组,shape=(n,2|3)
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
data - 数据集:元组、列表或numpy数组,shape=(n,)
cm - 调色板
texture - 纹理图片,或2D/2DArray/3D纹理对象
texcoord - 纹理坐标集:元组、列表或numpy数组,shape=(n,2|3)
quad - 使用四角图元绘制:布尔型,默认False(使用三角图元绘制)
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认True(不透明)
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.text
wxgl.Scheme.text(text, pos, **kwds)
绘制2D文字。
text - 文本字符串
pos - 文本位置:元组、列表或numpy数组,shape=(2|3,)
kwds - 关键字参数
color - 文本颜色:浮预定义颜色、十六进制颜色,或者点型元组、列表或numpy数组,None表示背景色的对比色
size - 字号:整型,默认32
align - 水平对齐方式:'left'-左对齐(默认),'center'-水平居中,'right'-右对齐
valign - 垂直对齐方式:'bottom'-底部对齐(默认),'middle'-垂直居中,'top'-顶部对齐
family - 字体:None表示当前默认的字体
weight - 字体的浓淡:'normal'-正常(默认),'light'-轻,'bold'-重
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
slide - 幻灯片函数,默认None
ambient - 环境光,默认(1.0,1.0,1.0)
name - 模型或部件名
wxgl.Scheme.text3d
wxgl.Scheme.text3d(text, box, **kwds)
绘制3D文字。
text - 文本字符串
box - 文本显示区域:左上、左下、右下、右上4个点的坐标,浮点型元组、列表或numpy数组,shape=(4,2|3)
kwds - 关键字参数
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
bg - 背景色,None表示背景透明
align - 对齐方式:'left'-左对齐(默认),'center'-水平居中,'right'-右对齐,'fill'-填充
family - 字体:None表示当前默认的字体
weight - 字体的浓淡:'normal'-正常(默认),'light'-轻,'bold'-重
size - 字号:整型,默认64。此参数影响文本显示质量,不改变文本大小
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列,默认None
light - 光照模型(默认基础光照模型)
name - 模型或部件名
wxgl.Scheme.title
wxgl.Scheme.title(title, size=32, color=None, family=None, weight=‘normal’)
设置标题。
title - 标题文本
size - 字号:整型,默认32
color - 颜色或颜色集:预定义颜色、十六进制颜色,或者浮点型元组、列表或numpy数组,值域范围[0,1]
family - 字体:None表示当前默认的字体
weight - 字体的浓淡:'normal'-正常(默认),'light'-轻,'bold'-重
wxgl.Scheme.torus
wxgl.Scheme.torus(center, r1, r2, **kwds)
绘制球环。
center - 球环中心坐标:元组、列表或numpy数组
r1 - 球半径:浮点型
r2 - 环半径:浮点型
kwds - 关键字参数
color - 颜色:浮点型元组、列表或numpy数组
vec - 环面法向量
uarc - u方向范围:默认0°~360°
varc - v方向范围:默认0°~360°
cell - 圆周分片精度:默认5°
visible - 是否可见,默认True
inside - 模型顶点是否影响模型空间,默认True
opacity - 模型不透明属性,默认不透明
cull - 面剔除,可选项:'front', 'back', None(默认,表示使用当前设置)
fill - 填充,可选项:True, False, None(默认,表示使用当前设置)
slide - 幻灯片函数,默认None
transform - 由旋转、平移和缩放组成的模型几何变换序列
light - 光照模型(默认户外光照模型)
name - 模型或部件名
wxgl.Scheme.xrange
wxgl.Scheme.xrange(range_tuple)
设置x轴范围。
range_tuple - x轴最小值和最大值组成的元祖
wxgl.Scheme.yrange
wxgl.Scheme.yrange(range_tuple)
设置y轴范围。
range_tuple - y轴最小值和最大值组成的元祖
wxgl.Scheme.zrange
wxgl.Scheme.zrange(range_tuple)
设置z轴范围。
range_tuple - z轴最小值和最大值组成的元祖
5.7 wxgl.App
wxgl.App(backend=‘auto’, **kwds)
三维数据快速可视化类,由wxgl.Scheme派生而来。
backend - 后端GUI库,可选wx或qt,默认auto(按照wx/qt优先级自动选择)
kwds - 关键字参数
size - 窗口分辨率,默认(960, 640)
bg - 画布背景色,默认(0.0, 0.0, 0.0)
haxis - 高度轴,默认y轴,可选z轴,不支持x轴
fovy - 相机水平视野角度,默认50°
azim - 方位角,默认0°
elev - 高度角,默认0°
azim_range - 方位角变化范围,默认-180°~180°
elev_range - 高度角变化范围,默认-180°~180°
smooth - 直线和点的反走样,默认True
wxgl.App.info
wxgl.App.info(time_func=None, cam_func=None)
设置时间信息格式化函数和相机位置信息格式化函数,开启在界面状态栏显示信息功能。
time_func - 以时间t(毫秒)为参数的时间信息格式化函数,返回字符串
cam_func - 以方位角、仰角和距离为参数的相机位置信息格式化函数,返回字符串
wxgl.App.save_fig
wxgl.App.save_fig(outfile, dpi=None, fps=25, frames=100, loop=0, quality=100)
保存画布为图像文件或动画文件。
outfile - 输出文件名,支持的文件格式:'.png', '.jpg', '.jpeg', '.gif', '.webp', '.mp4', '.avi', '.wmv', '.mov'
dpi - 图像文件每英寸像素数
fps - 动画文件帧率
frames - 动画文件总帧数
loop - gif文件播放次数,0表示循环播放
quality - webp文件质量,100表示最高品质
wxgl.App.show
wxgl.App.show()
显示画布。
5.8 wxgl.wxscene.WxScene
wxgl.wxscene.WxScene(parent, scheme, **kwds)
场景类,继承自wx.glcanvas.GLCanvas类。
parent - 父级窗口对象
scheme - wxgl.Scheme类实例
kwds - 关键字参数
size - 窗口分辨率,默认(960, 640)
bg - 画布背景色,默认(0.0, 0.0, 0.0)
haxis - 高度轴,默认y轴,可选z轴,不支持x轴
fovy - 相机水平视野角度,默认50°
azim - 方位角,默认0°
elev - 高度角,默认0°
azim_range - 方位角变化范围,默认-180°~180°
elev_range - 高度角变化范围,默认-180°~180°
smooth - 直线和点的反走样,默认True
wxgl.wxscene.WxScene.capture
wxgl.wxscene.WxScene.capture(mode=‘RGBA’, crop=False, buffer=‘front’)
捕捉缓冲区数据,保存到名为im_pil的类属性变量中。
mode - 'RGB'或'RGBA'
crop - 是否将宽高裁切为16的倍数
buffer - 'front'(前缓冲区)或'back'(后缓冲区)
wxgl.wxscene.WxScene.get_buffer
wxgl.wxscene.WxScene.get_buffer(mode=‘RGBA’, crop=False, buffer=‘front’)
以PIL对象的格式返回场景缓冲区数据。
mode - 'RGB'或'RGBA'
crop - 是否将宽高裁切为16的倍数
buffer - 'front'(前缓冲区)或'back'(后缓冲区)
wxgl.wxscene.WxScene.home
wxgl.wxscene.WxScene.home()
恢复初始位置和姿态。
wxgl.wxscene.WxScene.pause
wxgl.wxscene.WxScene.pause()
动画启停。
wxgl.wxscene.WxScene.set_visible
wxgl.wxscene.WxScene.set_visible(name, visible)
设置部件或模型的可见性。
name - 部件名或模型id
visible - bool型
5.9 wxgl.qtscene.QtScene
wxgl.qtscene.QtScene(parent, scheme, **kwds)
场景类,继承自PyQt6.QtOpenGLWidgets.QOpenGLWidget类。
parent - 父级窗口对象
scheme - wxgl.Scheme类实例
kwds - 关键字参数
size - 窗口分辨率,默认(960, 640)
bg - 画布背景色,默认(0.0, 0.0, 0.0)
haxis - 高度轴,默认y轴,可选z轴,不支持x轴
fovy - 相机水平视野角度,默认50°
azim - 方位角,默认0°
elev - 高度角,默认0°
azim_range - 方位角变化范围,默认-180°~180°
elev_range - 高度角变化范围,默认-180°~180°
smooth - 直线和点的反走样,默认True
wxgl.qtscene.QtScene.capture
wxgl.qtscene.QtScene.capture(mode=‘RGBA’, crop=False, buffer=‘front’)
捕捉缓冲区数据,保存到名为im_pil的类属性变量中。
mode - 'RGB'或'RGBA'
crop - 是否将宽高裁切为16的倍数
buffer - 'front'(前缓冲区)或'back'(后缓冲区)
wxgl.qtscene.QtScene.get_buffer
wxgl.qtscene.QtScene.get_buffer(mode=‘RGBA’, crop=False, buffer=‘front’)
以PIL对象的格式返回场景缓冲区数据。
mode - 'RGB'或'RGBA'
crop - 是否将宽高裁切为16的倍数
buffer - 'front'(前缓冲区)或'back'(后缓冲区)
wxgl.qtscene.QtScene.home
wxgl.qtscene.QtScene.home()
恢复初始位置和姿态。
wxgl.qtscene.QtScene.pause
wxgl.qtscene.QtScene.pause()
动画启停。
wxgl.qtscene.QtScene.set_visible
wxgl.qtscene.QtScene.set_visible(name, visible)
设置部件或模型的可见性。
name - 部件名或模型id
visible - bool型
wxgl.qtscene.QtScene.clear_buffer
wxgl.qtscene.QtScene.clear_buffer()文章来源:https://www.toymoban.com/news/detail-815522.html
删除纹理、顶点缓冲区等对象。Qt应用程序窗口关闭前,需要在槽函数closeEvent中显式地调用该方法。文章来源地址https://www.toymoban.com/news/detail-815522.html
到了这里,关于十分钟玩转3D绘图:WxGL完全手册的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!