User:Papaltine/ProtoGraph

From Resonite Wiki

ProtoGraph is a declarative programming language designed to work with ProtoFlux in the Resonite ecosystem. It allows creators to write logic in a clean, readable text format that compiles directly into ProtoFlux nodes—making it easier to build, test, and maintain complex systems.

Overview

  • Paradigms: Declarative, Modular
  • Family: ML: Caml: OCaml: F#
  • Designed by: Papaltine, Kittysquirrel
  • Developer: Papaltine
  • Stable Release: N/A (Currently in Alpha)
  • License: AGPLv3
  • Target Platform: Resonite (via ProtoFlux)
  • File Extension: .pg
  • Compiler Tool: flux-sdk
  • Repository: Flux SDK
  • Compiled Format: .brson (Resonite Record)
  • Influenced by: F#, Elm, Python, Haskell, Odin

Who Should Use ProtoGraph?

  • Creators who want to move beyond visual scripting
  • Developers building modular, reusable systems
  • Teams collaborating on large-scale Resonite projects

Benefits

  • Readable: Clean syntax that mirrors ProtoFlux visually
  • Modular: Encourages reusable code through modules and packages
  • Safe: Compiler checks help catch errors early
  • Accessible: Friendly to those familiar with ProtoFlux as a first programming language

Building and Using in Resonite

Getting Started

  1. Write your .pg file
  2. Compile it:
flux-sdk build MyModule.pg
  1. Import the .brson file into Resonite
  2. Inspect the generated ProtoFlux under the corresponding slot

Example: Cross Product Module

module CrossProduct

where {
    /// First vector input
    let A = Pack_Float3;
    /// Second vector input
    let B = Pack_Float3;

    let Ax, Ay, Az = Unpack_Float3(A);
    let Bx, By, Bz = Unpack_Float3(B);

    let Cx = (Ay * Bz) - (Az * By);
    let Cy = (Az * Bx) - (Ax * Bz);
    let Cz = (Ax * By) - (Ay * Bx);

    // Final result
    Pack_Float3(Cx, Cy, Cz);
}

See Also