Beam

La Attachment d'où la poutre provient.Cette pièce jointe est le premier point de contrôle sur la courbe Bézier cubique du faisceau ; son orientation, aux côtés de la propriété CurveSize0, détermine la position du deuxième point de contrôle.Voir poutres pour plus de détails.

Pour le Attachment où la poutre se termine, voir Attachment1 .

Le Attachment à partir duquel la poutre se termine.Cette pièce jointe est le quatrième et dernier point de contrôle sur la courbe Bézier cubique du faisceau ; son orientation, aux côtés de la propriété CurveSize1, détermine la position du troisième point de contrôle.Voir poutres pour plus de détails.

Pour le Attachment où la poutre provient, voir Attachment0 .

Échelle la lumière émise par le faisceau lorsque LightInfluence est inférieure à 1.Cette propriété est 1 par défaut et peut être définie à n'importe quel nombre se situant dans la plage de 0 à 10 000.L'augmentation de la valeur de LightInfluence diminue l'effet de la valeur de cette propriété.

Détermine la couleur du rayon à travers ses Segments .Si Texture est configurer, cette couleur sera appliquée à la texture du rayon.Si aucun Texture n'est configurer, le Beam apparaîtra comme une ligne solide colorée selon cette propriété.

Cette propriété est un ColorSequence , ce qui permet de configurer la couleur pour qu'elle varie le long de la longueur du rayon.Considérez la suivante ColorSequence qui, lorsqu'appliquée à un rayon, donnerait le resultatspeint.

local colorSequence = ColorSequence.new({
		ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)), -- Rouge
		ColorSequenceKeypoint.new(0.5, Color3.fromRGB(0, 188, 203)), -- Bleu vert
		ColorSequenceKeypoint.new(1, Color3.fromRGB(196, 0, 255)), -- Violet
	}
)

Remarquez que la coloration du rayon dépend également du nombre de Segments que le Beam a.Chaque segment du faisceau ne peut montrer qu'une transition entre deux couleurs.Il sera donc nécessaire qu'un Beam ait au moins n-1 segments pour que la couleur s'affiche correctement, où n est le nombre de ColorSequenceKeypoints dans le ColorSequence .

Détermine, avec Attachment0, la position du deuxième point de contrôle dans la courbe Bézier du faisceau. Voir Rayons pour plus de détails.

La position de ce point peut être déterminée par l'équation suivante :

local controlPoint2 = Beam.Attachment0.WorldPosition + (Beam.Attachment0.CFrame.RightVector * Beam.CurveSize0)

Détermine, avec Attachment1, la position du troisième point de contrôle dans la courbe Bézier du faisceau. Voir Rayons pour plus de détails.

La position de ce point peut être déterminée par l'équation suivante :

local controlPoint3 = Beam.Attachment1.WorldPosition - (Beam.Attachment1.CFrame.RightVector * Beam.CurveSize1)

Détermine si le rayon est visible ou non.

Lorsque cette propriété est définie sur false, le Segments de la poutre ne sera pas affiché.

Un Beam est une projection 2D existante dans l'espace 3D, ce qui signifie qu'elle peut ne pas être visible de tous les angles.La propriété Caméra de visage , lorsqu'elle est définie sur true, garantit que le rayon toujours face à la CurrentCamera, quelle que soit son orientation.

Détermine dans quelle mesure les couleurs du rayon sont mélangées aux couleurs derrière lui.Il devrait être défini dans la plage de 0 à 1.Une valeur de 0 utilise les modes de mélange normaux et une valeur de 1 utilise le mélange additif.

Cette propriété ne doit pas être confondue avec LightInfluence qui détermine comment le rayon est affecté par la lumière environnementale.

Cette propriété ne fait pas pas que la poutre éclaire l'environnement.

Détermine le degré dans lequel le rayon est influencé par l'éclairage de l'environnement, comprise entre 0 et 1.Lorsque 0, le rayon sera insensible à l'éclairage de l'environnement.Lorsque 1, il sera entièrement affecté par l'éclairage comme un BasePart le serait.

Voir aussi LightEmission qui spécifie dans quelle mesure les couleurs du faisceau sont mélangées avec les couleurs derrière lui.

Plutôt que d'être une courbe parfaite, un rayon est composé de segments droits.Plus il y a de segments, plus la résolution de la courbe est élevée.La propriété segments définit le nombre de segments droits dont la poutre est composée, avec une valeur par défaut de 10.

Notez que les propriétés Color et Transparency nécessitent un certain nombre de segments pour s'afficher correctement.C'est parce que chaque segment ne peut montrer qu'une transition entre deux couleurs ou transparences.Il est donc nécessaire qu'un Beam requiert au moins n-1 segments pour s'afficher correctement, où n est le nombre de point clé associé au rayon de Color et Transparency .

L'ID du contenu de la texture à afficher sur le faisceau.Si cette propriété n'est pas configurer, le rayon sera affiché comme une ligne solide ; cela se produit également lorsque la texture est définie sur un ID de contenu non valide ou que l'image associée à la texture n'a pas encore été chargée.

L'apparence de la texture peut être modifiée par d'autres propriétés de rayon, y compris Color et Transparency.

L'ajustement de la texture est déterminé par les propriétés TextureMode, TextureLength, Width0 et Width1.

Définit la longueur de la texture du rayon, dépendant de TextureMode.

Cette propriété, aux côtés de TextureLength, détermine comment une poutre se répète Texture.

Lorsqu'elle est réglée sur Enum.TextureMode.Wrap ou Enum.TextureMode.Static, les répétitions de texture correspondront à la longueur globale du rayon (en studs) divisée par son TextureLength.

Lorsqu'elle est réglée sur Enum.TextureMode.Stretch, la texture se répétera TextureLength fois sur la longueur globale du rayon.

Détermine la vitesse à laquelle l'image Texture se déplace le long du rayon.Lorsque cette propriété est une valeur positive, la texture du rayon se déplacera de Attachment0 à Attachment1 .Cette direction peut être inversée en définissant cette propriété sur un nombre négatif.

Détermine la transparence du rayon à travers ses segments.Cette propriété est un NumberSequence , ce qui permet de configurer la transparence pour varier au fil de la longueur du rayon.

Considérez la suivante NumberSequence qui, lorsqu'appliquée à un rayon, donnerait le resultatspeint.

local numberSequence = NumberSequence.new({
		NumberSequenceKeypoint.new(0, 0), -- Opaque
		NumberSequenceKeypoint.new(0.5, 1), -- Transparent
		NumberSequenceKeypoint.new(1, 0), -- Opaque
	}
)

Notez que la transparence du rayon dépend également du nombre de Segments.Chaque segment du faisceau ne peut montrer qu'une transition entre deux transparences.Il est donc nécessaire qu'un rayon ait au moins n-1 segments pour s'afficher correctement, où n est le nombre de NumberSequenceKeypoints dans le NumberSequence .

La largeur du rayon à son origine ( Attachment0 ), en studs. La largeur du rayon changera linéairement en Width1 studs à sa fin ( Attachment1 ).

La largeur du rayon à sa fin ( Attachment1 ), en studs. La largeur du rayon changera linéairement de Width0 studs à son origine ( Attachment0 ).

La distance, en studs, l'affichage du rayon est décalé par rapport au CurrentCamera .Lorsque 0, le rayon sera affiché dans sa position standard entre Attachment0 et Attachment1 . ZOffset peut être positif ou négatif.

Cette propriété est particulièrement utile pour éviter le « combat Z » lors de l'utilisation de plusieurs Beams entre le même Attachments.

-- Create beams
local beam1 = Instance.new("Beam")
beam1.Color = ColorSequence.new(Color3.new(1, 0, 0))
beam1.FaceCamera = true
beam1.Width0 = 3
beam1.Width1 = 3
local beam2 = Instance.new("Beam")
beam2.Color = ColorSequence.new(Color3.new(0, 1, 0))
beam2.FaceCamera = true
beam2.Width0 = 2
beam2.Width1 = 2
local beam3 = Instance.new("Beam")
beam3.Color = ColorSequence.new(Color3.new(0, 0, 1))
beam3.FaceCamera = true
beam3.Width0 = 1
beam3.Width1 = 1

-- Layer beams
beam1.ZOffset = 0
beam2.ZOffset = 0.01
beam3.ZOffset = 0.02

-- Create attachments
local attachment0 = Instance.new("Attachment")
attachment0.Position = Vector3.new(0, -10, 0)
attachment0.Parent = workspace.Terrain
local attachment1 = Instance.new("Attachment")
attachment1.Position = Vector3.new(0, 10, 0)
attachment1.Parent = workspace.Terrain

-- Connect beams
beam1.Attachment0 = attachment0
beam1.Attachment1 = attachment1
beam2.Attachment0 = attachment0
beam2.Attachment1 = attachment1
beam3.Attachment0 = attachment0
beam3.Attachment1 = attachment1

-- Parent beams
beam1.Parent = workspace
beam2.Parent = workspace
beam3.Parent = workspace

L'écart de la texture d'un cycle de rayon représente la progression de son animationsde texture.Cette méthode défini l'écart actuel du cycle de la texture du rayon ; donc, elle peut être utilisée pour réinitialiser le cycle en passant 0 comme paramètre offset.

Notations

• Le paramètre donné offset est attendu pour être une valeur entre 0 et 1, mais des valeurs plus élevées peuvent être utilisées.
• Le cycle de la texture se termine à 0 et 1, ce qui signifie que la texture est à la même position lorsque le décalage est à 0 ou 1.
• Si la propriété Texture n'est pas configurer, cette méthode ne fait rien.
• L'augmentation de la décalage agira dans le sens inverse de la propriété TextureSpeed, ce qui signifie qu'il déplacera la texture dans la direction opposée à celle dans laquelle la texture s'anime lorsque TextureSpeed est supérieure à 0.

Paramètres

Retours