LumaxForge
ZH EN

JSON Injection Panel

easy-chart-lit · Manual

Back to Product Chapters

JSON Injection Panel

This chapter explains the JSON Injection panel at the bottom-left of Unity Easy Chart/Library Editor.

Its purpose is to represent the current ChartProfile configuration (or externally imported configuration) as readable/copyable JSON, and supports ApplyToChart to parse the JSON and write it back into the selected Profile.

Location and purpose

  • Location: below the Library panel (tree view).
  • Main uses:
    • Export: convert the selected ChartProfile into example JSON (Feed)
    • Edit: manually edit the JSON in the text box
    • Import/Apply: click ApplyToChart to parse and apply JSON into the selected ChartProfile

Use cases:

  • Debugging: quickly validate whether a specific field takes effect.
  • Batch edits: copy JSON to an external editor (multi-cursor/find-replace), then paste back and Apply.
  • Integrations: e.g. your toolchain/scripts generate a Feed and you Apply it in the editor.

Controls (header bar)

The header bar typically contains (left to right):

  • Min/Max (label changes)

    • Toggles panel height.
    • Min: collapse to a smaller height (more like an auxiliary tool).
    • Max: expand to a larger height (better for long JSON).

  • ApplyToChart (icon button)

    • Attempts to parse the JSON in the text box as a Feed and apply it to the selected ChartProfile.
    • On success it will:
      • mark the asset dirty and call SaveAssets()
      • refresh the Series list
      • refresh Preview

  • Help (icon button)

    • Opens this chapter.

Controls (button row)

Below the header there is a row of buttons (may wrap):

  • API Envelope (icon toggle)

    • Controls whether the example JSON is wrapped in an “API response” envelope.
    • Useful when you want to send the Feed directly to an HTTP API/service.
    • Toggling regenerates the example and overwrites the text box (see “overwrite rules”).

  • Feed Mode (dropdown)

    • Controls which levels/fields are included in the example JSON.
    • Options come from an internal enum (common ones include):
      • Lite
      • Standard / ID
      • Standard / Default
      • Standard / With Axes
      • Full
    • General recommendations:
      • Quickly inspect structure: use Lite
      • Need stable references: use Standard / ID
      • Need to include axes config: use Standard / With Axes
      • Need full copy/migration: use Full

  • Datas Format (dropdown)

    • Controls the output format of seriesData (data points).
    • Common options:
      • Values: more compact, mostly “values only”.
      • Standard: default format, good for editing and Apply.
      • Full: more complete (may include more fields/structure), good for migration/restoration.

  • Copy (icon button)

    • Copies the current text box content to the clipboard.

Text box and “overwrite rules” (important)

The JSON text box is editable. To prevent your manual edits from being overwritten automatically, the panel has a “dirty” flag logic:

  • As soon as you manually change the text box, it is considered “user modified” (dirty).
  • When dirty:
    • the editor will not automatically overwrite your content with example JSON.
  • However, switching the following options will force overwrite (and clear dirty):
    • API Envelope
    • Feed Mode
    • Datas Format
    • or when switching the selected Profile (resets to that Profile’s example)

Recommendation:

  • If you plan to do major edits:
    • Copy to an external editor first
    • Paste back and Apply when done

ApplyToChart behavior and notes

  • ApplyToChart modifies the selected ChartProfile asset.
  • If JSON parsing fails, an error is logged to the Console:
    • ApplyToChart failed: invalid JSON or unsupported format.
  • In Full mode, more meta/structural information may be overwritten (IDs/config, etc.), which is more powerful but also more dangerous.

Recommendations:

  • Before applying, make sure:
    • the correct ChartProfile is selected on the left
    • JSON format is valid (brackets/commas)
    • you understand what the current Feed Mode will overwrite

1) Export from current Profile and tweak

  • Select a ChartProfile
  • Choose appropriate Feed Mode / Datas Format
  • Copy to an external editor for tweaks
  • Paste back
  • ApplyToChart

2) Import configuration from external sources

  • Paste external JSON into the text box
  • ApplyToChart
  • Fine-tune further in Inspector / Series

Help

  • Click the rightmost Help icon in the header to open this chapter.