守望者--AIR技术交流

标题: AS3.h API 文档 [打印本页]
作者: 破晓    时间: 2014-12-30 00:03
标题: AS3.h API 文档
Adobe Flash C++ Compiler (FlasCC)

A complete BSD-like C/C++ development environment with a GCC based cross-compiler capable of targeting the Adobe Flash Runtime.


C/C++ API Reference

AS3.h
Use the macros in the AS3.h header file to inject ActionScript 3 code into your C/C++ code.



FunctionDescription
inline_as3

  1. #define inline_as3(...)
复制代码
The inline_as3 macro correctly restores the global stack pointer and lets you inject arbitrary AS3 code within the body of a C/C++ function. Refer to the FlasCC documentation for examples of how you can use GCC's inline asm syntax for interoperating between C/C++ and AS3.
Parameters:
  • ... - Arbitrary ActionScript code including inline asm.
Example Usage:
See the 02_Interop sample (hellointerop.c)
inline_nonreentrant_as3

  1. #define inline_nonreentrant_as3(...)
复制代码
If your AS3 code doesn't re-enter FlasCC code you can use this. But if it does re-enter FlasCC code (either directly or indirectly via something like CModule.mallocString) then your stack will be smashed. Use inline_as3 unless you are really sure this is what you want!
Parameters:
  • ... - Arbitrary ActionScript code including inline asm.
Example Usage:
See the Example_Lua sample
package_as3

  1. #define package_as3(...)
复制代码
The package_as3 macro lets you inject arbitrary AS3 into the module namespace associated with the current C/C++ translation unit. This is useful for declaring global AS3 variables that you want to reference from inline as3 asm statements within C/C++ functions.
Parameters:
  • ... - Arbitrary ActionScript code including inline asm.
Example Usage:
See the Example_Lua sample
AS3_GoAsync

  1. #define AS3_GoAsync()
复制代码
When breaking a C/C++ run-loop so that FlasCC code is suitable for use without using multi-threading you need to execute main, so the static initializers for your code are run, but you want to prevent the static destructors from running so it is important that main does not return. By throwing an AS3 exception and preserving the stack we can effectively interrupt the execution of main.
Example Usage:
See the 04_Animation sample
AS3_Return

  1. #define AS3_Return(CVAR)
复制代码
Returns a value via an AS3 return. Must be a scalar value.
Parameters:
  • CVAR - A variable in C.
Example Usage:
The code in this example is designed to be compiled into a SWC. See the 05_SWC sample to learn how to compile and run this example.
  1. #include <stdlib.h>
  2. #include "AS3/AS3.h"

  4. void returnPi() __attribute__((used,
  5.         annotate("as3sig:public function returnPi():Number"),
  6.         annotate("as3package:MyLibrary")));

  8. void returnPi(){
  9.     float pi = 3.14159;
  10.     AS3_Return(pi);
  11. }

  13. int main(){
  14.     // See the code comments in samples/05_SWC for more details.
  15.     AS3_GoAsync();
  16. }
复制代码
AS3_ReturnAS3Var

  1. #define AS3_ReturnAS3Var(AS3VAR)
复制代码
Returns an AS3 variable via an AS3 return.
Parameters:
  • AS3VAR - An AS3 variable.
Example Usage:
The code in this example is designed to be compiled into a SWC. See the 05_SWC sample to learn how to compile and run this example.
  1. #include <stdlib.h>
  2. #include "AS3/AS3.h"

  4. void returnString() __attribute__((used,
  5.         annotate("as3sig:public function returnString():String"),
  6.         annotate("as3package:MyLibrary")));

  8. void returnString(){
  9.     char* s = "Hello World";
  10.    
  11.     // We can't just call AS3_Return(s) because s is not a scalar.
  12.     // Instead we need to marshall the C string into AS3 and use
  13.     // AS3_ReturnAS3Var().
  14.    
  15.     AS3_DeclareVar(myString, String);
  16.     AS3_CopyCStringToVar(myString, s, 11);
  17.     AS3_ReturnAS3Var(myString);
  18. }

  20. int main(){
  21.     // See samples/05_SWC for more details.
  22.     AS3_GoAsync();
  23. }
复制代码
AS3_Trace

  1. #define AS3_Trace(STR)
复制代码
Simple wrapper to trace strings to the flash log file, which can be found in one of these locations:
  • Windows 95/98/ME/2000/XP - C:\Documents and Settings\username\Application Data\Macromedia\Flash Player\Logs
  • Windows Vista/Windows 7 - C:\Users\username\AppData\Roaming\Macromedia\Flash Player\Logs
  • Macintosh OS X - /Users/username/Library/Preferences/Macromedia/Flash Player/Logs/
  • Linux - /home/username/.macromedia/Flash_Player/Logs/
Parameters:
  • STR - A string.
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     AS3_Trace("Hello World!");
  5. }
复制代码
AS3_MallocString

  1. #define AS3_MallocString(CVAR, STR)
复制代码
Marshalls an AS3 string into a C char*. This will call malloc behind the scenes so you must free it later.
Parameters:
  • CVAR - A variable in C.
  • STR - An ActionScript string.
Example Usage:
  1. #include <AS3/AS3.h>
  2. #include <stdio.h>

  4. int main() {
  5.     inline_as3("var myString:String = 'hello';\n");
  6.    
  7.     char *str = NULL;
  8.     AS3_MallocString(str, myString);
  9.         
  10.     printf("str=%s", str); // output: str=hello
  11.     free(str); // remember to free
  12. }
复制代码

Also see the 05_SWC sample
AS3_StringLength

  1. #define AS3_StringLength(CVAR, STR)
复制代码
Sets the value of CVAR to the length of the ActionScript string STR.
Parameters:
  • CVAR - A variable in C.
  • STR - A string or an ActionScript variable.
Example Usage:
  1. #include <AS3/AS3.h>
  2. #include <stdio.h>

  4. int main() {
  5.     inline_as3("var myString:String = 'hello';\n");
  6.    
  7.     int strLen = 0;
  8.    
  9.     AS3_StringLength(strLen, myString);
  10.     printf("strLen=%d\n", strLen); // output: 5
  11.    
  12.     AS3_StringLength(strLen, "hello world");
  13.     printf("strLen=%d\n", strLen); // output: 11
  14. }
复制代码
Also see the 05_SWC sample
AS3_DeclareVar

  1. #define AS3_DeclareVar(AS3NAME, AS3TYPE)
复制代码
Declares an AS3 variable in the current function.
Parameters:
  • AS3NAME - Name of the ActionScript variable to declare.
  • AS3TYPE - Type of the ActionScript variable to declare (ex: String).
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     int x = 5;
  5.     // declare an ActionScript variable of type Number
  6.     AS3_DeclareVar(myAS3Number, Number);
  7.     // assign a value to that variable
  8.     AS3_CopyScalarToVar(myAS3Number, x);
  9.     // trace the value
  10.     AS3_Trace("myAS3Number=" + myAS3Number);
  11. }
复制代码
Also see the Example_Lua sample
AS3_CopyCStringToVar

  1. #define AS3_CopyCStringToVar(AS3VAR, CSTRPTR, LEN)
复制代码
Marshalls a C character string into a local AS3 string variable.
Parameters:
  • AS3VAR - ActionScript variable to assign the string value to.
  • CSTRPTR - Pointer to the C character string.
  • LEN - Length of the C character string.
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     char* str = "hello";
  5.    
  6.     AS3_DeclareVar(myString, String);
  7.     AS3_CopyCStringToVar(myString, str, 5);
  8.     AS3_Trace("myString=" + myString);
  9. }
复制代码
Also see the Example_Lua sample
AS3_CopyCharToVar

  1. #define AS3_CopyCharToVar(AS3VAR, CSTRPTR)
复制代码
Marshalls a C character into a local AS3 string variable.
Parameters:
  • AS3VAR - ActionScript variable to assign the character value to.
  • CSTRPTR - Pointer to the C character.
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     char* ch = "A";
  5.    
  6.     AS3_DeclareVar(myString, String);
  7.     AS3_CopyCharToVar(myString, ch);
  8.     AS3_Trace("myString=" + myString);
  9. }
复制代码
AS3_CopyScalarToVar

  1. #define AS3_CopyScalarToVar(AS3VAR, VAL)
复制代码
Copies a scalar C value into a local AS3 variable.
Parameters:
  • AS3VAR - ActionScript variable to assign the scalar to.
  • VAL - A scalar value (ex: int, double, boolean).
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     int x = 5;
  5.     // declare an ActionScript variable of type Number
  6.     AS3_DeclareVar(myAS3Number, Number);
  7.     // assign a value to that variable
  8.     AS3_CopyScalarToVar(myAS3Number, x);
  9.     // trace the value
  10.     AS3_Trace("myAS3Number=" + myAS3Number);
  11. }
复制代码
AS3_GetScalarFromVar

  1. #define AS3_GetScalarFromVar(CVAR, AS3VAR)
复制代码
Copies an AS3 local variable into a local C variable.
Parameters:
  • CVAR - A C variable to copy the value into.
  • AS3VAR - ActionScript variable.
Example Usage:
  1. #include <AS3/AS3.h>
  2. #include <stdio.h>

  4. int main() {
  5.     inline_as3("var myAS3Number:Number = 5");

  7.     int x;
  8.     AS3_GetScalarFromVar(x, myAS3Number);
  9.     printf("x=%d\n", x); // output: x=5
  10. }
复制代码
AS3_GetVarxxFromVar

  1. #define AS3_GetVarxxFromVar(CVARXX, AS3VAR)
复制代码
Copies an AS3 local variable into an AS3::local::var C++ variable.
Parameters:
  • CVARXX - An AS3::local::var object.
  • AS3VAR - ActionScript variable.
Example Usage:
  1. #include <AS3/AS3.h>
  2. #include <AS3/AS3++.h>

  4. int main() {
  5.     inline_as3("var myString = 'hello';");
  6.    
  7.     AS3::local::var cVar;
  8.     AS3_GetVarxxFromVar(cVar, myString);
  9.    
  10.     char* str = AS3::local::internal::utf8_toString(cVar);
  11.     printf("cVar=%s\n", str); // output: cVar=hello
  12.     free(str);
  13. }
复制代码
AS3_CopyVarxxToVar

  1. #define AS3_CopyVarxxToVar(AS3VAR, CVARXX)
复制代码
Copies an AS3::local::var C++ variable into an AS3 local variable.
Parameters:
  • AS3VAR - ActionScript variable.
  • CVARXX - An AS3::local::var object.
Example Usage:
  1. #include <AS3/AS3.h>
  2. #include <AS3/AS3++.h>

  4. int main() {   
  5.     inline_as3("var myString:String = 'hello';");
  6.     AS3_Trace(myString); // output: hello
  7.    
  8.     AS3::local::var cVar = AS3::local::internal::new_String("world");
  9.     AS3_CopyVarxxToVar(myString, cVar);
  10.     AS3_Trace(myString); // output: world
  11. }
复制代码
AS3_SendMetricString

  1. void AS3_SendMetricString(const char* metric, const char *value);
复制代码
Sends a metric to Adobe Scout with a string value. The metric will show up in the metric summary panel for the frame it was sent in.
Parameters:
  • metric - C character string representing the metric name.
  • value - C character string representing the metric value.
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     char* status = "success";
  5.     AS3_SendMetricString("my.metric.complete", status);
  6. }
复制代码
AS3_SendMetricInt

  1. void AS3_SendMetricInt(const char* metric, int value);
复制代码
Sends a metric to Adobe Scout with an integer value. The metric will show up in the metric summary panel for the frame it was sent in.
Parameters:
  • metric - C character string representing the metric name.
  • value - An integer value.
Example Usage:
  1. #include <AS3/AS3.h>

  3. int main() {
  4.     int result = 5;
  5.     AS3_SendMetricInt("my.metric.complete", result);
  6. }
复制代码
Also see the Example_Quake sample


相关链接：

作者: 破晓    时间: 2014-12-30 00:15
谁有能力翻译一下
作者: 我是一个兵    时间: 2015-1-11 14:56
果断收藏...



欢迎光临 守望者--AIR技术交流 (http://www.airmyth.com/)