Add command-line toggles.

Author: wojciech-graj

.clang-tidy

@@ -3,20 +3,17 @@ Checks: >
   -altera-id-dependent-backward-branch,
   -altera-struct-pack-align,
   -altera-unroll-loops,
-  -bugprone-narrowing-conversions,
-  -clang-analyzer-security.insecureAPI.DeprecatedOrUnsafeBufferHandling,
+  -concurrency-mt-unsafe,
   -cppcoreguidelines-avoid-magic-numbers,
   -cppcoreguidelines-avoid-non-const-global-variables,
   -cppcoreguidelines-init-variables,
-  -cppcoreguidelines-narrowing-conversions,
   -google-readability-braces-around-statements,
   -hicpp-braces-around-statements,
   -hicpp-signed-bitwise,
-  -hicpp-uppercase-literal-suffix,
   -llvmlibc-restrict-system-libc-headers,
   -readability-braces-around-statements,
   -readability-function-cognitive-complexity,
   -readability-identifier-length,
   -readability-isolate-declaration,
   -readability-magic-numbers,
-  -readability-uppercase-literal-suffix
+  -readability-math-missing-parentheses

README.md

@@ -17,19 +17,29 @@ telnet doom.w-graj.net 666
 Binaries for Windows and Linux are provided as [github releases](https://github.com/wojciech-graj/doom-ascii/releases).
 
 ### Linux / Mac
-Requires Make and a C compiler. Creates ```doom_ascii/doom_ascii```
+Requires Make and a C compiler. Creates `doom_ascii/doom_ascii`
 ```
 cd src
 make
 ```
 
 ### Windows
-Compile on linux. Creates ```doom_ascii/doom_ascii.exe```
+Compile on linux. Creates `doom_ascii/doom_ascii.exe`
 ```
 cd src
 make windows-cross
 ```
 
+## Settings
+
+The following command-line arguments can be supplied:
+- `-nocolor`: Disable color.
+- `-nograd`: Disable text gradients, exclusively use # or █.
+- `-nobold`: Disable bold text.
+- `-unicode`: Use [unicode block elements](https://en.wikipedia.org/wiki/Block_Elements) instead of ASCII characters.
+- `-erase`: Erase previous frame instead of overwriting. May cause a strobe effect.
+- `-scaling <n>`: Set resolution. Smaller numbers denote a larger display. A scale of 4 is used by default, and should work flawlessly on all terminals. Most terminals (excluding Windows CMD) should manage with scales up to and including 2.
+
 ## Controls
 Default keybindings are listed below.
 
@@ -46,15 +56,13 @@ Default keybindings are listed below.
 |SPEED			|]				|
 |WEAPON SELECT  |1-7            |
 
-Keybinds can be remapped in ```.default.cfg```, which should be placed in the same directory as the game executable.
+Keybinds can be remapped in `.default.cfg`, which should be placed in the same directory as the game executable.
 
 ## Performance tips
 ### Display
 Most terminals aren't designed for massive throughput, so the game cannot be played at full 320x200 resolution at high frames per second.
 
-Pass the command-line argument ```-scaling n``` to determine the level of scaling. Smaller numbers denote a larger display.
-
-A scale of 4 is used by default, and should work flawlessly on all terminals. Most terminals (excluding Windows CMD) should manage with scales up to and including 2.
+Pass the command-line argument `-scaling` to determine the level of scaling (See [Settings](#settings)).
 
 ### Input
 For a better playing experience, increase the keyboard repeat rate, and reduce the keyboard repeat delay.

src/doomgeneric.c

@@ -1,5 +1,5 @@
 //
-// Copyright(C) 2022 Wojciech Graj
+// Copyright(C) 2022-2025 Wojciech Graj
 //
 // This program is free software; you can redistribute it and/or
 // modify it under the terms of the GNU General Public License
@@ -16,26 +16,28 @@
 //
 
 #include "doomgeneric.h"
-#include "m_argv.h"
+
 #include "i_video.h"
+#include "m_argv.h"
+
+#include <stdlib.h>
 
 unsigned DOOMGENERIC_RESX = 80;
 unsigned DOOMGENERIC_RESY = 50;
 
-uint32_t* DG_ScreenBuffer = 0;
-
+uint32_t *DG_ScreenBuffer = 0;
 
 void dg_Create()
 {
 	int i;
 	i = M_CheckParmWithArgs("-scaling", 1);
-    if (i > 0) {
+	if (i > 0) {
 		i = atoi(myargv[i + 1]);
 		DOOMGENERIC_RESX = SCREENWIDTH / i;
 		DOOMGENERIC_RESY = SCREENHEIGHT / i;
 	}
 
-	DG_ScreenBuffer = malloc(DOOMGENERIC_RESX * DOOMGENERIC_RESY * 4);
+	DG_ScreenBuffer = malloc((unsigned long)DOOMGENERIC_RESX * DOOMGENERIC_RESY * 4);
 
 	DG_Init();
 }

src/doomgeneric.h

@@ -1,22 +1,19 @@
 #ifndef DOOM_GENERIC
 #define DOOM_GENERIC
 
-#include <stdlib.h>
 #include <stdint.h>
 
 extern unsigned DOOMGENERIC_RESX;
 extern unsigned DOOMGENERIC_RESY;
 
+extern uint32_t *DG_ScreenBuffer;
 
-extern uint32_t* DG_ScreenBuffer;
-
-
-void DG_Init();
-void DG_DrawFrame();
+void DG_Init(void);
+void DG_DrawFrame(void);
 void DG_SleepMs(uint32_t ms);
-uint32_t DG_GetTicksMs();
-int DG_GetKey(int* pressed, unsigned char* key);
-void DG_SetWindowTitle(const char * title);
+uint32_t DG_GetTicksMs(void);
+int DG_GetKey(int *pressed, unsigned char *key);
+void DG_SetWindowTitle(const char *title);
 void DG_ReadInput(void);
 
 #endif //DOOM_GENERIC