With the Blender Python API we can manage not only scene objects, but also the view from the 3D viewport area, The viewport has a matrix with which the viewport can be moved to the desired position.
.blend file on Patreon
To manage the viewport, we first need to get its area.
Let’s loop through all open areas until we find the viewport:
|
1 2 |
for area in bpy.context.screen.areas: if area.type == 'VIEW_3D': |
We can interact with the viewport matrix through its 3d region. We can access the 3d region of the viewport, having its area, as follows:
|
1 |
region = area.spaces[0].region_3d |
We can get the viewport matrix from the region through its view_matrix property
|
1 2 3 4 5 6 |
print(region.view_matrix) #<Matrix 4x4 ( 0.6794, 0.7337, 0.0000, 0.2145) # (-0.2413, 0.2234, 0.9444, 0.0000) # ( 0.6929, -0.6416, 0.3289, 21.5210) # ( 0.0000, 0.0000, 0.0000, 1.0000)> |
To save the viewport position and view, we need to save this matrix:
|
1 |
stored_view = region.view_matrix.copy() |
Through this view_matrix property, we can set a new position for the viewport by assigning it a matrix with the desired values.
For example, to set a 3D viewport to the front view, we need to assign the following matrix to the view_matrix property:
|
1 2 3 4 5 6 |
region.view_matrix = Matrix(( ( 1.0000, -0.0000, 0.0000, 0.0000), ( 0.0000, -0.0000, 1.0000, 0.0000), (-0.0000, -1.0000, -0.0000, -0.0000), ( 0.0000, 0.0000, 0.0000, 1.0000) )) |
And in order to return the viewport to its original position, assign the previously saved value to the view_matrix property.
|
1 |
region.view_matrix = stored_view |