这篇条目有关 Source引擎。如需详情，点击这里。

Zh/$declaresequence: Difference between revisions

From Valve Developer Community
< Zh
Jump to navigation Jump to search
(chatgpt translation)
 
(deepseek translation)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{LanguageBar}}
{{LanguageBar}}
{{translate}}
{{translate}}
{{this is a|QC command|name=$declaresequence}} 它用于提前声明一个[[sequence|序列]]。
{{this is a|QC 命令|name=$declaresequence}} 该命令用于前向声明一个{{L|sequence}}。


当您希望添加未在本地声明的其他序列作为层时（例如，它们实际上是外部.mdl文件的一部分，参见[[$includemodel]]），这非常有用。$declaresequence 会创建一个空的序列条目，以便本地序列指针可以设置，并且在运行时，这些引用会被实际的序列索引覆盖。
当需要添加未在本地声明的其他序列作为层级（例如这些序列实际属于外部.mdl文件时，参见{{L|$includemodel}}），此命令非常有用。$declaresequence 会创建一个空序列条目，使得本地序列指针可以被设置。在运行时，这些引用会被实际的序列索引覆盖。


用简单的话来说：$declaresequence 可用于告诉编译器声明的序列将从[[$includemodel]]中获取，而未声明的序列将从当前编译中获取。如果通过更改已声明序列的顺序进行多人游戏的模组开发，这对于防止序列索引不匹配非常有用。<br>
简而言之：$declaresequence 可用于告知编译器，已声明的序列将从{{L|$includemodel}}中获取，而未声明的序列则来自当前编译。这对多人游戏模组中通过调整声明顺序来防止序列索引错位非常有效。<br>
声明的序列将按$declaresequence行出现的顺序编译，而不是按原始$includemodel文件的顺序。如果您希望保留$includemodel的序列顺序而不进行任何更改，则无需使用$declaresequence。
声明序列将按照$declaresequence行的出现顺序编译，而非原$includemodel文件中的顺序。若需完全保留$includemodel的原始序列顺序且不作任何修改，则无需使用$declaresequence。


{{Warning|如果您使用两个[[$includemodel]].mdl文件，而这两个文件包含同名的序列，$declaresequence 无法区分这两个mdl文件中的动画，最终会声明它们的同名序列。<br>
{{Warning|若使用两个包含同名序列的{{L|$includemodel}}.mdl文件，$declaresequence 将无法区分具体声明哪个模型的动画，最终会以相同名称同时声明两者。<br>
通常，如果使用[[$sequence]]，会弹出“重复序列”错误，而使用$declaresequence在编译时不会产生此错误，但可能会在游戏中看到结果。}}
通常使用{{L|$sequence}}时会弹出"重复序列"错误，但使用declaresequence编译时不会报错，但游戏中可能出现异常表现。}}


== 语法 ==
== 语法 ==
<syntaxhighlight lang=php highlight=4>
<syntaxhighlight lang=php highlight=4>
  $declaresequence (sequence name)
  $declaresequence (序列名称)
</syntaxhighlight>
</syntaxhighlight>
{{ACategory|QC Commands|declaresequence}}
{{ACategory|QC Commands|declaresequence}}


== 示例 ==
== 示例 ==
如果您希望在使用[[$includemodel]]中的所有其他动画的同时替换一个模型的动画，您需要创建一个DeclareSequence.qci文件来列出所有动画。[[Crowbar|Crowbar工具]]可以为您生成此文件。<br>
若需替换模型中的一个动画，同时保留{{L|$includemodel}}中的其他动画，需创建DeclareSequence.qci文件列出所有动画。{{L|Crowbar}}工具可自动生成该文件。<br>
然后，只需注释掉您需要替换的声明序列，并用$sequence代替即可。 
然后只需注释掉目标声明序列，并添加$sequence替换即可。
<syntaxhighlight lang=php highlight=6,7>
<syntaxhighlight lang=php highlight=6,7>
...
...
$declaresequence "melee_sweep_FirstAidKit"
$declaresequence "melee_sweep_FirstAidKit"
$declaresequence "use_cola"
$declaresequence "use_cola"
$declaresequence "melee_sweep_cola"
$declaresequence "melee_sweep_cola"


//$declaresequence "use_ammopack"
//$declaresequence "use_ammopack"
$sequence "use_ammopack" "anims/use_ammopack_NEW" fadein 0.2 fadeout 0.2 fps 30
$sequence "use_ammopack" "anims/use_ammopack_NEW" fadein 0.2 fadeout 0.2 fps 30


$declaresequence "crouch_use_ammopack"
$declaresequence "crouch_use_ammopack"
$declaresequence "melee_sweep_ammopack"
$declaresequence "melee_sweep_ammopack"
$declaresequence "Defibrillate_Incap_Standing"
$declaresequence "Defibrillate_Incap_Standing"
...</syntaxhighlight>
...</syntaxhighlight>
当然，您需要在编译QC文件中使用$includemodel和$include命令添加DeclareSequence.qci文件和$includemodel。 
最后需要通过$includemodel和$include命令将declaresequence.qci文件与模型包含进编译QC文件：
<syntaxhighlight lang=php highlight=2,4>
<syntaxhighlight lang=php highlight=2,4>//引用原始anim_teenangst.mdl获取动画
//引用原始anim_teenangst.mdl以获取动画 
$includemodel "survivors/animaTeenAngst.mdl"
$includemodel "survivors/animaTeenAngst.mdl"
//通过声明序列保留所有动画并替换指定部分
//使用declaresequence复制所有动画但替换一个（或多个） 
$include "anim_teenangst_DeclareSequence.qci"</syntaxhighlight>
$include "anim_teenangst_DeclareSequence.qci"
</syntaxhighlight>

Latest revision as of 08:27, 28 January 2025

English (en)中文 (zh)Translate (Translate)
Info content.png
This page needs to be translated.
This page either contains information that is only partially or incorrectly translated, or there isn't a translation yet.
If this page cannot be translated for some reason, or is left untranslated for an extended period of time after this notice is posted, the page should be requested to be deleted.
Also, please make sure the article complies with the alternate languages guide.(en)

$declaresequence是一个QC 命令，可在所有的 起源 起源 游戏中使用。 该命令用于前向声明一个sequence(en)。

当需要添加未在本地声明的其他序列作为层级（例如这些序列实际属于外部.mdl文件时，参见$includemodel(en)），此命令非常有用。$declaresequence 会创建一个空序列条目，使得本地序列指针可以被设置。在运行时，这些引用会被实际的序列索引覆盖。

简而言之：$declaresequence 可用于告知编译器，已声明的序列将从$includemodel(en)中获取，而未声明的序列则来自当前编译。这对多人游戏模组中通过调整声明顺序来防止序列索引错位非常有效。
声明序列将按照$declaresequence行的出现顺序编译，而非原$includemodel文件中的顺序。若需完全保留$includemodel的原始序列顺序且不作任何修改，则无需使用$declaresequence。

Warning.png警告:若使用两个包含同名序列的$includemodel(en).mdl文件，$declaresequence 将无法区分具体声明哪个模型的动画，最终会以相同名称同时声明两者。
通常使用$sequence(en)时会弹出"重复序列"错误，但使用declaresequence编译时不会报错，但游戏中可能出现异常表现。

语法

 $declaresequence (序列名称)

示例

若需替换模型中的一个动画，同时保留$includemodel(en)中的其他动画，需创建DeclareSequence.qci文件列出所有动画。Crowbar(en)工具可自动生成该文件。
然后只需注释掉目标声明序列，并添加$sequence替换即可。 

...
$declaresequence "melee_sweep_FirstAidKit"
$declaresequence "use_cola"
$declaresequence "melee_sweep_cola"

//$declaresequence "use_ammopack"
$sequence "use_ammopack" "anims/use_ammopack_NEW" fadein 0.2 fadeout 0.2 fps 30

$declaresequence "crouch_use_ammopack"
$declaresequence "melee_sweep_ammopack"
$declaresequence "Defibrillate_Incap_Standing"
...

最后需要通过$includemodel和$include命令将declaresequence.qci文件与模型包含进编译QC文件： 

//引用原始anim_teenangst.mdl获取动画
$includemodel "survivors/animaTeenAngst.mdl"
//通过声明序列保留所有动画并替换指定部分
$include "anim_teenangst_DeclareSequence.qci"
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Zh/$declaresequence&oldid=462022"