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

Наша функция storemesh() принимает в качестве аргументов объект и номер кадра. Первым действием нужно извлечь координаты вершин из данных меша, связанных с объектом. Затем она извлекает все данные, сохранённые в реестре Блендера для объекта, с которым мы имеем дело, и мы передаем дополнительный параметр True (Истина), указывающий, что если нет данных в памяти, GetKey() должна проверить их наличие на диске. Если совсем нет никаких данных, сохранённых для нашего объекта, GetKey() возвращает None , и в этом случае мы инициализируем наш кеш пустым словарём.

Впоследствии, мы сохраняем координаты нашего меша в этом словаре, проиндексированном номером кадра (выделено в следующем куске кода). Мы преобразуем этот номер кадра из целого в строку, которую нужно использовать в качестве фактического ключа, поскольку функция Блендера SetKey() принимает ключи строкового типа при сохранении данных реестра на диск, и вызовет исключение, если она сталкивается с целым. Последняя строка снова вызывает SetKey() с дополнительным аргументом True , чтобы указать, что мы хотим сохранять данные также на диск.

def storemesh(ob,frame):

coords = [(v.co.x,v.co.y,v.co.z) for v in

ob.getData().verts]

d=Blender.Registry.GetKey(ckey(ob),True)

if d == None: d={}

d[str(frame)]=coords

Blender.Registry.SetKey(ckey(ob),d,True)

Функция retrievemesh() принимает в качестве аргументов объект и номер кадра. Если она находит кешированные данные для данного объекта и кадра, она назначает загруженные координаты вершинам в меше. Сначала мы определим два новых исключения, означающие некоторые специфические ошибочные состояния, с которыми retrievemesh() может столкнуться:

class NoSuchProperty(RuntimeError): pass;

class NoFrameCached(RuntimeError): pass;

retrievemesh() вызовет исключение NoSuchProperty , если объект не имеет связанных кешированных данных меша, и исключение NoFrameCached если данные присутствуют, но не для указанного кадра. Выделенная строка в следующем коде заслуживает некоторого внимания. Мы выбираем связанные данные меша у объекта с mesh=True . Это даст завёрнутый (wrapped) меш, а не копию, так что любые данные вершин, к которым мы получаем доступ, или изменяем, ссылаются на фактические данные. Также, мы сталкиваемся со встроенный функцией Питона zip() , которая принимает два списка и возвращает список, состоящий из кортежей двух элементов, по одному из каждого списка. Это эффективно позволяет просматривать два списка параллельно. В нашем случае, эти списки - список вершин и список координат и мы просто преобразуем эти координаты в векторы и назначаем их в атрибут co каждой вершины:

def retrievemesh(ob,frame):

d=Blender.Registry.GetKey(ckey(ob),True)

if d == None:

raise NoSuchProperty("no property %s for object %s"

%(meshcache,ob.name))

try:

coords = d[str(frame)]

except KeyError:

raise NoFrameCached(("frame %d not cached on" +

"object %s") %(frame,ob.name))

for v,c in zip(ob.getData(mesh=True).verts,coords):

v.co = Blender.Mathutils.Vector(c)

Чтобы завершить наш набор функций кеша, мы определяем функцию clearcache() , которая пытается удалять данные в реестре, связанные с нашим объектом. Конструкция try … except … обеспечивает, чтобы при отсутствии сохранённых данных, действие было молча проигнорировано:

def clearcache(ob):

try:

Blender.Registry.RemoveKey(ckey(ob))

except:

pass

Наш скрипт будет использоваться не только как скриптсвязь, связанная с объектом, но он также будет использоваться автономно (по нажатию Alt + P в текстовом редакторе, например), чтобы обеспечить пользователя средствами для идентификации цели, которая создаст отпечаток, чтобы очищать кеш, и, чтобы ассоциировать скриптсвязь с активным объектом. При использовании таким образом, он обеспечивает конечного пользователя несколькими управляющими меню, показанными на скриншотах. Первый показывает возможные действия:

Второй скриншот показывает всплывающее меню с предложением выбрать объект из списка Меш -объектов, из которого пользователь может выбрать, чем создавать отпечаток:

Мы сначала определяем вспомогательную функцию, которая будет использована выпадающим меню, обеспечивающим пользователя выбором Меш -объектов, для использования в качестве цели при создании отпечатка. getmeshobjects() принимает аргумент scene и возвращает список имен всех Меш -объектов. Как показано на скриншоте, список объектов-целей включает в том числе исходный объект. Хотя это законно, но вряд ли очень полезно:

def getmeshobjects(scene):

return [ob.name for ob in scene.objects if

ob.type=='Mesh']

Само меню осуществляется функцией targetmenu() , определенной следующим образом:

def targetmenu(ob):

meshobjects=getmeshobjects(Blender.Scene.GetCurrent())

menu='Select target%t|'+ "|".join(meshobjects)

ret = Blender.Draw.PupMenu(menu)

if ret>0:

try:

p = ob.getProperty(impresstarget)

p.setData(meshobjects[ret-1])

except:

ob.addProperty(impresstarget,meshobjects[ret-1])

Она выбирает список из всех Меш-объектов в сцене и представляет этот список на выбор пользователю, используя функцию Блендера Draw.PupMenu() . Если пользователь выбирает один из пунктов меню (возвращённая величина будет больше нуля, смотри выделенную строку предыдущего кода), будет загружено имя этого Меш-объекта как свойство, связанное с нашим объектом. Константа impresstarget определяется в другом месте в качестве имени для свойства. Сначала, программа независимо проверяет, есть ли там уже такое свойство, связанное с объектом, вызывая метод getProperty() , и присваивает данные свойству, если есть. Если метод getProperty() вызывает исключение, поскольку свойство еще не существует, тогда мы добавляем новое свойство к объекту и назначаем ему данные с помощью единственного вызова addProperty() .

Основной интерфейс пользователя определяется на верхнем уровне скрипта. Он проверяет, что не был запущен как скриптсвязь, затем предоставляет пользователю несколько действий на выбор:

if not Blender.bylink:

ret = Blender.Draw.PupMenu('Impress scriptlink%t|'+

'Add/Replace scriptlink|'+

'Clear cache|Remove ' +

'all|New Target')

active = Blender.Scene.GetCurrent().objects.active

if ret > 0:

clearcache(active)

if ret== 1:

active.clearScriptLinks([scriptname])

active.addScriptLink(scriptname,'FrameChanged')

targetmenu(active)

elif ret== 2:

pass

elif ret== 3:

active.removeProperty(meshcache)

active.clearScriptLinks([scriptname])