VCVRack
/
Rack
mirror of https://github.com/VCVRack/Rack.git
1
0
Fork 0
Code Issues 0 Releases 43 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1107 Commits
4 Branches
540MB
Tree: 8dfecaa7d6
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '8dfecaa7d6'
${ noResults }
Rack/dep/yac/yac.h

2470 lines
126KB
Raw Blame History 

  1. /// ----

  2. /// ---- file   : yac.h

  3. /// ----

  4. /// ---- author : (c) 2003 - 2018 by bsp

  5. /// ----

  6. /// ---- date   : 21-Nov-2003 /  8-Jun-2003 /  1-Aug-2003 / 24-Dec-2003 / 15-Jan-2004 /  9-Feb-2004 /

  7. /// ----          17-Feb-2004 / 19-Feb-2004 / 28-Feb-2004 / 26-Mar-2004 / 27-Mar-2004 / 19-Sep-2004 /

  8. /// ----          05-Nov-2004 / 06-Nov-2004 / 26-Dec-2004 /  9-Jan-2005 / 16-Jan-2005 / 05-Feb-2005 /

  9. /// ----          14-Feb-2005 / 24-Feb-2005 / 27-Feb-2005 / 12-Mar-2005 / 13-Jun-2005 / 16-Jun-2005

  10. /// ----          27-Jun-2005 / 22-Aug-2005 / 27-Aug-2005 / 05-Sep-2005 / 11-Sep-2005 / 28-Nov-2005

  11. /// ----          13-Jan-2006 / 14-Jan-2006 / 04-Feb-2006 / 07-Feb-2006 / 25-Apr-2006 / 13-Mai-2006

  12. /// ----          19-Jan-2008 / 31-Jan-2008 / 01-Feb-2008 / 04-Feb-2008 / 11-Feb-2008 / 18-Feb-2008

  13. /// ----          24-Feb-2008 / 25-Feb-2008 / 28-Feb-2008 / 05-Mar-2008 / 22-Mar-2008 / 14-Sep-2008

  14. /// ----          08-Jan-2009 / 10-Jan-2009 / 31-Jan-2009 / 05-Mar-2009 / 01-Apr-2009 / 03-Apr-2009

  15. /// ----          17-Apr-2009 / 28-Apr-2009 / 04-May-2009 / 01-Jun-2009 / 22-Apr-2010 / 11-Jul-2010

  16. /// ----          25-Sep-2010 / 01-Oct-2010 / 21-Apr-2011 / 21-Dec-2012 / 04-Jun-2013 / 13-Aug-2013

  17. /// ----          24-Aug-2013 / 05-Feb-2014 / 11-Feb-2014 / 03-Mar-2014 / 07-Apr-2018 / 26-Jun-2018

  18. /// ----

  19. /// ---- info   : YAC - Yet Another Component object model.  YAC is a self contained, binary level

  20. /// ----          C++ component/reflectance model and plugin SDK.

  21. /// ----          YAC is accompanied by YInG- the YAC interface generator.

  22. /// ----          YInG and YAC can be used to e.g. extend the TKScript language by new ADTs. 

  23. /// ----          

  24. /// ----          The YAC_Object and YAC_Host classes basically define a virtual table

  25. /// ----          setup that has to be used on both host and plugin sides.

  26. /// ----          

  27. /// ----          By deriving an extension class from the YAC_Object class, the extension

  28. /// ----          class inherits the YAC_Object virtual table and can now overwrite 

  29. /// ----          vtable entries (e.g. by declaring a yacMethodGetAdr() method) so

  30. /// ----          when the plugin host calls this vtable entry the yacMethodGetAdr() method

  31. /// ----          of your extension class is actually called (instead of the 'stub' included

  32. /// ----          in this header file)

  33. /// ----

  34. /// ----          Vice versa, the YAC_Host interface can be used to implement a new application

  35. /// ----          host that handles the registration/instanciation of new YAC_Object classes.

  36. /// ----          Usually, the TKScript engine takes care of this but you are free to implement

  37. /// ----          your own plugin hosts (e.g. for testing/debugging new libraries).

  38. /// ----

  39. /// ---- ack    : thanks to Chaos^fr for his s* datatypes, limits, 

  40. /// ----          sABS- macros and vector/matrix classes (included with the tkoldmath plugin).

  41. /// ----

  42. /// ---- license: MIT. See LICENSE.txt.

  43. /// ---- 

  44. /// ----

  45. 

  46. #ifndef __YAC_H__

  47. #define __YAC_H__

  48. 

  49. #include <stdio.h>

  50. #include <string.h>

  51. #include <stdarg.h>

  52. 

  53. /// Define in the project/makefile to disable the use of thread local storage

  54. /* #define YAC_FORCE_NO_TLS defined */

  55. 

  56. // ----

  57. // ---- Version number

  58. // ----

  59. #define YAC_VERSION_MAJOR 916

  60. #define YAC_VERSION_MINOR 2

  61. 

  62. // ----

  63. // ---- Configuration

  64. // ----

  65. #ifndef YAC_PRINTF

  66. /// ---- Define if you want a YAC_Host::printf() tool function

  67. #define YAC_PRINTF defined

  68. #endif

  69. 

  70. /// ---- Define if you want printf(), append(),... methods in the YAC_String class

  71. #ifndef YAC_BIGSTRING

  72. #define YAC_BIGSTRING defined

  73. #endif // YAC_BIGSTRING

  74. 

  75. /// ---- Adds validation tag to YAC_Object class (yac_host must support this, too!!). 

  76. /// ---- This makes it possible to detect double-free'd objects, not only zero-pointers.

  77. #define YAC_OBJECT_TAGS defined 

  78. 

  79. /// ---- Adds static object_counter field to YAC_Object class

  80. #define YAC_OBJECT_COUNTER defined

  81. 

  82. /// ---- Adds YAC interface to the YAC_Object class

  83. #define YAC_OBJECT_YAC defined 

  84. 

  85. /// ---- Define to enable object pooling

  86. #define YAC_OBJECT_POOL defined

  87. 

  88. /// ---- Define to use placement new to initialize pooled objects. If not defined, copy vtable* and call constructors. 

  89. /// ---- Note: GCC does not allow C::C() so keep this defined if you use GCC!

  90. #define YAC_PLACEMENT_NEW defined

  91. 

  92. /// ---- Define to use a custom global new/delete replacement

  93. /// ---- This is mainly useful for debugging memory allocations.

  94. /// ---- The global var "yac_global_newdelete_counter" tracks the total number of bytes currently allocated via

  95. /// ---- the global new/delete operators. This also includes the total size of all ObjectPools, regardless of how many

  96. /// ---- pool elements are actually in use. The counter also includes all memory allocated/freed in a plugin via new/delete.

  97. /// ---- Please make sure that your plugin does not call new/delete before YAC_Init() has been called and the

  98. /// ---- yac_host variable has been set.

  99. /// ---- Please re-compile all plugins plus the YAC_Host if you change this setting.

  100. /// ---- There might be issues with new/delete being called before yac_host is set so be careful.

  101. //#define YAC_GLOBAL_NEWDELETE defined

  102. 

  103. /// ---- Define to define Dflt*_abs and Ddbl*_abs macros, helpful to epsilon compare float/double values

  104. /// ---- Please define this in your plugin sources if you need it

  105. //#define YAC_EPSILONCOMPARE_ABS defined

  106. 

  107. /// ---- Define to use absolute epsilon float comparisons by default (also requires YAC_EPSILONCOMPARE_ABS)

  108. /// ---- Note: Only one of YAC_EPSILONCOMPARE_ABS_DEFAULT and YAC_EPSILONCOMPARE_REL_DEFAULT may be enabled

  109. //#define YAC_EPSILONCOMPARE_ABS_DEFAULT defined

  110. 

  111. /// ---- Define to define Dflt*_rel and Ddbl*_rel macros, helpful to epsilon compare float/double values

  112. //#define YAC_EPSILONCOMPARE_REL defined

  113. 

  114. /// ---- Define to use relative epsilon float comparisons by default (also requires YAC_EPSILONCOMPARE_REL)

  115. //#define YAC_EPSILONCOMPARE_REL_DEFAULT defined

  116. 

  117. 

  118. /// ---- Define to give YAC_TypeS, YAC_ValueS a vtable

  119. /// ---- This is used to satisfy the Intel C++ compiler, i.e. to get no warnings 

  120. /// ---- when classes with virtual methods are derived from this class/YAC_Value)

  121. /// ---- If you change this define, make sure to recompile the host and all plugins

  122. /// ---- since the member offsets will shift.

  123. //#define YAC_VIRTUAL_VALUE defined 

  124. 

  125. //

  126. //#define YAC_NO_EXPORTS defined 

  127. //

  128. /// ---- Define if you want to re-implement the YAC_Object YAC interface (custom YAC_Hosts)

  129. //#define YAC_CUST_OBJECT defined 

  130. //#define YAC_CUST_STRING defined        // define to skip declaration of the YAC_String and YAC_StringArray class.

  131. //#define YAC_CUST_EVENT defined         // define to skip declaration of the YAC_Event class.

  132. //#define YAC_CUST_VALUE defined         // define to skip declaration of the YAC_Value, 

  133.                                          // YAC_ValueObject and YAC_ValueArray classes.

  134. //#define YAC_CUST_NUMBEROBJECTS defined // define to skip the declaration of the YAC_Integer, YAC_Float, YAC_Byte... classes

  135. //#define YAC_CUST_LISTNODE defined      // define to skip declaration of the YAC_ListNode class.

  136. //#define YAC_CUST_TREENODE defined      // define to skip declaration of the YAC_TreeNode class.

  137. //#define YAC_CUST_STREAMBASE defined    // define to skip declaration of the YAC_StreamBase class.

  138. //#define YAC_CUST_BUFFER defined        // define to skip declaration of the YAC_Buffer class.

  139. //#define YAC_CUST_INTARRAY defined      // define to skip declaration of the YAC_IntArray class.

  140. //#define YAC_CUST_FLOATARRAY defined    // define to skip declaration of the YAC_FloatArray class.

  141. 

  142. //#define YAC_TRACK_CHARALLOC defined    // define to keep track of total amount of allocated string chars

  143. 

  144. // ----

  145. // ----

  146. // ---- capability flags for an object class ----

  147. // ----

  148. // ----

  149. typedef enum __yac_interfaces {

  150.    YAC_INTERFACE_REFLECTION    = (1<<0),

  151.    YAC_INTERFACE_OPERATOR      = (1<<1),

  152.    YAC_INTERFACE_STREAM        = (1<<2),

  153.    YAC_INTERFACE_SERIALIZATION = (1<<3),

  154.    YAC_INTERFACE_ITERATOR      = (1<<4),

  155.    YAC_INTERFACE_ARRAY         = (1<<5),

  156.    YAC_INTERFACE_METACLASS     = (1<<6),

  157.    YAC_INTERFACE_SIGNALS       = (1<<7),

  158.    YAC_INTERFACE_ALL           =  0xFF

  159. 

  160. } e_yac_interfaces;

  161. // ----

  162. // ----

  163. // ---- capability flags for the application host ----

  164. // ----

  165. // ----

  166. typedef enum __yac_host_interfaces {

  167.    YAC_HOST_INTERFACE_REFLECTION   = (1<<0),

  168.    YAC_HOST_INTERFACE_DEBUG        = (1<<1),

  169.    YAC_HOST_INTERFACE_STRING       = (1<<2),

  170.    YAC_HOST_INTERFACE_SCRIPTING    = (1<<3),

  171.    YAC_HOST_INTERFACE_EVENT        = (1<<4),

  172.    YAC_HOST_INTERFACE_EXCEPTION    = (1<<5),

  173.    YAC_HOST_INTERFACE_CALLBACK     = (1<<6),

  174.    YAC_HOST_INTERFACE_MUTEX        = (1<<7),

  175.    YAC_HOST_INTERFACE_ALL          =  0xFF

  176. } e_yac_host_interfaces;

  177. // ----

  178. // ----

  179. // ---- OS detection 

  180. // ----

  181. // ----

  182. 

  183. // ---- Linux ?

  184. #ifdef __linux__

  185. #ifndef YAC_LINUX

  186.   #define YAC_LINUX defined

  187. #endif // YAC_LINUX

  188.   #define YAC_POSIX defined

  189.   #define YAC_OSNAME "linux"

  190. #endif

  191. // ---- Amiga OS ?

  192. #ifdef AMIGA

  193. #ifndef YAC_AMIGA

  194.   #define YAC_AMIGA defined

  195. #endif // YAC_AMIGA

  196.   #define YAC_OSNAME "c= amiga"

  197. #endif

  198. // ---- QNX ?

  199. #if defined(__QNXNTO__)

  200. #ifndef YAC_QNX

  201.   #define YAC_QNX defined

  202. #endif // YAC_QNX

  203.   #define YAC_OSNAME "qnx"

  204.   #define YAC_POSIX defined

  205. #endif

  206. // ---- OS/2 ?

  207. #ifdef OS2

  208. #ifndef YAC_OS2

  209.   #define YAC_OS2 defined

  210. #endif // YAC_OS2

  211.   #define YAC_OSNAME "os/2"

  212. #endif

  213. // ---- Win32 ?

  214. #ifdef _WIN32

  215. #ifndef WIN32

  216. #define WIN32

  217. #endif

  218. #endif

  219. #ifdef WIN32

  220. #ifndef YAC_WIN32

  221.   #define YAC_WIN32 defined

  222. #endif // YAC_WIN32

  223.   #define YAC_OSNAME "win32"

  224. #ifdef _MSC_VER

  225.   #define YAC_VC defined

  226. #endif

  227. #endif

  228. // ---- MS/DOS ?

  229. #ifdef MSDOS

  230. #ifndef YAC_MSDOS

  231.   #define YAC_MSDOS defined

  232. #endif // YAC_MSDOS

  233.   #define YAC_OSNAME "msdos (compatible)"

  234. #endif

  235. // ---- BSD ? (untested)

  236. #ifdef BSD

  237. #ifndef YAC_BSD

  238.   #define YAC_BSD defined

  239. #endif // YAC_BSD

  240.   #define YAC_POSIX defined

  241.   #define YAC_OSNAME "bsd"

  242. #endif

  243. // ---- MacOsX ? (untested)

  244. #ifdef __APPLE__

  245. #ifndef YAC_MACOSX

  246.   #define YAC_MACOSX defined

  247. #endif // YAC_MACOSX

  248.   #define YAC_POSIX defined

  249.   #define YAC_BIG_ENDIAN defined

  250.   #define YAC_OSNAME "macosx"

  251. #endif

  252. // ---- NeXT ? (untested)

  253. #ifdef NeXT

  254. #ifndef YAC_NEXT

  255.   #define YAC_NEXT defined

  256. #endif // YAC_NEXT

  257.   #define YAC_OSNAME "NeXT"

  258. #endif

  259. // ---- Unknown OS.. please report..

  260. #if !defined(YAC_OSNAME)

  261.   #ifdef __unix__

  262.   #define YAC_UNIX defined

  263.   #define YAC_POSIX defined

  264.   #define YAC_OSNAME "unix"

  265.   #else

  266.     #ifdef SYSV

  267.     #define YAC_UNIX defined

  268.     #define YAC_POSIX defined

  269.     #define YAC_OSNAME "sysv"

  270.     #else

  271.       #define YAC_OSNAME "unknown"

  272.     #endif

  273.   #endif

  274. #endif

  275. 

  276. #ifdef __CYGWIN32__

  277. #define YAC_CYGWIN defined

  278. #undef YAC_FORCE_NO_TLS

  279. #define YAC_FORCE_NO_TLS defined

  280. #endif // __CYGWIN32__

  281. 

  282. 

  283. // ---- C99 support

  284. #ifdef __STDC_VERSION__ 

  285. #if (__STDC_VERSION__ >= 199901L) 

  286. #define YAC_C99 defined

  287. #endif 

  288. #endif 

  289. // ---- GCC detection ----

  290. #ifdef __GNUC__

  291. #define YAC_GCC defined

  292. #endif

  293. // ---- endianess ----

  294. #if !defined(YAC_BIG_ENDIAN) && !defined(YAC_LITTLE_ENDIAN)

  295. #ifdef YAC_WIN32

  296. #define YAC_LITTLE_ENDIAN defined

  297. #else

  298. #ifdef YAC_POSIX

  299.   #include <endian.h>

  300.   #if (__BYTE_ORDER == __BIG_ENDIAN)

  301.     #define YAC_BIG_ENDIAN defined

  302.   #else

  303.     #define YAC_LITTLE_ENDIAN defined

  304.   #endif

  305. #else

  306. // !!! "please define YAC_BIG_ENDIAN or YAC_LITTLE_ENDIAN! (falling back to YAC_LITTLE_ENDIAN)" !!!

  307. #define YAC_LITTLE_ENDIAN defined

  308. #endif

  309. #endif

  310. #endif

  311. // ---- check whether we are running on (x86) 64bit ----

  312. #ifdef __x86_64__

  313. #define YAC_64

  314. #else

  315. #ifdef __AMD64__

  316. #define YAC_64

  317. #else

  318. #ifdef __amd64__

  319. #define YAC_64

  320. #else

  321. #ifdef __LP64__

  322. #define YAC_64

  323. #else

  324. #ifdef _M_IA64

  325. #define YAC_64

  326. #else

  327. #ifdef _M_X64

  328. #define YAC_64

  329. #endif

  330. #endif

  331. #endif

  332. #endif

  333. #endif

  334. #endif

  335. // ----

  336. // ---- Calling convention for yac* methods and global functions

  337. // ---- X86/64 uses a custom calling convention; (most?) c++ compilers

  338. // ---- cannot handle __cdecl 64bit methods/functions.

  339. // ----

  340. #ifndef YAC_CALL

  341. #ifdef YAC_64 

  342. #define YAC_CALL

  343. #else

  344. #ifdef __GNUC__

  345. #define YAC_CALL

  346. #else

  347. #define YAC_CALL __cdecl

  348. #endif

  349. #endif

  350. #endif

  351. /* // ---- YAC virtual method decorator */

  352. #ifdef YAC_WIN32

  353. //#define YAC_VCALL __cdecl

  354. #define YAC_VCALL

  355. #else

  356. #define YAC_VCALL

  357. #endif

  358. // ----

  359. // ----

  360. // ---- determine way to export symbols

  361. // ----

  362. // ----

  363. #ifndef YAC_NO_EXPORTS

  364. #ifdef YAC_VC

  365.  #define YAC_APIC extern "C" __declspec(dllexport)

  366.  #define YAC_API __declspec(dllexport)

  367. #else

  368.  #define YAC_APIC extern "C"

  369.  #define YAC_API

  370. #endif

  371. #else

  372. #define YAC_APIC extern "C"

  373. #define YAC_API

  374. #endif

  375. // ----

  376. // ---- determine thread local storage attribute syntax

  377. // ----

  378. #ifdef YAC_VC

  379. #define YAC_TLS __declspec(thread)

  380. #endif

  381. #ifdef YAC_GCC

  382. #define YAC_TLS __thread

  383. #endif

  384. 

  385. // Note: using TLS in .dlls is only allowed since Windows Vista. 

  386. //       However, I noticed that static TLS arrays increase the .dll file size 

  387. //       by the size of the array (!). e.g.: a 128kb buffer will increase the filesize

  388. //       by 128kb. not even UPX crunching can solve that issue (but why?)

  389. //       so, to keep the file size small and the .dll compatible with Windows XP and prior versions,

  390. //       you should define "YAC_FORCE_NO_TLS" in plugin_msvc.mk

  391. //       also see <http://msdn.microsoft.com/en-us/library/2s9wt68x.aspx>

  392. //       

  393. #ifdef YAC_FORCE_NO_TLS

  394. #undef YAC_TLS

  395. #define YAC_TLS

  396. #endif // YAC_FORCE_NO_TLS

  397. 

  398. 

  399. // ----

  400. // ---- determine how to "restrict" pointer aliasing

  401. // ----

  402. #ifdef YAC_VC

  403. #define YAC_RESTRICT __restrict

  404. #else

  405. #ifdef YAC_GCC

  406. #define YAC_RESTRICT __restrict__

  407. #else

  408. #define YAC_RESTRICT 

  409. #endif // YAC_GCC

  410. #endif // YAC_VC

  411. 

  412. 

  413. // ----

  414. // ---- determine how to "inline" functions

  415. // ----

  416. #ifdef YAC_VC

  417. #define YAC_INLINE __inline

  418. #else

  419. // GCC

  420. #define YAC_INLINE static inline

  421. #endif

  422. 

  423. 

  424. // ----

  425. // ---- Version string

  426. // ----

  427. #define YAC__X(a) # a

  428. #define YAC__Y(a) YAC__X(a)

  429. #define YAC__Z(a,b) a ## . ## b

  430. #define YAC_VERSION_STRING YAC__Y(YAC__Z(YAC_VERSION_MAJOR, YAC_VERSION_MINOR)) 

  431. #undef YAC__X

  432. #undef YAC__Y

  433. #undef YAC__Z

  434. 

  435. // ----

  436. // ----

  437. // ---- interface tags for YInG 

  438. // ----

  439. // ----

  440. #define YF YAC_APIC

  441. #define YC

  442. #define YCS

  443. #define YCR

  444. #define YCI

  445. #define YCF

  446. #define YG(a)

  447. #define YM

  448. #define YP

  449. 

  450. // ----

  451. // ---- The only reason to use a macro for "const" is that it 

  452. // ---- eases C++ type/name parsing 

  453. // ----  (Note: actual parsing would be required to distinguish e.g. "YAC_String *_constName" and "char *const _name",

  454. // ----         hence this workaround)

  455. // ---- 

  456. #define YAC_CONST const

  457. 

  458. YG("core");

  459. 

  460. // ---- s[USF] types originally from Dierk Ohlerich <chaos@vcc.de> <chaos@ohlerich.org> (thanks) ----

  461. // ----

  462. // ----

  463. // ---- type conventions / abbreviations for common C/C++ datatypes

  464. // ----

  465. // ----

  466. typedef char                    sChar;

  467. typedef unsigned char           sU8;

  468. typedef signed char             sS8;

  469. typedef unsigned short          sU16;

  470. typedef signed short            sS16;

  471. typedef unsigned int            sU32;

  472. typedef signed int              sS32;

  473. #ifdef YAC_VC

  474.  typedef unsigned __int64        sU64;

  475.  typedef signed __int64          sS64;

  476. #else

  477.  typedef unsigned long long      sU64;

  478.  typedef signed long long        sS64;

  479. #endif

  480. typedef float                   sF32;

  481. typedef double                  sF64; 

  482. typedef unsigned int            sBool;

  483. // ---- datatype limits ----

  484. #define sU8_MIN    0x00

  485. #define sU8_MAX    0xff

  486. #define sS8_MIN   -0x80

  487. #define sS8_MAX    0x7f

  488. #define sU16_MIN   0x0000

  489. #define sU16_MAX   0xffff

  490. #define sS16_MIN  -0x8000

  491. #define sS16_MAX   0x7fff

  492. #define sU32_MIN   0x00000000

  493. #define sU32_MAX   0xffffffff

  494. #define sS32_MIN  -0x80000000

  495. #define sS32_MAX   0x7fffffff

  496. #define sU64_MIN   0x0000000000000000

  497. #define sU64_MAX   0xffffffffffffffff

  498. #define sS64_MIN  -0x8000000000000000

  499. #define sS64_MAX   0x7fffffffffffffff

  500. #define sINT_MIN  -0x80000000

  501. #define sINT_MAX   0x7fffffff

  502. #define sF32_MIN   1.2E-38f

  503. #define sF32_MAX   3.4e+38f

  504. #define SIZEOF_CHAR   sizeof(sChar)

  505. #define SIZEOF_BYTE   1

  506. #define SIZEOF_INT    4

  507. #define SIZEOF_FLOAT  4

  508. #define SIZEOF_DOUBLE 8

  509. //#define SIZEOF_RINT   sizeof(void*)  // # of bytes / CPU register; sizeof(void*)

  510. #define SIZEOF_RINT   4

  511. // ---- void* size, # of bytes per CPU register ----

  512. #if (SIZEOF_RINT) == 4

  513.   typedef sU32 sUI;

  514.   typedef sS32 sSI;

  515.   #define RINT_SIZE_SHIFT 2

  516.   #define sUI_MIN sU32_MIN

  517.   #define sUI_MAX sU32_MAX

  518.   #define sSI_MIN sS32_MIN

  519.   #define sSI_MAX sS32_MAX

  520. #else

  521.   #if (SIZEOF_RINT) == 8

  522.     typedef sU64 sUI;

  523.     typedef sS64 sSI;

  524.     #define RINT_SIZE_SHIFT 3

  525.     #define sUI_MIN sU64_MIN

  526.     #define sUI_MAX sU64_MAX

  527.     #define sSI_MIN sS64_MIN

  528.     #define sSI_MAX sS64_MAX

  529.   #else

  530.     #error "error: trying to compile with 16-bit ints (128bit?)."

  531.   #endif

  532. #endif

  533. 

  534. // ---- 'sBool' true/false constants ----

  535. #define YAC_TRUE   (1)

  536. #define YAC_FALSE  (0)

  537. 

  538. // ---- maximum iterator size, see yacIteratorInit()

  539. #define YAC_MAX_ITERATOR_SIZE (sizeof(void*)*16)

  540. 

  541. // ---- float constants ----

  542. #define YAC_FLOAT_DEVIATION  0.000001f

  543. #define YAC_DOUBLE_DEVIATION 0.0000000001f

  544. 

  545. // ---- math constants ----

  546. #define sM_E        2.7182818284590452353602874713526625

  547. #define sM_LOG2E    1.4426950408889634073599246810018922

  548. #define sM_LOG10E   0.4342944819032518276511289189166051

  549. #define sM_LN2      0.6931471805599453094172321214581766

  550. #define sM_LN10     2.3025850929940456840179914546843642

  551. #define sM_PI       3.1415926535897932384626433832795029

  552. #define sM_PI_2     1.5707963267948966192313216916397514

  553. #define sM_PI_4     0.7853981633974483096156608458198757

  554. #define sM_1_PI     0.3183098861837906715377675267450287

  555. #define sM_2_PI     0.6366197723675813430755350534900574

  556. #define sM_2_SQRTP  1.1283791670955125738961589031215452

  557. #define sM_SQRT1_2  0.7071067811865475244008443621048490

  558. #define sM_SQRT2    1.4142135623730950488016887242096981

  559. 

  560. // ---- math constants for use with 80bit doubles (taken from GNU math.h).

  561. #define sM_El           2.7182818284590452353602874713526625L  /* e */

  562. #define sM_LOG2El       1.4426950408889634073599246810018922L  /* log_2 e */

  563. #define sM_LOG10El      0.4342944819032518276511289189166051L  /* log_10 e */

  564. #define sM_LN2l         0.6931471805599453094172321214581766L  /* log_e 2 */

  565. #define sM_LN10l        2.3025850929940456840179914546843642L  /* log_e 10 */

  566. #define sM_PIl          3.1415926535897932384626433832795029L  /* pi */

  567. #define sM_PI_2l        1.5707963267948966192313216916397514L  /* pi/2 */

  568. #define sM_PI_4l        0.7853981633974483096156608458198757L  /* pi/4 */

  569. #define sM_1_PIl        0.3183098861837906715377675267450287L  /* 1/pi */

  570. #define sM_2_PIl        0.6366197723675813430755350534900574L  /* 2/pi */

  571. #define sM_2_SQRTPIl    1.1283791670955125738961589031215452L  /* 2/sqrt(pi) */

  572. #define sM_SQRT1_2l     0.7071067811865475244008443621048490L  /* 1/sqrt(2) */

  573. #define sM_SQRT2l       1.4142135623730950488016887242096981L  /* sqrt(2) */

  574. 

  575. // ---- floating point endianess helpers ----

  576. typedef union yac_ieee_float_u {

  577. 

  578.    sF32 f32;

  579. 

  580. #ifdef YAC_LITTLE_ENDIAN

  581.    struct {

  582.       sUI mantissa : 23;

  583.       sUI exponent : 8;

  584.       sUI sign     : 1;

  585.    } le;

  586. 

  587.    struct {

  588.       sUI sign     : 1;

  589.       sUI exponent : 8;

  590.       sUI mantissa : 23;

  591.    } be;

  592. #else

  593.    struct {

  594.       sUI sign     : 1;

  595.       sUI exponent : 8;

  596.       sUI mantissa : 23;

  597.    } le;

  598. 

  599.    struct {

  600.       sUI mantissa : 23;

  601.       sUI exponent : 8;

  602.       sUI sign     : 1;

  603.    } be;

  604. #endif // YAC_LITTLE_ENDIAN

  605. 

  606.    sU8 u8[4];

  607.    sU64 u32;

  608. 

  609. } yac_ieee_float_t;

  610. 

  611. typedef union yac_ieee_double_u {

  612. 

  613.    sF64 f64;

  614. 

  615. #ifdef YAC_LITTLE_ENDIAN

  616.    // (note) C only permits integer types in bitfields => split the mantissa

  617.    struct {

  618.       sUI mantissa1 : 26;

  619.       sUI mantissa2 : 26;

  620.       sUI exponent  : 11;

  621.       sUI sign      : 1;

  622.    } le;

  623. 

  624.    struct {

  625.       sUI sign      : 1;

  626.       sUI exponent  : 11;

  627.       sUI mantissa1 : 26;

  628.       sUI mantissa2 : 26;

  629.    } be;

  630. #else

  631.    struct {

  632.       sUI sign      : 1;

  633.       sUI exponent  : 11;

  634.       sUI mantissa1 : 26;

  635.       sUI mantissa2 : 26;

  636.    } le;

  637. 

  638.    struct {

  639.       sUI mantissa1 : 26;

  640.       sUI mantissa2 : 26;

  641.       sUI exponent  : 11;

  642.       sUI sign      : 1;

  643.    } be;

  644. #endif // YAC_LITTLE_ENDIAN

  645. 

  646.    sU8 u8[8];

  647.    sU32 u64;

  648. 

  649. } yac_ieee_double_t;

  650. 

  651. // ---- useful macros ----

  652. #define sMIN(a,b) (((a)>(b))?(b):(a))

  653. #define sMAX(a,b) (((a)>(b))?(a):(b))

  654. #define sSIGN(x) (((x)==0)?0:(((x)>0)?1:-1))

  655. #define sABS(x) (((x)>0)?(x):-(x))

  656. #define sRANGE(x,max,min) (((x)<(min))?(min):(((x)>(max))?(max):(x)))

  657. #define sALIGN(x,a) (((x)+(a)-1)&~((a)-1))

  658. #define sMAKE2(b,a)      (((a)<<16)+(b))                      // special macros to pack multiple numbers in one integer.

  659. #define sMAKE4(d,c,b,a)  (((a)<<24)+((b)<<16)+((c)<<8)+(d))   // usefull for if() and switch() statements

  660. #define sMAKEID(d,c,b,a) (((a)<<24)+((b)<<16)+((c)<<8)+(d))

  661. 

  662. // ---- prefix for printf %p

  663. #ifdef YAC_WIN32

  664. #define YAC_PRINTF_PTRPREFIX "0x"

  665. #else

  666. #define YAC_PRINTF_PTRPREFIX ""

  667. #endif

  668. 

  669. // ---- handle types ----

  670. typedef void * YAC_ModuleHandle;

  671. typedef void * YAC_FunctionHandle;

  672. typedef void * YAC_VariableHandle;

  673. typedef void * YAC_ContextHandle;

  674. typedef void * YAC_MutexHandle;

  675. 

  676. // ---- nameid types ----

  677. typedef sUI    YAC_ExceptionId;

  678. typedef sSI    YAC_CallbackId;

  679. 

  680. // ---- other anonymous pointer types ----

  681. typedef void * YAC_CFunctionPtr;

  682. 

  683. typedef struct __YAC_PoolHandle {

  684.    sUI pool_id;

  685.    sUI object_id;

  686. } YAC_PoolHandle;

  687. 

  688. // ---- object validation tags ----

  689. #define YAC_VALID_TAG   0x900DF00D

  690. #define YAC_INVALID_TAG 0xD34DBEEF

  691. 

  692. // ---- base classes and structures ----

  693. class YAC_API YAC_Buffer;

  694. class YAC_API YAC_Event;

  695. class YAC_API YAC_Iterator;

  696. class YAC_API YAC_Object;

  697. class YAC_API YAC_String;

  698. class YAC_API YAC_Value;

  699. 

  700. // ---- (untyped) memory  ----

  701. typedef union _yacmem {

  702.    sUI                ui;

  703.    sSI                si;

  704.    sF32               f4;

  705.    YAC_Object        *o ;

  706.    YAC_Object       **io;

  707.    YAC_String        *s;

  708.    void              *any;

  709. } yacmem; //this has size 4byte on 32bit systems and 8byte on 64bit systems

  710. 

  711. typedef union _yacmem64 {

  712.    sUI                ui4;

  713.    sSI                si4;

  714.    sU64               ui8;

  715.    sS64               si8;

  716.    sF32                f4;

  717.    sF64                f8;

  718.    YAC_Object         *o;

  719.    YAC_Object        **io;

  720.    YAC_String         *s;

  721.    void               *any;

  722. } yacmem64; //this is always 8byte (except on bigger than 64bit systems with larger ptr)

  723. 

  724. // ---- pointer to (untyped) memory ----

  725. typedef union _yacmemptr {

  726.    yacmem            *mem;

  727.    void              *any;

  728.    sChar             *c;

  729.    sS8               *s1;

  730.    sU8               *u1;

  731.    sS16              *s2;

  732.    sU16              *u2;

  733.    sS32              *s4;

  734.    sU32              *u4;

  735.    sU64              *u8;

  736.    sF32              *f4;

  737.    sF64              *f8;

  738.    sSI               *si;

  739.    sUI               *ui;

  740.    YAC_Object        *o;

  741.    // ---- pointer to array of pointers ----

  742.    void             **iany;

  743.    sChar            **ic;

  744.    sS8              **is1;

  745.    sU8              **iu1;

  746.    sS16             **is2;

  747.    sU16             **iu2;

  748.    sS32             **is4;

  749.    sU32             **iu4;

  750.    sF32             **if4;

  751.    sSI              **isi;

  752.    sUI              **iui;

  753.    YAC_Object       **io;

  754.    YAC_Object      ***iio;

  755.    // ---- union with register int (32, 64bit) ----

  756.    sUI                _ui;

  757.    sSI                _si;

  758. } yacmemptr;

  759. 

  760. // ---- 

  761. // ---- YAC uses a custom RTTI. 

  762. // ---- 

  763. // ---- The following (absolute) class IDs are mapped to a set of core classes.

  764. // ---- (The YAC_Host application host assigns dynamic class IDs to dynamically loaded classes)

  765. // ---- 

  766. // ---- 

  767. enum __yac_class_IDs {

  768.    YAC_CLID_OBJECT=0,        // 0: base class for all API classes; cannot be instanciated

  769. 

  770.    // ---- v a l u e   o  b j e c t s ----

  771.    YAC_CLID_BOOLEAN,         // 1: object representation of a boolean (1bit)

  772.    YAC_CLID_BYTE,            // 2: object representation of a signed byte (8bit)

  773.    YAC_CLID_SHORT,           // 3: object representation of a signed short (16bit)

  774.    YAC_CLID_INTEGER,         // 4: object representation of a 32bit integer 

  775.    YAC_CLID_LONG,            // 5: object representation of a signed long long (64bit)

  776.    YAC_CLID_UNSIGNEDBYTE,    // 6: object representation of an unsigned byte (8bit)

  777.    YAC_CLID_UNSIGNEDSHORT,   // 7: object representation of an unsigned short (16bit)

  778.    YAC_CLID_UNSIGNEDINTEGER, // 8: object representation of an unsigned int (32bit)

  779.    YAC_CLID_UNSIGNEDLONG,    // 9: object representation of an unsigned long (64bit)

  780.    YAC_CLID_FLOAT,           // 10: object representation of a 32bit float

  781.    YAC_CLID_DOUBLE,          // 11: object representation of a 64bit double

  782.    YAC_CLID_STRING,          // 12: a (buffered) char sequence (has special fastpaths)

  783.    YAC_CLID_EVENT,	          // 13: a time-stamped String

  784.    YAC_CLID_VALUE,           // 14: an int/float/String or Object value that is wrapped in an object

  785.    YAC_CLID_LISTNODE,        // 15: a single node of a list (or a list header). derived from Value.

  786.    YAC_CLID_TREENODE,        // 16: a single node of a tree (or a tree header). derived from Value.

  787. 

  788.    // ---- c o n t a i n e r    o b j e c t s ----

  789.    YAC_CLID_CLASS,           // 17: base class for meta class objects (e.g. script class objects)

  790.    YAC_CLID_LIST,            // 18: object container for a double linked list, see YAC_ListNode.

  791.    YAC_CLID_INTARRAY,        // 19: an Array of ints, see yacArray*

  792.    YAC_CLID_FLOATARRAY,      // 20: an Array of floats, see yacArray*

  793.    YAC_CLID_STRINGARRAY,     // 21: an Array of YAC_Strings (all read-write)

  794.    YAC_CLID_OBJECTARRAY,     // 22: an Array of (uniform) YAC_Objects (all read-write)

  795.    YAC_CLID_CLASSARRAY,      // 23: an Array of meta class objects (all read-write)

  796.    YAC_CLID_VALUEARRAY,      // 24: an Array of YAC_Values

  797.    YAC_CLID_POINTERARRAY,    // 25: an Array of (mixed) YAC_Objects wrapped in YAC_Values

  798.    YAC_CLID_HASHTABLE,       // 26: an associative Array, see yacHash*

  799. 

  800.    // ---- s t r e a m  s ----

  801.    YAC_CLID_STREAM,          // 27: base class for Files und Buffers, see yacStream*, YAC_StreamBase

  802.    YAC_CLID_STDINSTREAM,     // 28: standard input filestream, derived from YAC_StreamBase

  803.    YAC_CLID_STDOUTSTREAM,    // 29: standard output filestream, derived from YAC_StreamBase

  804.    YAC_CLID_STDERRSTREAM,    // 30: standard error filestream, derived from YAC_StreamBase

  805.    YAC_CLID_BUFFER,          // 31: an Array of bytes, derived from YAC_StreamBase

  806.    YAC_CLID_FILE,            // 32: used to access local filesystems, derived from YAC_StreamBase

  807.    YAC_CLID_PAKFILE,         // 33: used to access virtual file systems, derived from YAC_StreamBase

  808.    YAC_CLID_PIPE,

  809. 

  810.    // Note: Be careful with the preallocated String/array variants. 

  811.    //       A buffer reallocation will waste the initial buffer memory (not leaked but it cannot be used for anything

  812.    //       else as long as the object is alive!). This means: Choose the variant wisely!

  813.    //       The good thing is that in conjunction with object pooling, it is possible to write code that

  814.    //       works with *zero* malloc() calls. Without these variants, a malloc() would be necessary to allocate

  815.    //       the actual buffer data even if the object is pooled.

  816.    //       Finally, keep in mind that if you use static variables, the Object is not re-initialized the next

  817.    //       time a function is called, i.e. the buffer will still be there and no malloc() will be necessary

  818.    //       even without these variants.

  819.    YAC_CLID_STRING8,         // 34: variation of String that comes with preallocated char buffer of 8 chars

  820.    YAC_CLID_STRING16,        // 35: variation of String that comes with preallocated char buffer of 16 chars

  821.    YAC_CLID_STRING32,        // 36: variation of String that comes with preallocated char buffer of 32 chars

  822.    YAC_CLID_STRING64,        // 37: variation of String that comes with preallocated char buffer of 64 chars

  823.    YAC_CLID_STRING128,       // 38: variation of String that comes with preallocated char buffer of 128 chars

  824.    YAC_CLID_INTARRAY8,       // 39: variation of IntArray that comes with a preallocated buffer of 8 ints

  825.    YAC_CLID_INTARRAY16,      // 40: variation of IntArray that comes with a preallocated buffer of 16 ints

  826.    YAC_CLID_INTARRAY32,      // 41: variation of IntArray that comes with a preallocated buffer of 32 ints

  827.    YAC_CLID_INTARRAY64,      // 42: variation of IntArray that comes with a preallocated buffer of 64 ints

  828.    YAC_CLID_INTARRAY128,     // 43: variation of IntArray that comes with a preallocated buffer of 128 ints

  829.    YAC_CLID_FLOATARRAY8,     // 44: variation of FloatArray that comes with a preallocated buffer of 8 floats

  830.    YAC_CLID_FLOATARRAY16,    // 45: variation of FloatArray that comes with a preallocated buffer of 16 floats

  831.    YAC_CLID_FLOATARRAY32,    // 46: variation of FloatArray that comes with a preallocated buffer of 32 floats

  832.    YAC_CLID_FLOATARRAY64,    // 47: variation of FloatArray that comes with a preallocated buffer of 64 floats

  833.    YAC_CLID_FLOATARRAY128,   // 48: variation of FloatArray that comes with a preallocated buffer of 128 floats

  834.    

  835.    YAC_NUM_CORE_CLASSES = 128

  836. };

  837. 

  838. // ---- hard coded limits/"magic" constants ----

  839. #define YAC_MAX_CLASSES  256         // maximum number of C++ classes

  840. #define YAC_MAX_COMMANDS 64          // maximum number of C++ methods per class

  841. #define YAC_LOSTKEY      ((sU32)-1)  // indicates that YAC_String hashkey needs to be recalc'd

  842. 

  843. // ---- YAC class types

  844. #define YAC_CLASSTYPE_STATIC 0   // C++ class cannot be instantiated in scripts or native code

  845. #define YAC_CLASSTYPE_NORMAL 1   // regular C++ class

  846. #define YAC_CLASSTYPE_NOINST 2   // C++ class objects can only be instantiated by native code

  847. 

  848. // ---- basic datatype enumeration

  849. #define YAC_TYPE_VOID     0  // not used

  850. #define YAC_TYPE_VARIANT  0  // not defined (yet)

  851. #define YAC_TYPE_INT      1  // currently 32bit integer (may become 64bit signed long long on 64bit architectures)

  852. #define YAC_TYPE_FLOAT    2  // currently 32bit float (may become 64bit double on 64bit architectures)

  853. #define YAC_TYPE_OBJECT   3  // pointer to Object (YAC_Object *)

  854. #define YAC_TYPE_STRING   4  // only used in YAC_Value::type field, script engine hint

  855. 

  856. // ---- Hint flags for the YAC_Host to use different pools for different types of object allocations (e.g. short-lived vs. long-term)

  857. // ---- YAC_NEW() should be used for seldomly deleted objects (i.e. to prevent pooling)

  858. #define YAC_POOL_HINT_DEFAULT 0

  859. #define YAC_POOL_HINT_TEMPORARY 1

  860. 

  861. // ---- Pool priorities

  862. #define YAC_POOL_PRIORITY_LOW    0

  863. #define YAC_POOL_PRIORITY_MEDIUM 1

  864. #define YAC_POOL_PRIORITY_HIGH   2

  865. #define YAC_NUM_POOL_PRIORITIES  3

  866. 

  867. #ifdef YAC_PLACEMENT_NEW

  868. #include <stdlib.h>

  869. #include <new>

  870. #endif // YAC_PLACEMENT_NEW

  871. 

  872. #if !defined(RACK_PLUGIN) && !defined(RACK_HOST)

  873. 

  874. // ---- basic type structure (no con-/destructors) ----

  875. class YAC_API YAC_TypeS { 

  876.   public:

  877. #ifdef YAC_VIRTUAL_VALUE

  878.    inline virtual ~YAC_TypeS() { } // To satisfy the Intel C++ compiler :/ (i.e. to get no warnings when virtual classes are derived from this class/YAC_Value)

  879. #endif // YAC_VIRTUAL_VALUE

  880.  public:

  881.   sUI type;       // YAC_TYPE_xxx 

  882.   sSI class_type; // if type==YAC_TYPE_OBJECT then this field stores the internal object class type 

  883. };

  884. 

  885. // ---- basic script value structure (no con-/destructors) ----

  886. class YAC_API YAC_ValueS : public YAC_TypeS {

  887. public:

  888. 	union __my_value {	

  889. 		sF32        float_val; 

  890. 		sSI         int_val; 

  891. 		YAC_Object *object_val; 

  892. 		YAC_String *string_val;

  893.       void       *any;

  894. 	} value; 

  895. 	sUI deleteme; // ---- this flag is used to decide whether it is safe to delete the object

  896. };

  897. 

  898. //

  899. // How to allocate string characters

  900. //

  901. #ifdef YAC_TRACK_CHARALLOC

  902. extern sSI yac_string_total_char_size;

  903. extern sU8 *yac_string_alloc_chars(size_t _n);

  904. extern void yac_string_free_chars(sU8 *_chars);

  905. #define Dyacallocchars(n) yac_string_alloc_chars(n)

  906. #define Dyacfreechars(n) yac_string_free_chars(n)

  907. #else

  908. #define Dyacallocchars(n) ((sU8*)::malloc(n))

  909. #define Dyacfreechars(n) ::free(n)

  910. #endif // YAC_TRACK_CHARALLOC

  911. 

  912. #ifndef YAC_CUST_VALUE

  913. // ---- 

  914. // ---- 

  915. // ----  YAC_Value:

  916. // ---- 

  917. // ----       - stores an int/float or YAC_Object* 

  918. // ----       - dynamic type

  919. // ----       - track object pointer ownership

  920. // ----       - used to return values from methods/functions 

  921. // ---- 

  922. // ---- 

  923. // ---- 

  924. class YAC_API YAC_Value : public YAC_ValueS {

  925. public:

  926.     YAC_Value            (void                      );

  927.     ~YAC_Value           (                          );

  928.     void initVoid        (void                      );

  929.     void initInt         (sSI _i                    );

  930.     void initFloat       (sF32 _f                   );

  931.     void initString      (YAC_String *_s, sBool _del);

  932.     void initNewString   (YAC_String *s             );

  933.     void initObject      (YAC_Object *_o, sBool _del);

  934.     void initNull        (void                      );

  935.     void typecast        (sUI _type                 );

  936.     void unsetFast       (void                      );  // delete object if it is volatile (deleteme flag)

  937.     void unset           (void                      );  // delete object if it is volatile (deleteme flag), reset members to 0

  938.     void operator =      (YAC_Value*_v              );

  939.     void safeInitInt     (sSI _i                    );

  940.     void safeInitFloat   (sF32 _f                   );

  941.     void safeInitString  (YAC_String *_s, sBool _del);

  942.     void safeInitObject  (YAC_Object *_o, sBool _new);

  943.     void initEmptyString (void                      );

  944.     void copyRef         (const YAC_Value *_o       );

  945. };

  946. #endif // YAC_CUST_VALUE

  947. 

  948. // ---- macros for the c++ interface ----

  949. #define YAC_RETI(a)   _r->initInt((sSI)(a))

  950.                              // the return value of an API function (to the hostengine) is passed in a YAC_Value *_r argument, e.g. getValue(YAC_Value *_r) { _r->initInt(42); }. lists and arrays can be returned using apprioriate objects (e.g. PointerArray)

  951. #define YAC_RETF(a)   _r->initFloat((sF32)(a))

  952.                              // return a float value, also see YAC_RETI

  953. #define YAC_RETO(a,b) _r->initObject((YAC_Object*)(a),b)

  954.                              // return an object. new objects have to be allocated with YAC_Host::yacNew(), also see YAC_RETI

  955. #define YAC_RETS(a,b) _r->initString((YAC_String*)(a), b)                                                                                                 // return a string. new strings have to be allocated with YAC_Host::yacNew(), also see YAC_RETI

  956. #define YAC_RETSC(a)  _r->initNewString((YAC_String*)(a))

  957. #define YAC_H(a)      YAC_Object*YAC_VCALL yacNewObject(void);const sChar*YAC_VCALL yacClassName(void)

  958.                              // ---- start an interface definition, e.g. YAC_H(MyClass);

  959. #define YAC(a)    YAC_Object * YAC_VCALL yacNewObject         (void);\

  960.    const sChar*  YAC_VCALL yacClassName                     (void);\

  961.    sUI           YAC_VCALL yacMemberGetNum                  (void);\

  962.    const char ** YAC_VCALL yacMemberGetNames                (void);\

  963. 	const sUI   * YAC_VCALL yacMemberGetTypes                (void);\

  964. 	const char ** YAC_VCALL yacMemberGetObjectTypes          (void);\

  965. 	const sU8  ** YAC_VCALL yacMemberGetOffsets              (void);\

  966. 	sUI           YAC_VCALL yacMethodGetNum                  (void);\

  967. 	const char ** YAC_VCALL yacMethodGetNames                (void);\

  968. 	const sUI   * YAC_VCALL yacMethodGetNumParameters        (void);\

  969. 	const sUI  ** YAC_VCALL yacMethodGetParameterTypes       (void);\

  970. 	const char*** YAC_VCALL yacMethodGetParameterObjectTypes (void);\

  971. 	const sUI   * YAC_VCALL yacMethodGetReturnTypes          (void);\

  972. 	const char ** YAC_VCALL yacMethodGetReturnObjectTypes    (void);\

  973. 	const void ** YAC_VCALL yacMethodGetAdr                  (void);\

  974. 	sUI           YAC_VCALL yacConstantGetNum                (void);\

  975. 	const char ** YAC_VCALL yacConstantGetNames              (void);\

  976. 	const sUI   * YAC_VCALL yacConstantGetTypes              (void);\

  977. 	yacmemptr     YAC_VCALL yacConstantGetValues             (void)

  978. 

  979. #define YAC_POOLED_H(a, p) \

  980.    void         YAC_VCALL yacPoolInit        (YAC_Object *_this); \

  981.    sUI          YAC_VCALL yacPoolGetSize     (void); \

  982.    sUI          YAC_VCALL yacPoolGetPriority (void) { return p; } \

  983.    void         YAC_VCALL yacFinalizeObject  (YAC_ContextHandle)

  984. 

  985. #define YAC_POOLED(a, p) YAC(a); YAC_POOLED_H(a, p)

  986. 

  987. #define YAC_C(a, b) YAC_Object *YAC_VCALL a::yacNewObject(void){YAC_Object*r=new a();r->class_ID=class_ID;return r;}const sChar*a::yacClassName(void){return b;}

  988. 

  989. #define YAC_C_CORE(a, b, c) YAC_Object *YAC_VCALL a::yacNewObject(void){YAC_Object*r=new a();r->class_ID=c;return r;}const sChar*a::yacClassName(void){return b;}

  990. 

  991. 

  992. #ifdef YAC_PLACEMENT_NEW

  993. #define YAC_C_POOLED__NEWOBJECT(a) \

  994.    void YAC_VCALL a::yacPoolInit(YAC_Object *_this) { new(_this)a(); } 

  995. #else

  996. #define YAC_C_POOLED__NEWOBJECT(a) \

  997.    void YAC_VCALL a::yacPoolInit(YAC_Object *_this) { *(void**)_this = *(void**)this; ((a*)_this)->a::a(); } 

  998. #endif // YAC_PLACEMENT_NEW

  999. 

  1000. #define YAC_C_POOLED(a, b) YAC_C(a, b) YAC_C_POOLED__NEWOBJECT(a) \

  1001.    void       YAC_VCALL a::yacFinalizeObject (YAC_ContextHandle) { this->a::~a(); } \

  1002.    sUI        YAC_VCALL a::yacPoolGetSize    (void)              { return sizeof(a); }

  1003. 

  1004. #define YAC_C_CORE_POOLED(a, b, c) YAC_C_CORE(a, b, c) YAC_C_POOLED__NEWOBJECT(a) \

  1005.    void       YAC_VCALL a::yacFinalizeObject (YAC_ContextHandle) { this->a::~a(); } \

  1006.    sUI        YAC_VCALL a::yacPoolGetSize    (void)              { return sizeof(a); }

  1007. 

  1008. #define YAC_CHK(a,b)  ((a)&&((a)->class_ID==b))

  1009.                        // ---- custom RTTI, used to verify Object arguments passed from scripts

  1010. #define YAC_BCHK(a,b) ((a)&&(yac_host->cpp_typecast_map[(a)->class_ID][b]))

  1011.                        // ---- custom RTTI, used to verify if Object is baseclass of another Object, also to validate script arguments

  1012. 

  1013. // For regular class names (e.g. MyClass)

  1014. #define YAC_NEW(a) (a*)yac_host->yacNewByID(clid_##a)

  1015. 

  1016. // For mangled class name (e.g. _MyClass)

  1017. #define YAC_NEW_(a) (_##a*)yac_host->yacNewByID(clid_##a)

  1018. 

  1019. // Note: do not pass stack objects to other yac* methods (object may have different vtable!)

  1020. #define YAC_NEW_STACK(t, v) _##t v; v.class_ID = clid_##t

  1021. 

  1022. #define YAC_NEW_CORE(c) yac_host->yacNewByID(c)

  1023. 

  1024. #define YAC_NEW_POOLED(a) (_##a*)yac_host->yacNewPooledByID(clid_##a, YAC_POOL_HINT_DEFAULT)

  1025. 

  1026. #define YAC_NEW_TEMP(a) (_##a*)yac_host->yacNewPooledByID(clid_##a, YAC_POOL_HINT_TEMPORARY)

  1027. 

  1028. #define YAC_NEW_CORE_POOLED(c) yac_host->yacNewPooledByID(c, YAC_POOL_HINT_DEFAULT)

  1029. 

  1030. #define YAC_NEW_CORE_TEMP(c) yac_host->yacNewPooledByID(c, YAC_POOL_HINT_TEMPORARY)

  1031. 

  1032. // ---- Cloning creates a new object and calls yacOperatorInit. 

  1033. #define YAC_CLONE_POOLED(x, a) (a)->yacNewPooled((YAC_ContextHandle)x, YAC_POOL_HINT_DEFAULT)

  1034. 

  1035. #define YAC_CLONE_TEMP(x, a) (a)->yacNewPooled((YAC_ContextHandle)x, YAC_POOL_HINT_TEMPORARY)

  1036. 

  1037. #define YAC_DELETE(a) yac_host->yacDelete(a)

  1038. 

  1039. #define YAC_DELETE_SAFE(a) if(NULL != a) { YAC_DELETE(a); a = NULL; } else (void)0

  1040. 

  1041. // ---- operation codes for YAC_Object::yacOperator() ----

  1042. enum __yacoperators {

  1043.     YAC_OP_ASSIGN=0, // ---- also see YAC_Object::yacOperator()

  1044.     YAC_OP_ADD,

  1045.     YAC_OP_SUB,

  1046.     YAC_OP_MUL,

  1047.     YAC_OP_DIV,

  1048.     YAC_OP_MOD,

  1049.     YAC_OP_SHL,

  1050.     YAC_OP_SHR,

  1051.     YAC_OP_CEQ,

  1052.     YAC_OP_CNE,

  1053.     YAC_OP_CLE,

  1054.     YAC_OP_CLT,

  1055.     YAC_OP_CGE,

  1056.     YAC_OP_CGT,

  1057.     YAC_OP_AND,

  1058.     YAC_OP_OR,

  1059.     YAC_OP_EOR,

  1060.     YAC_OP_NOT,

  1061.     YAC_OP_BITNOT, // iinv

  1062.     YAC_OP_LAND,

  1063.     YAC_OP_LOR,

  1064.     YAC_OP_LEOR,

  1065.     YAC_OP_NEG,

  1066.     YAC_OP_INIT, // init class, call constructors (or put on cs list)

  1067.     YAC_NUMOPERATORS

  1068. };

  1069. 

  1070. // ---- double arg operator priorities (sUI YAC_Object::yacOperatorPriority(void))

  1071. #define YAC_OP_PRIO_BOOLEAN  0x00001000

  1072. #define YAC_OP_PRIO_BYTE     0x00002000

  1073. #define YAC_OP_PRIO_SHORT    0x00003000

  1074. #define YAC_OP_PRIO_INTEGER  0x00004000

  1075. #define YAC_OP_PRIO_LONG     0x00005000

  1076. #define YAC_OP_PRIO_FLOAT    0x00006000

  1077. #define YAC_OP_PRIO_DOUBLE   0x00007000

  1078. #define YAC_OP_PRIO_STRING   0x00010000

  1079. 

  1080. // ---- Return values for yacTensorRank()

  1081. #define YAC_TENSOR_RANK_NONE  -2 // Definitely not a math object, e.g. Time

  1082. #define YAC_TENSOR_RANK_VAR   -1 // Some object's tensor rank can be variant resp. interpreted differently, e.g. String, ListNode, ValueObject

  1083. #define YAC_TENSOR_RANK_SCALAR 0 // Integer, Float, Double, ..

  1084. #define YAC_TENSOR_RANK_VECTOR 1 // IntArray, FloatArray, ObjectArray, ..

  1085. #define YAC_TENSOR_RANK_MATRIX 2 // e.g. tkmath::Matrix3f

  1086. 

  1087. // ---- all plugin class(es) have to be derived from this virtual interface class ----

  1088. YCR class YAC_API YAC_Object {

  1089. public:

  1090.    sUI class_ID;                 /// ---- set by YAC_Host::yacRegisterClass()

  1091. 

  1092. #ifdef YAC_OBJECT_TAGS

  1093.    sUI validation_tag;           /// ---- YAC_VALID_TAG ord YAC_INVALID_TAG

  1094. #endif

  1095. 

  1096. #ifdef YAC_OBJECT_POOL

  1097.    YAC_PoolHandle pool_handle;   /// ---- != 0 if the object was allocated from a pool

  1098. #endif 

  1099. 

  1100. #ifdef YAC_OBJECT_COUNTER

  1101.    static sUI object_counter;    /// ---- tracks the total number of objects

  1102. #endif

  1103. 

  1104. #ifdef YAC_PLACEMENT_NEW

  1105. public:

  1106.    void *operator new    (size_t _size)        { return ::malloc(_size); }

  1107.    void  operator delete (void *_ptr)          { 

  1108.       if(((YAC_Object*)_ptr)->pool_handle.pool_id)

  1109.       {

  1110.          ::printf("[---] delete: object is pooled (handle=%08x:%08x)!!\n", 

  1111.                   ((YAC_Object*)_ptr)->pool_handle.pool_id,

  1112.                   ((YAC_Object*)_ptr)->pool_handle.object_id

  1113.                   ); 

  1114.       }

  1115.       else 

  1116.       {

  1117.          ::free(_ptr); 

  1118.       }

  1119.    }

  1120. 

  1121.    void *operator new    (size_t, void *_this) { return _this; }

  1122. #endif // YAC_PLACEMENT_NEW

  1123. public:

  1124. 

  1125.    // ---- 

  1126.    // ---- 

  1127.    // ---- LEVEL (1<<0) interface 

  1128.    // ----                    ( C++ reflectance support )

  1129.    // ---- 

  1130.    // ---- 

  1131.                            YAC_Object                      (void);

  1132.   virtual                  ~YAC_Object                     ();

  1133.   virtual sUI              YAC_VCALL yacQueryInterfaces              (void);

  1134.   virtual const sChar     *YAC_VCALL yacClassName                    (void);                                  // get human readable class name

  1135.   virtual YAC_Object      *YAC_VCALL yacNewObject                    (void);                                  // create new instance of object class, also see non-virtual yacNew(). autogenerated by YAC_H(), YAC_C() macros

  1136.   virtual sUI              YAC_VCALL yacMemberGetNum                 (void);

  1137.   virtual const char     **YAC_VCALL yacMemberGetNames               (void);

  1138.   virtual const sUI       *YAC_VCALL yacMemberGetTypes               (void);

  1139.   virtual const char     **YAC_VCALL yacMemberGetObjectTypes         (void);

  1140.   virtual const sU8      **YAC_VCALL yacMemberGetOffsets             (void);

  1141.   virtual sUI              YAC_VCALL yacMethodGetNum                 (void);

  1142.   virtual const char     **YAC_VCALL yacMethodGetNames               (void);

  1143.   virtual const sUI       *YAC_VCALL yacMethodGetNumParameters       (void);

  1144.   virtual const sUI      **YAC_VCALL yacMethodGetParameterTypes      (void);

  1145.   virtual const char    ***YAC_VCALL yacMethodGetParameterObjectTypes(void);

  1146.   virtual const sUI       *YAC_VCALL yacMethodGetReturnTypes         (void);

  1147.   virtual const char     **YAC_VCALL yacMethodGetReturnObjectTypes   (void);

  1148.   virtual const void     **YAC_VCALL yacMethodGetAdr                 (void); 

  1149.   virtual sUI              YAC_VCALL yacConstantGetNum               (void);

  1150.   virtual const char     **YAC_VCALL yacConstantGetNames             (void);

  1151.   virtual const sUI       *YAC_VCALL yacConstantGetTypes             (void);

  1152.   virtual yacmemptr        YAC_VCALL yacConstantGetValues            (void);

  1153.   virtual void             YAC_VCALL yacFinalizeObject               (YAC_ContextHandle _context);

  1154.   virtual void             YAC_VCALL yacGetConstantStringList        (YAC_String *);      // !!WILL BE REMOVED SOON!! write constant list to _retstring. example: "CONST_A:42 CONST_B:77 CONST_C:$7f"

  1155.   virtual sBool            YAC_VCALL yacIsComposite                  (void); // return true if object stores references to other objects, used for serialization

  1156.   virtual sUI              YAC_VCALL yacPoolGetSize                  (void); // return 0 to prevent pooling for this class type (default)

  1157.   virtual void             YAC_VCALL yacPoolInit                     (YAC_Object *_this); // initialize new object (install vtable, call constructors)

  1158.   virtual sUI              YAC_VCALL yacPoolGetPriority              (void); // return pool priority for this class type. see YAC_POOL_PRIORITY_xxx

  1159.   virtual void             YAC_VCALL vtable_entry_0_25_reserved      (void);

  1160.   virtual void             YAC_VCALL vtable_entry_0_26_reserved      (void);

  1161.   virtual void             YAC_VCALL vtable_entry_0_27_reserved      (void);

  1162.   virtual void             YAC_VCALL vtable_entry_0_28_reserved      (void);

  1163.   virtual void             YAC_VCALL vtable_entry_0_29_reserved      (void);

  1164.   virtual void             YAC_VCALL vtable_entry_0_30_reserved      (void);

  1165.   virtual void             YAC_VCALL vtable_entry_0_31_reserved      (void);

  1166. 

  1167.    // ---- 

  1168.    // ---- 

  1169.    // ---- LEVEL (1<<1) interface 

  1170.    // ----                    ( operator support )

  1171.    // ----                        - also see YAC_OP_xxx constants

  1172.    // ---- 

  1173.    // ---- 

  1174.   virtual sBool            YAC_VCALL yacCopy                         (YAC_Object *_o);                                // copy from other object

  1175.   virtual sBool            YAC_VCALL yacEquals                       (YAC_Object *_o);                                // compare objects

  1176.   virtual void             YAC_VCALL yacOperator                     (sSI _cmd, YAC_Object *_robj, YAC_Value *_r);    // call operator (see YAC_OP_)

  1177.   virtual void             YAC_VCALL yacOperatorInit                 (void *_context, YAC_Object *_robj);             // used to initialize a class-like YAC_Object by using a template

  1178.   virtual void             YAC_VCALL yacOperatorAssign               (YAC_Object *_robj);                             // assign YAC_Object _robj (i.e. copy the members)

  1179.   virtual void             YAC_VCALL yacOperatorAdd                  (YAC_Object *_robj);                             // add YAC_Object _robj

  1180.   virtual void             YAC_VCALL yacOperatorSub                  (YAC_Object *_robj);                             // subtract YAC_Object _robj

  1181.   virtual void             YAC_VCALL yacOperatorMul                  (YAC_Object *_robj);                             // multiply with YAC_Object _robj

  1182.   virtual void             YAC_VCALL yacOperatorDiv                  (YAC_Object *_robj);                             // divide by YAC_Object _robj

  1183.   virtual void             YAC_VCALL yacOperatorClamp                (YAC_Object *_min, YAC_Object *_max);            // clamp object to boundaries [_min, _max] (e.g. Vector)

  1184.   virtual void             YAC_VCALL yacOperatorWrap                 (YAC_Object *_min, YAC_Object *_max);            // wrap object around boundaries [_min, _max] (e.g. Vector)

  1185.   virtual sBool            YAC_VCALL yacScanI                        (sSI *_ip);                                      // convert object to integer

  1186.   virtual sBool            YAC_VCALL yacScanF32                      (sF32 *_fp);                                     // convert object to 32bit IEEE float

  1187.   virtual sBool            YAC_VCALL yacScanF64                      (sF64 *_dp);                                     // convert object to 64bit IEEE double

  1188.   virtual sBool            YAC_VCALL yacToString                     (YAC_String *s) const;                           // convert object to String object

  1189.   virtual sBool            YAC_VCALL yacScanI64                      (sS64 *_lip);                                    // convert object to long or long long integer (platform dependent)

  1190.   virtual void             YAC_VCALL yacOperatorI                    (sSI _cmd, sSI _val, YAC_Value *_r);             // operate on object with integer argument

  1191.   virtual void             YAC_VCALL yacOperatorF32                  (sSI _cmd, sF32 _val, YAC_Value *_r);            // operate on object with 32bit IEEE float argument

  1192.   virtual void             YAC_VCALL yacOperatorF64                  (sSI _cmd, sF64 _val, YAC_Value *_r);            // operato on object with 64bit IEEE double argument

  1193.   virtual void             YAC_VCALL yacValueOfI                     (sSI);                                           // set object value by integer argument

  1194.   virtual void             YAC_VCALL yacValueOfF32                   (sF32);                                          // set object value by 32bit IEEE float argument

  1195.   virtual void             YAC_VCALL yacValueOfF64                   (sF64);                                          // set object value by 64bit IEEE double argument

  1196.   virtual sUI              YAC_VCALL yacOperatorPriority             (void);                                          // query priority of object in double-arg expressions (for type conversions)

  1197.   virtual void             YAC_VCALL yacValueOfI64                   (sS64);                                          // set object value by 64bit long long integer

  1198.   virtual sSI              YAC_VCALL yacTensorRank                   (void);                                          // query tensor rank of math object, -1=not a math object, 0=scalar, 1=vector, 2=matrix, ..

  1199.   virtual sBool            YAC_VCALL yacToParsableString             (YAC_String *s) const;                           // convert object to script-parsable String object

  1200.   virtual void             YAC_VCALL yacOperatorI64                  (sSI _cmd, sS64 _val, YAC_Value *_r);            // operate on object with 64bit integer argument

  1201.   virtual void             YAC_VCALL vtable_entry_1_28_reserved      (void);

  1202.   virtual void             YAC_VCALL vtable_entry_1_29_reserved      (void);

  1203.   virtual void             YAC_VCALL vtable_entry_1_30_reserved      (void);

  1204.   virtual void             YAC_VCALL vtable_entry_1_31_reserved      (void);

  1205. 

  1206.    // ---- 

  1207.    // ---- 

  1208.    // ---- LEVEL (1<<2) interface 

  1209.    // ----                    ( stream support )

  1210.    // ---- 

  1211.    // ---- 

  1212.    // ---- 

  1213.   virtual sBool            YAC_VCALL yacIsStream                     (void);                                                 // test if the object supports the stream interface

  1214.   virtual void             YAC_VCALL yacStreamClose                  (void);                                                 // close previously opened stream

  1215.   virtual sBool            YAC_VCALL yacStreamOpenLocal              (sChar *_local_pathname, sSI _access);                  // open local filestream; _access must be YAC_IOS_IN, YAC_IOS_IN or YAC_IOS_IN. return true (=ok) or false (=error)

  1216.   virtual sBool            YAC_VCALL yacStreamOpenLogic              (sChar *_name_in_pakfile);                              // open filestream stored in a "pak" file. return true (=ok) or false (=error)

  1217.   virtual sUI              YAC_VCALL yacStreamGetByteOrder           (void);                                                 // get byteorder of stream (YAC_LITTLEENDIAN, YAC_BIGENDIAN)

  1218.   virtual void             YAC_VCALL yacStreamSetByteOrder           (sUI);                                                  // set byteorder of stream (YAC_LITTLEENDIAN, YAC_BIGENDIAN)

  1219.   virtual sBool            YAC_VCALL yacStreamEOF                    (void);                                                 // return 1 (true) if the stream end has been reached

  1220.   virtual void             YAC_VCALL yacStreamSeek                   (sSI _off, sUI _mode);                                  // seek to a position in the stream. _mode must be one of YAC_BEG (absolute seek), YAC_CUR (add offset to current position), YAC_END (seek relative to stream end, if available)

  1221.   virtual sUI              YAC_VCALL yacStreamGetOffset              (void);                                                 // get current stream position (byte offset)

  1222.   virtual void             YAC_VCALL yacStreamSetOffset              (sUI);                                                  // set current stream position (byte offset)

  1223.   virtual sUI              YAC_VCALL yacStreamGetSize                (void);                                                 // get size of stream (if known)

  1224.   virtual sSI              YAC_VCALL yacStreamRead                   (sU8 *, sUI _num);                                      // read _num bytes to buffer, return number of bytes actually read

  1225.   virtual sU8              YAC_VCALL yacStreamReadI8                 (void);                                                 // read a single byte

  1226.   virtual sU16             YAC_VCALL yacStreamReadI16                (void);                                                 // read a single word, convert endianess from stream to host endianess

  1227.   virtual sU32             YAC_VCALL yacStreamReadI32                (void);                                                 // read double word, convert endianess from stream to host endianess

  1228.   virtual sF32             YAC_VCALL yacStreamReadF32                (void);                                                 // read standard IEEE 32bit float

  1229.   virtual void             YAC_VCALL yacStreamReadObject             (YAC_Object *_dest);                                    // deserialize object from stream

  1230.   virtual sSI              YAC_VCALL yacStreamReadString             (YAC_String *_dest, sUI _maxlen);                       // read up to _maxlen bytes to _dest (until ASCIIZ is found)

  1231.   virtual sSI              YAC_VCALL yacStreamReadBuffer             (YAC_Buffer *_dest, sUI _off, sUI _num, sBool _resize); // read _num bytes into buffer starting at buffer offset _off. resize buffer if necessary and _resize==true. return number of bytes actually read

  1232.   virtual sSI              YAC_VCALL yacStreamReadLine               (YAC_String *_s, sUI _maxlen);

  1233.   virtual sSI              YAC_VCALL yacStreamWrite                  (sU8 *, sUI _num);                                      // write _num bytes from _buf into stream. return number of bytes actually written.

  1234.   virtual void             YAC_VCALL yacStreamWriteI8                (sU8);                                                  // write a single byte

  1235.   virtual void             YAC_VCALL yacStreamWriteI16               (sU16);                                                 // write a single word

  1236.   virtual void             YAC_VCALL yacStreamWriteI32               (sS32);                                                 // write a single double word

  1237.   virtual void             YAC_VCALL yacStreamWriteF32               (sF32);                                                 // write a standard IEEE 32bit float

  1238.   virtual void             YAC_VCALL yacStreamWriteObject            (YAC_Object*);                                          // serialize object into stream

  1239.   virtual sSI              YAC_VCALL yacStreamWriteString            (YAC_String *, sUI _off, sUI _num);                     // write _num chars from string starting at string offset _off into stream. return number of chars (bytes) actually written.

  1240.   virtual sSI              YAC_VCALL yacStreamWriteBuffer            (YAC_Buffer *_buf, sUI _off, sUI _num);                 // write _num bytes from _buf starting at buffer offset _off into stream. return number of bytes actually written.

  1241.   virtual sSI              YAC_VCALL yacStreamGetErrorCode           (void);                                                 // return last error code (or 0==no error)

  1242.   virtual void             YAC_VCALL yacStreamGetErrorStringByCode   (sSI _code, YAC_Value *_r);                             // convert last error code to human readable string

  1243.   virtual sF64             YAC_VCALL yacStreamReadF64                (void);                                                 // read standard IEEE 64bit double

  1244.   virtual void             YAC_VCALL yacStreamWriteF64               (sF64);                                                 // write a standard IEEE 64bit double

  1245.   virtual sU64             YAC_VCALL yacStreamReadI64                (void);                                                 // read 64bit signed long long

  1246.   virtual void             YAC_VCALL yacStreamWriteI64               (sS64);                                                 // write 64bit signed long long

  1247.   virtual void             YAC_VCALL vtable_entry_2_35_reserved      (void);

  1248.   virtual void             YAC_VCALL vtable_entry_2_36_reserved      (void);

  1249.   virtual void             YAC_VCALL vtable_entry_2_37_reserved      (void);

  1250.   virtual void             YAC_VCALL vtable_entry_2_38_reserved      (void);

  1251.   virtual void             YAC_VCALL vtable_entry_2_39_reserved      (void);

  1252.   virtual void             YAC_VCALL vtable_entry_2_40_reserved      (void);

  1253.   virtual void             YAC_VCALL vtable_entry_2_41_reserved      (void);

  1254.   virtual void             YAC_VCALL vtable_entry_2_42_reserved      (void);

  1255.   virtual void             YAC_VCALL vtable_entry_2_43_reserved      (void);

  1256.   virtual void             YAC_VCALL vtable_entry_2_44_reserved      (void);

  1257.   virtual void             YAC_VCALL vtable_entry_2_45_reserved      (void);

  1258.   virtual void             YAC_VCALL vtable_entry_2_46_reserved      (void);

  1259.   virtual void             YAC_VCALL vtable_entry_2_47_reserved      (void);

  1260. 

  1261.    // ---- 

  1262.    // ---- 

  1263.    // ---- LEVEL (1<<3) interface 

  1264.    // ----                    ( serialization support )

  1265.    // ---- 

  1266.    // ---- 

  1267.    // ---- 

  1268.   virtual void             YAC_VCALL yacSerializeClassName           (YAC_Object *_ofs);                      // write pascal style string (sU32 len + string chars) to stream _ofs. may differ from yacClassName()

  1269.   virtual void             YAC_VCALL yacSerialize                    (YAC_Object *_ofs, sUI _usetypeinfo);    // serialize object into _ofs stream

  1270.   virtual sUI              YAC_VCALL yacDeserialize                  (YAC_Object *_ifs, sUI _usetypeinfo);    // deserialize object from _ifs stream

  1271.   virtual void             YAC_VCALL vtable_entry_3_3_reserved       (void);

  1272.   virtual void             YAC_VCALL vtable_entry_3_4_reserved       (void);

  1273.   virtual void             YAC_VCALL vtable_entry_3_5_reserved       (void);

  1274.   virtual void             YAC_VCALL vtable_entry_3_6_reserved       (void);

  1275.   virtual void             YAC_VCALL vtable_entry_3_7_reserved       (void);

  1276.   virtual void             YAC_VCALL vtable_entry_3_8_reserved       (void);

  1277.   virtual void             YAC_VCALL vtable_entry_3_9_reserved       (void);

  1278.   virtual void             YAC_VCALL vtable_entry_3_10_reserved      (void);

  1279.   virtual void             YAC_VCALL vtable_entry_3_11_reserved      (void);

  1280.   virtual void             YAC_VCALL vtable_entry_3_12_reserved      (void);

  1281.   virtual void             YAC_VCALL vtable_entry_3_13_reserved      (void);

  1282.   virtual void             YAC_VCALL vtable_entry_3_14_reserved      (void);

  1283.   virtual void             YAC_VCALL vtable_entry_3_15_reserved      (void);

  1284. 

  1285.    // ---- 

  1286.    // ---- 

  1287.    // ---- LEVEL (1<<4) interface 

  1288.    // ----                    ( iterator support )

  1289.    // ---- 

  1290.    // ---- 

  1291.    // ---- 

  1292.   virtual sBool            YAC_VCALL yacIteratorInit                 (YAC_Iterator *) const;                  // initialize iterator for a container-like object. The maximum size of an iterator is YAC_MAX_ITERATOR_SIZE bytes.

  1293.   virtual void             YAC_VCALL vtable_entry_4_1_reserved       (void);

  1294.   virtual void             YAC_VCALL vtable_entry_4_2_reserved       (void);

  1295.   virtual void             YAC_VCALL vtable_entry_4_3_reserved       (void);

  1296.   virtual void             YAC_VCALL vtable_entry_4_4_reserved       (void);

  1297.   virtual void             YAC_VCALL vtable_entry_4_5_reserved       (void);

  1298.   virtual void             YAC_VCALL vtable_entry_4_6_reserved       (void);

  1299.   virtual void             YAC_VCALL vtable_entry_4_7_reserved       (void);

  1300.   virtual void             YAC_VCALL vtable_entry_4_8_reserved       (void);

  1301.   virtual void             YAC_VCALL vtable_entry_4_9_reserved       (void);

  1302.   virtual void             YAC_VCALL vtable_entry_4_10_reserved      (void);

  1303.   virtual void             YAC_VCALL vtable_entry_4_11_reserved      (void);

  1304.   virtual void             YAC_VCALL vtable_entry_4_12_reserved      (void);

  1305.   virtual void             YAC_VCALL vtable_entry_4_13_reserved      (void);

  1306.   virtual void             YAC_VCALL vtable_entry_4_14_reserved      (void);

  1307.   virtual void             YAC_VCALL vtable_entry_4_15_reserved      (void);

  1308. 

  1309.    // ---- 

  1310.    // ---- 

  1311.    // ---- LEVEL (1<<5) interface 

  1312.    // ----                    ( array and hashtable support )

  1313.    // ---- 

  1314.    // ---- 

  1315.    // ---- 

  1316.   virtual YAC_Object      *YAC_VCALL yacArrayNew                     (void);                                              // return array class instance for "scalar" type. e.g. return yac_host->yacNew("MyClassArray");

  1317.   virtual sUI              YAC_VCALL yacArrayAlloc                   (sUI _sx, sUI _sy=0, sUI _type=0, sUI _elementbytesize=0); // allocate new array elements

  1318.   virtual sUI              YAC_VCALL yacArrayRealloc                 (sUI _sx, sUI _sy=0, sUI _type=0, sUI _elementbytesize=0); // re-allocate new array elements

  1319.   virtual sUI              YAC_VCALL yacArrayGetNumElements          (void);                                              // return number of used elements in array

  1320.   virtual sUI              YAC_VCALL yacArrayGetMaxElements          (void);                                              // return maximum array size (buffer size)

  1321.   virtual void             YAC_VCALL yacArrayCopySize                (YAC_Object *_arrayobject);                          // copy size of other array object (used to construct arrays from default objects, e.g. a class template)

  1322.   virtual void             YAC_VCALL yacArraySet                     (void *_context, sUI _index, YAC_Value *_value);     // set an array value

  1323.   virtual void             YAC_VCALL yacArrayGet                     (void *_context, sUI _index, YAC_Value *_r);         // get an array value (references only)

  1324.   virtual sUI              YAC_VCALL yacArrayGetWidth                (void);                                              // get width of array object (x maxElements)

  1325.   virtual sUI              YAC_VCALL yacArrayGetHeight               (void);                                              // get height of array object (y maxElements)

  1326.   virtual sUI              YAC_VCALL yacArrayGetElementType          (void);                                              // 0=no array,1=int,2=float,3=object,4=string

  1327.   virtual sUI              YAC_VCALL yacArrayGetElementByteSize      (void);                                              // # of bytes per element

  1328.   virtual sUI              YAC_VCALL yacArrayGetStride               (void);                                              // # of bytes to next row

  1329.   virtual void            *YAC_VCALL yacArrayGetPointer              (void);                                              // get pointer to first element of array object

  1330.   virtual void             YAC_VCALL yacArraySetWidth                (sUI);                                               // set # of used elements

  1331.   virtual void             YAC_VCALL yacArraySetTemplate             (YAC_Object *);                                      // set template for yacArrayAlloc(). Used for object and class arrays.

  1332.   virtual void             YAC_VCALL yacArrayGetDeref                (void *_context, sUI _index, YAC_Value *_r);         // get/unlink value from array

  1333.   virtual void             YAC_VCALL vtable_entry_5_17_reserved      (void);

  1334.   virtual void             YAC_VCALL vtable_entry_5_18_reserved      (void);

  1335.   virtual void             YAC_VCALL vtable_entry_5_19_reserved      (void);

  1336.   virtual void             YAC_VCALL vtable_entry_5_20_reserved      (void);

  1337.   virtual void             YAC_VCALL vtable_entry_5_21_reserved      (void);

  1338.   virtual void             YAC_VCALL vtable_entry_5_22_reserved      (void);

  1339.   virtual void             YAC_VCALL vtable_entry_5_23_reserved      (void);

  1340.   virtual void             YAC_VCALL vtable_entry_5_24_reserved      (void);

  1341.   virtual void             YAC_VCALL vtable_entry_5_25_reserved      (void);

  1342.   virtual void             YAC_VCALL vtable_entry_5_26_reserved      (void);

  1343.   virtual void             YAC_VCALL vtable_entry_5_27_reserved      (void);

  1344.   virtual void             YAC_VCALL vtable_entry_5_28_reserved      (void);

  1345.   virtual void             YAC_VCALL vtable_entry_5_29_reserved      (void);

  1346.   virtual void             YAC_VCALL vtable_entry_5_30_reserved      (void);

  1347.   virtual void             YAC_VCALL vtable_entry_5_31_reserved      (void);

  1348.   virtual void             YAC_VCALL yacHashSet                      (void *_context, YAC_String*_key, YAC_Value *_value);                // set value 

  1349.   virtual void             YAC_VCALL yacHashGet                      (void *_context, YAC_String*_key, YAC_Value *_r);                    // get value (reference) 

  1350.   virtual void             YAC_VCALL yacHashGetDeref                 (void *_context, YAC_String*_key, YAC_Value *_r);                    // get value 

  1351.   virtual void             YAC_VCALL vtable_entry_5_35_reserved      (void);

  1352.   virtual void             YAC_VCALL vtable_entry_5_36_reserved      (void);

  1353.   virtual void             YAC_VCALL vtable_entry_5_37_reserved      (void);

  1354.   virtual void             YAC_VCALL vtable_entry_5_38_reserved      (void);

  1355.   virtual void             YAC_VCALL vtable_entry_5_39_reserved      (void);

  1356. 

  1357.    // ---- 

  1358.    // ---- 

  1359.    // ---- LEVEL (1<<6) interface 

  1360.    // ----                    ( metaclass support )

  1361.    // ---- 

  1362.    // ---- 

  1363.    // ---- 

  1364.   virtual sChar           *YAC_VCALL yacMetaClassName                (void);                                // get meta class class name of object (e.g. user defined class name)

  1365.   virtual sUI              YAC_VCALL yacMetaClassMemberGetNum        (void);                                // get number of members

  1366.   virtual sUI              YAC_VCALL yacMetaClassMemberGetAccessKeyByIndex  (sUI _idx);                     // get access key to member nr. _idx

  1367.   virtual sUI              YAC_VCALL yacMetaClassMemberGetAccessKeyByName   (const sChar *_name);           // get access key to member called _name

  1368.   virtual sUI              YAC_VCALL yacMetaClassMemberGetType       (sUI _accesskey);                      // get member type (0=void,1=int,2=float,3=object)

  1369.   virtual sChar           *YAC_VCALL yacMetaClassMemberGetName       (sUI _accesskey);                      // get member name by access key

  1370.   virtual void             YAC_VCALL yacMetaClassMemberSet           (sUI _accesskey, YAC_Value *_value);   // set member value

  1371.   virtual void             YAC_VCALL yacMetaClassMemberGet           (sUI _accesskey, YAC_Value *_r);       // get member value

  1372.   virtual sSI              YAC_VCALL yacMetaClassInstanceOf          (YAC_Object *_object);                 // check if this is an instance of _object meta class type

  1373.   virtual void             YAC_VCALL vtable_entry_6_10_reserved      (void);

  1374.   virtual void             YAC_VCALL vtable_entry_6_11_reserved      (void);

  1375.   virtual void             YAC_VCALL vtable_entry_6_12_reserved      (void);

  1376.   virtual void             YAC_VCALL vtable_entry_6_13_reserved      (void);

  1377.   virtual void             YAC_VCALL vtable_entry_6_14_reserved      (void);

  1378.   virtual void             YAC_VCALL vtable_entry_6_15_reserved      (void);

  1379. 

  1380.    // ---- 

  1381.    // ---- 

  1382.    // ---- LEVEL (1<<7) interface 

  1383.    // ----                    ( signal/callback support )

  1384.    // ---- 

  1385.    // ---- 

  1386.    // ---- 

  1387.   virtual void             YAC_VCALL yacRegisterSignal               (sUI _id, YAC_FunctionHandle _f);        // register script function callback for signal _id (sequential index of signal name in signal list, see below)

  1388.   virtual void             YAC_VCALL yacGetSignalStringList          (YAC_String *_retstring);                // write signal name+rtti list to _retstring. example: "onSignal:1 onKeyboard:3 onMouse:85 ". the signals are enumerated (starting with 0) , see yacRegisterSignal()

  1389. 

  1390.    // ---- 

  1391.    // ---- 

  1392.    // ---- non-virtual helper methods

  1393.    // ---- 

  1394.    // ---- 

  1395.    // ---- 

  1396.   YAC_Object      * yacNew                   (YAC_ContextHandle _context); // call yacNewObject() and yacOperatorInit()

  1397.   YAC_Object      * yacNewPooled             (YAC_ContextHandle _context, sUI _poolHint); // call yacNewObject() and yacOperatorInit()

  1398.   sBool             yacCanDeserializeClass   (YAC_Object *_stream);   // read up to 64 chars from stream and compare with class name. implemented below.

  1399.   sBool             yacInstanceOf            (YAC_Object *_object);   // check if this is an instance of _object class type

  1400. 

  1401. 

  1402. #ifdef YAC_OBJECT_YAC

  1403.    // ---- YAC interface for YAC_Object itself 

  1404.    YM void _yacClassName                     (YAC_Value *_r);

  1405.    YM void _yacNewObject                     (YAC_Value *_r);

  1406.    // ---- m e m b e r s

  1407.    YM sSI  _yacMemberGetNum                  (void);

  1408.    YM void _yacMemberGetNames                (YAC_Value *_r);

  1409.    YM void _yacMemberGetTypes                (YAC_Value *_r);

  1410.    YM void _yacMemberGetObjectTypes          (YAC_Value *_r);

  1411.    YM void _yacMemberGetOffsets              (YAC_Value *_r);

  1412.    // ---- m e t h o d s

  1413.    YM sSI  _yacMethodGetNum                  (void);

  1414.    YM void _yacMethodGetNames                (YAC_Value *_r);

  1415.    YM void _yacMethodGetNumParameters        (YAC_Value *_r);

  1416.    YM void _yacMethodGetParameterTypes       (YAC_Value *_r);

  1417.    YM void _yacMethodGetParameterObjectTypes (YAC_Value *_r);

  1418.    YM void _yacMethodGetReturnTypes          (YAC_Value *_r);

  1419.    YM void _yacMethodGetReturnObjectTypes    (YAC_Value *_r);

  1420.    YM void _yacMethodGetAdr                  (YAC_Value *_r);

  1421.    // ---- c o n s t a n t s

  1422.    YM sSI  _yacConstantGetNum                (void);

  1423.    YM void _yacConstantGetNames              (YAC_Value *_r);

  1424.    YM void _yacConstantGetTypes              (YAC_Value *_r);

  1425.    YM void _yacConstantGetValues             (YAC_Value *_r);

  1426.    // ---- o p e r a t o r s

  1427.    YM sSI  _yacCopy                          (YAC_Object *_os);

  1428.    YM sSI  _yacEquals                        (YAC_Object *_ro);

  1429.    YM void _yacOperator                      (sSI _cmd, YAC_Object *_ro, YAC_Value *_r);

  1430.    YM void _yacOperatorInit                  (YAC_Object *_ro);

  1431.    YM void _yacOperatorAssign                (YAC_Object *_ro);

  1432.    YM void _yacOperatorAdd                   (YAC_Object *_ro);

  1433.    YM void _yacOperatorSub                   (YAC_Object *_ro);

  1434.    YM void _yacOperatorMul                   (YAC_Object *_ro);

  1435.    YM void _yacOperatorDiv                   (YAC_Object *_ro);

  1436.    YM void _yacOperatorClamp                 (YAC_Object *_min, YAC_Object *_max);

  1437.    YM void _yacOperatorWrap                  (YAC_Object *_min, YAC_Object *_max);

  1438.    YM sSI  _yacScanI32                       (YAC_Object *_vo);

  1439.    YM sSI  _yacScanI64                       (YAC_Object *_vo);

  1440.    YM sSI  _yacScanF32                       (YAC_Object *_vo);

  1441.    YM sSI  _yacScanF64                       (YAC_Object *_vo);

  1442.    YM sSI  _yacToString                      (YAC_Object *_s) const;

  1443.    YM void _yacOperatorI                     (sSI _cmd, sSI _i, YAC_Value *_r);

  1444.    YM void _yacOperatorI64                   (sSI _cmd, YAC_Object *_no, YAC_Value *_r);

  1445.    YM void _yacOperatorF32                   (sSI _cmd, sF32 _f32, YAC_Value *_r);

  1446.    YM void _yacOperatorF64                   (sSI _cmd, YAC_Object *_no, YAC_Value *_r);

  1447.    YM void _yacValueOfI                      (sSI _i);

  1448.    YM void _yacValueOfF32                    (sF32 _f32);

  1449.    YM void _yacValueOfF64                    (YAC_Object *_no);

  1450.    YM void _yacValueOfI64                    (YAC_Object *_no);

  1451.    YM sSI  _yacToParsableString              (YAC_Object *_s) const;

  1452.    // ---- s t r e a m s

  1453.    YM sSI  _yacIsStream                      (void); 

  1454.    YM void _yacStreamClose                   (void);

  1455.    YM sSI  _yacStreamOpenLocal               (YAC_Object *_name, sSI _access);

  1456.    YM sSI  _yacStreamOpenLogic               (YAC_Object *_name);

  1457.    YM sSI  _yacStreamGetByteOrder            (void);

  1458.    YM void _yacStreamSetByteOrder            (sSI _order);

  1459.    YM sSI  _yacStreamEOF                     (void);

  1460.    YM void _yacStreamSeek                    (sSI _off, sSI _mode);

  1461.    YM sSI  _yacStreamGetOffset               (void);

  1462.    YM void _yacStreamSetOffset               (sSI _off);

  1463.    YM sSI  _yacStreamGetSize                 (void);

  1464.    YM sSI  _yacStreamRead                    (YAC_Object *_ret, sSI _num);

  1465.    YM sSI  _yacStreamReadI8                  (void);

  1466.    YM sSI  _yacStreamReadI16                 (void);

  1467.    YM sSI  _yacStreamReadI32                 (void);

  1468.    YM void _yacStreamReadI64                 (YAC_Value *_r);

  1469.    YM sF32 _yacStreamReadF32                 (void);

  1470.    YM void _yacStreamReadF64                 (YAC_Value *_r);

  1471.    YM void _yacStreamReadObject              (YAC_Object *_p);

  1472.    YM sSI  _yacStreamReadString              (YAC_Object *_s, sSI _maxlen);

  1473.    YM sSI  _yacStreamReadBuffer              (YAC_Object *_buffer, sSI _off, sSI _num, sSI _resize);

  1474.    YM sSI  _yacStreamReadLine                (YAC_Object *_s, sSI _maxlen);

  1475.    YM sSI  _yacStreamWrite                   (YAC_Object *_in, sSI _num);

  1476.    YM void _yacStreamWriteI8                 (sSI _i);

  1477.    YM void _yacStreamWriteI16                (sSI _i);

  1478.    YM void _yacStreamWriteI32                (sSI _i);

  1479.    YM void _yacStreamWriteI64                (YAC_Object *_no);

  1480.    YM void _yacStreamWriteF32                (sF32 _f);

  1481.    YM void _yacStreamWriteF64                (YAC_Object *_no);

  1482.    YM void _yacStreamWriteObject             (YAC_Object *_p);

  1483.    YM sSI  _yacStreamWriteString             (YAC_Object *_s, sSI _off, sSI _num);

  1484.    YM sSI  _yacStreamWriteBuffer             (YAC_Object *_b, sSI _off, sSI _num);

  1485.    YM sSI  _yacStreamGetErrorCode            (void);

  1486.    YM void _yacStreamGetErrorStringByCode    (sSI _code, YAC_Value *_r);

  1487.    YM void _yacSerializeClassName            (YAC_Object *_ofs);

  1488.    YM void _yacSerialize                     (YAC_Object *_ofs, sSI _usetypeinfo);

  1489.    YM sSI  _yacDeserialize                   (YAC_Object *_ifs, sSI _usetypeinfo);

  1490.    // ---- i t e r a t o r s

  1491.    // ...

  1492.    // ---- a r r a y s   /   h a s h t a b l e s

  1493.    YM void _yacArrayNew                      (YAC_Value *_r);

  1494.    YM sSI  _yacArrayAlloc                    (sSI _sx, sSI _sy, sSI _type, sSI _ebytesize);

  1495.    YM sSI  _yacArrayRealloc                  (sSI _sx, sSI _sy, sSI _type, sSI _ebytesize);

  1496.    YM sSI  _yacArrayGetNumElements           (void);

  1497.    YM sSI  _yacArrayGetMaxElements           (void);

  1498.    YM void _yacArrayCopySize                 (YAC_Object *_p);

  1499.    YM void _yacArraySet                      (sSI _index, YAC_Object *_value);

  1500.    YM void _yacArrayGet                      (sSI _index, YAC_Value *_r);

  1501.    YM sSI  _yacArrayGetWidth                 (void);

  1502.    YM sSI  _yacArrayGetHeight                (void);

  1503.    YM sSI  _yacArrayGetElementType           (void);

  1504.    YM sSI  _yacArrayGetElementByteSize       (void);

  1505.    YM sSI  _yacArrayGetStride                (void);

  1506.    YM sSI  _yacArrayGetPointer               (void);

  1507.    YM void _yacArraySetWidth                 (sSI _width);

  1508.    YM void _yacArraySetTemplate              (YAC_Object *_template);

  1509.    YM void _yacArrayGetDeref                 (sSI _index, YAC_Value *_r);

  1510.    YM void _yacHashSet                       (YAC_Object *_key, YAC_Object *_value);

  1511.    YM void _yacHashGet                       (YAC_Object *_key, YAC_Value *_r);

  1512.    YM void _yacHashGetDeref                  (YAC_Object *_key, YAC_Value *_r);

  1513.    // ---- s i g n a l s

  1514.    YM void _yacGetSignalStringList           (YAC_Object *_s);

  1515.    // ---- m e t a c l a s s e s

  1516.    YM void _yacMetaClassName                      (YAC_Value *_r);

  1517.    YM sSI  _yacMetaClassMemberGetNum              (void);

  1518.    YM sSI  _yacMetaClassMemberGetAccessKeyByIndex (sSI _index);

  1519.    YM sSI  _yacMetaClassMemberGetAccessKeyByName  (YAC_Object *_s);

  1520.    YM sSI  _yacMetaClassMemberGetType             (sSI _ak);

  1521.    YM void _yacMetaClassMemberGetName             (sSI _ak, YAC_Value *_r);

  1522.    YM void _yacMetaClassMemberSet                 (sSI _ak, YAC_Object *_value);

  1523.    YM void _yacMetaClassMemberGet                 (sSI _ak, YAC_Value *_r);

  1524.    YM sSI  _yacMetaClassInstanceOf                (YAC_Object *_o);

  1525.    // ---- n o n - v i r t u a l

  1526.    YM void _yacNew                                (YAC_Value *_r);

  1527.    YM sSI  _yacCanDeserializeClass                (YAC_Object *_ifs);

  1528.    YM sSI  _yacInstanceOf                         (YAC_Object *_o);

  1529. #endif

  1530. 

  1531.    

  1532. };

  1533. 

  1534. YAC_API void YAC_CALL Object__operator(void*,yacmemptr,YAC_Value*);

  1535. 

  1536. #ifdef YAC_OBJECT_YAC

  1537. // ---- forward declarations for external YAC_Object YAC interface implementation ----

  1538. YAC_APIC void YAC_CALL yac_object_yacClassName                    (YAC_Object *_this, YAC_Value *_r);

  1539. YAC_APIC void YAC_CALL yac_object_yacNewObject                    (YAC_Object *_this, YAC_Value *_r);

  1540. 

  1541. // ---- m e m b e r s

  1542. YAC_APIC sSI  YAC_CALL yac_object_yacMemberGetNum                 (YAC_Object *_this);

  1543. YAC_APIC void YAC_CALL yac_object_yacMemberGetNames               (YAC_Object *_this, YAC_Value *_r);

  1544. YAC_APIC void YAC_CALL yac_object_yacMemberGetTypes               (YAC_Object *_this, YAC_Value *_r);

  1545. YAC_APIC void YAC_CALL yac_object_yacMemberGetObjectTypes         (YAC_Object *_this, YAC_Value *_r);

  1546. YAC_APIC void YAC_CALL yac_object_yacMemberGetOffsets             (YAC_Object *_this, YAC_Value *_r);

  1547. 

  1548. // ---- m e t h o d s

  1549. YAC_APIC sSI  YAC_CALL yac_object_yacMethodGetNum                 (YAC_Object *_this);

  1550. YAC_APIC void YAC_CALL yac_object_yacMethodGetNames               (YAC_Object *_this, YAC_Value *_r);

  1551. YAC_APIC void YAC_CALL yac_object_yacMethodGetNumParameters       (YAC_Object *_this, YAC_Value *_r);

  1552. YAC_APIC void YAC_CALL yac_object_yacMethodGetParameterTypes      (YAC_Object *_this, YAC_Value *_r);

  1553. YAC_APIC void YAC_CALL yac_object_yacMethodGetParameterObjectTypes(YAC_Object *_this, YAC_Value *_r);

  1554. YAC_APIC void YAC_CALL yac_object_yacMethodGetReturnTypes         (YAC_Object *_this, YAC_Value *_r);

  1555. YAC_APIC void YAC_CALL yac_object_yacMethodGetReturnObjectTypes   (YAC_Object *_this, YAC_Value *_r);

  1556. YAC_APIC void YAC_CALL yac_object_yacMethodGetAdr                 (YAC_Object *_this, YAC_Value *_r);

  1557. 

  1558. // ---- c o n s t a n t s

  1559. YAC_APIC sSI  YAC_CALL yac_object_yacConstantGetNum               (YAC_Object *_this);

  1560. YAC_APIC void YAC_CALL yac_object_yacConstantGetNames             (YAC_Object *_this, YAC_Value *_r);

  1561. YAC_APIC void YAC_CALL yac_object_yacConstantGetTypes             (YAC_Object *_this, YAC_Value *_r);

  1562. YAC_APIC void YAC_CALL yac_object_yacConstantGetValues            (YAC_Object *_this, YAC_Value *_r);

  1563. 

  1564. // ---- o p e r a t o r s

  1565. YAC_APIC sSI  YAC_CALL yac_object_yacCopy                         (YAC_Object *_this, YAC_Object *_os);

  1566. YAC_APIC sSI  YAC_CALL yac_object_yacEquals                       (YAC_Object *_this, YAC_Object *_ro);

  1567. YAC_APIC void YAC_CALL yac_object_yacOperator                     (YAC_Object *_this, sSI _cmd, YAC_Object *_ro, YAC_Value *_r);

  1568. YAC_APIC void YAC_CALL yac_object_yacOperatorInit                 (YAC_Object *_this, YAC_Object *_ro);

  1569. YAC_APIC void YAC_CALL yac_object_yacOperatorAssign               (YAC_Object *_this, YAC_Object *_ro);

  1570. YAC_APIC void YAC_CALL yac_object_yacOperatorAdd                  (YAC_Object *_this, YAC_Object *_ro);

  1571. YAC_APIC void YAC_CALL yac_object_yacOperatorSub                  (YAC_Object *_this, YAC_Object *_ro);

  1572. YAC_APIC void YAC_CALL yac_object_yacOperatorMul                  (YAC_Object *_this, YAC_Object *_ro);

  1573. YAC_APIC void YAC_CALL yac_object_yacOperatorDiv                  (YAC_Object *_this, YAC_Object *_ro);

  1574. YAC_APIC void YAC_CALL yac_object_yacOperatorClamp                (YAC_Object *_this, YAC_Object *_min, YAC_Object *_max);

  1575. YAC_APIC void YAC_CALL yac_object_yacOperatorWrap                 (YAC_Object *_this, YAC_Object *_min, YAC_Object *_max);

  1576. YAC_APIC sSI  YAC_CALL yac_object_yacScanI32                      (YAC_Object *_this, YAC_Object *_vo);

  1577. YAC_APIC sSI  YAC_CALL yac_object_yacScanI64                      (YAC_Object *_this, YAC_Object *_vo);

  1578. YAC_APIC sSI  YAC_CALL yac_object_yacScanF32                      (YAC_Object *_this, YAC_Object *_vo);

  1579. YAC_APIC sSI  YAC_CALL yac_object_yacScanF64                      (YAC_Object *_this, YAC_Object *_vo);

  1580. YAC_APIC sSI  YAC_CALL yac_object_yacToString                     (const YAC_Object *_this, YAC_Object *_s);

  1581. YAC_APIC void YAC_CALL yac_object_yacOperatorI                    (YAC_Object *_this, sSI _cmd, sSI _i, YAC_Value *_r);

  1582. YAC_APIC void YAC_CALL yac_object_yacOperatorI64                  (YAC_Object *_this, sSI _cmd, YAC_Object *_no, YAC_Value *_r);

  1583. YAC_APIC void YAC_CALL yac_object_yacOperatorF32                  (YAC_Object *_this, sSI _cmd, sF32 _f32, YAC_Value *_r);

  1584. YAC_APIC void YAC_CALL yac_object_yacOperatorF64                  (YAC_Object *_this, sSI _cmd, YAC_Object *_no, YAC_Value *_r);

  1585. YAC_APIC void YAC_CALL yac_object_yacValueOfI                     (YAC_Object *_this, sSI _i);

  1586. YAC_APIC void YAC_CALL yac_object_yacValueOfI64                   (YAC_Object *_this, YAC_Object *_no);

  1587. YAC_APIC void YAC_CALL yac_object_yacValueOfF32                   (YAC_Object *_this, sF32 _f32);

  1588. YAC_APIC void YAC_CALL yac_object_yacValueOfF64                   (YAC_Object *_this, YAC_Object *_no);

  1589. YAC_APIC sSI  YAC_CALL yac_object_yacToParsableString             (const YAC_Object *_this, YAC_Object *_s);

  1590. 

  1591. // ---- s t r e a m s

  1592. YAC_APIC sSI  YAC_CALL yac_object_yacIsStream                     (YAC_Object *_this);

  1593. YAC_APIC void YAC_CALL yac_object_yacStreamClose                  (YAC_Object *_this);

  1594. YAC_APIC sSI  YAC_CALL yac_object_yacStreamOpenLocal              (YAC_Object *_this, YAC_Object *_name, sSI _access);

  1595. YAC_APIC sSI  YAC_CALL yac_object_yacStreamOpenLogic              (YAC_Object *_this, YAC_Object *_name);

  1596. YAC_APIC sSI  YAC_CALL yac_object_yacStreamGetByteOrder           (YAC_Object *_this);

  1597. YAC_APIC void YAC_CALL yac_object_yacStreamSetByteOrder           (YAC_Object *_this, sSI _order);

  1598. YAC_APIC sSI  YAC_CALL yac_object_yacStreamEOF                    (YAC_Object *_this);

  1599. YAC_APIC void YAC_CALL yac_object_yacStreamSeek                   (YAC_Object *_this, sSI _off, sSI _mode);

  1600. YAC_APIC sSI  YAC_CALL yac_object_yacStreamGetOffset              (YAC_Object *_this);

  1601. YAC_APIC void YAC_CALL yac_object_yacStreamSetOffset              (YAC_Object *_this, sSI _off);

  1602. YAC_APIC sSI  YAC_CALL yac_object_yacStreamGetSize                (YAC_Object *_this);

  1603. YAC_APIC sSI  YAC_CALL yac_object_yacStreamRead                   (YAC_Object *_this, YAC_Object *_ret, sSI _num);

  1604. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadI8                 (YAC_Object *_this);

  1605. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadI16                (YAC_Object *_this);

  1606. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadI32                (YAC_Object *_this);

  1607. YAC_APIC void YAC_CALL yac_object_yacStreamReadI64                (YAC_Object *_this, YAC_Value *_r);

  1608. YAC_APIC sF32 YAC_CALL yac_object_yacStreamReadF32                (YAC_Object *_this);

  1609. YAC_APIC void YAC_CALL yac_object_yacStreamReadF64                (YAC_Object *_this, YAC_Value *_r);

  1610. YAC_APIC void YAC_CALL yac_object_yacStreamReadObject             (YAC_Object *_this, YAC_Object *_p);

  1611. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadString             (YAC_Object *_this, YAC_Object *_s, sSI _maxlen);

  1612. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadBuffer             (YAC_Object *_this, YAC_Object *_buf, sSI _off, sSI _n, sSI _resize);

  1613. YAC_APIC sSI  YAC_CALL yac_object_yacStreamReadLine               (YAC_Object *_this, YAC_Object *_s, sSI _maxlen);

  1614. YAC_APIC sSI  YAC_CALL yac_object_yacStreamWrite                  (YAC_Object *_this, YAC_Object *_in, sSI _num);

  1615. YAC_APIC void YAC_CALL yac_object_yacStreamWriteI8                (YAC_Object *_this, sSI _i);

  1616. YAC_APIC void YAC_CALL yac_object_yacStreamWriteI16               (YAC_Object *_this, sSI _i);

  1617. YAC_APIC void YAC_CALL yac_object_yacStreamWriteI32               (YAC_Object *_this, sSI _i);

  1618. YAC_APIC void YAC_CALL yac_object_yacStreamWriteI64               (YAC_Object *_this, YAC_Object *_no);

  1619. YAC_APIC void YAC_CALL yac_object_yacStreamWriteF32               (YAC_Object *_this, sF32 _f);

  1620. YAC_APIC void YAC_CALL yac_object_yacStreamWriteF64               (YAC_Object *_this, YAC_Object *_no);

  1621. YAC_APIC void YAC_CALL yac_object_yacStreamWriteObject            (YAC_Object *_this, YAC_Object *_p);

  1622. YAC_APIC sSI  YAC_CALL yac_object_yacStreamWriteString            (YAC_Object *_this, YAC_Object *_s, sSI _off, sSI _num);

  1623. YAC_APIC sSI  YAC_CALL yac_object_yacStreamWriteBuffer            (YAC_Object *_this, YAC_Object *_b, sSI _off, sSI _num);

  1624. YAC_APIC sSI  YAC_CALL yac_object_yacStreamGetErrorCode           (YAC_Object *_this);

  1625. YAC_APIC void YAC_CALL yac_object_yacStreamGetErrorStringByCode   (YAC_Object *_this, sSI _code, YAC_Value *_r);

  1626. 

  1627. // ---- s e r i a l i z a t i o n

  1628. YAC_APIC void YAC_CALL yac_object_yacSerializeClassName           (YAC_Object *_this, YAC_Object *_ofs);

  1629. YAC_APIC void YAC_CALL yac_object_yacSerialize                    (YAC_Object *_this, YAC_Object *_ofs, sSI _usetypeinfo);

  1630. YAC_APIC sSI  YAC_CALL yac_object_yacDeserialize                  (YAC_Object *_this, YAC_Object *_ifs, sSI _usetypeinfo);

  1631. 

  1632. // ---- i t e r a t o r s

  1633. // ---- a r r a y s   /   h a s h t a b l e s

  1634. YAC_APIC void YAC_CALL yac_object_yacArrayNew                     (YAC_Object *_this, YAC_Value *_r);

  1635. YAC_APIC sSI  YAC_CALL yac_object_yacArrayAlloc                   (YAC_Object *_this, sSI _sx, sSI _sy, sSI _type, sSI _ebytesize);

  1636. YAC_APIC sSI  YAC_CALL yac_object_yacArrayRealloc                 (YAC_Object *_this, sSI _sx, sSI _sy, sSI _type, sSI _ebytesize);

  1637. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetNumElements          (YAC_Object *_this);

  1638. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetMaxElements          (YAC_Object *_this);

  1639. YAC_APIC void YAC_CALL yac_object_yacArrayCopySize                (YAC_Object *_this, YAC_Object *_p);

  1640. YAC_APIC void YAC_CALL yac_object_yacArraySet                     (YAC_Object *_this, sSI _index, YAC_Object *_value);

  1641. YAC_APIC void YAC_CALL yac_object_yacArrayGet                     (YAC_Object *_this, sSI _index, YAC_Value *_r);

  1642. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetWidth                (YAC_Object *_this);

  1643. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetHeight               (YAC_Object *_this);

  1644. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetElementType          (YAC_Object *_this);

  1645. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetElementByteSize      (YAC_Object *_this);

  1646. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetStride               (YAC_Object *_this);

  1647. YAC_APIC sSI  YAC_CALL yac_object_yacArrayGetPointer              (YAC_Object *_this);

  1648. YAC_APIC void YAC_CALL yac_object_yacArraySetWidth                (YAC_Object *_this, sSI _width);

  1649. YAC_APIC void YAC_CALL yac_object_yacArraySetTemplate             (YAC_Object *_this, YAC_Object *_template);

  1650. YAC_APIC void YAC_CALL yac_object_yacArrayGetDeref                (YAC_Object *_this, sSI _index, YAC_Value *_r);

  1651. YAC_APIC void YAC_CALL yac_object_yacHashSet                      (YAC_Object *_this, YAC_Object *_key, YAC_Object *_value);

  1652. YAC_APIC void YAC_CALL yac_object_yacHashGet                      (YAC_Object *_this, YAC_Object *_key, YAC_Value *_r);

  1653. YAC_APIC void YAC_CALL yac_object_yacHashGetDeref                 (YAC_Object *_this, YAC_Object *_key, YAC_Value *_r);

  1654. 

  1655. // ---- s i g n a l s

  1656. YAC_APIC void YAC_CALL yac_object_yacGetSignalStringList          (YAC_Object *_this, YAC_Object *_s);

  1657. 

  1658. // ---- m e t a c l a s s e s

  1659. YAC_APIC void YAC_CALL yac_object_yacMetaClassName                      (YAC_Object *_this, YAC_Value *_r);

  1660. YAC_APIC sSI  YAC_CALL yac_object_yacMetaClassMemberGetNum              (YAC_Object *_this);

  1661. YAC_APIC sSI  YAC_CALL yac_object_yacMetaClassMemberGetAccessKeyByIndex (YAC_Object *_this, sSI _index);

  1662. YAC_APIC sSI  YAC_CALL yac_object_yacMetaClassMemberGetAccessKeyByName  (YAC_Object *_this, YAC_Object *_s);

  1663. YAC_APIC sSI  YAC_CALL yac_object_yacMetaClassMemberGetType             (YAC_Object *_this, sSI _ak);

  1664. YAC_APIC void YAC_CALL yac_object_yacMetaClassMemberGetName             (YAC_Object *_this, sSI _ak, YAC_Value *_r);

  1665. YAC_APIC void YAC_CALL yac_object_yacMetaClassMemberSet                 (YAC_Object *_this, sSI _ak, YAC_Object *_value);

  1666. YAC_APIC void YAC_CALL yac_object_yacMetaClassMemberGet                 (YAC_Object *_this, sSI _ak, YAC_Value *_r);

  1667. YAC_APIC sSI  YAC_CALL yac_object_yacMetaClassInstanceOf                (YAC_Object *_this, YAC_Object *_o);

  1668. 

  1669. // ---- n o n - v i r t u a l

  1670. YAC_APIC void YAC_CALL yac_object_yacNew                          (YAC_Object *_this, YAC_Value *_r);

  1671. YAC_APIC sSI  YAC_CALL yac_object_yacCanDeserializeClass          (YAC_Object *_this, YAC_Object *_ifs);

  1672. YAC_APIC sSI  YAC_CALL yac_object_yacInstanceOf                   (YAC_Object *_this, YAC_Object *_o);

  1673. #endif // YAC_OBJECT_YAC

  1674. 

  1675. #ifndef YAC_CUST_VALUE

  1676. // ---- YAC_Object representation of a YAC_Value ----

  1677. class YAC_API YAC_ValueObject : public YAC_Object, public YAC_Value { 

  1678. };

  1679. 

  1680. // ---- an array of YAC_Values ----

  1681. class YAC_ValueArray : public YAC_Object {

  1682. public:

  1683.     sUI          max_elements;

  1684.     sUI          num_elements;

  1685.     YAC_Value   *elements; // arbitrary int/float/Object values

  1686. 

  1687.     YAC_ValueArray(void) {

  1688.        max_elements = 0;

  1689.        num_elements = 0;

  1690.        elements = NULL;

  1691.     }

  1692. };

  1693. 

  1694. // ---- an array of YAC_Objects wrapped in YAC_Values ----

  1695. class YAC_PointerArray :  public YAC_Object {

  1696. public:

  1697.     sUI          max_elements;

  1698.     sUI          num_elements;

  1699.     YAC_Value   *elements; // only Object values allowed

  1700. 

  1701.     YAC_PointerArray(void) {

  1702.        max_elements = 0;

  1703.        num_elements = 0;

  1704.        elements = NULL;

  1705.     }

  1706. 

  1707.     sBool realloc       (sUI _maxElements);

  1708.     sBool add           (YAC_Object *_o, sBool _bDelete);

  1709.     void  removeIndex   (sUI _idx);

  1710.     sSI   indexOfPointer(YAC_Object *_o, sUI _off);

  1711.     

  1712. };

  1713. #endif // YAC_CUST_VALUE

  1714. 

  1715. #ifndef YAC_CUST_EVENT

  1716. // ---- event class; a time-stamped String ----

  1717. class YAC_API YAC_Event : public YAC_ValueObject {

  1718. public:

  1719. 	sSI id;

  1720.    sSI sub_id;

  1721. public:

  1722. 	YAC_Event (void);

  1723. 	~YAC_Event();

  1724. };

  1725. #endif // YAC_CUST_EVENT

  1726. 

  1727. 

  1728. // ---- seek modes for streams, see yacStreamSeek() ----

  1729. enum __yac_stream_seekmodes {

  1730.    YAC_BEG          =0,

  1731.    YAC_CUR          =1,

  1732.    YAC_END          =2

  1733. };

  1734. 

  1735. // ---- byte order for streams, see yacStreamGetByteOrder(), yacStreamSetByteOrder()

  1736. enum __yac_stream_byteorder {

  1737.    YAC_LITTLEENDIAN =0,

  1738.    YAC_BIGENDIAN    =1

  1739. };

  1740. 

  1741. // ---- open modes for yacStreamOpenLocal()

  1742. enum __yac_stream_openmodes {

  1743.    YAC_IOS_IN            =0,

  1744.    YAC_IOS_OUTIN         =1,

  1745.    YAC_IOS_INOUT         =2

  1746. };

  1747. 

  1748. // ---- file stream types

  1749. enum __yac_stream_openmodesx {

  1750.    YAC_LOGIC             =0,

  1751.    YAC_LOCAL             =1

  1752. };

  1753. 

  1754. // ---- error codes for yacStream*() interface, see yacStreamGetErrorCode()

  1755. enum __streamerrorcodes {

  1756.     YAC_NOERROR       =0,

  1757.     YAC_ERRINVALIDSEEK=1,

  1758.     YAC_ERRIO,

  1759.     YAC_ERRCREATEFILE,

  1760.     YAC_ERROPENFILE,

  1761.     YAC_ERRPAD

  1762. };

  1763. 

  1764. // ---- also see Object::serialize(), Object::deserialize() ----

  1765. #define YAC_IS_STREAM(a)       ((a)&&((a)->yacIsStream()))                                                                         // test if class supports the stream interface

  1766. #define YAC_BEG_DESERIALIZE()  if((_rtti)&&!yacCanDeserializeClass((_ifs)))return 0                                                // start object deserialization, read string from stream and compare with class name

  1767. #define YAC_BEG_SERIALIZE()    if(_rtti){YAC_String s;char *t=(char*)yacMetaClassName();if(!t)t=(char*)yacClassName();s.visit(t);_ofs->yacStreamWriteString(&s, 0, s.length);} // start object serialization, write (meta) class name string into stream

  1768. #define YAC_SERIALIZE_I8(a)    _ofs->yacStreamWriteI8(a)      // write a byte (8bit)

  1769. #define YAC_SERIALIZE_I16(a)   _ofs->yacStreamWriteI16(a)     // write a 16bit word (with transparent byteorder conversion)

  1770. #define YAC_SERIALIZE_I32(a)   _ofs->yacStreamWriteI32(a)     // write a 32bit double word (with transparent byteorder conversion)

  1771. #define YAC_SERIALIZE_I64(a)   _ofs->yacStreamWriteI64(a)     // write a 64bit quad word (with transparent byteorder conversion)

  1772. #define YAC_SERIALIZE_F32(a)   _ofs->yacStreamWriteF32(a)     // write a 32bit IEEE float

  1773. #define YAC_SERIALIZE_F64(a)   _ofs->yacStreamWriteF64(a)     // write a 64bit IEEE double

  1774. #define YAC_SERIALIZE_OBJ(a)   _ofs->yacStreamWriteObject(a)  // write an object

  1775. #define YAC_DESERIALIZE_I8()   _ifs->yacStreamReadI8()        // read a byte (8bit)

  1776. #define YAC_DESERIALIZE_I16()  _ifs->yacStreamReadI16()       // read a 16bit word (with transparent byteorder conversion)

  1777. #define YAC_DESERIALIZE_I32()  _ifs->yacStreamReadI32()       // read a 32bit double word (with transparent byteorder conversion)

  1778. #define YAC_DESERIALIZE_I64()  _ifs->yacStreamReadI64()       // read a 64bit quad word (with transparent byteorder conversion)

  1779. #define YAC_DESERIALIZE_F32()  _ifs->yacStreamReadF32()       // read a 32bit IEEE float

  1780. #define YAC_DESERIALIZE_F64()  _ifs->yacStreamReadF64()       // read a 64bit IEEE double

  1781. #define YAC_DESERIALIZE_OBJ(a) _ifs->yacStreamReadObject(a)   // read an object

  1782. 

  1783. // ---- base stream class with no methods ----

  1784. #ifndef YAC_CUST_STREAMBASE

  1785. class YAC_API YAC_StreamBase : public YAC_Object {

  1786. public:

  1787. 	sUI byteOrder;

  1788. };

  1789. #ifndef YAC_CUST_BUFFER

  1790. // ---- a binary buffer that supports the yacStream interface ----

  1791. class YAC_Buffer : public YAC_StreamBase {

  1792. public:

  1793. 	sUI   size;

  1794. 	sUI   io_offset;

  1795. 	sU8 * buffer;

  1796.    sBool deleteme;

  1797. public:

  1798.           YAC_Buffer                 (void);                          //

  1799.           ~YAC_Buffer                ();                              //

  1800. 

  1801.     void  YAC_VCALL yacArraySet                (void *_context, sUI _index, YAC_Value *_value)  override; // set a single value

  1802.     void  YAC_VCALL yacArrayGet                (void *_context, sUI _index, YAC_Value *_r)  override;     // read a single value

  1803.     sUI   YAC_VCALL yacArrayGetWidth           (void) override;                 // get number of elements/lines

  1804.     sUI   YAC_VCALL yacArrayGetHeight          (void) override;                 // get number of lines

  1805.     sUI   YAC_VCALL yacArrayGetElementType     (void) override;                 // get type of element (1=int, 2=float)

  1806.     sUI   YAC_VCALL yacArrayGetElementByteSize (void) override;                 // get bytes / element (1,2,4,...)

  1807.     sUI   YAC_VCALL yacArrayGetStride          (void) override;                 // return byte offset to next line

  1808.     void *YAC_VCALL yacArrayGetPointer         (void) override;                 // return pointer to first element in first line

  1809. };

  1810. #endif

  1811. #endif // YAC_CUST_STREAMBASE

  1812. // ---- see YAC_Object::yacGetIterator() ----

  1813. class YAC_API YAC_Iterator {

  1814. public:

  1815. 	sUI current_index;

  1816. public:

  1817.                        YAC_Iterator(void); //

  1818.     virtual            ~YAC_Iterator();    //

  1819. 

  1820.     virtual void YAC_VCALL getNext(YAC_Value *); // get next value

  1821.     virtual void YAC_VCALL begin(void);          // start iteration

  1822.     virtual void YAC_VCALL end(void);            // finish iteration

  1823. };

  1824. // ---- plugin host interface -----

  1825. class YAC_API YAC_Host { 

  1826. public:

  1827.     sU8 cpp_typecast_map[YAC_MAX_CLASSES][YAC_MAX_CLASSES]; // used to test whether class b is a base class of class a, i.e. cpp_typecast_map[a_class_id][b_class_id]==1

  1828. public:

  1829.                          YAC_Host                   (void);

  1830.     virtual              ~YAC_Host                  ();

  1831. 	// ----

  1832. 	// ----

  1833. 	// ----

  1834. 	// ---- LEVEL (1<<0) interface:

  1835. 	// ----                       ( C/C++ reflection support )

  1836. 	// ----

  1837. 	// ----

  1838.     virtual sUI          YAC_VCALL yacQueryInterfaces         (void) = 0;

  1839.     virtual sUI          YAC_VCALL yacRegisterClass           (YAC_Object *_template, sUI _may_instanciate) = 0; // returns class_ID assigned by YAC_Host

  1840.     virtual YAC_Object  *YAC_VCALL yacNew                     (const char *_namespaceName, const char *_classname) = 0; // allocate unknown API object (e.g. Texture or a plugin class)

  1841.     virtual YAC_Object  *YAC_VCALL yacNewByID                 (sUI _class_ID) = 0;

  1842.     virtual void         YAC_VCALL yacDelete                  (YAC_Object *_apiobject) = 0; // delete previously allocated API object

  1843.     virtual sUI          YAC_VCALL yacGetClassIDByName        (sChar *_name) = 0;

  1844.     virtual sUI          YAC_VCALL yacRegisterFunction        (void *_adr, const char *_name, sUI _returntype, const char *_return_otype, sUI _numargs, const sUI *_argtypes, const char **_argtypenames, sUI _callstyle) = 0;

  1845.     virtual sSI          YAC_VCALL yacEvalMethodByName        (YAC_Object *_apiobject, const char *_name, YAC_Value *_args, sUI _numargs, YAC_Value *_r) = 0;  // lookup method by name, typecast arguments and evaluate. return true if everything worked OK, false if method _name was not found.

  1846.     virtual YAC_Object * YAC_VCALL yacGetClassTemplateByID    (sUI _class_ID) = 0;

  1847.     virtual YAC_Object * YAC_VCALL yacNewPooledByID           (sUI _class_ID, sUI _poolHint) = 0;

  1848.     virtual void         YAC_VCALL yacNewDeleteModifyCounter  (sSI _deltaByteSize) = 0;

  1849.     virtual sSI          YAC_VCALL yacNewDeleteGetCounter     (void) = 0;

  1850.     virtual void         YAC_VCALL vtable_entry_0_12_reserved (void) = 0;

  1851.     virtual void         YAC_VCALL vtable_entry_0_13_reserved (void) = 0;

  1852.     virtual void         YAC_VCALL vtable_entry_0_14_reserved (void) = 0;

  1853.     virtual void         YAC_VCALL vtable_entry_0_15_reserved (void) = 0;

  1854. 	// ----

  1855. 	// ----

  1856. 	// ----

  1857. 	// ---- LEVEL (1<<1) interface:

  1858. 	// ----                       ( debug support )

  1859. 	// ----

  1860. 	// ----

  1861.     virtual sUI          YAC_VCALL yacGetDebugLevel           (void) = 0;

  1862.     virtual void         YAC_VCALL yacPrint                   (const sChar *_s) = 0; // print to default debug console (stdout, stderr, or textfile)

  1863.     virtual void         YAC_VCALL vtable_entry_1_2_reserved  (void) = 0;

  1864.     virtual void         YAC_VCALL vtable_entry_1_3_reserved  (void) = 0;

  1865.     virtual void         YAC_VCALL vtable_entry_1_4_reserved  (void) = 0;

  1866.     virtual void         YAC_VCALL vtable_entry_1_5_reserved  (void) = 0;

  1867.     virtual void         YAC_VCALL vtable_entry_1_6_reserved  (void) = 0;

  1868.     virtual void         YAC_VCALL vtable_entry_1_7_reserved  (void) = 0;

  1869. 	// ----

  1870. 	// ----

  1871. 	// ----

  1872. 	// ---- LEVEL (1<<2) interface:

  1873. 	// ----                       ( string support )

  1874. 	// ----

  1875. 	// ----

  1876.     virtual sSI          YAC_VCALL yacStringReplace           (YAC_String *_d, YAC_String *_a, YAC_String *_b) = 0;

  1877.     virtual sSI          YAC_VCALL yacStringScan              (YAC_String *,sSI*) = 0;

  1878.     virtual sSI          YAC_VCALL yacStringScan              (YAC_String *,sF32*) = 0;

  1879.     virtual sUI          YAC_VCALL yacScanFlags               (YAC_String*) = 0;

  1880.     virtual void         YAC_VCALL vtable_entry_2_4_reserved  (void) = 0;

  1881.     virtual void         YAC_VCALL vtable_entry_2_5_reserved  (void) = 0;

  1882.     virtual void         YAC_VCALL vtable_entry_2_6_reserved  (void) = 0;

  1883.     virtual void         YAC_VCALL vtable_entry_2_7_reserved  (void) = 0;

  1884.     virtual void         YAC_VCALL vtable_entry_2_8_reserved  (void) = 0;

  1885.     virtual void         YAC_VCALL vtable_entry_2_9_reserved  (void) = 0;

  1886.     virtual void         YAC_VCALL vtable_entry_2_10_reserved (void) = 0;

  1887.     virtual void         YAC_VCALL vtable_entry_2_11_reserved (void) = 0;

  1888.     virtual void         YAC_VCALL vtable_entry_2_12_reserved (void) = 0;

  1889.     virtual void         YAC_VCALL vtable_entry_2_13_reserved (void) = 0;

  1890.     virtual void         YAC_VCALL vtable_entry_2_14_reserved (void) = 0;

  1891.     virtual void         YAC_VCALL vtable_entry_2_15_reserved (void) = 0;

  1892. 	// ----

  1893. 	// ----

  1894. 	// ----

  1895. 	// ---- LEVEL (1<<3) interface:

  1896. 	// ----                       ( scripting support )

  1897. 	// ----

  1898. 	// ----

  1899.     virtual sUI                YAC_VCALL yacRunning                 (void) = 0;

  1900.     virtual YAC_FunctionHandle YAC_VCALL yacFindFunction            (sChar *_name) = 0;

  1901.     virtual sUI                YAC_VCALL yacEvalFunction            (YAC_ContextHandle _context, YAC_FunctionHandle _script_function, sUI _numargs, YAC_Value *_args) = 0; // evaluate script function, e.g. used for tks signal callbacks; see YAC_Object::yacRegisterSignal(),yacGetSignalStringList(). return true or false depending on whether the function call succeeded.

  1902.     virtual YAC_ModuleHandle   YAC_VCALL yacCompileModule           (sChar *_source) = 0;

  1903.     virtual void               YAC_VCALL yacDeleteModule            (YAC_ModuleHandle _mod) = 0;

  1904.     virtual YAC_FunctionHandle YAC_VCALL yacFindFunctionInModule    (YAC_ModuleHandle _mod, sChar *_name) = 0;

  1905.     virtual YAC_VariableHandle YAC_VCALL yacFindVariableInModule    (YAC_ModuleHandle _mod, sChar *_name) = 0;

  1906.     virtual YAC_FunctionHandle YAC_VCALL yacFindVariableInFunction  (YAC_FunctionHandle _fn, sChar *_name) = 0;

  1907.     virtual void               YAC_VCALL yacSetVariable             (YAC_VariableHandle _var, YAC_Value *_v) = 0;

  1908.     virtual void               YAC_VCALL yacGetVariable             (YAC_VariableHandle _var, YAC_Value *_r) = 0;

  1909.     virtual sUI                YAC_VCALL yacEvalFunctionReturn      (YAC_ContextHandle _context, YAC_FunctionHandle _script_function, sUI _numargs, YAC_Value *_args, YAC_Value *_r) = 0; // evaluate script function, e.g. used for tks signal callbacks; see YAC_Object::yacRegisterSignal(),yacGetSignalStringList(). return true or false depending on whether the function call succeeded.

  1910.     virtual YAC_ContextHandle  YAC_VCALL yacContextCreate           (void) = 0; // Create script execution context

  1911.     virtual void               YAC_VCALL yacContextDestroy          (YAC_ContextHandle _context) = 0; // Destroy script execution context

  1912.     virtual YAC_ContextHandle  YAC_VCALL yacContextGetDefault       (void) = 0;

  1913.     virtual void               YAC_VCALL yacContextSetDefault       (YAC_ContextHandle _context) = 0; // Set default script context (for use in threads created by plugins / not by a Thread object)

  1914.     virtual void               YAC_VCALL vtable_entry_3_15_reserved (void) = 0;

  1915.     virtual void               YAC_VCALL vtable_entry_3_16_reserved (void) = 0;

  1916.     virtual void               YAC_VCALL vtable_entry_3_17_reserved (void) = 0;

  1917.     virtual void               YAC_VCALL vtable_entry_3_18_reserved (void) = 0;

  1918.     virtual void               YAC_VCALL vtable_entry_3_19_reserved (void) = 0;

  1919.     virtual void               YAC_VCALL vtable_entry_3_20_reserved (void) = 0;

  1920.     virtual void               YAC_VCALL vtable_entry_3_21_reserved (void) = 0;

  1921.     virtual void               YAC_VCALL vtable_entry_3_22_reserved (void) = 0;

  1922.     virtual void               YAC_VCALL vtable_entry_3_23_reserved (void) = 0;

  1923.     virtual void               YAC_VCALL vtable_entry_3_24_reserved (void) = 0;

  1924.     virtual void               YAC_VCALL vtable_entry_3_25_reserved (void) = 0;

  1925.     virtual void               YAC_VCALL vtable_entry_3_26_reserved (void) = 0;

  1926.     virtual void               YAC_VCALL vtable_entry_3_27_reserved (void) = 0;

  1927.     virtual void               YAC_VCALL vtable_entry_3_28_reserved (void) = 0;

  1928.     virtual void               YAC_VCALL vtable_entry_3_29_reserved (void) = 0;

  1929.     virtual void               YAC_VCALL vtable_entry_3_30_reserved (void) = 0;

  1930.     virtual void               YAC_VCALL vtable_entry_3_31_reserved (void) = 0;

  1931. 	// ----

  1932. 	// ----

  1933. 	// ----

  1934. 	// ---- LEVEL (1<<4) interface:

  1935. 	// ----                       ( event support )

  1936. 	// ----

  1937. 	// ----

  1938.     virtual void         YAC_VCALL yacSendUserEvent           (YAC_Object *_event_or_string) = 0; // send user event to running application

  1939.     virtual sUI          YAC_VCALL yacMilliSeconds            (void) = 0; // Query milliseconds since startup

  1940.     virtual void         YAC_VCALL vtable_entry_4_2_reserved  (void) = 0;

  1941.     virtual void         YAC_VCALL vtable_entry_4_3_reserved  (void) = 0;

  1942.     virtual void         YAC_VCALL vtable_entry_4_4_reserved  (void) = 0;

  1943.     virtual void         YAC_VCALL vtable_entry_4_5_reserved  (void) = 0;

  1944.     virtual void         YAC_VCALL vtable_entry_4_6_reserved  (void) = 0;

  1945.     virtual void         YAC_VCALL vtable_entry_4_7_reserved  (void) = 0;

  1946.     

  1947.     // ---- 

  1948.     // ---- 

  1949.     // ---- LEVEL (1<<5) interface 

  1950.     // ----                    ( exception support )

  1951.     // ---- 

  1952.     // ---- 

  1953.     // ---- 

  1954.     virtual YAC_ExceptionId  YAC_VCALL yacExceptionRegister       (const char *_name, sUI _baseException) = 0; // register new exception type. Return exception id or 0==registration failed

  1955.     virtual YAC_ExceptionId  YAC_VCALL yacExceptionGetIdByName    (const char *_name) = 0; // Look up ID for exception called _name

  1956.     virtual void             YAC_VCALL yacExceptionRaise          (YAC_ContextHandle _context, sUI _id, const char *_message=NULL, const char *_file=NULL, sSI _line=0) = 0; // raise new Exception with type _id.

  1957.     virtual void             YAC_VCALL vtable_entry_5_3_reserved  (void) = 0;

  1958.     virtual void             YAC_VCALL vtable_entry_5_4_reserved  (void) = 0;

  1959.     virtual void             YAC_VCALL vtable_entry_5_5_reserved  (void) = 0;

  1960.     virtual void             YAC_VCALL vtable_entry_5_6_reserved  (void) = 0;

  1961.     virtual void             YAC_VCALL vtable_entry_5_7_reserved  (void) = 0;

  1962.     virtual void             YAC_VCALL vtable_entry_5_8_reserved  (void) = 0;

  1963.     virtual void             YAC_VCALL vtable_entry_5_9_reserved  (void) = 0;

  1964. 

  1965.     // ---- 

  1966.     // ---- 

  1967.     // ---- LEVEL (1<<6) interface 

  1968.     // ----                    ( callback support )

  1969.     // ---- 

  1970.     // ---- 

  1971.     // ---- 

  1972.     virtual YAC_CallbackId   YAC_VCALL yacCallbackCreate          (const char *_name) = 0; // create named callback slot and returns callback id, -1=unable to create

  1973.     virtual YAC_CallbackId   YAC_VCALL yacCallbackGetIdByName     (const char *_name) = 0; // map callback name to slot id, -1=not found

  1974.     virtual sBool            YAC_VCALL yacCallbackSetFunById      (YAC_CallbackId _id, YAC_CFunctionPtr _fun) = 0; // register callback function for given slot, _fun=NULL => unregister

  1975.     virtual sSI              YAC_VCALL yacCallbackSetFunByName    (const char *_name, YAC_CFunctionPtr _fun) = 0; // register callback function for given slot, _fun=NULL => unregister

  1976.                                                                                    // this implicitely creates a callback slot in order to make the plugin

  1977.                                                                                    // loading order irrelevant

  1978.     virtual YAC_CFunctionPtr YAC_VCALL yacCallbackGetFunById      (YAC_CallbackId _callbackId) = 0;   // query current C function (cdecl) binding for the given callback slot

  1979.     virtual void             YAC_VCALL vtable_entry_6_6_reserved  (void) = 0;

  1980.     virtual void             YAC_VCALL vtable_entry_6_7_reserved  (void) = 0;

  1981.     virtual void             YAC_VCALL vtable_entry_6_8_reserved  (void) = 0;

  1982.     virtual void             YAC_VCALL vtable_entry_6_9_reserved  (void) = 0;

  1983. 

  1984.     // ---- 

  1985.     // ---- 

  1986.     // ---- LEVEL (1<<7) interface 

  1987.     // ----                    ( mutual exclusive semaphore support )

  1988.     // ---- 

  1989.     // ---- 

  1990.     // ---- 

  1991.     virtual YAC_MutexHandle  YAC_VCALL yacMutexCreate             (void) = 0; // Create new mutex, NULL=create failed

  1992.     virtual void             YAC_VCALL yacMutexDestroy            (YAC_MutexHandle _mutexHandle) = 0; // Destroy mutex that was created with yacMutexCreate()

  1993.     virtual YAC_MutexHandle  YAC_VCALL yacMutexFindByName         (const char *_name) = 0; // Find named sync point 

  1994.     virtual void             YAC_VCALL yacMutexLock               (YAC_MutexHandle _mutexHandle) = 0; // Lock mutex, beware of dead locks!

  1995.     virtual void             YAC_VCALL yacMutexUnlock             (YAC_MutexHandle _mutexHandle) = 0; // Unlock mutex

  1996.     virtual void             YAC_VCALL vtable_entry_7_5_reserved  (void) = 0;

  1997.     virtual void             YAC_VCALL vtable_entry_7_6_reserved  (void) = 0;

  1998.     virtual void             YAC_VCALL vtable_entry_7_7_reserved  (void) = 0;

  1999.     virtual void             YAC_VCALL vtable_entry_7_8_reserved  (void) = 0;

  2000.     virtual void             YAC_VCALL vtable_entry_7_9_reserved  (void) = 0;

  2001.     

  2002. 

  2003. 

  2004. #ifdef YAC_PRINTF

  2005. 	void printf(const char *_fmt, ...);

  2006. #endif

  2007. };

  2008. #ifndef YAC_CUST_STRING

  2009. // ---- simple String class 

  2010. // ---- Import notes: * Never delete[]chars in Strings obtained from YAC_New_String()!

  2011. // ----               * Never pass Strings NOT allocated with YAC_New_String() to the YAC_Host !

  2012. class YAC_API YAC_String : public YAC_Object {

  2013. public:

  2014. 	enum __stringflags {

  2015.       QUOT       = (1<<24),

  2016.       UTAG1      = (1<<25),

  2017.       DEL        = (1<<31)

  2018.    };

  2019. 

  2020.  public:

  2021.   sUI    buflen; // ---- total buffer size

  2022.   sUI    bflags; // ---- stringflags (e.g. deleteme flag)

  2023.   sUI    length; // ---- number of used chars in buffer

  2024.   sUI    key;    // ---- hashkey that is used for fast object comparison

  2025.   sU8   *chars;  // ---- pointer to first char in buffer

  2026.   void  *clones; // ---- internal StaticList::Node*, see tks-list.h if you need this member (used for split() string lists)

  2027.  public:

  2028.         YAC_String     (void);

  2029.         ~YAC_String    ();

  2030. 

  2031.   void  free           (void                             );  // Note: Never delete Strings obtained from the YAC_Host!

  2032.   void  visit          (const sChar *_cstring            );  // set read-only reference to (const) char array

  2033.   sBool compare        (const sChar *e                   );  // compare with "C" string (slow)

  2034.   sSI   lastIndexOf    (sChar _c, sUI _start=0           );

  2035.   sSI   indexOf        (sChar _c, sUI _start=0           );

  2036. #ifdef YAC_BIGSTRING // ---- use with care; don't mix YAC_Host/plugin *chars

  2037.   sUI   sum            (void                             );  // 

  2038.   void  genKey         (void                             );  //

  2039.   sUI   getKey         (void                             );  // 

  2040.   sBool compare        (YAC_String *s                    );  // compare with YAC_String object (fast)

  2041.   void  fixLength      (void                             );  // counter number of chars (including ASCIIZ)

  2042.   sBool alloc          (sU32 len                         );

  2043.   sBool copy           (const sChar *e                   );  // copy c-string, 

  2044.   sBool copy           (YAC_String *_s                   );  // copy YAC_String object

  2045.   sBool realloc        (sU32 len                         );  // resize string buffer

  2046.   sBool createEmpty    (void                             );   

  2047.   sBool append         (YAC_String *                     );  // append YAC_String

  2048.   sBool append         (const char *                     );  // append "C" string

  2049.   sBool substring      (YAC_String *s, sUI start, sUI len);  // extract substring

  2050.   sBool empty          (void                             );

  2051.   void  printf         (const char *_fmt, ...            );

  2052. #endif // YAC_BIGSTRING

  2053. };

  2054. 

  2055. #ifdef YAC_BIGSTRING

  2056. sUI YAC_strlen(const char *_s);

  2057. #endif

  2058. 

  2059. // ---- an array of YAC_Strings ----

  2060. class YAC_StringArray : public YAC_Object { 

  2061. public:

  2062.   sUI         max_elements;

  2063.   sUI         num_elements;

  2064.   YAC_String *elements;

  2065. 

  2066.   YAC_StringArray(void) {

  2067.      max_elements = 0;

  2068.      num_elements = 0;

  2069.      elements = NULL;

  2070.   }

  2071. };

  2072. #endif // YAC_CUST_STRING

  2073. 

  2074. #ifndef YAC_CUST_FLOATARRAY

  2075. // ---- 

  2076. class YAC_FloatArray : public YAC_Object {

  2077. public:

  2078. 	sBool own_data;

  2079.     sUI   max_elements;

  2080.     sUI   num_elements;

  2081.     sF32 *elements;

  2082. 

  2083.     YAC_FloatArray(void) {

  2084.        own_data = 0;

  2085.        max_elements = 0u;

  2086.        num_elements = 0u;

  2087.        elements = NULL;

  2088.     }

  2089. };

  2090. #endif // YAC_CUST_FLOATARRAY

  2091. 

  2092. #ifndef YAC_CUST_INTARRAY

  2093. // ----

  2094. class YAC_IntArray : public YAC_Object { 

  2095. public:

  2096. 	sSI   own_data;

  2097. 	sUI   max_elements;

  2098. 	sUI   num_elements;

  2099. 	sSI  *elements;

  2100. 

  2101.    YAC_IntArray(void) {

  2102.       own_data = 0;

  2103.       max_elements = 0u;

  2104.       num_elements = 0u;

  2105.       elements = NULL;

  2106.    }

  2107. };

  2108. #endif // YAC_CUST_INTARRAY

  2109. 

  2110. #ifndef YAC_CUST_LISTNODE

  2111. // ---- a list of value objects ----

  2112. class YAC_API YAC_ListNode : public YAC_ValueObject {

  2113. public:

  2114. 	YAC_ListNode *next;

  2115. 	YAC_ListNode *prev;

  2116. 

  2117. 	YAC_ListNode(void);

  2118. 	~YAC_ListNode();

  2119. };

  2120. 

  2121. // ---- object wrapper for a YAC_ListNode list ----

  2122. class YAC_API YAC_List : public YAC_Object { 

  2123.   YAC_ListNode *head; 

  2124.   YAC_ListNode *tail; 

  2125. 

  2126.   YAC_List(void) {

  2127.      head = NULL;

  2128.      tail = NULL;

  2129.   }

  2130. };

  2131. #endif // YAC_CUST_LISTNODE

  2132. 

  2133. #ifndef YAC_CUST_TREENODE

  2134. // ---- a tree of values ----

  2135. class YAC_API YAC_TreeNode : public YAC_ValueObject {

  2136. public:

  2137. 	YAC_TreeNode      *left;

  2138. 	YAC_TreeNode      *right;

  2139. 	YAC_TreeNode      *parent;

  2140. 	YAC_String         name;

  2141. 	YAC_String         id;

  2142. 

  2143. 	YAC_TreeNode(void);

  2144. 	~YAC_TreeNode();

  2145. };

  2146. #endif // YAC_CUST_LISTNODE

  2147. 

  2148. #ifndef YAC_CUST_NUMBEROBJECTS

  2149. // ---- Object shells/wrappers for 8-64 bit integer resp. floating point values

  2150. // ---- YAC_Number is part of the YAC_Object interface thus there is no "Number" class 

  2151. class YAC_API YAC_UnsignedByte    : public YAC_Object { public: sU8  value; };

  2152. class YAC_API YAC_Byte            : public YAC_Object { public: sS8  value; };

  2153. class YAC_API YAC_Boolean         : public YAC_Object { public: sBool value;};

  2154. class YAC_API YAC_UnsignedShort   : public YAC_Object { public: sU16 value; };

  2155. class YAC_API YAC_Short           : public YAC_Object { public: sS16 value; };

  2156. class YAC_API YAC_UnsignedInteger : public YAC_Object { public: sU32 value; };

  2157. class YAC_API YAC_Integer         : public YAC_Object { public: sS32 value; };

  2158. class YAC_API YAC_Long            : public YAC_Object { public: sS64 value; };

  2159. class YAC_API YAC_Float           : public YAC_Object { public: sF32 value; };

  2160. class YAC_API YAC_Double          : public YAC_Object { public: sF64 value; };

  2161. #endif // YAC_CUST_NUMBEROBJECTS

  2162. 

  2163. 

  2164. // ---- magic loader symbols ----

  2165. YAC_APIC void YAC_Init   (YAC_Host *); // ---- called when a plugin is (un-)loaded

  2166. YAC_APIC void YAC_Exit   (YAC_Host *); // ---- your plugin needs to define at least these

  2167. YAC_APIC sUI  YAC_Version(void      ); // ---- query plugin version information. 0xaabbccdd, e.g. 0x00050203.

  2168. 

  2169. // ---- helper macros to instanciate new YAC_Objects  ----

  2170. #define YAC_New_Boolean()         (YAC_Boolean*)         yac_host->yacNewByID (YAC_CLID_BOOLEAN        )

  2171. #define YAC_New_Byte()            (YAC_Byte*)            yac_host->yacNewByID (YAC_CLID_BYTE           )

  2172. #define YAC_New_Short()           (YAC_Short*)           yac_host->yacNewByID (YAC_CLID_SHORT          )

  2173. #define YAC_New_Integer()         (YAC_Integer*)         yac_host->yacNewByID (YAC_CLID_INTEGER        )

  2174. #define YAC_New_Long()            (YAC_Long*)            yac_host->yacNewByID (YAC_CLID_LONG           )

  2175. #define YAC_New_UnsignedByte()    (YAC_UnsignedByte*)    yac_host->yacNewByID (YAC_CLID_UNSIGNEDBYTE   )

  2176. #define YAC_New_UnsignedShort()   (YAC_UnsignedShort*)   yac_host->yacNewByID (YAC_CLID_UNSIGNEDSHORT  )

  2177. #define YAC_New_UnsignedInteger() (YAC_UnsignedInteger*) yac_host->yacNewByID (YAC_CLID_UNSIGNEDINTEGER)

  2178. #define YAC_New_Float()           (YAC_Float*)           yac_host->yacNewByID (YAC_CLID_FLOAT          )

  2179. #define YAC_New_Double()          (YAC_Double*)          yac_host->yacNewByID (YAC_CLID_DOUBLE         )

  2180. #define YAC_New_String()          (YAC_String*)          yac_host->yacNewByID (YAC_CLID_STRING         )

  2181. #define YAC_New_Event()           (YAC_Event*)           yac_host->yacNewByID (YAC_CLID_EVENT          )

  2182. #define YAC_New_Value()           (YAC_ValueObject*)     yac_host->yacNewByID (YAC_CLID_VALUE          ) 

  2183. #define YAC_New_ListNode()        (YAC_ListNode*)        yac_host->yacNewByID (YAC_CLID_LISTNODE       )

  2184. #define YAC_New_TreeNode()        (YAC_TreeNode*)        yac_host->yacNewByID (YAC_CLID_TREENODE       )

  2185. #define YAC_New_IntArray()        (YAC_IntArray*)        yac_host->yacNewByID (YAC_CLID_INTARRAY       )

  2186. #define YAC_New_FloatArray()      (YAC_FloatArray*)      yac_host->yacNewByID (YAC_CLID_FLOATARRAY     )

  2187. #define YAC_New_StringArray()     (YAC_StringArray*)     yac_host->yacNewByID (YAC_CLID_STRINGARRAY    )

  2188. #define YAC_New_ObjectArray( )    (YAC_ObjectArray*)     yac_host->yacNewByID (YAC_CLID_OBJECTARRAY    )

  2189. #define YAC_New_ClassArray()      (YAC_ClassArray*)      yac_host->yacNewByID (YAC_CLID_CLASSARRAY     )

  2190. #define YAC_New_ValueArray()      (YAC_ValueArray*)      yac_host->yacNewByID (YAC_CLID_VALUEARRAY     )

  2191. #define YAC_New_PointerArray()                           yac_host->yacNewByID (YAC_CLID_POINTERARRAY   )

  2192. #define YAC_New_HashTable()                              yac_host->yacNewByID (YAC_CLID_HASHTABLE      )

  2193. #define YAC_New_Buffer()          (YAC_Buffer*)          yac_host->yacNewByID (YAC_CLID_BUFFER         )

  2194. #define YAC_New_File()                                   yac_host->yacNewByID (YAC_CLID_FILE           )

  2195. #define YAC_New_PakFile()                                yac_host->yacNewByID (YAC_CLID_PAKFILE        )

  2196. #define YAC_New_Pipe()                                   yac_host->yacNewByID (YAC_CLID_PIPE           )

  2197. 

  2198. // ---- helper macros to check whether a YAC_Object is safe to cast to the respective type

  2199. #define YAC_Is_String(a)          YAC_BCHK(a, YAC_CLID_STRING)

  2200. #define YAC_Is_Buffer(a)          YAC_BCHK(a, YAC_CLID_BUFFER)

  2201. #define YAC_Is_IntArray(a)        YAC_BCHK(a, YAC_CLID_INTARRAY)

  2202. #define YAC_Is_FloatArray(a)      YAC_BCHK(a, YAC_CLID_FLOATARRAY)

  2203. #define YAC_Is_StringArray(a)     YAC_BCHK(a, YAC_CLID_STRINGARRAY)

  2204. #define YAC_Is_HashTable(a)       YAC_BCHK(a, YAC_CLID_HASHTABLE)

  2205. #define YAC_Is_Value(a)           YAC_BCHK(a, YAC_CLID_VALUE)

  2206. #define YAC_Is_ListNode(a)        YAC_BCHK(a, YAC_CLID_LISTNODE)

  2207. #define YAC_Is_TreeNode(a)        YAC_BCHK(a, YAC_CLID_TREENODE)

  2208. #define YAC_Is_PointerArray(a)    YAC_BCHK(a, YAC_CLID_POINTERARRAY)

  2209. #define YAC_Is_File(a)            YAC_BCHK(a, YAC_CLID_FILE)

  2210. #define YAC_Is_Boolean(a)         YAC_BCHK(a, YAC_CLID_BOOLEAN)

  2211. #define YAC_Is_UnsignedByte(a )   YAC_BCHK(a, YAC_CLID_UNSIGNEDBYTE)

  2212. #define YAC_Is_UnsignedShort(a)   YAC_BCHK(a, YAC_CLID_UNSIGNEDSHORT)

  2213. #define YAC_Is_UnsignedInteger(a) YAC_BCHK(a, YAC_CLID_UNSIGNEDINTEGER)

  2214. #define YAC_Is_Byte(a)            YAC_BCHK(a, YAC_CLID_BYTE)

  2215. #define YAC_Is_Short(a)           YAC_BCHK(a, YAC_CLID_SHORT)

  2216. #define YAC_Is_Integer(a)         YAC_BCHK(a, YAC_CLID_INTEGER)

  2217. #define YAC_Is_Long(a)            YAC_BCHK(a, YAC_CLID_LONG)

  2218. #define YAC_Is_Float(a)           YAC_BCHK(a, YAC_CLID_FLOAT)

  2219. #define YAC_Is_Double(a)          YAC_BCHK(a, YAC_CLID_DOUBLE)

  2220. 

  2221. // ---- used for e.g. scriptclasses (YAC_Object type=Class, metaclasstype=MyClass ..) ----

  2222. #define YAC_IS_METACLASS(a) ((a)->yacMetaClassName()!=0)

  2223. 

  2224. // ---- object class template macros ----

  2225. // -------- regular template ----

  2226. /* template <class T> class YAC_Template  {public:T *ctemplate; public: YAC_Template  (YAC_Host *_host) { ctemplate=new T(); _host->yacRegisterClass(ctemplate, YAC_CLASSTYPE_NORMAL); } ~YAC_Template() { delete ctemplate; } };  */

  2227. /* // -------- singleton type template, may not be instanciated ---- */

  2228. /* template <class T> class YAC_STemplate {public:T *ctemplate; public: YAC_STemplate (YAC_Host *_host) { ctemplate=new T(); _host->yacRegisterClass(ctemplate, YAC_CLASSTYPE_STATIC); } ~YAC_STemplate() { delete ctemplate; } };  */

  2229. /* // -------- interface template, objects are only created by plugins, may not be instanciated but pointer variables may be declared ---- */

  2230. /* template <class T> class YAC_RTemplate {public:T *ctemplate; public: YAC_RTemplate (YAC_Host *_host) { ctemplate=new T(); _host->yacRegisterClass(ctemplate, YAC_CLASSTYPE_NOINST); } ~YAC_RTemplate() { delete ctemplate; } };  */

  2231. 

  2232. // Note: the template objects are declared static so that operator new is never called.

  2233. template <class T> class YAC_Template  {public: T ctemplate; YAC_Template(YAC_Host *_host) { _host->yacRegisterClass(&ctemplate, YAC_CLASSTYPE_NORMAL); } ~YAC_Template() { } }; 

  2234. // -------- singleton type template, may not be instanciated ----

  2235. template <class T> class YAC_STemplate {public: T ctemplate; YAC_STemplate(YAC_Host *_host) { _host->yacRegisterClass(&ctemplate, YAC_CLASSTYPE_STATIC); } ~YAC_STemplate() { } }; 

  2236. // -------- interface template, objects are only created by plugins, may not be instanciated but pointer variables may be declared ----

  2237. template <class T> class YAC_RTemplate {public: T ctemplate; YAC_RTemplate(YAC_Host *_host) { _host->yacRegisterClass(&ctemplate, YAC_CLASSTYPE_NOINST); } ~YAC_RTemplate() { } }; 

  2238. 

  2239. 

  2240. #ifndef YAC_NO_EXPORTS

  2241. extern YAC_Host *yac_host;

  2242. #endif

  2243. 

  2244. #ifdef YAC_OBJECT_TAGS

  2245. #define YAC_VALID(a) ((a)&&((a)->validation_tag==YAC_VALID_TAG))

  2246. //#define YAC_ILL(a) ((a)?((a)->validation_tag!=YAC_VALID_TAG):0)

  2247. #else

  2248. #define YAC_VALID(a) a

  2249. //#define YAC_ILL(a) 0

  2250. #endif // YAC_OBJECT_TAGS

  2251. 

  2252. // ---- "C" function handling (0..8 args, YAC_Value *_r return) ----

  2253. // YAC_APIC const sChar*YAC_GetFunctionStringList(void);   // called to get list of "c" functions

  2254. 

  2255. 

  2256. // ----

  2257. // ----

  2258. // ---- Epsilon float comparisons

  2259. // ----

  2260. // ----

  2261. #define YAC_FLT_EPSILON 0.000001f

  2262. #define YAC_DBL_EPSILON 0.000000000001

  2263. 

  2264. #ifdef YAC_EPSILONCOMPARE_ABS

  2265. // 

  2266. // absolute epsilon floating point value comparisons (taken from tks-source/tks.h)

  2267. // 

  2268. #define Dfltnonzero_abs(a) ( ((a)>YAC_FLT_EPSILON) || ((a)<-YAC_FLT_EPSILON) )

  2269. #define Dfltequal_abs(a,b) ( (((a)-YAC_FLT_EPSILON) <= (b)) && (((a)+YAC_FLT_EPSILON) >= (b)) )

  2270. #define Dfltnotequal_abs(a,b) ( (((a)-YAC_FLT_EPSILON) > (b)) || (((a)+YAC_FLT_EPSILON) < (b)) )

  2271. #define Dfltzero_abs(a) Dfltequal(a, 0.0f)

  2272. 

  2273. #define Ddblnonzero_abs(a) ( ((a)>YAC_DBL_EPSILON) || ((a)<-YAC_DBL_EPSILON) )

  2274. #define Ddblequal_abs(a,b) ( (((a)-YAC_DBL_EPSILON) <= (b)) && (((a)+YAC_DBL_EPSILON) >= (b)) )

  2275. #define Ddblnotequal_abs(a,b) ( (((a)-YAC_DBL_EPSILON) > (b)) || (((a)+YAC_DBL_EPSILON) < (b)) )

  2276. #define Ddblzero_abs(a) Ddblequal(a, 0.0)

  2277. 

  2278. #endif // YAC_EPISLONCOMPARE_ABS

  2279. 

  2280. 

  2281. 

  2282. #ifdef YAC_EPSILONCOMPARE_REL

  2283. //

  2284. // alternative floating point value comparisons that shift epsilon 

  2285. // with the exponent. 

  2286. // test against zero are special cases

  2287. //

  2288. // contributed by Carsten Busse <carsten.busse@gmail.com>

  2289. // 

  2290. extern sSI yac_epsilon_flt_units;

  2291. extern sS64 yac_epsilon_dbl_units;

  2292. extern sF32 yac_epsilon_flt;

  2293. extern sF64 yac_epsilon_dbl;

  2294. //fast version

  2295. YAC_APIC sSI YAC_CALL yac_fltcmp_rel_fast(sF32, sF32);

  2296. YAC_APIC sSI YAC_CALL yac_dblcmp_rel_fast(sF64, sF64);

  2297. //"real" tolerance version

  2298. YAC_APIC sSI YAC_CALL yac_fltcmp_rel(sF32, sF32, sF32);

  2299. YAC_APIC sSI YAC_CALL yac_dblcmp_rel(sF64, sF64, sF64);

  2300. 

  2301. #define Dfltnonzero_rel(a) ( ((a)>YAC_FLT_EPSILON) || ((a)<-YAC_FLT_EPSILON) )

  2302. #define Dfltzero_rel(a) ( ((a)<=YAC_FLT_EPSILON) && ((a)>=-YAC_FLT_EPSILON) )

  2303. #define Dfltequal_rel(a,b) ( yac_fltcmp_rel_fast((sF32)a,(sF32)(b)) == 0 )

  2304. #define Dfltnotequal_rel(a,b) ( yac_fltcmp_rel_fast((sF32)(a), (sF32)(b)) != 0 )

  2305. 

  2306. #define Ddblnonzero_rel(a) ( ((a)>YAC_DBL_EPSILON) || ((a)<-YAC_DBL_EPSILON) )

  2307. #define Ddblzero_rel(a) ( ((a)<=YAC_DBL_EPSILON) && ((a)>=-YAC_DBL_EPSILON) )

  2308. #define Ddblequal_rel(a,b) ( yac_dblcmp_rel_fast((sF64)(a), (sF64)(b) ) == 0 )

  2309. #define Ddblnotequal_rel(a,b) ( yac_dblcmp_rel_fast((sF64)(a), (sF64)(b) ) != 0 )

  2310. 

  2311. #endif // YAC_EPSILONCOMPARE_REL

  2312. 

  2313. 

  2314. 

  2315. // ----

  2316. // ---- Default float comparison, either abs or rel

  2317. // ----

  2318. 

  2319. #ifdef YAC_EPSILONCOMPARE_ABS_DEFAULT

  2320. // ---- Use absolute epsilon comparison macros by default

  2321. #define Dfltnonzero(a)     Dfltnonzero_abs  (a)

  2322. #define Dfltequal(a, b)    Dfltequal_abs    (a, b)

  2323. #define Dfltnotequal(a, b) Dfltnotequal_abs (a, b)

  2324. #define Dfltzero(a)        Dfltzero_abs     (a)

  2325. #define Ddblnonzero(a)     Ddblnonzero_abs  (a)

  2326. #define Ddblequal(a,b)     Ddblequal_abs    (a, b)

  2327. #define Ddblnotequal(a, b) Ddblnotequal_abs (a, b)

  2328. #define Ddblzero(a)        Ddblzero_abs     (a)

  2329. #elif defined(YAC_EPSILONCOMPARE_REL_DEFAULT)

  2330. // ---- Use relative epsilon comparison macros by default

  2331. #define Dfltnonzero(a)     Dfltnonzero_rel  (a)

  2332. #define Dfltequal(a, b)    Dfltequal_rel    (a, b)

  2333. #define Dfltnotequal(a, b) Dfltnotequal_rel (a, b)

  2334. #define Dfltzero(a)        Dfltzero_rel     (a)

  2335. #define Ddblnonzero(a)     Ddblnonzero_rel  (a)

  2336. #define Ddblequal(a,b)     Ddblequal_rel    (a, b)

  2337. #define Ddblnotequal(a, b) Ddblnotequal_rel (a, b)

  2338. #define Ddblzero(a)        Ddblzero_rel     (a)

  2339. #endif // YAC_EPSILONCOMPARE_REL_DEFAULT

  2340. 

  2341. 

  2342. // ----                             ----

  2343. // ----      exception helpers      ----

  2344. // ----                             ----

  2345. 

  2346. // Raise runtime exception "a" with message text "b" in context _ctx

  2347. #define Dyac_throw(a, b)  yac_host->yacExceptionRaise(_ctx, exid_##a, b, __FILE__, __LINE__)

  2348. 

  2349. // Raise runtime exception "a" with message text "b" in default context (**only use if context is not available!**)

  2350. #define Dyac_throw_def(a, b)  yac_host->yacExceptionRaise(yac_host->yacContextGetDefault(), exid_##a, b, __FILE__, __LINE__)

  2351. 

  2352. // Forward declarate an exception id

  2353. #define Dyac_exid_decl(a) extern YAC_ExceptionId exid_##a

  2354. 

  2355. // Implement exception id variable

  2356. #define Dyac_exid_impl(a) YAC_ExceptionId exid_##a

  2357. 

  2358. // Resolve exception id

  2359. #define Dyac_exid_resolve(a) exid_##a = yac_host->yacExceptionGetIdByName(#a)

  2360. 

  2361. // Register custom exception id (e=exception name, b=base class exception name)

  2362. #define Dyac_exid_register(e, b) exid_##e = yac_host->yacExceptionRegister(#e, exid_##b)

  2363. 

  2364. // Forward declarate all "standard" YAC/TkScript exceptions

  2365. #define Dyac_std_exid_decl \

  2366. Dyac_exid_decl(CriticalError);\

  2367. Dyac_exid_decl(UncriticalError);\

  2368. Dyac_exid_decl(InvalidPointer);\

  2369. Dyac_exid_decl(Death);\

  2370. Dyac_exid_decl(TypeMismatch);\

  2371. Dyac_exid_decl(ClassTypeMismatch);\

  2372. Dyac_exid_decl(NativeClassTypeMismatch);\

  2373. Dyac_exid_decl(ScriptClassTypeMismatch);\

  2374. Dyac_exid_decl(ClassMemberNotFound);\

  2375. Dyac_exid_decl(NativeClassMemberNotFound);\

  2376. Dyac_exid_decl(ScriptClassMemberNotFound);\

  2377. Dyac_exid_decl(ModuleNotFound);\

  2378. Dyac_exid_decl(ModuleMemberNotFound);\

  2379. Dyac_exid_decl(ArrayOutOfBounds);\

  2380. Dyac_exid_decl(ReadArrayOutOfBounds);\

  2381. Dyac_exid_decl(WriteArrayOutOfBounds);\

  2382. Dyac_exid_decl(ConstraintViolation);\

  2383. Dyac_exid_decl(NotNullConstraintViolation)

  2384. 

  2385. // Implement all "standard" YAC/TkScript exception id variables

  2386. #define Dyac_std_exid_impl \

  2387. Dyac_exid_impl(CriticalError);\

  2388. Dyac_exid_impl(UncriticalError);\

  2389. Dyac_exid_impl(InvalidPointer);\

  2390. Dyac_exid_impl(Death);\

  2391. Dyac_exid_impl(TypeMismatch);\

  2392. Dyac_exid_impl(ClassTypeMismatch);\

  2393. Dyac_exid_impl(NativeClassTypeMismatch);\

  2394. Dyac_exid_impl(ScriptClassTypeMismatch);\

  2395. Dyac_exid_impl(ClassMemberNotFound);\

  2396. Dyac_exid_impl(NativeClassMemberNotFound);\

  2397. Dyac_exid_impl(ScriptClassMemberNotFound);\

  2398. Dyac_exid_impl(ModuleNotFound);\

  2399. Dyac_exid_impl(ModuleMemberNotFound);\

  2400. Dyac_exid_impl(ArrayOutOfBounds);\

  2401. Dyac_exid_impl(ReadArrayOutOfBounds);\

  2402. Dyac_exid_impl(WriteArrayOutOfBounds);\

  2403. Dyac_exid_impl(ConstraintViolation);\

  2404. Dyac_exid_impl(NotNullConstraintViolation)

  2405. 

  2406. // Resolve all "standard" YAC/TkScript exception ids

  2407. #define Dyac_std_exid_resolve \

  2408. Dyac_exid_resolve(CriticalError);\

  2409. Dyac_exid_resolve(UncriticalError);\

  2410. Dyac_exid_resolve(InvalidPointer);\

  2411. Dyac_exid_resolve(Death);\

  2412. Dyac_exid_resolve(TypeMismatch);\

  2413. Dyac_exid_resolve(ClassTypeMismatch);\

  2414. Dyac_exid_resolve(NativeClassTypeMismatch);\

  2415. Dyac_exid_resolve(ScriptClassTypeMismatch);\

  2416. Dyac_exid_resolve(ClassMemberNotFound);\

  2417. Dyac_exid_resolve(NativeClassMemberNotFound);\

  2418. Dyac_exid_resolve(ScriptClassMemberNotFound);\

  2419. Dyac_exid_resolve(ModuleNotFound);\

  2420. Dyac_exid_resolve(ModuleMemberNotFound);\

  2421. Dyac_exid_resolve(ArrayOutOfBounds);\

  2422. Dyac_exid_resolve(ReadArrayOutOfBounds);\

  2423. Dyac_exid_resolve(WriteArrayOutOfBounds);\

  2424. Dyac_exid_resolve(ConstraintViolation);\

  2425. Dyac_exid_resolve(NotNullConstraintViolation)

  2426. 

  2427. 

  2428. #ifdef YAC_GLOBAL_NEWDELETE

  2429. extern sSI yac_global_newdelete_counter;    // Tracks currently allocated # of bytes

  2430. extern sSI yac_global_newdelete_numallocs;  // Tracks total number of calls to "new"

  2431. extern sSI yac_global_newdelete_numfrees;   // Tracks total number of calls to "delete"

  2432. #endif // YAC_GLOBAL_NEWDELETE

  2433. 

  2434. 

  2435. #endif // RACK_PLUGIN

  2436. 

  2437. 

  2438. // Local var/typecast from arg helper

  2439. #define YAC_CAST_ARG(t,l,a) t *l = (t *) a

  2440. 

  2441. // Local var/typecast/unlink from ValueObject arg helper

  2442. #define YAC_DEREF_ARG(t,l,a) t*l=NULL; sBool l##_deleteme=0; if(YAC_Is_Value(a)){ YAC_ValueObject*l##vo=(YAC_ValueObject*)a; if(l##vo->type >= YAC_TYPE_OBJECT) { l = (t*) l##vo->value.object_val; l##_deleteme = l##vo->deleteme; l##vo->deleteme = 0; } } else { l = (t*) a; }

  2443. 

  2444. // Check if 32bit float is denormalized (can cause severe slowdowns on Intel processors (faktor 5-8)

  2445. //  a float is denormalized if the exponent part is 0 and the fractional part is not

  2446. #define Dyac_chkdenorm_32(a) ((0==((*(sUI*)&(a)) & 0x7f800000u)) && (0 != ((*(sUI*)&(a)) & 0x007FFFFFu)))

  2447. 

  2448. // Correct denormalized 32bit float

  2449. //#define Dyac_denorm_32(a) (Dyac_chkdenorm_32(a) ? 0.0f : (a))

  2450. #define Dyac_denorm_32(a) ( ((a)+10.0f) - 10.0f ) // kb's denormalize trick!

  2451. 

  2452. // Check if 32bit float is (plus or minus) infinity

  2453. #define Dyac_chkinf_32(a) (0x7f800000u == ((*(sUI*)&(a)) & 0x7f800000u))

  2454. 

  2455. // Check if 32bit float is NaN

  2456. #define Dyac_chknan_32(a) ( ((*(sUI*)&(a)) == 0x7F820000u) || ((*(sUI*)&(a)) == 0xFF9112AAu) )

  2457. 

  2458. // Check if 32bit float is -0

  2459. #define Dyac_chkm0_32(a) ( ((*(sUI*)&(a)) == 0x80000000u) )

  2460. 

  2461. // Debug: print warning if float is denormalized, infinity, or NaN

  2462. #define Dyac_dbgflt_32(a) if(1) { \

  2463.       if(Dyac_chkdenorm_32(a)) printf(#a " denorm\n"); \

  2464.       if(Dyac_chkinf_32(a)) printf(#a " inf\n"); \

  2465.       if(Dyac_chknan_32(a)) printf(#a " NaN\n"); \

  2466.       if(Dyac_chkm0_32(a)) printf(#a " m0\n"); \

  2467.    } else (void)0

  2468. 

  2469. #endif // ifndef __YAC_H__