UK:HowTo:Use POV-Ray with Blender/Developers - Revision history

Maurice at 14:03, 2 March 2025

2025-03-02T14:03:15Z

Maurice: /* Використовуйте «спробувати/крім» помірно */

2025-03-02T14:00:13Z

Використовуйте «спробувати/крім» помірно

Maurice: /* C++ */

2025-03-02T13:54:19Z

C++

Show changes

Maurice at 10:17, 2 March 2025

2025-03-02T10:17:51Z

Show changes

Maurice at 09:44, 2 March 2025

2025-03-02T09:44:45Z

Maurice at 20:44, 1 March 2025

2025-03-01T20:44:17Z

Maurice: Created page with "Доповнення Blender до POV-Ray і навпаки (він же «POV@Ble») починалося як єдиний файл Python. Щоб бути сумісним..."

2025-03-01T20:41:07Z

Created page with "Доповнення Blender до POV-Ray і навпаки (він же «POV@Ble») починалося як єдиний файл Python. Щоб бути сумісним..."

New page

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

===bpy===
У Blender є вбудований інтерпретатор Python, який завантажується під час запуску Blender і залишається активним, поки Blender працює. Цей інтерпретатор запускає сценарії для малювання інтерфейсу користувача, а також використовується для деяких внутрішніх інструментів Blender. Вбудований інтерпретатор Blender надає типове середовище Python, тому код із навчальних посібників про те, як писати сценарії Python, також можна запускати за допомогою інтерпретатора Blender. Blender надає свої Python [https://docs.python.org/3/tutorial/modules.html модулі], такі як ''bpy'' і ''mathutils'', для вбудованого інтерпретатора, щоб їх можна було імпортувати в сценарій і надати доступ до даних, класів і функцій Blender. Сценарії, які працюють з даними Blender, повинні будуть '''імпортувати''' модулі для роботи. Таким чином, з усіх модулів, якщо немає іншого, bpy зазвичай завжди імпортується в сценарії blender. (за винятком інтерактивної консолі, де це імпортування виконується автоматично для зручності)
{| style="width:100%" border="0"
|[[Файл:Blender-interactive-console.png|рамка|ліворуч|Інтерактивна консоль Blender]]
|}
<br/>

===Метадані надбудови===
<джерело 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 загальна інформація про додаток визначалася в [https://docs.python.org/3/tutorial/datastructures.html#dictionaries словнику] з назвою <source lang="py">bl_info</source>
Кожен «ключ» цього словника надавав Blender певну інформацію про додаток, хоча не всі були однаково важливими. Більшість інформації використовувалося в діалоговому вікні налаштувань користувача та допомагало користувачеві знайти та вибрати доповнення.

<source lang="py">name</source>
Тип кодової назви для надбудови, під якою вона згадується в джерелі Blender... (Назва інтерфейсу користувача може вказувати щось інше)
<source lang="py">автор</source>
Якщо ви зробите внесок, вам буде зараховано тут!
<source lang="py">версія</source>
Версія надбудови.
Будь-яка схема нумерації дійсна, якщо вона є кортежем із трьох цілих чисел.
Бажано перемістити лише останню позицію, але пізніше ми можемо вибрати більш структуровану схему.
<source lang="py">блендер</source>
Мінімальна версія Blender, необхідна для цього доповнення. Знову кортеж із трьох цілих чисел. Навіть якщо ви очікуєте, що все працюватиме зі старішою та новішою версіями, може бути гарною ідеєю вказати найранішу версію, з якою ви насправді тестували свій додаток! Розробка з чимось досить стабільним є важливою, а потім тестуйте з останньою версією безпосередньо перед фіксацією, але зазвичай не оновлюйте номер сумісної версії тоді, лише коли щось зламається на цьому етапі.
<source lang="py">категорія</source>
Категорія в налаштуваннях користувача, у якій згруповано наш додаток. Він працює з механізмами, сумісними з POV, які є рендерерами, тому історично було сенс додати його до категорії Render. На жаль, це не відображає багатоцільовий характер, який він зрештою вирощував (наприклад, доставлений імпортер, підсвічування синтаксису текстового редактора тощо...) Якщо можливо кілька категорій, можливо, нам слід додати їх.
<source lang="py">місцезнаходження</source>
Де знайти доповнення після його ввімкнення. Це може бути посилання на певну панель або внутрішній корпус, опис її розташування в меню.
<source lang="py">опис</source>
Короткий опис того, що робить додаток.
<source lang="py">попередження</source>
Якщо це не порожній рядок, надбудова відображатиметься з попереджувальним знаком у налаштуваннях користувача. Ви можете використовувати це, щоб, наприклад, позначити додаток як експериментальний.
<source lang="py">doc_url</source>
публічна онлайн-документація, це похідна від роботи, що тут відбувається. Це буде пункт, який можна натиснути в налаштуваннях користувача.
<source lang="py">tracker_url</source>
Додаток POV, будучи частиною Blender, має власний запис трекера помилок, пов’язаний із ним, і цей ключ надасть вказівник на нього.

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

@@ Line 12: / Line 12: @@
 <table width=100% border=0 cellspacing=0 cellpadding=5>
 <tr><td width=33% bgcolor=#EEEEEF>
-<font size="+2">[[HowTo:Use_POV-Ray_with_Blender/Developers|▼ Developer's page]]</font>
+<font size="+2">[[HowTo:Use_POV-Ray_with_Blender/Developers|▼ Сторінка розробника]]</font>
 </td>
 <td width=33% align=center>[[File:POVExporterLogo.png|center|100px|link=https://extensions.blender.org/add-ons/povable]]</td>
 <td width=33% bgcolor=#EEEEEF align=right>
-<font size="+2">[[HowTo:Use_POV-Ray_with_Blender|Go To User's page ►]]</font></td></tr>
+<font size="+2">[[HowTo:Use_POV-Ray_with_Blender|Перейти на сторінку користувача ►]]</font></td></tr>
 </table>
 <!--</wikinav>--->

@@ Line 316: / Line 316: @@
 Хороший спосіб видалити деякі з ваших ''try'' ... ''окрім'' випадків, коли виявлена помилка виявляється '''AttributeError''', це замінити їх тестом вище за течією за допомогою функції ''hasattr()'':
 <syntaxhighlight lang="python3">
-для члена в dir(properties_freestyle):
+for member in dir(properties_freestyle):
- підклас = getattr(properties_freestyle, член)
+    subclass = getattr(properties_freestyle, member)
- спробуйте:
+    try:
- subclass.COMPAT_ENGINES.add('POVRAY_RENDER')
+        subclass.COMPAT_ENGINES.add('POVRAY_RENDER')
- крім:
+    except:
- пропуск
+        pass
 </syntaxhighlight>
 міг тоді стати
 <syntaxhighlight lang="python3">
-для члена в dir(properties_freestyle):
+for member in dir(properties_freestyle):
- підклас = getattr(properties_freestyle, член)
+   subclass = getattr(properties_freestyle, member)
- if hasattr(підклас, "COMPAT_ENGINES"):
+   if hasattr(subclass, "COMPAT_ENGINES"):
-subclass.COMPAT_ENGINES.add('POVRAY_RENDER')
+       subclass.COMPAT_ENGINES.add('POVRAY_RENDER')
 </syntaxhighlight>
 Якщо вам потрібно використовувати ''try:''... ''except:''... не залишайте тип винятку невизначеним, це не дає жодного зворотного зв’язку чи читабельності коду. Натомість, якщо ви не знаєте, що це може бути, замініть його чимось, що дасть більше інформації під час фази налагодження:
@@ Line 336: / Line 336: @@
 <syntaxhighlight lang="python3">
 def your_function(b, c):
- спробуйте:
+    try:
- a = b + c
+        a = b + c
- повертає True
+        return True
- крім BaseException як e:
+    except BaseException as e:
- надрукувати (e.__doc__)
+        print(e.__doc__)
- print('Сталася виняток: {}'.format(e))
+        print('An exception occurred: {}'.format(e))
- повернути False
+        return False
 </syntaxhighlight>

@@ Line 1: / Line 1: @@
 {{OtherLang
-   | title=HowTo: Use POV-Ray with Blender (Developers page)
+   | title=Як: використовувати POV-Ray із Blender (сторінка розробника)
    | en=HowTo:Use_POV-Ray_with_Blender/Developers
    | fr=FR:HowTo:Use_POV-Ray_with_Blender/Developers

← Older revision		Revision as of 20:44, 1 March 2025
Line 1:		Line 1:
		+	{{OtherLang
		+	\| title=HowTo: Use POV-Ray with Blender (Developers page)
		+	\| en=HowTo:Use_POV-Ray_with_Blender/Developers
		+	\| fr=FR:HowTo:Use_POV-Ray_with_Blender/Developers
		+	\| it=IT:HowTo:Use_POV-Ray_with_Blender/Developers
		+	\| uk=UK:HowTo:Use_POV-Ray_with_Blender/Developers
		+	}}
		+
		+
		+	<!--<wikinav>--->
		+	<br>
		+	<table width=100% border=0 cellspacing=0 cellpadding=5>
		+	<tr><td width=33% bgcolor=#EEEEEF>
		+	<font size="+2">[[HowTo:Use_POV-Ray_with_Blender/Developers\|▼ Developer's page]]</font>
		+	</td>
		+	<td width=33% align=center>[[File:POVExporterLogo.png\|center\|100px\|link=https://extensions.blender.org/add-ons/povable]]</td>
		+	<td width=33% bgcolor=#EEEEEF align=right>
		+	<font size="+2">[[HowTo:Use_POV-Ray_with_Blender\|Go To User's page ►]]</font></td></tr>
		+	</table>
		+	<!--</wikinav>--->
		+
		+	<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3" align=center>
		+	*[http://povray.org POV-Ray Site]
		+	*[[HowTo:Use_POV-Ray_with_Blender#Quick_Start\|Exporter Quick Start]]
		+	*[http://povray.org/documentation/3.7.0/ POV-Ray Documentation]
		+	*[[HowTo:Use_POV-Ray_with_Blender/Sample_Materials\| Sample Materials]]
		+	*[[Media:POV WORKSPACE 1.blend\|POV-Ray centric default workspace]]
		+	*---
		+	*---
		+	*---
		+	*---
		+	*---
		+	*---
		+	*---
		+	*---
		+	*design ideas
		+	*[[Media:regression and test blendfiles.zip\|regression files]]
		+	</div>
		+
		+	<br>
		+	<div class="clearBoth"></div>
		+	<div style="text-align:center; border-top: grey solid 1px;">
		+	<ul style="font-size:1.1em; list-style-type:none;"><li><font size="+2">[http://developer.blender.org/diffusion/BA/history/master/render_povray/ Latest News]</font size="+2"></li>
		+	<li>[irc://irc.freenode.org/blenderpovray Chat room, IRC: #blenderpovray at freenode]</li>
		+	<li>[http://git.blender.org/gitweb/gitweb.cgi/blender-addons.git/atom/refs/heads/master?f=render_povray RSS feed]</li>
		+	<li>[http://blenderartists.org/forum/group.php?groupid=79 Forum Group]</li></ul>
		+	</div>
		+
	Доповнення Blender до POV-Ray і навпаки (він же «POV@Ble») починалося як єдиний файл Python.		Доповнення Blender до POV-Ray і навпаки (він же «POV@Ble») починалося як єдиний файл Python.
	Щоб бути сумісним із системою упаковки доповнень Blender, це доповнення мало:		Щоб бути сумісним із системою упаковки доповнень Blender, це доповнення мало: