`Class.Texture` 객체는 부모 `Class.BasePart`의 면에 반복 이미지 텍스처를 적용합니다. 영향을 받는 면은
`Class.Texture.Face|Face` 속성에 따라 달라집니다. `Class.Decal|Decals`와는 달리 `Class.Texture`에 의해 적용된 텍스처는
부모 `Class.BasePart` 크기가 조정될 때 반복되며, 반복 텍스처의 크기는
`Class.Texture.StudsPerTileU|StudsPerTileU` 및
`Class.Texture.StudsPerTileV|StudsPerTileV` 속성에 의해 결정됩니다.

적용된 이미지 텍스처는 그
`Class.Texture.ColorMapContent|ColorMapContent` 속성에 의해 결정됩니다. 이미지를 업로드하는 방법에 대한 자세한 내용은
[자산 관리](/projects/assets#asset-management)를 참조하세요.

자세한 내용을 보려면
[텍스처 및 데칼](/parts/textures-decals)을 검토하세요. 추가 정보:

- 비반복 표면 이미지를 위한 `Class.Decal`
- `Class.MeshPart`에 이미지 텍스처를 적용하기 위한 `Class.MeshPart.TextureContent`
- 경험 내 3D 객체에 `Class.ImageLabel` 또는 `Class.ImageButton`을 적용하기 위한 `Class.SurfaceGui`


Texture

이 속성은 렌더링된 질감이 수평 축에서 얼마만큼 오프셋되는지를 결정하며, 스터드 단위로 표시됩니다. [여기](/parts/textures-decals#offset-textures)에서 시각화된 바와 같이 나타납니다.

또한 `Class.Texture.OffsetStudsV|OffsetStudsV`를 참조하세요.

Texture.OffsetStudsU

렌더링된 텍스처의 수평 좌표의 스텐다드 오프셋을 결정합니다.

이 속성은 렌더링된 텍스처가 수직 축에서 얼마나 떨어져 있는지를 스터드 단위로 결정하며,
[여기](/parts/textures-decals#offset-textures)에서 시각화되어 있습니다.

또한 `Class.Texture.OffsetStudsU|OffsetStudsU`를 참조하세요.


Texture.OffsetStudsV

렌더링된 텍스처의 수직 좌표의 스텐다드 오프셋을 결정합니다.

`Class.Texture`에 의해 적용된 타일 이미지의 수평 크기를 스텐다드로 설정합니다.

이 속성에 대한 큰 값은 `Class.Texture`가 더 크게 보이고, 반복 빈도가 낮아지게 합니다. `Class.Decal|Decals`와는 달리, 반복된 이미지의 크기는 `Class.BasePart`의 크기에 영향을 받지 않습니다. 대신, `Class.BasePart`의 크기를 조정하면 텍스처가 반복되는 횟수만 증가합니다.

이 속성과는 상관없이 매우 낮은 값으로 설정할 수 있지만, 0으로 설정할 수는 없습니다. 또한 수평/수직 구분은 부모 `Class.BasePart` 축에 상대적입니다. 따라서 `Class.Texture`는 `Class.BasePart`와 함께 회전합니다.

`Class.Texture.StudsPerTileV|StudsPerTileV`도 참고하세요.

Texture.StudsPerTileU

`Class.Texture`에 의해 적용된 타일 이미지의 수평 크기를 스텐다드로 설정합니다.

`Class.Texture`에 의해 적용된 타일 이미지의 수직 크기를 스텐다드로 설정합니다.

이 속성에 대한 큰 값은 `Class.Texture`가 더 크게 보이고, 반복 빈도가 낮아지게 합니다. `Class.Decal|Decals`와는 달리, 반복된 이미지의 크기는 `Class.BasePart`의 크기에 영향을 받지 않습니다. 대신, `Class.BasePart`의 크기를 조정하면 텍스처가 반복되는 횟수만 증가합니다.

이 속성과는 상관없이 매우 낮은 값으로 설정할 수 있지만, 0으로 설정할 수는 없습니다. 또한 수평/수직 구분은 부모 `Class.BasePart` 축에 상대적입니다. 따라서 `Class.Texture`는 `Class.BasePart`와 함께 회전합니다.

`Class.Texture.StudsPerTileU|StudsPerTileU`도 참고하세요.

Texture.StudsPerTileV

`Class.Texture`에 의해 적용된 타일 이미지의 수직 크기를 스텐다드로 설정합니다.

`Class.BasePart`의 면에 반복되는 이미지 질감을 적용합니다.

다음 코드는 바닥에 `Decal`이 적용된 `Part`를 생성합니다.
플레이어가 그 위를 지나갈 때와 같이 무언가가 파트를 치면,
디칼에 적용된 텍스처가 변경되고 소리가 재생됩니다.


아래 코드는 `TweenService`와 `Class.Decal.Transparency`를 사용하여 서서히 나타나고 사라지는 투명한 `Part`를 생성합니다.


`Class.Decal` 객체는 부모 `Class.BasePart`의 면에 이미지 텍스처를 적용합니다. 영향을 받는 면은 `Class.Decal.Face|Face` 속성에 따라 달라지며, 데칼의 크기는 면의 크기에 따라 결정됩니다.

적용된 이미지 텍스처는 `Class.Decal.ColorMapContent|ColorMapContent` 속성에 의해 결정됩니다. 이미지를 업로드하는 방법에 대한 자세한 내용은 [자산 관리](/projects/assets#asset-management)를 참조하십시오.

자세한 정보는 [텍스처 및 데칼](/parts/textures-decals)을 검토하십시오. 또한:

- 반복되는 표면 이미지를 위한 `Class.Texture`.
- `Class.MeshPart`에 이미지 텍스처를 적용하기 위한 `Class.MeshPart.TextureContent`.
- 경험 내 3D 객체에 `Class.ImageLabel` 또는 `Class.ImageButton`을 적용하기 위한 `Class.SurfaceGui`.

Decal

`true`로 설정하면 데칼의 이미지 자산이 자동
로컬라이제이션을 통해 Automatic Asset Capture 시스템에 의해 캡처됩니다. `Class.LocalizationService`는 이 속성을 사용하여 데칼의 `Class.Decal.ColorMapContent|ColorMapContent`가 캡처되어 로컬라이즈된 버전으로 교체될 수 있는지를 결정합니다.

이 속성은 비-PBR 데칼에만 적용됩니다. PBR 맵(`Class.Decal.NormalMapContent|NormalMapContent`, `Class.Decal.RoughnessMapContent|RoughnessMapContent`, 또는 `Class.Decal.MetalnessMapContent|MetalnessMapContent`)이 설정된 경우, 일관되지 않은 렌더링을 피하기 위해 자동 로컬라이제이션 캡처가 억제됩니다.


Decal.AutoLocalize

`true`로 설정하면 데칼의 이미지 자산이 자동
로컬라이제이션 캡처에 적합합니다.


이 코드 샘플은 작업 공간에 `Decal`을 생성하고 `Class.Decal.Color3` 속성을 `Class.TweenService`를 사용하여 반복적으로 변경합니다.

`Class.Decal`의 `Datatype.Color3` 색조입니다. 이 속성은 데칼의 **색조**만 설정하며 색상은 설정하지 않습니다. `Class.Decal`과 연결된 이미지가 원래 순수한 흰색이 아닌 경우, 이 속성을 사용하여 색상을 자유롭게 변경할 수 없습니다.


Decal.Color3

`Class.Decal`의 `Datatype.Color3` 색조입니다.


이 속성은 표면의 색상과 불투명도를 결정하는 콘텐츠 ID를 사용합니다. 이 텍스처는 때때로 **알베도** 텍스처라고 불립니다.


Decal.ColorMap

표면의 색상과 불투명도를 결정하는 콘텐츠 ID입니다.


이 속성은 표면의 색상과 불투명도를 결정하는 `Datatype.Content` 객체를 사용합니다. 이 텍스처는 때때로 **알베도** 텍스처라고 불립니다.


Decal.ColorMapContent

표면의 색상과 불투명도를 결정하는 `Datatype.Content` 객체입니다.


데칼의 `Class.Decal.Transparency|Transparency` 속성에 대한 배수 역할을 합니다. 효과는 `Class.Players.LocalPlayer|LocalPlayer`에게만 표시되며 서버에 복제되지 않습니다.

이 속성이 `1`로 설정되면, `Class.Decal`은 원래의 투명도와 관계없이 완전히 보이지 않게 됩니다. `0`으로 설정되면, 데칼의 렌더링된 투명도는 `Class.Decal.Transparency|Transparency` 값과 일치합니다.


Decal.LocalTransparencyModifier

데칼의 `Class.Decal.Transparency|Transparency` 속성에 대한 배수 역할을 합니다. 효과는 로컬 플레이어에게만 표시됩니다.


이 속성은 표면에 적용되는 금속성 맵을 결정하는 콘텐츠 ID를 사용합니다. 금속성 맵은 표면이 각 지점에서 얼마나 금속처럼 보이는지를 제어하며, 비금속과 금속의 빛에 대한 반응 사이를 혼합합니다. 기본값은 빈 콘텐츠이며, 이 경우 금속성 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다. `Datatype.Content` 객체에서 이 맵을 할당하려면 `Class.Decal.MetalnessMapContent|MetalnessMapContent`를 사용하십시오.


Decal.MetalnessMap

표면의 금속성 맵을 결정하는 콘텐츠 ID입니다.


이 속성은 표면에 적용되는 금속성 맵을 결정하는 `Datatype.Content` 객체를 사용합니다. 금속성 맵은 표면이 각 지점에서 얼마나 금속처럼 보이는지를 제어하며, 비금속과 금속의 빛에 대한 반응 사이를 혼합합니다. 기본값은 빈 콘텐츠이며, 이 경우 금속성 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다.


Decal.MetalnessMapContent

표면의 금속성 맵을 결정하는 `Datatype.Content` 객체입니다.


이 속성은 표면에 적용되는 노멀 맵을 결정하는 콘텐츠 ID를 사용합니다. 노멀 맵은 조명 계산에 사용되는 표면 노멀을 왜곡하여, 기하학적 구조를 변경하지 않고도 돌기와 홈과 같은 세부 사항의 외관을 추가합니다. 기본값은 빈 콘텐츠이며, 이 경우 노멀 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다. `Datatype.Content` 객체에서 이 맵을 할당하려면 `Class.Decal.NormalMapContent|NormalMapContent`를 사용하십시오.


Decal.NormalMap

표면의 노멀 맵을 결정하는 콘텐츠 ID입니다.


이 속성은 표면에 적용되는 노멀 맵을 결정하는 `Datatype.Content` 객체를 사용합니다. 노멀 맵은 조명 계산에 사용되는 표면 노멀을 왜곡하여, 기하학적 구조를 변경하지 않고도 돌기와 홈과 같은 세부 사항의 외관을 추가합니다. 기본값은 빈 콘텐츠이며, 이 경우 노멀 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다.


Decal.NormalMapContent

표면의 노멀 맵을 결정하는 `Datatype.Content` 객체입니다.


이 속성은 데칼 텍스처의 회전 각도를 도 단위로 제어합니다. 회전은 UV 좌표에 시계 방향으로 적용됩니다.


Decal.Rotation

이 속성은 표면에 적용되는 거칠기 맵을 결정하는 콘텐츠 ID를 사용합니다. 거칠기 맵은 표면이 각 지점에서 얼마나 거칠거나 매끄럽게 보이는지를 제어하며, 이는 반사광이 얼마나 선명하거나 흐릿하게 보이는지를 결정합니다. 기본값은 빈 콘텐츠이며, 이 경우 거칠기 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다. `Datatype.Content` 객체에서 이 맵을 할당하려면 `Class.Decal.RoughnessMapContent|RoughnessMapContent`를 사용하십시오.


Decal.RoughnessMap

표면의 거칠기 맵을 결정하는 콘텐츠 ID입니다.


이 속성은 표면에 적용되는 거칠기 맵을 결정하는 `Datatype.Content` 객체를 사용합니다. 거칠기 맵은 표면이 각 지점에서 얼마나 거칠거나 매끄럽게 보이는지를 제어하며, 이는 반사광이 얼마나 선명하거나 흐릿하게 보이는지를 결정합니다. 기본값은 빈 콘텐츠이며, 이 경우 거칠기 맵이 적용되지 않습니다.

노멀, 거칠기 또는 금속성 맵을 할당하면 `Class.Decal`이 물리 기반 렌더링(PBR) 표면이 됩니다.


Decal.RoughnessMapContent

표면의 거칠기 맵을 결정하는 `Datatype.Content` 객체입니다.


이 속성은 데칼이 얼마나 빛나는지를 결정합니다. `0`과 `1` 사이의 값을 사용하며, `1`은 "완전히 빛나는" 상태입니다.


Decal.Shiny

이전에는 데칼의 광택을 설정했던 사용 중단된 속성입니다.


표면이 빛에 반응하는 방식을 설정합니다.


Decal.Specular

이전에는 데칼의 반사율을 설정했던 사용 중단된 속성입니다.


`Class.Decal`에 적용될 이미지의 콘텐츠 ID입니다.


Decal.Texture

`Class.Decal`에 의해 표시되는 텍스처 콘텐츠입니다. [자산 URI](/projects/assets#asset-uris) 및 `Class.EditableImage` 객체를 지원합니다.


Decal.TextureContent

`Class.Decal`에 의해 표시되는 텍스처 콘텐츠입니다.


엔진에서 관리되며 스크립트에서 접근할 수 없습니다. 데칼의 압축된 런타임 텍스처 데이터를 보유하는 `Datatype.Content`입니다. `Class.Decal`이 물리 기반 렌더링(PBR) 표면일 때, 엔진은 색상, 노멀, 거칠기 및 금속성 맵을 단일 텍스처 팩 자산으로 패킹하고 여기에서 참조합니다. 기본값은 빈 콘텐츠입니다.


Decal.TexturePackContent

엔진에서 관리하는 `Datatype.Content`로, PBR 데칼의 압축된 런타임 텍스처 팩 데이터를 저장합니다.


`Class.Decal`의 투명도를 결정하며, `0`은 완전히 불투명하고 `1`은 완전히 투명합니다.

`Class.Decal.LocalTransparencyModifier|LocalTransparencyModifier`는 이 투명도 수준에 대한 **배수** 역할을 하며, 데칼의 투명도가 다른 스크립트에 의해 변경될 가능성이 있을 때 사용해야 합니다.


Decal.Transparency

`Class.Decal`의 투명도를 결정합니다.


이 속성은 UV 좌표 변환을 제어합니다. `Datatype.Vector2.X|X` 값(**U**&nbsp;오프셋)과 `Datatype.Vector2.Y|Y` 값(**V**&nbsp;오프셋)이 텍스처 매핑 중 모든 해당 UV 좌표에 추가됩니다.


Decal.UVOffset

텍스처 매핑 전에 오프셋을 추가하여 UV 좌표를 이동합니다.


이 속성은 수평 및 수직 좌표에 적용되는 스케일을 제어합니다. `Datatype.Vector2.X|X` 값(**U**&nbsp;스케일)과 `Datatype.Vector2.Y|Y` 값(**V**&nbsp;스케일)이 텍스처 매핑 중 모든 해당 UV 좌표에 곱해집니다.


Decal.UVScale

스케일 팩터를 곱하여 UV 좌표를 늘리거나 압축합니다.


이 속성은 `Class.BasePart`의 동일한 `Class.Decal.Face|Face`에 있는 데칼이 렌더링되는 순서를 결정합니다. 낮은 값이 먼저 렌더링되므로, 더 높은 `ZIndex`를 가진 데칼이 더 낮은 `ZIndex`를 가진 데칼 위에 렌더링됩니다.

미래에 두 개의 기존 데칼 사이에 데칼을 레이어링해야 할지 확실하지 않은 경우, `ZIndex` 값 사이에 `10` 또는 `100`과 같은 더 큰 간격을 사용하여 미래의 데칼을 위한 공간을 확보하십시오.


Decal.ZIndex

여러 데칼이 동일한 면에 할당될 때 렌더링 순서를 결정합니다.


부모 `Class.BasePart`의 면에 이미지 텍스처를 적용합니다.

`Class.FaceInstance`는 `Class.Decal` 및
`Class.Texture` 클래스가 상속받는 추상 클래스입니다.

FaceInstance

객체가 상위 `Class.BasePart`의 어느 면에 나타나는지를 설정합니다.

FaceInstance.Face

`Class.Decal` 및 `Class.Texture` 클래스가 상속받는 추상 클래스입니다.


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

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


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

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

이 인스턴스가 재부모화되거나 그 조상 중 하나가 재부모화될 때 발생합니다.

이 이벤트를 사용하여 스튜디오에서 인스턴스의 삭제를 추적할 수 있습니다. 예를 들어 탐색기에서 수동으로 삭제하거나 플러그인을 통해 삭제하는 경우입니다. `Class.Instance:Destroy()`를 사용하여 인스턴스가 파괴될 때를 감지해야 하는 경우, 대신 `Class.Instance.Destroying` 이벤트를 사용하세요.


Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` 속성이 변경된 인스턴스입니다. 이 인스턴스 또는 더 먼 조상이 될 수 있으며, 반드시 핸들러가 연결된 인스턴스일 필요는 없습니다.


parent

`child` 매개변수의 새로운 부모입니다.


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


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

예를 들어, 다음 코드 조각은 파트의 속성 중 하나가 변경될 때마다 `attributeChanged()` 함수를 연결합니다:

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

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

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


Instance.AttributeChanged

attribute

인스턴스에서 속성이 변경될 때마다 발생합니다.


이 코드 조각은 객체가 Workspace에 추가될 때 그 이름을 출력합니다:


이 `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`에 자식이 추가된 후 발생합니다.


Instance.childAdded

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


이 `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`의 자손이 제거되기 직전에 발생합니다.


이 샘플은 즉시 신호 동작을 사용할 때 인스턴스가 파괴되더라도 연결된 함수가 yield될 때까지 그대로 유지된다는 것을 보여줍니다.

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

연결된 함수가 여전히 사용 중인 동안 `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` 이벤트에 연결하는 것이 문제가 됩니다. 스크립트가 콜백이 호출되기 전에 파괴되기 때문입니다(즉, 실행되지 않습니다).

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


Instance.Destroying

인스턴스가 `Class.Instance:Destroy()`를 통해 파괴되기 직전에 발생합니다.


 `Class.Instance.StyledPropertiesChanged`를 보여줍니다.


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


Instance.StyledPropertiesChanged

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


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

#### 경고

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

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


Instance:AddTag

인스턴스에 적용할 태그입니다.


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


자식 함수는 객체의 자식 배열을 반환합니다.


Instance:children

자식 객체/인스턴스의 배열입니다.


객체의 자식 배열을 반환합니다.


이 메서드는 인스턴스의 모든 자식과 자손을 파괴합니다.

```
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`가 아닌 경우 `nil`입니다.


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


Instance:clone

`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()`를 호출합니다.


Instance:destroy

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

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `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`의 첫 번째 조상을 반환합니다.


주어진 className과 같은 `Class.Object.ClassName`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `Class.Instance.Parent`에서 시작하여
`Class.DataModel`까지 올라갑니다. 일치하는 조상이 없으면 `nil`을 반환합니다.

이 메서드의 일반적인 사용은 `Class.BasePart`가 속한 `Class.Model`을 찾는 것입니다. 예를 들어:

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


Instance:FindFirstAncestorOfClass

className

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


주어진 className과 같은 `Class.Object.ClassName`을 가진 `Class.Instance`의 첫 번째 조상을 반환합니다.


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

이 메서드는 위로 작동하며, 인스턴스의 즉각적인 `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

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


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

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

#### 객체 존재 확인

`FindFirstChild()`는 객체가 존재하는지 확인해야 할 경우 필요합니다.
이름을 사용하여 자식을 인덱싱하려고 하면 자식이 존재하지 않으면 오류가 발생합니다.

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

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

```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.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`의 첫 번째 자식을 반환합니다.


Instance:findFirstChild

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


Instance:FindFirstChildOfClass

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


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

일치하는 자식이 없으면 이 메서드는 `nil`을 반환합니다. 선택적 `recursive` 인수가 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

주어진 className에 대해 `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

인스턴스와 연결된 `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`의 `Class.Instance.Parent|Parent`가 객체와 같은 모든 `Class.Instance`입니다.
배열은 숫자 또는 일반 `for` 루프를 사용하여 반복할 수 있습니다:

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

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

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

-- 일반 루프 예제
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. "는 자식 번호 " .. i)
end
```
반환된 배열은 **특정 순서로 정렬되지 않으므로**, 수동 정렬(예: `Library.table.sort()`)을 권장합니다.
이 메서드에 의해 반환된 자식을 정렬합니다.

또한 `Class.Instance:GetDescendants()|GetDescendants()` 메서드를 참조하십시오.


Instance:GetChildren

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


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


Instance:getChildren

Instance

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


요약