Astra.Components.TimeOfDay
Hora do dia: Move o sol pela hora, data e latitude; dia, crepúsculo e noite. Família Luz · Luzes.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.TimeOfDayHora do dia: Move o sol pela hora, data e latitude; dia, crepúsculo e noite. Família Luz · Luzes.
Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_directionallight3d.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.TimeOfDay>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Luz / Luzes → Hora do dia.
No Behavior em Play, obtenha a fachada com Object.GetComponent<TimeOfDay>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new TimeOfDay(component) envolve um componente existente; não adiciona um componente à cena.
Roadmap e uso
Seção intitulada “Roadmap e uso”Renderização e materiais: 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.
Consulte também Hora do dia para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| DayChanged | Method |
| HourChanged | Method |
| OnDayChanged | Method |
| OnHourChanged | Method |
| OnSunrise | Method |
| OnSunset | Method |
| Remove | Method |
| Sunrise | Method |
| Sunset | Method |
| Wrap | Method |
| Component | Property |
| Current | Property |
| DayLengthMinutes | Property |
| DayOfYear | Property |
| Enabled | Property |
| Hour | Property |
| InstanceId | Property |
| IsAlive | Property |
| Latitude | Property |
| MoonLight | Property |
| NorthDegrees | Property |
| Object | Property |
| Speed | Property |
| TypeId | Property |
.ctor
public TimeOfDay(Astra.Component component)Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
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: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
DayChanged
public Astra.ComponentSubscription DayChanged(Astra.Behavior owner, System.Action<int> handler)Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
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: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<int> |
HourChanged
public Astra.ComponentSubscription HourChanged(Astra.Behavior owner, System.Action<int> handler)Hora inteira nova (0..23), como o evento HourChanged do plano.
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Hora inteira nova (0..23), como o evento HourChanged do plano.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<int> |
OnDayChanged
public Astra.ComponentSubscription OnDayChanged(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Dia mudou. A hora passou de 24 h; o Dia do ano avança um. Payload: Dia do ano: inteiro
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Dia mudou. A hora passou de 24 h; o Dia do ano avança um. Payload: Dia do ano: inteiro
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnHourChanged
public Astra.ComponentSubscription OnHourChanged(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Hora mudou. A hora inteira mudou: passou o tempo ou um script escreveu outra hora. Payload: Hora: inteiro
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Hora mudou. A hora inteira mudou: passou o tempo ou um script escreveu outra hora. Payload: Hora: inteiro
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnSunrise
public Astra.ComponentSubscription OnSunrise(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Nascer do sol. O sol subiu acima do horizonte
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Nascer do sol. O sol subiu acima do horizonte
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
OnSunset
public Astra.ComponentSubscription OnSunset(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Pôr do sol. O sol desceu abaixo do horizonte
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Pôr do sol. O sol desceu abaixo do horizonte
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Sunrise
public Astra.ComponentSubscription Sunrise(Astra.Behavior owner, System.Action handler)Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
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: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action |
Sunset
public Astra.ComponentSubscription Sunset(Astra.Behavior owner, System.Action handler)Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
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: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action |
Wrap
public static Astra.Components.TimeOfDay Wrap(Astra.Component component)Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Envolve um Component existente após conferir TypeId; não cria componente.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
Component
public Astra.Component Component { get; }Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Handle genérico da instância, usado para operações de reflexão e recursos.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Current
public static Astra.Components.TimeOfDay? Current { get; }A primeira Hora do dia ativa do mundo (o “TimeOfDay.Current” do plano G4).
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: A primeira Hora do dia ativa do mundo (o “TimeOfDay.Current” do plano G4).
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
DayLengthMinutes
public float DayLengthMinutes { get; set; }Duração do dia (min). Minutos reais para 24 h de jogo; 0 congela a hora
Faixa válida: 0 a 1440.
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Duração do dia: Minutos reais para 24 h de jogo; 0 congela a hora
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
DayOfYear
public float DayOfYear { get; set; }Dia do ano. Estação e fase da lua; 172 é o solstício de junho
Faixa válida: 1 a 366.
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Dia do ano: Estação e fase da lua; 172 é o solstício de junho
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Enabled
public bool Enabled { get; set; }Ativo
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Ativo: Desligado, o componente para de agir e conserva os dados.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Hour
public float Hour { get; set; }Hora (h). Hora solar local; com Duração do dia, avança em Play
Faixa válida: 0 a 24.
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Hora: Hora solar local; com Duração do dia, avança em Play
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
InstanceId
public ulong InstanceId { get; }Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IsAlive
public bool IsAlive { get; }Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Latitude
public float Latitude { get; set; }Latitude (°). Altura do sol ao meio-dia e duração da noite; negativo no hemisfério sul
Faixa válida: -90 a 90.
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Latitude: Altura do sol ao meio-dia e duração da noite; negativo no hemisfério sul
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
MoonLight
public Astra.ObjectReference MoonLight { get; set; }Lua. Luz direcional girada até a lua desta hora; à noite ilumina com a fase e projeta a sombra
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Lua: Luz direcional girada até a lua desta hora; à noite ilumina com a fase e projeta a sombra
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
NorthDegrees
public float NorthDegrees { get; set; }Norte (°). Gira o caminho do sol em torno do eixo vertical
Faixa válida: 0 a 360.
Caminho: Inspector → Hora do dia → Hora do dia; ou fachada C# em um Behavior.
Uso: Norte: Gira o caminho do sol em torno do eixo vertical
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Object
public Astra.GameObject Object { get; }Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Objeto dono deste componente; use para resolver composição.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Speed
public float Speed { get; set; }Quantas horas de jogo passam por hora real: 60 faz 1 min real = 1 h. 0 congela; o mínimo além de 0 é 1 (tempo real), porque a Duração do dia vai até 1440 min.
Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Quantas horas de jogo passam por hora real: 60 faz 1 min real = 1 h. 0 congela; o mínimo além de 0 é 1 (tempo real), porque a Duração do dia vai até 1440 min.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
TypeId
public static string TypeId { get; }Caminho: Inspector → Hora do dia; ou fachada C# em um Behavior.
Uso: Identificador nativo usado em AddComponent/GetComponent.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.