**SurfaceAppearance** permite sobreescribir la apariencia de un
`Class.MeshPart` con opciones gráficas avanzadas. De manera notable, puede aplicar un
conjunto de imágenes de textura **Physically‑Based Rendering** (PBR), o mapas, en un
único objeto. Combinar múltiples mapas de textura puede simular con más precisión
el color, la rugosidad y la reflectividad en cualquier entorno de iluminación y puede mejorar
los elementos visuales de tus activos y entorno; consulta
[Texturas PBR](/art/modeling/surface-appearance) para más detalles.

<figure>
<img src="/assets/modeling/surface-appearance/SurfaceAppearance-Example-1.jpg" width="405" alt="Un arbusto de hojas realista" />
<img src="/assets/modeling/surface-appearance/SurfaceAppearance-Example-3.jpg" width="405" alt="Una roca musgosa realista" />
</figure>

La apariencia de este objeto en un `Class.MeshPart` depende del dispositivo del usuario
y del nivel de calidad gráfica. Para obtener los mejores resultados, puede que desees previsualizar tu
contenido con diferentes configuraciones de nivel de calidad.

Ten en cuenta que la mayoría de las propiedades de `Class.SurfaceAppearance` no pueden ser modificadas por
scripts, ya que el pre-procesamiento necesario suele ser demasiado costoso durante
el tiempo de ejecución.

SurfaceAppearance

Esta propiedad determina cómo se utiliza el canal alfa del
`Class.SurfaceAppearance.ColorMap`.

Cuando se establece en `Enum.AlphaMode|Transparency` y el
`Class.MeshPart.Transparency` está configurado en `0`, los píxeles opacos en el
`Class.SurfaceAppearance.ColorMap|ColorMap` se representarán como completamente
opacos en la escena 3D. Esta combinación funciona mejor con efectos basados en la profundidad
y la oclusión.

Cuando se establece en `Enum.AlphaMode|Transparency` y el
`Class.MeshPart.Transparency` está configurado en al menos `0.02`, se utiliza un método
de mezcla diferente que puede representar mejor los gradientes de transparencia suaves
y bordes suaves. Esta combinación no admite todos los efectos
y la oclusión puede no ser perfecta.

Consulta [aquí](/art/modeling/surface-appearance#alpha-modes) para
más información.

SurfaceAppearance.AlphaMode

Determina cómo se utiliza el canal alfa del `Class.SurfaceAppearance.ColorMap`.

Aplica un tinte a tu colormap existente. Configúralo directamente con el selector de color
o programáticamente con `Datatype.Color3`.

SurfaceAppearance.Color

Esta propiedad determina el color y la opacidad de la superficie. Esta
textura a veces se llama la textura **albedo**. El canal alfa de
esta textura controla su opacidad, que se comporta de manera diferente según la
configuración de `Class.SurfaceAppearance.AlphaMode`.

Consulta [aquí](/art/modeling/surface-appearance#color-albedo) para
más información.

SurfaceAppearance.ColorMap

Determina el color y la opacidad de la superficie.

SurfaceAppearance.ColorMapContent

Esta propiedad determina la emisividad aparente en toda la superficie. Una
máscara emisiva es una imagen en escala de grises donde los píxeles negros corresponden a ninguna
emisividad, y los píxeles blancos corresponden a plena emissividad.

La contribución emisiva se suma a la contribución total de iluminación en toda
a la superficie, y la suma se multiplica por la textura albedo, que
se muestrearía de `Class.SurfaceAppearance.ColorMap|ColorMap` si
está proporcionada.

SurfaceAppearance.EmissiveMaskContent

Determina la emisividad en toda la superficie.

Este valor es un multiplicador para controlar cuán fuerte es la contribución emisiva
en toda la superficie. Si la contribución final de los emisivos excede
el rango dinámico soportado, se limitará; esto podría resultar en
que la contribución emisiva aparezca completamente blanca al usar grandes valores de intensidad
emisiva. Dado que este valor es un multiplicador, el valor máximo para
prevenir la limitación depende de todos los demás valores que contribuyen,
incluyendo `Class.SurfaceAppearance.EmissiveTint|EmissiveTint`,
`Class.SurfaceAppearance.ColorMap|ColorMap` y la contribución de iluminación combinada.

SurfaceAppearance.EmissiveStrength

Determina la intensidad de la contribución emisiva.

Este valor es un color RGB para teñir la contribución emisiva.

SurfaceAppearance.EmissiveTint

Determina el color de tinte para la contribución emisiva.

Esta propiedad determina qué partes de la superficie son metálicas o
no metálicas. El mapa de metalicidad es una imagen en escala de grises donde los píxeles negros
corresponden a no metálicos y los píxeles blancos corresponden a metálicos.

Los metales solo reflejan luz del mismo color que el metal, y reflejan
mucha más luz que los no metálicos. La mayoría de los píxeles en un mapa de metalicidad estarán
bien sean completamente negros o completamente blancos, mientras que los valores intermedios pueden ser utilizados para
simular suciedad o grunge sobre un área metálica subyacente.

Cuando `Class.Lighting.EnvironmentSpecularScale` es 0, la metalicidad no tiene
efecto. Para las reflexiones más realistas, se recomienda establecer
`Class.Lighting.EnvironmentSpecularScale` y
`Class.Lighting.EnvironmentDiffuseScale` en 1, así como
`Class.Lighting.Ambient` y `Class.Lighting.OutdoorAmbient` en
`(0, 0, 0)`.

Consulta [aquí](/art/modeling/surface-appearance#metalness) para más
información.

SurfaceAppearance.MetalnessMap

Determina qué partes de la superficie son metálicas o no metálicas.

SurfaceAppearance.MetalnessMapContent

Esta propiedad modifica la iluminación de la superficie al añadir bultos, abolladuras,
grietas y curvas, sin añadir más polígonos. El mapa normal es una imagen RGB
que modifica el vector normal de la superficie utilizado para los cálculos de iluminación. Sus
canales **R**, **G** y **B** corresponden a los componentes **X**, **Y** y **Z** del vector
de superficie local respectivamente, y los valores de byte de 0 y 255 para cada canal corresponden
e linealmente a los componentes del vector normal de -1 y 1.016 respectivamente. Este
rango se estira ligeramente de -1 a 1 para que un valor de byte de 127 se mapee
a exactamente 0.

El eje **Z** del vector normal se define siempre como la dirección del
normal de la malla subyacente. Una imagen uniforme `(127, 127, 255)` se traduce a
un mapa normal completamente plano donde el normal es perpendicular a
la superficie de la malla en todas partes; este formato se denomina como un mapa normal de "espacio tangente".
Ten en cuenta que Roblox no admite mapas normales de espacio mundial o espacio de objeto.

Componentes normales invertidos incorrectamente pueden hacer que los bultos aparezcan como
indentaciones. Si importas un mapa normal y notas que la iluminación se ve mal, puede que necesites
invertir el canal **G** de la imagen. Los ejes **X** y **Y** del
sistema de espacio tangente corresponden a las direcciones **X** y **Y** en la
imagen después de haber sido transformada por las UVs de la malla. Si miras tu mapa normal
en un editor de imágenes como si se mostrara en una superficie, los normales que apuntan
hacia el lado derecho de la pantalla deberían aparecer más rojos, y los normales
que apuntan hacia la parte superior de tu pantalla deberían aparecer más verdes. Los
términos "formato DirectX" y "formato OpenGL" a veces se utilizan para describir
si el canal **G** del mapa normal está invertido o no (Roblox
espera el formato OpenGL).

Roblox también espera que las mallas importadas incluyan tangentes. El software de modelado
puede referirse a esto como información de "espacio tangente". Si aplicas un
mapa normal y no parece hacer ninguna diferencia visual, puede que necesites
re-exportar tu malla junto con su información de tangente desde el software de modelado.

Consulta [aquí](/art/modeling/surface-appearance#normal) para más
información.

SurfaceAppearance.NormalMap

Modifica la iluminación de la superficie al añadir bultos, abolladuras, grietas y
curvas.

SurfaceAppearance.NormalMapContent

SurfaceAppearance.ResampleMode

Esta propiedad determina la rugosidad aparente a través de la superficie. El
 mapa de rugosidad es una imagen en escala de grises donde los píxeles negros
 corresponden a una superficie maximamente lisa, y los píxeles blancos
 corresponden a una superficie maximamente rugosa.

Ten en cuenta que la rugosidad de la superficie funciona a una escala muy
 pequeña. Los reflejos en superficies lisas son nítidos y concentrados, mientras
 que los reflejos en superficies rugosas son más borrosos y dispersos.

Consulta [aquí](/art/modeling/surface-appearance#roughness) para más
 información.


SurfaceAppearance.RoughnessMap

Determina la rugosidad aparente a través de la superficie.


SurfaceAppearance.RoughnessMapContent

SurfaceAppearance.TexturePack

Un objeto que permite a los desarrolladores sobreescribir la apariencia de un MeshPart con opciones gráficas avanzadas.

`Instance` es la clase base para todas las clases de la jerarquía de clases de Roblox
que pueden ser parte del árbol de `Class.DataModel`.

No es posible crear directamente objetos `Instance` en la raíz, pero el constructor especial
`Datatype.Instance.new()` crea objetos a través de código, tomando el
nombre de la clase como parámetro y devolviendo el objeto creado.

Demuestra cómo detectar cambios en la ascendencia de una instancia al conectarse al
`Class.Instance.AncestryChanged` evento.

El Parent de ChangingPart se establece en diferentes valores con el tiempo. El padre de
la parte es el ancestro de la parte, por lo que el evento `Class.Instance.AncestryChanged`
se activará cada vez que cambie.


Se activa cuando esta instancia es reparentada o cuando cualquiera de sus
ancestros es reparentado.

Puedes usar este evento para rastrear la eliminación de una instancia en el
Studio, como la eliminación manual en el Explorador o a través de un
plugin. Si necesitas detectar cuándo una instancia es destruida usando
`Class.Instance:Destroy()`, usa en su lugar el evento
`Class.Instance.Destroying`.

Instance.AncestryChanged

child

La instancia cuya propiedad `Class.Instance.Parent|Parent` ha cambiado,
que puede ser esta instancia o un ancestro más distante, **no**
es necesariamente la instancia a la que el controlador está conectado.

parent

Se activa cuando la propiedad `Class.Instance.Parent` de este objeto o uno de
sus ancestros es cambiada.

Este evento se activa cada vez que se cambia cualquier atributo en la instancia,
incluyendo cuando un atributo se establece en `nil`. El nombre del
atributo cambiado se pasa a la función conectada.

Por ejemplo, el siguiente fragmento de código conecta la función
`attributeChanged()` para que se active cada vez que cambia uno de los
atributos de la parte:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Consulta también `Class.Instance:GetAttributeChangedSignal()` que devuelve un
evento que se activa cuando un atributo específico cambia.

Instance.AttributeChanged

attribute

El nombre del atributo que ha sido cambiado.

Se activa cada vez que se cambia un atributo en la `Class.Instance`.

Este fragmento imprime los nombres de los objetos a medida que se añaden al Espacio de Trabajo:

Se activa después de que un objeto es parentado a esta `Class.Instance`.

Nota, al usar este método en un cliente para detectar objetos creados por el
servidor, es necesario usar `Class.Instance:WaitForChild()` al
indexar los descendientes de este objeto. Esto se debe a que el objeto y sus
descendientes no se garantiza que se repliquen desde el servidor al cliente
simultáneamente. Por ejemplo:

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

Workspace.ChildAdded:Connect(function(child)
	-- Usa WaitForChild() ya que los descendientes pueden no haberse replicado aún
	local head = child:WaitForChild("Head")
end)
```
Nota, este evento solo opera para hijos inmediatos de la
`Class.Instance`. Para un evento que capture todos los descendientes, usa
`Class.Instance.DescendantAdded`.

Consulta también `Class.Instance.ChildRemoved`.

Instance.ChildAdded

La `Class.Instance` que ha sido añadida.

Se activa después de que un objeto es parentado a esta `Class.Instance`.

Instance.childAdded

Este fragmento imprime los nombres de los objetos a medida que se eliminan del
Espacio de trabajo:

Se activa después de que un hijo es eliminado de esta `Class.Instance`.

Eliminado se refiere a cuando el padre de un objeto se cambia de esta
`Class.Instance` a algo diferente de esta `Class.Instance`. Nota, este
evento también se activará cuando un hijo sea destruido (usando
`Class.Instance:Destroy()`) ya que la función de destrucción establece el
padre de un objeto a `nil`.

Este evento solo opera para hijos inmediatos de la `Class.Instance`.
Para un evento que capture todos los descendientes, usa
`Class.Instance.DescendantRemoving`.

Consulta también `Class.Instance.ChildAdded`.

Instance.ChildRemoved

La `Class.Instance` que ha sido eliminada.

Se activa después de que un hijo es eliminado de esta `Class.Instance`.

Este siguiente ejemplo imprimirá el nombre de cualquier objeto que se agregue al
Espacio de trabajo:

Este evento se activa después de que se añade un descendiente a la `Class.Instance`.

Al activarse para cada descendiente, parentar un objeto a la
`Class.Instance` activará el evento para este objeto y todos sus
descendientes individualmente.

Si solo te preocupas por los **hijos directos** de la
`Class.Instance`, usa `Class.Instance.ChildAdded` en su lugar.

Consulta también `Class.Instance.DescendantRemoving`.

Instance.DescendantAdded

descendant

Se activa después de que se añade un descendiente a la `Class.Instance`.

El siguiente ejemplo imprime el nombre de cualquier descendiente mientras se está eliminando
del Workspace:

Este evento se activa **inmediatamente antes** de que el padre de la `Class.Instance`
cambie de forma que una instancia **descendiente** ya no será un
descendiente. `Class.Instance:Destroy()|Destroy()` cambia el
`Class.Instance.Parent|Parent` de una instancia a `nil`, por lo que al llamar a
ese método en un descendiente del padre, este evento se activará.

Dado que este evento se activa **antes** de la eliminación del descendiente,
el padre del descendiente no cambiará en el momento de la activación de
este evento. Si el descendiente también es un **hijo directo** del
padre, este evento se activará antes de `Class.Instance.ChildRemoved`.

Si un descendiente tiene hijos, este evento se activará primero con el
descendiente, seguido por sus descendientes.

#### Advertencia

Este evento se activa con el objeto descendiente que se está eliminando.
Intentar establecer el `Class.Instance.Parent|Parent` del descendiente en
algo más fallará. A continuación se muestra un ejemplo que demuestra esto:

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

Workspace.DescendantRemoving:Connect(function(descendant)
	-- ¡No manipules el padre del descendiente en esta función!
	-- Este evento se activa PORQUE el padre fue manipulado, y el cambio aún no ha ocurrido
	-- Por lo tanto, es problemático cambiar el padre de esta manera:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Consulta también `Class.Instance.DescendantAdded|DescendantAdded`.

Instance.DescendantRemoving

La `Class.Instance` que se está eliminando.

Se activa inmediatamente antes de que se elimine un descendiente de la `Class.Instance`.

Este ejemplo demuestra cómo, al usar el comportamiento de señal Inmediata, una
Instancia que está siendo destruida permanece en su lugar hasta que la función conectada se detiene.


Este ejemplo demuestra cómo, al usar el comportamiento de señal diferida, una Instancia
se destruye antes de que se dispare la señal.


La `Class.Instance` nunca se eliminará de la memoria mientras una función conectada
la esté utilizando. Sin embargo, si la función se bloquea en algún momento,
la `Class.Instance` y sus descendientes serán parentados a `nil`.

Si la propiedad `Class.Workspace.SignalBehavior` está establecida en
`Enum.SignalBehavior.Immediate`, este evento se activa inmediatamente antes del
`Class.Instance` o de uno de sus ancestros es destruido con
`Class.Instance:Destroy()`.

Si la propiedad `Class.Workspace.SignalBehavior` está establecida en
`Enum.SignalBehavior.Deferred`, este evento se activa en el siguiente
punto de reanudación, que estará después de que el `Class.Instance` o uno de
sus ancestros sean destruidos con `Class.Instance:Destroy()`.

Con el comportamiento de `Enum.SignalBehavior.Deferred|Deferred`, conectar un
script a su propio evento `Class.Instance.Destroying` es problemático, ya que el
script será destruido antes de que se pueda llamar al callback (lo que significa
que no se ejecutará).

Al eliminar una `Class.Instance` en Studio, como eliminar manualmente
a través del [Explorador](/studio/explorer) o a través de un
plugin, la `Class.Instance` no es destruida. En su lugar, el padre se establece
en `nil` lo que puedes rastrear con `Class.Instance.AncestryChanged`.

Instance.Destroying

Se activa inmediatamente antes (o se difiere hasta después) de que la instancia se
destruya a través de `Class.Instance:Destroy()`. 

Este evento se activa cada vez que se cambia cualquier propiedad de estilo en la instancia,
incluyendo cuando una propiedad se establece en `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("Las propiedades de estilo han cambiado")
end

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

Instance.StyledPropertiesChanged

Se activa cada vez que se cambia cualquier propiedad de estilo en la instancia,
incluyendo cuando una propiedad se establece en `nil`.

Este método aplica una etiqueta a la instancia, sin efecto si la etiqueta ya
ha sido aplicada. Agregar una etiqueta con éxito generará una señal creada por
`Class.CollectionService:GetInstanceAddedSignal()` con la etiqueta dada.

#### Advertencias

- Las etiquetas de una instancia que fueron añadidas del lado del cliente se eliminarán si el
  servidor más tarde añade o elimina una etiqueta en esa instancia porque el servidor
  replica todas las etiquetas juntas y sobrescribe las etiquetas anteriores.

- Al etiquetar una instancia, es común que se utilicen algunos recursos para
darle a la etiqueta su funcionalidad, por ejemplo conexiones de eventos o tablas.
  Para prevenir fugas de memoria, es una buena idea limpiar estos recursos
  (desconectar, establecer en `nil`, etc.) cuando ya no sean necesarios para una etiqueta. Haz esto al
  llamar a `Class.Instance:RemoveTag()`, al
  llamar a `Class.Instance:Destroy()`, o en una función conectada a una señal
  devuelta por `Class.CollectionService:GetInstanceRemovedSignal()`.

Instance:AddTag

La función de los hijos devuelve un array de los hijos del objeto.

Instance:children

Devuelve un array de los hijos del objeto.

Este método destruye todos los hijos y descendientes de una instancia.

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

-- Agregar algunos destellos
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
```
Si no deseas destruir **todos** los hijos y descendientes, usa ya sea
`Class.Instance:GetChildren()` o `Class.Instance:GetDescendants()` para
recorrer esos hijos/descendientes y seleccionar qué destruir. Por
ejemplo, el siguiente extracto de código destruirá todos
`Class.BasePart|BaseParts` descendientes de un `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 destruye todos los hijos de una instancia.

Demuestra cómo clonar un modelo usando `Class.Instance:Clone()`.

`Clone()` crea una copia de una instancia y de todos sus descendientes,
ignorando todas las instancias que no son
`Class.Instance.Archivable|Archivable`. La copia de la instancia raíz es
devuelta por este método y su `Class.Instance.Parent|Parent` se establece en
`nil`. Ten en cuenta que si la instancia misma tiene
`Class.Instance.Archivable|Archivable` establecida en `false`, este método devolverá
`nil`.

Si una propiedad de referencia como `Class.ObjectValue.Value` se establece en una
instancia clonada, el valor de la propiedad de la copia depende del
valor original:

- Si una propiedad de referencia se refiere a una instancia que también fue clonada,
  la copia se referirá a la copia.
- Si una propiedad de referencia se refiere a una instancia que no fue clonada,
  se mantiene el mismo valor en la copia.

Instance:Clone

Crea una copia de una instancia y de todos sus descendientes, ignorando instancias
que no son `Class.Instance.Archivable|Archivable`.

Instance:clone

Demuestra cómo destruir una Parte utilizando la función `Class.Instance:Destroy()`.

Esta función es la manera correcta de eliminar objetos que ya no son
necesarios.


Establece la propiedad `Class.Instance.Parent` en `nil`, bloquea la
propiedad `Class.Instance.Parent`, desconecta todas las conexiones, y llama a
`Destroy()` en todos los hijos. Este método es la manera correcta de eliminar
objetos que ya no son necesarios.

Eliminar objetos innecesarios es importante, ya que objetos y
conexiones innecesarias en un lugar consumen memoria lo que puede llevar
con el tiempo a problemas serios de rendimiento.

Como mejor práctica después de llamar a `Destroy()` en un objeto, establece cualquier
variable que haga referencia al objeto (o sus descendientes) en `nil`. Esto
previene que tu código acceda a cualquier cosa relacionada con el objeto.

```lua
local part = Instance.new("Part")
part.Name = "Hola, mundo"
part:Destroy()
-- No hagas esto:
print(part.Name)  --> "Hola, mundo"
-- Haz esto para prevenir que la línea anterior funcione:
part = nil
```
Una vez que un `Class.Instance` ha sido destruido por este método, no puede ser
reutilizado porque la propiedad `Class.Instance.Parent` está bloqueada. Para
**eliminar temporalmente** un objeto en lugar de destruirlo, establece
`Class.Instance.Parent|Parent` en `nil`. Por ejemplo:

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

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Para destruir un objeto después de un tiempo determinado, usa
`Class.Debris:AddItem()`.

Instance:Destroy

Establece la propiedad `Class.Instance.Parent` en `nil`, bloquea la
propiedad `Class.Instance.Parent`, desconecta todas las conexiones, y llama a
`Destroy()` en todos los hijos.

Instance:destroy

Devuelve el primer ancestro del `Class.Instance` cuyo
`Class.Instance.Name` es igual al nombre dado.

Este método trabaja hacia arriba, lo que significa que comienza en el `Class.Instance.Parent`
inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se
encuentra un ancestro coincidente, devuelve `nil`.

El siguiente fragmento de código encontraría el primer ancestro del objeto
llamado `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Para variantes de este método que encuentran ancestros de una clase específica,
consulta `Class.Instance:FindFirstAncestorOfClass()` y
`Class.Instance:FindFirstAncestorWhichIsA()`.

Instance:FindFirstAncestor

name

Devuelve el primer ancestro del `Class.Instance` cuyo
`Class.Instance.Name` es igual al nombre dado.

Devuelve el primer ancestro del `Class.Instance` cuyo
`Class.Object.ClassName` es igual al className dado.

Este método trabaja hacia arriba, lo que significa que comienza en el `Class.Instance.Parent`
inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se
encuentra un ancestro coincidente, devuelve `nil`.

Un uso común de este método es encontrar el `Class.Model` al que
pertenece un `Class.BasePart`. Por ejemplo:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Este método es una variante de `Class.Instance:FindFirstAncestor()` que
verifica la propiedad `Class.Object.ClassName` en lugar de `Class.Instance.Name`. También
existe `Class.Instance:FindFirstAncestorWhichIsA()`, que usa el método `Class.Object:IsA()` en su lugar para respetar la
herencia de clases.

Instance:FindFirstAncestorOfClass

className

Devuelve el primer ancestro del `Class.Instance` cuyo
`Class.Object.ClassName` es igual al className dado.

Devuelve el primer ancestro del `Class.Instance` para quien
`Class.Object:IsA()` devuelve verdadero para el className dado.

Este método trabaja hacia arriba, lo que significa que comienza en el `Class.Instance.Parent`
inmediato de la instancia y trabaja hacia el `Class.DataModel`. Si no se
encuentra un ancestro coincidente, devuelve `nil`.

A diferencia de `Class.Instance:FindFirstAncestorOfClass()`, este método utiliza
`Class.Object:IsA()` que respeta la herencia de clases. Por ejemplo:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Por lo tanto, el siguiente fragmento de código devolverá el primer
ancestro `Class.BasePart`, independientemente de si es un `Class.WedgePart`,
`Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Consulta también `Class.Instance:FindFirstAncestor()`.

Instance:FindFirstAncestorWhichIsA

Devuelve el primer ancestro del `Class.Instance` para quien
`Class.Object:IsA()` devuelve verdadero para el className dado.

A continuación, buscaría en Workspace un objeto llamado "Brick". Si se encuentra, cambiará el nombre del objeto a "Foo".

Devuelve el primer hijo del `Class.Instance` con el nombre dado, o
`nil` si no existe tal hijo. Si el argumento opcional `recursive` es
`true`, este método busca todos los descendientes en lugar de solo los
hijos inmediatos del `Class.Instance`.

#### Verificando la Existencia de un Objeto

`FindFirstChild()` es necesario si necesitas verificar que un objeto existe
antes de continuar. Intentar indexar un hijo por nombre usando el operador
punto generará un error si el hijo no existe.

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

-- La siguiente línea da error si la parte no existe en el espacio de trabajo
Workspace.Part.Transparency = 0.5
```
Un enfoque mejor es usar `FindFirstChild()` para primero comprobar si `Part`,
luego usar una instrucción `if` para ejecutar código que lo necesite.

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

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

#### Encontrar un Hijo cuyo Nombre Coincida con una Propiedad

A veces el `Class.Instance.Name|Name` de un objeto es el mismo que el de una
propiedad de `Class.Instance.Parent|Parent`. Al usar el operador punto, las
propiedades tienen prioridad sobre los hijos si comparten un nombre.

En el siguiente ejemplo, se añade una `Class.Folder` llamada `Color` a un
`Class.Part`, que también tiene la propiedad `Class.Part.Color`. Ten en cuenta que
`part.Color` se refiere al valor de la propiedad `Datatype.Color3`, no a la instancia hija
`Class.Folder`. Un beneficio de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` es que la
introducción de nuevas propiedades no pone en riesgo tu código.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- La propiedad
local c2 = part:FindFirstChild("Color")  -- La carpeta hija
```

#### Notas de Rendimiento

`Class.Instance:FindFirstChild()|FindFirstChild()` toma aproximadamente un 20% más de
tiempo que usar el operador punto y casi 8 veces más que simplemente guardar un
referencia a un objeto. Por lo tanto, debes evitar llamarlo en
código dependiente del rendimiento, como en bucles ajustados o funciones conectadas
a `Class.RunService.Heartbeat` y `Class.RunService.PreRender`. En su lugar,
almacena el resultado en una variable, o considera usar
`Class.Instance.ChildAdded|ChildAdded` o
`Class.Instance:WaitForChild()|WaitForChild()` para detectar cuándo un hijo de un
dado nombre se convierte disponible.

Instance:FindFirstChild

recursive

Si la búsqueda debe ser realizada de forma recursiva.

Devuelve el primer hijo del `Class.Instance` encontrado con el nombre dado.

Instance:findFirstChild

Devuelve el primer hijo del `Class.Instance` cuyo
`Class.Object.ClassName|ClassName` es igual al `className` dado.
A diferencia de `Class.Instance:FindFirstChildWhichIsA()`, este método solo devuelve
objetos cuya clase coincide con `className`, ignorando la herencia de clases. Si no se
encuentra un hijo coincidente, este método devuelve `nil`.

Instance:FindFirstChildOfClass

Devuelve el primer hijo del `Class.Instance` cuyo
`Class.Object.ClassName|ClassName` es igual al nombre de clase dado.

Devuelve el primer hijo del `Class.Instance` para quien
`Class.Object:IsA()` devuelve verdadero para el className dado.

Si no se encuentra un hijo coincidente, este método devuelve `nil`. Si el argumento
opcional recursivo es verdadero, este método busca todos los descendientes en lugar
de solo los hijos inmediatos del `Class.Instance`.

A diferencia de `Class.Instance:FindFirstChildOfClass()`, este método utiliza
`Class.Object:IsA()` que respeta la herencia de clases. Por ejemplo:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Por lo tanto, el siguiente fragmento de código devolverá el primer
hijo `Class.BasePart`, independientemente de si es un `Class.WedgePart`,
`Class.MeshPart` o `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Los desarrolladores que busquen un hijo por nombre, deben usar
`Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstChildWhichIsA

Devuelve el primer hijo del `Class.Instance` para quien
`Class.Object:IsA()` devuelve verdadero para el className dado.

Devuelve el primer descendiente encontrado con el `Class.Instance.Name` dado.

Este método está deshabilitado y no se puede usar. Para encontrar el primer descendiente
de una instancia, considera usar el parámetro `recursive` en
`Class.Instance:FindFirstChild()` en su lugar.

Instance:FindFirstDescendant

Devuelve el primer descendiente encontrado con el `Class.Instance.Name` dado.

Si el `Class.Instance` es un `Class.Actor`, se devuelve el `Class.Actor` mismo.
De lo contrario, se devuelve su ancestro más cercano `Class.Actor`. Si no
hay ancestro que sea un `Class.Actor`, el resultado es `nil`.

Instance:GetActor

Devuelve el `Class.Actor` asociado con la instancia, si lo hay.

Este método devuelve el valor que se ha asignado al nombre de
atributo dado. Si no se ha asignado ningún atributo, se devuelve `nil`.

Por ejemplo, el siguiente fragmento de código establece y luego obtiene el valor del
atributo `InitialPosition` de la instancia:

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

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

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

#### Consulta También

- `Class.Instance:SetAttribute()` que establece el atributo con el nombre dado en el valor dado.
- `Class.Instance:GetAttributes()` que devuelve un diccionario de pares clave-valor
  para cada uno de los atributos de la instancia.

Instance:GetAttribute

El nombre del atributo que se está recuperando.

El valor que se ha asignado al nombre de atributo dado. Si no se
ha asignado ningún atributo, se devuelve `nil`.

Devuelve el valor que se ha asignado al nombre de atributo dado.

Este método devuelve un evento que se comporta exactamente como el
evento `Class.Object.Changed|Changed`, excepto que solo se activa cuando
el atributo específico dado cambia; efectivamente es similar a
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` pero
para atributos.

Es generalmente una buena idea usar este método en lugar de una conexión a
`Class.Object.Changed|Changed` con una función que verifica el nombre del atributo.
Las llamadas posteriores a este método en el mismo objeto con el mismo
nombre de atributo devuelven el mismo evento.

El siguiente ejemplo de código devuelve una señal que activa la función
`attributeChanged()` cuando cambia el atributo `InitialPosition` de la parte:

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

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

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

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Consulta también `Class.Instance.AttributeChanged` que se activa cada vez que se
cambia cualquier atributo en la instancia.

Instance:GetAttributeChangedSignal

El nombre del atributo especificado para el cual se devuelve la señal de cambio.

Un evento que se activa cuando cambia el atributo dado.

Devuelve un evento que se activa cuando cambia el atributo dado.

Este método devuelve un diccionario de pares clave-valor para cada atributo
donde la clave es el nombre del atributo y el valor es un valor no `nil`.

Por ejemplo, el siguiente código devuelve los atributos de una instancia
y sus valores:

```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
```
Consulta también `Class.Instance:GetAttribute()` que devuelve el valor que se ha
asignado al nombre de atributo dado.

Instance:GetAttributes

Un diccionario de pares string → variante para cada atributo donde la
string es el nombre del atributo y la variante es un valor no nulo.

Devuelve un diccionario de los atributos de la instancia.

A continuación se imprimiría el nombre de todos los objetos actualmente en Workspace cuando se ejecuta.

Devuelve un array (una tabla numerada) que contiene todos los
hijos directos de la instancia, o cada `Class.Instance` cuyo
`Class.Instance.Parent|Parent` es igual al objeto. El array puede ser
iterado usando ya sea un bucle numérico o un bucle genérico:

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

-- Ejemplo de bucle numérico
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " es el hijo número " .. i)
end
```

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

-- Ejemplo de bucle genérico
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " es el hijo número " .. i)
end
```
Ten en cuenta que el array devuelto **no** está ordenado de ninguna manera,
sí que se recomienda realizar un ordenamiento manual (por ejemplo, usando
`Library.table.sort()`) para ordenar los hijos devueltos por este método.

Consulta también el método `Class.Instance:GetDescendants()|GetDescendants()`.

Instance:GetChildren

Un array que contiene los hijos de la instancia.

Devuelve un array que contiene todos los hijos de la instancia.

Instance:getChildren

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox. Ten en cuenta que:

- Este elemento está protegido. Intentar usarlo en un `Class.Script` o
  `Class.LocalScript` causará un error.
- Un ID de depuración es un ID utilizado en procesos de depuración. Permite que un depurador
  lea cada instrucción antes de que una aplicación la procese. Todos los objetos en
  Roblox actúan como procesos y cada uno ejecuta instrucciones (o 'código') que pueden
  ser depuradas si es necesario.
- Esto puede ser útil para complementos que necesitan distinguir objetos similares
  entre sí (como objetos que comparten el mismo nombre).

Instance:GetDebugId

scopeLength

Devuelve una cadena codificada del ID de depuración utilizado internamente por Roblox.

GetDescendants se usa a menudo para hacer algo con todos los descendientes que son un
tipo particular de objeto. El código en este ejemplo utiliza GetDescendants y
`Class.Instance:IsA()` para encontrar todas las partes en el espacio de trabajo y las
convierte en verdes.

Este método de objeto devuelve un array que contiene todos los
descendientes de ese objeto. A diferencia de `Class.Instance:GetChildren()`, que solo devuelve
los hijos inmediatos de un objeto, este método encuentra cada niño del
objeto, cada niño de esos hijos, y así sucesivamente.

Ten en cuenta que el array devuelto **no** está ordenado de ninguna manera,
sí que se recomienda realizar un ordenamiento manual (por ejemplo, usando
`Library.table.sort()`) para ordenar los descendientes devueltos por este método. También considera el método
`Class.Instance:QueryDescendants()|QueryDescendants()` para consultar
descendientes por una combinación de selectores y combinadores.

Instance:GetDescendants

Un array que contiene los descendientes de la instancia.

Devuelve un array que contiene todos los descendientes de la instancia.

Este ejemplo de código demuestra el comportamiento de `Class.Instance:GetFullName()`.
Muestra cómo se comporta la función cuando se llama a un objeto que no está en la
jerarquía de `DataModel`, y también muestra cómo el valor de retorno no escapa
caracteres especiales.

Este ejemplo de código reimplementa la función `Class.Instance:GetFullName()` en
Lua.

Devuelve una cadena que describe la ascendencia de la instancia. La cadena es una
concatenación de `Class.Instance.Name|Name` del objeto y sus
ancestros, separados por puntos. El `Class.DataModel` (`game`) no
se considera. Por ejemplo, un `Class.Part` en el `Class.Workspace` puede
devolver `Class.Workspace.Part`.

Cuando se llama a un `Class.Instance` que no es un descendiente de la
`Class.DataModel`, este método considera todos los ancestros hasta e incluyendo
el más alto que no tenga un `Class.Instance.Parent|Parent`.

Este método es útil para registrar y depurar. No debes intentar
analizar la cadena devuelta para ninguna operación útil; este método no
escapa puntos (o cualquier otro símbolo) en los nombres de objeto. En otras palabras,
aunque su salida parece ser un identificador válido de Luau, no está
garantizado.

Instance:GetFullName

Devuelve una cadena que describe la ascendencia de la instancia.

Este método devuelve el valor estilizado o explícitamente modificado de la
propiedad especificada, o el valor de propiedad predeterminado si no ha sido
estilizado/modificado. Esto difiere ligeramente de acceder al valor de la propiedad
directamente, como `[GuiObject].Rotation`, que devuelve el valor predeterminado o
modificado de la propiedad.

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

-- Referencia a un botón
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (valor predeterminado)
print(button.Rotation) --> 0 (valor predeterminado)

-- Aplicar rotación a través de la propiedad de regla de estilo
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (valor estilizado basado en regla)
print(button.Rotation) --> 0 (valor predeterminado)

-- Modificar explícitamente/sobrescribir propiedad estilizada
button.Rotation = 45

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

Instance:GetStyled

selector

Selector opcional para la pseudo instancia que estás objetivo en la
instancia.

El valor estilizado o explícitamente modificado de la propiedad especificada, o
el valor de propiedad predeterminado si no ha sido estilizado/modificado.

Devuelve el valor estilizado o explícitamente modificado de la propiedad especificada,
o el valor de propiedad predeterminado si no ha sido estilizado/modificado.

Este método devuelve un evento que se comporta exactamente como el
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
salvo que solo se activa cuando cambia la propiedad de estilo dada. Es
una buena idea utilizar este método en lugar de una conexión a
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` con una
función que verifica el nombre de la propiedad. Las llamadas posteriores a este método en
el mismo objeto con el mismo nombre de propiedad devuelven el mismo evento.

Ten en cuenta que este evento no pasará ningún argumento a una función conectada,
por lo que el valor de la propiedad modificada debe leerse directamente dentro de un
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("¡Propiedad de estilo cambiada!")
end

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

Instance:GetStyledPropertyChangedSignal

property

Nombre de la propiedad de estilo para la cual se escuchará cambios.

Evento que se activa cuando cambia la propiedad de estilo dada.

Este método devuelve un array de las etiquetas aplicadas a la instancia dada, como
cadenas. Puedes añadir etiquetas ya sea en Studio en la
[Ventana de Propiedades](/studio/properties) o en tiempo de ejecución con
`Class.Instance:AddTag()|AddTag()`.

Este método es útil cuando deseas hacer algo con múltiples etiquetas en
una instancia a la vez. Sin embargo, es ineficiente usar este método para
comprobar la existencia de una sola etiqueta; en su lugar, usa
`Class.Instance:HasTag()|HasTag()` para comprobar una etiqueta específica.

Instance:GetTags

Obtiene un array de todas las etiquetas aplicadas a la instancia.

Este método devuelve `true` si la etiqueta proporcionada ha sido añadida al
objeto. Puedes añadir etiquetas ya sea en Studio en la
[Ventana de Propiedades](/studio/properties) o en tiempo de ejecución con
`Class.Instance:AddTag()|AddTag()`.

Instance:HasTag

Comprueba si la instancia tiene una etiqueta dada.

Demuestra cómo determinar si una instancia es el ancestro de otra usando
`Class.Instance:IsAncestorOf()`

Workspace y SpawnLocation son ancestros del decal de SpawnLocation.
Workspace es un ancestro de SpawnLocation.

SpawnLocation y su decal son descendientes de Workspace, no ancestros.
El decal es un descendiente de SpawnLocation, no un ancestro.


Devuelve verdadero si un `Class.Instance` es un ancestro del dado
descendiente.

Se considera que un `Class.Instance` es el ancestro de un objeto si la
`Class.Instance.Parent` del objeto o uno de los `Class.Instance.Parent`
del padre está establecido en el `Class.Instance`.

Consulta también, `Class.Instance:IsDescendantOf()`.

Instance:IsAncestorOf

Verdadero si el `Class.Instance` es un ancestro del dado descendiente.

Devuelve verdadero si un `Class.Instance` es un ancestro del dado
descendiente.

Devuelve `true` si un `Class.Instance` es un descendiente del dado
ancestro.

Ten en cuenta que `IsDescendantOf()` no se puede usar con un parámetro de `nil` para
comprobar si un objeto ha sido eliminado.

Consulta también `Class.Instance:IsAncestorOf()`.

Instance:IsDescendantOf

ancestor

Verdadero si el `Class.Instance` es un descendiente del dado ancestro.

Devuelve `true` si un `Class.Instance` es un descendiente del dado
ancestro.

Instance:isDescendantOf

Este método indica si una propiedad específica ha sido modificada desde
la predeterminada instanciada por código. Si se llama en una instancia recién creada a través
código (`Datatype.Instance.new()`), este método devolverá `false`. Si
se llama en un objeto recién creado por flujos de trabajo de Studio como
a través de la ventana del [Explorador](/studio/explorer), el resultado puede
diferir.

Por ejemplo, consultar la
`Class.TextLabel.BackgroundColor3|BackgroundColor3` de un
`Class.TextLabel` insertado a través de la ventana del [Explorador](/studio/explorer)
volverá `true`, pero consultar la misma propiedad de un `Class.TextLabel`
creado a través de `Datatype.Instance.new()` devolverá `false`, suponiendo que no
se han realizado otros cambios en su
`Class.TextLabel.BackgroundColor3|BackgroundColor3`.

Ten en cuenta que este método solo devuelve resultados útiles para servicios y
instancias creadas por usuarios. Los valores de retorno para propiedades pobladas por el sistema de
instancias como `Class.PackageLink` son un comportamiento indefinido.

Además, ten en cuenta que si este método devuelve `true`, el estilo **no** afectará
a la propiedad porque la modificación explícita de una propiedad tiene prioridad sobre
su estilización. Para restablecer una propiedad a su valor predeterminado
y permitir que el estilo se aplique, usa
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.

Instance:IsPropertyModified

Booleano que indica si la propiedad se ha modificado desde su
predeterminada instanciada por código.

Devuelve `true` si el valor almacenado en la propiedad especificada no es igual
a la predeterminada instanciada por código.

Este método de objeto devuelve un array que contiene todos los descendientes del
objeto que coinciden con la cadena `selector` proporcionada. `selector` puede incluir
múltiples selectores y combinadores para coincidir con características como el
nombre de clase, nombre de instancia, y relaciones de jerarquía, así como
valores específicos de propiedades y atributos de instancia. La
gramática de `selector` es similar a la utilizada en `Class.StyleRule`, con solo unas pocas
diferencias respecto a qué partes de la gramática son compatibles o no.

#### Selectores

- `ClassName` — Coincide con instancias de la clase especificada en una
  relación `Class.Object:IsA()`.
- `.Tag` — Coincide con instancias etiquetadas con un tag de `Class.CollectionService`.
- `#Name` — Coincide con instancias de un `Class.Instance.Name` específico.
- `[property = value]` — Coincide con instancias que tienen la
  propiedad especificada y esa propiedad tiene el valor especificado. Se admiten valores booleanos, numéricos y
  de cadena. Se pueden usar letras, números, `_` y `-` sin poner el valor entre comillas.
- `[$attribute]` — Coincide con instancias que tienen el
  [atributo](/studio/properties#instance-attributes) especificado.
- `[$attribute = value]` — Coincide con instancias que tienen el atributo
  especificado **y** ese atributo tiene el valor especificado. Las mismas
  limitaciones se aplican que para los selectores de propiedades. Si deseas verificar la
  ausencia de un atributo, no lo consultes como `nil`; en su lugar, utiliza la
  pseudo-clase `:not` como en `:not([$attribute])`.

Los selectores también se pueden combinar. Por ejemplo,
`Model.Apple[$Variety = Fuji][$Flavor = 4]` coincidirá con instancias que son
un `Class.Model` etiquetado como `Apple` y que tienen un atributo `Variety`
equivalente a `Fuji`, así como un atributo `Flavor` equivalente a `4`.

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

-- Obtener todos los descendientes de MeshPart
print(Workspace:QueryDescendants("MeshPart"))

-- Obtener todos los descendientes etiquetados como "Fruit"
print(Workspace:QueryDescendants(".Fruit"))

-- Obtener todos los descendientes con el nombre "RedTree"
print(Workspace:QueryDescendants("#RedTree"))

-- Obtener todos los descendientes con la propiedad CanCollide establecida en false
print(Workspace:QueryDescendants("[CanCollide = false]"))

-- Obtener todos los descendientes con un atributo "FuelCapacity" asignado
print(Workspace:QueryDescendants("[$FuelCapacity]"))
-- Obtener todos los descendientes con un atributo "FuelCapacity" establecido en 75
print(Workspace:QueryDescendants("[$FuelCapacity = 75]"))
```

#### Combinadores

Los combinadores te permiten mezclar selectores básicos para coincidir con relaciones de jerarquía más profundas.

- `>` — Coincide con instancias que son **hijos directos** de los matches del filtro anterior.

- `>>` — Coincide con instancias que son **descendientes** de los matches del filtro anterior. Este es el primer filtro por defecto, lo que significa que `SpotLight.Red`
  es lo mismo que `>> SpotLight.Red`.

- `,` — Especifica una lista de múltiples selectores independientes para la
  consulta de descendientes. Solo los elementos que coinciden con el filtro se colocan en el
  array devuelto; `nil` no se incluirá para no coincidencias en una lista de consulta.

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

-- Obtener hijos directos de cualquier Modelo que están etiquetados como "SwordPart"
print(Workspace:QueryDescendants("Model > .SwordPart"))

-- Obtener hijos directos que son un Part y están etiquetados como "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

-- Obtener descendientes de cualquier Modelo con un atributo "OnFire" establecido en true
print(Workspace:QueryDescendants("Model >> [$OnFire = true]"))

-- Obtener descendientes de MeshPart etiquetados como "SwordPart" O con un atributo "OnFire" establecido en true
print(Workspace:QueryDescendants("MeshPart.SwordPart, MeshPart[$OnFire = true]"))
```

#### Selectores de pseudo-clase

- `:not(complex-selector-list)` — Permite seleccionar instancias que **no** coinciden con ninguno de los selectores dentro, realizando efectivamente una
  negación de los selectores. Dado que la expresión dentro es una lista de
  selectores complejos, es posible filtrar en función de múltiples condiciones.

- `:has(relative-selector-list)` — Permite seleccionar instancias basadas en
  qué instancias contienen dentro. La lista de selectores se evalúa
  respecto a cada instancia.

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

-- Obtener todos los descendientes que NO son de la clase SpotLight
print(Workspace:QueryDescendants(":not(SpotLight)"))
-- Obtener todos los descendientes que NO son de la clase SpotLight O PointLight
print(Workspace:QueryDescendants(":not(SpotLight, PointLight)"))
-- Obtener todos los descendientes que NO tienen un atributo "OnFire"
print(Workspace:QueryDescendants(":not([$OnFire])"))
-- Obtener todos los descendientes EXCEPTO hijos de un Modelo etiquetado como "SwordPart"
print(Workspace:QueryDescendants(":not(Model > .SwordPart)"))

-- Obtener descendientes que contienen una instancia de Tool como su propio descendiente
print(Workspace:QueryDescendants(":has(Tool)"))
-- Obtener descendientes de MeshPart que contienen un hijo directo etiquetado como "SwordPart"
print(Workspace:QueryDescendants("MeshPart:has(> .SwordPart)"))

-- Obtener descendientes de MeshPart con hijos directos NO de la clase SurfaceAppearance o Texture
print(Workspace:QueryDescendants("MeshPart:has(> :not(SurfaceAppearance, Texture))"))
```


Instance:QueryDescendants

Cadena de selector utilizada para filtrar elementos.

Un array de instancias (vacío si nada coincidió con el selector).

Devuelve un array que contiene todos los descendientes de la instancia que coinciden con la
cadena `selector`.


El siguiente código demuestra cómo una parte puede ser agregada nuevamente al DataModel
después de haber sido eliminada:

Este método establece el `Class.Instance.Parent` del objeto en `nil`, y hace
lo mismo para todos sus descendientes.

Si el objeto es referenciado antes de ser eliminado, es posible
recuperar el objeto en un momento posterior.

Instance:Remove

Establece el `Parent` del objeto en `nil`, y hace lo mismo para todos sus
descendientes.

Instance:remove

Instance

`Instance` es la clase base para todas las clases de la jerarquía de clases de Roblox
que pueden ser parte del árbol de `Class.DataModel`.

/reference/engine/classes/SurfaceAppearance.yaml