Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

DirectionalLight2D

Hérite de : Light2D < Node2D < CanvasItem < Node < Object

Une lumière directionnelle à une certaine distance.

Description

Une lumière directionnelle est un type de nœud Light2D qui modélise un nombre infini de rayons parallèles couvrant toute la scène. Elle est utilisée pour les lumières à forte intensité qui sont situées loin de la scène (par exemple : pour modéliser la lumière du soleil ou le clair de lune).

La lumière est émise dans la direction +Y de la base globale du nœud. Pour une lumière non-pivotée, cela signifie que la lumière est émise vers le bas. La position du nœud est ignorée, seule la base est utilisée pour déterminer la direction de la lumière.

Note : DirectionalLight2D ne supporte pas les masques de light cull (mais il supporte les masques de shadow cull). Elle va toujours éclairer les nœuds 2D, peu importe le CanvasItem.light_mask du nœud 2D.

Tutoriels

Propriétés

float

height

0.0

float

max_distance

10000.0

Descriptions des propriétés

float height = 0.0 🔗

  • void set_height(value: float)

  • float get_height()

La hauteur de la lumière. Utilisé avec les normal maps 2D. Va de 0 (parallèle au plan) à 1 (perpendiculaire au plan).

float max_distance = 10000.0 🔗

  • void set_max_distance(value: float)

  • float get_max_distance()

La distance maximale au centre de la caméra à laquelle des objets peuvent être peut être avant que leurs ombres soient culled (coupées) (en pixels). Diminuer cette valeur peut empêcher les objets situés à l'extérieur de la caméra de projeter des ombres (tout en améliorant également les performances). Camera2D.zoom n'est pas pris en compte par max_distance, ce qui signifie que, à des valeurs de zoom plus élevées, des ombres semblent disparaître plus tôt lorsque vous zoomez sur un point donné.