m Papaltine moved page ProtoGraph to User:Papaltine/ProtoGraph: move under user |
m Add world link |
||
| (6 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
== Overview == | == Overview == | ||
* ''' | * '''Paradigm''': [[wikipedia:Dataflow_programming|Dataflow]] | ||
* '''Family''': ML: Caml: OCaml: F# | * '''Family''': ML: Caml: OCaml: F# | ||
* ''' | * '''Designers''': [[User:Papaltine|Papaltine]], [[User:Kittysquirrel|Kittysquirrel]] | ||
* '''Developer''': [[User:Papaltine|Papaltine]] | * '''Developer''': [[User:Papaltine|Papaltine]] | ||
* '''Stable Release''': N/A (Currently in | * '''Stable Release''': N/A (Currently in Beta) | ||
* '''License''': AGPLv3 | * '''License''': AGPLv3 | ||
* '''Target Platform''': Resonite (via ProtoFlux) | * '''Target Platform''': Resonite (via ProtoFlux) | ||
| Line 13: | Line 13: | ||
* '''Repository''': [https://git.samsmucny.com/ssmucny/Flux-SDK Flux SDK] | * '''Repository''': [https://git.samsmucny.com/ssmucny/Flux-SDK Flux SDK] | ||
* '''Compiled Format''': <code>.brson</code> (Resonite Record) | * '''Compiled Format''': <code>.brson</code> (Resonite Record) | ||
* '''Influenced by''': F#, Elm, Python, Haskell, Odin | * '''Influenced by''': F#, Elm, Python, Haskell, VHDL, Odin, Go | ||
* '''Showcase World''': https://go.resonite.com/world/U-1O4IcGhlKSm/R-2045c574-dda6-4a7e-9955-56d2ca002d78 | |||
== Who Should Use ProtoGraph? == | == Who Should Use ProtoGraph? == | ||
| Line 21: | Line 22: | ||
== Benefits == | == Benefits == | ||
* '''Readable''': Clean syntax that mirrors ProtoFlux | * '''Readable''': Clean syntax that mirrors ProtoFlux | ||
* '''Modular''': Encourages reusable code | * '''Modular''': Encourages reusable and easy to refactor code | ||
* ''' | * '''Reliable''': Compiler checks help catch errors early | ||
* '''Accessible''': Friendly to those familiar with ProtoFlux as a first programming language | * '''Accessible''': Friendly to those familiar with ProtoFlux as a first programming language | ||
| Line 33: | Line 34: | ||
# Compile it: | # Compile it: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
flux-sdk build MyModule.pg | dotnet flux-sdk.dll build MyModule.pg | ||
</syntaxhighlight> | </syntaxhighlight> | ||
# Import the <code>.brson</code> file into Resonite | # Import the <code>.brson</code> file into Resonite | ||
| Line 39: | Line 40: | ||
== Example: Cross Product Module == | == Example: Cross Product Module == | ||
<syntaxhighlight lang="fsharp"> | <syntaxhighlight lang="fsharp" line="1"> | ||
module CrossProduct | module CrossProduct | ||
in A: float3 | |||
in B: float3 | |||
out this: float3 | |||
where { | where { | ||
// Inputs | |||
Ax, Ay, Az = Unpack_Float3(A); | |||
Bx, By, Bz = Unpack_Float3(B); | |||
// Computations | |||
Cx = (Ay * Bz) - (Az * By); | |||
Cy = (Az * Bx) - (Ax * Bz); | |||
Cz = (Ax * By) - (Ay * Bx); | |||
// Final result | |||
Pack_Float3(Cx, Cy, Cz); | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Revision as of 23:04, 29 June 2025
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
- Paradigm: Dataflow
- Family: ML: Caml: OCaml: F#
- Designers: Papaltine, Kittysquirrel
- Developer: Papaltine
- Stable Release: N/A (Currently in Beta)
- 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, VHDL, Odin, Go
- Showcase World: https://go.resonite.com/world/U-1O4IcGhlKSm/R-2045c574-dda6-4a7e-9955-56d2ca002d78
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
- Modular: Encourages reusable and easy to refactor code
- Reliable: Compiler checks help catch errors early
- Accessible: Friendly to those familiar with ProtoFlux as a first programming language
Building and Using in Resonite
- Write your
.pgfile - Compile it:
dotnet flux-sdk.dll build MyModule.pg
- Import the
.brsonfile into Resonite - Inspect the generated ProtoFlux under the corresponding slot
Example: Cross Product Module
module CrossProduct
in A: float3
in B: float3
out this: float3
where {
// Inputs
Ax, Ay, Az = Unpack_Float3(A);
Bx, By, Bz = Unpack_Float3(B);
// Computations
Cx = (Ay * Bz) - (Az * By);
Cy = (Az * Bx) - (Ax * Bz);
Cz = (Ax * By) - (Ay * Bx);
// Final result
Pack_Float3(Cx, Cy, Cz);
}