O objeto WrapTarget define um alvo. Um alvo é o corpo 3D com apenas uma
superfície externa, ou uma Capa Externa.

Esse alvo, frequentemente um Avatar, é o que acessórios 3D (usando WrapLayer) serão
aplicados, permitindo que vários itens de acessórios se sobreponham
naturalmente ao alvo de origem.

Cria uma nova `Class.EditableImage` transferindo `texture` do espaço UV do `Class.WrapTarget` pai para o espaço UV da gaiola do WrapTarget. Este método aguarda até que a transferência esteja completa e não modifica a imagem de entrada.

Por exemplo, após um jogador pintar maquiagem em uma malha de cabeça em uma ferramenta de criação dentro da experiência, use este método para transferir a textura para o espaço UV da gaiola antes de enviá-la para uso com `Class.WrapTextureTransfer`. Este método também suporta transferências de textura no espaço da gaiola não relacionadas à maquiagem. Para transferir uma textura na direção oposta, use `Class.WrapTarget:CreateTextureInTargetSpaceAsync()`.

Use `options` para especificar uma região do espaço UV da gaiola. Cada limite fornecido deve ser um `Datatype.Vector2` finito. Se ambos os limites forem fornecidos, `MaxUVBounds` deve ser maior que `MinUVBounds` em ambos os eixos. Chaves de opção não reconhecidas geram um erro.

Este método requer que o WrapTarget esteja parentado a um `Class.MeshPart` com dados de malha e gaiola válidos. Ele gera um erro se a entrada ou opções forem inválidas, se os dados de malha necessários não puderem ser carregados ou se a transferência falhar. Se o orçamento de memória editável específico do dispositivo for esgotado, ele retorna `nil`. Consulte `Class.EditableImage` para requisitos adicionais de uso.


WrapTarget:CreateTextureInCageSpaceAsync

texture

A `Class.EditableImage` no espaço UV do `Class.WrapTarget` pai.


options

Dicionário opcional contendo controles para a transferência:

- `MinUVBounds` – Um `Datatype.Vector2` especificando o limite mínimo da gaiola UV.
- `MaxUVBounds` – Um `Datatype.Vector2` especificando o limite máximo da gaiola UV.

Cada limite omitido é calculado a partir da malha da gaiola. Se nenhum for especificado, os limites incluem toda a gaiola.


Uma nova `Class.EditableImage` no espaço UV da gaiola, ou `nil` se o orçamento de memória editável específico do dispositivo for esgotado.


Cria uma nova `Class.EditableImage` no espaço UV da gaiola a partir de uma textura no espaço UV do `Class.MeshPart` pai.


Cria uma nova `Class.EditableImage` transferindo `texture` do espaço UV da gaiola para o espaço UV do `Class.WrapTarget` pai. Este método aguarda até que a transferência esteja completa e não modifica a imagem de entrada.

O `wrapTextureTransfer` fornece a gaiola de referência opcional através de `Class.WrapTextureTransfer.ReferenceCageMeshContent` e os limites UV da gaiola através de `Class.WrapTextureTransfer.UVMinBound` e `Class.WrapTextureTransfer.UVMaxBound`. Use um WrapTextureTransfer sob um `Class.Decal` na mesma MeshPart que o WrapTarget.

Por exemplo, use este método para transferir uma textura de maquiagem que você possui para o espaço UV de uma malha de cabeça para que os jogadores possam editá-la diretamente na cabeça em uma ferramenta de criação dentro da experiência. Este método também suporta transferências de textura no espaço de destino não relacionadas à maquiagem. Para transferir a textura editada de volta para o espaço UV da gaiola, use `Class.WrapTarget:CreateTextureInCageSpaceAsync()`.

Este método requer que o WrapTarget esteja parentado a um `Class.MeshPart` com dados de malha e gaiola válidos. Ele gera um erro se qualquer entrada for inválida, se os dados de malha necessários não puderem ser carregados ou se a transferência falhar. Se o orçamento de memória editável específico do dispositivo for esgotado, ele retorna `nil`. Consulte `Class.EditableImage` para requisitos adicionais de uso.


WrapTarget:CreateTextureInTargetSpaceAsync

A `Class.EditableImage` no espaço UV da gaiola.


wrapTextureTransfer

O `Class.WrapTextureTransfer` associado ao mesmo `Class.MeshPart` pai que este `Class.WrapTarget`.


Uma nova `Class.EditableImage` no espaço UV do `Class.MeshPart` pai, ou `nil` se o orçamento de memória editável específico do dispositivo for esgotado.


Cria uma nova `Class.EditableImage` no espaço UV do `Class.MeshPart` pai a partir de uma textura no espaço UV da gaiola.


WrapTarget

Define a cor usada para a renderização de depuração. Veja `Class.WrapTarget.DebugMode`

WrapTarget.Color

Define a cor usada para a renderização de depuração. Veja `Class.WrapTarget.DebugMode`.

Permite alternar entre diferentes modos de visualização de depuração para as malhas da
capa.

WrapTarget.DebugMode

Define o quanto a malha do corpo pode ser comprimida pelas roupas. Roupas super ajustadas
podem levar a uma interseção entre a malha das roupas e a malha do corpo. Para resolver
esse artefato visual, o deformador pode comprimir ligeiramente a malha do corpo para
resolver possíveis interseções.

O intervalo válido é de 0 a 1. Um valor de 0 comprime a malha do corpo o máximo que for
necessário para garantir que as interseções sejam eliminadas (partes do corpo visíveis
podem parecer um pouco deformadas). Um valor de 1 evitará que a malha do corpo seja
comprimida (pode levar a interseções visíveis ou Z-fighting). Um valor de 0.9 (padrão)
és uma configuração razoável que resolve a maioria das interseções sem introduzir
deformação significativa no corpo.

WrapTarget.Stiffness

Define o quanto a malha do corpo pode ser comprimida pelas roupas.

O objeto WrapTarget define um alvo. Um alvo é o corpo 3D com apenas uma
superfície externa, ou uma Capa Externa.

A classe base para objetos `Class.WrapTarget` e `Class.WrapLayer`. Note que
`Class.MeshPart` é o único tipo de pai válido para `Class.BaseWrap` e que
se comporta mais como um componente de `Class.MeshPart` do que como um objeto
independente.

BaseWrap

A malha de gaiola que este wrap usa para deformar a geometria, armazenada como um
valor `Datatype.Content` que pode referenciar um ativo de malha carregado ou um
`Class.EditableMesh` em memória. Definido automaticamente pelo Importer. É
o armazenamento de apoio para `Class.BaseWrap.CageMeshId`: essa propriedade lê o
ID da malha deste conteúdo, e definir qualquer um mantém ambos em sincronia e
gera uma alteração em ambos.

Por padrão, é um `Datatype.Content` vazio. Sem uma gaiola válida, o wrap
não pode contribuir para a deformação de roupas em camadas para `Class.WrapLayer` ou
`Class.WrapTarget`.


BaseWrap.CageMeshContent

A malha de gaiola que este wrap usa para deformar a geometria, armazenada como um
valor `Datatype.Content`.


Essa propriedade é configurada automaticamente pelo Importador 3D.

ID do ativo para a malha do cage.

BaseWrap.CageMeshId

Essa propriedade é configurada automaticamente pelo Importador 3D.

Deslocamento da malha do cage em relação ao pai `Class.MeshPart`.

BaseWrap.CageOrigin

Deslocamento da malha do cage em relação ao pai `Class.MeshPart`.

Deslocamento da malha do cage no espaço do mundo.

BaseWrap.CageOriginWorld

Esta propriedade não é acessível através de scripts, mas é visível na janela de Propriedades para qualquer objeto `Class.BaseWrap`. Ela referencia dados pré-calculados que determinam quais triângulos de malha estão ocultos quando as camadas de roupa se sobrepõem.

BaseWrap.HSRAssetId

ID do ativo para os dados de remoção de superfície oculta (HSR) usados por roupas em camadas.

Dados de remoção de superfície oculta (HSR) para este wrap, armazenados como um
valor `Datatype.Content` que referencia um ativo de malha pré-computado. É
o armazenamento de apoio para `Class.BaseWrap.HSRAssetId`: essa propriedade lê o
ID do ativo deste conteúdo, e definir qualquer um mantém ambos em sincronia.

O conteúdo determina quais triângulos de malha estão ocultos quando as
camadas de roupas se sobrepõem, para que a geometria ocluída possa ser
removida durante a deformação de roupas em camadas. Gerado automaticamente quando um
`Class.BaseWrap` é publicado; você não precisa defini-lo manualmente.


BaseWrap.HSRContent

Os dados de remoção de superfície oculta para este wrap, armazenados como um
valor `Datatype.Content`.


Demonstra `Class.BaseWrap.ImportOrigin`.


Esta propriedade é configurada automaticamente pelo Importador 3D.

Descreve onde estava o zero global enquanto se criava a malha de gaiola em uma
ferramenta de criação de ativos como Blender ou Maya. Esta propriedade não é usada pelo
deformador, mas é útil para ferramentas/scripts de alinhamento, por exemplo,
alinhando duas partes correspondendo seus pivôs da seguinte forma:


BaseWrap.ImportOrigin

Descreve onde estava o zero global enquanto se criava a malha de gaiola em uma
ferramenta de criação de ativos.


Descreve onde estava a origem (no espaço mundial) enquanto se criava a malha
 de gaiola em uma ferramenta de criação de ativos como Blender ou Maya.


BaseWrap.ImportOriginWorld

Descreve onde estava a origem (no espaço mundial) enquanto se criava a malha
 de gaiola em uma ferramenta de criação de ativos.


Classe base abstrata para `Class.WrapTarget` e `Class.WrapLayer` que armazena
dados de malha de gaiola para deformação de roupas em camadas.


`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.

Não é possível criar objetos `Instance` raiz diretamente, mas o construtor especial
`Datatype.Instance.new()` cria objetos via código, recebendo o
nome da classe como parâmetro e retornando o objeto criado.


Demonstra como detectar mudanças na ancestralidade de uma instância conectando-se ao
`Class.Instance.AncestryChanged` evento.

O Parent do ChangingPart é definido para valores diferentes ao longo do tempo. O pai da
peça é o ancestral da peça, então o evento `Class.Instance.AncestryChanged`
será acionado sempre que mudar.

Dispara quando esta instância é reparentada ou quando qualquer um de seus ancestrais é
reparentado.

Você pode usar este evento para rastrear a exclusão de uma instância no Studio,
such as exclusão manual no Explorer ou através de um plugin. Se você precisar
detectar quando uma instância é destruída usando `Class.Instance:Destroy()`,
use o evento `Class.Instance.Destroying` em vez disso.


Instance.AncestryChanged

child

A instância cuja propriedade `Class.Instance.Parent|Parent` mudou,
que pode ser esta instância ou um ancestral mais distante, **não**
necessariamente a instância à qual o manipulador está conectado.


parent

Dispara quando a propriedade `Class.Instance.Parent` deste objeto ou de um de
seus ancestrais é alterada.


Este evento dispara sempre que qualquer atributo é alterado na instância,
 incluindo quando um atributo é definido como `nil`. O nome do atributo alterado
 é passado para a função conectada.

Por exemplo, o seguinte trecho de código conecta a função `attributeChanged()`
para disparar sempre que um dos atributos da parte muda:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Veja também `Class.Instance:GetAttributeChangedSignal()` que retorna um
evento que dispara quando um atributo específico dado muda.


Instance.AttributeChanged

attribute

Dispara sempre que um atributo é alterado na `Class.Instance`.


Este trecho imprime os nomes dos objetos à medida que são adicionados ao Espaço de Trabalho:


Dispara após um objeto ser parentado a esta `Class.Instance`.

Note que, ao usar este método em um cliente para detectar objetos criados pelo
servidor, é necessário usar `Class.Instance:WaitForChild()` ao
indexar os descendentes desses objetos. Isso ocorre porque o objeto e seus
descendentes não são garantidos para replicar do servidor para o cliente
simultaneamente. Por exemplo:

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

Workspace.ChildAdded:Connect(function(child)
	-- Use WaitForChild() já que os descendentes podem não ter replicado ainda
	local head = child:WaitForChild("Head")
end)
```
Note que este evento opera apenas para filhos imediatos da
`Class.Instance`. Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantAdded`.

Veja também `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Dispara após um objeto ser parentado a esta `Class.Instance`.


Instance.childAdded

Este trecho imprime os nomes dos objetos à medida que são removidos do
Workspace:


Dispara após um filho ser removido desta `Class.Instance`.

Removido refere-se a quando o pai de um objeto é alterado de esta
`Class.Instance` para algo diferente desta `Class.Instance`. Note que este
evento também será disparado quando um filho for destruído (usando
`Class.Instance:Destroy()`) uma vez que a função de destruição define o pai de um objeto
como `nil`.

Este evento opera apenas para filhos imediatos da `Class.Instance`.
Para um evento que captura todos os descendentes, use
`Class.Instance.DescendantRemoving`.

Veja também `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Dispara após um filho ser removido desta `Class.Instance`.


Este exemplo a seguir imprimirá o nome de qualquer objeto que for adicionado ao
Espaço de Trabalho:

Este evento dispara após um descendente ser adicionado à `Class.Instance`.

Como ele dispara para cada descendente, parentar um objeto à
`Class.Instance` disparará o evento para este objeto e todos os seus
descendentes individualmente.

Se você está apenas preocupado com os **filhos diretos** da
`Class.Instance`, use `Class.Instance.ChildAdded` em vez disso.

Veja também `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Dispara após um descendente ser adicionado à `Class.Instance`.


O seguinte exemplo imprime o nome de qualquer descendente enquanto está sendo removido
do Workspace:

Este evento dispara **imediatamente antes** que o pai `Class.Instance`
mude de forma que uma instância **descendente** não será mais um
descendente. `Class.Instance:Destroy()|Destroy()` muda o `Class.Instance.Parent|Parent` de uma instância para `nil`, então chamar esse método em um
descendente do pai fará com que este evento dispare.

Como este evento dispara **antes** da remoção do descendente, o pai do
descendente não será alterado no momento em que este evento disparar. Se o
descendente também for um **filho direto** do pai, este evento disparará
antes de `Class.Instance.ChildRemoved`.

Se um descendente tiver filhos, este evento dispara com o descendente primeiro,
seguido por seus descendentes.

#### Aviso

Este evento dispara com o objeto descendente que está sendo removido.
Tentar definir o `Class.Instance.Parent|Parent` do descendente para
algo diferente falhará. Abaixo está um exemplo que demonstra isso:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Não manipule o pai do descendente nesta função!
	-- Este evento dispara PORQUE o pai foi manipulado, e a mudança ainda não aconteceu
	-- Portanto, é problemático mudar o pai assim:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Veja também `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

O `Class.Instance` que está sendo removido.


Dispara imediatamente antes de um descendente da `Class.Instance` ser removido.


Este exemplo demonstra como, ao usar o comportamento de sinal Imediato, uma
Instância sendo destruída permanece no lugar até que a função conectada faça yield.

Este exemplo demonstra como, ao usar o comportamento de sinal Deferred, uma Instância
é destruída antes que o sinal seja acionado.

O `Class.Instance` nunca será deletado da memória enquanto uma função conectada
estiver ainda usando-o. No entanto, se a função suspender em algum ponto,
o `Class.Instance` e seus descendentes serão parentados a `nil`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Immediate`, este evento dispara imediatamente antes do
`Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

Se a propriedade `Class.Workspace.SignalBehavior` estiver definida como
`Enum.SignalBehavior.Deferred`, este evento dispara no próximo ponto de retoma,
que será após o `Class.Instance` ou um de seus ancestrais ser destruído com
`Class.Instance:Destroy()`.

Com o comportamento `Enum.SignalBehavior.Deferred|Deferred`, conectar um script
ao seu próprio evento `Class.Instance.Destroying` é problemático, pois o script
será destruído antes que o callback possa ser chamado (o que significa que não
será executado).

Ao deletar um `Class.Instance` no Studio, como excluir manualmente
através do [Explorer](/studio/explorer) ou através de um plugin,
o `Class.Instance` não é destruído. Em vez disso, o pai é definido como `nil`
que você pode rastrear com `Class.Instance.AncestryChanged`.


Instance.Destroying

Dispara imediatamente antes (ou é adiado até depois) que a instância é
destruída via `Class.Instance:Destroy()`.


Demonstra `Class.Instance.StyledPropertiesChanged`.


Este evento dispara sempre que qualquer propriedade de estilo é alterada na instância,
 incluindo quando uma propriedade é definida como `nil`.


Instance.StyledPropertiesChanged

Dispara sempre que qualquer propriedade de estilo é alterada na instância, incluindo
quando uma propriedade é definida como `nil`.


Este método aplica uma tag à instância, sem efeito se a tag já estiver
aplicada. Adicionar uma tag com sucesso acionará um sinal criado por
`Class.CollectionService:GetInstanceAddedSignal()` com a tag dada.

#### Avisos

- As tags de uma instância que foram adicionadas do lado do cliente serão descartadas se o
  servidor adicionar ou remover uma tag nessa instância posteriormente, pois o servidor
  replica todas as tags juntas e sobrescreve as tags anteriores.

- Ao marcar uma instância, é comum que alguns recursos sejam usados para
dar funcionalidade à tag, por exemplo, conexões de eventos ou tabelas.
  Para evitar vazamentos de memória, é uma boa ideia limpar esses recursos
  (desconectar, definir como `nil`, etc.) quando não forem mais necessários para uma tag. Faça isso ao
  chamar `Class.Instance:RemoveTag()`, chamando
  `Class.Instance:Destroy()`, ou em uma função conectada a um sinal
  retornado por `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

A função filhos retorna um array dos filhos do objeto.


Instance:children

Este método destrói todos os filhos e descendentes de uma instância.

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

-- Adiciona algumas faíscas
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

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

part:ClearAllChildren()

print("Filhos:", #part:GetChildren())  --> Filhos: 0
```
Se você não deseja destruir **todos** os filhos e descendentes, use
`Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para
percorrer esses filhos/descendentes e selecionar o que destruir. Por
exemplo, o seguinte exemplo de código destruirá todos os
`Class.BasePart|BaseParts` descendentes de um `Class.Model`:

```
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

Este método destrói todos os filhos de uma instância.


Demonstra como clonar um modelo usando `Class.Instance:Clone()`.

`Clone()` cria uma cópia de uma instância e todos os seus descendentes,
ignorando todas as instâncias que não são
`Class.Instance.Archivable|Archivable`. A cópia da instância raiz é
retornada por este método e seu `Class.Instance.Parent|Parent` é definido como
`nil`. Note que se a própria instância tiver
`Class.Instance.Archivable|Archivable` definido como `false`, este método
retornará `nil`.

Se uma propriedade de referência, como `Class.ObjectValue.Value`, for definida em uma
instância clonada, o valor da propriedade da cópia depende do
valor do original:

- Se uma propriedade de referência se referir a uma instância que foi **também** clonada,
  a cópia se referirá à cópia.
- Se uma propriedade de referência se referir a uma instância que **não** foi clonada,
  o mesmo valor é mantido na cópia.


Instance:Clone

Uma cópia da instância, ou `nil` se a instância não for
`Class.Instance.Archivable|Archivable`.


Cria uma cópia de uma instância e todos os seus descendentes, ignorando instâncias
que não são `Class.Instance.Archivable|Archivable`.


Instance:clone

Demonstra a destruição de uma Parte usando a função `Class.Instance:Destroy()`.

Esta função é a maneira correta de descartar objetos que não são mais
necessários.

Define a propriedade `Class.Instance.Parent` como `nil`, bloqueia a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos. Este método é a maneira correta de descartar
objetos que não são mais necessários.

Descartar objetos desnecessários é importante, pois objetos e
conexões desnecessárias em um lugar consomem memória, o que pode levar a sérios problemas de desempenho ao longo do tempo.

Como uma boa prática, após chamar `Destroy()` em um objeto, defina quaisquer
variáveis que referenciam o objeto (ou seus descendentes) como `nil`. Isso
impede que seu código acesse qualquer coisa relacionada ao objeto.

```lua
local part = Instance.new("Part")
part.Name = "Olá, mundo"
part:Destroy()
-- Não faça isso:
print(part.Name)  --> "Olá, mundo"
-- Faça isso para evitar que a linha acima funcione:
part = nil
```
Uma vez que um `Class.Instance` foi destruído por este método, não pode ser
reutilizado porque a propriedade `Class.Instance.Parent` está bloqueada. Para
**remover temporariamente** um objeto em vez de destruí-lo, defina
`Class.Instance.Parent|Parent` como `nil`. Por exemplo:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Para destruir um objeto após um determinado período de tempo, use
`Class.Debris:AddItem()`.


Instance:Destroy

Define a propriedade `Class.Instance.Parent` como `nil`, bloqueia a
propriedade `Class.Instance.Parent`, desconecta todas as conexões e chama
`Destroy()` em todos os filhos.


Instance:destroy

Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

O seguinte trecho de código encontraria o primeiro ancestral do objeto
chamado `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Para variantes deste método que encontram ancestrais de uma classe específica,
veja `Class.Instance:FindFirstAncestorOfClass()` e
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

O `Class.Instance.Name` a ser procurado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Instance.Name` é igual ao nome dado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Um uso comum deste método é encontrar o `Class.Model` ao qual um
`Class.BasePart` pertence. Por exemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Este método é uma variante de `Class.Instance:FindFirstAncestor()` que
verifica a propriedade `Class.Object.ClassName` em vez de
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` também
existe, usando o método `Class.Object:IsA()` em vez disso para respeitar a
herança de classe.


Instance:FindFirstAncestorOfClass

className

O `Class.Object.ClassName` a ser procurado.


Retorna o primeiro ancestral do `Class.Instance` cujo
`Class.Object.ClassName` é igual ao className dado.


Retorna o primeiro ancestral do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Este método funciona para cima, ou seja, começa no `Class.Instance.Parent`
imediato da instância e trabalha em direção ao `Class.DataModel`. Se nenhum
ancestral correspondente for encontrado, retorna `nil`.

Diferente de `Class.Instance:FindFirstAncestorOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
ancestral `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Veja também `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Retorna o primeiro ancestral do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.


O abaixo procurará no Workspace por um objeto chamado "Brick". Se encontrado, ele
mudará o nome do objeto para "Foo".

Retorna o primeiro filho do `Class.Instance` com o nome dado, ou
`nil` se nenhum filho desse tipo existir. Se o argumento opcional `recursive` for
`true`, este método pesquisa todos os descendentes em vez de apenas os
filhos imediatos do `Class.Instance`.

#### Verificando a Existência de um Objeto

`FindFirstChild()` é necessário se você precisar verificar se um objeto existe
antes de continuar. Tentar indexar um filho pelo nome usando o operador de ponto
lança um erro se o filho não existir.

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

-- A linha a seguir gera um erro se a parte não existir no espaço de trabalho
Workspace.Part.Transparency = 0.5
```
Uma abordagem melhor é usar `FindFirstChild()` para primeiro verificar por `Part`,
então usar uma declaração `if` para executar o código que precisa dele.

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

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

#### Encontrando um Filho cujo Nome Corresponde a uma Propriedade

Às vezes, o `Class.Instance.Name|Name` de um objeto é o mesmo que o
propriedade de seu `Class.Instance.Parent|Parent`. Ao usar o operador de ponto,
as propriedades têm precedência sobre os filhos se compartilharem um nome.

No exemplo a seguir, uma `Class.Folder` chamada `Color` é adicionada a um
`Class.Part`, que também possui a propriedade `Class.Part.Color`. Note que
`part.Color` se refere ao valor da propriedade `Datatype.Color3`, não à instância
filho `Class.Folder`. Um benefício de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` é que a
introdução de novas propriedades não impõe um risco ao seu código.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- A propriedade
local c2 = part:FindFirstChild("Color")  -- A pasta filho
```

#### Notas de Desempenho

`Class.Instance:FindFirstChild()|FindFirstChild()` leva cerca de 20% mais
tempo do que usar o operador de ponto e quase 8 vezes mais do que simplesmente armazenar
uma referência a um objeto. Portanto, você deve evitar chamá-lo em
código dependente de desempenho, como em loops apertados ou funções conectadas
a `Class.RunService.Heartbeat` e `Class.RunService.PreRender`. Em vez disso,
estou o resultado em uma variável, ou considere usar
`Class.Instance.ChildAdded|ChildAdded` ou
`Class.Instance:WaitForChild()|WaitForChild()` para detectar quando um filho de um
dado nome se torna disponível.


Instance:FindFirstChild

O `Class.Instance.Name` a ser pesquisado.


recursive

Se a pesquisa deve ser realizada recursivamente ou não.


Retorna o primeiro filho do `Class.Instance` encontrado com o nome dado.


Instance:findFirstChild

Retorna o primeiro filho do `Class.Instance` cujo
`Class.Object.ClassName|ClassName` é igual ao `className` dado.
Diferente de `Class.Instance:FindFirstChildWhichIsA()`, este método só retorna
objetos cuja classe corresponde a `className`, ignorando a herança de classe. Se nenhum
filho correspondente for encontrado, este método retorna `nil`.


Instance:FindFirstChildOfClass

Retorna o primeiro filho do `Class.Instance` cujo
`Class.Object.ClassName|ClassName` é igual ao nome da classe dada.


Retorna o primeiro filho do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.

Se nenhum filho correspondente for encontrado, este método retorna `nil`. Se o argumento
opcional recursivo for verdadeiro, este método pesquisa todos os descendentes em vez de apenas os filhos imediatos do `Class.Instance`.

Diferente de `Class.Instance:FindFirstChildOfClass()`, este método usa
`Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Portanto, o seguinte exemplo de código retornará o primeiro
filho `Class.BasePart`, independentemente de ser um `Class.WedgePart`,
`Class.MeshPart` ou `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Desenvolvedores que procuram um filho pelo nome, devem usar
`Class.Instance:FindFirstChild()` em vez disso.


Instance:FindFirstChildWhichIsA

Retorna o primeiro filho do `Class.Instance` para o qual
`Class.Object:IsA()` retorna verdadeiro para o className dado.


Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.

Este método está desativado e não pode ser usado. Para encontrar o primeiro descendente
 de uma instância, considere usar o parâmetro `recursive` em
`Class.Instance:FindFirstChild()` em vez disso.


Instance:FindFirstDescendant

Retorna o primeiro descendente encontrado com o dado `Class.Instance.Name`.


Se o `Class.Instance` for um `Class.Actor`, o próprio `Class.Actor` é
retornado. Caso contrário, seu ancestral mais próximo `Class.Actor` é retornado. Se nenhum
ancestral for um `Class.Actor`, o resultado é `nil`.


Instance:GetActor

Retorna o `Class.Actor` associado à Instância, se houver.


Este método retorna o valor que foi atribuído ao nome do
atributo dado. Se nenhum atributo foi atribuído, `nil` é retornado.

Por exemplo, o seguinte trecho de código define e depois obtém o valor do
atributo `InitialPosition` da instância:

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

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

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

#### Veja Também

- `Class.Instance:SetAttribute()` que define o atributo com o nome dado
  para o valor dado.
- `Class.Instance:GetAttributes()` que retorna um dicionário de pares chave-valor
  para cada um dos atributos da instância.


Instance:GetAttribute

O valor que foi atribuído ao nome do atributo dado. Se nenhum
atributo foi atribuído, `nil` é retornado.


Retorna o valor que foi atribuído ao nome do atributo dado.


Este método retorna um evento que se comporta exatamente como o
evento `Class.Object.Changed|Changed`, exceto que ele só é acionado quando o
atributo específico muda; efetivamente é semelhante a
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` mas
para atributos.

É geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Object.Changed|Changed` com uma função que verifica o nome do atributo. Chamadas subsequentes a este método no mesmo objeto com o mesmo
nome de atributo retornam o mesmo evento.

O seguinte exemplo de código retorna um sinal que aciona a função
`attributeChanged()` quando o atributo `InitialPosition` da parte muda:

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

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

local function attributeChanged()
	print("Atributo mudado")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Veja também `Class.Instance.AttributeChanged` que é acionado sempre que qualquer
atributo é mudado na instância.


Instance:GetAttributeChangedSignal

O nome do atributo especificado para o qual o sinal de mudança está
sendo retornado.


Um evento que é acionado quando o atributo dado muda.


Retorna um evento que é acionado quando o atributo dado muda.


Este método retorna um dicionário de pares chave-valor para cada atributo
onde a chave é o nome do atributo e o valor é um valor não-nulo.

Por exemplo, o seguinte trecho de código exibe os atributos e valores de uma instância:

```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
```
Veja também `Class.Instance:GetAttribute()` que retorna o valor que foi
atribuído ao nome do atributo dado.


Instance:GetAttributes

Um dicionário de pares string → variante para cada atributo onde a
string é o nome do atributo e a variante é um valor não-nulo.


Retorna um dicionário dos atributos da instância.


O abaixo imprimiria o nome de todos os objetos atualmente no Workspace quando executado.

Retorna um array (uma tabela indexada numericamente) contendo todos os
filhos diretos da instância, ou cada `Class.Instance` cujo
`Class.Instance.Parent|Parent` é igual ao objeto. O array pode ser
iterado usando um loop numérico ou genérico:

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

-- Exemplo de loop numérico
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " é o filho número " .. i)
end
```

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

-- Exemplo de loop genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " é o filho número " .. i)
end
```
Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada para
ordenar os filhos retornados por este método.

Veja também o método `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Um array contendo os filhos da instância.


Retorna um array contendo todos os filhos da instância.


Instance:getChildren

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox. Note
que:

- Este item é protegido. Tentar usá-lo em um `Class.Script` ou
  `Class.LocalScript` causará um erro.
- Um ID de depuração é um ID usado em processos de depuração. Ele permite que um depurador
  leia cada instrução antes que um aplicativo a processe. Todos os objetos no
  Roblox agem como processos e cada execução de instruções (ou 'código') que pode
  ser depurado se necessário.
- Isso pode ser útil para plugins que precisam distinguir objetos semelhantes
  uns dos outros (como objetos que compartilham o mesmo nome).


Instance:GetDebugId

scopeLength

Retorna uma string codificada do ID de depuração usado internamente pelo Roblox.


GetDescendants é frequentemente usado para fazer algo com todos os descendentes que são de um
tipo específico de objeto. O código neste exemplo usa GetDescendants e
`Class.Instance:IsA()` para encontrar todas as partes no workspace e as torna
verdes.

Este método de objeto retorna um array que contém todos os descendentes
desse objeto. Diferente de `Class.Instance:GetChildren()`, que só retorna
os filhos imediatos de um objeto, este método encontra cada filho do
objeto, cada filho desses filhos, e assim por diante.

Note que o array retornado **não** é ordenado em nenhuma ordem particular, então
uma ordenação manual (por exemplo, usando `Library.table.sort()`) é aconselhada para
ordenar os descendentes retornados por este método. Também considere o
método `Class.Instance:QueryDescendants()|QueryDescendants()` para consultar
descendentes por uma combinação de seletores e combinadores.


Instance:GetDescendants

Um array contendo os descendentes da instância.


Retorna um array contendo todos os descendentes da instância.


Este exemplo de código demonstra o comportamento de `Class.Instance:GetFullName()`.
Ele mostra como a função se comporta ao ser chamada em um objeto que não está na
hierarquia `DataModel`, e também mostra como o valor de retorno não escapa
caracteres especiais.

Este exemplo de código reimplementa a função `Class.Instance:GetFullName()` em
Lua.


Retorna uma string descrevendo a ancestralidade da instância. A string é uma
concatenação do `Class.Instance.Name|Name` do objeto e seus
ancestrais, separados por pontos. O `Class.DataModel` (`game`) não é
considerado. Por exemplo, um `Class.Part` no `Class.Workspace` pode
retornar `Class.Workspace.Part`.

Quando chamado em um `Class.Instance` que não é um descendente do
`Class.DataModel`, este método considera todos os ancestrais até e incluindo
o mais alto que não tem um `Class.Instance.Parent|Parent`.

Este método é útil para registro e depuração. Você não deve tentar
analisar a string retornada para qualquer operação útil; este método não
escapa pontos (ou qualquer outro símbolo) nos nomes dos objetos. Em outras palavras,
embora sua saída frequentemente pareça ser um identificador Luau válido, não é
garantido.


Instance:GetFullName

Retorna uma string descrevendo a ancestralidade da instância.


Este método retorna o valor estilizado ou explicitamente modificado da
propriedade especificada, ou então o valor padrão da propriedade se não tiver sido
estilizado/modificado. Isso difere ligeiramente de acessar o valor da propriedade
diretamente, como `[GuiObject].Rotation`, que retorna o valor padrão ou
modificado da propriedade.


Instance:GetStyled

selector

Selecionador opcional para a pseudo instância que você está mirando na
instância.


O valor estilizado ou explicitamente modificado da propriedade especificada, ou
então o valor padrão da propriedade se não tiver sido estilizado/modificado.


Retorna o valor estilizado ou explicitamente modificado da propriedade especificada,
ou então o valor padrão da propriedade se não tiver sido estilizado/modificado.


Demonstra `Class.Instance:GetStyledPropertyChangedSignal()`.


Este método retorna um evento que se comporta exatamente como o
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
exceto que ele só é acionado quando a propriedade de estilo dada muda. É
geralmente uma boa ideia usar este método em vez de uma conexão para
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` com uma
função que verifica o nome da propriedade. Chamadas subsequentes a este método no
mesmo objeto com o mesmo nome de propriedade retornam o mesmo evento.

Note que este evento não passará nenhum argumento para uma função conectada,
portanto o valor da propriedade alterada deve ser lido diretamente dentro de um
script.


Instance:GetStyledPropertyChangedSignal

property

Nome da propriedade de estilo para a qual ouvir mudanças.


Evento que é acionado quando a propriedade de estilo dada muda.


Retorna um evento que é acionado quando a propriedade de estilo dada muda na
instância.


Este método retorna um array das tags aplicadas à instância dada, como
strings. Você pode adicionar tags tanto no Studio na
janela [Propriedades](/studio/properties) quanto em tempo de execução com
`Class.Instance:AddTag()|AddTag()`.

Este método é útil quando você deseja fazer algo com várias tags em
uma instância de uma só vez. No entanto, é ineficiente usar este método para
verificar a existência de uma única tag; em vez disso, use
`Class.Instance:HasTag()|HasTag()` para verificar uma tag específica.


Instance:GetTags

Um array de strings, cada uma representando uma tag aplicada à instância.


Obtém um array de todas as tags aplicadas à instância.


Este método retorna `true` se a tag fornecida foi adicionada ao
objeto. Você pode adicionar tags tanto no Studio na
janela [Propriedades](/studio/properties) quanto em tempo de execução com
`Class.Instance:AddTag()|AddTag()`.


Instance:HasTag

`true` se a instância tem a tag dada, `false` caso contrário.


Verifica se a instância tem uma tag dada.


Demonstra como determinar se uma instância é o ancestral de outra usando
`Class.Instance:IsAncestorOf()`

Workspace e SpawnLocation são ancestrais do decalque do SpawnLocation.
Workspace é um ancestral do SpawnLocation.

SpawnLocation e seu decalque são descendentes do Workspace, não ancestrais.
Decalque é um descendente do SpawnLocation, não um ancestral.


Retorna verdadeiro se um `Class.Instance` é um ancestral do dado
descendente.

Um `Class.Instance` é considerado o ancestral de um objeto se o
`Class.Instance.Parent` do objeto ou um dos pais dele
`Class.Instance.Parent` estiver definido para o `Class.Instance`.

Veja também, `Class.Instance:IsDescendantOf()`.


Instance:IsAncestorOf

Verdadeiro se o `Class.Instance` é um ancestral do dado descendente.


Retorna verdadeiro se um `Class.Instance` é um ancestral do dado
descendente.


Instance

`Instance` é a classe base para todas as classes na hierarquia de classes do Roblox
que podem fazer parte da árvore `Class.DataModel`.


/reference/engine/classes/WrapTarget.yaml

Resumo