동봉된 자료는 2.3.0b 를 가지고 만든 간단한 스크립트 엔진 예제입니다.

1. 엔젤 스크립트에 스크립트를 등록하는 방법.

// C++ code

// Load the script
FILE *f = fopen("myscriptfile.as", "rb");
int length = _filelength(_fileno(f));
char *script = new char[length];
fread(script, length, 1, f);
fclose(f);

// Compile the script
engine->AddScriptSection("module", "section", script, length);
engine->Build("module");

이와 같은 방법으로 스크립트 파일을 엔젤 스크립트에 등록하여 빌드한다
그런데. 여기서 module, section 은 각기 어떤게 들어가야 할지 모르겠다.

2. 엔젤 스크립트의 모듈 사이의 동적 링크

다른 모듈(여기선 스크립트를 나타내냐?)은 다음과 같이 등록한다.
// AngelScript code

// Import a function from another module
import void ImportedFunction() from "OtherModule";

// Call the imported function normally
void Test()
{
  ImportedFunction();
}

OtherModule 에 등록된 ImportedFunction()수를 현 스크립트에서
사용할수 있게 한다? 테스트 해봐야한다.

3. 호스트 어플리케이션(클라이언트)의 함수를 호출하는 방법.

엔젤 스크립트에서 소스의 함수를 호출하기 위해선 다음과 같은 방식으로 한다.

이 c++ 코드는 엔젤 스크립트에 소스에 존재하는 함수를 등록시키는 루틴이다.

// C++ code

#include <stdio.h>
#include <math.h>

void Print(float value);
{
  printf("%g", value);
}

engine->RegisterGlobalFunction("void Print(float)", asFUNCTION(Print), asCALL_CDECL);
engine->RegisterGlobalFunction("float sin(float)", asFUNCTION(sinf), asCALL_CDECL);

이렇게 등록하면 엔젤 스크립트 내부에서 Print() 와 sin() 함수를 사용할수
있다.

실제 사용되는 스크립트를 보면..

// AngelScript code

void DoSomething()
{
  float val = sin(3.141592f);

  Print(val);
}

4. 호스트 어플리케이션(클라이언트)에 등록된 변수에 접근하는 방법.

그리고 글로벌 함수가 아닌 소스안에 존재하는 글로벌 변수를 등록하려면
다음과 같은 방식으로 한다.

// C++ code

int counter = 5;
float time = 0;
engine->RegisterGlobalProperty("int counter", &counter);
engine->RegisterGlobalProperty("const float time", &time);

소스 코드를 보면.. 소스에 존재하는 int 형 counter과 float형 time를
엔젤 스크립트에 등록하는 소스이다.

다음은 엔젤 스크립트 내에서 등록된 변수를 사용하는 방법이다.

// AngelScript code
void DoSomething()
{
  if( time > 1 )
  counter += 2;
  else
  counter++;
}

5. 스크립트 실행.

엔젤 스크립트에 등록된 함수를 호출하기 위해선 2가지 방법이 존재한다.
하나는 ExceuteString() 함수를 이용하는 방법으로 이방법은 쉽게
엔젤 스크립트를 실행할수 있다.

// C++ code

// Execute some simple statements
engine->ExecuteString("module", "DoSomething()");

또다른 하나는 asIScriptContext 를 이용하는 방법으로 사용법이
복잡하다.. 이 asIScriptContext 를 꼭 사용해야 하는 상황이 있는데..

// C++ code

// Do some preparation before execution
asIScriptContext *context = 0;
engine->CreateContext(&context);
int functionID = engine->GetFunctionIDByDecl("module", "void DoSomething()");

// Execute the script function
context->Prepare(functionID);
context->Execute();

// Release the context when finished with it
context->Release();

6. 새로운 형의 클래스를 등록하는 방법.

// C++ code

class CObject
{
public:
  int property;
};

engine->RegisterObjectType("object", sizeof(CObject), asOBJ_CLASS);
engine->RegisterObjectProperty("object", "int property", offsetof(CObject, property));

CObject란 클래스와 object 클래스의 int property 형 변수를 등록합니다.

스크립트 내의 사용법.
// AngelScript code

void DoSomething()
{
  object o;

  o.property = 5;
}

7. 스크립트에 등록된 클래스의 생성자와 소멸자.

예문을 보면 엔젤 스크립트는 클래스가 생성될때 자동으로 생성자 및 소멸자를
호출하지 못한다. 그래서 호출할수 있도록 등록해줘야 한다.

// C++ code
#include <new.h>

class CObject
{
  CObject() {}

  virtual void VFunction() {}
};

위와같이 CObject 클래스가 생성자와 소멸자를 가지고 있을때

void Constructor(CObject *o)
{
  // Call the placement new operator,
  // which in turn will call the constructor
  new(o) CObject();
}

생성자와

void Destructor(CObject &o)
{
  o.~CObject();
}

소멸자의 클래스를 만든다. 그리고 엔젤 스크립트에 등록하면 되는데..

// We must tell AngelScript that the C++ class has a constructor as it affects
// calling conventions. If the class has a defined destructor or assignment 
// operator AngelScript must be told about those as well.
engine->RegisterObjectType("object", sizeof(CObject), asOBJ_CLASS | asOBJ_CLASS_CONSTRUCTOR);

맨마지막 형을 보면 asOBJ_CLASS와 함께 asOBJ_CLASS_CONSTRUCTOR
형이 존재한다.

// Register the constructor function with asCALL_CDECL_OBJLAST
// as AngelScript will call it as if it was a class method
engine->RegisterObjectBehaviour("object", asBEHAVE_CONSTRUCT, "void f()", asFUNCTION(Constructor), asCALL_CDECL_OBJLAST);

engine->RegisterObjectBehaviour("object", asBEHAVE_DESTRUCT, "void f()", asFUNCTION(Destructor), asCALL_CDECL_OBJLAST);

이렇게 생성자와 소멸자의 함수를 등록한다.. 그런데 왜.. void f() 인지?
asFUNCTION 에 Constructor, Destructor 을 등록하는거 보니 이게 호출될
함수명인데.. 등록할때 문자열로 void f() 를 한이유는 그냥 형식을 맞춰주기
위함일까??

// C++ code

CObject &Copy(CObject &other, CObject &self)
{
  // Do the necessary copy operation, that assures that both objects are correctly working afterwards.
  // This is especially necessary if the objects have pointers that shouldn't be shared between them.
  self = other;

  return self;
}

engine->RegisterObjectBehaviour("object", asBEHAVE_ASSIGNMENT, "object &f(object &in)", asFUNCTION(Copy), asCALL_CDECL_OBJLAST);

위의 설명은 다음과 같다.
지연 연산자는 1 인수(전류에 베낀 객체)를 잡습니다.
복사된 전류 객체와 객체 모두는 정확하게 생성자와 초기화되기 위하여 보증됩니다.
만약 지연 연산자가 등록되지 않는다면, 그 다음에 AngelScript는 단순히 바이트를 위해 객체 바이트를 복사합니다.

8. 클래스의 오브젝트 메서드 등록

스크립트의 사용을 위해 전역 기능을 등록하는 것처럼 (3번예문) 클래스의 함수를 등록할수 있다.
// C++ code

float CObject::Sum(float a, float b)
{
  return a + b;
}

engine->RegisterObjectMethod("object", "float Sum(float, float)", asMETHOD(CObject, Sum), asCALL_THISCALL);

사용.
// AngelScript code

void Test()
{
  object o;

  float sum = o.Sum(1.0f, 2.0f);
}

참고.
엔젤 스크립트는 상속된 가상함수를 사용할 수 없다.
가상함수를 사용하기 위해서 따로 오브젝트 메서드를 생성해 사용해야 한다.

// C++ code

class CObject : virtual CVirtualBase
{
  virtual float Sum(float a, float b);
};

float CObject_Sum(float a, float b, CObject &o)
{
  // Call the virtual method
  return o.Sum(a, b);
}

engine->RegisterObjectMethod("object", "float Sum(float, float)", asFUNCTION(CObject_Sum), asCALL_CDECL_OBJLAST);

9. 오퍼레이터 사용.
엔젤 스크립트에서 오퍼레이터를 사용하기 위해선 다음과 같은 작업이 필요하다.

// C++ code

class CVector
{
  float x, y;
};

CVector operator+(CVector &a, CVector &b)
{
  CVector c;
  c.x = a.x + b.x;
  c.y = a.y + b.y;

  return c;
}

engine->RegisterGlobalBehaviour(asBEHAVE_ADD, "vector f(vector &in, vector &in)", asFUNCTIONP(operator+, (CVector &, CVector &)), asCALL_CDECL);

위의 함수는 CVector 의 + 오퍼레이터를 등록한 함수이다.

사용법.
// AngelScript code

void Test()
{
  vector a, vector b;

  vector c = a + b;
}

10. 엔젤 스크립트에서 배열을 사용하기

// C++ code

// Register std::vector<int>
engine->RegisterObjectType("int[]", sizeof(vector<int>), asOBJ_CLASS_CDA);
engine->RegisterObjectBehaviour("int[]", asBEHAVE_CONSTRUCT, "void f()", asFUNCTIONP(ConstructIntArray, (vector<int> *)), asCALL_CDECL_OBJLAST);
engine->RegisterObjectBehaviour("int[]", asBEHAVE_CONSTRUCT, "void f(int)", asFUNCTIONP(ConstructIntArray, (int, vector<int> *)), asCALL_CDECL_OBJLAST);
engine->RegisterObjectBehaviour("int[]", asBEHAVE_DESTRUCT, "void f()", asFUNCTION(DestructIntArray), asCALL_CDECL_OBJLAST);
engine->RegisterObjectBehaviour("int[]", asBEHAVE_ASSIGNMENT, "int[] &f(int[]&in)", asMETHODP(vector<int>, operator=, (const std::vector<int> &)), asCALL_THISCALL);
engine->RegisterObjectBehaviour("int[]", asBEHAVE_INDEX, "int &f(int)", asMETHODP(vector<int>, operator[], (int)), asCALL_THISCALL);
engine->RegisterObjectMethod("int[]", "int length()", asMETHOD(vector<int>, size), asCALL_THISCALL);

// Constructor functions
void ConstructIntArray(vector<int> *self)
{
  new(self) vector<int>();
}

void ConstructIntArray(int length, vector<int> *self)
{
  new(self) vector<int>(length);
}

void DestructIntArray(vector<int> *self)
{
  self->~vector();
}

// AngelScript code

void Test()
{
  int[] a(2);

  a[0] = 123;
  a[1] = a[0];
}

솔직히 이 배열 사용법은 이해가 안간다.
----------------------------------

11. Exception handling

// C++ code

int *ArrayIndex(int n, vector &o)
{
  if( n < 0 || n >= o.size() )
  {
  asIScriptContext *ctx = asGetActiveContext();
  if( ctx )
     ctx->SetException("Out of range");

  return 0;
  }

  return &o.buffer[n];
}

// C++ code

int r = context->Execute();
if( r == asEXECUTION_EXCEPTION )
{
  printf("The script raised an exception. ");
  printf("func: %s ", engine->GetFunctionDeclaration(context->GetExceptionFunction()));
  printf("line: %d ", context->GetExceptionLine());
  printf("desc: %s ", context->GetExceptionString());
}