**Aparência da superfície** objetos permitem que você substitua a aparência de um `Class.MeshPart` com opções de gráficos avançados.Mais notavelmente, ele pode aplicar um conjunto de **imagens de renderização baseadas em física** (RBP (Renderização baseada em física)) ou mapas a um único Objeto.Combinar múltiplos mapas de textura pode simular com mais precisão cor, rugosidade e refletância em qualquer ambiente de iluminação e pode melhorar os elementos visuais de seus recursos e ambiente; veja [Texturas PBR](/art/modeling/surface-appearance) para mais detalhes.

  <figure>
    <img src="/assets/modeling/surface-appearance/SurfaceAppearance-Example-1.jpg" width="405" alt="A realistic leafy bush" />

    <img src="/assets/modeling/surface-appearance/SurfaceAppearance-Example-3.jpg" width="405" alt="A realistic mossy rock" />
  </figure>

  A aparência deste objeto em um `Class.MeshPart` depende do dispositivo e do nível de qualidade gráfica do usuário.Para os melhores resultados, você pode querer pré-visualizar seu conteúdo com diferentes configurações de nível de qualidade.

  Observe que a maioria das propriedades `Class.SurfaceAppearance` não pode ser modificada por scripts, pois o pré-processamento necessário é geralmente muito caro durante o tempo de execução.

SurfaceAppearance

Essa propriedade determina como o canal alfa do `Class.SurfaceAppearance.ColorMap` é usado.

  Quando definido para `Enum.AlphaMode|Transparency` e o `Class.MeshPart.Transparency` é definido para `0` , pixels opacos na `Class.SurfaceAppearance.ColorMap|ColorMap` renderizarão como completamente opacos na cena 3D.Essa combinação funciona melhor com efeitos baseados em profundidade e occlusão.

  Quando definido para `Enum.AlphaMode|Transparency` e o `Class.MeshPart.Transparency` é definido para pelo menos `0.02`, um método de mistura diferente é usado que pode representar melhor os gradientes de transparência suaves e as bordas suaves.Essa combinação não suporta todos os efeitos e a occlusão pode não ser perfeita.

  Veja [aqui](/art/modeling/surface-appearance#alpha-modes) para mais informações.

SurfaceAppearance.AlphaMode

Determina como o canal alfa do `Class.SurfaceAppearance.ColorMap` é usado.

Aplica uma tinta à sua mapa de cores existente. Defina diretamente com o seletor de cores ou programaticamente com `Datatype.Color3`.

SurfaceAppearance.Color

Essa propriedade determina a cor e a opacidade da superfície.Essa textura às vezes é chamada de textura **albedo** .O canal alfa desta textura controla sua opacidade, que se comporta de forma diferente dependendo da configuração `Class.SurfaceAppearance.AlphaMode`.

  Veja [aqui](/art/modeling/surface-appearance#color-albedo) para mais informações.

SurfaceAppearance.ColorMap

Determina a cor e a opacidade da superfície.

SurfaceAppearance.ColorMapContent

Esta propriedade determina quais partes da superfície são metálicas ou não metálicas.O mapa de metalidade é uma imagem em tons de cinza em que pixels pretos correspondem a não-metais e pixels brancos correspondem a metais.

  Metais só refletem luz do mesmo tom que o metal e refletem muito mais luz do que os metais não metálicos.A maioria dos pixels em um mapa de metalidade será pura preta ou pura branca, enquanto os valores entre eles podem ser usados para simular sujeira ou grunge sobre uma área de metal subjacente.

  Quando `Class.Lighting.EnvironmentSpecularScale` é 0, a metalinguagem não tem efeito.Para as reflexões mais realistas, é recomendado definir `Class.Lighting.EnvironmentSpecularScale` e `Class.Lighting.EnvironmentDiffuseScale` para 1, bem como `Class.Lighting.Ambient` e `Class.Lighting.OutdoorAmbient` para `(0, 0, 0)`.

  Veja [aqui](/art/modeling/surface-appearance#metalness) para mais informações.

SurfaceAppearance.MetalnessMap

Determina quais partes da superfície são metais ou não metais.

SurfaceAppearance.MetalnessMapContent

Essa propriedade modifica a iluminação da superfície adicionando saliências, irregularidades, rachaduras e curvas, sem adicionar mais polígonos.O mapa normal é uma imagem RGB que modifica o vetor normal da superfície usado para cálculos de iluminação.Seus canais **R** , **G** e **B** correspondem respectivamente aos componentes **X** , **Y** e **Z** da superfície local, e os valores de bytes de 0 e 255 para cada canal correspondem linearmente aos componentes normais de vetor de -1 e 1.016, respectivamente.Este alcance é estendido ligeiramente de -1 a 1 para que um valor de byte de 127 seja exatamente 0.

  O eixo **Z** do vetor normal é sempre definido como a direção do normal da malha subjacente.Uma imagem uniforme `(127, 127, 255)` traduz para um mapa normal completamente plano onde o normal está em toda parte perpendicular à superfície da malha; este formato é referido como um mapa normal "tangente ao espaço".Observe que o Roblox não suporta mapas normais de espaço mundial ou de espaço de objeto.

  Componentes normais invertidos incorretamente podem fazer com que os saltos pareçam como entradas.Se você importar um mapa normal e notar que a iluminação parece desligado, pode precisar inverter o canal **G** da imagem.Os eixos **X** e **Y** do quadro de espaço tangente correspondem às direções **X** e **Y** na imagem depois de ser transformada pelos UVs de malha.Se você visualizar seu mapa normal em um editor de imagens como se ele fosse exibido em uma superfície, os normais apontando para o lado direito da tela devem aparecer mais vermelhos e os normais apontando para o lado superior da sua tela devem aparecer mais verdes.Os termos "formato DirectX" e "formato OpenGL" são às vezes usados para descrever se o canal **G** do mapa normal está invertido ou não (o Roblox espera o formato OpenGL).

  O Roblox também espera que malhas importadas incluam tangentes.O software de modelagem também pode se referir a isso como informações de "espaço tangente".Se você aplicar um mapa normal e ele não parece fazer nenhuma diferença visual, talvez você precise reexportar sua malha junto com suas informações tangentes do software de modelagem.

  Veja [aqui](/art/modeling/surface-appearance#normal) para mais informações.

SurfaceAppearance.NormalMap

Modifica a iluminação da superfície adicionando saliências, irregularidades, rachaduras e curvas.

SurfaceAppearance.NormalMapContent

Essa propriedade determina a aparente rugosidade em toda a superfície.O mapa de rugosidade é uma imagem em tons de cinza onde pixels pretos correspondem a uma superfície maximamente lisa e pixels brancos correspondem a uma superfície maximamente áspera.

  Observe que a rugosidade da superfície funciona em uma dimensionar/escalonarmuito pequena.Reflexões em superfícies lisas são afiadas e concentradas, enquanto reflexões em superfícies rugosas são mais difusas e dispersas.

  Veja [aqui](/art/modeling/surface-appearance#roughness) para mais informações.

SurfaceAppearance.RoughnessMap

Determina a aparente rugosidade em toda a superfície.

SurfaceAppearance.RoughnessMapContent

SurfaceAppearance.TexturePack

Um objeto que permite que os desenvolvedores substituam a aparência de um MeshPart com opções gráficas avançadas.

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

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

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.

Incêndios quando a propriedade `Class.Instance.Parent` do objeto ou uma de suas ancestrais é alterada.

  Este evento inclui dois parâmetros: `child` refere-se ao `Class.Instance` cujo `Class.Instance.Parent` foi realmente alterado, enquanto `parent` refere-se ao novo `Class.Instance.Parent` desta instância.

  Você pode usar esse evento para rastrear a exclusão de uma instância no Studio, como 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

O `Class.Instance` cujo `Class.Instance.Parent` foi alterado.

parent

O novo `Class.Instance.Parent` da `Class.Instance` cujo `Class.Instance.Parent` foi alterado.

Incêndios quando a propriedade `Class.Instance.Parent` do objeto ou uma de suas ancestrais é alterada.

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

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

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

  local part = Workspace.Part

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

  part.AttributeChanged:Connect(attributeChanged)
  ```

  Veja também `Class.Instance:GetAttributeChangedSignal()` que retorna um evento que dispara quando um atributo específico for modificado.

Instance.AttributeChanged

attribute

Incêndios sempre que um atributo é alterado no `Class.Instance`.

This snippet prints the names of objects as they are added to the Workspace:

Incêndios após um objeto ser associado a este `Class.Instance` .

  Observe, ao usar essa função em um cliente para detectar objetos criados pelo servidor, é necessário usar `Class.Instance:WaitForChild()`.Isso ocorre porque o objeto e seus descendentes não são garantidos de se replicarem do servidor para o cliente simultaneamente.Por exemplo:

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

  Workspace.ChildAdded:Connect(function(child)
  	-- Use WaitForChild() since descendants may not have replicated yet
  	local head = child:WaitForChild("Head")
  end)
  ```

  Observe, essa função só funciona para filhos imediatos do `Class.Instance`. Para uma função que captura todos os descendentes, use `Class.Instance.DescendantAdded` .

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

Instance.ChildAdded

Incêndios após um objeto ser associado a este `Class.Instance` .

This snippet prints the names of objects as they are removed from the
Workspace:

Incêndios após uma criança ser removida deste `Class.Instance` .

  Removido se refere a quando o pai de um objeto é alterado deste `Class.Instance` para algo diferente deste `Class.Instance`.Observe, este evento também será disparado quando uma criança for destruída (usando `Class.Instance:Destroy()` ) pois a função de destruição define o pai de um objeto para `nil` .

  Essa função só funciona para filhos imediatos do `Class.Instance`. Para uma função que captura todos os descendentes, use `Class.Instance.DescendantRemoving`.

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

Instance.ChildRemoved

Incêndios após uma criança ser removida deste `Class.Instance` .

O seguinte exemplo imprimirá o nome de qualquer objeto que seja adicionado ao Espaço de Trabalho:

Este evento é acionado após um descendente ser adicionado ao `Class.Instance`.

  Ao disparar para cada descendente, cuidar de um objeto para o `Class.Instance` disparará o evento para esse objeto e todos os seus descendentes individualmente.

  Se você está apenas preocupado com as crianças diretas **do** da `Class.Instance`, use `Class.Instance.ChildAdded`.

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

Instance.DescendantAdded

descendant

Incêndios após um descendente for adicionado ao `Class.Instance`.

The following example prints the name of any descendant as it is being removed
from the Workspace:

Este evento dispara **imediatamente antes de** as alterações do pai `Class.Instance` para que uma instância **descendente** não seja mais descendente.`Class.Instance:Destroy()|Destroy()` altera o `Class.Instance.Parent|Parent` de uma instância para `nil`, então chamar esse método em um descrente do pai fará com que esse evento seja disparado.

  Como este evento dispara **antes de** a remoção do descendente, o pai do descendente será mantido inalterado no momento do disparo deste evento.Se o descrente também for uma criança direta do pai, este evento será disparado antes de .

  Se um descendente tem 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 outra coisa falhará.Abaixo está um exemplo que demonstra isso:

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

  Workspace.DescendantRemoving:Connect(function(descendant)
  	-- Do not manipulate the parent of the descendant in this function!
  	-- This event fires BECAUSE the parent was manipulated, and the change hasn't happened yet
  	-- Therefore, it is problematic to change the parent like this:
  	descendant.Parent = game
  end)

  local part = Instance.new("Part")
  part.Parent = Workspace
  part.Parent = nil
  ```

  Veja também `Class.Instance.DescendantAdded|DescendantAdded` .

Instance.DescendantRemoving

Incêndios imediatamente antes de um descendente do `Class.Instance` ser removido.

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.

This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.

O `Class.Instance` nunca será excluído da memória enquanto uma função conectada ainda estiver usando-o.No entanto, se a função retornar em qualquer ponto, os descendentes da `Class.Instance` e seus pais serão parentados para `nil`.

  Se a propriedade `Class.Workspace.SignalBehavior` for definida como `Enum.SignalBehavior.Immediate`, este evento é disparado imediatamente antes que o `Class.Instance` ou um de seus ancestrais seja destruído com `Class.Instance:Destroy()`.

  Se a propriedade `Class.Workspace.SignalBehavior` for definida como `Enum.SignalBehavior.Deferred`, este evento será disparado no próximo ponto de retomada, que será depois que o `Class.Instance` ou um de seus ancestrais for 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 retorno de chamada possa ser chamado (o que significa que não será executado).

  Ao excluir um `Class.Instance` em 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

Incêndios imediatamente antes (ou são adiados até depois) que a instância seja destruída via `Class.Instance:Destroy()` .

Este evento dispara sempre que qualquer propriedade de estilo é alterada na instância, incluindo quando uma propriedade é definida como `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("Styled properties changed")
  end

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

Instance.StyledPropertiesChanged

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

Instance.childAdded

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

  ##### Avertimentos

  *   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 mais tarde, pois o servidor replica todas as tags juntas e substitui as tags anteriores.

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

Instance:AddTag

Essa função destrói todos os filhos e descendentes de uma instância.

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

  -- Add some sparkles
  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
  ```

  Se você não deseja destruir **todas** as crianças e descendentes, use `Class.Instance:GetChildren()` ou `Class.Instance:GetDescendants()` para percorrer essas crianças/descendentes e selecionar o que deve destruir.Por exemplo, o seguinte código de exemplo 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

Essa função destrói todos os filhos de uma instância.

Demonstrates cloning a model using `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` .Observe que, se a própria instância tiver `Class.Instance.Archivable|Archivable` definido para `false`, essa função 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 da propriedade 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 um objeto que não foi **clonado** , o mesmo valor é mantido na cópia.

Instance:Clone

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

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.

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

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

  Como melhor prática após chamar `Destroy()` em um objeto, defina qualquer variável que referencie o objeto (ou seus descendentes) para `nil`.Isso impede que seu código acesse qualquer coisa relacionada ao objeto.

  ```lua
  local part = Instance.new("Part")
  part.Name = "Hello, world"
  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 temporariamente remover um objeto em vez de destruí-lo, defina para >.Por exemplo:

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

  object.Parent = nil
  task.wait(2)
  object.Parent = Workspace
  ```

  Para destruir um objeto após um período de tempo definido, use `Class.Debris:AddItem()` .

Instance:Destroy

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

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

  Essa função funciona em direção ao topo, o que significa que ela começa no imediato da instância `Class.Instance.Parent` e funciona em direção ao `Class.DataModel`.Se nenhum ancestral correspondente for encontrado, ele retorna `nil` .

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

  ```
  local car = object:FindFirstAncestor("Car")
  ```

  Para variantes dessa função que encontram ancestrais de uma classe específica, consulte `Class.Instance:FindFirstAncestorOfClass()` e `Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

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 à classe dada.

  Essa função funciona em direção ao topo, o que significa que ela começa no imediato da instância `Class.Instance.Parent` e funciona em direção ao `Class.DataModel`.Se nenhum ancestral correspondente for encontrado, ele retorna `nil` .

  Um uso comum dessa função é encontrar o `Class.Model` a `Class.BasePart` pertence. Por exemplo:

  ```
  local model = part:FindFirstAncestorOfClass("Model")
  ```

  Essa função é 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 de 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 à classe dada.

Retorna o primeiro ancestral do `Class.Instance` para quem `Class.Object:IsA()` retorna verdadeiro para a classe dada.

  Essa função funciona em direção ao topo, o que significa que ela começa no imediato da instância `Class.Instance.Parent` e funciona em direção ao `Class.DataModel`.Se nenhum ancestral correspondente for encontrado, ele retorna `nil` .

  Ao contrário de `Class.Instance:FindFirstAncestorOfClass()`, esta função 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 se ele é 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 quem `Class.Object:IsA()` retorna verdadeiro para a classe dada.

O abaixo procuraria no Espaço de Trabalho por um nome de objeto "Tijolo". Se encontrado, mudaria o nome do objeto para "Foo".

Retorna o primeiro filho do `Class.Instance` com o nome dado, ou `nil` se não existir tal filho.Se o argumento opcional `recursive` for `true`, esta função 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 uma criança por nome usando o operador ponto lança um erro se a criança não existir.

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

  -- Os seguintes erros de linha ocorrem se a peça não existir no espaço de trabalho
  Workspace.Part.Transparency = 0.5
  ```

  Uma abordagem melhor é usar `FindFirstChild()` para verificar primeiro `Part` , então usar uma declaração `if` para executar código que precisa dela.

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

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

  ##### Encontrando uma criança cujo nome corresponde a uma propriedade

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

  No seguinte exemplo, um `Class.Folder` chamado `Color` é adicionado a um `Class.Part`, que também tem a propriedade `Class.Part.Color`.Observe que `part.Color` refere-se ao valor da propriedade `Datatype.Color3` , não à instância filha `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  -- Propriedade
  local c2 = part:FindFirstChild("Color")  -- The child folder
  ```

  ##### 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 tempo 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, armazene 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 determinado nome ficará disponível.

Instance:FindFirstChild

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

recursive

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

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

Retorna o primeiro filho do `Class.Instance` cujo `Class.Object.ClassName|ClassName` é igual ao dado `className` .Ao contrário de `Class.Instance:FindFirstChildWhichIsA()`, esta função retorna apenas objetos cuja classe corresponda a `className`, ignorando a herança de classe.Se nenhuma criança correspondente for encontrada, esta função retorna `nil` .

Instance:FindFirstChildOfClass

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

Retorna o primeiro filho do `Class.Instance` para quem `Class.Object:IsA()` retorna verdadeiro para a classe dada.

  Se nenhuma criança correspondente for encontrada, esta função retorna `nil` .Se o argumento recursivo opcional for verdadeiro, esta função pesquisa todos os descendentes em vez de apenas os filhos imediatos do `Class.Instance`.

  Ao contrário de `Class.Instance:FindFirstChildOfClass()`, esta função usa `Class.Object:IsA()` que respeita a herança de classe. Por exemplo:

  ```lua
  print(part:IsA("Part")) --> verdadeiro
  print(part:IsA("BasePart")) --> verdadeiro
  print(part:IsA("Instance")) --> true
  ```

  Portanto, o seguinte exemplo de código retornará o primeiro filho `Class.BasePart` , independentemente de se ele é um `Class.WedgePart` , `Class.MeshPart` ou `Class.Part` .

  ```
  local part = object:FindFirstChildWhichIsA("BasePart")
  ```

  Desenvolvedores que buscam uma criança por nome devem usar `Class.Instance:FindFirstChild()` em vez disso.

Instance:FindFirstChildWhichIsA

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

Retorna o primeiro filho do `Class.Instance` para quem `Class.Object:IsA()` retorna verdadeiro para a classe dada.

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 `Class.Actor` próprio é 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 então obtém o valor do atributo da instância `InitialPosition`:

  ```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 de chave-valor para cada atributo 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.

Essa função retorna um evento que se comporta exatamente como o evento `Class.Object.Changed|Changed`, exceto que só é disparado quando o atributo específico muda; efetivamente, é semelhante a `Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` para atributos.

  É geralmente uma boa ideia usar esse método em vez de uma conexão com `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 ativa a função `attributeChanged()` quando o atributo da peça `InitialPosition` muda:

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

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

  local function attributeChanged()
  	print("Attribute changed")
  end

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

  Veja também `Class.Instance.AttributeChanged` que dispara sempre que algum atributo for alterado na instância.

Instance:GetAttributeChangedSignal

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

Um evento que dispara quando o atributo dado muda.

Retorna um evento que dispara quando o atributo dado muda.

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

  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 de corda → variáveis para cada atributo onde a corda é o nome do atributo e a variável é um valor não nulo.

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

The below would print the name of all objects currently in Workspace when ran.

Retorna um array (uma tabela numericamente indexada) que contém todos os filhos diretos da instância ou todos os `Class.Instance` que seu `Class.Instance.Parent|Parent` é igual ao objeto.O array pode ser iterado usando um for-loop numérico ou genérico:

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

  -- Exemplo de ciclo for numérico
  local children = Workspace:GetChildren()
  for i = 1, #children do
  	local child = children[i]
  	print(child.Name .. " is child number " .. i)
  end
  ```

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

  -- Exemplo genérico de for-loop
  local children = Workspace:GetChildren()
  for i, child in children do
  	print(child.Name .. " is child number " .. i)
  end
  ```

  As crianças são classificadas pela ordem em que sua propriedade `Class.Instance.Parent|Parent` foi definida para o objeto.

  Veja também a função `Class.Instance:GetDescendants()|GetDescendants` .

Instance:GetChildren

Um array que contém os filhos da instância.

Retorna um array que contém todos os filhos da instância.

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

  *   Este item está protegido. Tentar usá-lo em um `Class.Script` ou `Class.LocalScript` causará um erro.
  *   Um ID de debug é um ID usado em processos de depuração.Permite que um depurador leia cada instrução antes que uma aplicação processe-a.Todos os objetos no Roblox agem como processos e instruções de execução (ou "código") que podem ser debugadas 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 is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.

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

Instance:GetDescendants

Um array que contém os descendentes da instância.

Retorna um array que contém todos os descendentes da instância.

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.

This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.

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

  Quando chamado em um `Class.Instance` que não é um descendente do `Class.DataModel` , esta função considera todos os ancestrais até e incluindo o mais antigo sem um `Class.Instance.Parent|Parent` .

  Essa função é útil para registro e depuração.Você não deve tentar analisar a string retornada para qualquer operação útil; esta função não escapa períodos (ou qualquer outro símbolo) em nomes de objetos.Em outras palavras, embora sua saída muitas vezes pareça ser um identificador Luau válido, não é garantida.

Instance:GetFullName

Retorna uma string que descreve a ancestralidade da instância.

Este método retorna o valor estilizado ou explicitamente modificado da propriedade especificada, ou 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.

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

  -- Referência a um botão
  local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

  print(button:GetStyled("Rotation")) --> 0 (valor padrão)
  print(button.Rotation) --> 0 (valor padrão)

  -- Aplicar rotação através da propriedade de regra de estilo
  rule:SetProperty("Rotation", 30)

  print(button:GetStyled("Rotation")) --> 30 (valor estilizado com base em regra)
  print(button.Rotation) --> 0 (valor padrão)

  -- Modificar/substituir propriedade estilizada explicitamente
  button.Rotation = 45

  print(button:GetStyled("Rotation")) --> 45 ( valor modificado )
  print(button.Rotation) --> 45 (modified value)
  ```

Instance:GetStyled

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

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

Este método retorna um evento que se comporta exatamente como o evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`, exceto que só é disparado quando a propriedade de estilo dada muda.É geralmente uma boa ideia usar esse método em vez de uma conexão com `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.

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

  ```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("Style property changed!")
  end

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

Instance:GetStyledPropertyChangedSignal

property

Nome da propriedade de estilo para a qual ouvir alterações.

Evento que dispara quando a propriedade de estilo dada muda.

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

  Este método é útil quando você quer fazer algo com várias etiquetas em uma instância de uma vez.No entanto, é ineficiente usar esse 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

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) ou em tempo de execução com `Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Verifique se a instância tem uma tag dada.

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.

Retorna verdadeiro se um `Class.Instance` for um ancestral do descrente dado.

  Um `Class.Instance` é considerado o ancestral de um objeto se o objeto de `Class.Instance.Parent` ou um de seus pais de `Class.Instance.Parent` for definido como `Class.Instance`.

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

Instance:IsAncestorOf

Verdadeiro se o `Class.Instance` for um ancestral do descrente dado.

Retorna verdadeiro se um `Class.Instance` for um ancestral do descrente dado.

Retorna `true` se um `Class.Instance` for descendente do ancestral dado.

  Observe que `IsDescendantOf()` não pode ser usado com um parâmetro de `nil` para verificar se um objeto foi removido.

  Veja também `Class.Instance:IsAncestorOf()` .

Instance:IsDescendantOf

ancestor

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

Retorna `true` se um `Class.Instance` for descendente do ancestral dado.

Retorna `true` se o valor armazenado na propriedade especificada for igual ao padrão instanciado pelo código.Por exemplo, se exportar a propriedade `Class.TextLabel.TextSize|TextSize` de um `Class.TextLabel` indicar `8` , então chamar `IsPropertyModified("TextSize")` no rótulo retornará `false` porque `8` é o valor padrão para `Class.TextLabel.TextSize` quando o rótulo é criado via `Instance.new("TextLabel")` em vez de ser inserido através dos fluxos de trabalho de inserção do Studio.

  Observe que se este método retornar , o estilo não afetará a propriedade porque modificar explicitamente uma propriedade tem precedência sobre estilizá-la.

Instance:IsPropertyModified

Booleano indicando se a propriedade foi modificada.

Retorna `true` se o valor armazenado na propriedade especificada for igual ao padrão instanciado por código.

The following code demonstrates how a part can be re-added to the DataModel
after being removed:

Essa função define o `Class.Instance.Parent` do objeto para `nil` e faz o mesmo para todos os seus descendentes.

  Se o objeto for referenciado antes de ser removido, é possível recuperar o objeto em um momento posterior.

Instance:Remove

Define o objeto de `Parent` para `nil` e faz o mesmo para todos os seus descendentes.

Este método remove uma tag de uma instância.Não será lançado um erro se o objeto não tiver a tag.Remover com sucesso uma etiqueta disparará um sinal criado por `Class.CollectionService:GetInstanceRemovedSignal()` com a etiqueta dada.

  Observe que, ao rotular uma instância, é comum que alguns recursos sejam usados para dar à etiqueta sua funcionalidade, por exemplo, conexões de eventos ou tabelas.Para evitar vazamentos de memória, é uma boa ideia limpar esses (desconectar, definir como `nil` , etc.) quando não forem mais necessários para uma etiqueta.

Instance:RemoveTag

Redefine uma propriedade para o seu valor padrão.Por exemplo, chamar `ResetPropertyToDefault("Rotation")` em um `Class.TextLabel` é equivalente a definir seu `Class.TextLabel.Rotation|Rotation` para `0` (o valor padrão da propriedade).Este método pode ser usado para garantir que o estilo substituirá o valor padrão desta propriedade.

Instance:ResetPropertyToDefault

Redefine uma propriedade para o seu valor padrão.

Este método define o atributo com o nome dado para o valor dado.Se o valor fornecido for `nil`, o atributo será removido, pois `nil` é retornado por padrão.

  Por exemplo, o seguinte trecho de código define o atributo `InitialPosition` da instância para `Datatype.Vector3|Vector3.new(0, 10, 0)` :

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

  local part = Workspace.Part
  part:SetAttribute("InitialPosition", Vector3.new(0, 10, 0))
  ```

  ##### Limitações

  Requisitos e restrições de nomeação:

  *   Nomes devem usar apenas caracteres alfanuméricos e sublinhado.
  *   Não são permitidos espaços ou símbolos exclusivos.
  *   As cordas devem ter 100 caracteres ou menos.
  *   Nomes não são permitidos para começar com **RBX** a menos que o chamador seja um script de núcleo do Roblox (reservado para o Roblox).

  Ao tentar definir um atributo para um tipo não suportado, um erro será lançado.

  ##### Veja também

  *   `Class.Instance:GetAttribute()` que retorna o valor que foi atribuído ao nome do atributo dado.
  *   `Class.Instance:GetAttributes()` que retorna um dicionário de pares de chave-valor para cada atributo da instância.

Instance:SetAttribute

value

O valor para definir o atributo especificado.

Define o atributo com o nome dado para o valor dado.

The following code waits for an instance named "Part" to be added to
Workspace.

Retorna o filho do `Class.Instance` com o nome dado.Se a criança não existir, ela produzirá o subprocesso atual até que ela o faça.Se o parâmetro `timeOut` for especificado, este método expirará após o número especificado de segundos e retornará `nil` .

  ##### Uso primário

  `Class.Instance:WaitForChild()|WaitForChild()` é extremamente importante ao trabalhar com código executado pelo cliente em um `Class.LocalScript` .O motor do Roblox não garante o tempo ou a ordem em que os objetos são replicados do servidor para o cliente.Além disso, se uma experiência tiver setado para verdadeiro, que estão longe do personagem do jogador pode não ser transmitido para o cliente, potencialmente causando falhas em scripts ao indexar objetos que ainda não existem no cliente.

  ##### Notas

  *   Essa função não retorna se uma criança com o nome dado existe quando a chamada é feita.
  *   `Class.Instance:FindFirstChild()` é uma alternativa mais eficiente para `Class.Instance:WaitForChild()|WaitForChild()` para objetos que se supõe existirem.
  *   Se uma chamada a este método exceder 5 segundos sem retornar e nenhum parâmetro `timeOut` for especificado, uma advertência será impressa na saída que o thread pode produzir indefinidamente.

Instance:WaitForChild

childName

timeOut

Retorna o filho do `Class.Instance` com o nome dado. Se o filho não existir, ele produzirá o subprocesso atual até que ele o faça.

A função das crianças retorna um array de filhos do objeto.

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Essa propriedade determina se a instância deve ser incluída quando a experiência for publicada ou salva ou quando `Class.Instance:Clone()|Clone()` for chamada em um dos ancestrais da instância.Chamar diretamente em uma instância retornará se essa instância não for não .

  Copiar um objeto no Studio usando as opções **Duplicar** ou **Copiar** / **Colar** ignorará sua própria propriedade `Class.Instance.Archivable|Archivable` e definirá `Class.Instance.Archivable|Archivable` para `true` para a cópia.

  ```
  local part = Instance.new("Part")
  print(part:Clone())  --> Part
  part.Archivable = false
  print(part:Clone())  --> nil
  ```

Instance.Archivable

Determina se um `Class.Instance` e seus descendentes podem ser clonados usando `Class.Instance:Clone()` e podem ser salvos/publicados.

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

/reference/engine/classes/SurfaceAppearance.yaml

SurfaceAppearance

Resumo

Propriedades

Métodos

Eventos

Propriedades

AlphaMode

Color

ColorMap

ColorMapContent

MetalnessMap

MetalnessMapContent

NormalMap

NormalMapContent

RoughnessMap

RoughnessMapContent

TexturePack

Métodos

Eventos