# NumberSequenceKeypoint

## Overview

NumberSequence에서 하나의 키포인트를 구성하는 요소로, 특정 시점에 해당하는 시간 값과 그 시점에 적용될 숫자 값, 그리고 변동 범위를 나타내는 엔벨로프 크기를 함께 정의합니다. 이러한 키포인트들이 여러 개 연속적으로 연결되어 NumberSequence 전체의 수치 변화 흐름과 변동 폭을 형성합니다.

## Constructors

### new

입력된 시간 값, 숫자 값을 조합하여 새로운 NumberSequenceKeypoint를 생성합니다. 생성된 키포인트는 NumberSequence 내에서 특정 시점의 값을 정의합니다.

#### Parameters

| `number` InTime  | NumberSequence 내에서 키포인트가 위치할 시간 값을 지정합니다. 값은 일반적으로 0에서 1 사이의 범위를 사용하며, 시퀀스 내에서의 상대적인 위치를 나타냅니다. |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| `number` InValue | 지정된 시간 값에 적용될 숫자 값입니다.                                                                          |

#### Return

| `NumberSequenceKeypoint` | 입력된 시간 값, 숫자 값을 기준으로 생성된 새로운 NumberSequenceKeypoint를 입니다. |
| ------------------------ | --------------------------------------------------------- |

#### Code Samples

```lua
local Time = 0.5
local Value = 10
local KeyPoint = NumberSequenceKeyPoint.new(Time, Value)
```

### new

입력된 시간 값, 숫자 값, 엔벨로프 크기를 조합하여 새로운 NumberSequenceKeypoint를 생성합니다. 생성된 키포인트는 NumberSequence 내에서 특정 시점의 값과 해당 값의 변동 범위를 함께 정의합니다.

#### Parameters

| `number` InTime     | NumberSequence 내에서 키포인트가 위치할 시간 값을 지정합니다. 값은 일반적으로 0에서 1 사이의 범위를 사용하며, 시퀀스 내에서의 상대적인 위치를 나타냅니다. |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| `number` InValue    | 지정된 시간 값에 적용될 숫자 값입니다.                                                                          |
| `number` InEnvelope | 해당 키포인트에 적용될 엔벨로프 크기입니다. 값의 변동 폭을 나타내며, 빠른 확장이나 완만한 변화와 같은 효과를 표현하는 데 사용됩니다.                    |

#### Return

| `NumberSequenceKeypoint` | 입력된 시간 값, 숫자 값, 엔벨로프 크기를 기준으로 생성된 새로운 NumberSequenceKeypoint입니다. |
| ------------------------ | ---------------------------------------------------------------- |

#### Code Samples

```lua
local Time = 0.5
local Value = 10
local Envelope = 1
local KeyPoint = NumberSequenceKeyPoint.new(Time, Value, Envelope)
```

## Properties

### Envelope

`number`

이 값은 기준이 되는 숫자 값에서 어느 정도까지 변화가 허용되는지를 나타내는 범위입니다. 엔벨로프 계산에 의해 결정되며, 실제 적용 시에는 해당 범위 내에서 값이 변동될 수 있습니다.

#### Code Samples

```lua
local Time = 0.5
local Value = 10
local Envelope = 1
local KeyPoint = NumberSequenceKeyPoint.new(Time, Value, Envelope)
print(KeyPoint.Envelope)
```

### Time

`number`

NumberSequence 내에서 해당 키포인트가 어느 지점에 배치되는지를 나타내는 값으로, 0에서 1 사이의 범위를 사용하여 시작과 끝 사이의 위치를 정의합니다.

#### Code Samples

```lua
local Time = 0.5
local Value = 10
local Envelope = 1
local KeyPoint = NumberSequenceKeyPoint.new(Time, Value, Envelope)
print(KeyPoint.Time)
```

### Value

`number`

키포인트 지점에서 적용될 숫자를 나타내는 값입니다.

#### Code Samples

```lua
local Time = 0.5
local Value = 10
local Envelope = 1
local KeyPoint = NumberSequenceKeyPoint.new(Time, Value, Envelope)
print(KeyPoint.Value)
```

## Methods

## Events


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/datatype/numbersequencekeypoint.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.