Quartz 4

12 - Project Examples

2 min read

Project Examples

The imported examples are practical regression and learning material. Each .vizzy.cs imported example should be considered together with its .vizzy.meta.json sidecar. examples vizzy

Location

Main imported examples live under Vizzy examples/Imported C examples.

Example Table

FileTypeDescriptionFidelity notes
Altair Alphard Vizzy.vizzy.csImported clean-view codeCraft or mission program from an Altair example.Keep sidecar for exact export.
Altair Alphard Vizzy.vizzy.meta.jsonSidecarHidden import metadata.Required for clean-view fidelity restoration.
Altair Basic Function.vizzy.csImported clean-view codeSmaller function-oriented example.Useful for custom block checks.
Altair Basic Function.vizzy.meta.jsonSidecarHidden metadata for the code file.Keep paired with code.
MFD Default.vizzy.csImported clean-view codeMFD-related default program.Useful for widget and UI block coverage.
MFD Default.vizzy.meta.jsonSidecarHidden metadata.Keep paired with code.
T.T. Mission Program.vizzy.csImported missionLarge mission-scale example.Fidelity-sensitive and useful for mixed-region diagnostics.
T.T. Mission Program.vizzy.meta.jsonSidecarHidden metadata for T.T.Keep paired with code.
Universal Vizzy Mission 2.vizzy.csImported missionUniversal mission automation example.Useful for broader flow coverage.
Universal Vizzy Mission 2.vizzy.meta.jsonSidecarHidden metadata.Keep paired with code.

T.T. Mission Program

Complex example

T.T. Mission Program should be treated as a high-signal example for mission-scale behavior: preserved regions, custom blocks, orbital math, raw fragments, and manually edited areas can coexist.

Use it when testing:

AreaWhy
Round-trip fidelityLarge enough to expose preservation gaps.
Custom blocksExercises top-level metadata and call formats.
Orbital mathContains nested expressions that can be fidelity-sensitive.
AI repairDemonstrates why context bundles matter.
Export validationGood candidate for catching structural regressions.

Pair Rule

flowchart LR
    A[name.vizzy.cs] --> B[Visible clean code]
    C[name.vizzy.meta.json] --> D[Hidden exact metadata]
    B --> E[Export]
    D --> E
    E --> F[Validated XML]

Pair files intentionally

For imported examples, treat .vizzy.cs and .vizzy.meta.json as a pair. If the sidecar is absent, unchanged imported lines may no longer have their exact hidden metadata.

How To Use Examples

TaskExample strategy
Learn authoring syntaxCompare imported code against 10 - Vizzy Authoring Guide.
Debug validationExport an example and inspect 04 - Export Validation output.
Check raw preservationSearch for RawXml* and compare with 05 - Raw Preservation.
Check MFD behaviorUse MFD Default.
Check mission-scale behaviorUse T.T. Mission Program.
Example testing checklist
  • Copy both .vizzy.cs and .vizzy.meta.json when moving an imported example.
  • Export through the CLI.
  • Check validation output.
  • Use roundtrip for original XML sources.
  • Open generated XML in Juno for important behavior.

Related notes: 03 - CLI (VizzyCode.Cli), 04 - Export Validation, 05 - Raw Preservation, 10 - Vizzy Authoring Guide, 11 - Vizzy Blocks Reference, 13 - Recommended Workflows.

Graph View

Backlinks