Michel Anders - Написание скриптов для Blender 2.49

poseob = obbones.getPose()

bigarmpose = poseob.bones[bone]

c=bigarmpose.constraints.append(Type.LIMITROT)

c[Settings.LIMIT]=Settings.LIMIT_XROT|

Settings.LIMIT_YROT

c[Settings.XMIN]=0.0

c[Settings.XMAX]=0.0

c[Settings.YMIN]=0.0

c[Settings.YMAX]=0.0

poseob.update()

Вновь присоединенное ограничениесохраняется в переменную cи в последующих строках видно, что различные атрибуты ограничения, становятся доступны подобно словарю. Сначала мы настраиваем атрибут LIMIT(это битовая маска), для ограничения вращения по осям Xи Y. Далее, мы устанавливаем минимальное и максимальное значение вращения вокруг этих осей равным 0.0, таким образом мы останавливаем любое движение. Например, в риггинге реалистичного скелета животного этими значениями можно задать пределы величин вращения к значениям, сопоставимыми с реальными соединениями между костями. И в конце, чтобы сделать изменения pose (позы) видимыми, мы обращаемся к методу update().

Там, где pydriversпредоставляют нам возможность управлять изменением одной IPO-кривой посредством изменения другой, PyConstraints( питон-ограничения) предоставляют нам способы задавать пределы изменения свойств объекта.

Конечно, в Блендер встроено много простых ограничений, таких как мы видели в предыдущем разделе, и часто комбинации простых ограничений достаточно для того, что нам нужно. Но если нам необходимо, чтобы наши объекты перемещались с места на место свободно в пределах не прямоугольной области, а например, для упрощения размещения светофоров и телефонных будок по сетке улиц. Как мы можем достичь этого? Введите pyconstraints.

PyConstraints - Питон-скрипты, которые присутствуют как текстовые блоки в текстовом редакторе Блендера и должны начинаться со строки комментария, идентифицирующей их как ограничение:

#BPYCONSTRAINT

Ограничениена Питоне должно содержать три функции с именами doConstraint(), doTarget(), и getSettings(). Первые двe вызываются в любое время, когда мы двигаем или цель, или ограничиваемыйобъект, а последняя функция вызывается тогда, когда пользователь щелкает по кнопке Options, которая появляется, как только пользователь выбрал pyconstraint. Следующий скриншот показывает окно Ограничений, как только был выбран pyconstraint.

Самый легкий путь понять, что эти функции делают — посмотреть встроенный шаблон ограничения, который мы можем использовать в качестве основы, чтобы написать наши собственные ограничения. Он доступен в текстовом редакторе по меню Text | Script Templates | Script Constraint. При выборе этого меню будет создан новый текстовый блок, который можно выбрать в выпадающем списке внизу окна текстового редактора.

Шаблон ограничениясодержит также много полезных комментариев, но здесь мы перечислим, по большей части голые функции. Кроме того, шаблон создает окно с фиктивными свойствами. Мы столкнемся со свойствами в следующей части, так что наш пример функции getSettings()здесь будет почти пуст. Как показано, функции будут осуществлять функциональное ограничение, однако, ничего фактически не будет ограничено. Расположение, вращение, и масштаб ограничиваемогообъекта останутся без изменений.

def doConstraint(obmatrix, targetmatrices, idprop):

# Выделить компоненты преобразования для быстрого

# доступа.

obloc = obmatrix.translationPart() # перемещение

obrot = obmatrix.toEuler() # вращение

obsca = obmatrix.scalePart() # масштабирование

# код, который реально меняет положение, вращение и

# масштабирование, расположен здесь

# Конвертация обратно в матрицы положения, вращения,

# масштаба,

mtxloc = Mathutils.TranslationMatrix(obloc)

mtxrot = obrot.toMatrix().resize4x4()

mtxsca = Mathutils.Matrix([obsca[0],0,0,0],

[0,obsca[1],0,0],

[0,0,obsca[2],0], [0,0,0,1])

# Рекомбинация отдельных элементов в матрицу

# преобразования.

outputmatrix = mtxsca * mtxrot * mtxloc

# Возвращаем новую матрицу.

return outputmatrix

В функцию doConstraint()передаётся матрица преобразований ограничиваемогообъекта и список матриц преобразования для каждого целевого объекта. Она также получает словарь свойств ограничения, к которым можно получить доступ по имени.

Первая вещь, которую мы делаем, - выделяем отдельные компоненты матрицы преобразования — перемещение, вращение, и масштаб ограничиваемогообъекта. Частью перемещения будет вектор положения x, y, z, частью масштаба будет вектор масштабирующих коэффициентов вдоль осей x, y, z. Часть вращения будет представлена вектором Эйлера с вращением вокруг трех основных осей. (углы Эйлера очень упрощают работу с вращениями в трехмерном пространстве, но по началу являются довольно трудными для понимания. В википедии есть материал на эту тему http://ru.wikipedia.org/wiki/Углы_Эйлера, но пока что легче думать о углах Эйлера как о вращении вокруг осей x, y, z. Углы Эйлера трудны? Вот от кватернионов реально мозг взрывается! - возмущение пер. ) Мы можем разделить любую матрицу преобразования целевого объекта так, как нам нужно, и затем изменить компоненты матрицы преобразования ограничиваемогообъекта по своему усмотрению.

Функция, показанная здесь, не делает ничего, но преобразует различные компоненты преобразования обратно в матрицы, используя методы API (где это доступно), и затем рекомбинирует их, используя матричное умножение в единственную матрицу, которая впоследствии возвращается.

Функция doTarget()вызывается до вызова doConstraint()и даёт нам возможность манипулировать целевой матрицей прежде, чем она будет передана в doConstraint(). Аргументы - целевой объект, под-цель (или Кость или группа вершин для целевой арматуры или меша соответственно), целевая матрица, и свойства ограничения. В следующем разделе мы используем эту возможность для сохранения ссылки на целевой объект в свойствах, чтобы doConstraint()могла иметь доступ к этой информации. Если мы не хотим ничего изменять, то достаточно возвратить целевую матрицу, как показано в следующем коде:

def doTarget(target_object, subtarget_bone, target_matrix,

id_properties_of_constraint):

return target_matrix

Точно также, если нет необходимости предлагать пользователю возможность определять дополнительные свойства, getSettings(), может иметь просто оператор return(возврат). Если мы хотим показать всплывающее меню, getSettings()- то место, где это нужно сделать. Мы также увидим такой пример в следующем разделе. Следующий код будет корректной реализацией "ничегонеделания":