Drivers: Introduce the Context Properties The goal: allow accessing context dependent data, such as active scene camera without linking to a specific scene data-block. This is useful in cases when, for example, geometry node setup needs to be aware of the camera position. A possible work-around without changes like this is to have some scene evaluation hook which will update driver variables for the currently evaluating scene. But this raises an issue of linking: it is undesirable that the asset scene is linked to the shot file. Surely, it is possible to have post-evaluation handler to clear the variables, but it all starts to be quite messy. Not to mention possible threading conflicts. Another possibility of introducing a way to achieve the goal is to make it so the dependency graph somehow parses the python expression where artists can (and already are trying to) type something like: depsgraph.scene.camera.matrix_world.col[3][0] But this is not only tricky to implement properly and reliably, it hits two limitations: - Currently dependency graph can only easily resolve dependencies to a RNA property. - Some properties access which are valid in Python are not considered valid RNA properties by the existing property resolution functions: `camera.matrix_world[3][0]` is a valid RNA property, but `camera.matrix_world.col[3][0]` is not. Using driver variables allows to have visual feedback when the path resolution fails, and there is no way to visualize errors in the python expression itself. This change introduces the new variable type: Context Property. Using this variable type makes allows to choose between Active Scene and Active View Layer. These scene and view layer are resolved during the driver evaluation time, based on the current dependency graph. This allows to create a driver variable in the following configuration: - Type: Context Property - Context Property: Active Scene - Path: camera.matrix_world[3][0] The naming is a bit confusing. Tried my best to keep it clear keeping two aspects in mind: using UI naming when possible, and follow the existing naming. A lot of the changes are related on making it so the required data is available from the variable evaluation functions. It wasn't really clear what the data would be, and the scope of the changes, so it is done together with the functional changes. It seems that there is some variable evaluation logic duplicated in the `bpy_rna_driver.c`. This change does not change it. It is not really clear why this separate code path with much more limited scope of supported target types is even needed. There is also a possible change in the behavior of the dependency graph: it is now using ID of the resolved path when building driver variables. It used to use the variable ID. In common cases they match, but when going into nested data-blocks it is actually correct to use relation to the resolved ID. Not sure if there was some code to ensure that, which now can be resolved. Also not sure whether it is still needed to ensure the ID specified in the driver target is build as well. Intuitively it is not needed. Pull Request #105132
810 lines
23 KiB
C
810 lines
23 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup pythonintern
|
|
*
|
|
* This file defines the 'BPY_driver_exec' to execute python driver expressions,
|
|
* called by the animation system, there are also some utility functions
|
|
* to deal with the name-space used for driver execution.
|
|
*/
|
|
|
|
#include <Python.h>
|
|
|
|
#include "DNA_anim_types.h"
|
|
|
|
#include "BLI_listbase.h"
|
|
#include "BLI_math_base.h"
|
|
#include "BLI_string.h"
|
|
|
|
#include "BKE_animsys.h"
|
|
#include "BKE_fcurve_driver.h"
|
|
#include "BKE_global.h"
|
|
#include "BKE_idtype.h"
|
|
|
|
#include "RNA_access.h"
|
|
#include "RNA_prototypes.h"
|
|
#include "RNA_types.h"
|
|
|
|
#include "bpy_rna_driver.h" /* For #pyrna_driver_get_variable_value. */
|
|
|
|
#include "bpy_intern_string.h"
|
|
|
|
#include "bpy_driver.h"
|
|
#include "bpy_rna.h"
|
|
|
|
#include "BPY_extern.h"
|
|
|
|
#define USE_RNA_AS_PYOBJECT
|
|
|
|
#define USE_BYTECODE_WHITELIST
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
# include <opcode.h>
|
|
#endif
|
|
|
|
PyObject *bpy_pydriver_Dict = NULL;
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
static PyObject *bpy_pydriver_Dict__whitelist = NULL;
|
|
#endif
|
|
|
|
int bpy_pydriver_create_dict(void)
|
|
{
|
|
PyObject *d, *mod;
|
|
|
|
/* Validate name-space for driver evaluation. */
|
|
if (bpy_pydriver_Dict) {
|
|
return -1;
|
|
}
|
|
|
|
d = PyDict_New();
|
|
if (d == NULL) {
|
|
return -1;
|
|
}
|
|
|
|
bpy_pydriver_Dict = d;
|
|
|
|
/* Import some modules: `builtins`, `bpy`, `math`, `mathutils.noise`. */
|
|
PyDict_SetItemString(d, "__builtins__", PyEval_GetBuiltins());
|
|
|
|
mod = PyImport_ImportModule("math");
|
|
if (mod) {
|
|
PyDict_Merge(d, PyModule_GetDict(mod), 0); /* 0 - don't overwrite existing values */
|
|
Py_DECREF(mod);
|
|
}
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
PyObject *mod_math = mod;
|
|
#endif
|
|
|
|
/* Add `bpy` to global name-space. */
|
|
mod = PyImport_ImportModuleLevel("bpy", NULL, NULL, NULL, 0);
|
|
if (mod) {
|
|
PyDict_SetItemString(bpy_pydriver_Dict, "bpy", mod);
|
|
Py_DECREF(mod);
|
|
}
|
|
|
|
/* Add noise to global name-space. */
|
|
mod = PyImport_ImportModuleLevel("mathutils", NULL, NULL, NULL, 0);
|
|
if (mod) {
|
|
PyObject *modsub = PyDict_GetItemString(PyModule_GetDict(mod), "noise");
|
|
PyDict_SetItemString(bpy_pydriver_Dict, "noise", modsub);
|
|
Py_DECREF(mod);
|
|
}
|
|
|
|
/* Add math utility functions. */
|
|
mod = PyImport_ImportModuleLevel("bl_math", NULL, NULL, NULL, 0);
|
|
if (mod) {
|
|
static const char *names[] = {"clamp", "lerp", "smoothstep", NULL};
|
|
|
|
for (const char **pname = names; *pname; ++pname) {
|
|
PyObject *func = PyDict_GetItemString(PyModule_GetDict(mod), *pname);
|
|
PyDict_SetItemString(bpy_pydriver_Dict, *pname, func);
|
|
}
|
|
|
|
Py_DECREF(mod);
|
|
}
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
/* Setup the whitelist. */
|
|
{
|
|
bpy_pydriver_Dict__whitelist = PyDict_New();
|
|
const char *whitelist[] = {
|
|
/* builtins (basic) */
|
|
"all",
|
|
"any",
|
|
"len",
|
|
/* builtins (numeric) */
|
|
"max",
|
|
"min",
|
|
"pow",
|
|
"round",
|
|
"sum",
|
|
/* types */
|
|
"bool",
|
|
"float",
|
|
"int",
|
|
/* bl_math */
|
|
"clamp",
|
|
"lerp",
|
|
"smoothstep",
|
|
|
|
NULL,
|
|
};
|
|
|
|
for (int i = 0; whitelist[i]; i++) {
|
|
PyDict_SetItemString(bpy_pydriver_Dict__whitelist, whitelist[i], Py_None);
|
|
}
|
|
|
|
/* Add all of `math` functions. */
|
|
if (mod_math != NULL) {
|
|
PyObject *mod_math_dict = PyModule_GetDict(mod_math);
|
|
PyObject *arg_key, *arg_value;
|
|
Py_ssize_t arg_pos = 0;
|
|
while (PyDict_Next(mod_math_dict, &arg_pos, &arg_key, &arg_value)) {
|
|
const char *arg_str = PyUnicode_AsUTF8(arg_key);
|
|
if (arg_str[0] && arg_str[1] != '_') {
|
|
PyDict_SetItem(bpy_pydriver_Dict__whitelist, arg_key, Py_None);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
#endif /* USE_BYTECODE_WHITELIST */
|
|
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* \note this function should do nothing most runs, only when changing frame.
|
|
* Not thread safe but neither is Python.
|
|
*/
|
|
static struct {
|
|
float evaltime;
|
|
|
|
/* Borrowed reference to the `self` in `bpy_pydriver_Dict`
|
|
* keep for as long as the same self is used. */
|
|
PyObject *self;
|
|
BPy_StructRNA *depsgraph;
|
|
} g_pydriver_state_prev = {
|
|
.evaltime = FLT_MAX,
|
|
.self = NULL,
|
|
.depsgraph = NULL,
|
|
};
|
|
|
|
static void bpy_pydriver_namespace_update_frame(const float evaltime)
|
|
{
|
|
if (g_pydriver_state_prev.evaltime != evaltime) {
|
|
PyObject *item = PyFloat_FromDouble(evaltime);
|
|
PyDict_SetItem(bpy_pydriver_Dict, bpy_intern_str_frame, item);
|
|
Py_DECREF(item);
|
|
|
|
g_pydriver_state_prev.evaltime = evaltime;
|
|
}
|
|
}
|
|
|
|
static void bpy_pydriver_namespace_update_self(struct PathResolvedRNA *anim_rna)
|
|
{
|
|
if ((g_pydriver_state_prev.self == NULL) ||
|
|
(pyrna_driver_is_equal_anim_rna(anim_rna, g_pydriver_state_prev.self) == false)) {
|
|
PyObject *item = pyrna_driver_self_from_anim_rna(anim_rna);
|
|
PyDict_SetItem(bpy_pydriver_Dict, bpy_intern_str_self, item);
|
|
Py_DECREF(item);
|
|
|
|
g_pydriver_state_prev.self = item;
|
|
}
|
|
}
|
|
|
|
static void bpy_pydriver_namespace_clear_self(void)
|
|
{
|
|
if (g_pydriver_state_prev.self) {
|
|
PyDict_DelItem(bpy_pydriver_Dict, bpy_intern_str_self);
|
|
|
|
g_pydriver_state_prev.self = NULL;
|
|
}
|
|
}
|
|
|
|
static PyObject *bpy_pydriver_depsgraph_as_pyobject(struct Depsgraph *depsgraph)
|
|
{
|
|
struct PointerRNA depsgraph_ptr;
|
|
RNA_pointer_create(NULL, &RNA_Depsgraph, depsgraph, &depsgraph_ptr);
|
|
return pyrna_struct_CreatePyObject(&depsgraph_ptr);
|
|
}
|
|
|
|
/**
|
|
* Adds a variable `depsgraph` to the name-space. This can then be used to obtain evaluated
|
|
* data-blocks, and the current view layer and scene. See #75553.
|
|
*/
|
|
static void bpy_pydriver_namespace_update_depsgraph(struct Depsgraph *depsgraph)
|
|
{
|
|
/* This should never happen, but it's probably better to have None in Python
|
|
* than a NULL-wrapping Depsgraph Python struct. */
|
|
BLI_assert(depsgraph != NULL);
|
|
if (UNLIKELY(depsgraph == NULL)) {
|
|
PyDict_SetItem(bpy_pydriver_Dict, bpy_intern_str_depsgraph, Py_None);
|
|
g_pydriver_state_prev.depsgraph = NULL;
|
|
return;
|
|
}
|
|
|
|
if ((g_pydriver_state_prev.depsgraph == NULL) ||
|
|
(depsgraph != g_pydriver_state_prev.depsgraph->ptr.data)) {
|
|
PyObject *item = bpy_pydriver_depsgraph_as_pyobject(depsgraph);
|
|
PyDict_SetItem(bpy_pydriver_Dict, bpy_intern_str_depsgraph, item);
|
|
Py_DECREF(item);
|
|
|
|
g_pydriver_state_prev.depsgraph = (BPy_StructRNA *)item;
|
|
}
|
|
}
|
|
|
|
void BPY_driver_exit(void)
|
|
{
|
|
if (bpy_pydriver_Dict) { /* Free the global dict used by python-drivers. */
|
|
PyDict_Clear(bpy_pydriver_Dict);
|
|
Py_DECREF(bpy_pydriver_Dict);
|
|
bpy_pydriver_Dict = NULL;
|
|
}
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
if (bpy_pydriver_Dict__whitelist) {
|
|
PyDict_Clear(bpy_pydriver_Dict__whitelist);
|
|
Py_DECREF(bpy_pydriver_Dict__whitelist);
|
|
bpy_pydriver_Dict__whitelist = NULL;
|
|
}
|
|
#endif
|
|
|
|
g_pydriver_state_prev.evaltime = FLT_MAX;
|
|
|
|
/* Freed when clearing driver dictionary. */
|
|
g_pydriver_state_prev.self = NULL;
|
|
g_pydriver_state_prev.depsgraph = NULL;
|
|
}
|
|
|
|
void BPY_driver_reset(void)
|
|
{
|
|
PyGILState_STATE gilstate;
|
|
const bool use_gil = true; /* !PyC_IsInterpreterActive(); */
|
|
|
|
if (use_gil) {
|
|
gilstate = PyGILState_Ensure();
|
|
}
|
|
|
|
/* Currently exit/reset are practically the same besides the GIL check. */
|
|
BPY_driver_exit();
|
|
|
|
if (use_gil) {
|
|
PyGILState_Release(gilstate);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Error return function for #BPY_driver_exec.
|
|
*
|
|
* \param anim_rna: Used to show the target when printing the error to give additional context.
|
|
*/
|
|
static void pydriver_error(ChannelDriver *driver, const struct PathResolvedRNA *anim_rna)
|
|
{
|
|
driver->flag |= DRIVER_FLAG_INVALID; /* Python expression failed. */
|
|
|
|
const char *null_str = "<null>";
|
|
const ID *id = anim_rna->ptr.owner_id;
|
|
fprintf(stderr,
|
|
"\n"
|
|
"Error in PyDriver: expression failed: %s\n"
|
|
"For target: (type=%s, name=\"%s\", property=%s, property_index=%d)\n"
|
|
"\n",
|
|
driver->expression,
|
|
id ? BKE_idtype_idcode_to_name(GS(id->name)) : null_str,
|
|
id ? id->name + 2 : null_str,
|
|
anim_rna->prop ? RNA_property_identifier(anim_rna->prop) : null_str,
|
|
anim_rna->prop_index);
|
|
|
|
// BPy_errors_to_report(NULL); /* TODO: reports. */
|
|
PyErr_Print();
|
|
PyErr_Clear();
|
|
}
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
|
|
# define OK_OP(op) [op] = true
|
|
|
|
static const bool secure_opcodes[255] = {
|
|
# if PY_VERSION_HEX >= 0x030b0000 /* Python 3.11 & newer. */
|
|
|
|
OK_OP(CACHE),
|
|
OK_OP(POP_TOP),
|
|
OK_OP(PUSH_NULL),
|
|
OK_OP(NOP),
|
|
OK_OP(UNARY_POSITIVE),
|
|
OK_OP(UNARY_NEGATIVE),
|
|
OK_OP(UNARY_NOT),
|
|
OK_OP(UNARY_INVERT),
|
|
OK_OP(BINARY_SUBSCR),
|
|
OK_OP(GET_LEN),
|
|
OK_OP(LIST_TO_TUPLE),
|
|
OK_OP(RETURN_VALUE),
|
|
OK_OP(SWAP),
|
|
OK_OP(BUILD_TUPLE),
|
|
OK_OP(BUILD_LIST),
|
|
OK_OP(BUILD_SET),
|
|
OK_OP(BUILD_MAP),
|
|
OK_OP(COMPARE_OP),
|
|
OK_OP(JUMP_FORWARD),
|
|
OK_OP(JUMP_IF_FALSE_OR_POP),
|
|
OK_OP(JUMP_IF_TRUE_OR_POP),
|
|
OK_OP(POP_JUMP_FORWARD_IF_FALSE),
|
|
OK_OP(POP_JUMP_FORWARD_IF_TRUE),
|
|
OK_OP(LOAD_GLOBAL),
|
|
OK_OP(IS_OP),
|
|
OK_OP(CONTAINS_OP),
|
|
OK_OP(BINARY_OP),
|
|
OK_OP(LOAD_FAST),
|
|
OK_OP(STORE_FAST),
|
|
OK_OP(DELETE_FAST),
|
|
OK_OP(POP_JUMP_FORWARD_IF_NOT_NONE),
|
|
OK_OP(POP_JUMP_FORWARD_IF_NONE),
|
|
OK_OP(BUILD_SLICE),
|
|
OK_OP(LOAD_DEREF),
|
|
OK_OP(STORE_DEREF),
|
|
OK_OP(RESUME),
|
|
OK_OP(LIST_EXTEND),
|
|
OK_OP(SET_UPDATE),
|
|
/* NOTE(@ideasman42): Don't enable dict manipulation, unless we can prove there is not way it
|
|
* can be used to manipulate the name-space (potentially allowing malicious code). */
|
|
# if 0
|
|
OK_OP(DICT_MERGE),
|
|
OK_OP(DICT_UPDATE),
|
|
# endif
|
|
OK_OP(POP_JUMP_BACKWARD_IF_NOT_NONE),
|
|
OK_OP(POP_JUMP_BACKWARD_IF_NONE),
|
|
OK_OP(POP_JUMP_BACKWARD_IF_FALSE),
|
|
OK_OP(POP_JUMP_BACKWARD_IF_TRUE),
|
|
|
|
/* Special cases. */
|
|
OK_OP(LOAD_CONST), /* Ok because constants are accepted. */
|
|
OK_OP(LOAD_NAME), /* Ok, because `PyCodeObject.names` is checked. */
|
|
OK_OP(CALL), /* Ok, because we check its "name" before calling. */
|
|
OK_OP(KW_NAMES), /* Ok, because it's used for calling functions with keyword arguments. */
|
|
OK_OP(PRECALL), /* Ok, because it's used for calling. */
|
|
|
|
# else /* Python 3.10 and older. */
|
|
|
|
OK_OP(POP_TOP),
|
|
OK_OP(ROT_TWO),
|
|
OK_OP(ROT_THREE),
|
|
OK_OP(DUP_TOP),
|
|
OK_OP(DUP_TOP_TWO),
|
|
OK_OP(ROT_FOUR),
|
|
OK_OP(NOP),
|
|
OK_OP(UNARY_POSITIVE),
|
|
OK_OP(UNARY_NEGATIVE),
|
|
OK_OP(UNARY_NOT),
|
|
OK_OP(UNARY_INVERT),
|
|
OK_OP(BINARY_MATRIX_MULTIPLY),
|
|
OK_OP(INPLACE_MATRIX_MULTIPLY),
|
|
OK_OP(BINARY_POWER),
|
|
OK_OP(BINARY_MULTIPLY),
|
|
OK_OP(BINARY_MODULO),
|
|
OK_OP(BINARY_ADD),
|
|
OK_OP(BINARY_SUBTRACT),
|
|
OK_OP(BINARY_SUBSCR),
|
|
OK_OP(BINARY_FLOOR_DIVIDE),
|
|
OK_OP(BINARY_TRUE_DIVIDE),
|
|
OK_OP(INPLACE_FLOOR_DIVIDE),
|
|
OK_OP(INPLACE_TRUE_DIVIDE),
|
|
OK_OP(GET_LEN),
|
|
OK_OP(INPLACE_ADD),
|
|
OK_OP(INPLACE_SUBTRACT),
|
|
OK_OP(INPLACE_MULTIPLY),
|
|
OK_OP(INPLACE_MODULO),
|
|
OK_OP(BINARY_LSHIFT),
|
|
OK_OP(BINARY_RSHIFT),
|
|
OK_OP(BINARY_AND),
|
|
OK_OP(BINARY_XOR),
|
|
OK_OP(BINARY_OR),
|
|
OK_OP(INPLACE_POWER),
|
|
OK_OP(INPLACE_LSHIFT),
|
|
OK_OP(INPLACE_RSHIFT),
|
|
OK_OP(INPLACE_AND),
|
|
OK_OP(INPLACE_XOR),
|
|
OK_OP(INPLACE_OR),
|
|
OK_OP(LIST_TO_TUPLE),
|
|
OK_OP(RETURN_VALUE),
|
|
OK_OP(ROT_N),
|
|
OK_OP(BUILD_TUPLE),
|
|
OK_OP(BUILD_LIST),
|
|
OK_OP(BUILD_SET),
|
|
OK_OP(BUILD_MAP),
|
|
OK_OP(COMPARE_OP),
|
|
OK_OP(JUMP_FORWARD),
|
|
OK_OP(JUMP_IF_FALSE_OR_POP),
|
|
OK_OP(JUMP_IF_TRUE_OR_POP),
|
|
OK_OP(JUMP_ABSOLUTE),
|
|
OK_OP(POP_JUMP_IF_FALSE),
|
|
OK_OP(POP_JUMP_IF_TRUE),
|
|
OK_OP(LOAD_GLOBAL),
|
|
OK_OP(IS_OP),
|
|
OK_OP(CONTAINS_OP),
|
|
OK_OP(LOAD_FAST),
|
|
OK_OP(STORE_FAST),
|
|
OK_OP(DELETE_FAST),
|
|
OK_OP(BUILD_SLICE),
|
|
OK_OP(LOAD_DEREF),
|
|
OK_OP(STORE_DEREF),
|
|
OK_OP(LIST_EXTEND),
|
|
OK_OP(SET_UPDATE),
|
|
/* NOTE(@ideasman42): Don't enable dict manipulation, unless we can prove there is not way it
|
|
* can be used to manipulate the name-space (potentially allowing malicious code). */
|
|
# if 0
|
|
OK_OP(DICT_MERGE),
|
|
OK_OP(DICT_UPDATE),
|
|
# endif
|
|
|
|
/* Special cases. */
|
|
OK_OP(LOAD_CONST), /* Ok because constants are accepted. */
|
|
OK_OP(LOAD_NAME), /* Ok, because `PyCodeObject.names` is checked. */
|
|
OK_OP(CALL_FUNCTION), /* Ok, because we check its "name" before calling. */
|
|
OK_OP(CALL_FUNCTION_KW),
|
|
OK_OP(CALL_FUNCTION_EX),
|
|
|
|
# endif /* Python 3.10 and older. */
|
|
};
|
|
|
|
# undef OK_OP
|
|
|
|
bool BPY_driver_secure_bytecode_test_ex(PyObject *expr_code,
|
|
PyObject *namespace_array[],
|
|
const bool verbose,
|
|
const char *error_prefix)
|
|
{
|
|
PyCodeObject *py_code = (PyCodeObject *)expr_code;
|
|
|
|
/* Check names. */
|
|
{
|
|
for (int i = 0; i < PyTuple_GET_SIZE(py_code->co_names); i++) {
|
|
PyObject *name = PyTuple_GET_ITEM(py_code->co_names, i);
|
|
const char *name_str = PyUnicode_AsUTF8(name);
|
|
bool contains_name = false;
|
|
for (int j = 0; namespace_array[j]; j++) {
|
|
if (PyDict_Contains(namespace_array[j], name)) {
|
|
contains_name = true;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if ((contains_name == false) || (name_str[0] == '_')) {
|
|
if (verbose) {
|
|
fprintf(stderr,
|
|
"\t%s: restricted access disallows name '%s', "
|
|
"enable auto-execution to support\n",
|
|
error_prefix,
|
|
name_str);
|
|
}
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Check opcodes. */
|
|
{
|
|
const _Py_CODEUNIT *codestr;
|
|
Py_ssize_t code_len;
|
|
|
|
PyObject *co_code;
|
|
|
|
# if PY_VERSION_HEX >= 0x030b0000 /* Python 3.11 & newer. */
|
|
co_code = PyCode_GetCode(py_code);
|
|
if (UNLIKELY(!co_code)) {
|
|
PyErr_Print();
|
|
PyErr_Clear();
|
|
return false;
|
|
}
|
|
# else
|
|
co_code = py_code->co_code;
|
|
# endif
|
|
|
|
PyBytes_AsStringAndSize(co_code, (char **)&codestr, &code_len);
|
|
code_len /= sizeof(*codestr);
|
|
bool ok = true;
|
|
|
|
/* Loop over op-code's, the op-code arguments are ignored. */
|
|
for (Py_ssize_t i = 0; i < code_len; i++) {
|
|
const int opcode = _Py_OPCODE(codestr[i]);
|
|
if (secure_opcodes[opcode] == false) {
|
|
if (verbose) {
|
|
fprintf(stderr,
|
|
"\t%s: restricted access disallows opcode '%d', "
|
|
"enable auto-execution to support\n",
|
|
error_prefix,
|
|
opcode);
|
|
}
|
|
ok = false;
|
|
break;
|
|
}
|
|
}
|
|
|
|
# if PY_VERSION_HEX >= 0x030b0000 /* Python 3.11 & newer. */
|
|
Py_DECREF(co_code);
|
|
# endif
|
|
if (!ok) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
bool BPY_driver_secure_bytecode_test(PyObject *expr_code, PyObject *namespace, const bool verbose)
|
|
{
|
|
|
|
if (!bpy_pydriver_Dict) {
|
|
if (bpy_pydriver_create_dict() != 0) {
|
|
fprintf(stderr, "%s: couldn't create Python dictionary\n", __func__);
|
|
return false;
|
|
}
|
|
}
|
|
return BPY_driver_secure_bytecode_test_ex(expr_code,
|
|
(PyObject *[]){
|
|
bpy_pydriver_Dict,
|
|
bpy_pydriver_Dict__whitelist,
|
|
namespace,
|
|
NULL,
|
|
},
|
|
verbose,
|
|
__func__);
|
|
}
|
|
|
|
#endif /* USE_BYTECODE_WHITELIST */
|
|
float BPY_driver_exec(struct PathResolvedRNA *anim_rna,
|
|
ChannelDriver *driver,
|
|
ChannelDriver *driver_orig,
|
|
const AnimationEvalContext *anim_eval_context)
|
|
{
|
|
/* (old) NOTE: PyGILState_Ensure() isn't always called because python can call
|
|
* the bake operator which intern starts a thread which calls scene update
|
|
* which does a driver update. to avoid a deadlock check #PyC_IsInterpreterActive()
|
|
* if #PyGILState_Ensure() is needed, see #27683.
|
|
*
|
|
* (new) NOTE: checking if python is running is not thread-safe #28114
|
|
* now release the GIL on python operator execution instead, using
|
|
* #PyEval_SaveThread() / #PyEval_RestoreThread() so we don't lock up blender.
|
|
*
|
|
* For copy-on-write we always cache expressions and write errors in the
|
|
* original driver, otherwise these would get freed while editing.
|
|
* Due to the GIL this is thread-safe. */
|
|
|
|
PyObject *driver_vars = NULL;
|
|
PyObject *retval = NULL;
|
|
|
|
/* Speed up by pre-hashing string & avoids re-converting unicode strings for every execution. */
|
|
PyObject *expr_vars;
|
|
|
|
PyObject *expr_code;
|
|
PyGILState_STATE gilstate;
|
|
bool use_gil;
|
|
|
|
DriverVar *dvar;
|
|
double result = 0.0; /* Default return. */
|
|
const char *expr;
|
|
bool targets_ok = true;
|
|
int i;
|
|
|
|
/* Get the python expression to be evaluated. */
|
|
expr = driver_orig->expression;
|
|
if (expr[0] == '\0') {
|
|
return 0.0f;
|
|
}
|
|
|
|
#ifndef USE_BYTECODE_WHITELIST
|
|
if (!(G.f & G_FLAG_SCRIPT_AUTOEXEC)) {
|
|
if (!(G.f & G_FLAG_SCRIPT_AUTOEXEC_FAIL_QUIET)) {
|
|
G.f |= G_FLAG_SCRIPT_AUTOEXEC_FAIL;
|
|
BLI_snprintf(G.autoexec_fail, sizeof(G.autoexec_fail), "Driver '%s'", expr);
|
|
|
|
printf("skipping driver '%s', automatic scripts are disabled\n", expr);
|
|
}
|
|
return 0.0f;
|
|
}
|
|
#else
|
|
bool is_recompile = false;
|
|
#endif
|
|
|
|
use_gil = true; /* !PyC_IsInterpreterActive(); */
|
|
|
|
if (use_gil) {
|
|
gilstate = PyGILState_Ensure();
|
|
}
|
|
|
|
/* Needed since drivers are updated directly after undo where `main` is re-allocated #28807. */
|
|
BPY_update_rna_module();
|
|
|
|
/* Initialize global dictionary for Python driver evaluation settings. */
|
|
if (!bpy_pydriver_Dict) {
|
|
if (bpy_pydriver_create_dict() != 0) {
|
|
fprintf(stderr, "%s: couldn't create Python dictionary\n", __func__);
|
|
if (use_gil) {
|
|
PyGILState_Release(gilstate);
|
|
}
|
|
return 0.0f;
|
|
}
|
|
}
|
|
|
|
/* Update global name-space. */
|
|
bpy_pydriver_namespace_update_frame(anim_eval_context->eval_time);
|
|
|
|
if (driver_orig->flag & DRIVER_FLAG_USE_SELF) {
|
|
bpy_pydriver_namespace_update_self(anim_rna);
|
|
}
|
|
else {
|
|
bpy_pydriver_namespace_clear_self();
|
|
}
|
|
|
|
bpy_pydriver_namespace_update_depsgraph(anim_eval_context->depsgraph);
|
|
|
|
if (driver_orig->expr_comp == NULL) {
|
|
driver_orig->flag |= DRIVER_FLAG_RECOMPILE;
|
|
}
|
|
|
|
/* Compile the expression first if it hasn't been compiled or needs to be rebuilt. */
|
|
if (driver_orig->flag & DRIVER_FLAG_RECOMPILE) {
|
|
Py_XDECREF(driver_orig->expr_comp);
|
|
driver_orig->expr_comp = PyTuple_New(2);
|
|
|
|
expr_code = Py_CompileString(expr, "<bpy driver>", Py_eval_input);
|
|
PyTuple_SET_ITEM(((PyObject *)driver_orig->expr_comp), 0, expr_code);
|
|
|
|
driver_orig->flag &= ~DRIVER_FLAG_RECOMPILE;
|
|
|
|
/* Maybe this can be removed but for now best keep until were sure. */
|
|
driver_orig->flag |= DRIVER_FLAG_RENAMEVAR;
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
is_recompile = true;
|
|
#endif
|
|
}
|
|
else {
|
|
expr_code = PyTuple_GET_ITEM(((PyObject *)driver_orig->expr_comp), 0);
|
|
}
|
|
|
|
if (driver_orig->flag & DRIVER_FLAG_RENAMEVAR) {
|
|
/* May not be set. */
|
|
expr_vars = PyTuple_GET_ITEM(((PyObject *)driver_orig->expr_comp), 1);
|
|
Py_XDECREF(expr_vars);
|
|
|
|
expr_vars = PyTuple_New(BLI_listbase_count(&driver_orig->variables));
|
|
PyTuple_SET_ITEM(((PyObject *)driver_orig->expr_comp), 1, expr_vars);
|
|
|
|
for (dvar = driver_orig->variables.first, i = 0; dvar; dvar = dvar->next) {
|
|
PyTuple_SET_ITEM(expr_vars, i++, PyUnicode_FromString(dvar->name));
|
|
}
|
|
|
|
driver_orig->flag &= ~DRIVER_FLAG_RENAMEVAR;
|
|
}
|
|
else {
|
|
expr_vars = PyTuple_GET_ITEM(((PyObject *)driver_orig->expr_comp), 1);
|
|
}
|
|
|
|
/* Add target values to a dict that will be used as `__locals__` dict. */
|
|
driver_vars = _PyDict_NewPresized(PyTuple_GET_SIZE(expr_vars));
|
|
for (dvar = driver->variables.first, i = 0; dvar; dvar = dvar->next) {
|
|
PyObject *driver_arg = NULL;
|
|
|
|
/* Support for any RNA data. */
|
|
#ifdef USE_RNA_AS_PYOBJECT
|
|
if (dvar->type == DVAR_TYPE_SINGLE_PROP) {
|
|
driver_arg = pyrna_driver_get_variable_value(
|
|
anim_eval_context, driver, dvar, &dvar->targets[0]);
|
|
|
|
if (driver_arg == NULL) {
|
|
driver_arg = PyFloat_FromDouble(0.0);
|
|
dvar->curval = 0.0f;
|
|
}
|
|
else {
|
|
/* No need to worry about overflow here, values from RNA are within limits. */
|
|
if (PyFloat_CheckExact(driver_arg)) {
|
|
dvar->curval = (float)PyFloat_AsDouble(driver_arg);
|
|
}
|
|
else if (PyLong_CheckExact(driver_arg)) {
|
|
dvar->curval = (float)PyLong_AsLong(driver_arg);
|
|
}
|
|
else if (PyBool_Check(driver_arg)) {
|
|
dvar->curval = (driver_arg == Py_True);
|
|
}
|
|
else {
|
|
dvar->curval = 0.0f;
|
|
}
|
|
}
|
|
}
|
|
else
|
|
#endif
|
|
{
|
|
/* Try to get variable value. */
|
|
const float tval = driver_get_variable_value(anim_eval_context, driver, dvar);
|
|
driver_arg = PyFloat_FromDouble((double)tval);
|
|
}
|
|
|
|
/* Try to add to dictionary. */
|
|
/* `if (PyDict_SetItemString(driver_vars, dvar->name, driver_arg)) {` */
|
|
if (PyDict_SetItem(driver_vars, PyTuple_GET_ITEM(expr_vars, i++), driver_arg) != -1) {
|
|
/* Pass. */
|
|
}
|
|
else {
|
|
/* This target failed - bad name. */
|
|
if (targets_ok) {
|
|
/* First one, print some extra info for easier identification. */
|
|
fprintf(stderr, "\n%s: Error while evaluating PyDriver:\n", __func__);
|
|
targets_ok = false;
|
|
}
|
|
|
|
fprintf(stderr, "\t%s: couldn't add variable '%s' to namespace\n", __func__, dvar->name);
|
|
// BPy_errors_to_report(NULL); /* TODO: reports. */
|
|
PyErr_Print();
|
|
PyErr_Clear();
|
|
}
|
|
Py_DECREF(driver_arg);
|
|
}
|
|
|
|
#ifdef USE_BYTECODE_WHITELIST
|
|
if (is_recompile && expr_code) {
|
|
if (!(G.f & G_FLAG_SCRIPT_AUTOEXEC)) {
|
|
if (!BPY_driver_secure_bytecode_test_ex(
|
|
expr_code,
|
|
(PyObject *[]){
|
|
bpy_pydriver_Dict,
|
|
bpy_pydriver_Dict__whitelist,
|
|
driver_vars,
|
|
NULL,
|
|
},
|
|
/* Always be verbose since this can give hints to why evaluation fails. */
|
|
true,
|
|
__func__)) {
|
|
if (!(G.f & G_FLAG_SCRIPT_AUTOEXEC_FAIL_QUIET)) {
|
|
G.f |= G_FLAG_SCRIPT_AUTOEXEC_FAIL;
|
|
BLI_snprintf(G.autoexec_fail, sizeof(G.autoexec_fail), "Driver '%s'", expr);
|
|
}
|
|
|
|
Py_DECREF(expr_code);
|
|
expr_code = NULL;
|
|
PyTuple_SET_ITEM(((PyObject *)driver_orig->expr_comp), 0, NULL);
|
|
}
|
|
}
|
|
}
|
|
#endif /* USE_BYTECODE_WHITELIST */
|
|
|
|
#if 0 /* slow, with this can avoid all Py_CompileString above. */
|
|
/* execute expression to get a value */
|
|
retval = PyRun_String(expr, Py_eval_input, bpy_pydriver_Dict, driver_vars);
|
|
#else
|
|
/* Evaluate the compiled expression. */
|
|
if (expr_code) {
|
|
retval = PyEval_EvalCode((void *)expr_code, bpy_pydriver_Dict, driver_vars);
|
|
}
|
|
#endif
|
|
|
|
/* Decref the driver variables first. */
|
|
Py_DECREF(driver_vars);
|
|
|
|
/* Process the result. */
|
|
if (retval == NULL) {
|
|
pydriver_error(driver, anim_rna);
|
|
}
|
|
else {
|
|
if (UNLIKELY((result = PyFloat_AsDouble(retval)) == -1.0 && PyErr_Occurred())) {
|
|
pydriver_error(driver, anim_rna);
|
|
result = 0.0;
|
|
}
|
|
else {
|
|
/* All fine, make sure the "invalid expression" flag is cleared. */
|
|
driver->flag &= ~DRIVER_FLAG_INVALID;
|
|
}
|
|
Py_DECREF(retval);
|
|
}
|
|
|
|
if (use_gil) {
|
|
PyGILState_Release(gilstate);
|
|
}
|
|
|
|
if (UNLIKELY(!isfinite(result))) {
|
|
fprintf(stderr, "\t%s: driver '%s' evaluates to '%f'\n", __func__, driver->expression, result);
|
|
return 0.0f;
|
|
}
|
|
|
|
return (float)result;
|
|
}
|