Pular para o conteúdo
AstraDOCS

Astra.RandomStream

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

Namespace: Astra · Assembly: Astra.Scripting · Tipo: Class

class Astra.RandomStream

Deterministic, per-owner random stream. State is explicitly capturable for replay/save. PCG-XSH-RR 32; Godot 4.5 RandomNumberGenerator is the capability reference. Algorithm/version belongs to Astra and is not sequence-compatible with Godot or Unity.

Tipos de valor/utilitários C# usados dentro de Behaviors e campos suportados. Construa o valor ou chame o membro estático conforme a declaração; ele só tem efeito quando um consumidor recebe o resultado.

Objetos, Behaviors e composição: 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.

Membro Categoria
AlgorithmVersion Field
.ctor Method
Capture Method
Gaussian Method
InsideUnitCircle Method
InsideUnitSphere Method
NextUInt Method
OnUnitSphere Method
Range Method
Range Method
Restore Method
Shuffle Method
Value Property

AlgorithmVersion

public const uint AlgorithmVersion = 1

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

Uso: Contrato de dados conforme a declaração; a explicação individual permanece em revisão.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

.ctor

public RandomStream(ulong seed, ulong stream = 0)

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
seed ulong
stream ulong · Opcional: 0

Capture

public Astra.RandomStream.Snapshot Capture()

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Gaussian

public float Gaussian(float mean = 0, float standardDeviation = 1)

Normal distribution using Box-Muller; zero deviation returns the mean.

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

Uso: Normal distribution using Box-Muller; zero deviation returns the mean.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
mean float · Opcional: 0
standardDeviation float · Opcional: 1

InsideUnitCircle

public System.Numerics.Vector2 InsideUnitCircle()

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InsideUnitSphere

public System.Numerics.Vector3 InsideUnitSphere()

Uniform volume distribution, not a uniform radius.

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

Uso: Uniform volume distribution, not a uniform radius.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

NextUInt

public uint NextUInt()

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OnUnitSphere

public System.Numerics.Vector3 OnUnitSphere()

Uniform direction on the unit sphere (no rejection loop).

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

Uso: Uniform direction on the unit sphere (no rejection loop).

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Range

public int Range(int minimumInclusive, int maximumExclusive)

Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

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

Uso: Uniform integer range [minimumInclusive, maximumExclusive), without modulo bias.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
minimumInclusive int
maximumExclusive int

Range

public float Range(float minimumInclusive, float maximumExclusive)

Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

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

Uso: Finite float range [minimumInclusive, maximumExclusive). Equal endpoints return the endpoint.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
minimumInclusive float
maximumExclusive float

Restore

public void Restore(Astra.RandomStream.Snapshot snapshot)

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: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
snapshot Astra.RandomStream.Snapshot

Shuffle

public void Shuffle<T>(System.Span<T> values)

Fisher-Yates shuffle, unbiased bounded indices.

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

Uso: Fisher-Yates shuffle, unbiased bounded indices.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
values System.Span&lt;T&gt;

Value

public float Value { get; }

Uniform [0,1), using 24 random bits exactly representable by float.

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

Uso: Uniform [0,1), using 24 random bits exactly representable by float.

Roadmap deste membro: Objetos, Behaviors e composição. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.