GBX.lua.BillboardGui (Object)

Up one category: Class reference

A BillboardGui is a GUI object that can 'stick to' part objects in what appears to be 3D space. It always faces the camera, and appears to get smaller as the camera gets farther away from it. Unlike the text that appears above models with Humanoids' heads, this does not disappear or resize. Also, unlike BubbleChat, this object does not give big text to its descendants.

Example:

local players = game:GetService("Players")
local player = players.LocalPlayer
local character = player.Character

local bg = Instance.new("BillboardGui")
bg.Parent = player.PlayerGui
bg.Adornee = character.Head
-- Same size as Head
bg.Size = UDim2.new( 1.0, 0, 1.0, 0 )
-- Above (defaults to inside)
bg.StudsOffset = Vector3.new( 0, 2, 0 )

local frame = Instance.new("Frame")
frame.Parent = bg
frame.Size = UDim2.new(1.0, 0, 1.0, 0 )
frame.BackgroundTransparency = 0.7
frame.BackgroundColor3 = Color3.new( 1,1,1 )

local text = Instance.new("TextLabel")
text.Parent = frame
text.Position = UDim2.new( 0.25, 0, 0.25, 0 )
text.Size = UDim2.new(0.5, 0, 0.5, 0 )
text.Text = "Hello"

Known Issues:

When using this object with ImageLabel, it is known to flicker between your face decal, and the texture.

GUI events like MouseButton1Click do not fire for child objects.

Functions

The BillboardGui only incorporates global functions.

Properties

In addition to the global properties, the BillboardGui object also has these:

• AbsolutePosition
• AbsoluteSize
• Adornee
• ExtentsOffset
• Size
• SizeOffset
• StudsOffset

Events

The BillboardGui only incorporates global events.