com.ansca.corona

类 CoronaLua

java.lang.Object

com.ansca.corona.CoronaLua

public class CoronaLua
extends Object

提供一组用于 LuaState 的便捷函数。

您应该在 CoronaRuntimeTask 内部调用这些方法，以确保对 LuaState 的修改发生在 Corona 线程上。

字段概要

字段

修饰符和类型	字段和描述
静态 int	NOREF 用于将引用标记为无效。
静态 int	REFNIL 当在 nil 值上调用 LuaState.ref(int) 时返回。

构造器概要

构造器

构造器和描述
CoronaLua()

方法概要

方法

修饰符和类型	方法和描述
静态 void	deleteRef(LuaState L, int ref) 释放对 Lua 值的 Java 端引用，否则将阻止 Lua 值被垃圾回收。
静态 void	dispatchEvent(LuaState L, int listenerRef, int nresults) 通过调用与listenerRef对应的侦听器来分派一个 事件，并将栈顶的值作为 Corona 事件表传递。
静态 void	dispatchRuntimeEvent(LuaState L, int nResults) 将 lua 栈 顶部的 事件 分派给全局 Runtime 对象。
静态 boolean	isListener(LuaState L, int index, String eventName) 返回位于index处的函数是否为 Corona 侦听器。
静态 void	newEvent(LuaState L, String eventName) 创建一个 Corona 事件，并将name属性设置为eventName.
静态 int	newRef(LuaState L, int index) 在 Lua 栈 的index.
静态 int	normalize(LuaState L, int index) 返回 Lua 栈 上传递的index.
静态 void	pushHashtable(LuaState L, Hashtable<Object,Object> hashtable) 将一个包含 Hashtable 中值的 lua 表 推送到 lua 栈 的顶部。
静态 void	pushValue(LuaState L, Object object) 将 Object 推送到 lua 栈 的顶部。
静态 Hashtable<Object,Object>	toHashtable(LuaState L, int index) 从 lua 栈 上指定索引处的 lua 表 创建一个 Hashtable。
静态 Object	toValue(LuaState L, int index) 返回指定索引处项的 Object。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

REFNIL

public static final int REFNIL

当在 nil 值上调用 LuaState.ref(int) 时返回。

另请参阅

常量字段值

NOREF

public static final int NOREF

用于将引用标记为无效。

添加于 每日构建版本 2013.1227.

另请参阅

常量字段值

构造器详细信息

CoronaLua

public CoronaLua()

方法详细信息

normalize

public static int normalize(LuaState L,
            int index)

返回 Lua 栈 上传递的index。如果您有负栈索引，这将非常有用，因为它们是相对于 栈 顶部的。

参数

L - 要操作的 LuaState。

index - lua 栈 上我们想要规范化值的索引。

返回

Lua 栈上传递的index.

newRef

public static int newRef(LuaState L,
         int index)

在 Lua 栈 的index的绝对索引位置。您可以使用它从原生 Java 代码存储和访问 Lua 对象。通常，当您想要存储对 Lua 侦听器 的引用时，可以使用它。

参数

L - 要操作的 LuaState。

index - lua 栈 上保存我们想要 Java 端引用的对象的索引。

返回

返回一个引用标识符。

deleteRef

public static void deleteRef(LuaState L,
             int ref)

释放对 Lua 值的 Java 端引用，否则将阻止 Lua 值被垃圾回收。

参数

L - 要操作的 LuaState。

ref - 要释放的 Java 端引用。

newEvent

public static void newEvent(LuaState L,
            String eventName)

创建一个 Corona 事件，并将name属性设置为eventName.

此函数将创建的事件表*推送到* Lua 栈 的顶部！

参数

L - 要操作的 LuaState。

eventName - 要分配给此 Corona 事件 的名称。

dispatchEvent

public static void dispatchEvent(LuaState L,
                 int listenerRef,
                 int nresults)
                          throws Exception

通过调用与listenerRef并将栈顶的值作为 Corona 事件表传递。您应该使用 newEvent() 来创建此事件。

此函数将从 Lua 栈 的顶部*弹出*值！

参数

L - 要操作的 LuaState。

listenerRef - CoronaLua.newRef() 返回的引用标识符。

nresults - 要分派给 事件 的结果数。

抛出

异常

isListener

public static boolean isListener(LuaState L,
                 int index,
                 String eventName)

返回位于index处的函数是否为 Corona 侦听器。

参数

L - 要操作的 LuaState。

index - lua 栈 上保存相关函数的索引。

eventName -位于index.

toValue

public static Object toValue(LuaState L,
             int index)

处的函数的名称。返回指定索引处项的 Object。支持 Lua 字符串、数字、布尔值 和 表。

添加于 每日构建版本 2014.2125.

参数

L - 对象所在的 LuaState。

index - 对象所在的 lua 栈 上的索引。

返回

一个 Object，其值为 lua 栈 上指定索引处的 lua 对象的值。

toHashtable

public static Hashtable<Object,Object> toHashtable(LuaState L,
                                   int index)

从 lua 栈 上指定索引处的 lua 表 创建一个 Hashtable。

添加于 每日构建版本 2014.2125.

参数

L - 表 所在的 LuaState。

index - lua 表 所在的 lua 栈 上的索引。

返回

一个包含 lua 表 值的 Hashtable。

pushValue

public static void pushValue(LuaState L,
             Object object)

将 Object 推送到 lua 栈 的顶部。支持 String、Integer、Double、Boolean 和 Hashtable 对象。

此函数将所需对象*推送到* Lua 栈 的顶部！

添加于 每日构建版本 2014.2125.

参数

L - 要操作的 LuaState。

object - 要推送到 lua 栈 顶部的 Object。

pushHashtable

public static void pushHashtable(LuaState L,
                 Hashtable<Object,Object> hashtable)

将一个包含 Hashtable 中值的 lua 表 推送到 lua 栈 的顶部。

此函数将一个 lua 表 *推送到* Lua 栈 的顶部！

添加于 每日构建版本 2014.2125.

参数

L - 应该将 表 推送到其中的 LuaState。

hashtable - 包含要作为 Lua 表 推送到 Lua 栈 的值的 Hashtable。

分发运行时事件（dispatchRuntimeEvent）

public static void dispatchRuntimeEvent(LuaState L,
                        int nResults)

将 lua 栈 顶部的 事件 分派给全局 Runtime 对象。

添加于 每日构建版本 2014.2125.

参数

L - 运行时（Runtime） 对象的 LuaState。

nResults - Lua 方面返回的结果数量。