AS3与C/C++的交互

AS3与C/C++的交互

?

(以官方网站的文档内容为准)

?

原文见:

http://labs.adobe.com/wiki/index.php/Alchemy:Documentation:Developing_with_Alchemy:C_API

http://labs.adobe.com/wiki/index.php/Alchemy:Documentation:Developing_with_Alchemy:AS3_API

?

1 Alchemy C/C++ API

1.1 Managing ActionScript objects:管理ActionScript对象

1.1.1 AS3_Val:AS3值对象

1.1.2 void AS3_Acquire(AS3_Val obj):增加obj的引用计数

1.1.3 void AS3_Release(AS3_Val obj):减小obj的引用计数

1.1.4 AS3_Val AS3_New(AS3_Val constr, AS3_Val params):

把constr构造函数(用AS3_NSGet获取)应用到非null(可以是空的)的Array型变量params上。

1.1.5 AS3_Malloced_Str AS3_TypeOf(AS3_Val obj):

获取obj的类型的malloc字符串(返回值需要free)

1.1.6 int AS3_InstanceOf(AS3_Val val, AS3_Val type):

判断val是否属于type(用NSGet获取)类型,如果是返回非0,否返回0。

1.1.7 AS3_Val AS3_NSGet(AS3_Val ns, AS3_Val prop):

运行时通过ns(AS3_String,例如"flash.utils")

和prop(AS3_String,例如"ByteArray")查找类。

1.1.8 AS3_Val AS3_NSGetS(AS3_Val ns, const char *prop):

同AS3_NSGet,只不过prop是C风格常数值,不需要AS3_Release。

1.2 Converting C/C++ Values to ActionScript objects

C/C++到AS的值转换。

1.2.1 AS3_Val AS3_String(const char* str):

const char[](C风格)转String,需要AS3_Release释放。

1.2.2 AS3_Val AS3_StringN(const char* str, int len):

void *转String,需要AS3_Release释放。

1.2.3 AS3_Val AS3_Int(int):

int转AS3的int,需要AS3_Release释放。

1.2.4 AS3_Val AS3_Ptr(void* ptr):

void *转ByteArray(用uint读写),需要AS3_Release释放。

1.2.5 AS3_Val AS3_Number(double d):

double转Number,需要AS3_Release释放。

1.2.6 AS3_Val AS3_True():

获取true,需要AS3_Release释放。

1.2.7 AS3_Val AS3_False():

获取false,需要AS3_Release释放。

1.2.8 AS3_Val AS3_Null():

获取null,无需释放。

1.2.9 AS3_Val AS3_Undefined()

获取undefined,无需释放。

1.2.10 AS3_Val AS3_Array(const char *tt, ...):

printf风格的Array构造式,例如:

AS3_Val point = AS3_Array("IntType, IntType", x, y);

支持"IntType"(int),"PtrType"(void*),

"DoubleType"(double),"StrType"(char *),

"AS3ValType"(AS3_Val)。

需要AS3_Release释放。

1.2.11 AS3_Val AS3_Object(const char *tt, ...)

同上,但是构造Object对象,需要AS3_Release释放。

1.3 Converting ActionScript objects to C/C++ Values

AS3到C/C++的值转换

1.3.1 AS3_Malloced_Str AS3_StringValue(AS3_Val obj)

String转char[](malloc,需要free)

1.3.2 int AS3_IntValue(AS3_Val obj)

AS3的int转int。

1.3.3 void* AS3_PtrValue(AS3_Val obj)

Object转void *。

1.3.4 double AS3_NumberValue(AS3_Val obj)

Number转double。

1.3.5 void AS3_ArrayValue(AS3_Val arr, const char *tt, ...)

scanf风格的Array分解。例如:

int arg0 = 0;

char* arg1 = NULL;

double arg2 = 0.0;

AS3_ArrayValue(arr, "IntType, StrType, DoubleType", &arg0, &arg1, &arg2)

1.3.6 void AS3_ObjectValue(AS3_Val arr, const char *tt, ...)

同上,但是对Object的分解

1.4 Calling ActionScript methods from C/C++

从C/C++中调用AS3方法

1.4.1 AS3_Val AS3_Get(AS3_Val obj, AS3_Val prop)

对obj执行prop(例如AS3_String("length"))的属性读取,

1.4.2 AS3_Val AS3_GetS(AS3_Val obj, const char *prop)

同AS3_Get,不过prop是C风格常数字符串,不需要AS3_Release。

1.4.3 AS3_Val AS3_Set(AS3_Val obj, AS3_Val prop, AS3_Val val)

对obj的prop执行属性设置,值为val。

1.4.4 AS3_Val AS3_SetS(AS3_Val obj, const char *prop, AS3_Val val)

同AS3_Set,不过prop是C风格常数字符串,不需要AS3_Release。

1.4.5 AS3_Val AS3_Call(AS3_Val func, AS3_Val thiz, AS3_Val params)

对thiz(如果是AS3_Undefined()则为顶级调用)

执行func(可以是NSGet/NSGetS的名字空间(常规函数)或Get/GetS的对象(闭包))

函数调用,传入Array型的params(例如AS3_Array("IntType", strlen(buf)))作为参数。

1.4.6 AS3_Val AS3_CallS(const char *func, AS3_Val thiz, AS3_Val params)

同AS3_Call,不过func是C风格常数字符串,不需要AS3_Release。

1.4.7 AS3_Val AS3_CallT(AS3_Val func, AS3_Val thiz, const char *tt, ...)

同AS3_Call,不过params换成变长参数tt。

1.4.8 AS3_Val AS3_CallTS(const char *func, AS3_Val thiz, const char *tt, ...)

同AS3_CallS,不过params换成变长参数tt。

1.4.9 void *AS3_Shim(AS3_Val func, AS3_Val thiz, const char *rt, const char *tt, int varargs)

获取永久的函数指针,但实际上没有调用它(就像AS3的闭包)。例如:

int (*myfunc)(const char *s, double n) =?

AS3_Shim(someFunc, someThiz, "IntType, StrType, NumberType", false);

1.4.10 AS3_Val AS3_Proxy()

创建AS3的Proxy对象,以代理flash_delegate名字空间下的函数

例如flash_delegate::callProperty而非public::callProperty

(注:这里怀疑是用来针对Proxy派生类对象的属性和方法访问,

因为用flash_delegate限定而非public限定,所以需要单独处理)

1.5 Calling C/C++ methods from ActionScript methods

从AS3中调用C/C++方法

1.5.1 AS3_ThunkProc

用typedef定义回调函数的一般形式。

typedef AS3_Val (*AS3_ThunkProc)(void *data, AS3_Val params);

1.5.2 AS3_Val AS3_Function(void *data, AS3_ThunkProc proc)

注册同步回调函数proc,data是用户数据,作为第一参数传给proc的第一参数。

1.5.3 AS3_Val AS3_FunctionAsync(void *data, AS3_ThunkProc proc)

注册异步回调函数proc,data是用户数据,作为第一参数传给proc的第一参数。

1.5.4 AS3_Val AS3_FunctionT(void *data, void *proc, const char *rt, const char *tt, int varargs):

同AS3_Function,不过proc的参数表是不规则的(不同于AS3_ThunkProc)

1.5.5 AS3_Val AS3_FunctionAsyncT(void *data, void *proc, const char *rt, const char *tt, int varargs):

同AS3_FunctionAsync,不过proc的参数表是不规则的(不同于AS3_ThunkProc)

1.6 Miscellaneous

杂项

1.6.1 void AS3_LibInit(AS3_Val libData)

初始化用户定义的libData库对象,永不返回的函数。

1.6.2 AS3_Val AS3_Stage()

获取运行时舞台对象(例如ConSprite),然后操作它。

1.6.3 AS3_Val AS3_Ram()

获取存放C程序中使用的所有RAM的ByteArray变量。

1.6.4 void flyield()

放弃当前时间分片,在下次时间分片时返回以继续下面的语句。

1.6.5 void sztrace(char* msg)

用FlexBuilder的话相当于trace(),用swfbridge的话则相当于STDOUT输出。

1.6.6 void AS3_Trace(AS3_Val val)

同sztrace,不过参数是需要AS3_Release的String值

1.6.7 int AS3_ByteArray_readBytes(void *dst, AS3_Val src, int len)

从ByteArray型的src中读取len长度的字节到dst中

1.6.8 int AS3_ByteArray_writeBytes(AS3_Val dst, void *src, int len)

把len字节长度的src写入ByteArray型的dst中。

1.6.9 int AS3_ByteArray_seek(AS3_Val dst, int offs, int whence)

调整ByteArray型dst的游标位置,类似lseek的用法。

-----------------------------

Alchemy:Documentation:Developing with Alchemy:AS3 API

1 Manipulating the Alchemy state machine

操作Alchemy状态机

1.1 CLibInit

CLibInit用于暴露C代码给AS3使用。

init():*:?

初始化,返回导出C函数(一般名称和C函数是相同的)的对象。

setSprite(sprite:Sprite):void:?

设置一个Sprite对象给Alchemy,Alchemy会创建一个TextField然后把STDOUT, STDERR输出内容输出到这个文本域上。

也用于STDIN。

putEnv(key:String, value:String:?

设置环境变量,供C代码的getenv()读取

supplyFile(path:String, data:ByteArray):?

提供文件系统。以避免运行时由于安全限制而无法访问的情况。

gstate:

全局变量,保存Alchemy的状态机。

1.2 GLEByteArrayProvider

这个类允许直接访问C库的RAM(如同操作ByteArray型变量)

get:?

返回当前的领域内存,不存在的话开辟数字低位在前(little endian)的新RAM。

1.3 MemUser

直接操作C库的RAM,以addr偏移的形式访问(如同C代码一样)。

读取RAM:

_mr32(addr:int):int: 32位整型

_mru16(addr:int):int: 16位无符号整型

_mrs16(addr:int):int: 16位有符号整型

_mru8(addr:int):int: 8位无符号整型

_mrs8(addr:int):int: 16位有符号整型

_mrf(addr:int):Number: 浮点型

_mrd(addr:int):Number: 双精度

写入RAM:

_mw32(addr:int, val:int):void: 32位整型

_mw16(addr:int, val:int):void: 16位整型

_mw8(addr:int, val:int):void: 8位整型

_mwf(addr:int, val:Number):void: 浮点型

_mwd(addr:int, val:Number):void: 双精型

2 Calling Functions Exported from C

在AS3中调用C导出函数

在flash工程加入swc库

导入名字空间

import cmodule.;

创建CLibInit实例

调用init()

例如:

import cmodule.example.CLibInit;

const libInitializer:CLibInit = new CLibInit();

const lib:Object = libInitializer.init();

lib.myExportedFunc("param1", 1234);

文档中没提到的其它非用户导出函数最好不要调用。

?

转载于:https://www.cnblogs.com/176170847/archive/2011/01/27/1946214.html

你可能感兴趣的:(AS3与C/C++的交互)