4.4 KiB
BefunWrite is an IDE to write and compile TextFunge, once started you will see the main window:
You can write your code in the center and see a summary of current constants/variables/methods on the right side.
On the bottom site you can also expand the tabs Output and ErrorList.
In the code section you can see an example program (a simple hello world), feel free to edit this example or delete it completely.
You can safe your code in the menu or by pressing STRG+S. 3 different files will be created:
projectname.tfp: The project file, it contains settings and the path to the other filesprojectname.tf: The actual source-codeprojectname.tfdv: The initial display value (or empty if not defined)
If you want to set an initial display value (see the topic TextFunge for more information) you can modify the tab Display beside the tab code.
To build the project simply choose a build configuration (Debug and Release are the defaults) and click Build.
The builded Befunge files will end up in the sub-folder projectname\configname.
To test the program you can also choose run, this will build the project and then open it in BefunExec.
##Build configurations
With the build configurations dialog you can modify the build process
Note:
- PC is the Program Counter, the current position in the program
- NOP-cells are the unused parts of the program, they are neither variable space, nor commands.
The PC will enter them and they should never be evaluated.
###General
General BefunWrite Settings
- Name
###Execution
BefunExec Settings
- Debugging Enabled: Enable debugging options (warnings on unexpected behaviours)
- Start Paused: Starts the program non-running
- Syntax highlighting: Sets the preferred syntax highlighting method
- Show chars in stack: Show the ASCII chars in the stack
- Follow PC: Start with follow mode enabled
- Skip Whitespace: Skip continuous white-spaces
- Initial speed: Sets (the index) of the initial interpretation speed
- Speed[x]: The delay between cycles on speed level x
- Show Tail: Show a fading tail behind the actual PC
- Lifetime Tail: The time (in ms) until the tail has faded away
- Start zoomed in on display: Set the initial zoom fitting for the display
###Code Generation
BefunGen Settings
- Number literal representation: The used algorithm for presenting number literals
- Optimize double string-mode: Try to combine two adjacent
"together - Set NOP to special char: Set NOP cells to a special character
- Custom NOP char: The special character for NOP cells (if used)
- Horizontal compression: Try to horizontally compress the program
- Vertical compression: Try to vertically compress the program
- Minimum VarDecl. width: The minimum width of a declaration block, increase this if your initialization-blocks grow in height.
- Default VarDecl char: The initial char (before initialization) of variable fields
- Default TempDecl/TempResult char: The initial char (before use) of temporary fields
- Safe boolean cast: When hard-casting a variable to boolean it will result in either a 1 or a 0
- Default local int/char/bool var value: The initial value of a local variable (should stay default)
- Initial disp char: The initial character of the display fields
- Display border value: The character of the border around the display
- Display border thickness: The thickness of the border around the display
- Prevent Display overflow: When accessing coordinates outside of the display wrap around the edges.
- Optimize static Expr: Try to compile-time interpret simple expressions (4 * 4 + 4 ==> 20)
- Remove unused methods: Don't include methods that get never called
Warning ! If Prevent Display overflow is not set you can write into your own program and cause really strange behaviour.
If you choose this path you have to prevent an out-of-bounds display access for yourself.
Be aware that it is wise to leave most code generation settings on their default values.
For the most cases only the settings Set NOP to special char, Safe boolean cast and Prevent Display overflow should be interesting.