local spr = LoadActor('awesome.png')
spr.InitCommand=function(self)
	self:horizalign('HorizAlign_Left')
end

Def.ActorFrame{
	Name="AF",

	Def.Sprite{ Name="sun", Texture="sun.png" },

	Def.ActorFrame{
		Name="AF2",
		InitCommand=function(self)
			-- bounce() will be applied to AF2, airhorn, and catchphrase
			self:RunCommandsRecursively( function(actor) actor:bounce() end )
		end,

		Def.Sprite{ Name="airhorn", Texture="airhorn.png" },
		Def.BitmapText{ Name="catchphrase", Font="Common Normal", Text="Yo!" }
	}
}

local spr = LoadActor('awesome.png')
spr.InitCommand=function(self)
	self:vertalign('VertAlign_Bottom')
end

Def.ActorFrame{
	Name="AF",
	InitCommand=function(self)
		-- bounce() will be applied to sun and AF2
		self:RunCommandsOnChildren( function(child) child:bounce() end )
	end,

	Def.Sprite{ Name="sun", Texture="sun.png" },

	Def.ActorFrame{
		Name="AF2",
		Def.Sprite{ Name="airhorn", Texture="airhorn.png" },
		Def.BitmapText{ Name="catchphrase", Font="Common Normal", Text="Yo!" }
	}
}

Def.ActorFrame{
	Name="AF",
	InitCommand=function(self)
		-- bounce() will be applied to sun, airhorn, and catchphrase
		self:runcommandsonleaves( function(leaf) leaf:bounce() end )
	end,

	Def.Sprite{ Name="sun", Texture="sun.png" },

	Def.ActorFrame{
		Name="AF2",
		Def.Sprite{ Name="airhorn", Texture="airhorn.png" },
		Def.BitmapText{ Name="catchphrase", Font="Common Normal", Text="Yo!" }
	}
}

-- Sets all three parts of the draw state.
self:SetDrawState{Mode="DrawMode_Quads", First= 1, Num= -1}
-- Set only the draw mode.  First and Num remain unchanged from previous.
self:SetDrawState{Mode="DrawMode_Quads"}
-- Set the first and number to draw.  Draw mode remains unchanged.
self:SetDrawState{First= 3, Num= 4}

local can, reason = GAMESTATE:CanSafelyEnterGameplay()
if not can then
	lua.ReportScriptError("Cannot safely enter gameplay: " .. tostring(reason))
end

NETWORK:HttpRequest{
	url="https://api.example.com",
	method="GET",                                   -- default: "GET"
	body="",                                        -- default: ""
	multipartBoundary="",                           -- default: ""
	headers={                                       -- default: {}
		["Accept-Language"]="en-US",
		["Cookie"]="sessionId=42",
	},
	connectTimeout=3,                               -- default: 60
	transferTimeout=10,                             -- default: 1800
	downloadFile="",                                -- default: no download file
	onProgress=function(currentBytes, totalBytes)   -- default: no callback
		...
	end,
	onResponse=function(response)                   -- default: no callback
		...
	end,
}

{
	statusCode=200,
	headers={
		["Content-Type"]="application/json",
		["Cache-Control"]="max-age=172800",
		["Server"]="Apache",
	},
	body="{...}"
	uploadSize=204,
	downloadSize=216,
}

{
	error="HttpErrorCode_Blocked",
	errorMessage="access to https://api.example.com is not allowed",
}

NETWORK:WebSocket{
	url="wss://api.example.com/chat",
	headers={                                       -- default: {}
		["Accept-Language"]="en-US",
		["Cookie"]="sessionId=42",
	},
	handshakeTimeout=3,                             -- default: 60 seconds
	pingInterval=10,                                -- default: disabled
	automaticReconnect=false,                       -- default: true
	onMessage=function(message)                     -- default: no callback
		...
	end,
}

-- Data
{
	type="WebSocketMessageType_Message",
	data="some data",
	binary=false,
}

-- Open
{
	type="WebSocketMessageType_Open",
	uri="/chat",
	headers={
		["Date"]="Fri, 27 May 2022 18:50:47 GMT",
	},
	protocol="",
}

-- Close
{
	type="WebSocketMessageType_Close",
	reason="Normal closure",
	remote=false,
}

-- Error
{
	type="WebSocketMessageType_Error",
	retries=1,
	waitTime=100,
	httpStatusCode=404,
	reason="Expecting status 101 (Switching Protocol), got 404",
	decompressionError=false,

}

-- Sets note_name to the player's current noteskin
note_name = options:NoteSkin()

-- Sets prev_note_name to the noteskin the player had set
-- changes the current noteskin to "cel"
-- sets succeeded to true if the "cel" noteskin exists.
prev_note_name, succeeded = options:NoteSkin("cel")

local InputHandler = function( event )
	-- do something cool with the event table in here :)
	-- the details of the event table are documented below

	-- example:
	-- show the GameButton that was most recently pressed/held
	if event.type ~= "InputEventType_Release" then
		SCREENMAN:SystemMessage( event.GameButton )
	end

	return false
end

Def.ActorFrame{
	OnCommand=function(self)
		SCREENMAN:GetTopScreen():AddInputCallback( InputHandler )
	end
}

{
	-- The "semi-raw" button that was pressed. This is what
	-- the button was mapped to by the keymap settings, without
	-- the conversions that occur when OnlyDedicatedMenuButtons
	--  is true. Will be empty if the button was not mapped.
	button = string,

	-- "InputEventType_FirstPress", "InputEventType_Repeat",
	-- or "InputEventType_Release".
	type = string,

	-- The "cooked" button that was pressed.  This is button with
	-- mapping that occurs when OnlyDedicatedMenuButtons is true
	-- applied.  This is nil for unmapped buttons.
	GameButton = string,

	-- The player that the controller is mapped to, or nil.
	PlayerNumber = PlayerNumber,

	-- The game controller this event was mapped to.
	-- "GameController_1" or "GameController_2", or nil if the event
	-- wasn't mapped to either controller.
	controller = string,

	-- The details of the event.
	DeviceInput = {
		-- The type of device.  The first half of the string will
		-- be "Device_", the second half will be from InputDeviceNames
		-- in RageInputDevice.cpp.
		device = string,

		-- The button that was pressed. The first half of the string
		-- will be "DeviceButton_", the second half will be from InitNames
		-- in RageInputDevice.cpp.
		button = string,

		-- A floating point value for analog input.
		level = float,

		-- Mousewheel input.
		z = float,

		-- Whether the button is down.  This is level with a threshold
		-- and debouncing applied.
		down = bool,

		-- How long ago this input occurred, in seconds.
		ago = float,

		-- True if the device is a joystick.
		is_joystick = bool,

		-- True if the device is a mouse.
		is_mouse = bool
	},

	-- Unknown purpose. SMOnline?
	MultiPlayer = string
}

local args = {
	-- ScreenMessage to send on pop
	-- optional, "SM_None" if omitted
	SendOnPop = "",

	-- the question text to display
	Question = "",

	-- initial answer text
	InitialAnswer = "",

	-- Maximum amount of characters
	MaxInputLength = 0,

	-- mask character input (optional)
	Password = false,

	-- validation function
	-- must return boolean and string
	Validate = function(answer, errorStr) end,

	-- function called on ok
	OnOK = function(answer) end,

	-- function called on cancel
	OnCancel = function() end,

	-- Validate appending a character 
	-- must return boolean
	ValidateAppend = function(answer, append) end,

	-- Format answer for display
	-- must return string
	FormatAnswerForDisplay = function(answer) end
}

{
	{ Frame=0, Delay=0.333, {0, 0}, {.25, .25} },
	{ Frame=1, Delay=0.333, {0, 0}, {.25, .25} },
	{ Frame=2, Delay=0.333, {0, 0}, {.25, .25} },
	{ Frame=3, Delay=0.333, {0, 0}, {.25, .25} },
}

{
	{Frame=0, Delay=0.333},
	{Frame=1, Delay=0.333},
	{Frame=2, Delay=0.333},
	{Frame=3, Delay=0.333}
}

{
	[1]="Home",
	[2]="default",
	[3]="_fallback"
}