blender/blender-manual
23
23
Fork 104
Code Issues 74 Pull Requests 6 Projects 1 Releases Wiki Activity

Driver Variables: document camera.location vs camera.matrix_world. #104513

Merged
Alexander Gavrilov merged 1 commits from angavrilov/blender-manual:pr-camera-matrix into blender-v3.6-release 2023-07-17 17:28:51 +02:00
Conversation 0 Commits 1 Files Changed 1 +15 -4
1 changed files with 15 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
manual/animation/drivers/drivers_panel.rst
View File

@ -138,8 +138,8 @@ Variable Type
The ID of the ID-block type. For example: "Material.001". The ID of the ID-block type. For example: "Material.001".
RNA Path RNA Path
The RNA name of the property, based on a subset of Python attribute access syntax. The RNA name of the property, based on a subset of Python attribute access syntax.
For example: ``location.x`` or ``location[0]`` for the raw X location value, or For example: ``location.x`` or ``location[0]`` for the X location animation channel
``["prop_name"]`` for a custom property. value (before parenting or constraints), or ``["prop_name"]`` for a custom property.
.. tip:: .. tip::
@ -185,8 +185,19 @@ Variable Type
RNA Path RNA Path
The RNA name of the property, based on a subset of Python attribute access syntax. The RNA name of the property, based on a subset of Python attribute access syntax.
For example: ``location.x`` or ``location[0]`` for the raw X location value, or For example: ``camera.location.x`` or ``camera.location[0]`` for the camera X location animation
``["prop_name"]`` for a custom property. channel value (before parenting or constraints), or ``["prop_name"]`` for a custom property.
.. tip::
Although the values of the x/y/z animation channels for the camera location can be accessed
via ``camera.location[0/1/2]``, retrieving its world space location and orientation after parenting
and constraints currently requires using ``camera.matrix_world``. This property can be understood
easily by viewing the matrix as an array of four vectors in *World* space:
* ``matrix_world[0][0/1/2]`` is the *Screen Right* direction vector (camera local X).
* ``matrix_world[1][0/1/2]`` is the *Screen Up* direction vector (camera local Y).
* ``matrix_world[2][0/1/2]`` is the **opposite** of the direction the camera is pointing.
* ``matrix_world[3][0/1/2]`` is the *location* of the camera.
Value Value
Shows the value of the variable. Shows the value of the variable.