TextUR

Text-based texture UI and Rasterizer.

TextUR is a terminal-based editor for text-based textures or images. This is a tool for generating textures to be used with DungGine.

Command Line Arguments

• Load existing texture : ./textel -f <filename>.

• Create new texture or overwrite existing texture : ./textel -f <filename> -s <num_rows> <num_cols>.

• Trace over another texture : ./textel -f <main_texture_filename> -t <trace_texture_filename>.

• Convert texture made up of bright textels from the textel presets in TextUR to a corresponding dark texture which then can be used for rendering shadows in e.g. DungGine. The program exits when conversion is completed : ./textel -f <source_texture_filename> -c <target_texture_filename>.

  Keys

• WASD (lower case) or arrow keys : navigates the cursor or selects a textel preset in the textel menu. When in the textel menu, left and right (or A and D) scrolls from material to material for quicker navigation among the different textel presets.

• SHIFT + WASD (upper case) keys : scrolls the texture page-wise.

• Space : enter selected textel preset under cursor.

• Z : undo.

• SHIFT + Z : redo.

• C : clear textel under cursor.

• V : toggle drawing of vertical coordinates.

• H : toggle drawing of horizontal coordinates.

• SHIFT + V : toggle drawing of vertical guide line from the horizontal coordinate axis.

• SHIFT + H : toggle drawing of horizontal guide line from the vertical coordinate axis.

• - : toggle hide/show textel presets menu.

• X : export (save) work to current file.

• B : brush-stroke. Forms a circle, filled with the currently selected textel preset.

• SHIFT + B : big brush-stroke.

• R : randomized brush-stroke. Same as the B key, but fills the circle with textels according to a normal random distribution. You can re-generate until you get the desired result.

• SHIFT + R : randomized big brush-stroke. Same as the SHIFT + B key, but fills the circle with textels according to a normal random distribution. You can re-generate until you get the desired result.

• F: fill screen. Fills the texture with the currently selected textel preset where the bounding box of the screen is currently located over the texture.

• P : pick a textel from under the cursor and hilite the corresponding preset in the menu.

• L : show location of cursor.

• G : goto new cursor location. Press backspace to clear the last digit, press tab to toggle between R and C coordinate fields and press enter to confirm. Pressing G again toggles the input box.

• T : toggle show/hide of tracing texture.

• I : toggle inverted textels (i.e. toggle between dark and bright textel presets).

• M : toggle show/hide of material id:s.

• Q : quit.

Custom Textel Presets

Add a file named custom_textel_presets. The file format looks like this:

'<normal-char>', <normal-fg-color>, <normal-bg-color>, <normal-material>
'<shadow-char>', <shadow-fg-color>, <shadow-bg-color>, <shadow-material>
<textel-preset-name>
'<normal-char>', <normal-fg-color>, <normal-bg-color>, <normal-material>
'<shadow-char>', <shadow-fg-color>, <shadow-bg-color>, <shadow-material>
<textel-preset-name>
...etc...

So e.g.

'%', Magenta, Cyan, 28
'%', DarkMagenta, DarkCyan, 28
Magic Stone

produces the following textel preset at the end of the list:

Look in the source code for which material number that is appropriate to use for your custom presets.

Screenshots

Bright mode textels (normal mode):

Dark mode textels (shadow mode):

Dark mode texture (shadow texture):

Unsaved changes indicator:

Confirmation screen for attempting to quit while there are unsaved changes:

Custom textel "Magic Stone":

• Small brush stroke using B key (upper left corner).
• Big brush stroke using SHIFT + B key (lower left corner).
• Small randomized brush stroke using R key (upper right corner).
• Big randomized brush stroke using SHIFT + R key (lower right corner).

Build & Run Instructions

There are two options on dealing with repo dependencies:

Repo Dependencies Option 1

Run the following command from <my_source_code_dir>.

./TextUR/fetch-dependencies ./TextUR/dependencies

This will make sure you are running the latest stable versions that work with TextUR.

This script was created by Thibaut Buchert.

Repo Dependencies Option 2

You need the following header-only libraries that I've made:

• https://github.com/razterizer/Core
• https://github.com/razterizer/Termin8or

Make sure the folder structure looks like this:

<my_source_code_dir>/lib/Core/                   ; Core repo workspace/checkout goes here.
<my_source_code_dir>/lib/Termin8or/              ; Termin8or repo workspace/checkout goes here.
<my_source_code_dir>TextUR/                      ; TextUR repo workspace/checkout goes here.

These repos are not guaranteed to all the time work with the latest version of TextUR. If you want the more stable aproach then look at Option 1 instead.

Windows

Then just open <my_source_code_dir>/TextUR/TextUR/TextUR.sln and build and run. That's it!

You can also build it by going to <my_source_code_dir>/TextUR/TextUR/ and build with build.bat. Then you run by typing x64\Release\textur followed by the appropriate command line arguments.

MacOS

Goto <my_source_code_dir>/TextUR/TextUR/ and build with ./build.sh.

Then run by typing ./bin/textur and apply the appropriate command line arguments (see beginning of README.md).

Linux (Ubuntu)

Goto <my_source_code_dir>/TextUR/TextUR/ and build with ./build.sh.

Then run by typing ./bin/textur and apply the appropriate command line arguments (see beginning of README.md).