UIScene

UIScene

ScreenUI ์™€ SurfaceUI ์˜ ๋ถ€๋ชจ ๊ฐ์ฒด์ž…๋‹ˆ๋‹ค.

์ด๋ฒคํŠธ

OnVisibleEvent

UI๊ฐ€ ๋ณด์—ฌ์งˆ ๋•Œ ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function(UIScene), UIScene ๋Š” ๋ณด์—ฌ์ง€๋Š” UIScene ๊ฐ์ฒด ์ž…๋‹ˆ๋‹ค.

-- ์ƒ˜ํ”Œ --

local someUI = Workspace.ScreenUI

local function VisibleEvent(self)
    print(self.Name, " Visible!")
end
someUI.OnVisibleEvent:Connect(VisibleEvent)

someUI.Visible = true

OnUpdateEvent

UI๊ฐ€ ๋ณด์—ฌ์ง€๋Š” ๋™์•ˆ ๋งค ํ”„๋ ˆ์ž„๋งˆ๋‹ค ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function(UIScene, updateTime), UIScene ์€ ๋งค ํ”„๋ ˆ์ž„๋งˆ๋‹ค ํ˜ธ์ถœ๋˜๋Š” UIScene ๊ฐ์ฒด , updateTime ์€ number ์ž…๋‹ˆ๋‹ค.

-- ์ƒ˜ํ”Œ --

local someUI = Workspace.ScreenUI

local function UpdateEvent(self)
    print(self.Name, " Update!")
end
someUI.OnUpdateEvent:Connect(UpdateEvent)

OnInVisibleEvent

UI๊ฐ€ ์•ˆ ๋ณด์—ฌ์งˆ ๋•Œ ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function(UIScene), UIScene ๋Š” ์•ˆ ๋ณด์—ฌ์ง€๋Š” ์€ UIScene ๊ฐ์ฒด ์ž…๋‹ˆ๋‹ค.

-- ์ƒ˜ํ”Œ --

local someUI = Workspace.ScreenUI

local function InVisibleEvent(self)
    print(self.Name, " InVisible!")
end
someUI.OnInVisibleEvent:Connect(InVisibleEvent)

someUI.Visible = false

ํ•จ์ˆ˜

void AddChildUIScene(string ChildUISceneName, UIScene ObjectUIScene)

(deprecate) AddChildUIWidget ํ•จ์ˆ˜๋กœ ์ด์šฉํ•˜์„ธ์š”.

void AddChildWidget(UIWidget ObjectWidget)

์ž์‹ UI ์œ„์ ฏ์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (์ž์‹์œผ๋กœ ์ถ”๊ฐ€ํ•  UI ์œ„์ ฏ)

-- ์ƒ˜ํ”Œ --

local ScreenUI = Workspace.ScreenUI

ScreenUI.Image:AddChildUIWidget(Button)

void AddUIMove(string WidgetName, string TrackName, Vector Pos, number Time)

ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ์ด๋™ ๋ณ€ํ™”๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (์ด๋™ ๋ณ€ํ™”๋ฅผ ์ค„ ์œ„์ ฏ ์ด๋ฆ„, ํŠธ๋ž™ ์ด๋ฆ„, ์ด๋™ Vector, ๋ณ€ํ™” ์™„๋ฃŒ๊นŒ์ง€์˜ ์‹œ๊ฐ„)

void AddUIRot(string WidgetName, string TrackName, float Rot, number Time)

ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ํšŒ์ „ ๋ณ€ํ™”๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (ํšŒ์ „ ๋ณ€ํ™”๋ฅผ ์ค„ ์œ„์ ฏ ์ด๋ฆ„, ํŠธ๋ž™ ์ด๋ฆ„, ํšŒ์ „ float, ๋ณ€ํ™” ์™„๋ฃŒ๊นŒ์ง€์˜ ์‹œ๊ฐ„)

void AddUIScale(string WidgetName, string TrackName, float scale, number Time)

(deprecated)ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ํฌ๊ธฐ ๋ณ€ํ™”๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (์Šค์ผ€์ผ ๋ณ€ํ™”๋ฅผ ์ค„ ์œ„์ ฏ ์ด๋ฆ„, ํŠธ๋ž™ ์ด๋ฆ„, ์Šค์ผ€์ผ float, ๋ณ€ํ™” ์™„๋ฃŒ๊นŒ์ง€์˜ ์‹œ๊ฐ„)

void AddUISize(string WidgetName, string TrackName, Vector Size, number Time)

ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ํฌ๊ธฐ ๋ณ€ํ™”๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (ํฌ๊ธฐ ๋ณ€ํ™”๋ฅผ ์ค„ ์œ„์ ฏ ์ด๋ฆ„, ํŠธ๋ž™ ์ด๋ฆ„, ํฌ๊ธฐ Vector, ๋ณ€ํ™” ์™„๋ฃŒ๊นŒ์ง€์˜ ์‹œ๊ฐ„)

void AddUIOpacity(string WidgetName, string TrackName, float float, number Time)

ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ํˆฌ๋ช…๋„ ๋ณ€ํ™”๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (ํˆฌ๋ช…๋„ ๋ณ€ํ™”๋ฅผ ์ค„ ์œ„์ ฏ ์ด๋ฆ„, ํŠธ๋ž™ ์ด๋ฆ„, ํˆฌ๋ช…๋„ ๊ฐ’, ๋ณ€ํ™” ์™„๋ฃŒ๊นŒ์ง€์˜ ์‹œ๊ฐ„)

void AddUIEmpty(stirng WidgetName, string TrackName, number Time)

ํ•ด๋‹น Scene์•ˆ์— ์žˆ๋Š” WidgetName์˜ ์ด๋ฆ„์„ ๊ฐ€์ง„ ์œ„์ ฏ์˜ ๋ณ€ํ™˜ ๋Œ€๊ธฐ ์‹œ๊ฐ„์„ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์–ด์š”. (ํŠธ๋ž™ ์ด๋ฆ„, ๋ณ€ํ™˜ ๋Œ€๊ธฐ ์‹œ๊ฐ„)

void PlayUIActionTrack(string TrackName, TransformPlayType Type, number PlayCount)

์„ค์ •๋œ ๋ณ€ํ™˜ ์ปจํŠธ๋กค๋Ÿฌ ์‹คํ–‰ํ•ด์š”. (ํŠธ๋ž™ ์ด๋ฆ„, Enum.TransformPlayType.ํƒ€์ž… , ์‹คํ–‰ ํšŸ์ˆ˜)

void StopUIActionTrack(string TrackName)

๋ณ€ํ™˜ ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ์ •์ง€์‹œ์ผœ์š”. (์ •์ง€ ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

void PauseUIActionTrack(string TrackName)

๋ณ€ํ™˜ ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ์ผ์‹œ ์ •์ง€์‹œ์ผœ์š”. (์ผ์‹œ ์ •์ง€ ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

void ResumeUIActionTrack(string TrackName)

๋ณ€ํ™˜ ์ปจํŠธ๋กค๋Ÿฌ๋ฅผ ๋‹ค์‹œ ํ”Œ๋ ˆ์ดํ•ด์š”. (๋‹ค์‹œ ํ”Œ๋ ˆ์ด ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

bool IsPlayingUIActionTrack(string TrackName)

ํ•ด๋‹น TransformTrack์ด ํ”Œ๋ ˆ์ด ์ค‘์ธ์ง€ ํ™•์ธํ•  ์ˆ˜ ์žˆ์–ด์š”. (ํ™•์ธ ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

void ResetUIActionTrack(string TrackName)

ํ•ด๋‹น TransformTrack๋ฅผ ์ ์šฉ๋˜๊ธฐ ์ „์˜ Transform์œผ๋กœ ๋ฆฌ์…‹์‹œ์ผœ์š”. (๋ฆฌ์…‹ ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

void RemoveUIActionTrack(String TrackName)

ํ•ด๋‹น Track์„ ์ œ๊ฑฐํ•ด์š”. (์ œ๊ฑฐ ํ•  ํŠธ๋ž™ ์ด๋ฆ„)

WidgetList FindWidgets(WidgetType Type)

ํ•˜์œ„์˜ ์˜ค๋ธŒ์ ํŠธ๋“ค ์ค‘ WidgetType ์— ํ•ด๋‹นํ•˜๋Š” ์œ„์ ฏ ๋ฆฌ์ŠคํŠธ๋ฅผ ์–ป์„ ์ˆ˜ ์žˆ์–ด์š”.

-- ์ƒ˜ํ”Œ --

local widgetList = Workspace.ScreenUI(Enum.UIWidgetType.Image)

for i = 1, #widgetList do --๋ฆฌ์ŠคํŠธ์•ž์— #์„ ๋ถ™์—ฌ ๋ฆฌ์ŠคํŠธ์˜ ๊ธธ์ด๋ฅผ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ์–ด์š”.
    print(widgetList[i].Name)
end

์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ๋ถ€๋ชจ ์˜ค๋ธŒ์ ํŠธ ๊ธฐ๋Šฅ๋“ค

์†์„ฑ

์ด๋ฆ„

์„ค๋ช…

๊ฐ์ฒด ํ™œ์„ฑํ™” ์—ฌ๋ถ€

๊ฐ์ฒด์˜ Matrix

๊ฐ์ฒด์˜ Local Transform

๊ฐ์ฒด์˜ ์œ„์น˜ Vector

๊ฐ์ฒด์˜ ๋กœ์ปฌ์ขŒํ‘œ Vector

๊ฐ์ฒด์˜ ํšŒ์ „ Vector

๊ฐ์ฒด์˜ ๋กœ์ปฌ ํšŒ์ „ Vector

๊ฐ์ฒด์˜ ํฌ๊ธฐ Vector

๊ฐ์ฒด์˜ ๊ฐ€์‹œ์„ฑ

์ด๋ฒคํŠธ

์ด๋ฆ„

์„ค๋ช…

์ƒ์„ฑ ํ›„ ๋งค ํ”„๋ ˆ์ž„๋งˆ๋‹ค ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function(updateTime), updateTime ์€ number ์ž…๋‹ˆ๋‹ค.

์‚ญ์ œ๋  ๋•Œ ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function() ์ž…๋‹ˆ๋‹ค.

Enable ๋ ๋•Œ ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function() ์ž…๋‹ˆ๋‹ค.

Disable ๋ ๋•Œ ํ˜ธ์ถœ๋˜๋Š” ์ด๋ฒคํŠธ์—์š”. ์—ฐ๊ฒฐํ•จ์ˆ˜ ํ˜•์‹์€ function() ์ž…๋‹ˆ๋‹ค.

ํ•จ์ˆ˜

์ด๋ฆ„

์„ค๋ช…

๊ฐ์ฒด์˜ ํ‚ค ๊ฐ’์„ ์–ป์„ ์ˆ˜ ์žˆ์–ด์š”.

ํ˜„์žฌ ๋งคํŠธ๋ฆญ์Šค์—์„œ ์„ค์ • ๋œ ๋งคํŠธ๋ฆญ์Šค๋กœ ๋ณด๊ฐ„์ด ๋˜๋Š” ๋งคํŠธ๋ฆญ์Šค๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š” ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š”. (Matrix ๊ฐ’, bool ์ถฉ๋Œ ์ฒ˜๋ฆฌ ์—ฌ๋ถ€)

ํ˜„์žฌ ๋งคํŠธ๋ฆญ์Šค์—์„œ ์„ค์ • ๋œ ๋งคํŠธ๋ฆญ์Šค๋กœ ๋ณด๊ฐ„์ด ๋˜๋Š” ๋งคํŠธ๋ฆญ์Šค๋ฅผ ๋กœ์ปฌ์ขŒํ‘œ๊ธฐ์ค€์œผ๋กœ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š” ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š”. (Matrix ๊ฐ’, bool ์ถฉ๋Œ ์ฒ˜๋ฆฌ ์—ฌ๋ถ€)

์ˆœ๊ฐ„์ด๋™ ํ•˜๋Š” ๋งคํŠธ๋ฆญ์Šค๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š”. (Matrix ๊ฐ’)

๊ฐ์ฒด์˜ ์œ„์น˜๋ฅผ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์–ด์š”. (์„ค์ •ํ•  ์œ„์น˜ Vector ๊ฐ’, ์ถฉ๋Œ ์ฒ˜๋ฆฌ ์—ฌ๋ถ€)

๊ฐ์ฒด์˜ tag๋ฅผ ์„ค์ •ํ•ด์š”. (์„ค์ •ํ•  tag)

๊ฐ์ฒด์— ์„ค์ •๋œ tag๋ฅผ ์–ป์„ ์ˆ˜ ์žˆ์–ด์š”.

์œ ์ €๊ฐ€ ์ถ”๊ฐ€ํ•œ ์˜ค๋ธŒ์ ํŠธ ์ปค์Šคํ…€ ์ด๋ฒคํŠธ์— ํ•จ์ˆ˜๋ฅผ ์—ฐ๊ฒฐํ•  ์ˆ˜ ์žˆ์–ด์š”. (์ด๋ฒคํŠธ ์ด๋ฆ„, ์—ฐ๊ฒฐ ํ•จ์ˆ˜)

์˜ค๋ธŒ์ ํŠธ๊ฐ€ ํ•ด๋‹นํ•˜๋Š” ์œ„์น˜๋ฅผ ๋ฐ”๋ผ๋ณด๊ฒŒ ํ•  ์ˆ˜ ์žˆ์–ด์š”. (๋ฐ”๋ผ๋ณผ ์œ„์น˜ Vector)

Last updated

Was this helpful?