Code Monkey home page Code Monkey logo

format's Introduction

TravisCI Build Status

The format library contains support for different file-formats for the Haxe programming language.

Formats

Currently supported formats are :

Format Description Reader Writer
ABC Flash AS3 bytecode format
AGAL Adobe Shader Assembler for Stage3D
AMF Flash serialized object
AS1 Adobe ActionScript1-2 bytecode in SWF
BMP Bitmap Image format
ELF Executable and Linkable Format
FLV Flash Video
GIF Image file format
GZ Compressed file
HL HashLink
ICO Windows ICO/CUR File format
JPG Image file format
LZ4 Compressed file
MAP Source Maps
MP3 Compressed audio
NEKO NekoVM bytecode
PBJ PixelBender Binary file
PDF Only generic file structure and partial decryption
PEX Particle effect format
PNG Image file format
SWF Flash file format
TAR Compressed Archive
TGA TARGA Image file format; Reader/Writer does not support developer data chunk; Writer does not support RLE encoding
TGZ TAR+GZ Archive
WAV Raw sound
ZIP Compressed Archive

Documentation

Automatically generated API documentation is here: https://haxefoundation.github.io/format/format/

Installation

Available on haxelib, simply run the following command : haxelib install format. To use the library, simply add -lib format to your commandline parameters.

Package Structure

Each format lies in its own package, for example format.pdf contains classes for PDF.

The format.tools package contains some tools that might be shared by several formats but don't belong to a specific one.

Each format must provide the following files :

  • one Data.hx file that contains only data structures / enums used by the format. If there are really a lot, they can be separated into several files, but it's often easier for the end user to only have to do one single import format.xxx.Data to access to all the defined types.
  • one Reader.hx class which enables reading the file format from an haxe.io.Input
  • one Writer.hx class which enables writing the file format to an haxe.io.Output
  • some other classes that might be necessary for manipulating the data structures

It's important in particular that the data structures storing the decoded information are separated from the actual classes manipulating it. This enables full access to all the file format infos and the ability to easily write libraries that manipulate the format, even if later the Reader implementation is changed for example.

Contributing

We're accepting contributions if they are following the package structure rules (see above), please send them as Pull Requests.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.