The Gravity Graphics File Interface Script Toolkit

Return to the project page
Return to the index

The File Interface Script Toolkit is essentially a cop-out to keep me from having to write file interface code into grfxgrav. There's one core file (grfxgrav-fist), several derived files, and one outlying file (grfxgrav-clean) that just removes the standard options file (as defined below). The whole thing centers around the file "$HOME/.grfxgrav" or "$GRFXGRAVOPTFILE" if its defined; it's nothing but a plaintext for storing command line options. It's not bad as rank amateur work goes (I hope); the FIST has a few hardcoded options (they don't use "-option"/"-o" notation either, which will eventually be fixed) of restore, save, help, and a file chooser.
You can use the file chooser to save options into, and read out of nonstandard files. That's the only real purpose of an explicit restore; running the FIST without options auto-loads anything stored in the default file onto the command line. All parts of the grfxgrav-fist (except grfxgrav-clean) take and pass normal grfxgrav parameters, even if loading others from a file. These are appended to the end of the line.
Since my option format sucks I added several helper files to cheerfully clog your file system. run-grfxgrav jumps directly into grfxgrav-fist and is meant to not use file,restore, or save. grfxgrav-loadfile takes a first parameter of a filename, and is used to load from a nonstandard file. grfxgrav-savefile takes a fist parameter of a filename, and is used to save to a nonstandard file. grfxgrav-save saves options to the default file, a la "grfxgrav-fist save <opts>".
And that's about it. All the scripts have "grfxgrav" in the title and so should be easy to find with a quick wildcard mask (*grfxgrav*).