Supports for native formats

Corsaair / redtamarin

AS3 running on the command line / server side

http://redtamarin.com

Other

119 stars 23 forks source link

Supports for native formats #182

Open zwetan opened 4 years ago

zwetan commented 4 years ago

Native formats are

ABC: ActionScript ByteCode
SWF: SWF file
- uncompressed
- compressed ZIP
- compressed LZMA
SWC: pre-compiled libraries
- Zip file
- catalog.xml and library.swf

zwetan commented 4 years ago

many goals

be able to valid the different formats is it a valid ABC file? is it a valid SWF file? etc.
when we load external files dynamically the AVM2 only supports SWF9+ files with AS3 bytecode we do not support AVM1 AS1/AS2 bytecode in SWF8 or less
supports libraries using .swc
- avoid forcing dev to republish an .abc library
- be able to extract the library.swf in-memory and load the bytecode
supports patching on the fly
- be able to patch kDoAbcLazyInitializeFlag for ABC for now, if we load a SWF that is not made as library it replaces the current execution context
- be able to load a SWF but then
  - list all the different ABC contained
  - only load some of them (eg. partial load) for ex: loading the SWF does not force to load all ABC in memory
  - extract the files etc.

zwetan commented 4 years ago

be able to support AVMGlue API [ApplicationDomain.getQualifiedDefinitionNames()](https://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/system/ApplicationDomain.html#getQualifiedDefinitionNames())

list all API loaded in-memory
be able to add anything loaded dynamically for ex: if we load an external SWF, then its definitions are added to the list of getQualifiedDefinitionNames()

zwetan commented 4 years ago

reuse and repurpose abcdis sources

API would be like:

avmplus.abc
avmplus.abc.types
avmplus.swf
avmplus.swc
avmplus.zip

notes: because of classname collisions between AS3 and C++ context all classes under avmplus.xyz package are prepended by the package name in upper case eg. XYZClassName

for ex: avmplus.abc::BasicBlock becomes avmplus.abc::ABCBasicBlock etc.

zwetan commented 4 years ago

general guideline:

we don't try to cover everything eg. if we only need to read a SWF we don't add API to modify/write SWF unless special case wher we try to patch something on the fly like kDoAbcLazyInitializeFlag
it is not a full blown compiler this will be done in another project as an external library
it is only for "native formats" that make sense to define in avmplus other formats can either be defined in shell if needed to be embedded or as external libraries etc.

zwetan commented 4 years ago

like the other #89 AVMGlue API, we document those classes