Макропрограммирование K3 в Python - История изменений

Aleksandr Dragunkin в 16:28, 19 февраля 2025

2025-02-19T16:28:36Z

← Предыдущая версия		Версия от 19:28, 19 февраля 2025
Строка 1:		Строка 1:
	[[Категория:Макро\|*]]		[[Категория:Макро\|*]]
			[[Файл:Button2 py processed.png\|128px\|слева]]
	===Общие принципы===		===Общие принципы===

Aleksandr Dragunkin: /* Вызов сторонней макропрограммы (команда macro) */

2025-02-19T07:42:59Z

Вызов сторонней макропрограммы (команда macro)

← Предыдущая версия		Версия от 10:42, 19 февраля 2025
Строка 200:		Строка 200:
	}}		}}
	}}		}}

	=== Библиотека k3utils ===		=== Библиотека k3utils ===
	''Файл'' '''k3utils.py'''		''Файл'' '''k3utils.py'''

Aleksandr Dragunkin в 20:42, 18 февраля 2025

2025-02-18T20:42:12Z

@@ Строка 174: / Строка 174: @@
 {{Внимание| Версии программы до 09.10.2024 поддерживают только передачу параметров по ссылке (<code>byref</code>)! }}
 === Библиотека k3utils ===
 ''Файл'' '''k3utils.py'''

Aleksandr Dragunkin в 20:20, 18 февраля 2025

2025-02-18T20:20:13Z

← Предыдущая версия		Версия от 23:20, 18 февраля 2025
Строка 287:		Строка 287:
	===Пример программы для К3-Мебель на Python===		===Пример программы для К3-Мебель на Python===
	{{python\|		{{python\|

	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
	# -- coding: utf-8 --		# -- coding: utf-8 --

Aleksandr Dragunkin в 20:09, 18 февраля 2025

2025-02-18T20:09:01Z

← Предыдущая версия		Версия от 23:09, 18 февраля 2025
Строка 154:		Строка 154:
	и т.д.		и т.д.

			{{Идея\|
	В отличие от макропрограммы в Python при вызове '''getpar''' не объявляется явно количество значений, которые мы собираемся получить.		В отличие от макропрограммы в Python при вызове '''getpar''' не объявляется явно количество значений, которые мы собираемся получить.
			}}
	{{#seo:		{{#seo:
	\|title=Макропрограммирование К3 в Python {{!}} База знаний		\|title=Макропрограммирование К3 в Python {{!}} База знаний
Строка 171:		Строка 172:
	Здесь первый параметр передаётся по ссылке (ключ <code>byref</code>), поэтому он должен быть переменной '''K3''', второй параметр передаётся по значению (ключ <code>byval</code>), поэтому это обычная переменная с некоторым значением.		Здесь первый параметр передаётся по ссылке (ключ <code>byref</code>), поэтому он должен быть переменной '''K3''', второй параметр передаётся по значению (ключ <code>byval</code>), поэтому это обычная переменная с некоторым значением.

	~~<u>~~Внимание~~:</u>~~ Версии программы до 09.10.2024 поддерживают только передачу параметров по ссылке (<code>byref</code>)!		{{Внимание\| Версии программы до 09.10.2024 поддерживают только передачу параметров по ссылке (<code>byref</code>)! }}

	=== Библиотека k3utils ===		=== Библиотека k3utils ===
Строка 285:		Строка 286:

	===Пример программы для К3-Мебель на Python===		===Пример программы для К3-Мебель на Python===
			{{python\|

	<syntaxhighlight lang="python" line>		<syntaxhighlight lang="python" line>
	# -- coding: utf-8 --		# -- coding: utf-8 --
Строка 317:		Строка 320:
	k3.putmsg(f'На слой Possible_Errors отправлено {errnum} объектов')		k3.putmsg(f'На слой Possible_Errors отправлено {errnum} объектов')
	</syntaxhighlight>		</syntaxhighlight>
			}}
	В основном теле программы создаётся новый слой командой '''layers''' с ключом '''new''', затем идёт перебор всех объектов функцией '''getobjnums'''.		В основном теле программы создаётся новый слой командой '''layers''' с ключом '''new''', затем идёт перебор всех объектов функцией '''getobjnums'''.

Aleksandr Dragunkin в 19:45, 18 февраля 2025

2025-02-18T19:45:55Z

← Предыдущая версия		Версия от 22:45, 18 февраля 2025
Строка 4:		Строка 4:
	Команда macro в '''К3''' может запускать два типа файлов – макропрограмму '''k3''' (файл '''.mac''') и макропрограмму на '''Python''' (файл '''.py'''). Расширение файла показывает системе, какой интерпретатор использовать.		Команда macro в '''К3''' может запускать два типа файлов – макропрограмму '''k3''' (файл '''.mac''') и макропрограмму на '''Python''' (файл '''.py'''). Расширение файла показывает системе, какой интерпретатор использовать.

	Также в '''К3''' есть возможность вставить блок кода на '''Python''' внутрь файла '''.mac'''. Для ~~этого~~ необходимо воспользоваться конструкцией		Также в '''К3''' есть возможность вставить блок кода на '''Python''' внутрь файла '''.mac'''.
			{{macro\| Для вставки блока кода на языке '''Python''' необходимо воспользоваться конструкцией:
			<syntaxhighlight lang="html">
	<?python		<?python
	…		…
	?>		?>
			</syntaxhighlight>

			Например так:

			<syntaxhighlight lang="python" line highlight="3,9">
			key_ecd=0;
			//исключаем из анализа зависимости типа створки например шлегель unitcode=6900
			<?python
			import k3
			key_elemcode=k3.Var("key_ecd")
			elem_code=k3.GlobalVar("ElemCode")
			if elem_code.value in ("6900",):
			key_elemcode.value=1
			?>
			if key_ecd==1 {
			goto end;
			}
			</syntaxhighlight>
			}}
	Для всех строчек кода внутри будет использоваться интерпретатор <code>python</code>.		Для всех строчек кода внутри будет использоваться интерпретатор <code>python</code>.

Aleksandr Dragunkin в 19:20, 18 февраля 2025

2025-02-18T19:20:50Z

← Предыдущая версия		Версия от 22:20, 18 февраля 2025
Строка 53:		Строка 53:
	построит линию от точки '''0''' до точки, введённой пользователем в интерактивном режиме.		построит линию от точки '''0''' до точки, введённой пользователем в интерактивном режиме.

	{~~\| class="prettytable"~~		{{Идея
	\|-
	~~\|valign="top"\|[[image:eksklamacia.png]]~~
	\|'''Функции К3, запущенные через библиотеку К3 в Python, всегда возвращают числа в формате с плавающей точкой (double). Поэтому часто для дальнейшего использования их нужно перевести в целое, например'''		\|'''Функции К3, запущенные через библиотеку К3 в Python, всегда возвращают числа в формате с плавающей точкой (double). Поэтому часто для дальнейшего использования их нужно перевести в целое, например'''

Строка 63:		Строка 61:

	<code>k3.'''getobjnum'''('''int'''(k3.'''sysvar'''(''60'')))</code>		<code>k3.'''getobjnum'''('''int'''(k3.'''sysvar'''(''60'')))</code>
	\|}		}}

	===Переменные и массивы K3===		===Переменные и массивы K3===
Строка 99:		Строка 97:
	Здесь <code>''<length>''</code> — это длина будущего массива, а <code>''<name>''</code> — его имя в K3.		Здесь <code>''<length>''</code> — это длина будущего массива, а <code>''<name>''</code> — его имя в K3.

	{~~\| class="prettytable"~~		{{Идея
	\|-
	~~\|valign="top"\|[[image:eksklamacia.png]]~~
	\|'''Не забывайте, что хотя Python может работать с динамическими списками, массивы K3 – статические, то есть содержат ровно столько элементов, какая длина указана при создании.'''		\|'''Не забывайте, что хотя Python может работать с динамическими списками, массивы K3 – статические, то есть содержат ровно столько элементов, какая длина указана при создании.'''
	\|}		}}

	С точки зрения Python объект <code>VarArray</code> — это список объектов типа '''Var''', каждый из которых – один элемент массива, например		С точки зрения Python объект <code>VarArray</code> — это список объектов типа '''Var''', каждый из которых – один элемент массива, например

Aleksandro: /* Вызов сторонней макропрограммы (команда macro) */

2024-10-16T12:53:43Z

Вызов сторонней макропрограммы (команда macro)

← Предыдущая версия		Версия от 15:53, 16 октября 2024
Строка 147:		Строка 147:
	}}		}}

	=== Вызов сторонней макропрограммы (команда macro) ===		=== Вызов сторонней макропрограммы (команда '''macro''') ===
	Для вызова сторонней макропрограммы из скрипта на '''Python''' нужно передать в аргументы функции строку с путём и именем файла и список из передаваемых значений и ключей <code>byref</code> или <code>byval</code>		Для вызова сторонней макропрограммы из скрипта на '''Python''' нужно передать в аргументы функции строку с путём и именем файла и список из передаваемых значений и ключей <code>byref</code> или <code>byval</code>

Aleksandro: /* Вызов сторонней макропрограммы (команда macro) */

2024-10-16T12:53:34Z

Вызов сторонней макропрограммы (команда macro)

← Предыдущая версия		Версия от 15:53, 16 октября 2024
Строка 148:		Строка 148:

	=== Вызов сторонней макропрограммы (команда macro) ===		=== Вызов сторонней макропрограммы (команда macro) ===
	Для вызова сторонней макропрограммы из скрипта на '''Python''' нужно передать в аргументы функции строку с путём и именем файла и список из передаваемых значений и ключей byref или byval		Для вызова сторонней макропрограммы из скрипта на '''Python''' нужно передать в аргументы функции строку с путём и именем файла и список из передаваемых значений и ключей <code>byref</code> или <code>byval</code>

	Например:		Например:

	k3.macro(‘my_macro.mac’, [k3.k_byref, k3_var1, k3.k_byval, var2], k3.k_done)		<code>k3.'''macro'''(‘my_macro.mac’, [k3.k_byref, k3_var1, k3.k_byval, var2], k3.k_done)</code>

	Здесь первый параметр передаётся по ссылке (ключ byref), поэтому он должен быть переменной к3, второй параметр передаётся по значению (ключ byval), поэтому это обычная переменная с некоторым значением.		Здесь первый параметр передаётся по ссылке (ключ <code>byref</code>), поэтому он должен быть переменной '''K3''', второй параметр передаётся по значению (ключ <code>byval</code>), поэтому это обычная переменная с некоторым значением.

	<u>Внимание:</u> Версии программы до 09.10.2024 поддерживают только передачу параметров по ссылке (byref)!		<u>Внимание:</u> Версии программы до 09.10.2024 поддерживают только передачу параметров по ссылке (<code>byref</code>)!

	=== Библиотека k3utils ===		=== Библиотека k3utils ===

Aleksandro: /* Библиотека k3utils */

2024-10-16T12:52:26Z

Библиотека k3utils

@@ Строка 146: / Строка 146: @@
 |keywords=К3-Мебель, кз-мебель, k3-mebel, К3-Коттедж, кз-коттедж, k3-cottage, К3-Ship, кз-ship, k3-ship, инструкция, база знаний, online руководство, обучение, k3makro wiki, макро, макропрограммирование, макропрограммы, Python, питон, Питон
 }}
 === Библиотека k3utils ===