이 코드 샘플은 `Beam` 효과를 처음부터 만드는 방법을 보여줍니다.
`Beam`을 생성하고, 모든 속성을 설정하며, 그
`Attachment`들을 구성합니다.

**Beam** 객체는 두 개의 `Class.Attachment|Attachments`를 연결하여
그 사이에 텍스처를 그립니다.

비임을 표시하려면 `Class.Workspace`의 자손이어야 하며,
`Class.Beam.Attachment0|Attachment0` 및 `Class.Beam.Attachment1|Attachment1`
속성이 `Class.Workspace`에서 파생된 `Class.Attachment|Attachments`로 설정되어야 합니다.

비임의 모양은 아래에 설명된 다양한 속성을 사용하여 사용자 정의할 수 있습니다.
비주얼 예제를 보려면 [Beams](/effects/beams) 가이드를 참조하십시오.

#### 비임 곡률

비임은 네 개의 제어점으로 형성된 3차 베지어 곡선을 사용하도록 설정됩니다.
이는 비임이 직선에 제한되지 않으며, 비임의 곡선은 `Class.Beam.CurveSize0|CurveSize0`,
`Class.Beam.CurveSize1|CurveSize1` 및 비임의 `Class.Attachment|Attachments`의 방향을 변경하여 수정할 수 있음을 의미합니다.

- **P0** — 비임의 시작; `Class.Beam.Attachment0|Attachment0`의 위치.
- **P1** — `Class.Beam.Attachment0|Attachment0`의 양의 **X** 방향으로
  `Class.Beam.CurveSize0|CurveSize0` 스터드 떨어진 위치.
- **P2** — `Class.Beam.Attachment1|Attachment1`의 음의 **X** 방향으로
  `Class.Beam.CurveSize1|CurveSize1` 스터드 떨어진 위치.
- **P3** — 비임의 끝; `Class.Beam.Attachment1|Attachment1`의 위치.

<img src="/assets/engine-api/classes/Beam/Curvature-Diagram.png" width="800" alt="Beam curvature diagram" />


비임의 텍스처 주기의 오프셋은 텍스처 애니메이션의 진행 상태를 나타냅니다. 이 메서드는 비임의 텍스처
주기의 현재 오프셋을 설정하므로 `offset` 매개변수로 `0`을 전달하여 주기를 재설정할 수 있습니다.

#### 노트

- 주어진 `offset` 매개변수는 0과 1 사이의 값을 기대하지만, 더 큰 값을 사용할 수 있습니다.
- 텍스처 주기는 0과 1에서 감싸여 즉, 오프셋이 0 또는 1일 때 텍스처가 동일한 위치에 있습니다.
- `Class.Beam.Texture|Texture` 속성이 설정되지 않으면 이 메서드는 아무것도 하지 않습니다.
- 오프셋을 증가시키면 이는 `Class.Beam.TextureSpeed|TextureSpeed` 속성과 반대 방향으로 작용하여,
`Class.Beam.TextureSpeed|TextureSpeed`가 0보다 클 때 텍스처가 애니메이션 진행 방향과 반대 방향으로 이동합니다.


Beam:SetTextureOffset

offset

텍스처 주기의 원하는 오프셋입니다.


비임의 텍스처 주기의 현재 오프셋을 설정합니다.


Beam

비임이 시작되는 `Class.Attachment`입니다. 이 부착물은 비임의 3차 베지어 곡선에서
첫 번째 제어점이며, 방향과 `Class.Beam.CurveSize0|CurveSize0` 속성이 두 번째
제어점의 위치를 결정합니다. 자세한 내용은
[Beams](/effects/beams#curve)를 참조하십시오.

비임이 끝나는 `Class.Attachment`에 대해서는
`Class.Beam.Attachment1|Attachment1`을 참조하십시오.


Beam.Attachment0

비임이 시작되는 `Class.Attachment`입니다.


비임이 끝나는 `Class.Attachment`입니다. 이 부착물은 비임의 3차 베지어 곡선에서
네 번째이자 마지막 제어점이며, 방향과 `Class.Beam.CurveSize1|CurveSize1` 속성이
세 번째 제어점의 위치를 결정합니다. 자세한 내용은
[Beams](/effects/beams#curve)를 참조하십시오.

비임이 시작되는 `Class.Attachment`에 대해서는
`Class.Beam.Attachment0|Attachment0`을 참조하십시오.


Beam.Attachment1

비임이 끝나는 `Class.Attachment`입니다.


비임에서 방출되는 빛의 크기를 조절합니다.
`Class.Beam.LightInfluence|LightInfluence`가 1보다 작을 때. 이 속성은 기본적으로
1이며 0에서 10000 범위 내의 어떤 숫자로든 설정할 수 있습니다.
`Class.Beam.LightInfluence|LightInfluence`의 값을 증가시키면 이 속성의
효과가 감소합니다.


Beam.Brightness

비임에서 방출되는 빛의 크기를 조절합니다.
`Class.Beam.LightInfluence|LightInfluence`가 1보다 작을 때.


비임의 `Class.Beam.Segments|Segments` 전반의 색상을 결정합니다. `Class.Beam.Texture|Texture`
가 설정되어 있으면 이 색상이 비임의 텍스처에 적용됩니다. `Class.Beam.Texture|Texture`
가 설정되어 있지 않으면 `Class.Beam`은 이 속성에 따라 색상이 지정된 고체 선으로 표시됩니다.

이 속성은 `Datatype.ColorSequence`로, 색상이 비임의 길이를 따라 다양하게 설정될 수 있습니다.
다음 `Datatype.ColorSequence`를 고려하십시오. 비임에 적용하면 다음의 이미지와 같은 결과를 생성합니다.

```lua
local colorSequence = ColorSequence.new({
		ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)), -- 빨강
		ColorSequenceKeypoint.new(0.5, Color3.fromRGB(0, 188, 203)), -- 청록색
		ColorSequenceKeypoint.new(1, Color3.fromRGB(196, 0, 255)), -- 보라색
	}
)
```

<img src="/assets/lighting-and-effects/beam/ColorSequence-Applied.png" width="800" />

비임의 색상은 `Class.Beam.Segments|Segments`의 개수에도 의존합니다. 비임의 각
세그먼트는 두 가지 색상 간의 전이만 표시할 수 있습니다. 따라서 `Class.Beam`은 색상을
올바르게 표시하기 위해 최소한 `n-1` 개 세그먼트를 가져야 하며, 여기서 `n`은 `Datatype.ColorSequenceKeypoint|ColorSequenceKeypoints`의
수입니다.


Beam.Color

비임의 `Class.Beam.Segments|Segments` 전반의 색상을 결정합니다.


비임의 베지어 곡선에서 두 번째 제어점의 위치를 결정하는 `Class.Beam.Attachment0|Attachment0`과 함께 작용합니다.
자세한 내용은
[Beams](/effects/beams#curve)에서 확인하십시오.

이 점의 위치는 다음의 수식을 통해 결정될 수 있습니다:

```lua
local controlPoint2 = Beam.Attachment0.WorldPosition + (Beam.Attachment0.CFrame.RightVector * Beam.CurveSize0)
```


Beam.CurveSize0

비임의 베지어 곡선에서 두 번째 제어점의 위치를 결정하는 `Class.Beam.Attachment0|Attachment0`과 함께 작용합니다.


비임의 베지어 곡선에서 세 번째 제어점의 위치를 결정하는 `Class.Beam.Attachment1|Attachment1`과 함께 작용합니다.
자세한 내용은
[Beams](/effects/beams#curve)에서 확인하십시오.

이 점의 위치는 다음의 수식을 통해 결정될 수 있습니다:

```lua
local controlPoint3 = Beam.Attachment1.WorldPosition - (Beam.Attachment1.CFrame.RightVector * Beam.CurveSize1)
```


Beam.CurveSize1

비임의 베지어 곡선에서 세 번째 제어점의 위치를 결정하는 `Class.Beam.Attachment1|Attachment1`과 함께 작용합니다.


비임이 보이는지 여부를 결정합니다.

이 속성이 false로 설정되면 비임의
`Class.Beam.Segments|Segments`는 표시되지 않습니다.


Beam.Enabled

비임이 보이는지 여부를 결정합니다.


`Class.Beam`은 3D 공간에 존재하는 2D 프로젝션이므로
모든 각도에서 볼 수 없을 수 있습니다. **FaceCamera** 속성이
`true`로 설정되면 비임이 항상
`Class.Workspace.CurrentCamera|CurrentCamera`를 향하도록 보장됩니다.


Beam.FaceCamera

비임의 `Class.Beam.Segments|Segments`가 방향에 관계없이 항상 카메라를 향하게 하는지 여부를 결정합니다.


비임의 색상이 그 뒤의 색상과 얼마나 혼합되는지를 결정합니다. 이 값은 0과 1 사이에서 설정되어야 하며,
0은 일반 혼합 모드를 사용하고 1은 추가 혼합을 사용합니다.

이 속성은 환경 빛에 비쳐 비임에 미치는 영향을 결정하는 `Class.Beam.LightInfluence|LightInfluence`와 혼동해서는 안됩니다.

이 속성은 비임이 환경을 밝도록 만들지 않습니다.


Beam.LightEmission

비임의 색상이 그 뒤의 색상과 얼마나 혼합되는지를 결정합니다.


비임이 환경의 조명에 얼마나 영향을 받는지를 결정하며, 0과 1 사이로 제한됩니다. 0일 경우
비임은 환경 조명의 영향을 받지 않습니다. 1일 경우는 `Class.BasePart`처럼 조명의 영향을
전적으로 받습니다.

비임의 색상이 그 뒤의 색상과 얼마나 혼합되는지에 대한 `Class.Beam.LightEmission|LightEmission`도 참조하십시오.


Beam.LightInfluence

비임이 환경의 조명에 얼마나 영향을 받는지를 결정합니다.


Beam.LocalTransparencyModifier

비임은 완벽한 곡선이 아니라 직선 세그먼트로 구성되어 있습니다.
세그먼트가 많을수록 곡선 해상도가 높아집니다. **Segments** 속성은 비임의
직선 세그먼트 수를 설정하며, 기본값은 10입니다.

`Class.Beam.Color|Color` 및 `Class.Beam.Transparency|Transparency` 속성은 올바르게
표시되기 위해 특정 수의 세그먼트가 필요합니다. 각 세그먼트는 두 개의 색상 또는 투명도의 전환만 표시할 수 있으므로,
`Class.Beam`은 올바르게 표시하기 위해 최소한 `n-1` 개의 세그먼트를 가져야 하며,
여기서 `n`은 비임의 `Class.Beam.Color|Color` 및 `Class.Beam.Transparency|Transparency`와 관련된
키포인트의 수입니다.


Beam.Segments

비임이 구성되는 직선 세그먼트의 수를 설정합니다.


비임에 표시할 텍스처의 콘텐츠 ID입니다. 이 속성이 설정되지 않으면 비임은
고체선으로 표시됩니다. 이는 텍스처가 올바른 콘텐츠 ID로 설정되거나
텍스처와 연결된 이미지가 아직 로드되지 않았을 때도 발생합니다.

텍스처의 모양은 `Class.Beam.Color|Color` 및 `Class.Beam.Transparency|Transparency`와 같은
기타 비임 속성을 사용하여 추가로 수정할 수 있습니다.

텍스처의 크기는 `Class.Beam.TextureMode|TextureMode`,
`Class.Beam.TextureLength|TextureLength`, `Class.Beam.Width0|Width0` 및
`Class.Beam.Width1|Width1` 속성에 의해 결정됩니다.


Beam.Texture

비임에 표시할 텍스처의 콘텐츠 ID입니다.


비임의 텍스처 길이를 설정합니다, 
`Class.Beam.TextureMode|TextureMode`에 따라 달라집니다.


Beam.TextureLength

이 속성은 `Class.Beam.TextureLength|TextureLength`와 함께 비임의
`Class.Beam.Texture|Texture`가 반복되는 방식을 결정합니다.

`Enum.TextureMode.Wrap` 또는 `Enum.TextureMode.Static`으로 설정하면
텍스처 반복은 비임의 전체 길이(스터드 단위)를 비임의 `Class.Beam.TextureLength|TextureLength`로 나눈 것과 같아집니다.

<img src="/assets/engine-api/enums/TextureMode/Wrap-Static.png" width="720" alt="TextureMode diagram with Wrap mode" />

`Enum.TextureMode.Stretch`로 설정하면 텍스처가 비임의 전체 길이에 걸쳐
`Class.Beam.TextureLength|TextureLength` 회 반복됩니다.

<img src="/assets/engine-api/enums/TextureMode/Stretch.png" width="720" alt="TextureMode diagram with Stretch mode" />


Beam.TextureMode

`Class.Beam.Texture|Texture`가 스케일되고 반복되는 방식을 결정합니다.


`Class.Beam.Texture|Texture` 이미지가 비임을 따라 이동하는 속도를 결정합니다. 이 속성이 값이
양수일 경우 비임의 텍스처가 `Class.Beam.Attachment0|Attachment0`에서
`Class.Beam.Attachment1|Attachment1`로 이동합니다. 이 방향은 이 속성을 음수로 설정하여 반전할 수 있습니다.


Beam.TextureSpeed

`Class.Beam.Texture|Texture` 이미지가 비임을 따라 이동하는 속도를 결정합니다.


비임의 세그먼트 전반의 투명도를 결정합니다. 이 속성은 `Datatype.NumberSequence`로,
비임의 길이에 따라 투명도가 다양하게 설정될 수 있습니다.

다음 `Datatype.NumberSequence`를 고려하십시오. 비임에 적용되면 다음의 이미지와 같은
결과를 생성합니다.

```lua
local numberSequence = NumberSequence.new({
		NumberSequenceKeypoint.new(0, 0), -- 불투명
		NumberSequenceKeypoint.new(0.5, 1), -- 투명
		NumberSequenceKeypoint.new(1, 0), -- 불투명
	}
)
```

<img src="/assets/lighting-and-effects/beam/Transparency-Applied.png" width="800" />

비임의 투명도는 `Class.Beam.Segments|Segments`의 개수에도 의존합니다. 비임의 각
세그먼트는 두 개의 투명도 간의 전이만 표시할 수 있습니다. 따라서 비임은 올바르게 표시하기 위해
최소한 `n-1`개의 세그먼트를 가져야 하며, 여기서 `n`은 `Datatype.NumberSequenceKeypoint|NumberSequenceKeypoints`의
수입니다.


Beam.Transparency

비임의 세그먼트 전반의 투명도를 결정합니다.


비임의 시작 지점에서의 너비
(`Class.Beam.Attachment0|Attachment0`), 스터드 단위로. 비임의 너비는
`Class.Beam.Width1|Width1` 스터드로 비임의 끝
(`Class.Beam.Attachment1|Attachment1`)에 선형적으로 변경됩니다.


Beam.Width0

비임의 시작 지점에서의 너비
(`Class.Beam.Attachment0|Attachment0`), 스터드 단위로.


비임의 끝에서의 너비(`Class.Beam.Attachment1|Attachment1`),
스터드 단위로. 비임의 너비는 비임의 시작(`Class.Beam.Attachment0|Attachment0`)
에서 `Class.Beam.Width0|Width0` 스터드에서 선형적으로 변경됩니다.


Beam.Width1

비임의 끝에서의 너비(`Class.Beam.Attachment1|Attachment1`),
스터드 단위로.


이 코드 샘플은 `Class.Beam.ZOffset` 속성을 사용하여 동일한 첨부물 사이에 여러 개의
빔을 레이어합니다.

비임 표시가 `Class.Workspace.CurrentCamera|CurrentCamera`에 대해 오프셋된 거리,
스터드 단위입니다. 0일 경우 비임은
`Class.Beam.Attachment0|Attachment0`과
`Class.Beam.Attachment1|Attachment1` 사이의 표준 위치에 표시됩니다. **ZOffset**은 양수 또는 음수일 수 있습니다.

이 속성은 동일한 `Class.Attachment|Attachments` 사이에 여러 `Class.Beam|Beams`를 사용할 때 "Z‑간섭"을 피하는 데 특히 유용합니다.


Beam.ZOffset

비임 표시가 `Class.Workspace.CurrentCamera|CurrentCamera`에 대해 오프셋된 거리,
스터드 단위입니다.


두 개의 `Class.Attachment|Attachments`를 연결하여 그 사이에 텍스처를 그립니다.


`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.

루트 `Instance` 객체를 직접 생성할 수는 없지만, 특수한
`Datatype.Instance.new()` 생성자는 코드를 통해 객체를 생성하며,
클래스의 이름을 매개변수로 받아 생성된 객체를 반환합니다.


인스턴스의 조상이 변경되는 것을 감지하기 위해 `Class.Instance.AncestryChanged` 이벤트에 연결하는 방법을 보여줍니다.

ChangingPart의 Parent는 시간이 지남에 따라 다른 값으로 설정됩니다. 부품의 부모는 부품의 조상이므로, `Class.Instance.AncestryChanged` 이벤트는 변경될 때마다 발생합니다.

`Class.Instance.Parent` 속성이 객체 또는 그 조상 중 하나가 변경될 때 발생합니다.

이 이벤트에는 두 개의 매개변수가 포함됩니다: `child`는 실제로 `Class.Instance.Parent`가 변경된 `Class.Instance`를 나타내며, `parent`는 이 인스턴스의 새로운 `Class.Instance.Parent`를 나타냅니다.

이벤트를 사용하여 Studio에서 인스턴스의 삭제를 추적할 수 있으며, Explorer에서의 수동 삭제나 플러그인을 통해서도 가능합니다. `Class.Instance:Destroy()`를 사용하여 인스턴스가 파괴될 때를 감지해야 하는 경우에는 대신 `Class.Instance.Destroying` 이벤트를 사용하세요.


Instance.AncestryChanged

child

`Class.Instance.Parent`가 변경된 `Class.Instance`입니다.


parent

`Class.Instance.Parent`가 변경된 `Class.Instance`의 새로운 `Class.Instance.Parent`입니다.


`Class.Instance.Parent` 속성이 객체 또는 그 조상의 변경될 때 발생합니다.


이 이벤트는 인스턴스의 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다. 변경된 속성의 이름이 연결된 함수에 전달됩니다.

예를 들어, 다음 코드 조각은 부분의 속성 중 하나가 변경될 때 `attributeChanged()` 함수를 발생시킵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "변경됨")
end

part.AttributeChanged:Connect(attributeChanged)
```
특정 주어진 속성이 변경될 때 발생하는 이벤트를 반환하는 `Class.Instance:GetAttributeChangedSignal()`도 참조하십시오.


Instance.AttributeChanged

attribute

`Class.Instance`에서 속성이 변경될 때마다 발생합니다.


이 코드는 객체가 작업 공간에 추가될 때 그 이름을 출력합니다:

이 `Class.Instance`에 객체가 부모로 설정된 후에 발생합니다.

클라이언트에서 서버가 생성한 객체를 감지하기 위해 이 함수를 사용할 때는 `Class.Instance:WaitForChild()`를 사용하여 이 객체의 자손을 인덱스해야 합니다. 이는 객체와 그 자손이 서버에서 클라이언트로 동시에 복제되지 않기 때문입니다. 예를 들어:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 자손이 아직 복제되지 않았을 수 있으므로 WaitForChild() 사용
	local head = child:WaitForChild("Head")
end)
```
이 함수는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 감지하는 함수의 경우 `Class.Instance.DescendantAdded`를 사용하세요.

또한 `Class.Instance.ChildRemoved`도 참조하세요.


Instance.ChildAdded

객체가 이 `Class.Instance`에 부모로 설정된 후에 발생합니다.


이 코드 조각은 객체가 작업공간에서 제거될 때 그 이름을 출력합니다:

이 `Class.Instance`에서 자식이 제거된 후에 발생합니다.

제거란 객체의 부모가 이 `Class.Instance`에서 이 `Class.Instance`가 아닌 다른 것으로 변경된 것을 말합니다. 이 이벤트는 자식이 파괴될 때도 발생합니다(`Class.Instance:Destroy()` 사용) 왜냐하면 파괴 함수가 객체의 부모를 `nil`로 설정하기 때문입니다.

이 함수는 `Class.Instance`의 즉각적인 자식에 대해서만 작동합니다. 모든 자손을 감지하는 함수의 경우 `Class.Instance.DescendantRemoving`을 사용하세요.

또한 `Class.Instance.ChildAdded`도 참조하세요.


Instance.ChildRemoved

이 `Class.Instance`에서 자식이 제거된 후에 발생합니다.


다음 예제는 Workspace에 추가되는 모든 객체의 이름을 출력합니다:

이 이벤트는 `Class.Instance`에 자손이 추가된 후에 발생합니다.

모든 자손에 대해 발생하므로, 객체를 `Class.Instance`에 부모로 설정하면 이 객체와 그 모든 자손에 대해 각각 이벤트가 발생합니다.

`Class.Instance`의 **직접적인 자식**만 걱정하는 경우 `Class.Instance.ChildAdded`를 대신 사용하세요.

또한 `Class.Instance.DescendantRemoving`도 참조하세요.


Instance.DescendantAdded

descendant

이 `Class.Instance`에 자손이 추가된 후에 발생합니다.


다음 예제는 Workspace에서 제거되는 하위 항목의 이름을 출력합니다:

이 이벤트는 부모 `Class.Instance`가 **자손** 인스턴스의 부모가 더 이상 자손이 되지 않도록 변경되기 **바로 전에** 발생합니다. `Class.Instance:Destroy()|Destroy()`는 인스턴스의 `Class.Instance.Parent|Parent`를 `nil`로 변경하므로, 부모의 자손에 대해 그 메서드를 호출하는 경우 이 이벤트가 발생합니다.

이 이벤트는 자손이 제거되기 **전**에 발생하므로, 이 이벤트가 발생할 때 자손의 부모는 변경되지 않습니다. 자손이 부모의 **직접적인 자식**인 경우 이 이벤트는 `Class.Instance.ChildRemoved`보다 먼저 발생합니다.

자손이 자식을 가지고 있다면 이 이벤트는 먼저 자손으로 발생하고, 그 다음 자손의 자손이 발생합니다.

##### 경고

이 이벤트는 제거되고 있는 자손 객체와 함께 발생합니다. 자손의 `Class.Instance.Parent|Parent`를 다른 것으로 설정하려고 하면 실패합니다. 아래는 이를 설명하는 예입니다:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- 이 함수에서 자손의 부모를 조작하지 마세요!
	-- 이 이벤트는 부모가 조작되었기 때문에 발생하며, 변경 사항이 아직 적용되지 않았습니다
	-- 따라서, 이렇게 부모를 변경하는 것은 문제를 일으킵니다:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
또한 `Class.Instance.DescendantAdded|DescendantAdded`도 참조하세요.


Instance.DescendantRemoving

제거되고 있는 `Class.Instance`입니다.


`Class.Instance`의 자손이 제거되기 바로 전에 발생합니다.


이 샘플은 즉시 신호 동작을 사용할 때, 인스턴스가 파괴될 때 연결된 함수가 대기할 때까지 자리가 유지되는 방법을 보여줍니다.

이 샘플은 지연 신호 동작을 사용할 때 인스턴스가 신호가 발생하기 전에 어떻게 파괴되는지를 보여줍니다.

`Class.Instance`는 연결된 함수가 여전히 사용 중인 동안 메모리에서 삭제되지 않습니다. 그러나 함수가 어느 시점에서 양보하면 `Class.Instance`와 그 자손은 `nil`로 부모가 설정됩니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Immediate`로 설정된 경우, 이 이벤트는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴되기 바로 전에 발생합니다.

`Class.Workspace.SignalBehavior` 속성이 `Enum.SignalBehavior.Deferred`로 설정된 경우, 이 이벤트는 다음 재개 지점에서 발생하는데, 이는 `Class.Instance` 또는 그 조상이 `Class.Instance:Destroy()`로 파괴된 이후입니다.

`Enum.SignalBehavior.Deferred|Deferred` 동작의 경우, 스크립트를 자신의 `Class.Instance.Destroying` 이벤트에 연결하는 것이 문제가 될 수 있습니다. 왜냐하면 스크립트가 콜백이 호출되기 전에 파괴될 것이기 때문입니다 (즉, 실행되지 않습니다).

Studio에서 `Class.Instance`를 삭제할 때, 예를 들어 [Explorer](/studio/explorer)를 통해 수동으로 삭제하거나 플러그인을 통해 삭제할 때, `Class.Instance`는 파괴되지 않습니다. 대신 부모가 `nil`로 설정되며 이를 `Class.Instance.AncestryChanged`로 추적할 수 있습니다.


Instance.Destroying

`Class.Instance:Destroy()`를 통해 인스턴스가 파괴되기 **바로 전**에 발생하거나 (혹은 이후로 연기됩니다).


이 이벤트는 인스턴스에서 어떤 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경되었습니다")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```


Instance.StyledPropertiesChanged

인스턴스에서 어떤 스타일 속성이 변경될 때마다 발생하며, 속성이 `nil`로 설정될 때도 포함됩니다.


Instance.childAdded

이 메서드는 인스턴스에 태그를 적용하며, 태그가 이미 적용된 경우에는 효과가 없습니다.
태그를 성공적으로 추가하면 주어진 태그에 대해 `Class.CollectionService:GetInstanceAddedSignal()`
에 의해 생성된 신호가 발생합니다.

##### 경고

- 클라이언트 측에서 추가된 인스턴스의 태그는 서버가 이후에 태그를 추가하거나 제거하면 
  드롭됩니다. 서버는 모든 태그를 함께 복제하며 이전 태그를 덮어씁니다.

- 인스턴스에 태그를 추가할 때, 태그 기능을 부여하기 위해 일반적으로 일부 리소스, 예를 들어 이벤트
  연결 또는 테이블이 사용됩니다. 메모리 누수를 방지하기 위해 더 이상 태그에 필요하지 않을 경우 
  이를 정리하는 것이 좋습니다(연결 해제, `nil`로 설정 등). `Class.Instance:RemoveTag()`를 호출하거나
  `Class.Instance:Destroy()`를 호출하거나 `Class.CollectionService:GetInstanceRemovedSignal()`   
  의해 반환된 신호에 연결된 함수에서 수행하세요.


Instance:AddTag

인스턴스에 태그를 적용합니다.


이 함수는 인스턴스의 모든 자식과 자손을 파괴합니다.

```
local part = Instance.new("Part")

-- 약간의 반짝임 추가
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
모든 자식과 자손을 파괴하지 않으려면 `Class.Instance:GetChildren()` 또는
`Class.Instance:GetDescendants()`를 사용하여 해당 자식/자손을 루프 상에서 선택하여 파괴하세요.
예를 들어, 다음 코드 예제는 `Class.Model`로부터 파생된 모든 `Class.BasePart|BaseParts`를 파괴합니다:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

인스턴스의 모든 자식을 파괴합니다.


Class.Instance:Clone()을 사용하여 모델 복제를 시연합니다.

`Clone()`은 인스턴스 및 모든 자손의 복사본을 생성하며,
`Class.Instance.Archivable|Archivable`가 아닌 모든 인스턴스는 무시합니다. 루트 인스턴스의 복사본은
이 메서드에 의해 반환되며 그 인스턴스의 `Class.Instance.Parent|Parent`는 `nil`로 설정됩니다. 인스턴스 자체에
`Class.Instance.Archivable|Archivable`가 `false`로 설정되어 있는 경우, 이 함수는 `nil`을 반환합니다.

`Class.ObjectValue.Value`와 같은 참조 속성이 클론 된 인스턴스에서 설정되면, 복사의
속성 값은 원본의 값에 따라 달라집니다:

- 참조 속성이 **또한** 클론된 인스턴스를 참조하는 경우,
  복사는 그 클론을 참조합니다.
- 참조 속성이 **클론되지 않은** 인스턴스를 참조하는 경우,
  동일한 값이 복사본에 유지됩니다.


Instance:Clone

인스턴스 및 모든 자손의 복사본을 생성하며, `Class.Instance.Archivable|Archivable`가 아닌 인스턴스는 무시합니다.


이 예제는 `Class.Instance:Destroy()` 함수를 사용하여 Part를 파괴하는 방법을 보여줍니다.

이 함수는 더 이상 필요하지 않은 객체를 처리하는 올바른 방법입니다.

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 해제하고, 모든 자식에 대해 `Destroy()`를 호출합니다. 이 함수는 더 이상 필요하지 않은 객체를 처분하는 올바른 방법입니다.

불필요한 객체를 처분하는 것은 매우 중요합니다. 불필요한 객체와 연결이 있는 장소는 메모리를
사용하며 시간이 지남에 따라 심각한 성능 문제를 초래할 수 있습니다.

`Destroy()`를 호출한 후에는 객체(또는 자손)를 참조하는 변수를 `nil`로 설정하는 것이
모범 사례입니다. 이렇게 하면 코드가 객체와 관련된 어떤 것도 접근하지 않도록 방지할 수 있습니다.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- 이렇게 하지 마세요:
print(part.Name)  --> "Hello, world"
-- 위의 코드가 작동하지 않게 하려면:
part = nil
```

`Class.Instance`가 이 방법으로 파괴된 이후에는 재사용할 수 없습니다. `Class.Instance.Parent` 속성이
잠기기 때문입니다. 객체를 **일시적으로** 제거하고 싶다면, `Class.Instance.Parent|Parent`를 `nil`로 설정하세요. 예를 들어:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
정해진 시간 후 객체를 파괴하려면 `Class.Debris:AddItem()`을 사용하세요.


Instance:Destroy

`Class.Instance.Parent` 속성을 `nil`로 설정하고,
`Class.Instance.Parent` 속성을 잠그며, 모든 연결을 해제하고, 모든 자식에 대해 `Destroy()`를 호출합니다.


`Class.Instance.Name`이 주어진 이름과 같은 첫 번째 조상을 반환합니다.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

다음 코드 스니펫은 `Car`라는 이름의 객체의 첫 번째 조상을 찾습니다.

```
local car = object:FindFirstAncestor("Car")
```
특정 클래스의 조상을 찾는 이 함수의 변형에 대한 내용은 `Class.Instance:FindFirstAncestorOfClass()`와
`Class.Instance:FindFirstAncestorWhichIsA()`를 참조하세요.


Instance:FindFirstAncestor

name

찾고자 하는 `Class.Instance.Name`입니다.


`Class.Instance.Name`이 주어진 이름과 같은 첫 번째 조상을 반환합니다.


`Class.Instance`의 첫 번째 조상을 반환하며,
`Class.Object.ClassName`이 주어진 className과 같을 경우.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

이 함수의 일반적인 용도는 `Class.BasePart`에 속하는 `Class.Model`을 찾는 것입니다. 예를 들어:

```
local model = part:FindFirstAncestorOfClass("Model")
```
이 함수는 `Class.Instance:FindFirstAncestor()`의 변형으로,
`Class.Instance.Name` 대신 `Class.Object.ClassName` 속성을 검사합니다. `Class.Instance:FindFirstAncestorWhichIsA()`도
존재하며, 상속을 존중하기 위해 `Class.Object:IsA()` 메서드를 사용합니다.


Instance:FindFirstAncestorOfClass

className

찾고자 하는 `Class.Object.ClassName`입니다.


`Class.Instance`의 첫 번째 조상을 반환하며,
`Class.Object.ClassName`이 주어진 className과 같은 경우.


`Class.Instance`의 첫 번째 조상을 반환하며,
주어진 className에 대해 `Class.Object:IsA()`가 true를 반환하는 경우.

이 함수는 위로 작업하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`로 올라갑니다. 일치하는 조상을 찾지 못하면 `nil`을 반환합니다.

`Class.Instance:FindFirstAncestorOfClass()`와는 달리 이 함수는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예를 들어:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
따라서 다음 코드 샘플은 모든 `Class.BasePart` 조상을 반환하며, 그것이 `Class.WedgePart`이든,
`Class.MeshPart`이든, `Class.Part`이든 상관 없습니다.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
또한 `Class.Instance:FindFirstAncestor()`를 참조하세요.


Instance:FindFirstAncestorWhichIsA

`Class.Instance`의 첫 번째 조상을 반환하며,
주어진 className에 대해 `Class.Object:IsA()`가 true를 반환합니다.


아래 코드는 Workspace에서 객체 이름 "Brick"을 찾습니다. 찾으면,
객체의 이름을 "Foo"로 변경합니다.

주어진 이름을 가진 `Class.Instance`의 첫 번째 자식을 반환하며,
그런 자식이 존재하지 않으면 `nil`을 반환합니다. 선택적인 `recursive` 인자가
`true`인 경우, 이 함수는 `Class.Instance`의 즉각적인 자식이 아니라 모든 자손을
검색합니다.

##### 객체의 존재 확인하기

`FindFirstChild()`는 객체가 계속 진행되기 전에 존재하는지 확인할 필요가 있을 경우 필수입니다.
점 연산자를 사용하여 자식을 이름으로 인덱싱하려고 하면 자식이 존재하지 않으면 오류가 발생합니다.

```lua
local Workspace = game:GetService("Workspace")

-- 다음 줄은 파트가 작업 공간에 존재하지 않으면 오류가 발생합니다.
Workspace.Part.Transparency = 0.5
```
더 나은 방법은 먼저 `Part`를 확인하기 위해 `FindFirstChild()`를 사용한 다음,
그것이 필요할 경우 코드로 실행하는 것입니다.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

##### 속성과 이름이 일치하는 자식 찾기

때때로 객체의 `Class.Instance.Name|Name`은 그 `Class.Instance.Parent|Parent`의 속성과 동일합니다.
점 연산자를 사용할 때, 속성이 이름이 같으면 자식보다 우선합니다.

다음 예제에서 `Color`라는 이름의 `Class.Folder`가 `Class.Part`에 추가됩니다.
그러나 `Class.Part`도 `Class.Part.Color` 속성을 가지고 있습니다. `part.Color`는 자식
`Class.Folder` 인스턴스가 아니라 `Datatype.Color3` 속성 값을 참조합니다. 
`Class.Instance:FindFirstChild()|FindFirstChild()`를 사용할 때의 장점은 새로운 속성이 도입되더라도
코드에 위험을 주지 않는 것입니다.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- 속성
local c2 = part:FindFirstChild("Color")  -- 자식 폴더
```

##### 성능 노트

`Class.Instance:FindFirstChild()|FindFirstChild()`는 점 연산자를 사용하는 것보다 약 20% 더 오랜 시간이 걸리며,
단순히 객체를 참조를 저장하는 것보다 거의 8배 더 오랜 시간이 걸립니다. 따라서 성능에 의존하는 코드,
예를 들어 빡빡한 루프나 `Class.RunService.Heartbeat` 및 `Class.RunService.PreRender`에 연결된 함수에서는
이 함수를 호출하는 것을 피하세요. 대신 결과를 변수에 저장하거나, 자식의 이름이 주어진 경우 사용 가능한지를 탐지하기 위해
`Class.Instance.ChildAdded|ChildAdded` 또는 `Class.Instance:WaitForChild()|WaitForChild()`를 고려하세요.


Instance:FindFirstChild

검색할 `Class.Instance.Name`입니다.


recursive

검색이 재귀적으로 수행되어야 하는지 여부.


주어진 이름으로 찾은 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 `className`과 같은 `Class.Instance`의 첫 번째 자식을 반환합니다.
`Class.Instance:FindFirstChildWhichIsA()`와 달리 이 함수는
클래스가 `className`과 일치하는 객체만 반환하며, 클래스 상속을 무시합니다.
일치하는 자식이 없으면 이 함수는 `nil`을 반환합니다.


Instance:FindFirstChildOfClass

검색할 `Class.Object.ClassName`입니다.


주어진 클래스 이름과 같은 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 클래스 이름에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.

일치하는 자식이 없으면 이 함수는 `nil`을 반환합니다. 
선택적인 재귀 인자가 true인 경우, 이 함수는 `Class.Instance`의
즉각적인 자식이 아니라 모든 자손을 검색합니다.

`Class.Instance:FindFirstChildOfClass()`와 달리 이 함수는
`Class.Object:IsA()`를 사용하여 클래스 상속을 존중합니다. 예를 들어:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
따라서 다음 코드 샘플은 첫 번째 `Class.BasePart` 자식을 반환합니다.
그것이 `Class.WedgePart`, `Class.MeshPart` 또는 `Class.Part` 여부와 관계없이

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
이름으로 자식을 찾으려는 개발자는 대신 `Class.Instance:FindFirstChild()`를 사용해야 합니다.


Instance:FindFirstChildWhichIsA

주어진 클래스 이름에 대해 `Class.Object:IsA()`가 true를 반환하는 `Class.Instance`의 첫 번째 자식을 반환합니다.


주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.

이 메서드는 비활성화되어 사용할 수 없습니다. 인스턴스의 첫 번째 자손을 찾으려면
대신 `Class.Instance:FindFirstChild()`의 `recursive` 매개변수를 사용하세요.


Instance:FindFirstDescendant

주어진 `Class.Instance.Name`을 가진 첫 번째 자손을 반환합니다.


`Class.Instance`가 `Class.Actor`인 경우, `Class.Actor` 자체가
반환됩니다. 그렇지 않으면 가장 가까운 조상인 `Class.Actor`가 반환됩니다. 
조상 중 `Class.Actor`가 없는 경우 결과는 `nil`입니다.


Instance:GetActor

`Instance`와 연결된 `Class.Actor`를 반환합니다, 있다면.


이 메서드는 주어진 속성 이름에 할당된 값을 반환합니다. 할당된 속성이 없으면 `nil`이 반환됩니다.

예를 들어, 다음 코드 스니펫은 인스턴스의 `InitialPosition` 속성에 값을 설정한 후 이를 가져옵니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

##### 참조

- 주어진 이름으로 주어진 값을 속성에 설정하는 `Class.Instance:SetAttribute()`.
- 인스턴스의 각 속성에 대한 키-값 쌍의 사전을 반환하는 `Class.Instance:GetAttributes()`.


Instance:GetAttribute

주어진 속성 이름에 할당된 값입니다. 속성이 할당되지 않은 경우에는 `nil`이 반환됩니다.


주어진 속성 이름에 할당된 값을 반환합니다.


이 함수는 `Class.Object.Changed|Changed` 이벤트와 동일하게 작동하는 이벤트를 반환하지만, 특정 주어진 속성이 변경될 때만 발생합니다; 효과적으로는 `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()`와 유사하지만 속성에 대한 것입니다.

이 메소드 대신 `Class.Object.Changed|Changed`에 대한 함수와 함께 속성 이름을 확인하는 연결을 사용하는 것이 일반적으로 좋습니다. 동일한 객체에서 동일한 속성 이름으로 이 메소드를 후속 호출하면 동일한 이벤트가 반환됩니다.

다음 코드 예제는 부분의 `InitialPosition` 속성이 변경될 때 `attributeChanged()` 함수를 발생시키는 신호를 반환합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("속성이 변경되었습니다.")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```

`Class.Instance.AttributeChanged`도 참조하십시오. 인스턴스에서 속성이 변경될 때마다 발생합니다.


Instance:GetAttributeChangedSignal

변경 신호가 반환되는 지정된 속성의 이름입니다.


주어진 속성이 변경될 때 발생하는 이벤트입니다.


주어진 속성이 변경될 때 발생하는 이벤트를 반환합니다.


이 메소드는 속성의 이름을 키로 하고 `nil`이 아닌 값을 값으로 가지는 키-값 쌍의 사전을 반환합니다.

예를 들어, 다음 코드 조각은 인스턴스의 속성과 값을 출력합니다:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```

`Class.Instance:GetAttribute()`도 참조하십시오. 주어진 속성 이름에 할당된 값을 반환합니다.


Instance:GetAttributes

속성의 이름이 키이고 `nil`이 아닌 값이 값을 가지는 문자열 → 변형 쌍의 사전입니다.


인스턴스의 속성 사전을 반환합니다.


아래 코드는 실행 시 워크스페이스에 있는 모든 객체의 이름을 출력합니다.

이 함수는 인스턴스의 모든 직계 자식, 또는 객체와 `Class.Instance.Parent|Parent`가 동일한 모든 `Class.Instance`를 포함하는 배열(숫자 인덱스 테이블)을 반환합니다. 배열은 숫자 또는 일반 루프를 사용하여 반복할 수 있습니다:

```lua
local Workspace = game:GetService("Workspace")

-- 숫자 for 루프 예제
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. "는 자식 번호 " .. i .. "입니다.")
end
```

```lua
local Workspace = game:GetService("Workspace")

-- 일반 for 루프 예제
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. "는 자식 번호 " .. i .. "입니다.")
end
```
자식들은 그들의 `Class.Instance.Parent|Parent` 속성이 객체에 설정된 순서에 따라 정렬됩니다.

`Class.Instance:GetDescendants()|GetDescendants` 함수도 참조하십시오.


Instance:GetChildren

인스턴스의 자식 객체를 포함하는 배열입니다.


인스턴스의 모든 자식 객체를 포함하는 배열을 반환합니다.


이 함수는 Roblox 내부에서 사용되는 디버그 ID의 코드화된 문자열을 반환합니다. 주의:

- 이 항목은 보호됩니다. `Class.Script`나 `Class.LocalScript`에서 사용하면 오류가 발생합니다.
- 디버그 ID는 디버깅 프로세스에서 사용되는 ID입니다. 이는 디버거가 응용 프로그램이 처리하기 전에 각 명령어를 읽을 수 있도록 합니다. Roblox의 모든 객체는 프로세스처럼 작동하며 필요에 따라 디버깅할 수 있는 모든 실행 명령(또는 '코드')을 가지고 있습니다.
- 이는 비슷한 객체를 구별하는 데 도움이 될 수 있습니다(예: 동일한 이름을 가진 객체).


Instance:GetDebugId

scopeLength

Roblox 내부에서 사용되는 디버그 ID의 코드화된 문자열을 반환합니다.


GetDescendants는 특정 유형의 객체에 속한 모든 자손에게 무언가를 수행하는 데 자주 사용됩니다. 이 예제의 코드는 GetDescendants와
`Class.Instance:IsA()`를 사용하여 작업 공간의 모든 부품을 찾아 녹색으로 변경합니다.

이 객체 메소드는 해당 객체의 모든 자손을 포함하는 배열을 반환합니다. `Class.Instance:GetChildren()`와 달리, 즉시 자식을 반환하는 이 메소드는 객체의 모든 자식과 그 자식의 모든 자식을 찾습니다.


Instance:GetDescendants

인스턴스의 자손을 포함하는 배열입니다.


인스턴스의 모든 자손을 포함하는 배열을 반환합니다.


이 코드 샘플은 `Class.Instance:GetFullName()`의 동작을 보여줍니다.
`DataModel` 계층에 없는 객체에서 호출될 때 함수가 어떻게 작동하는지 보여주며, 
반환값이 특수 문자를 탈출하지 않는 방법도 보여줍니다.

이 코드 샘플은 `Class.Instance:GetFullName()` 함수를 Lua로 다시 구현합니다.

인스턴스의 조상을 설명하는 문자열을 반환합니다. 문자열은 객체와 그 조상들의 `Class.Instance.Name|Name`을 연결하여 마침표로 구분합니다. `Class.DataModel`(`game`)은 고려되지 않습니다. 예를 들어, `Class.Workspace`의 `Class.Part`는 `Class.Workspace.Part`를 반환할 수 있습니다.

`Class.DataModel`의 자손이 아닌 `Class.Instance`에서 호출할 때, 이 함수는 `Class.Instance.Parent|Parent`가 없는 가장 상위 조상까지 모든 조상을 고려합니다.

이 함수는 로깅 및 디버깅에 유용합니다. 반환된 문자열을 유용한 작업을 위해 구문 분석하려고 시도해서는 안 됩니다; 이 함수는 객체 이름에서 마침표(또는 다른 기호)를 이스케이프하지 않습니다. 다시 말해, 출력은 종종 유효한 Luau 식별자인 것처럼 보이지만 보장되지는 않습니다.


Instance:GetFullName

`Class.Instance`의 전체 이름입니다.


인스턴스의 조상을 설명하는 문자열을 반환합니다.


이 메소드는 지정된 속성의 스타일링된 또는 명시적으로 수정된 값을 반환합니다. 스타일링/수정되지 않았다면 기본 속성 값을 반환합니다. 이는 `[GuiObject].Rotation`과 같은 속성 값을 직접 접근하는 것과는 약간 다릅니다. 이는 속성의 기본값 또는 수정된 값을 반환합니다.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- 버튼 참조
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (기본값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 규칙 속성을 통해 회전 적용
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (규칙에 따른 스타일 값)
print(button.Rotation) --> 0 (기본값)

-- 스타일 속성을 명시적으로 수정/재정의
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (수정된 값)
print(button.Rotation) --> 45 (수정된 값)
```


Instance:GetStyled

지정된 속성의 스타일링된 또는 명시적으로 수정된 값, 또는 스타일링/수정되지 않았다면 기본 속성 값입니다.


지정된 속성의 스타일링된 또는 명시적으로 수정된 값을 반환합니다. 스타일링/수정되지 않았다면 기본 속성 값을 반환합니다.


이 메소드는 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 이벤트와 동일하게 작동하는 이벤트를 반환하지만, 주어진 스타일 속성이 변경될 때만 발생합니다. 이러한 속성 이름을 확인하는 함수와 함께 `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`에 대한 연결 대신 이 메소드를 사용하는 것이 일반적으로 좋습니다. 동일한 객체에서 동일한 속성 이름으로 이 메소드를 후속 호출하면 동일한 이벤트가 반환됩니다.

이 이벤트는 연결된 함수에 인수를 전달하지 않으므로, 변경된 속성의 값은 스크립트 내에서 직접 읽어야 합니다.

```lua
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("스타일 속성이 변경되었습니다!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```


Instance:GetStyledPropertyChangedSignal

property

변경 사항을 수신 대기할 스타일 속성의 이름입니다.


주어진 스타일 속성이 변경될 때 발생하는 이벤트입니다.


이 메소드는 지정된 인스턴스에 적용된 태그의 배열을 문자열로 반환합니다. Studio의 [속성](/studio/properties) 창에서 또는 런타임에서 `Class.Instance:AddTag()|AddTag()`를 사용하여 태그를 추가할 수 있습니다.

이 메소드는 한 번에 여러 태그로 작업할 때 유용합니다. 그러나 단일 태그의 존재 여부를 확인하기 위해 이 메소드를 사용하는 것은 비효율적입니다. 대신 특정 태그를 확인하기 위해 `Class.Instance:HasTag()|HasTag()`를 사용하세요.


Instance:GetTags

인스턴스에 적용된 모든 태그의 배열을 가져옵니다.


이 메소드는 제공된 태그가 객체에 추가되었으면 `true`를 반환합니다. Studio의 [속성](/studio/properties) 창에서 또는 런타임에 `Class.Instance:AddTag()|AddTag()`를 사용하여 태그를 추가할 수 있습니다.


Instance:HasTag

인스턴스가 주어진 태그를 가지고 있는지 확인합니다.


Instance

`Instance`는 Roblox 클래스 계층의 모든 클래스의 기본 클래스입니다
`Class.DataModel` 트리에 포함될 수 있습니다.
