---
title: "Astra.DeformableMesh"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-deformablemesh/
---

# Astra.DeformableMesh

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

**Namespace:** `Astra` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct

:::note[Sobre esta referência]
Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial.
:::

## Declaração

```csharp
readonly struct Astra.DeformableMesh
```

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

## Onde acessar este tipo

Atribua dados de animação/deformação ao componente e obtenha o player/estado pela API do objeto ou componente. AnimationCurve/Keyframe descrevem dados; não tornam uma malha automaticamente deformável.

## Roadmap e uso

[Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-0ae49b86ec2a9ba4) | Method |
| [GetBlendShapeWeight](#member-a8bd0a67151800d8) | Method |
| [SetBlendShapeWeight](#member-a0c56cb7257ae16a) | Method |
| [Component](#member-b3340196f2889030) | Property |

<h3 id="member-0ae49b86ec2a9ba4" class="astra-member">.ctor</h3>

```csharp
public DeformableMesh(Astra.Component component)
```

Malha deformável (`astra.render.skinned_mesh`): os pesos dos blend shapes, na escala da Unity (0 forma base, 100 alvo inteiro), como SkinnedMeshRenderer.Set/GetBlendShapeWeight.

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-a8bd0a67151800d8" class="astra-member">GetBlendShapeWeight</h3>

```csharp
public float GetBlendShapeWeight(int index)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |

<h3 id="member-a0c56cb7257ae16a" class="astra-member">SetBlendShapeWeight</h3>

```csharp
public void SetBlendShapeWeight(int index, float weight)
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `weight` | `float` |  |

<h3 id="member-b3340196f2889030" class="astra-member">Component</h3>

```csharp
public Astra.Component Component { get; }
```

**Caminho:** Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.

**Uso:** Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.

**Roadmap deste membro:** [Animação e deformação](/pt-br/snapshot-2026-10-06/roadmap/animacao/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.