Откатка и восстановление команд - История изменений

Aleksandro: Замена текста — « » на « »

2024-06-27T13:53:20Z

Замена текста — « » на « »

← Предыдущая версия		Версия от 16:53, 27 июня 2024
Строка 1:		Строка 1:
	[[Категория:Макро]]		[[Категория:Макро]]
	==Откатка команды==		==Откатка команды==
	Команда откатки '''undo''' имеет несколько режимов, представленных ниже.		Команда откатки '''undo''' имеет несколько режимов, представленных ниже.

Aleksandro в 14:13, 19 июня 2024

2024-06-19T14:13:30Z

← Предыдущая версия		Версия от 17:13, 19 июня 2024
Строка 10:		Строка 10:

	<code>'''undo''' off\|on</code>		<code>'''undo''' off\|on</code>


	Команда включает (<code>on</code>) или выключает (<code>off</code>) режим откатки.		Команда включает (<code>on</code>) или выключает (<code>off</code>) режим откатки.
Строка 29:		Строка 28:
	\|'''Следует иметь ввиду, что откатка распространяется на элементарные команды, а не на макрокоманды, состоящие из нескольких (десятки, сотни и более) элементарных команд'''		\|'''Следует иметь ввиду, что откатка распространяется на элементарные команды, а не на макрокоманды, состоящие из нескольких (десятки, сотни и более) элементарных команд'''
	\|}		\|}


	==Восстановление команды==		==Восстановление команды==

Aleksandro в 14:27, 1 сентября 2021

2021-09-01T14:27:14Z

← Предыдущая версия		Версия от 17:27, 1 сентября 2021
Строка 1:		Строка 1:
	[[Категория:Макро]]		[[Категория:Макро]]
	~~{{Макро}}~~
	~~----~~
	==Откатка команды==		==Откатка команды==
	Команда откатки '''undo''' имеет несколько режимов, представленных ниже.		Команда откатки '''undo''' имеет несколько режимов, представленных ниже.

Aleksandro в 14:27, 1 сентября 2021

2021-09-01T14:27:06Z

← Предыдущая версия		Версия от 17:27, 1 сентября 2021
Строка 1:		Строка 1:
	[[Категория:Макро]]		[[Категория:Макро]]
			{{Макро}}
			----
	==Откатка команды==		==Откатка команды==
	Команда откатки '''undo''' имеет несколько режимов, представленных ниже.		Команда откатки '''undo''' имеет несколько режимов, представленных ниже.
Строка 36:		Строка 38:

	Команда '''redo''' отменяет откатку, выполненную командой '''undo'''. Параметр <code>''<N>''</code> задает число команд откатки. По умолчанию восстанавливается одна последняя команда.		Команда '''redo''' отменяет откатку, выполненную командой '''undo'''. Параметр <code>''<N>''</code> задает число команд откатки. По умолчанию восстанавливается одна последняя команда.
			----
			{{Макро}}

Aleksandro: /* Изменение режима трассировки макропрограмм */

2021-09-01T14:26:37Z

Изменение режима трассировки макропрограмм

← Предыдущая версия		Версия от 17:26, 1 сентября 2021
Строка 36:		Строка 36:

	Команда '''redo''' отменяет откатку, выполненную командой '''undo'''. Параметр <code>''<N>''</code> задает число команд откатки. По умолчанию восстанавливается одна последняя команда.		Команда '''redo''' отменяет откатку, выполненную командой '''undo'''. Параметр <code>''<N>''</code> задает число команд откатки. По умолчанию восстанавливается одна последняя команда.

	~~==Изменение режима трассировки макропрограмм==~~
	~~<code>'''MacroMode''' keys</code>~~

	Команда '''MacroMode''' включает/отключает/меняет состояние режима трассировки макропрограмм в зависимости от установленных ключей <code>Keys</code>.

	~~Возможные состояния ключей <code>keys</code>:~~


	~~<code>'''MacroMode '''Trace {on\|off}</code>~~

	~~Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние трассировки макропрограмм.~~


	~~[[Файл:Parametroj-S21.png\|thumb\|right\|380px\|Режимы отладки макропрограмм]]~~
	~~<code>'''MacroMode '''ShowError {on\|off}</code>~~

	Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние режима показа места (строки) ошибок в макропрограмме.

	Также существует возможность управлять выводом в командное окно выполненных строк макропрограммы. Этот режим значительно замедляет работу макропрограмм, но позволяет отследить ее исполнение. Дополнительно к этому существует возможность управлять выводом диагностических сообщений в командное окно.

	~~<code>'''MacroMode''' Debug {on\|off}</code>~~

	Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние режима разработчика макропрограмме. Если режим разработчика включен, то при каждом новом запуске макропрограммы, она читается с диска. Если выключен, то единожды запущенная макропрограмма остается во внутреннем кэше и читается оттуда. Таким образом, если разработчик в процессе работы вносит изменения в макропрограмму, то изменения не будут выполнены (запускается предыдущий вариант макропрограммы из кэша). Но при запуске макропрограммы из кэша не тратится время на чтение с диска и скорость работы выше.

	~~{\| class="prettytable"~~
	\|-
	~~\|valign="top"\|[[image:i.png]]~~
	\|''Узнать текущую установку вывода диагностических сообщений и трассировки макропрограмм можно с помошью системной функции ''[[Функции работы с системой#Запрос у системы различной информации\|sysvar(78)]]
	\|}


	~~<code>'''MacroMode '''<nowiki>Undo { Off [Clear] \| On }</nowiki></code>~~

	~~Ключ включает (<code>On</code>) или выключает (<code>Off</code>) режим откатки.~~

	~~Выключение режима откатки возможно с очисткой буфера откаток (необязательный ключ <code>Clear</code>).~~


	~~<code>'''MacroMode '''Undo On ''<Name>'' ''<ObjectCreate>''<nowiki> [</nowiki>''<ObjectDelete>'']</code>~~

	Включенный режим откатки позволяет ввести имя откатки (параметр <code>''<Name>''</code>), а также зарегистрировать создание объекта <code>''<ObjectCreate></code> ''и удаление объекта <code>''<ObjectDelete>''</code>. Объекты <code>''<ObjectCreate></code> ''и <code>''<ObjectDelete>''</code> обязательно должны быть объектами верхнего уровня. Этот вариант применим только в том случае, если макропрограмма создает один новый объект или заменяет один объект на другой.
	~~[[Файл:Undo.png\|thumb\|right\|210px\|<Name> = "ObjectsTree"]]~~
	~~Имя <Name> задает строку, которая выводится в командное окно при выполнении откатки (см. рисунок)~~


	~~<code>'''MacroMode '''Undo On ''<Name> ''All </code>~~

	Если используется ключ <code>All</code>, то в откатке регистрируются все объекты. Этот вариант применим в случае, если макро создает все объекты сцены


	~~<code>'''MacroMode''' Undo Start</code>~~

	~~Начать накопление счетчика откаток во время выполнения макропрограммы.~~


	~~<code>'''MacroMode''' Undo Stop <Name></code>~~

	Закончить накопление счетчика откаток во время выполнения макропрограммы. Имя <code><Name></code> задает строку, которая выводится в командное окно при выполнении откатки.

	Последние две команды используются в макропрограммах, когда при старте макропрограммы нужно начать накопление откаток, а по окончании — завершить. В этом случае при выполнении откатки все команды между началом и завершением накопления счетчика откаток будут отменены за одну операцию.
	~~{\| class="prettytable"~~
	\|-
	~~\|valign="top"\|[[image:pluso.png]]~~
	\|Не рекомендуется использовать команды включения и выключения откатки неопытными пользователям. Неверное использование этих команд может привести к потере всех несохраненных данных и фатальной ошибке в работе программы.
	\|}


	~~<code>'''MacroMode '''Level<nowiki> [</nowiki>''<Level>'']</code>~~

	ключ устанавливает уровень выдачи сообщений <code>''<Level>''</code>. Если значение <code>''<Level>''</code> не задано, то возвращается текущий уровень выдачи сообщений

	~~Пример 1:~~
	~~// Выключить откатку без стирания буфера откаток~~
	~~#UndoOnBefore MacroMode Undo Off;~~
	~~// Включить откатку с регистрацией создания и удаления объектов верхнего уровня~~
	~~MacroMode Undo On "Otkatka" hCreate;~~

	~~Пример 2:~~
	~~macromode undo off;~~
	~~macro ProtoPath+"MakePan.mac" basep[1] basep[2] basep[3] xgab, ygab 12;~~
	~~objident last 1 polka;~~
	~~if (isvardef("polka")==16)~~
	{
	~~macromode undo on "Ug_Polka.mac" polka ;~~
	}
	~~else~~
	{
	~~macromode undo on;~~
	}


	~~<code>'''MacroMode '''LockHelp ''<Topic>''</code>~~

	~~Команда принудительно устанавливает тему справки для макропрограммы, где команда вызвана.~~

	~~<code>''<Topic>''</code> - идентификатор устанавливаемой темы – целое неотрицательное число.~~

	Если значение <code>''<Topic>''</code> = 0, то происходит снятие блокировки смены тем справки, иначе (<code>''<Topic>''</code> > 0) то устанавливается блокировка темы на все время выполнения макрокоманды. После любого выхода из макро в интерактив (нормального или аварийного), блокировка темы справки снимается.

	Суть команды в том, что внутри макропрограммы каждая выполняющаяся команда имеет свой указатель (тему) справки, которая зачастую не показывает сути всей макропрограммы. Так вот команда позволит не использовать указатели (темы) каждой из команд макропрограммы, а установить одну тему на всю макропрограмму.

Aleksandro: Новая страница: «Категория:Макро ==Откатка команды== Команда откатки '''undo''' имеет несколько режимов, пре...»

2021-07-28T20:06:25Z

Новая страница: «Категория:Макро ==Откатка команды== Команда откатки '''undo''' имеет несколько режимов, пре...»

Новая страница

[[Категория:Макро]]
==Откатка команды==
Команда откатки '''undo''' имеет несколько режимов, представленных ниже.

<code>'''undo''' ''<N>''</code>

Команда откатывает <code>''<N>''</code> последних выполненных команд

<code>'''undo''' off|on</code>

Команда включает (<code>on</code>) или выключает (<code>off</code>) режим откатки.

<code>'''undo''' bufsize ''<N>''</code>

Команда устанавливает величину буфера откатки равным <code>''<N>''</code> командам.

<code>'''undo''' clear</code>

Команда очищает буфер откатки.

{| class="prettytable"
|-
|valign="top"|[[image:eksklamacia.png]]
|'''Следует иметь ввиду, что откатка распространяется на элементарные команды, а не на макрокоманды, состоящие из нескольких (десятки, сотни и более) элементарных команд'''
|}

==Восстановление команды==

<code>'''redo'''<nowiki> [</nowiki>''<N>'']</code>

Команда '''redo''' отменяет откатку, выполненную командой '''undo'''. Параметр <code>''<N>''</code> задает число команд откатки. По умолчанию восстанавливается одна последняя команда.

==Изменение режима трассировки макропрограмм==
<code>'''MacroMode''' keys</code>

Команда '''MacroMode''' включает/отключает/меняет состояние режима трассировки макропрограмм в зависимости от установленных ключей <code>Keys</code>.

Возможные состояния ключей <code>keys</code>:

<code>'''MacroMode '''Trace {on|off}</code>

Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние трассировки макропрограмм.

[[Файл:Parametroj-S21.png|thumb|right|380px|Режимы отладки макропрограмм]]
<code>'''MacroMode '''ShowError {on|off}</code>

Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние режима показа места (строки) ошибок в макропрограмме.

Также существует возможность управлять выводом в командное окно выполненных строк макропрограммы. Этот режим значительно замедляет работу макропрограмм, но позволяет отследить ее исполнение. Дополнительно к этому существует возможность управлять выводом диагностических сообщений в командное окно.

<code>'''MacroMode''' Debug {on|off}</code>

Ключ включает (<code>on</code>) или выключает (<code>off</code>) состояние режима разработчика макропрограмме. Если режим разработчика включен, то при каждом новом запуске макропрограммы, она читается с диска. Если выключен, то единожды запущенная макропрограмма остается во внутреннем кэше и читается оттуда. Таким образом, если разработчик в процессе работы вносит изменения в макропрограмму, то изменения не будут выполнены (запускается предыдущий вариант макропрограммы из кэша). Но при запуске макропрограммы из кэша не тратится время на чтение с диска и скорость работы выше.

{| class="prettytable"
|-
|valign="top"|[[image:i.png]]
|''Узнать текущую установку вывода диагностических сообщений и трассировки макропрограмм можно с помошью системной функции ''[[Функции работы с системой#Запрос у системы различной информации|sysvar(78)]]
|}

<code>'''MacroMode '''<nowiki>Undo { Off [Clear] | On }</nowiki></code>

Ключ включает (<code>On</code>) или выключает (<code>Off</code>) режим откатки.

Выключение режима откатки возможно с очисткой буфера откаток (необязательный ключ <code>Clear</code>).

<code>'''MacroMode '''Undo On ''<Name>'' ''<ObjectCreate>''<nowiki> [</nowiki>''<ObjectDelete>'']</code>

Включенный режим откатки позволяет ввести имя откатки (параметр <code>''<Name>''</code>), а также зарегистрировать создание объекта <code>''<ObjectCreate></code> ''и удаление объекта <code>''<ObjectDelete>''</code>. Объекты <code>''<ObjectCreate></code> ''и <code>''<ObjectDelete>''</code> обязательно должны быть объектами верхнего уровня. Этот вариант применим только в том случае, если макропрограмма создает один новый объект или заменяет один объект на другой.
[[Файл:Undo.png|thumb|right|210px|<Name> = "ObjectsTree"]]
Имя <Name> задает строку, которая выводится в командное окно при выполнении откатки (см. рисунок)

<code>'''MacroMode '''Undo On ''<Name> ''All </code>

Если используется ключ <code>All</code>, то в откатке регистрируются все объекты. Этот вариант применим в случае, если макро создает все объекты сцены

<code>'''MacroMode''' Undo Start</code>

Начать накопление счетчика откаток во время выполнения макропрограммы.

<code>'''MacroMode''' Undo Stop <Name></code>

Закончить накопление счетчика откаток во время выполнения макропрограммы. Имя <code><Name></code> задает строку, которая выводится в командное окно при выполнении откатки.

Последние две команды используются в макропрограммах, когда при старте макропрограммы нужно начать накопление откаток, а по окончании — завершить. В этом случае при выполнении откатки все команды между началом и завершением накопления счетчика откаток будут отменены за одну операцию.
{| class="prettytable"
|-
|valign="top"|[[image:pluso.png]]
|Не рекомендуется использовать команды включения и выключения откатки неопытными пользователям. Неверное использование этих команд может привести к потере всех несохраненных данных и фатальной ошибке в работе программы.
|}

<code>'''MacroMode '''Level<nowiki> [</nowiki>''<Level>'']</code>

ключ устанавливает уровень выдачи сообщений <code>''<Level>''</code>. Если значение <code>''<Level>''</code> не задано, то возвращается текущий уровень выдачи сообщений

Пример 1:
// Выключить откатку без стирания буфера откаток
#UndoOnBefore MacroMode Undo Off;
// Включить откатку с регистрацией создания и удаления объектов верхнего уровня
MacroMode Undo On "Otkatka" hCreate;

Пример 2:
macromode undo off;
macro ProtoPath+"MakePan.mac" basep[1] basep[2] basep[3] xgab, ygab 12;
objident last 1 polka;
if (isvardef("polka")==16)
{
macromode undo on "Ug_Polka.mac" polka ;
}
else
{
macromode undo on;
}

<code>'''MacroMode '''LockHelp ''<Topic>''</code>

Команда принудительно устанавливает тему справки для макропрограммы, где команда вызвана.

<code>''<Topic>''</code> - идентификатор устанавливаемой темы – целое неотрицательное число.

Если значение <code>''<Topic>''</code> = 0, то происходит снятие блокировки смены тем справки, иначе (<code>''<Topic>''</code> > 0) то устанавливается блокировка темы на все время выполнения макрокоманды. После любого выхода из макро в интерактив (нормального или аварийного), блокировка темы справки снимается.

Суть команды в том, что внутри макропрограммы каждая выполняющаяся команда имеет свой указатель (тему) справки, которая зачастую не показывает сути всей макропрограммы. Так вот команда позволит не использовать указатели (темы) каждой из команд макропрограммы, а установить одну тему на всю макропрограмму.