Package net.paulhertz.pixelaudio.io

Class PACurveMakerIO

java.lang.Object

net.paulhertz.pixelaudio.io.PACurveMakerIO

public final class PACurveMakerIO
extends Object

JSON read/write support for PACurveMaker.
Filename convention suggestion: gesture_001_gesture.json Used in the example sketch Bagatelle.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	PACurveMakerIO.Meta	Optional metadata written with a gesture JSON file.
static final class	PACurveMakerIO.Result	Result of reading a gesture JSON file.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FORMAT	Format identifier written to gesture JSON headers.
static final int	VERSION	Gesture JSON format version.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PACurveMakerIO()

Method Summary

Modifier and Type	Method	Description
static PACurveMakerIO.Result	fromJson(processing.data.JSONObject root)	Reconstructs a curve from a parsed JSON root object.
private static processing.data.JSONArray	intsToJson(int[] values)
private static ArrayList<Integer>	jsonToIntsList(processing.data.JSONArray arr)
private static ArrayList<processing.core.PVector>	jsonToPoints(processing.data.JSONArray arr)
private static String	nonNull(String value, String fallback)
private static processing.data.JSONArray	pointsToJson(List<processing.core.PVector> points)
private static void	putIfPresent(processing.data.JSONObject obj, String key, String value)
static PACurveMakerIO.Result	read(File file)	Reads a curve JSON file.
private static void	requireHeader(processing.data.JSONObject header, String expectedFormat, int expectedVersion)
static processing.data.JSONObject	toJson(PACurveMaker curve, PACurveMakerIO.Meta meta)	Serializes a PACurveMaker to a JSON object.
static void	write(File file, PACurveMaker curve, PACurveMakerIO.Meta meta)	Writes a curve JSON file.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

FORMAT

public static final String FORMAT

Format identifier written to gesture JSON headers.

See Also:

• Constant Field Values

VERSION

public static final int VERSION

Gesture JSON format version.

See Also:

• Constant Field Values

Constructor Details

PACurveMakerIO

private PACurveMakerIO()

Method Details

toJson

public static processing.data.JSONObject toJson(PACurveMaker curve,
 PACurveMakerIO.Meta meta)

Serializes a PACurveMaker to a JSON object.

Parameters:

curve - curve to serialize

meta - optional metadata

Returns:

JSON root object

write

public static void write(File file,
 PACurveMaker curve,
 PACurveMakerIO.Meta meta)
                  throws IOException

Writes a curve JSON file.

Parameters:

file - destination file

curve - curve to serialize

meta - optional metadata

Throws:

IOException - if the file cannot be written

read

public static PACurveMakerIO.Result read(File file)
                                  throws IOException

Reads a curve JSON file.

Parameters:

file - source file

Returns:

parsed gesture result

Throws:

IOException - if the file cannot be read

fromJson

public static PACurveMakerIO.Result fromJson(processing.data.JSONObject root)

Reconstructs a curve from a parsed JSON root object.

Parameters:

root - parsed JSON root

Returns:

parsed gesture result

pointsToJson

private static processing.data.JSONArray pointsToJson(List<processing.core.PVector> points)

jsonToPoints

private static ArrayList<processing.core.PVector> jsonToPoints(processing.data.JSONArray arr)

intsToJson

private static processing.data.JSONArray intsToJson(int[] values)

jsonToIntsList

private static ArrayList<Integer> jsonToIntsList(processing.data.JSONArray arr)

requireHeader

private static void requireHeader(processing.data.JSONObject header,
 String expectedFormat,
 int expectedVersion)

putIfPresent

private static void putIfPresent(processing.data.JSONObject obj,
 String key,
 String value)

nonNull

private static String nonNull(String value,
 String fallback)