HowTo: Use POV-Ray with Blender (Developers page)

From POV-Wiki
Revision as of 20:44, 1 March 2025 by Maurice (talk | contribs)
Jump to navigation Jump to search




▼ Developer's page

POVExporterLogo.png
Go To User's page ►


Доповнення Blender до POV-Ray і навпаки (він же «POV@Ble») починалося як єдиний файл Python. Щоб бути сумісним із системою упаковки доповнень Blender, це доповнення мало:

  • надайте деяку загальну інформацію про додаток: його назву та версію,
  • визначте деякий код для виконання дій, переважно через «оператори» або «функції»
  • і переконайтеся, що вони зареєстровані, щоб ними можна було користуватися.


bpy

У Blender є вбудований інтерпретатор Python, який завантажується під час запуску Blender і залишається активним, поки Blender працює. Цей інтерпретатор запускає сценарії для малювання інтерфейсу користувача, а також використовується для деяких внутрішніх інструментів Blender. Вбудований інтерпретатор Blender надає типове середовище Python, тому код із навчальних посібників про те, як писати сценарії Python, також можна запускати за допомогою інтерпретатора Blender. Blender надає свої Python модулі, такі як bpy і mathutils, для вбудованого інтерпретатора, щоб їх можна було імпортувати в сценарій і надати доступ до даних, класів і функцій Blender. Сценарії, які працюють з даними Blender, повинні будуть імпортувати модулі для роботи. Таким чином, з усіх модулів, якщо немає іншого, bpy зазвичай завжди імпортується в сценарії blender. (за винятком інтерактивної консолі, де це імпортування виконується автоматично для зручності)

рамка|ліворуч|Інтерактивна консоль Blender


Метадані надбудови

<джерело lang="py"> bl_info = {

"name": "Стійкість зору",
"автор": "Кемпбелл Бартон, "
«Моріс Рейбо»,
«Леонід Десятков»
«Бастьєн Монтань»,
«Константін Ран»
«Сільвіо Фальчінеллі»,
"версія": (0, 1, 1),
"блендер": (2, 81, 0),
"location": "Властивості візуалізації > Механізм візуалізації > Постійність зору",
"description": "Постійність інтеграції Vision для blender",
"doc_url": "{BLENDER_MANUAL_URL}/addons/render/povray.html",
"category": "Відобразити",
"warning": "В стадії активної розробки, шукає супроводжувач(ів)",

} </джерело>


До Blender 4.2 загальна інформація про додаток визначалася в словнику з назвою

bl_info

Кожен «ключ» цього словника надавав Blender певну інформацію про додаток, хоча не всі були однаково важливими. Більшість інформації використовувалося в діалоговому вікні налаштувань користувача та допомагало користувачеві знайти та вибрати доповнення.

name

Тип кодової назви для надбудови, під якою вона згадується в джерелі Blender... (Назва інтерфейсу користувача може вказувати щось інше)

автор

Якщо ви зробите внесок, вам буде зараховано тут!

версія

Версія надбудови. Будь-яка схема нумерації дійсна, якщо вона є кортежем із трьох цілих чисел. Бажано перемістити лише останню позицію, але пізніше ми можемо вибрати більш структуровану схему.

блендер

Мінімальна версія Blender, необхідна для цього доповнення. Знову кортеж із трьох цілих чисел. Навіть якщо ви очікуєте, що все працюватиме зі старішою та новішою версіями, може бути гарною ідеєю вказати найранішу версію, з якою ви насправді тестували свій додаток! Розробка з чимось досить стабільним є важливою, а потім тестуйте з останньою версією безпосередньо перед фіксацією, але зазвичай не оновлюйте номер сумісної версії тоді, лише коли щось зламається на цьому етапі.

категорія

Категорія в налаштуваннях користувача, у якій згруповано наш додаток. Він працює з механізмами, сумісними з POV, які є рендерерами, тому історично було сенс додати його до категорії Render. На жаль, це не відображає багатоцільовий характер, який він зрештою вирощував (наприклад, доставлений імпортер, підсвічування синтаксису текстового редактора тощо...) Якщо можливо кілька категорій, можливо, нам слід додати їх.

місцезнаходження

Де знайти доповнення після його ввімкнення. Це може бути посилання на певну панель або внутрішній корпус, опис її розташування в меню.

опис

Короткий опис того, що робить додаток.

попередження

Якщо це не порожній рядок, надбудова відображатиметься з попереджувальним знаком у налаштуваннях користувача. Ви можете використовувати це, щоб, наприклад, позначити додаток як експериментальний.

doc_url

публічна онлайн-документація, це похідна від роботи, що тут відбувається. Це буде пункт, який можна натиснути в налаштуваннях користувача.

tracker_url

Додаток POV, будучи частиною Blender, має власний запис трекера помилок, пов’язаний із ним, і цей ключ надасть вказівник на нього.

Коментарі

Однорядкові коментарі починаються з символу решетки (#), відразу після якого йде пробіл, і коментар починається з великої літери, але не закінчується крапкою. Їх можна додати після досить короткого рядка коду (залиште один порожній простір перед #).