---
title: "Astra.CurvePath"
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-curvepath/
---

# Astra.CurvePath

A scene-owned Curve3D. Point identity survives reorder and value edits.

**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.CurvePath
```

A scene-owned Curve3D. Point identity survives reorder and value edits.

## Onde acessar este tipo

Adicione **Path** e autorie pontos. Adicione **Path Follow** ao consumidor e atribua a fonte. A API especializada devolve amostras/frames do caminho.

## Roadmap e uso

[Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/): 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-3acda61e78bca856) | Method |
| [At](#member-9316dbe348b508fd) | Method |
| [ById](#member-1a2cca6e58c07361) | Method |
| [Insert](#member-a65aaadd822090d9) | Method |
| [Move](#member-72aa88180e25b698) | Method |
| [Remove](#member-79c4c959359398a8) | Method |
| [Sample](#member-b70d7e2b704f79ef) | Method |
| [SampleFrame](#member-510dfd5a8f17b956) | Method |
| [Set](#member-8976f0a678d40a03) | Method |
| [Set](#member-bb99c20257ef076c) | Method |
| [Closed](#member-3e3e21a2a3305905) | Property |
| [Count](#member-acc065869deca0f0) | Property |
| [Up](#member-4dee55663812d8b2) | Property |

<h3 id="member-3acda61e78bca856" class="astra-member">.ctor</h3>

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

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

<h3 id="member-9316dbe348b508fd" class="astra-member">At</h3>

```csharp
public Astra.CurvePoint3D At(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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

<h3 id="member-1a2cca6e58c07361" class="astra-member">ById</h3>

```csharp
public Astra.CurvePoint3D ById(ulong id)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |

<h3 id="member-a65aaadd822090d9" class="astra-member">Insert</h3>

```csharp
public ulong Insert(int index, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming = default(System.Numerics.Vector3), System.Numerics.Vector3 outgoing = default(System.Numerics.Vector3), float rollDegrees = 0)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `index` | `int` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  · Opcional: `` |
| `outgoing` | `System.Numerics.Vector3` |  · Opcional: `` |
| `rollDegrees` | `float` |  · Opcional: `0` |

<h3 id="member-72aa88180e25b698" class="astra-member">Move</h3>

```csharp
public void Move(ulong id, int destinationIndex)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `destinationIndex` | `int` |  |

<h3 id="member-79c4c959359398a8" class="astra-member">Remove</h3>

```csharp
public void Remove(ulong id)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |

<h3 id="member-b70d7e2b704f79ef" class="astra-member">Sample</h3>

```csharp
public Astra.PathSample Sample(double worldDistance, bool wrap = false)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldDistance` | `double` |  |
| `wrap` | `bool` |  · Opcional: `False` |

<h3 id="member-510dfd5a8f17b956" class="astra-member">SampleFrame</h3>

```csharp
public Astra.PathFrame SampleFrame(double worldDistance, bool wrap = false)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `worldDistance` | `double` |  |
| `wrap` | `bool` |  · Opcional: `False` |

<h3 id="member-8976f0a678d40a03" class="astra-member">Set</h3>

```csharp
public void Set(ulong id, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming, System.Numerics.Vector3 outgoing)
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  |
| `outgoing` | `System.Numerics.Vector3` |  |

<h3 id="member-bb99c20257ef076c" class="astra-member">Set</h3>

```csharp
public void Set(ulong id, System.Numerics.Vector3 position, System.Numerics.Vector3 incoming, System.Numerics.Vector3 outgoing, float rollDegrees)
```

Atomically edits geometry and roll; the overload without roll preserves it.

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

**Uso:** Atomically edits geometry and roll; the overload without roll preserves it.

**Roadmap deste membro:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `id` | `ulong` |  |
| `position` | `System.Numerics.Vector3` |  |
| `incoming` | `System.Numerics.Vector3` |  |
| `outgoing` | `System.Numerics.Vector3` |  |
| `rollDegrees` | `float` |  |

<h3 id="member-3e3e21a2a3305905" class="astra-member">Closed</h3>

```csharp
public bool Closed { get; set; }
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-acc065869deca0f0" class="astra-member">Count</h3>

```csharp
public int Count { 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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4dee55663812d8b2" class="astra-member">Up</h3>

```csharp
public System.Numerics.Vector3 Up { get; set; }
```

**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:** [Caminhos e seguidores](/pt-br/snapshot-2026-10-06/roadmap/caminhos/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.