JSON library for the .Net framework
C# Makefile
Clone or download
Pull request Compare This branch is 20 commits ahead of Happy-Tuesday:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
benchmarks
build
doc
src/LitJson
test
.gitignore
COPYING
NEWS
README-ORIGINAL.md
README.md

README.md

LitJSON

A .Net library to handle conversions from and to JSON (JavaScript Object Notation) strings flavoured for the Unity3D engine.

Feature log

Attributes

Introducing attributes for JsonMappers when serializing to JSON String Objects. Currently only the Ignore Attribute is available but future implementations may bring new ones.

public class Foo
{
  public string id;
  [LitJson.Ignore]
  public string privateName;
}

LitJson.JsonMapper.ToJson(foo); would simply ignore the privateMember field and only output { "id" : "bar" }.
The Attribute is applyable to Classes, Properties and Fields.

UnityEngine types

These already work out of the box

JsonMapper.ToJson( AnimationCurve.EaseInOut(0,0,1,1) );

Further adaptions allow to pass UnityEngine types directly to the mapper:

JsonMapper.ToJson( Vector2.zero );         // Output { "x" : 0, "y" : 0 }
JsonMapper.ToJson( Vector3.one );          // Output { "x" : 1, "y" : 1, "z" : 1 }
JsonMapper.ToJson( Vector4.one );          // Output { "x" : 1, "y" : 1, "z" : 1, "w" : 1 }
JsonMapper.ToJson( Quaternion.identity );  // Output { "x" : 0, "y" : 0, "z" : 0, "w" : 0 }
JsonMapper.ToJson( Matrix4x4.zero );       // Output { "m33" : 0, .. }
JsonMapper.ToJson( Color.green );          // Output { "r" : 0, "g" : 1, "b" : 0, "a" : 1 }

JsonMapper.ToJson( Ray );                  // Output { "origin" : {V3}, "direction" : {V3} }
JsonMapper.ToJson( RaycastHit );           // Output { .. }

Of course reading back in also works:

var v2 = JsonMapper.ToObject<Vector2>( "{\"x\":0,\"y\":0}" ); 
var v3 = JsonMapper.ToObject<Vector3>( "{\"x\":0,\"y\":0,\"z\":1}" ); 
..

float (Single) and long (Int64) types

This fork includes this patch for serializing float(Single) and long(Int64) types from this pull request .

Build with Mono Develop / Xamarin Studio / Visual Studio / ..

  1. Create a solution & Library project within your IDE and reference all files from /src/LitJson .
  2. Add a configuration called Unity3D Project > Options > Build > Compiler and add Define Symbol UNITY3D .
  3. Reference the UnityEngine.dll from your Unity installation folder .
  4. Build the project .

Original README

The original README did move to README-ORIGINAL.md containing make instructions and license information.