Заголовки, импортирование модулей и глобальные данные.

Первые 32 строки кода представлены в примере 1.

001 ######################################################
002 
#
003 # Демонстрационный скрипт для руководства пользователя Blender 2.3
004 
#
005 ###################################################S68
006 # Этот 
скрипт генерирует полигон. Это не особо полезно,
007 # т.к. вы можете создать 
его так : ADD->Mesh->Circle,
008 # но это прекрасный пример скрипта, 
к тому же
009 # полигоны 'заполнены'
010 ######################################################
011 

012 ######################################################
013 # импорт 
модулей
014 ######################################################
015 
016 
import Blender
017 from Blender import NMesh
018 from Blender.BGL import 
*
019 from Blender.Draw import *
020 
021 import math
022 from math 
import *
023 
024 # Параметры полигона
025 T_NumberOfSides = Create(3)
026 
T_Radius = Create(1.0)
027 
028 # События
029 EVENT_NOEVENT = 1
030 
EVENT_DRAW = 2
031 EVENT_EXIT = 3
032 
 
 

После необходимых коментариев с описанием того, что делает скрипт, происходит (строки 016-022) импортирование модулей Python'а.

Blender - это главный модуль в Blender Python API. NMesh - модуль обеспечивающий доступ к mesh-объектам Blender'а, в то время как BGL и Draw дают доступ к константам и функциям OpenGL и оконному интерфейсу Blender'а соответственно. Модуль math это математический модуль Python'а, но с недавнего времени и 'math' и 'os' модули встроены в Blender, вам не нужна полная инсталяция Python'а для этого!

Полигон определяется через число сторон и радиус. Эти параметры имеют значения, которые должны быть определены пользователем через GUI (Graphical User Interface) следовательно строки (025-026) создают два объекта (generic button), с начальными значениями по умолчанию.

И наконец, объекты интерфейса (GUI) работают с событиями и генерируют их. Идентификатор событий представляет целое число. Это хороший стиль программирования, определять мнемонические назавания для событий, как это сделано здесь в строках 029-031.

Отрисовка графического интерфеса пользователя (GUI).

Код ответственный за отрисовку GUI должен быть в функции рисования draw (Пример 2).

033 ######################################################
034 
# Отрисовка GUI
035 ######################################################
036 
def draw():
037 global T_NumberOfSides
038 global T_Radius
039 global 
EVENT_NOEVENT,EVENT_DRAW,EVENT_EXIT
040 
041 ########## Titles (Заголовки)
042 
glClear(GL_COLOR_BUFFER_BIT)
043 glRasterPos2d(8, 103)
044 Text("Demo Polygon 
Script")
045 
046 ######### Параметры кнопок
047 glRasterPos2d(8, 83)
048 
Text("Parameters:")
049 T_NumberOfSides = Number("No. of sides: ", EVENT_NOEVENT, 
10, 55, 210, 18,
050 T_NumberOfSides.val, 3, 20, "Number of sides of out polygon");
051 
T_Radius = Slider("Radius: ", EVENT_NOEVENT, 10, 35, 210, 18,
052 T_Radius.val, 
0.001, 20.0, 1, "Radius of the polygon");
053 
054 ######### Кнопки "Draw" 
и "Exit"
055 Button("Draw",EVENT_DRAW , 10, 10, 80, 18)
056 Button("Exit",EVENT_EXIT 
, 140, 10, 80, 18)
057 
 
 

Строки (037-039) просто предоставляют доступ к глобальным данным. Действительно интересное содержимое начинается со строк (042-044). Инициализирутся окно OpenGL, и текущая позиция устанавливается в x=8, y=103. Исходное положение этой справки в нижнем левом углу скриптового окна. Затем выводится Demo Polygon Script.

Строки написанные далее (047-048) создают кнопки ввода параметров. Первые строки (049-050) - это кнопка ввода чисел, точно такая как в различных кнопочных окнах Blender'а. Для понимания всех параметров, обратитесь пожалуйста к справке по API. В основном там находятся: заголовок кнопки, события генерируемые кнопкой, её расположение (x,y), размеры (ширина, высота), значение, какие данные относятся к значению кнопки, минимальное и максимальное допустимые значения и текстовая строка, которая должна появлятся как всплывающая подсказка.

Строки (051-052) определяют числовую кнопку с полосой прокрутки, с очень похожим синтаксисом. Строки (055-056), наконец, создают кнопку выхода (Exit) , а ткаже кнопку прорисовки (Draw), которая создаст полигон.

Управление событиями.

Графический интерфейс пользователя не прорисовывается, и не работает, пока подходящее событие не прописано и не зарегистрировано. (Пример 3).

058 def event(evt, val): 
059 
if (evt == QKEY and not val): 
060 Exit()
061 
062 def bevent(evt):
063 
global T_NumberOfSides
064 global T_Radius
065 global EVENT_NOEVENT,EVENT_DRAW,EVENT_EXIT
066 

067 #########Управление событиями GUI
068 if (evt == EVENT_EXIT): 
069 
Exit()
070 elif (evt== EVENT_DRAW):
071 Polygon(T_NumberOfSides.val, T_Radius.val)
072 
Blender.Redraw()
073 
074 Register(draw, event, bevent)
075
 
 

Строки (058-060) определяют контроллер событий, соответствующий быстрой клавише (QKEY) вызова функции Exit().

Больше интересного в строках (062-072), отвечающих за события интерфейса. Каждый раз кнопка интерфейса пользователя используется для вызова этой функции, с номером события, определённым в качестве параметра. Суть этой функции в "выборе" структуры, выполняющей код соответствующий номеру события.

И последнее - это вызов функции Register. Она эффективно прорисовывает и запускает цикл перехвата событий.

Управление мешем

И наконец, Пример 4 показывает главную функцию, которая создаёт полигон. Это хотя и простое редактирование мешев, но показывает много важных моментов внутренней структуры данных Blender'а.

076 ######################################################
077 
# Главная часть
078 ######################################################
079 
def Polygon(NumberOfSides,Radius):
080
081 ######### Создание нового меша
082	
poly = NMesh.GetRaw()
083
084 ######### Размещение в нём вешин
085 for 
i in range(0,NumberOfSides):
086 phi = 3.141592653589 * 2 * i 
087 x = Radius 
* cos(phi)
088 y = Radius * sin(phi)
089 z = 0
090 
091 v = NMesh.Vert(x,y,z)
092	
poly.verts.append(v)
093
094 #########Добавление новой вершины в центр
095	
v = NMesh.Vert(0.,0.,0.)
096 poly.verts.append(v)
097
098 #########Присоеденение 
вершин к граням формы
099 for i in range(0,NumberOfSides):
100 f = NMesh.Face()
101	
f.v.append(poly.verts[i]) 
102 f.v.append(poly.verts[(i+1)%NumberOfSides]) 

103 f.v.append(poly.verts[NumberOfSides])
104 poly.faces.append(f)
105	

106 #########Создание нового объекта из нового меша
107 polyObj = NMesh.PutRaw(poly)
108
109	
Blender.Redraw()
 
 

Первая важная строка здесь (082). Это создание нового меш-объекта, в переменной poly. Меш-объект состоит из списка вершин и граней, плюс ещё некоторое интересное содержимое. Для наших целей нам нужны только списки вершин и граней.

Конечно только что созданный меш является пустым. Первый цикл (строки 085-092) задаёт положение x,y,z и количество вершин, необходимое для определения полигона. Т.к. это плоская фигура значение z везде равно 0.

Строка (091) вызывает метод Vert из модуля NMesh для создания нового вершинного объекта для координат (x,y,z). Такой объект добавляется (строка 096) в список вершин меш-объекта.

Наконец (строки 095-096) последняя вершина добавляется в центр.

Строки (099-104) соеденяют эти вершины, чтобы создать грани. Не обязательно создавать все вершины заранее, а только потом грани. Вы можете безопасно создавать новые грани как только все вершины необходимые для них созданы.

Строка (100) создаёт новый объект грани. Объект грани имеет свой собственный список вешин v, определяющий его. Строки (101-103) добавляют три вершины к первоначально пустому списку f.v. Две из этих вершин - это последующие вершины полигона, а третья центральная. Эти вершины должны быть взяты из списка вершин меш-объекта. Наконец строка (104) добавляет только что созданную грань к списку граней нашего меш-объектаpoly mesh.

Завершение

Если вы создадите файл polygon.py, содержащий вышеописаный код и загрузите его в текстовое окно Blender'а, как вы научились в предыдущем разделе, и нажмёте ALT-P в этом окне, чтобы запустить скрипт, вы увидите, что скрипт исчезнет и окно станет серым. В левом нижнем углу будет нарисован элемент управления (Рис 2).

Выбрав, например, 5 вершин и радиус равный 0.5, а потом нажав кнопку Draw появится пятиугольник в плоскости xy окна трёхмерного вида (Рис 3).