Documentation inconsistency for RegionView3D.view_matrix #77926

New Issue

Christopher Gearhart · 2020-06-16T19:21:16+02:00

2020-06-16 19:21:16 +02:00

Blender Version
Broken: 2.83

Short description of error

The documentation claims that the RegionView3D.view_matrix expects a sequence of 16 float values, but when a sequence of 16 float values are passed, an error is thrown.

Exact steps for others to reproduce the error

Open the default startup file
Run the following code in the Python console:

view_area = next(a for a in C.screen.areas if a.type == "VIEW_3D")
rv3d = view_area.spaces[0].region_3d
rv3d.view_matrix = (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)

You'll see a TypeError is thrown. To get around this, you would need to pass a 2D sequence of floats, contrary to the documentation:

rv3d.view_matrix = (
  (0.0, 0.0, 0.0, 0.0),
  (0.0, 0.0, 0.0, 0.0),
  (0.0, 0.0, 0.0, 0.0),
  (0.0, 0.0, 0.0, 0.0)
)

**Blender Version** Broken: 2.83 **Short description of error** The documentation claims that the [RegionView3D.view_matrix ](https://docs.blender.org/api/blender_python_api_current/bpy.types.RegionView3D.html#bpy.types.RegionView3D.view_matrix) expects a sequence of 16 float values, but when a sequence of 16 float values are passed, an error is thrown. **Exact steps for others to reproduce the error** 1. Open the default startup file 2. Run the following code in the Python console: ``` view_area = next(a for a in C.screen.areas if a.type == "VIEW_3D") rv3d = view_area.spaces[0].region_3d rv3d.view_matrix = (0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0) ``` 3. You'll see a TypeError is thrown. To get around this, you would need to pass a 2D sequence of floats, contrary to the documentation: ``` rv3d.view_matrix = ( (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0), (0.0, 0.0, 0.0, 0.0) ) ```

Christopher Gearhart commented

2020-06-16 19:21:16 +02:00

Added subscriber: @bblanimation

Aaron Carlisle commented

2020-06-16 19:45:58 +02:00

Added subscriber: @Blendify

Aaron Carlisle commented

2020-06-16 19:45:58 +02:00

Changed status from 'Needs Triage' to: 'Resolved'

Aaron Carlisle closed this issue

2020-06-16 19:45:58 +02:00

Aaron Carlisle self-assigned this 2020-06-16 19:45:58 +02:00

Aaron Carlisle commented

2020-06-16 19:45:58 +02:00

You are looking at old documentation see https://docs.blender.org/api/current/bpy.types.RegionView3D.html#bpy.types.RegionView3D.view_matrix

Robert Guetzkow commented

2020-06-16 19:47:48 +02:00

Added subscriber: @rjg

Robert Guetzkow commented

2020-06-16 19:47:48 +02:00

Changed status from 'Resolved' to: 'Archived'

Robert Guetzkow commented

2020-06-16 19:47:48 +02:00

You have linked the API docs of Blender 2.78, it is properly documented in the current API docs for 2.83 .

You have linked the API docs of Blender 2.78, it is properly documented in the [current API docs for 2.83 ](https://docs.blender.org/api/current/bpy.types.RegionView3D.html#bpy.types.RegionView3D.view_matrix).

Robert Guetzkow commented

2020-06-16 19:49:27 +02:00

Changed status from 'Archived' to: 'Resolved'

Christopher Gearhart commented

2020-06-16 20:37:59 +02:00

Ah, you're right! Pesky Google search results showing random Blender doc versions...

Sign in to join this conversation.

No Label

Download

What's New

Blender Studio

Manual

Developers Blog

Documentation

Benchmark

Blender Conference

Development Fund

One-time Donations

Documentation inconsistency for RegionView3D.view_matrix #77926