cc.RenderTexture More...

Classes
class	soundVolume

Public Member Functions
static function	_3DToWorld (local x, local y, local z)

static function	_DoFrame ()

static function	_SetBound ()

static function	acos (local x)

static function	AfterFrame ()

static function	AfterRender ()

static function	Angle (local arg1, local arg2, local arg3, local arg4)

static function	asin (local x)

static function	assert (local v, local message)

static function	atan (local x)

static function	atan2 (local y, local x)

static function	BeforeRender ()

static function	BeginScene ()

static function	BentLaserData ()

static function	BoundCheck ()

static function	BoxCheck (local object, local left, local right, local bottom, local top)

static function	CacheFile (local path)

static function	CacheFileAsync (local path, local callback)

static function	CalcTextSize (local name, local str)

static function	CaptureScreen (local obj, local x, local y, local w, local h)

static function	ChangeVideoMode (local width, local height, local windowed, local vsync)

static function	CheckRes (local resType, local name)

static function	Class (local base, local define)

static function	collectgarbage (local opt, local arg)

static function	CollisionCheck (local A, local B)

static function	CollisionCheck3D (local A, local B)

static function	Color (local a, local r, local g, local b)

static function	combinNum (local ord, local sum)

static function	CopyFrameBuffer ()

static function	CopyImage (local newname, local img)

static function	cos (local x)

static function	CreateRenderMode (local name, local blendEquation, local blendFuncSrc, local blendFuncDst, local shaderName)

static function	CreateRenderTarget (local name)

static function	CreateShaderProgramFromPath (local vert, local frag)

static function	CreateShaderProgramFromString (local vert, local frag)

static function	DefaultRenderFunc (local obj)

static function	DefineDefaultScoreData (local t)

static function	Del (local o)

static function	Del (local obj, local ...)

static function	DeSerialize (local s)

static function	Dist (local objA, local objB)

static function	dofile (local filename)

static function	DoFile (local path)
	keycode More...

static function	DoFrame ()

static function	DrawCollider ()

static function	DrawGroupCollider (local group, local color, local offset_x, local offset_y)

static function	EndScene ()

static function	EnumRes (local resType)

static function	error (local message, local level)

static function	ExtractRes (local path, local target)

static function	Factorial (local num)

static function	FileTaskAsyncWrapper (local path, local autoRelease, local task)

static function	FileTaskWrapper (local path, local autoRelease, local task)

static function	FindResAnimation (local name)

static function	FindResFont (local name)

static function	FindResForObject (local name)

static function	FindResFX (local name)

static function	FindResMusic (local name)

static function	FindResource (local name, local resType)

static function	FindResourcePackForPath (local path)

static function	FindResParticle (local name)

static function	FindResRenderTarget (local name)

static function	FindResSound (local name)

static function	FindResSprite (local name)

static function	FindResTexture (local name)

static function	FindTexture2D (local name)

static function	FocusGainFunc ()

static function	FocusLoseFunc ()

static function	FrameEnd ()

static function	FrameFunc ()

static function	FrameInit ()

static function	FrameReset ()

static function	FreeObject (local object)

static function	from (local path)

static function	GameExit ()

static function	GameInit ()

static function	GetAllControllers ()

static function	GetAttr (local obj, local key)

static function	getfenv (local f)

static function	GetFPS ()

static function	GetFrameBuffer ()

static function	GetGlobal (local k, local v)

static function	GetImageScale ()

static function	GetInput ()

static function	GetKeyState (local code)

static function	GetLastChar ()

static function	GetLastKey ()

static function	GetLastXY (local object)

static function	getmetatable (local object)

static function	GetMousePosition ()

static function	GetMouseState (local button)

static function	GetMusicState (local name)

static function	GetnObj ()

static function	GetParticlePool (local object)

static function	GetPlatform ()

static function	GetSoundState (local name)

static function	GetTextureSize (local name)

static function	GetThreadPoolSize ()

static function	GetV (local obj)

static function	hypot (local x, local y)

static function	import (local module)

static function	Include (local filename)
	脚本搜索路径 More...

static function	ipairs (local t)

static function	IsRenderTarget (local name)

static function	IsValid (local obj)

static function	KeyIsDown (local key)

static function	KeyIsPressed (local key)

static function	KeyIsReleased (local key)
	key是否被按下 More...

static function	Kill (local o)

static function	Kill (local obj, local ...)

static function	load (local chunk, local chunkname)

static function	LoadAniFromFile (local texaniname, local filename, local mipmap, local n, local m, local intv, local a, local b, local rect)

static function	LoadAnimation (local name, local tex_name, local x, local y, local w, local h, local nCol, local nRow, local interval, local a, local b, local colliType)

static function	loadfile (local filename, local mode, local env)

static function	LoadFont (local name, local path)

static function	LoadFontAsync (local name, local path, local callback)

static function	LoadFX (local name, local fShader, local vShader, local isString)

static function	LoadImage (local name, local tex_name, local x, local y, local w, local h, local a, local b, local colliType)

static function	LoadImageFromFile (local name, local filename, local mipmap, local a, local b, local rect)

static function	LoadImageGroup (local prefix, local texname, local x, local y, local w, local h, local cols, local rows, local a, local b, local rect)

static function	LoadImageGroupFromFile (local texaniname, local filename, local mipmap, local n, local m, local a, local b, local rect)

static function	LoadMusic (local name, local path, local loop_end, local loop_duration)

static function	LoadMusicAsync (local name, local path, local loop_end, local loop_duration, local callback)

static function	LoadPack (local path, local password)

static function	LoadPS (local name, local path, local img_name, local a, local b, local colliType)

static function	LoadPSAsync (local name, local path, local img_name, local a, local b, local colliType, local callback)

static function	LoadSound (local name, local path)

static function	LoadSoundAsync (local name, local path, local callback)

static function	loadstring (local string, local chunkname)

static function	LoadTexture (local name, local path)

static function	LoadTextureAsync (local name, local path, local callback)

static function	LoadTTF (local name, local path, local size)

static function	LoadTTFAsync (local name, local path, local size, local callback)

static function	make_scoredata_table (local t)

static function	MessageBox (local msg, local title)

static function	module (local name, local ...)

static function	MouseIsDown (local button)

static function	MouseIsPressed (local button)

static function	MouseIsReleased (local button)

static function	MousePosition ()

static function	MousePositionPre ()

static function	New (local class, local ...)

static function	next (local table, local index)

static function	NextObject (local groupid, local id)

static function	ObjFrame ()

static function	ObjList (local groupid)

static function	ObjRender ()

static function	ObjTable ()

static function	pairs (local t)

static function	ParticleFire (local object)

static function	ParticleGetEmission (local object)

static function	ParticleGetn (local object)

static function	ParticleSetEmission (local object, local count)

static function	ParticleStop (local object)

static function	PauseMusic (local name)

static function	PauseSound (local name)

static function	pcall (local f, local arg1, local ...)

static function	PlayMusic (local name, local vol, local position)

static function	PlaySound (local name, local vol, local pan)

static function	PlaySound (local name, local vol, local pan, local sndflag)

static function	PopRenderTarget (local name)

static function	PostEffect (local rt, local fx, local blend, local param)

static function	PostEffectApply (local fx, local blend_mode, local param)

static function	PostEffectCapture ()

static function	PreserveObject (local o)

static function	Print (local ...)

static function	print (local ...)

static function	PushRenderTarget (local name)

static function	Rand ()

static function	rawequal (local v1, local v2)

static function	rawget (local table, local index)

static function	RawKill (local o)

static function	rawset (local table, local index, local value)

static function	RC4XOR (local data, local size)

static function	RegistClasses ()
	object More...

static function	RegisterClass (local class)

static function	RemoveResource (local poolType, local resType, local name)

static function	Render (local name, local x, local y, local rot, local hscale, local vscale, local z)

static function	Render4V (local name, local x1, local y1, local z1, local x2, local y2, local z2, local x3, local y3, local z3, local x4, local y4, local z4)

static function	RenderClear (local color)

static function	RenderFunc ()

static function	RenderRect (local name, local left, local right, local bottom, local top)

static function	RenderSector (local name, local x, local y, local start, local end_, local r1, local r2, local seg)

static function	RenderText (local fontname, local text, local x, local y, local size, local ...)

static function	RenderText (local name, local text, local x, local y, local scale, local align)

static function	RenderTexture (local name, local blend, local vertex1, local vertex2, local vertex3, local vertex4)

static function	RenderTTF (local name, local text, local left, local right, local bottom, local top, local fmt, local color, local scale)

static function	RenderTTF (local ttfname, local text, local left, local right, local bottom, local top, local color, local ...)

static function	require (local modname)

static function	Reset3D ()

static function	ResetPool ()

static function	ResumeMusic (local name)

static function	ResumeSound (local name)

static function	SampleBezierA1 (local list, local count, local length, local rate)

static function	SaveScoreData ()

static function	scoredata_mt_index (local t, local k)

static function	scoredata_mt_newindex (local t, local k, local v)

static function	Screenshot ()

static function	select (local index, local ...)

static function	Serialize (local o)

static function	Set3D (local key, local a, local b, local c)

static function	SetAnimationCenter (local name, local x, local y)

static function	SetAnimationState (local name, local blendMode, local color1, local color2, local color3, local color4)

static function	SetAttr (local obj, local key, local v)

static function	SetBGMVolume (local arg1, local arg2)

static function	SetBound (local left, local right, local bottom, local top)

static function	setfenv (local f, local table)

static function	SetFog (local near, local far, local color)

static function	SetFontState (local name, local blendMode, local color)

static function	SetFPS (local number)

static function	SetGlobal (local k, local v)
	一些游戏中的全局变量 More...

static function	SetImageCenter (local name, local x, local y)

static function	SetImageScale (local scale)

static function	SetImageState (local name, local blendMode, local color1, local color2, local color3, local color4)

static function	SetImgState (local object, local blend, local a, local r, local g, local b)

static function	SetLastXY (local object, local x, local y)

static function	setmetatable (local table, local metatable)

static function	SetMSAALevel (local level)

static function	SetOffscreen (local b)

static function	SetOnControllerAxisEvent (local f)

static function	SetOnControllerConnect (local f)

static function	SetOnControllerDisconnect (local f)

static function	SetOnControllerKeyDown (local f)

static function	SetOnControllerKeyUp (local f)

static function	SetOnWriteLog (local f)

static function	SetOrtho (local left, local right, local bottom, local top)

static function	SetPerspective (local eyeX, local eyeY, local eyeZ, local atX, local atY, local atZ, local upX, local upY, local upZ, local fovy, local aspect, local zn, local zf)

static function	SetResLoadInfo (local b)

static function	SetResolution (local width, local height)

static function	SetResourceStatus (local poolType)

static function	SetSEVolume (local arg1, local arg2)

static function	SetShaderUniform (local fx, local param)

static function	SetSplash (local b)

static function	SetThreadPoolSize (local n)

static function	SetTitle (local title)

static function	SetV (local obj, local v, local angle, local updateRot)

static function	SetV2 (local obj, local v, local angle, local updateRot, local aim)

static function	SetViewMode (local mode)

static function	SetViewport (local left, local right, local bottom, local top)

static function	SetVsync (local boolean)

static function	SetWindowed (local b)

static function	ShowSplashWindow (local path)

static function	sign (local x)

static function	sin (local x)

static function	StopMusic (local name)

static function	StopSound (local name)

static function	stringify (local this, local docol, local spacing_h, local spacing_v, local preindent)

static function	SystemLog (local str)

static function	tan (local x)

static function	tonumber (local e, local base)

static function	tostring (local v)

static function	type (local v)

static function	UnloadPack (local path)

static function	unpack (local list, local i, local j)

static function	UpdateParticle (local object)

static function	UpdateXY ()

static function	UserSystemOperation ()

static function	visitTable (local t)

static function	WorldToGame (local x, local y, local flipY)

static function	WorldToScreen (local x, local y)

static function	xclass (local base, local define)

static function	xpcall (local f, local msgh, local arg1, local ...)

static function	XXHash32 (local data)

Public Attributes
number	GOLD = 360 * (math.sqrt(5) - 1) / 2
	0.618*360 More...

number	GROUP_ALL = 16

number	GROUP_ENEMY = 2

number	GROUP_ENEMY_BULLET = 1

number	GROUP_GHOST = 0

number	GROUP_INDES = 5

number	GROUP_ITEM = 6

number	GROUP_NONTJT = 7

number	GROUP_NUM_OF_GROUP = 16

number	GROUP_PLAYER = 4

number	GROUP_PLAYER_BULLET = 3

number	LAYER_BG = -700

number	LAYER_ENEMY = -600

number	LAYER_ENEMY_BULLET = -200

number	LAYER_ENEMY_BULLET_EF = -100

number	LAYER_ITEM = -300

number	LAYER_PLAYER = -400

number	LAYER_PLAYER_BULLET = -500

number	LAYER_TOP = 0

number	PI = math.pi
	π. More...

number	PI_2 = math.pi * 0.5
	π/2. More...

number	PI_4 = math.pi * 0.25
	π/4. More...

number	PIx2 = math.pi * 2
	π*2. More...

number	SQRT2 = math.sqrt(2)
	√2 More...

number	SQRT2_2 = math.sqrt(0.5)
	√2/2 More...

number	SQRT3 = math.sqrt(3)
	√3 More...

Detailed Description

cc.RenderTexture

一个全局变量（非函数），内部储存有全局环境。Lua 自己不使用这个变量；

改变这个变量的值不会对任何环境造成影响，反之亦然。

init score data

score/mod_name

Member Function Documentation

◆ _3DToWorld()

static function _3DToWorld	(	local	x,
		local	y,
		local	z
	)

◆ _DoFrame()

static function _DoFrame ( )

◆ _SetBound()

static function _SetBound ( )

屏幕宽度

屏幕高度

◆ acos()

static function acos ( local x )

Parameters

x number

Returns: number

◆ AfterFrame()

static function AfterFrame ( )

刷新对象的timer和ani_timer，若对象被标记为del或kill将删除对象并回收资源。

禁止在协程上调用该方法。

细节

>　对象只有在AfterFrame调用后才会被清理，在此之前可以通过设置对象的status字段取消删除标记。

◆ AfterRender()

static function AfterRender ( )

◆ Angle()

static function Angle	(	local	arg1,
		local	arg2,
		local	arg3,
		local	arg4
	)

计算两点连线角度

当参数个数为2时，返回2个object连线角度

当参数个数为4时，返回2个坐标连线角度

Parameters

arg1	object\|number object或x1
arg2	object\|number object或y1
arg3	number x2
arg4	number y2

◆ asin()

static function asin ( local x )

Parameters

x number

Returns: number

◆ atan()

static function atan ( local x )

Parameters

x number

Returns: number

◆ atan2()

static function atan2	(	local	y,
		local	x
	)

Parameters

y	number
x	number

Returns: number

◆ BeforeRender()

static function BeforeRender ( )

◆ BeginScene()

static function BeginScene ( )

通知开始渲染。该方法必须在RenderFunc中调用。所有渲染动作必须在BeginScene/EndScene中进行。

◆ BentLaserData()

static function BentLaserData ( )

创建并返回曲线激光类

Returns: lstg.BentLaserData

◆ BoundCheck()

static function BoundCheck ( )

执行边界检查。注意BoundCheck只保证对象中心还在范围内，不进行碰撞盒检查

禁止在协程上调用该方法

将bound==true并且x,y在SetBound设置范围外的所有对象状态置为'del'

◆ BoxCheck()

static function BoxCheck	(	local	object,
		local	left,
		local	right,
		local	bottom,
		local	top
	)

检查对象中心是否在所给范围内

Parameters

object	object
left	number
right	number
bottom	number
top	number

Returns: boolean

◆ CacheFile()

static function CacheFile ( local path )

Returns: boolean,lstg.ResourcePack

◆ CacheFileAsync()

static function CacheFileAsync	(	local	path,
		local	callback
	)

Returns: lstg.ResourcePack

◆ CalcTextSize()

static function CalcTextSize	(	local	name,
		local	str
	)

计算文字渲染后的尺寸

Parameters

name	string
str	string

Returns: number,number

◆ CaptureScreen()

static function CaptureScreen	(	local	obj,
		local	x,
		local	y,
		local	w,
		local	h
	)

x,y,w,h are in ui coords

Parameters

obj	object
x	number
y	number
w	number
h	number

◆ ChangeVideoMode()

static function ChangeVideoMode	(	local	width,
		local	height,
		local	windowed,
		local	vsync
	)

改变视频选项。若成功返回true，否则返回false

Parameters

width	number
height	number
windowed	boolean
vsync	boolean

◆ CheckRes()

static function CheckRes	(	local	resType,
		local	name
	)

获得一个资源所在资源池的类别，通常用于检测资源是否存在

细节

方法会根据名称先在全局资源池中寻找，若有则返回global

若全局资源表中没有找到资源，则在关卡资源池中找，若有则返回stage

若不存在资源，则返回nil

Parameters

resType	string 资源类型 tex,img,ani,bgm,snd,psi,fnt,ttf,fx
name	string 资源名

◆ Class()

static function Class	(	local	base,
		local	define
	)

定义类

Parameters

base	object 基类
define	table 需要额外继承的表，通常与base相同

Returns: object

◆ CollisionCheck()

static function CollisionCheck	(	local	A,
		local	B
	)

对组A和B进行碰撞检测。如果组A中对象与组B中对象发生碰撞，将执行A中对象的碰撞回调函数。

禁止在协程上调用该方法。

Parameters

A	number\|object
B	number\|object

◆ CollisionCheck3D()

static function CollisionCheck3D	(	local	A,
		local	B
	)

Parameters

A	number
B	number

◆ Color()

static function Color	(	local	a,
		local	r,
		local	g,
		local	b
	)

创建并返回颜色类

Parameters

a	number
r	number
g	number
b	number

Returns: lstg.Color

重载: fun(argb:number):lstg.Color

◆ combinNum()

static function combinNum	(	local	ord,
		local	sum
	)

组合数

Parameters

ord	number
sum	number

Returns: number

◆ CopyFrameBuffer()

static function CopyFrameBuffer ( )

Returns: cc.RenderTexture

◆ CopyImage()

static function CopyImage	(	local	newname,
		local	img
	)

复制已载入的图像资源

Parameters

newname	string 新的图像资源名
img	string 原有图像资源名

Returns: lstg.ResSprite

◆ cos()

static function cos ( local x )

Parameters

x number

Returns: number

◆ CreateRenderMode()

static function CreateRenderMode	(	local	name,
		local	blendEquation,
		local	blendFuncSrc,
		local	blendFuncDst,
		local	shaderName
	)

◆ CreateRenderTarget()

static function CreateRenderTarget ( local name )

创建一个名为name的RenderTarget

可以像纹理那样使用

Parameters

name string

Returns: lstg.ResRenderTarget

◆ CreateShaderProgramFromPath()

static function CreateShaderProgramFromPath	(	local	vert,
		local	frag
	)

设置雾值

若参数为空，将关闭雾效果。否则设置一个从near到far的雾

Parameters

near	number
far	number
color	lstg.Color 默认为0x00FFFFFF
vert	string
frag	string

Returns: ccb.Program

◆ CreateShaderProgramFromString()

static function CreateShaderProgramFromString	(	local	vert,
		local	frag
	)

Parameters

vert	string
frag	string

Returns: ccb.Program

◆ DefaultRenderFunc()

static function DefaultRenderFunc ( local obj )

在对象上调用默认渲染方法

Parameters

obj object

◆ DefineDefaultScoreData()

static function DefineDefaultScoreData ( local t )

◆ Del() [1/2]

static function Del ( local o )

◆ Del() [2/2]

static function Del	(	local	obj,
		local ...
	)

通知删除一个对象。将设置标志并调用回调函数。

若在object后传递多个参数，将被传递给回调函数。

Parameters

obj object

◆ DeSerialize()

static function DeSerialize ( local s )

◆ Dist()

static function Dist	(	local	objA,
		local	objB
	)

计算两个object距离

Parameters

objA	object
objB	object

Returns: number

◆ DoFile()

static function DoFile ( local path )

keycode

执行指定路径的脚本。已执行过的脚本会再次执行。

若文件不存在、编译失败、执行失败则抛出错误。

Parameters

path string

◆ DoFrame()

static function DoFrame ( )

◆ DrawCollider()

static function DrawCollider ( )

◆ DrawGroupCollider()

static function DrawGroupCollider	(	local	group,
		local	color,
		local	offset_x,
		local	offset_y
	)

DrawGroupCollider

Parameters

group	number
color	lstg.Color
offset_x	number
offset_y	number

◆ EndScene()

static function EndScene ( )

通知结束渲染。该方法必须在RenderFunc中调用。

◆ EnumRes()

static function EnumRes ( local resType )

枚举资源池中某种类型的资源

依次返回全局资源池、关卡资源池中该类型的所有资源的名称

Parameters

resType string 资源类型: tex,img,ani,bgm,snd,psi,fnt,ttf,fx

Returns: table,table 包含资源名的table，分别属于全局和关卡资源池

◆ ExtractRes()

static function ExtractRes	(	local	path,
		local	target
	)

将资源包中的数据解压到本地

若失败将抛出错误

◆ Factorial()

static function Factorial ( local num )

阶乘

Parameters

num number

Returns: number

◆ FileTaskAsyncWrapper()

static function FileTaskAsyncWrapper	(	local	path,
		local	autoRelease,
		local	task
	)

◆ FileTaskWrapper()

static function FileTaskWrapper	(	local	path,
		local	autoRelease,
		local	task
	)

◆ FindResAnimation()

static function FindResAnimation ( local name )

FindResAnimation

Parameters

name string

Returns: lstg.ResAnimation

◆ FindResFont()

static function FindResFont ( local name )

FindResFont

Parameters

name string

Returns: lstg.ResFont

◆ FindResForObject()

static function FindResForObject ( local name )

used by engine

◆ FindResFX()

static function FindResFX ( local name )

FindResFX

Parameters

name string

Returns: lstg.ResFX

◆ FindResMusic()

static function FindResMusic ( local name )

FindResMusic

Parameters

name string

Returns: lstg.ResMusic

◆ FindResource()

static function FindResource	(	local	name,
		local	resType
	)

FindResource

Parameters

name	string
resType	number\|string

Returns: lstg.Resource

◆ FindResourcePackForPath()

static function FindResourcePackForPath ( local path )

FindResourcePackForPath

Parameters

path string

Returns: lstg.ResourcePack

◆ FindResParticle()

static function FindResParticle ( local name )

FindResParticle

Parameters

name string

Returns: lstg.ResParticle

◆ FindResRenderTarget()

static function FindResRenderTarget ( local name )

FindResRenderTarget

Parameters

name string

Returns: lstg.ResRenderTarget

◆ FindResSound()

static function FindResSound ( local name )

FindResSound

Parameters

name string

Returns: lstg.ResSound

◆ FindResSprite()

static function FindResSprite ( local name )

FindResSprite

Parameters

name string

Returns: lstg.ResSprite

◆ FindResTexture()

static function FindResTexture ( local name )

FindResTexture

Parameters

name string

Returns: lstg.ResTexture

◆ FindTexture2D()

static function FindTexture2D ( local name )

Parameters

name string

Returns: cc.Texture2D

◆ FocusGainFunc()

static function FocusGainFunc ( )

◆ FocusLoseFunc()

static function FocusLoseFunc ( )

◆ FrameEnd()

static function FrameEnd ( )

◆ FrameFunc()

static function FrameFunc ( )

◆ FrameInit()

static function FrameInit ( )

◆ FrameReset()

static function FrameReset ( )

◆ FreeObject()

static function FreeObject ( local object )

◆ from()

static function from ( local path )

指定导入模块的位置，只能以根目录为基准

Parameters

path string

Returns: void

◆ GameExit()

static function GameExit ( )

◆ GameInit()

static function GameInit ( )

游戏初始化

◆ GetAllControllers()

static function GetAllControllers ( )

Returns: cc.Controller[]

◆ GetAttr()

static function GetAttr	(	local	obj,
		local	key
	)

获取对象属性

Parameters

obj	object
key	string

Returns: any

◆ GetFPS()

static function GetFPS ( )

获得当前的实时FPS。

Returns: number

◆ GetFrameBuffer()

static function GetFrameBuffer ( )

Returns: cc.RenderTexture

◆ GetGlobal()

static function GetGlobal	(	local	k,
		local	v
	)

从lstg.var取出k对应的值

◆ GetImageScale()

static function GetImageScale ( )

获取全局图像渲染缩放

Returns: number

◆ GetInput()

static function GetInput ( )

获取输入并保存

◆ GetKeyState()

static function GetKeyState ( local code )

给出虚拟键代码检测是否按下

code的具体含义请查阅keycode.lua

◆ GetLastChar()

static function GetLastChar ( )

返回最后一次输入的按键的虚拟键代码

Returns: number 返回上一次输入的字符; string

◆ GetLastKey()

static function GetLastKey ( )

返回最后一次输入的按键的虚拟键代码

Returns: number

◆ GetLastXY()

static function GetLastXY ( local object )

◆ GetMousePosition()

static function GetMousePosition ( )

获取鼠标的位置，以窗口左下角为原点，使用screen坐标系

Returns: number,number

◆ GetMouseState()

static function GetMouseState ( local button )

获取鼠标的位置，以窗口左下角为原点

Returns: number,number 检查鼠标按键是否按下

Parameters

button number 可取0、1、2，分别对应鼠标左键、中键、右键

Returns: boolean

◆ GetMusicState()

static function GetMusicState ( local name )

获取音乐播放状态

Parameters

name string

Returns: string 返回paused/playing/stopped

◆ GetnObj()

static function GetnObj ( )

获取对象池中对象个数

Returns: number

◆ GetParticlePool()

static function GetParticlePool ( local object )

Parameters

object object

Returns: lstg.ParticlePool

◆ GetPlatform()

static function GetPlatform ( )

◆ GetSoundState()

static function GetSoundState ( local name )

获取音效播放状态

Parameters

name string

Returns: string 返回paused/playing/stopped

◆ GetTextureSize()

static function GetTextureSize ( local name )

获取纹理的宽度和高度

Parameters

name string

Returns: number,number

◆ GetThreadPoolSize()

static function GetThreadPoolSize ( )

Returns: number

◆ GetV()

static function GetV ( local obj )

获取速度方向和大小（C++对象）

Parameters

obj object

Returns: number, number 速度大小，速度方向（角度）

◆ hypot()

static function hypot	(	local	x,
		local	y
	)

sqrt(x^2+y^2)

Parameters

x	number
y	number

Returns: number

◆ import()

static function import ( local module )

导入模块，以当前目录、from目录或根目录为基准

Parameters

module string

Returns: void

◆ Include()

static function Include ( local filename )

脚本搜索路径

包含（执行）脚本文件

Parameters

filename string

Returns: any 脚本返回值

◆ IsRenderTarget()

static function IsRenderTarget ( local name )

检查一个纹理是否为RenderTarget

Deprecated:

◆ IsValid()

static function IsValid ( local obj )

IsValid(obj)

检查对象是否有效

对象为table，且具有正确的资源池id

Parameters

obj object

Returns: boolean

◆ KeyIsDown()

static function KeyIsDown ( local key )

key是否被按下

Parameters

key string

Returns: boolean

◆ KeyIsPressed()

static function KeyIsPressed ( local key )

key是否刚刚被按下

Parameters

key string

Returns: boolean

◆ KeyIsReleased()

static function KeyIsReleased ( local key )

key是否被按下

key是否刚刚被按下 key是否刚刚松开

Parameters

key string

Returns: boolean

◆ Kill() [1/2]

static function Kill ( local o )

◆ Kill() [2/2]

static function Kill	(	local	obj,
		local ...
	)

通知杀死一个对象。将设置标志并调用回调函数。

若在object后传递多个参数，将被传递给回调函数。

Parameters

obj object

◆ LoadAniFromFile()

static function LoadAniFromFile	(	local	texaniname,
		local	filename,
		local	mipmap,
		local	n,
		local	m,
		local	intv,
		local	a,
		local	b,
		local	rect
	)

从文件载入动画

Parameters

texaniname	string 资源名
filename	string 文件名
mipmap	boolean 创建Mipmap链，用于加快图像渲染，对动态纹理和渲染目标无效
n	number 行数
m	number 列数
intv	number 动画间隔（帧）最小为1
a	number 横向碰撞大小的一半
b	number 纵向碰撞大小的一半
rect	boolean 是否为矩形碰撞盒

Returns: lstg.ResAnimation

◆ LoadAnimation()

static function LoadAnimation	(	local	name,
		local	tex_name,
		local	x,
		local	y,
		local	w,
		local	h,
		local	nCol,
		local	nRow,
		local	interval,
		local	a,
		local	b,
		local	colliType
	)

装载动画

动画总是循环播放的

Parameters

name	string
tex_name	string
x	number
y	number 第一帧的左上角位置
w	number
h	number 一帧的大小
nCol	number
nRow	number 纵向横向的分割数，以列优先顺序排列
interval	number 帧间隔
a	number
b	number
colliType	boolean 同LoadImage

Returns: lstg.ResAnimation

◆ LoadFont()

static function LoadFont	(	local	name,
		local	path
	)

装载纹理字体

支持HGE的纹理字体，将根据定义文件在字体同级目录下寻找纹理文件

Parameters

name	string 名称
path	string 定义文件

Returns: lstg.ResFont

◆ LoadFontAsync()

static function LoadFontAsync	(	local	name,
		local	path,
		local	callback
	)

◆ LoadFX()

static function LoadFX	(	local	name,
		local	fShader,
		local	vShader,
		local	isString
	)

载入FX文件(shader特效)

Parameters

name	string
fShader	string fragment shader路径/内容，默认为shader/ColorMulti.frag
vShaderpath	string vertex shader路径/内容，默认为shader/Common.vert
isString	boolean 指示fShader和vShader为shader内容还是路径

Returns: lstg.ResFX

◆ LoadImage()

static function LoadImage	(	local	name,
		local	tex_name,
		local	x,
		local	y,
		local	w,
		local	h,
		local	a,
		local	b,
		local	colliType
	)

在纹理中创建图像

细节

当把一个图像赋予对象的img字段时，它的a、b、rect属性会自动被赋值到对象上

Parameters

name	string
tex_name	string
x	number
y	number 图像在纹理上左上角的坐标（纹理左上角为（0,0），向下向右为正方向）
w	number
h	number 图像的大小
a	number
b	number 横向、纵向碰撞半径
colliType	boolean\|number\|string 判定形状

Returns: lstg.ResSprite

◆ LoadImageFromFile()

static function LoadImageFromFile	(	local	name,
		local	filename,
		local	mipmap,
		local	a,
		local	b,
		local	rect
	)

从文件载入图像

Parameters

name	string 资源名
filename	string 文件名
mipmap	boolean
a	number
b	number 碰撞半径省略为0
rect	boolean 是否为矩形碰撞盒省略为false

Returns: lstg.ResSprite

◆ LoadImageGroup()

static function LoadImageGroup	(	local	prefix,
		local	texname,
		local	x,
		local	y,
		local	w,
		local	h,
		local	cols,
		local	rows,
		local	a,
		local	b,
		local	rect
	)

从纹理资源载入图像组

Parameters

prefix	string 资源名前缀
texname	string 纹理资源名
x	number
y	number 起始坐标
w	number
h	number 单个图像尺寸
cols	number
rows	number 行列数
a	number
b	number 碰撞半径省略为0
rect	boolean 是否为矩形碰撞盒省略为false

◆ LoadImageGroupFromFile()

static function LoadImageGroupFromFile	(	local	texaniname,
		local	filename,
		local	mipmap,
		local	n,
		local	m,
		local	a,
		local	b,
		local	rect
	)

从文件载入图像组

通常使用_LoadImageGroupFromFile代替

Parameters

texaniname	string 资源名
filename	string 文件名
mipmap	boolean
n	number 行数
m	number 列数
a	number 横向碰撞大小的一半
b	number 纵向碰撞大小的一半
rect	boolean 是否为矩形碰撞盒

◆ LoadMusic()

static function LoadMusic	(	local	name,
		local	path,
		local	loop_end,
		local	loop_duration
	)

加载音乐

仅支持wav或ogg，推荐使用ogg格式

细节

音乐将以流的形式装载进入内存，不会一次性完整解码放入内存

通过描述循环节可以设置音乐的循环片段。当音乐位置播放到end时会衔接到start。这一步在解码器中进行，以保证完美衔接

Parameters

name	string 资源名
path	string 文件路径
loop_end	number 循环结束（秒）
loop_duration	number 循环时长（秒）

Returns: lstg.ResMusic

◆ LoadMusicAsync()

static function LoadMusicAsync	(	local	name,
		local	path,
		local	loop_end,
		local	loop_duration,
		local	callback
	)

◆ LoadPack()

static function LoadPack	(	local	path,
		local	password
	)

加载指定位置的ZIP资源包，可选填密码

失败将导致错误

细节

后加载的资源包有较高的查找优先级。这意味着可以通过该机制加载资源包来覆盖基础资源包中的文件。

一旦zip文件被打开，将不能被访问。

加载文件时将按照优先级依次搜索资源包，若资源包中不含文件则从当前目录加载。

Parameters

path	string
password	string @optional

Returns: lstg.ResourcePack

◆ LoadPS()

static function LoadPS	(	local	name,
		local	path,
		local	img_name,
		local	a,
		local	b,
		local	colliType
	)

装载粒子系统

使用HGE所用的粒子文件结构

Parameters

name	string
path	string 定义文件
img_name	string 粒子图片
a	number
b	number
colliType	boolean

Returns: lstg.ResParticle

◆ LoadPSAsync()

static function LoadPSAsync	(	local	name,
		local	path,
		local	img_name,
		local	a,
		local	b,
		local	colliType,
		local	callback
	)

◆ LoadSound()

static function LoadSound	(	local	name,
		local	path
	)

装载音效

仅支持wav或ogg，推荐使用wav格式

细节

音效将被装载进入内存。请勿使用较长的音频文件做音效

对于wav格式，由于受限于目前的实现，不支持非标准的、带压缩的格式

Parameters

name	string 资源名
path	string 文件路径

Returns: lstg.ResSound

◆ LoadSoundAsync()

static function LoadSoundAsync	(	local	name,
		local	path,
		local	callback
	)

◆ LoadTexture()

static function LoadTexture	(	local	name,
		local	path
	)

从文件载入纹理，支持多种格式，推荐png

Parameters

name	string
path	string

Returns: lstg.ResTexture

◆ LoadTextureAsync()

static function LoadTextureAsync	(	local	name,
		local	path,
		local	callback
	)

◆ LoadTTF()

static function LoadTTF	(	local	name,
		local	path,
		local	size
	)

加载TTF字体

Parameters

name	string 资源名称
path	string 加载路径
size	number 字形大小

Returns: lstg.ResFont

◆ LoadTTFAsync()

static function LoadTTFAsync	(	local	name,
		local	path,
		local	size,
		local	callback
	)

◆ make_scoredata_table()

static function make_scoredata_table ( local t )

◆ MessageBox()

static function MessageBox	(	local	msg,
		local	title
	)

Parameters

msg	string
title	string

◆ MouseIsDown()

static function MouseIsDown ( local button )

MouseIsDown

Parameters

button number

Returns: boolean

◆ MouseIsPressed()

static function MouseIsPressed ( local button )

MouseIsPressed

Parameters

button number

Returns: boolean

◆ MouseIsReleased()

static function MouseIsReleased ( local button )

MouseIsReleased

Parameters

button number

Returns: boolean

◆ MousePosition()

static function MousePosition ( )

Returns: number,number

◆ MousePositionPre()

static function MousePositionPre ( )

Returns: number,number

◆ New()

static function New	(	local	class,
		local ...
	)

创建新对象，将累加uid值

细节

该方法使用class创建一个对象，并在构造对象后调用class的构造方法(init)构造对象。

被创建的对象具有如下属性：

| 属性 | 描述 |

| ---— | ---— |

| x, y | 坐标 |

| dx, dy | (只读)距离上一次更新的坐标增量 |

| rot | 角度 |

| omiga | 角度增量 |

| timer | 计数器 |

| vx, vy | 速度 |

| ax, ay | 加速度 |

| layer | 渲染层级 |

| group | 碰撞组 |

| hide | 是否隐藏 |

| bound | 是否越界销毁 |

| navi | 是否自动更新朝向 |

| colli | 是否允许碰撞 |

| status | 对象状态，返回del kill normal |

| hscale, vscale | 横向、纵向的缩放 |

| class | 对象的父类 |

| a, b | 碰撞盒大小 |

| rect | 是否为矩形碰撞盒 |

| img | 绑定的图像/动画资源(名称) |

| ani | (只读)动画计数器 |

被创建对象的索引1和2被用于存放类和id【请勿修改】

其中父类class需满足如下形式：

is_class = true

[1] = 初始化函数 (object, ...)

[2] = 删除函数(DEL) (object, ...)

[3] = 帧函数 (object)

[4] = 渲染函数 (object)

[5] = 碰撞函数 (object, object)

[6] = 消亡函数(KILL) (object, ...)

上述回调函数将在对象触发相应事件时被调用

引擎提供了至多32768个空间共object使用。超过这个大小后将报错。

Returns: object

◆ NextObject()

static function NextObject	(	local	groupid,
		local	id
	)

获取组中的下一个元素。若groupid为无效的碰撞组则返回所有对象。

返回的第一个参数为id，第二个参数为对象

Parameters

groupid	number
id	number

Returns: object

◆ ObjFrame()

static function ObjFrame ( )

更新对象列表中所有对象，并更新属性

禁止在协程上调用该方法

细节

按照下列顺序更新这些属性：

vx += ax

vy += ay

x += vx

y += vy

rot += omiga

更新绑定的粒子系统（若有）

◆ ObjList()

static function ObjList ( local groupid )

产生组遍历迭代器

for id, obj in ObjList(GROUP_PLAYER) do

...

end

Parameters

groupid number

Returns: function

◆ ObjRender()

static function ObjRender ( )

渲染所有对象。此时将所有对象排序。

禁止在协程上调用该方法。

排序规则：layer小的先渲染，若layer相同则按照uid

细节

渲染列表总是保持有序的，将不会每次排序

◆ ObjTable()

static function ObjTable ( )

获得对象池所在的table

◆ ParticleFire()

static function ParticleFire ( local object )

启动绑定在对象上的粒子发射器

Parameters

object object

◆ ParticleGetEmission()

static function ParticleGetEmission ( local object )

获取绑定在对象上粒子发射器的发射密度（个/秒）

细节

　更新粒子发射器的时钟始终为1/60s

Parameters

object object

◆ ParticleGetn()

static function ParticleGetn ( local object )

返回绑定在对象上的粒子发射器的存活粒子数

Parameters

object object

◆ ParticleSetEmission()

static function ParticleSetEmission	(	local	object,
		local	count
	)

设置绑定在对象上粒子发射器的发射密度（个/秒）

Parameters

object	object
count	number

◆ ParticleStop()

static function ParticleStop ( local object )

停止绑定在对象上的粒子发射器

Parameters

object object

◆ PauseMusic()

static function PauseMusic ( local name )

暂停播放音乐

Parameters

name string

◆ PauseSound()

static function PauseSound ( local name )

暂停播放音效

Parameters

name string

◆ PlayMusic()

static function PlayMusic	(	local	name,
		local	vol,
		local	position
	)

播放音乐

Parameters

name	string 资源名
vol	number 音量系数，默认为1
position	number 起始播放位置（秒），默认为0

◆ PlaySound() [1/2]

static function PlaySound	(	local	name,
		local	vol,
		local	pan
	)

Parameters

name	string 音效资源名
vol	number 音量
pan	number 声道平衡

◆ PlaySound() [2/2]

static function PlaySound	(	local	name,
		local	vol,
		local	pan,
		local	sndflag
	)

Parameters

name	string 音效资源名
vol	number 音量
pan	number 声道平衡
sndflag	boolean 不使用默认音量

◆ PopRenderTarget()

static function PopRenderTarget ( local name )

将当前使用的RenderTarget从堆栈中移除

Parameters

name string

◆ PostEffect()

static function PostEffect	(	local	rt,
		local	fx,
		local	blend,
		local	param
	)

应用PostEffect(不论是否处于渲染状态)。参数指定传递给FX的参数表，将会影响后续对该FX的使用

其中blend指定posteffect要以什么样的形式绘制到屏幕上，此时blend的第一分量无效

细节

可以在PostEffect中使用下列语义注释(不区分大小写)捕获对象：

POSTEFFECTTEXTURE获取posteffect的捕获纹理(texture2d类型)

VIEWPORT获取视口大小(vector类型)

SCREENSIZE获取屏幕大小(vector类型)

Parameters

rt	lstg.ResRenderTarget\|string
fx	lstg.ResFX\|string
blend	lstg.RenderMode\|string
param	table

◆ PostEffectApply()

static function PostEffectApply	(	local	fx,
		local	blend_mode,
		local	param
	)

结束屏幕捕获并应用PostEffect

这一操作等价于：

PopRenderTarget(InternalPostEffectBuffer)

PostEffect(InternalPostEffectBuffer, fx_name, blend, args)

代码必须满足：

PostEffectCapture(...)

... –配对的Push/PopRenderTarget操作

PostEffectApply(...)

Parameters

fx	lstg.ResFX\|string
blend_mode	lstg.RenderMode\|string
param	table 其中key表示uniform变量名，value可以是数值、字符串（纹理名）、颜色

Deprecated:

◆ PostEffectCapture()

static function PostEffectCapture ( )

开始捕获绘制数据

从这一步开始，所有后续渲染操作都将在PostEffect缓冲区中进行

这一操作等价于PushRenderTarget(InternalPostEffectBuffer)

Deprecated:

◆ PreserveObject()

static function PreserveObject ( local o )

将对象状态置为'normal'

◆ Print()

static function Print ( local ... )

将若干值写到日志。

◆ PushRenderTarget()

static function PushRenderTarget ( local name )

将一个RenderTarget作为屏幕缓冲区，并推入栈

细节

引擎底层使用栈来管理RenderTarget，这意味着可以嵌套使用

Parameters

name string

◆ Rand()

static function Rand ( )

创建并返回随机数发生器

Returns: lstg.Rand

◆ RawKill()

static function RawKill ( local o )

kill对象的附属，将对象状态置为'kill'

◆ RC4XOR()

static function RC4XOR	(	local	data,
		local	size
	)

Parameters

data	string\|ffi.cdata

Returns: string

◆ RegistClasses()

static function RegistClasses ( )

object

◆ RegisterClass()

static function RegisterClass ( local class )

◆ RemoveResource()

static function RemoveResource	(	local	poolType,
		local	resType,
		local	name
	)

若只有一个参数，则删除一个池中的所有资源。否则删除对应池中的某个资源。参数可选global或stage。

若资源仍在使用之中，将继续保持装载直到相关的对象被释放。

Parameters

poolType	string
resType	string
name	string

◆ Render()

static function Render	(	local	name,
		local	x,
		local	y,
		local	rot,
		local	hscale,
		local	vscale,
		local	z
	)

渲染图像

Parameters

name	string 图像资源名
x	number
y	number 渲染位置
rot	number 旋转角度（角度），默认为0
hscale	number 水平缩放，默认为1
vscale	number 垂直缩放，默认等于hscale
z	number Z值，默认为0.5

◆ Render4V()

static function Render4V	(	local	name,
		local	x1,
		local	y1,
		local	z1,
		local	x2,
		local	y2,
		local	z2,
		local	x3,
		local	y3,
		local	z3,
		local	x4,
		local	y4,
		local	z4
	)

给出四个顶点渲染图像

Parameters

name	string
x1	number
y1	number
z1	number
x2	number
y2	number
z2	number
x3	number
y3	number
z3	number
x4	number
y4	number
z4	number

◆ RenderClear()

static function RenderClear ( local color )

使用指定颜色清空屏幕，同时会清除深度缓冲区

Parameters

color lstg.Color

◆ RenderFunc()

static function RenderFunc ( )

◆ RenderRect()

static function RenderRect	(	local	name,
		local	left,
		local	right,
		local	bottom,
		local	top
	)

在一个矩形范围渲染图像

此时z=0.5

Parameters

name	string
left	number
right	number
bottom	number
top	number

◆ RenderSector()

static function RenderSector	(	local	name,
		local	x,
		local	y,
		local	start,
		local	end_,
		local	r1,
		local	r2,
		local	seg
	)

将图像渲染到扇形区域（可用于绘制圆环）

Parameters

name	string
x	number
y	number 圆心位置
start	number 起始角度（角度）
end_	number 终止角度（角度）
r1	number 内圆半径
r2	number 外圆半径
seg	number 每圆周分割段数，默认为60

◆ RenderText() [1/2]

static function RenderText	(	local	fontname,
		local	text,
		local	x,
		local	y,
		local	size,
		local ...
	)

直接渲染文本

fontname：已载入的字体名

text：文本

x,y：对齐点

size：文本缩放

...：文本格式如：'left', 'top'

◆ RenderText() [2/2]

static function RenderText	(	local	name,
		local	text,
		local	x,
		local	y,
		local	scale,
		local	align
	)

使用纹理字体渲染一段文字

name: 纹理名称，text: 字符串，x、y: 坐标，align: 对齐模式

该函数受全局图像缩放系数影响

细节

对齐模式指定渲染中心，对齐模式可取值：

左上 0 中上 1 右上 2

左中 4 中中 5 右中 6

左下 8 中下 9 右下 10

由于使用了新的布局机制，在渲染HGE字体时在横向上会有少许误差，请手动调整

Parameters

name	string
text	string
x	number
y	number
scale	number
align	number

◆ RenderTexture()

static function RenderTexture	(	local	name,
		local	blend,
		local	vertex1,
		local	vertex2,
		local	vertex3,
		local	vertex4
	)

直接渲染纹理。

细节

vertex1~4指定各个顶点坐标，其中必须包含以下项：

[1] = X坐标

[2] = Y坐标

[3] = Z坐标

[4] = U坐标（以纹理大小为区间）

[5] = V坐标（以纹理大小为区间）

[6] = 顶点颜色

注意该函数效率较低，若要使用请考虑缓存顶点所用table

Parameters

name	string
blend	string
vertex1	table
vertex2	table
vertex3	table
vertex4	table

◆ RenderTTF() [1/2]

static function RenderTTF	(	local	name,
		local	text,
		local	left,
		local	right,
		local	bottom,
		local	top,
		local	fmt,
		local	color,
		local	scale
	)

渲染TTF字体

该函数受全局图像缩放系数影响

细节

暂时不支持渲染格式设置

若省略从fmt开始的参数，则值为字体资源设置的值

Parameters

name	string
text	string
left	number
right	number
bottom	number
top	number
fmt	number
color	lstg.Color
scale	number

◆ RenderTTF() [2/2]

static function RenderTTF	(	local	ttfname,
		local	text,
		local	left,
		local	right,
		local	bottom,
		local	top,
		local	color,
		local ...
	)

渲染TTF

Parameters

ttfname	string 字体资源名
text	string 文本
left	number
right	number
bottom	number
top	number 文本区域
color	lstg.Color 文本颜色
scale	number 文本缩放，可省略
...	any 文本格式如：'left', 'top'

包括：left,center,right,top,vcenter,bottom,wordbreak,noclip,paragraph,centerpoints

◆ Reset3D()

static function Reset3D ( )

重置3D变量

◆ ResetPool()

static function ResetPool ( )

清空并回收所有对象

◆ ResumeMusic()

static function ResumeMusic ( local name )

恢复播放音乐

Parameters

name string

◆ ResumeSound()

static function ResumeSound ( local name )

恢复播放音效

Parameters

name string

◆ SampleBezierA1()

static function SampleBezierA1	(	local	list,
		local	count,
		local	length,
		local	rate
	)

◆ SaveScoreData()

static function SaveScoreData ( )

save scoredata to file

◆ scoredata_mt_index()

static function scoredata_mt_index	(	local	t,
		local	k
	)

◆ scoredata_mt_newindex()

static function scoredata_mt_newindex	(	local	t,
		local	k,
		local	v
	)

◆ Screenshot()

static function Screenshot ( )

◆ Serialize()

static function Serialize ( local o )

◆ Set3D()

static function Set3D	(	local	key,
		local	a,
		local	b,
		local	c
	)

设置3D变量

◆ SetAnimationCenter()

static function SetAnimationCenter	(	local	name,
		local	x,
		local	y
	)

类似于SetImageCenter

See also: SetImageCenter

◆ SetAnimationState()

static function SetAnimationState	(	local	name,
		local	blendMode,
		local	color1,
		local	color2,
		local	color3,
		local	color4
	)

类似于SetImageState

See also: SetImageState

◆ SetAttr()

static function SetAttr	(	local	obj,
		local	key,
		local	v
	)

设置对象属性（C++或lua对象的属性）

Parameters

obj	object
key	string
v	any

◆ SetBGMVolume()

static function SetBGMVolume	(	local	arg1,
		local	arg2
	)

传入1个参数时，设置全局音乐音量，将影响后续播放音乐的音量

传入2个参数时，设置指定音乐音量

音量值范围为[0, 1]

Parameters

arg1	number\|string
arg2	number

◆ SetBound()

static function SetBound	(	local	left,
		local	right,
		local	bottom,
		local	top
	)

设置舞台边界

Parameters

left	number
right	number
bottom	number
top	number

◆ SetFog()

static function SetFog	(	local	near,
		local	far,
		local	color
	)

设置雾值

若参数为空，将关闭雾效果。否则设置一个从near到far的雾

Parameters

near	number
far	number
color	lstg.Color 默认为0xFF000000

◆ SetFontState()

static function SetFontState	(	local	name,
		local	blendMode,
		local	color
	)

设置字体的混合模式、颜色

具体混合选项见SetImageState

Parameters

name	string
blendMode	string
color	lstg.Color

◆ SetFPS()

static function SetFPS ( local number )

设置FPS锁定值。默认为60FPS。

Parameters

number number

◆ SetGlobal()

static function SetGlobal	(	local	k,
		local	v
	)

一些游戏中的全局变量

将k,v存入lstg.var

◆ SetImageCenter()

static function SetImageCenter	(	local	name,
		local	x,
		local	y
	)

设置图像中心

Parameters

name	string 图像资源名
x	number
y	number 相对于图像左上角的坐标

◆ SetImageScale()

static function SetImageScale ( local scale )

设置全局图像渲染缩放

Parameters

scale number

◆ SetImageState()

static function SetImageState	(	local	name,
		local	blendMode,
		local	color1,
		local	color2,
		local	color3,
		local	color4
	)

设置图像状态，可选一个颜色参数用于设置所有顶点或者给出4个颜色设置所有顶点。

混合模式可选

"" 默认值，=mul+alpha

"mul+add" 顶点颜色使用乘法，目标混合使用加法

"mul+alpha" (默认)顶点颜色使用乘法，目标混合使用alpha混合

"mul+sub" 顶点颜色使用乘法，结果=图像上的颜色-屏幕上的颜色

"mul+rev" 顶点颜色使用乘法，结果=屏幕上的颜色-图像上的颜色

"add+add" 顶点颜色使用加法，目标混合使用加法

"add+alpha" 顶点颜色使用加法，目标混合使用alpha混合

"add+sub" 顶点颜色使用加法，结果=图像上的颜色-屏幕上的颜色

"add+rev" 顶点颜色使用加法，结果=屏幕上的颜色-图像上的颜色

Parameters

name	string 图像资源名
blendMode	string 混合模式
color1	lstg.Color 混合颜色

◆ SetImgState()

static function SetImgState	(	local	object,
		local	blend,
		local	a,
		local	r,
		local	g,
		local	b
	)

设置资源状态

该函数将会设置和对象绑定的精灵、动画资源的混合模式，该设置对所有同名资源都有效果

Parameters

object	object
blend	string 混合模式
a	number
r	number
g	number
b	number 颜色

◆ SetLastXY()

static function SetLastXY	(	local	object,
		local	x,
		local	y
	)

◆ SetMSAALevel()

static function SetMSAALevel ( local level )

Parameters

level number

Returns: boolean

◆ SetOffscreen()

static function SetOffscreen ( local b )

Parameters

b boolean

◆ SetOnControllerAxisEvent()

static function SetOnControllerAxisEvent ( local f )

Parameters

f	fun(controller:cc.Controller, keyCode:number, value:number, isPressed:boolean, isAnalog:boolean)

◆ SetOnControllerConnect()

static function SetOnControllerConnect ( local f )

Parameters

f	fun(controller:cc.Controller)

◆ SetOnControllerDisconnect()

static function SetOnControllerDisconnect ( local f )

Parameters

f	fun(controller:cc.Controller)

◆ SetOnControllerKeyDown()

static function SetOnControllerKeyDown ( local f )

Parameters

f	fun(controller:cc.Controller, keyCode:number, value:number, isPressed:boolean, isAnalog:boolean)

◆ SetOnControllerKeyUp()

static function SetOnControllerKeyUp ( local f )

Parameters

f	fun(controller:cc.Controller, keyCode:number, value:number, isPressed:boolean, isAnalog:boolean)

◆ SetOnWriteLog()

static function SetOnWriteLog ( local f )

◆ SetOrtho()

static function SetOrtho	(	local	left,
		local	right,
		local	bottom,
		local	top
	)

设置正投影矩阵

创建的正投影矩阵将把z轴限制在[-1024, 1024]区间内

Parameters

left	number
right	number
bottom	number
top	number

◆ SetPerspective()

static function SetPerspective	(	local	eyeX,
		local	eyeY,
		local	eyeZ,
		local	atX,
		local	atY,
		local	atZ,
		local	upX,
		local	upY,
		local	upZ,
		local	fovy,
		local	aspect,
		local	zn,
		local	zf
	)

设置透视投影矩阵

(eyeX,eyeY,eyeZ)表示观察者位置

(atX,atY,atZ)表示观察目标

(upX,upY,upZ)用于表示观察者向上的正方向

fovy描述视角范围（弧度）

aspect描述宽高比

zn和zf描述z轴裁剪距离

Parameters

eyeX	number
eyeY	number
eyeZ	number
atX	number
atY	number
atZ	number
upX	number
upY	number
upZ	number
fovy	number
aspect	number
zn	number
zf	number

◆ SetResLoadInfo()

static function SetResLoadInfo ( local b )

Returns: cc.Map[]; cc.Map 设置是否在资源加载时写出日志

Parameters

b boolean

◆ SetResolution()

static function SetResolution	(	local	width,
		local	height
	)

设置窗口大小

可以在运行时动态设置

Parameters

width	number
height	number

◆ SetResourceStatus()

static function SetResourceStatus ( local poolType )

设置当前激活的资源池类型

Parameters

poolType string stage/global

◆ SetSEVolume()

static function SetSEVolume	(	local	arg1,
		local	arg2
	)

传入1个参数时，设置全局音效音量，将影响后续播放音效的音量

传入2个参数时，设置指定音效音量

音量值范围为[0, 1]

Parameters

arg1	number\|string
arg2	number

◆ SetShaderUniform()

static function SetShaderUniform	(	local	fx,
		local	param
	)

设置shader中的uniform变量

Parameters

fx	string
param	table

◆ SetSplash()

static function SetSplash ( local b )

设置是否显示光标，默认显示

Parameters

b boolean

◆ SetThreadPoolSize()

static function SetThreadPoolSize ( local n )

Parameters

n number

◆ SetTitle()

static function SetTitle ( local title )

设置窗口标题

默认为"LuaSTG-x"

Parameters

title string

◆ SetV()

static function SetV	(	local	obj,
		local	v,
		local	angle,
		local	updateRot
	)

设置速度方向和大小（C++对象）

Parameters

obj	object 要设置的对象
v	number 速度大小
angle	number 速度方向（角度）
updateRot	boolean 是否更新自转，默认为false

◆ SetV2()

static function SetV2	(	local	obj,
		local	v,
		local	angle,
		local	updateRot,
		local	aim
	)

设置对象的速度

Parameters

obj	object 要设置的对象
v	number 速度大小
angle	number 速度方向（角度）
updateRot	boolean 是否更新自转
aim	boolean 方向是否相对自机

◆ SetViewMode()

static function SetViewMode ( local mode )

设置视角模式: 3d world ui

'world': 对应lstrg.world

'ui': 对应screen坐标系

'3d': 对应lstg.view3d

Parameters

mode string

◆ SetViewport()

static function SetViewport	(	local	left,
		local	right,
		local	bottom,
		local	top
	)

设置视口，将影响裁剪和渲染。

Parameters

left	number
right	number
bottom	number
top	number

◆ SetVsync()

static function SetVsync ( local boolean )

设置是否垂直同步。默认为true。

仅限初始化中使用，不允许在运行时动态设置垂直同步。

◆ SetWindowed()

static function SetWindowed ( local b )

该函数未指定窗口化分辨率，请使用ChangeVideoMode

设置窗口化(true)/非窗口化(false)

Parameters

b boolean

Deprecated:

◆ ShowSplashWindow()

static function ShowSplashWindow ( local path )

装载载入窗口。

若图片加载失败或为空则使用内置的图片打开窗口。

目前无作用。

Parameters

path	string @图片路径

Deprecated:

◆ sign()

static function sign ( local x )

返回x的符号（1,-1,0）

◆ sin()

static function sin ( local x )

Parameters

x number

Returns: number

◆ StopMusic()

static function StopMusic ( local name )

停止播放音乐

Parameters

name string

◆ StopSound()

static function StopSound ( local name )

停止播放音效

Parameters

name string

◆ stringify()

static function stringify	(	local	this,
		local	docol,
		local	spacing_h,
		local	spacing_v,
		local	preindent
	)

序列化为字符串

◆ SystemLog()

static function SystemLog ( local str )

向日志文件写入字符串

Parameters

str string

◆ tan()

static function tan ( local x )

Parameters

x number

Returns: number

◆ UnloadPack()

static function UnloadPack ( local path )

卸载指定位置的资源包，要求路径名必须一致

若资源包不存在不发生错误

◆ UpdateParticle()

static function UpdateParticle ( local object )

◆ UpdateXY()

static function UpdateXY ( )

刷新对象的dx,dy,lastx,lasty,rot（若navi==true）属性值

禁止在协程上调用该方法。

◆ UserSystemOperation()

static function UserSystemOperation ( )

◆ visitTable()

static function visitTable ( local t )

◆ WorldToGame()

static function WorldToGame	(	local	x,
		local	y,
		local	flipY
	)

◆ WorldToScreen()

static function WorldToScreen	(	local	x,
		local	y
	)

坐标系变换

计算结果结果并非实际屏幕坐标系，而是screen的坐标系

用于boss扭曲效果时请将结果加上screen.dx和screen.dy

◆ xclass()

static function xclass	(	local	base,
		local	define
	)

Extends [Class] function so that you can use ClassName(...) to create an instance of lstg object.

Example: classname = xclass(object)

See also: object

Parameters

base	object
define	table

Returns: object

◆ XXHash32()

static function XXHash32 ( local data )

Parameters

data any

Returns: number

Member Data Documentation

◆ GOLD

number GOLD = 360 * (math.sqrt(5) - 1) / 2

0.618*360

◆ GROUP_ALL

number GROUP_ALL = 16

◆ GROUP_ENEMY

number GROUP_ENEMY = 2

◆ GROUP_ENEMY_BULLET

number GROUP_ENEMY_BULLET = 1

◆ GROUP_GHOST

number GROUP_GHOST = 0

◆ GROUP_INDES

number GROUP_INDES = 5

◆ GROUP_ITEM

number GROUP_ITEM = 6

◆ GROUP_NONTJT

number GROUP_NONTJT = 7

◆ GROUP_NUM_OF_GROUP

number GROUP_NUM_OF_GROUP = 16

◆ GROUP_PLAYER

number GROUP_PLAYER = 4

◆ GROUP_PLAYER_BULLET

number GROUP_PLAYER_BULLET = 3

◆ LAYER_BG

number LAYER_BG = -700

◆ LAYER_ENEMY

number LAYER_ENEMY = -600

◆ LAYER_ENEMY_BULLET

number LAYER_ENEMY_BULLET = -200

◆ LAYER_ENEMY_BULLET_EF

number LAYER_ENEMY_BULLET_EF = -100

◆ LAYER_ITEM

number LAYER_ITEM = -300

◆ LAYER_PLAYER

number LAYER_PLAYER = -400

◆ LAYER_PLAYER_BULLET

number LAYER_PLAYER_BULLET = -500

◆ LAYER_TOP

number LAYER_TOP = 0

◆ PI

number PI = math.pi

π.

◆ PI_2

number PI_2 = math.pi * 0.5

π/2.

◆ PI_4

number PI_4 = math.pi * 0.25

π/4.

◆ PIx2

number PIx2 = math.pi * 2

π*2.

◆ SQRT2

number SQRT2 = math.sqrt(2)

√2

◆ SQRT2_2

number SQRT2_2 = math.sqrt(0.5)

√2/2

◆ SQRT3

number SQRT3 = math.sqrt(3)

√3

The documentation for this class was generated from the following files:

lstg/constructor.lua.hpp
src/const/const.hpp
lstg/debug.lua.hpp
lstg/frame.lua.hpp
lstg/graph.lua.hpp
lstg/input.lua.hpp
lstg/math.lua.hpp
lstg/object.lua.hpp
lstg/render2d.lua.hpp
luajit/global.lua.hpp
src/api.lua.hpp
src/core/class.lua.hpp
src/core/corefunc.lua.hpp
src/core/file.lua.hpp
src/core/include.lua.hpp
src/core/resources.lua.hpp
src/core/respool.lua.hpp
src/core/score.lua.hpp
src/core/screen.lua.hpp
src/core/status.lua.hpp
src/core/view.lua.hpp
src/core_x/import.lua.hpp
src/core_x/util/xclass.lua.hpp
src/launch.lua.hpp
src/stringify.lua.hpp

Classes

Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ _3DToWorld()

◆ _DoFrame()

◆ _SetBound()

◆ acos()

◆ AfterFrame()

◆ AfterRender()

◆ Angle()

◆ asin()

◆ atan()

◆ atan2()

◆ BeforeRender()

◆ BeginScene()

◆ BentLaserData()

◆ BoundCheck()

◆ BoxCheck()

◆ CacheFile()

◆ CacheFileAsync()

◆ CalcTextSize()

◆ CaptureScreen()

◆ ChangeVideoMode()

◆ CheckRes()

◆ Class()

◆ CollisionCheck()

◆ CollisionCheck3D()

◆ Color()

◆ combinNum()

◆ CopyFrameBuffer()

◆ CopyImage()

◆ cos()

◆ CreateRenderMode()

◆ CreateRenderTarget()

◆ CreateShaderProgramFromPath()

◆ CreateShaderProgramFromString()

◆ DefaultRenderFunc()

◆ DefineDefaultScoreData()

◆ Del() [1/2]

◆ Del() [2/2]

◆ DeSerialize()

◆ Dist()

◆ DoFile()

◆ DoFrame()

◆ DrawCollider()

◆ DrawGroupCollider()

◆ EndScene()

◆ EnumRes()

◆ ExtractRes()

◆ Factorial()

◆ FileTaskAsyncWrapper()

◆ FileTaskWrapper()

◆ FindResAnimation()

◆ FindResFont()

◆ FindResForObject()

◆ FindResFX()

◆ FindResMusic()

◆ FindResource()

◆ FindResourcePackForPath()

◆ FindResParticle()

◆ FindResRenderTarget()

◆ FindResSound()

◆ FindResSprite()

◆ FindResTexture()

◆ FindTexture2D()

◆ FocusGainFunc()

◆ FocusLoseFunc()

◆ FrameEnd()

◆ FrameFunc()

◆ FrameInit()

◆ FrameReset()

◆ FreeObject()

◆ from()

◆ GameExit()

◆ GameInit()

◆ GetAllControllers()

◆ GetAttr()

◆ GetFPS()