Dota 2 Workshop Tools/Scripting/API/Global.TraceCollideable=zh: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(Created page with "{{Note | This page was previously automatically generated. Any changes may be overwritten}} Category:Dota2Function Category:Global == Function Description == ''' b...")
 
m (clean up, added deadend tag)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Dead end|date=January 2024}}
{{Note | This page was previously automatically generated.  Any changes may be overwritten}}
{{Note | This page was previously automatically generated.  Any changes may be overwritten}}
[[Category:Dota2Function]]
[[Category:Global]]
== Function Description ==


== 函数介绍 ==


''' bool TraceCollideable(table ''parameters'') '''
''' bool TraceCollideable(table ''parameters'') '''


Does a raytrace against a single solid entity. An extra bounding box centered around the entity can be added with the ''mins'' and ''maxs'' parameters.
对单个实体执行光线跟踪。可以使用“mins”和“maxs”参数添加以实体为中心的额外边界框。
 


;Example
;Example
<source lang="lua">
<source lang="lua">
-- Traces a line 100 units forward from the postion of the player, trying to find an entity named "my_prop".
-- 沿轨迹从玩家的位置向前追踪100个单位，试图找到一个名为“my_prop”的实体。
-- If the trace hits, a line is drawn to the hit position, along with the surface normal.
-- 如果命中，将沿曲面法线在命中位置绘制一条线。
local playerEnt = Entities:FindByClassname(nil, "player")
local playerEnt = Entities:FindByClassname(nil, "player")
local startVector = playerEnt:GetOrigin() + Vector(0, 0, 32)
local startVector = playerEnt:GetOrigin() + Vector(0, 0, 32)
Line 21: Line 19:
startpos = startVector;
startpos = startVector;
-- Traces from the player position 100 units in front of the player
-- 玩家前方100个单位的玩家位置
endpos = startVector + RotatePosition(Vector(0,0,0), playerEnt:GetAngles(), Vector(100, 0, 0));
endpos = startVector + RotatePosition(Vector(0,0,0), playerEnt:GetAngles(), Vector(100, 0, 0));
ent = Entities:FindByName(nil, "my_prop"); -- Traces the entity named "my_prop"
ent = Entities:FindByName(nil, "my_prop"); -- Traces the entity named "my_prop"
-- Adds an extra 20 x 20 x 20 bounding box on the model.
-- 在模型上添加一个额外的20 x 20 x 20边界体。
mins = Vector(-10, -10, -10 );
mins = Vector(-10, -10, -10 );
maxs = Vector(10, 10, 10 )
maxs = Vector(10, 10, 10 )
Line 41: Line 39:
</source>
</source>


== Parameters ==
== 参数 ==
{| class="standard-table" style="width: 50%;"
{| class="standard-table" style="width: 50%;"
! Type
! 类型
! Name
! 名字
! Description
! 介绍
|-
|-
| table
| table
| parameters
| parameters
| Table used for both input and output.
| 用于输入和输出的表。
|}
|}


== Returns ==
== 返回 ==


''bool'' - Whether the trace is successful. This only indicates that the trace was done, not whether it hit anything.
''bool'' - 追踪是否成功。这仅表示追踪已完成，而不是是否击中任何东西。


== Input Parameters ==
== 输入参数 ==
Passed to the ''parameters'' table to set up the trace.
传递到参数表以设置跟踪。


{| class="standard-table" style="width: 50%;"
{| class="standard-table" style="width: 50%;"
! Type
! 类型
! Name
! 名字
! Description
! 介绍
|-
|-
| Vector
| Vector
| startpos
| startpos
| Global vector where to start the trace.
| 从指定全局向量处开始追踪。
|-
|-
| Vector
| Vector
| endpos
| endpos
| Global vector where to end the trace.
| 从指定全局向量处结束追踪。
|-
|-
| CBaseEntity
| CBaseEntity
| ent
| ent
| Entity to trace against.
| 欲追踪的实体。
|-
|-
| Vector
| Vector
| mins
| mins
| (Optional) Minimum coordinates of the bounding box. Local to the entity.
| （可选）边界体的最小坐标。实体本地向量。
|-
|-
| Vector
| Vector
| maxs
| maxs
| (Optional) Maximum coordinates of the bounding box. Local to the entity.
| （可选）边界体的最大坐标。实体本地向量。
|}
|}


== Output parameters ==
== 输出参数 ==
Output written by the function to the ''parameters'' table.
被本函数添加到表中的成员。
{{Note | These parameters may not exist if the trace does not hit. Check for nil before using.}}
{{Note | 如果未命中，则这些参数可能不存在。使用前检查是否为空。}}


{| class="standard-table" style="width: 50%;"
{| class="standard-table" style="width: 50%;"
! Type
! 类型
! Name
! 名
! Description
! 介绍
|-
|-
| Vector
| Vector
| pos
| pos
| Global vector where the trace hit.
| 存储命中位置的全局向量。
|-
|-
| float
| float
| fraction
| fraction
| Fraction from the start to end where the trace hit.
| 在追踪轴上移动距离的百分比（？）
|-
|-
| bool
| bool
| hit
| hit
| Whether the trace hit something. Always present.
| 是否命中。始终会存在。
|-
|-
| bool
| bool
| startsolid
| startsolid
| Whether the trace started inside the entity. {{Note | This parameter is set to nil if it is false}}
| 跟踪是否在实体内部开始。{{Note | 如果为false，则此参数设置为 nil}}
|-
|-
| Vector
| Vector
| normal
| normal
| Global normal vector of the surface hit.
| 命中的曲面的全局法线向量。
|}
|}
[[Category:Dota2Function]]
[[Category:Global]]

Latest revision as of 09:59, 21 January 2024

Dead End - Icon.png
This article has no Wikipedia icon links to other VDC articles. Please help improve this article by adding links Wikipedia icon that are relevant to the context within the existing text.
January 2024
Note.pngNote: This page was previously automatically generated. Any changes may be overwritten

函数介绍

bool TraceCollideable(table parameters)

对单个实体执行光线跟踪。可以使用“mins”和“maxs”参数添加以实体为中心的额外边界框。

Example
-- 沿轨迹从玩家的位置向前追踪100个单位，试图找到一个名为“my_prop”的实体。
-- 如果命中，将沿曲面法线在命中位置绘制一条线。
local playerEnt = Entities:FindByClassname(nil, "player")
local startVector = playerEnt:GetOrigin() + Vector(0, 0, 32)
local traceTable =
{
	startpos = startVector;
	
	-- 玩家前方100个单位的玩家位置
	endpos = startVector + RotatePosition(Vector(0,0,0), playerEnt:GetAngles(), Vector(100, 0, 0));
	ent = Entities:FindByName(nil, "my_prop"); -- Traces the entity named "my_prop"
	
	-- 在模型上添加一个额外的20 x 20 x 20边界体。
	mins = Vector(-10, -10, -10 );
	maxs = Vector(10, 10, 10 )
}

TraceCollideable(traceTable)

if traceTable.hit 
then
	DebugDrawLine(traceTable.startpos, traceTable.pos, 0, 255, 0, false, 1)
	DebugDrawLine(traceTable.pos, traceTable.pos + traceTable.normal * 10, 0, 0, 255, false, 1)
else
	DebugDrawLine(traceTable.startpos, traceTable.endpos, 255, 0, 0, false, 1)
end

参数

类型 名字 介绍
table parameters 用于输入和输出的表。

返回

bool - 追踪是否成功。这仅表示追踪已完成，而不是是否击中任何东西。

输入参数

传递到参数表以设置跟踪。

类型 名字 介绍
Vector startpos 从指定全局向量处开始追踪。
Vector endpos 从指定全局向量处结束追踪。
CBaseEntity ent 欲追踪的实体。
Vector mins （可选）边界体的最小坐标。实体本地向量。
Vector maxs （可选）边界体的最大坐标。实体本地向量。

输出参数

被本函数添加到表中的成员。

Note.pngNote: 如果未命中，则这些参数可能不存在。使用前检查是否为空。
类型 名 介绍
Vector pos 存储命中位置的全局向量。
float fraction 在追踪轴上移动距离的百分比（？）
bool hit 是否命中。始终会存在。
bool startsolid 跟踪是否在实体内部开始。
Note.pngNote: 如果为false，则此参数设置为 nil
Vector normal 命中的曲面的全局法线向量。
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Dota_2_Workshop_Tools/Scripting/API/Global.TraceCollideable%3Dzh&oldid=380472"