> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/datatype/ballsimtargetresult.md).

# BallSimTargetResult

## Overview

`BallSimTargetResult`는 `SimulationBall:SimulateToTarget()`, `SimulationBall:ReSimulateToTargetWithDelay()`, `SimulationBall:ReSimulateSpinToTargetWithDelay()`처럼 목표 위치를 향해 발사 조건을 계산하는 메서드의 반환값입니다. 목표 지점에 도달하는 궤적을 찾았는지 여부와, 실제로 사용된 속도·방향, 목표에 도달하는 시각 정보를 담고 있습니다.

## Constructors

## Properties

### ActualSpeed

`number`

실제 발사에 사용된 속도입니다(km/h 단위). 호출 시 `UseDesiredSpeed`를 `true`로 지정했다면 요청한 속도 값이 그대로 반환됩니다.

#### Code Samples

```lua
local result = result -- BallSimTargetResult obtained from SimulateToTarget, etc.
print("Actual speed (km/h):", result.ActualSpeed)
```

### bHit

`boolean`

목표 위치에 도달하는 유효한 궤적을 찾았는지 여부를 나타냅니다. `false`인 경우 `ActualSpeed`, `Direction`, `HitTime`은 모두 기본값(0 또는 영벡터)입니다.

#### Code Samples

```lua
local result = result -- BallSimTargetResult obtained from SimulateToTarget, etc.
if result.bHit then
    print("Found a trajectory that reaches the target")
end
```

### Direction

`Vector3`

실제 발사에 필요한 방향 단위 벡터입니다.

#### Code Samples

```lua
local result = result -- BallSimTargetResult obtained from SimulateToTarget, etc.
print("Launch direction:", result.Direction)
```

### HitTime

`number`

재생 시작 시점을 기준으로 목표에 도달하는 시각(초 단위)입니다. `bHit`이 `false`이면 0입니다.

#### Code Samples

```lua
local result = result -- BallSimTargetResult obtained from SimulateToTarget, etc.
if result.bHit then
    print("Hit time (s):", result.HitTime)
end
```

## Methods

## Events

## See also

{% content-ref url="/pages/ca0qkgbvP2luHQy0HlFQ" %}
[SimulationBall](/korean/development/api-reference/classes/simulationball.md)
{% endcontent-ref %}