ilusha/blender
1
0
Fork 0
mirror of https://github.com/blender/blender synced 2026-09-29 04:37:17 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions

PyDoc: number all examples to avoid conflicts when type checking

Browse source 
Examples were supported with/without number suffix,
this caused problems using mypy for type checking because it attempted
to resolve imports such as `mathutils` to the example file.

Having only some examples numbered already complicated documentation
for conventions with examples - simplify extraction and number all.
This commit is contained in:
Campbell Barton 2026-02-12 00:51:02 +00:00
parent 084333edb0
commit 0640836baa
44 changed files with 9 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

35
doc/python_api/examples/mathutils.Euler.py
View file

@ -1,35 +0,0 @@
import mathutils
import math
# Create a new euler with default axis rotation order.
eul = mathutils.Euler((0.0, math.radians(45.0), 0.0), 'XYZ')
# Rotate the euler.
eul.rotate_axis('Z', math.radians(10.0))
# You can access its components by attribute or index.
print("Euler X", eul.x)
print("Euler Y", eul[1])
print("Euler Z", eul[-1])
# Components of an existing euler can be set.
eul[:] = 1.0, 2.0, 3.0
# Components of an existing euler can use slice notation to get a tuple.
print("Values: {:f}, {:f}, {:f}".format(*eul))
# The order can be set at any time too.
eul.order = 'ZYX'
# Eulers can be used to rotate vectors.
vec = mathutils.Vector((0.0, 0.0, 1.0))
vec.rotate(eul)
# Often its useful to convert the euler into a matrix so it can be used as
# transformations with more flexibility.
mat_rot = eul.to_matrix()
mat_loc = mathutils.Matrix.Translation((2.0, 3.0, 4.0))
mat = mat_loc @ mat_rot.to_4x4()
# Direct buffer access is supported.
print(memoryview(eul).tobytes())