crgbFromJson()

bool fl::crgbFromJson	(	const json &	document,
		span< CRGB >	pixels )

Decode a versioned JSON object into an existing CRGB pixel buffer.

The document must use schema version 1 and contain exactly one RGB triplet per output pixel. Every channel must be an integer from 0 through 255. The complete document is validated before any output pixel is changed.

Parameters

document	JSON object produced by crgbToJson().
pixels	Destination pixel buffer.

Returns

true on success; false if the document is invalid. On failure, pixels is left unchanged.

Definition at line 101 of file crgb_json.cpp.hpp.

                                                                        {
    if (!document.is_object()) {
        return false;
    }
 
    const json versionJson = document["version"];
    const optional<i64> version = versionJson.as<i64>();
    if (!versionJson.is_int() || versionJson.is_bool() || !version ||
        *version != 1) {
        return false;
    }
 
    const json encodedPixels = document["pixels"];
    if (!encodedPixels.is_array() || encodedPixels.size() != pixels.size()) {
        return false;
    }
 
    for (size i = 0; i < encodedPixels.size(); ++i) {
        if (!crgbJsonPixel(encodedPixels[i])) {
            return false;
        }
    }
 
    for (size i = 0; i < encodedPixels.size(); ++i) {
        pixels[i] = *crgbJsonPixel(encodedPixels[i]);
    }
    return true;
}

References fl::json::as(), FL_NO_EXCEPT, fl::json::is_array(), fl::json::is_bool(), fl::json::is_int(), and fl::json::size().

Here is the call graph for this function: