WrapTextureTransfer proporciona un modo de proyección alternativo para `Class.Decal`
donde este `Class.Decal` se ajusta al `Class.MeshPart` padre en función de su
CageMesh proporcionado en `Class.WrapTarget`.

Esto es útil ya que permite que los Decals se adapten a una amplia variedad de
MeshParts de diferentes formas que comparten una topología de CageMesh de
WrapTarget similar. Al crear texturas que están en el espacio UV de WrapTarget,
estas texturas se pueden reutilizar en muchos MeshParts diferentes con
diferentes diseños de texturas.

- Estructura del DataModel
  - `Class.MeshPart`
    - `Class.WrapTarget`
    - `Class.Decal`
      - `Class.WrapTextureTransfer`

Una forma de visualizar cómo funciona esto es imaginar las texturas de los Decals en el
CageMesh de WrapTarget, que se envuelve alrededor del MeshPart. Estas texturas se
proyectan desde el CageMesh hacia la superficie del MeshPart. La geometría que es
interna al MeshPart, o que no está cubierta por el CageMesh, no recibirá
ninguna textura de decal proyectada. Las regiones segmentadas del `Class.MeshPart`
target se utilizan para mejorar la calidad de la proyección cerca de agujeros o
límites en el CageMesh.

Prepara este `Class.WrapTextureTransfer` para usarlo como el
`projectionSource` en `Class.EditableImage:DrawImageProjected()` y
`Class.EditableImage:SampleImageProjected()`. Este método no toma
parámetros, se suspende hasta que la preparación se complete y no devuelve ningún valor.

Esto permite la edición de texturas proyectadas, como pintar maquillaje en la
cabeza actual de un jugador, sin crear un `Class.EditableMesh` a partir del
activo objetivo o requerir permiso para crear uno. Los datos preparados se
almacenan en caché internamente; no se devuelven a los scripts y no pueden ser inspeccionados,
convertidos a `Datatype.Content` o publicados.

El `Class.WrapTextureTransfer` debe estar parentado a un `Class.Decal` cuyo
padre sea un `Class.MeshPart` con contenido de malla y un
hijo `Class.WrapTarget` válido. Esta jerarquía debe estar en el modelo de datos.
Configura `Class.WrapTextureTransfer.ReferenceCageMeshContent`,
`Class.WrapTextureTransfer.UVMinBound` y
`Class.WrapTextureTransfer.UVMaxBound` según sea necesario antes de llamar a este
método.

Los datos preparados combinan las posiciones, normales y
conectividad de triángulos de la malla objetivo dentro de la región cubierta por la transferencia con los
UVs transferidos calculados a partir de la configuración actual de la jaula y los límites UV. La geometría se escala para coincidir con el
`Class.MeshPart` objetivo actual `Class.BasePart.Size`. Las posiciones y direcciones de proyección utilizan el
espacio local del MeshPart objetivo.

La preparación se reutiliza en operaciones de imagen proyectada mientras los datos
permanecen válidos. Los cambios en la malla objetivo o su tamaño, configuración de la jaula,
b límites UV, o jerarquía invalidan los datos en caché. Llama a este método nuevamente
despues de tal cambio. Ambos métodos de proyección generan un error si la preparación
no se ha completado con éxito o los datos en caché han sido invalidados.
Pasar un `Class.EditableMesh` a esos métodos no requiere esta
preparación.

Usa `pcall()` para manejar errores de preparación, incluyendo jerarquía inválida,
datos de malla o jaula no disponibles, transferencia de UV fallida, o entradas que cambian
durante la preparación. Solo realiza operaciones de imagen proyectada después de que la llamada
sea exitosa.

Por ejemplo, con la cabeza, el decal, las imágenes, el contenido de la jaula de referencia, los límites UV,
y las configuraciones del pincel ya definidas:

```lua
local projectionTransfer = Instance.new("WrapTextureTransfer")
projectionTransfer.ReferenceCageMeshContent = referenceCageContent
projectionTransfer.UVMinBound = makeupUVMin
projectionTransfer.UVMaxBound = makeupUVMax
projectionTransfer.Parent = makeupDecal
makeupDecal.Parent = playerHead

local success, errorMessage = pcall(function()
    projectionTransfer:PrepareProjectionMeshDataAsync()
end)

if not success then
    warn("Error al preparar la proyección de maquillaje: " .. tostring(errorMessage))
    return
end

makeupTexture:DrawImageProjected(projectionTransfer, projection, brushConfig)
sampledBrush:SampleImageProjected(
    projectionTransfer,
    makeupTexture,
    projection,
    sampleBrushConfig
)
```


WrapTextureTransfer:PrepareProjectionMeshDataAsync

Prepara y almacena en caché los datos de proyección para usar este
`Class.WrapTextureTransfer` con operaciones proyectadas de `Class.EditableImage`.


WrapTextureTransfer

La malla de jaula de referencia es la malla de jaula para la que se creó la textur.
Esta jaula de destino definida en `Class.WrapTarget` se poda en relación a
este `ReferenceCageMeshContent`. Si la jaula de destino contiene vértices
o caras que no están presentes en la malla de jaula de referencia, estos vértices
y caras se eliminan de la jaula de destino antes de realizar la
transferencia de textura. Si no hay UVs compartidos entre
`ReferenceCageMeshContent` y la malla de jaula definida en `Class.WrapTarget`,
la transferencia de textura falla.

Cuando no se define, se utiliza la jaula en `Class.WrapTarget` del ancestro
`Class.MeshPart` para la transferencia sin ninguna poda o validación.

WrapTextureTransfer.ReferenceCageMeshContent

Una malla de referencia opcional utilizada para podar y validar la jaula
target.

Determina el límite máximo del espacio UV a incluir en la transferencia.
Las áreas de la malla de jaula con valores UV mayores que el límite máximo
no se incluyen al aplicar la textura.

Las texturas de Decal se aplican al `Class.MeshPart` padre con las texturas
escalando linealmente entre UVMinBound y UVMaxBound.

Cuando se establece en el valor predeterminado -inf, se utiliza el valor UV máximo de la jaula de WrapTarget.

WrapTextureTransfer.UVMaxBound

Determina el límite máximo del espacio UV a incluir en la transferencia.

Determina el límite mínimo del espacio UV a incluir en la transferencia.
Las áreas de la malla de jaula con valores UV menores que el límite mínimo
no se incluyen al aplicar la textura.

Las texturas de Decal se aplican al `Class.MeshPart` padre con las texturas
escalando linealmente entre UVMinBound y UVMaxBound.

Cuando se establece en el valor predeterminado inf, se utiliza el valor UV mínimo de la jaula de WrapTarget.

WrapTextureTransfer.UVMinBound

Determina el límite mínimo del espacio UV a incluir en la transferencia.

`Class.WrapTextureTransfer` permite que un `Class.Decal` padre se envuelva alrededor de
su `Class.MeshPart` padre según la jaula de su `Class.WrapTarget`.

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

No es posible crear objetos `Instance` raíz directamente, 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 Studio,
such as la eliminación manual en el Explorador o a través de un complemento. Si necesitas
detectar cuándo se destruye una instancia usando `Class.Instance:Destroy()`,
usa el evento `Class.Instance.Destroying` en su lugar.


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**
necesariamente la instancia a la que está conectado el manejador.


parent

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


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()`
a activarse cada vez que uno de los atributos de la parte cambia:

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

local part = Workspace.Part

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

part.AttributeChanged:Connect(attributeChanged)
```
Véase 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 el `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 se haya parentado a este `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 estos objetos. Esto se debe a que el objeto y sus
descendientes no se garantiza que se repliquen del 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 del
`Class.Instance`. Para un evento que captura todos los descendientes, usa
`Class.Instance.DescendantAdded`.

Véase también `Class.Instance.ChildRemoved`.


Instance.ChildAdded

El `Class.Instance` que ha sido agregado.


Se activa después de que un objeto se haya parentado a este `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 este `Class.Instance`.

Eliminado se refiere a cuando el padre de un objeto cambia de este
`Class.Instance` a algo diferente de este `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
como `nil`.

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

Véase también `Class.Instance.ChildAdded`.


Instance.ChildRemoved

El `Class.Instance` que ha sido eliminado.


Se activa después de que un hijo es eliminado de este `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 un descendiente se agrega al `Class.Instance`.

Como se activa para cada descendiente, parentar un objeto al
`Class.Instance` activará el evento para este objeto y todos sus
descendientes individualmente.

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

Véase también `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Se activa después de que un descendiente se agrega al `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 `Class.Instance`
cambie de tal manera 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 llamar a ese método en un
descendiente del padre hará que este evento se active.

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 activa primero con el descendiente,
siguido de sus descendientes.

#### Advertencia

Este evento se activa con el objeto descendiente que se está eliminando.
Intentar establecer el `Class.Instance.Parent|Parent` del descendiente a
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
```
Véase también `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

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


Se activa inmediatamente antes de que un descendiente del `Class.Instance` sea eliminado.


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.

El `Class.Instance` nunca será eliminado de la memoria mientras una función conectada
lo esté utilizando. Sin embargo, si la función se suspende en algún momento,
el `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 de que el
`Class.Instance` o uno de sus ancestros sea 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 será después de que el `Class.Instance` o uno de sus ancestros sea
destruido con `Class.Instance:Destroy()`.

Con el comportamiento `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 a la devolución de llamada (lo que significa que no
se ejecutará).

Al eliminar un `Class.Instance` en Studio, como eliminar manualmente
a través del [Explorador](/studio/explorer) o a través de un complemento,
el `Class.Instance` no se destruye. 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 pospone hasta después) de que la instancia sea
destruida a través de `Class.Instance:Destroy()`.


Demuestra `Class.Instance.StyledPropertiesChanged`.


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


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 está
aplicada. Agregar una etiqueta con éxito activará una señal creada por
`Class.CollectionService:GetInstanceAddedSignal()` con la etiqueta dada.

#### Advertencias

- Las etiquetas de una instancia que se agregaron del lado del cliente se eliminarán si el
  servidor agrega o quita una etiqueta en esa instancia más tarde 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 funcionalidad a la etiqueta, 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 se necesiten 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 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 fragmento 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 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` establecido 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 del original:

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


Instance:Clone

Una copia de la instancia, o `nil` si la instancia no es
`Class.Instance.Archivable|Archivable`.


Crea una copia de una instancia y 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
`Destroy()` en todos los hijos. Este método es la forma correcta de eliminar
objetos que ya no son necesarios.

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

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 = "Hello, world"
part:Destroy()
-- No hagas esto:
print(part.Name)  --> "Hello, world"
-- 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
`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 funciona 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 funciona 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`. `Class.Instance:FindFirstAncestorWhichIsA()` también
existe, utilizando el método `Class.Object:IsA()` en su lugar para respetar la
herencia de clases.


Instance:FindFirstAncestorOfClass

className

El `Class.Object.ClassName` que se busca.


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 funciona 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 en todos los descendientes en lugar de solo en los
hijos inmediatos del `Class.Instance`.

#### Comprobando 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 de punto
lanza un error si el hijo no existe.

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

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

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

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

#### Encontrando un Hijo cuyo Nombre Coincide con una Propiedad

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

En el siguiente ejemplo, se agrega una `Class.Folder` llamada `Color` a un
`Class.Part`, que también tiene la propiedad `Class.Part.Color`. Observa que
`part.Color` se refiere al valor de la propiedad `Datatype.Color3`, no a la
instancia de la carpeta hijo `Class.Folder`. Un beneficio de usar
`Class.Instance:FindFirstChild()|FindFirstChild()` es que la
introducción de nuevas propiedades no impone un riesgo en 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 hijo
```

#### Notas de Rendimiento

`Class.Instance:FindFirstChild()|FindFirstChild()` toma aproximadamente un 20% más
que usar el operador de punto y casi 8 veces más que simplemente almacenar
una 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 vuelve disponible.


Instance:FindFirstChild

recursive

Si la búsqueda debe realizarse de manera 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 en todos los descendientes en lugar
de solo en 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 buscan 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` en sí.
De lo contrario, se devuelve su ancestro más cercano `Class.Actor`. Si ningún
ancestro es 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 de
el 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)
```

#### Ver También

- `Class.Instance:SetAttribute()` que establece el atributo con el nombre dado
  al 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.

Generalmente es 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 subsiguientes 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 el atributo `InitialPosition` de la parte cambia:

```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
cualquier atributo se cambia 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 el atributo dado cambia.


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


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 fragmento de código muestra 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 de cadena → variante para cada atributo donde la
cadena 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 indexada numéricamente) 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 un bucle numérico o 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 en ningún orden particular, por lo que
se recomienda la ordenación 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 a un depurador
  leer cada instrucción antes de que una aplicación la procese. Todos los objetos en
  Roblox actúan como procesos y cada ejecución de instrucciones (o 'código') que puede
  ser depurado si es necesario.
- Esto puede ser útil para plugins 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 hijo del
objeto, cada hijo de esos hijos, y así sucesivamente.

Ten en cuenta que el array devuelto **no** está ordenado en ningún orden particular, por lo que
se recomienda la ordenación 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 mediante 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 del `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 del
`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 el registro y la depuración. 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 los objetos. En otras palabras,
si bien su salida a menudo parece ser un identificador válido de Luau, no está
garantizado.


Instance:GetFullName

El nombre completo del `Class.Instance`.


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.


Instance:GetStyled

selector

Selector opcional para la instancia pseudo que estás apuntando 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.


Demuestra `Class.Instance:GetStyledPropertyChangedSignal()`.


Este método devuelve un evento que se comporta exactamente como el
evento `Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
excepto que solo se activa cuando la propiedad de estilo dada cambia. Es
generalmente una buena idea usar 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 subsiguientes 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 cambiada debe leerse directamente dentro de un
script.


Instance:GetStyledPropertyChangedSignal

property

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


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


Devuelve un evento que se activa cuando la propiedad de estilo dada cambia en la
instancia.


Este método devuelve un array de las etiquetas aplicadas a la instancia dada, como
cadenas. Puedes agregar 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

Un array de cadenas, cada una representando una etiqueta aplicada a la instancia.


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

La etiqueta a verificar en la instancia.


`true` si la instancia tiene la etiqueta dada, `false` de lo contrario.


Verifica 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.

Un `Class.Instance` se considera el ancestro de un objeto si el
`Class.Instance.Parent` del objeto o uno de los padres de este
`Class.Instance.Parent` 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 a una instancia recién creada a través de
código (`Datatype.Instance.new()`), este método devolverá `false`. Si
se llama a un objeto recién creado por flujos de trabajo de Studio como
la inserción en la ventana de [Explorer](/studio/explorer), el resultado puede
variar.

Por ejemplo, consultar la
propiedad `Class.TextLabel.BackgroundColor3|BackgroundColor3` de un
`Class.TextLabel` insertado a través de la ventana de [Explorer](/studio/explorer)
devolverá `true`, pero consultar la misma propiedad de un `Class.TextLabel`
creado a través de `Datatype.Instance.new()` devolverá `false`, asumiendo que no
se realizaron 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 el usuario. Los valores de retorno para propiedades pobladas por el sistema de
instancias como `Class.PackageLink` son un comportamiento indefinido.

También ten en cuenta que si este método devuelve `true`, el estilo **no** afectará
la propiedad porque modificar explícitamente una propiedad tiene prioridad sobre
estilizarla. Para restablecer una propiedad a su valor predeterminado instanciado por código y permitir
el estilo en ella, usa
`Class.Instance:ResetPropertyToDefault()|ResetPropertyToDefault()`.


Instance:IsPropertyModified

Booleano que indica si la propiedad ha sido modificada desde su
valor predeterminado instanciado 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 el string `selector` proporcionado. `selector` puede incluir
múltiples selectores y combinadores para coincidir con características como el
nombre de clase, nombre de instancia y relaciones jerárquicas, 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 algunas
variaciones 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 una etiqueta 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 que esa propiedad tiene el valor especificado. Se admiten valores booleanos, numéricos y
  de cadena. Letras, números, `_`, y `-` se pueden usar sin poner el valor entre comillas.
- `[$attribute]` — Coincide con instancias que tienen el atributo especificado
  [atributo](/studio/properties#instance-attributes) establecido.
- `[$attribute = value]` — Coincide con instancias que tienen el atributo especificado **y**
  que ese atributo tiene el valor especificado. Se aplican las mismas limitaciones que para los selectores de propiedades. Si deseas comprobar la ausencia de un atributo, no lo consultes como `nil`; en su lugar, usa 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 falso
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 jerárquicas más profundas.

- `>` — Coincide con instancias que son **hijos directos** de los filtros anteriores.

- `>>` — Coincide con instancias que son **descendientes** de los filtros anteriores. Este es el primer filtro predeterminado, 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 sean una Parte y estén etiquetados como "Apple"
print(Workspace:QueryDescendants("> Part.Apple"))

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

-- Obtener descendientes de MeshPart etiquetados como "SwordPart" O con un atributo "OnFire" establecido en verdadero
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 en función de
  qué instancias contienen dentro. La lista de selectores se evalúa
  en relación con 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 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

String 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 el
string `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
punto posterior.


Instance:Remove

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


Instance:remove

Este método elimina una etiqueta de una instancia. No lanzará un error si
el objeto no tiene la etiqueta. Eliminar una etiqueta con éxito activará una
señal creada por `Class.CollectionService:GetInstanceRemovedSignal()`
con la etiqueta dada.

Ten en cuenta que al etiquetar una instancia, es común que se utilicen algunos recursos para
darle funcionalidad a la etiqueta, 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 se necesiten para una etiqueta.


Instance:RemoveTag

Restablece una propiedad a su valor predeterminado. Por ejemplo, llamar a
`ResetPropertyToDefault("Rotation")` en un `Class.TextLabel` es equivalente
a establecer su `Class.TextLabel.Rotation|Rotation` en `0` (el valor predeterminado de la propiedad). Este método se puede usar para asegurar que el estilo anule
el valor predeterminado de esta propiedad.


Instance:ResetPropertyToDefault

Restablece una propiedad a su valor predeterminado.


Este método establece el atributo con el nombre dado al valor dado. Si
el valor dado es `nil`, el atributo será eliminado, ya que `nil` es
devuelto por defecto.

Por ejemplo, el siguiente fragmento de código establece el atributo
`InitialPosition` de la instancia a `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))
```

#### Limitaciones

Requisitos y restricciones de nombres:

- Los nombres solo deben usar caracteres alfanuméricos.
  - También puedes incluir puntos, guiones, barras y guiones bajos.
- No se permiten espacios ni símbolos únicos (como @, ~, !).
- Las cadenas deben tener 100 caracteres o menos.
- No se permite que los nombres comiencen con **RBX** a menos que el llamador sea un
  script central de Roblox (reservado para Roblox).

Al intentar establecer un atributo a un tipo no soportado, se lanzará un error.

#### Véase También

- `Class.Instance:GetAttribute()` que devuelve el valor que ha sido
  asignado al nombre de atributo dado.
- `Class.Instance:GetAttributes()` que devuelve un diccionario de pares clave-valor
  para cada uno de los atributos de la instancia.


Instance:SetAttribute

El nombre del atributo que se está estableciendo.


value

El valor para establecer el atributo especificado.


Establece el atributo con el nombre dado al valor dado.


Instance

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


/reference/engine/classes/WrapTextureTransfer.yaml

Resumen