跳转至

tkintertools.tools_3d#

约 1635 个字 260 行代码 预计阅读时间 28 分钟

文件描述: 3D support
外部引用: array, constants, exceptions, main, math, statistics, tkinter, typing
源码位置: tkintertoolstools_3d.py

Functions - 函数#

01. project#

project Function

project(
    coordinate,
    distance
)

将一个三维空间中的点投影到指定距离的正向平面上，并返回在该平面上的坐标

  • coordinate: 点的空间坐标
  • distance: 正向平面的距离（平面正对着我们）

02. rotate#

rotate Function

rotate(
    coordinate,
    dx=0,
    dy=0,
    dz=0,
    *,
    center,
    axis=None
)

将一个三维空间中的点以一个点或线为参照进行旋转（实现方式为欧拉角）

  • coordinate: 点的空间坐标
  • dx: x 方向逆时针旋转弧度，或者绕旋转轴线的旋转弧度
  • dy: y 方向逆时针旋转弧度
  • dz: z 方向逆时针旋转弧度
  • center: 旋转中心的空间坐标
  • axis: 旋转轴线的空间坐标

03. scale#

scale Function

scale(
    coordinate,
    kx=1,
    ky=1,
    kz=1,
    *,
    center
)

将一个三维空间中的点以另一个点为缩放中心进行缩放

  • coordinate: 点的空间坐标
  • kx: x 方向缩放比例
  • ky: y 方向缩放比例
  • kz: z 方向缩放比例
  • center: 缩放中心的空间坐标

04. translate#

translate Function

translate(
    coordinate,
    dx=0,
    dy=0,
    dz=0
)

将一个三维空间中的点进行平移

  • coordinate: 点的空间坐标
  • dx: x 方向位移长度
  • dy: y 方向位移长度
  • dz: z 方向位移长度

Classes - 类#

01. Canvas3D#

Canvas3D(Canvas) Class

3D 画布基类

__init__ Method Special

__init__(
    self,
    master,
    width,
    height,
    x=None,
    y=None,
    *,
    lock=True,
    expand=True,
    keep=True,
    camera_distance=1000,
    **kw
)
  • master: 父控件
  • width: 画布宽度
  • height: 画布高度
  • x: 画布左上角的横坐标
  • y: 画布左上角的纵坐标
  • lock: 画布内控件的功能锁，为 False 时功能暂时失效
  • expand: 画布内控件是否能缩放
  • keep: 画布比例是否保持不变
  • camera_distance: 相机位置与原点间的距离，默认值为 1000
  • **kw: 与 tkinter.Canvas 类的参数相同

geos Method

geos(
    self
)

返回 Canvas3D 类全部的几何体对象

items_3d Method

items_3d(
    self
)

返回 Canvas3D 类全部的基本 3D 对象

space_sort Method

space_sort(
    self
)

空间位置排序

02. Cuboid#

Cuboid(Geometry) Class

长方体

__init__ Method Special

__init__(
    self,
    canvas,
    x,
    y,
    z,
    length,
    width,
    height,
    *,
    boardwidth=1,
    color_fill_up='',
    color_fill_down='',
    color_fill_left='',
    color_fill_right='',
    color_fill_front='',
    color_fill_back='',
    color_outline_up='#000000',
    color_outline_down='#000000',
    color_outline_left='#000000',
    color_outline_right='#000000',
    color_outline_front='#000000',
    color_outline_back='#000000'
)
  • canvas: 父画布
  • x: 左上角 x 坐标
  • y: 左上角 y 坐标
  • z: 左上角 z 坐标
  • length: 长度
  • width: 宽度
  • height: 高度
  • boardwidth: 边框线条宽度
  • color_fill_up: 上表面内部颜色
  • color_fill_down: 下表面内部颜色
  • color_fill_left: 左侧面内部颜色
  • color_fill_right: 右侧面内部颜色
  • color_fill_front: 正面内部颜色
  • color_fill_back: 后面内部颜色
  • color_outline_up: 上表面边框颜色
  • color_outline_down: 下表面边框颜色
  • color_outline_left: 左侧面边框颜色
  • color_outline_right: 右侧面边框颜色
  • color_outline_front: 正面边框颜色
  • color_outline_back: 后面边框颜色

03. Geometry#

Geometry Class

几何体

__init__ Method Special

__init__(
    self,
    canvas,
    *sides
)
  • canvas: 父画布
  • sides: 组成几何体的面

append Method

append(
    self,
    *sides
)

给几何体添加更多新的面

  • sides: Side 类

center Method

center(
    self
)

几何中心

rotate Method

rotate(
    self,
    dx=0,
    dy=0,
    dz=0,
    *,
    center=(0, 0, 0),
    axis=None
)

旋转几何体中的所有 3D 对象

  • dx: x 方向逆时针旋转弧度，或者绕旋转轴线的旋转弧度
  • dy: y 方向逆时针旋转弧度
  • dz: z 方向逆时针旋转弧度
  • center: 旋转中心，默认为原点
  • axis: 旋转轴线，无默认值

scale Method

scale(
    self,
    kx=1,
    ky=1,
    kz=1,
    *,
    center=None
)

缩放几何体中的所有 3D 对象

  • kx: x 方向缩放比例
  • ky: y 方向缩放比例
  • kz: z 方向缩放比例
  • center: 缩放中心，默认为几何中心

translate Method

translate(
    self,
    dx=0,
    dy=0,
    dz=0
)

平移几何体中的所有 3D 对象

  • dx: x 方向位移长度
  • dy: y 方向位移长度
  • dz: z 方向位移长度

update Method

update(
    self
)

更新几何体

04. Line#

Line(_Object3D) Class

线

__init__ Method Special

__init__(
    self,
    canvas,
    point_start,
    point_end,
    *,
    width=1,
    fill='#000000'
)
  • canvas: 父画布
  • point_start: 起点坐标
  • point_end: 终点坐标
  • width: 线的宽度
  • fill: 线的颜色

_camera_distance Method Internal

_camera_distance(
    self
)

与相机距离

update Method

update(
    self
)

更新对象的显示

05. Point#

Point(_Object3D) Class

点

__init__ Method Special

__init__(
    self,
    canvas,
    coords,
    *,
    size=1,
    width=1,
    fill='#000000',
    outline='#000000',
    markuptext='',
    markupdelta=(0, 0),
    markupfont=('Microsoft YaHei', -24),
    markupfill='#000000',
    markupjustify='center'
)
  • canvas: 父画布
  • coords: 点的空间坐标
  • size: 点的大小
  • width: 点轮廓的宽度
  • fill: 点内部的填充颜色
  • outline: 点轮廓的颜色
  • markuptext: 标记文本
  • markupdelta: 标记文本显示位置的偏移量
  • markupfont: 标记文本字体
  • markupfill: 标记文本颜色
  • markupjustify: 标记文本多行对齐方式

_camera_distance Method Internal

_camera_distance(
    self
)

与相机距离

update Method

update(
    self
)

更新对象的显示

06. Side#

Side(_Object3D) Class

面

__init__ Method Special

__init__(
    self,
    canvas,
    *points,
    width=1,
    fill='',
    outline='#000000'
)
  • canvas: 父画布
  • points: 各点的空间坐标
  • width: 面轮廓的宽度
  • fill: 面内部的填充颜色
  • outline: 面轮廓的颜色

_camera_distance Method Internal

_camera_distance(
    self
)

与相机距离

update Method

update(
    self
)

更新对象的显示

07. Space#

Space(Canvas3D) Class

三维空间

__init__ Method Special

__init__(
    self,
    master,
    width,
    height,
    x=None,
    y=None,
    *,
    lock=True,
    expand=True,
    keep=True,
    camera_distance=1000,
    origin_size=1,
    origin_width=1,
    origin_fill='',
    origin_outline='',
    **kw
)
  • master: 父控件
  • width: 画布宽度
  • height: 画布高度
  • x: 画布左上角的横坐标
  • y: 画布左上角的纵坐标
  • lock: 画布内控件的功能锁，为 False 时功能暂时失效
  • expand: 画布内控件是否能缩放
  • keep: 画布比例是否保持不变
  • camera_distance: 相机位置与原点间的距离，默认值为 1000
  • origin_size: 原点大小，默认值为 1
  • origin_width: 原点轮廓宽度，默认值为 1
  • origin_fill: 原点填充颜色，默认为无色
  • origin_outline: 原点轮廓颜色，默认为无色
  • **kw: 与 tkinter.Canvas 类的参数相同

_rotate Method Internal

_rotate(
    self,
    event,
    flag=None,
    _cache=[]
)

旋转事件

_scale Method Internal

_scale(
    self,
    event,
    flag=None
)

缩放事件

_translate Method Internal

_translate(
    self,
    event,
    flag=None,
    _cache=[]
)

平移事件

08. Tetrahedron#

Tetrahedron(Geometry) Class

四面体

__init__ Method Special

__init__(
    self,
    canvas,
    point_1,
    point_2,
    point_3,
    point_4,
    *,
    boardwidth=1,
    color_fill=('', '', '', ''),
    color_outline=('#000000', '#000000', '#000000', '#000000')
)
  • canvas: 父画布
  • point_1: 第一个顶点
  • point_2: 第二个顶点
  • point_3: 第三个顶点
  • point_4: 第四个顶点
  • boardwidth: 边框线条宽度
  • color_fill: 内部颜色序列
  • color_outline: 边框颜色序列

09. Text3D#

Text3D(_Object3D) Class

三维文本

__init__ Method Special

__init__(
    self,
    canvas,
    coords,
    text='',
    *,
    font=('Microsoft YaHei', -24),
    justify='center',
    fill='#000000'
)
  • canvas: 父画布
  • coords: 点的空间坐标
  • text: 显示的文本
  • size: 点的大小
  • font: 点轮廓的宽度
  • justify: 多行文本对齐方式
  • fill: 点内部的填充颜色

_camera_distance Method Internal

_camera_distance(
    self
)

与相机距离

update Method

update(
    self
)

更新对象的显示

10. _Object3D#

_Object3D Class Internal

3D 对象基类

__init__ Method Special

__init__(
    self,
    *coordinates
)

_project Method Internal

_project(
    self,
    distance,
    canvas=None
)

投影对象自身

  • distance: 对象与观察者的距离
  • canvas: 投影到的画布

center Method

center(
    self
)

几何中心

rotate Method

rotate(
    self,
    dx=0,
    dy=0,
    dz=0,
    *,
    center=(0, 0, 0),
    axis=None
)

旋转对象本身

  • dx: x 方向逆时针旋转弧度，或者绕旋转轴线的旋转弧度
  • dy: y 方向逆时针旋转弧度
  • dz: z 方向逆时针旋转弧度
  • center: 旋转中心，默认为原点
  • axis: 旋转轴线，无默认值

scale Method

scale(
    self,
    kx=1,
    ky=1,
    kz=1,
    *,
    center=None
)

缩放对象本身

  • kx: x 方向缩放比例
  • ky: y 方向缩放比例
  • kz: z 方向缩放比例
  • center: 缩放中心，默认为几何中心

translate Method

translate(
    self,
    dx=0,
    dy=0,
    dz=0
)

平移对象本身

  • dx: x 方向位移长度
  • dy: y 方向位移长度
  • dz: z 方向位移长度