Ru/Func instance: Difference between revisions

From Valve Developer Community
< Ru
Jump to navigation Jump to search
mNo edit summary
(Translation added)
Line 1: Line 1:
{{lang|Func instance}}
{{lang|Func instance}}


{{point ent|func_instance|internal=1}} It inserts an [[instance]] of another VMF file into the current one. You can translate and rotate the instance without breaking anything or creating an off-grid editing nightmare. By default, instances are drawn in Hammer with an orange tint, though this can be disabled in <code>Instancing > View Instances</code>.
{{point ent|func_instance|internal=1}} Это энтити вставляет [[instance|образец (instance)]] другого VMF файла в текущий. Вы можете перемещать и вращать ваш образец без ломания чего-либо или создания кошмарного редактирования вне сетки. По умолчанию, образец VMF отображается в Hammer окрашенным в оранжевый, но вы можете отключить это по пути: <code>Instancing > View Instances</code>.


{{warning|Self recursive instances (i.e. instances which include themselves) will crash Hammer.}}
{{warning:ru|Саморекурсивный образец (т.е. образец, в который включен он сам) может вызвать вылет Hammer.}}


{{note|Instances are disabled by default in pre-[[Left 4 Dead 2]] games (except Team Fortress 2). To enable them, add a <code>GameData</code> key to [[gameinfo.txt]], pointing to the game's FGD file.}}
{{note:ru|Образцы по умолчанию отключены в играх до [[Left 4 Dead 2]] (кроме Team Fortress 2). Чтобы включить их, добавьте ключ <code>GameData</code> в [[gameinfo.txt]], указывая на FGD файл нужной игры.}}
{{note|VBSP will only transform entities in the [[FGD]] file it loads from the <code>GameData</code> key. If any custom entities are being misplaced, this is the most likely cause.}}
{{note:ru|VBSP преобразует только энтити в [[FGD]] файле, который загружается из ключа <code>GameData</code>. Если какие-либо свои энтити потеряны (misplaced), то это наиболее вероятная причина.}}


{{tip| [[gameinfo.txt]] has an InstancePath parameter that defines where instances are stored. If you try to reference files that aren't in this folder, you will have to manually type in the filename of your instance's .vmf (file path is relative to the parent .vmf)}}
{{tip:ru| [[gameinfo.txt]] имеет параметр InstancePath, которых указывает расположение образцов. Если вы пытаетесь обратиться к файлам, которых нет в этой папке, вам придётся вручную вводить имя вашего .vmf образца (путь к файлу относительно родительского .vmf)}}
<br>
{{bug:ru|{{as}} Вложенные экземпляры с относительными именами файлов некорректно работают в Alien Swarm, потому что они по-разному обрабатываются в Hammer и VBSP. {{todo:ru|проверить gameinfo.txt. Проблема может быть в неправильной настройке}}}}
{{bug:ru| [[light_spot]] будет вести себя непредсказуемо, когда часть образца будет изменять ключ-значение <code>Pitch</code>. Решается путём свёртывания ```[collapsing]``` образца, или при помощи ключа-значения "Entity to point at".}}
{{bug:ru|{{as}} Func_instance некорректно работает в Source 2009 Engine Branch. Вместо этого рекомендуется использовать [[Prefab|Префаб]].}}
{{bug:ru| [[func_viscluster]] не работает при размещении внутри образца.}}
{{bug:ru|VBSP произойдет сбой без ошибок, если образец превысит лимит брашей (т.е. ситуация, когда скрытие всех экземпляров приведет к тому, что карта не будет превышать лимиты на браши). Компиляция с -verbose покажет конкретный экземпляр, вызывающий сбой VBSP.}}


{{bug|{{as}} Nested instances with relative file names don't work correctly in Alien Swarm, because they are handled differently in Hammer and VBSP. (verify? may be because of incorrectly set up gameinfo.txt)}}
== Ввод через образец ==
{{bug| [[light_spot]] will behave unpredictably when part of an instance that alters the light's pitch. This is solved by collapsing the instance or using the light's "Entity to point at" keyvalue.}}
{{bug|{{as}} The func_instance does not work correctly in the Source 2009 Engine Branch. It is recommended you use a [[Prefab]] instead.}}
{{bug| [[func_viscluster]] does not function when placed inside of an instance.}}
{{bug|VBSP will crash with no error if an instance pushes it over the brush limit (i.e. a situation where hiding all instances would keep the map under the brush limit). Compiling with -verbose will reveal the specific instance causing VBSP to fail.}}


== Input through an instance ==
# Задайте Fix Up Name. Для примера будет задано имя "MyInstance"
 
# Определите значение для ввода (input) или выхода (output), которое вы хотите использовать (если он есть).
# Define a Fix Up Name.
# Отправьте ввод в [[targetname]] "fixupname-значение", например MyInstance-Start. Интерфейс Hammer не распознает имя, но не волнуйтесь.
# Define a value for the input or output you want to use (if there is one).
# Send an input to the [[targetname]] "fixupname-value", e.g. MyInstance-Start. Hammer's UI won't recognise the name, but don't worry.


==KeyValues==
==KeyValues==
{{KV|VMF Filename|intn=file|string|The VMF file to insert as an instance.}}
{{KV|VMF Filename|intn=file|string|Имя VMF файла для использования в образце.}}
{{KV|Fix Up Name|intn=propagate_fixup|string|Essentially the name of the instance. All entities within it will have this string added to them based upon the fix up style. If no name is provided, <code>InstanceAutoX</code> or <code>AutoInstanceX</code> will be used, where X is a number that is incremented with each instance.
{{KV|Fix Up Name|intn=propagate_fixup|string|По сути, это название образца. Эта строка будет добавлена ко всем объектам в нём на основе стиля исправления. Если имя не указано, то будет использовано <code>InstanceAutoX</code> или <code>AutoInstanceX</code>, где X - число, которое будет увеличиваться с каждым новым образцом.
{{note|Entity names that start with the <code>@</code> symbol e.g. '''@exit_door''' will not be changed by the instance name fix up. {{todo|only confirmed for [[Portal 2]]}}}}}}
{{note:ru|Имена энтити, начинающиеся с символа <code>@</code>, например '''@exit_door''', не будут изменены при исправлении имени образца. {{todo:ru|подтверждено только для [[Portal 2]]}}}}}}
{{KV|Entity Name Fix Up|intn=fixup_style|choices|How to apply the fix up name.}}
{{KV|Entity Name Fix Up|intn=fixup_style|choices|Как применять Fix Up Name.}}
:*0: Prefix (Default)
:*0: Prefix (По умолчанию)
:*1: Postfix
:*1: Postfix
:*2: None
:*2: None
{{KV|Replace|intn=replace01|instance_variable| This is a replacement parameter. Any usage of <code>$variable</code> inside the instance will be replaced with <code>value</code>. Replace <code><string $variable> <string value></code>. '''Example''': $color 255 0 0.
{{KV|Replace|intn=replace01|instance_variable| Это параметр замены. Любое использование <code>$variable</code> внутри экземпляра будет заменено на <code>value</code>. Заменить <code><string $variable> <string value></code>. '''Пример''': $color 255 0 0.
{{note|There are 10 ''Replace'' key-value pairs with the keys following ''replace'''''{number}''' for names: '''replace01''', '''replace02''', '''...''', '''replace10''' }}}}
{{note:ru|There are 10 ''Replace'' key-value pairs with the keys following ''replace'''''{number}''' for names: '''replace01''', '''replace02''', '''...''', '''replace10'''<br>{{todo:ru|перевести это предложение, да так перевести, чтобы хоть что-то было понятно}}}}}}


{{KV Angles}}
{{KV Angles:ru}}


==See also==
==Также смотрите==
*[[func_instance_parms]] - Entity to control parameters within instances.
*[[func_instance_parms]] - Сущность для управления параметрами в образцах.
*[[func_instance_io_proxy]] - Entity that is used as a proxy for entity I/O within instances.
*[[func_instance_io_proxy]] - Энтити, которая в образцах используется в качестве прокси для entity I/O (input/output).
*[[func_instance_origin]] - Helper entity that defines the center point of an instance.
*[[func_instance_origin]] - Вспомогательная сущность, определяющая центральную точку образца.
*[[L4D2 Level Design/VMF Instances]] - A tutorial on how to use this entity in Left 4 Dead 2.
*[[L4D2 Level Design/VMF Instances]] - Учебник о том, как пользоваться этой энтити в Left 4 Dead 2.
[[Category:Instances]]
[[Category:Instances]]

Revision as of 23:21, 3 April 2021

English (en)Español (es)Русский (ru)中文 (zh)Translate (Translate)

Template:Point ent Это энтити вставляет образец (instance) другого VMF файла в текущий. Вы можете перемещать и вращать ваш образец без ломания чего-либо или создания кошмарного редактирования вне сетки. По умолчанию, образец VMF отображается в Hammer окрашенным в оранжевый, но вы можете отключить это по пути: Instancing > View Instances.

Template:Warning:ru

Template:Note:ru Template:Note:ru

Template:Tip:ru
Template:Bug:ru Template:Bug:ru Template:Bug:ru Template:Bug:ru Template:Bug:ru

Ввод через образец

  1. Задайте Fix Up Name. Для примера будет задано имя "MyInstance"
  2. Определите значение для ввода (input) или выхода (output), которое вы хотите использовать (если он есть).
  3. Отправьте ввод в targetname "fixupname-значение", например MyInstance-Start. Интерфейс Hammer не распознает имя, но не волнуйтесь.

KeyValues

VMF Filename (file) <строка(en)>
Имя VMF файла для использования в образце.
Fix Up Name (propagate_fixup) <строка(en)>
По сути, это название образца. Эта строка будет добавлена ко всем объектам в нём на основе стиля исправления. Если имя не указано, то будет использовано InstanceAutoX или AutoInstanceX, где X - число, которое будет увеличиваться с каждым новым образцом.

Template:Note:ru

Entity Name Fix Up (fixup_style) <варианты выбора>
Как применять Fix Up Name.
  • 0: Prefix (По умолчанию)
  • 1: Postfix
  • 2: None
Replace (replace01) <instance_variable(en)>
Это параметр замены. Любое использование $variable внутри экземпляра будет заменено на value. Заменить <string $variable> <string value>. Пример: $color 255 0 0.

Template:Note:ru


Углы:
Pitch Yaw Roll (Y Z X) (angles) <QAngle(en)>
Ориентация этого объекта в мире. Тангаж (pitch) - поворот по оси Y, рысканье (yaw) - поворот по Z и крен(roll) - поворот по X.

Также смотрите

  • func_instance_parms - Сущность для управления параметрами в образцах.
  • func_instance_io_proxy - Энтити, которая в образцах используется в качестве прокси для entity I/O (input/output).
  • func_instance_origin - Вспомогательная сущность, определяющая центральную точку образца.
  • L4D2 Level Design/VMF Instances - Учебник о том, как пользоваться этой энтити в Left 4 Dead 2.