Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/desmonhak/colors-c-c-plus-plus
Cabecera que permite manipular colores con C/C++ de una forma mas sencilla
https://github.com/desmonhak/colors-c-c-plus-plus
c colors easy
Last synced: 6 days ago
JSON representation
Cabecera que permite manipular colores con C/C++ de una forma mas sencilla
- Host: GitHub
- URL: https://github.com/desmonhak/colors-c-c-plus-plus
- Owner: desmonHak
- License: other
- Created: 2021-04-18T18:07:56.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-17T21:17:02.000Z (3 months ago)
- Last Synced: 2024-08-17T22:25:54.970Z (3 months ago)
- Topics: c, colors, easy
- Language: C
- Homepage:
- Size: 914 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# colors-C-C++
----
Aqui tenemos una cabzera que incluye el modulo stdio.h por defecto y Windows.h. esta cabezera te permite manipular colores con C/C++ de una foma mas sencilla en Windows y linux(Colores ANSI). Para poder usar colores ANSI en windows es necesario activar esta caracteristica, nuestro codigo se encarga de incluir una subrutina constructora que activa esta caracteristica si no lo esta cada vez que ejecutemos el programa. Puedes situar el archivo `example.c` con un ejemplo del uso de esta cabecera.
Para usarla incluiremos la cabezera mediante la directiva `include`:
```C
#include "colors.h"
```
Desde donde es preciso en su codigo puede usar la clasica funcion `printf` o de la nueva `printf_color`, la cual es una version mejorada de la clasica `printf` que permite mostrar colores de forma directa. BG(BackGround = fondo) y FG(ForeGround = letra) para especificar los distintos colores. el formato seria `#{BG/FG:color_fondo_o_letra}`. De esta manera podemos ingresar colores sin usar macros:
```C
#include "colors.h"
int main(){
printf_color(BLACK "negro\n");
printf_color("#{BG:green}#{FG:red}letra en rojo con fondo verde: %d, %c#{BG:reset}\n", 1, 'c');
printf_color("#{BG:blue}#{FG:green}letra en verde con fondo azul: %d, %f#{BG:reset}\n", 2, 1.2f); // Print "Adios: 2" with blue background
return 0;
}
```
Si prefiere puede usar las funciones `POINTGREEN()` o `POINTRED()` para mostrar cierta informacion relevante:
```C
#include "colors.h"
int main(){
printf(POINTGREEN("hola mundo\n") );
printf_color(POINTRED("hola mundo\n") );
}
```
los colores disponibles con `printf_color` son los siguientes:
```C
// colores para las letras:
"FG:reset"
"FG:red"
"FG:green"
"FG:blue"
"FG:black"
"FG:yellow"
"FG:purple"
"FG:cyan"
"FG:white"
// colores para el fondo:
"BG:reset"
"BG:black"
"BG:red"
"BG:green"
"BG:yellow"
"BG:purple"
"BG:cyan"
"BG:white"
"BG:blue"
```
Cabe mencionar que `"BG:reset"` y `"FG:reset"` tienen el mismo efecto, ambas restauran el color de la terminal por defecto.
----
----
# Opciones disponibles:
Para letras:
```C
// letra negro oscuro
#define LETTER_BLACK ...
// letra rojo ocuro
#define LETTER_RED ...
// letra verde ocuro
#define LETTER_GREEN ...
// letra amarillo oscuro
#define LETTER_YELLOW ...
// letra azul oscuro
#define LETTER_BLUE ...
// letra magenta oscuro
#define LETTER_MAGENTA ...
// letra cyan ocuro:
#define LETTER_CYAN ...
// letra blanco oscuro
#define LETTER_WHITE ...
// resetear el color de la letra a la por defecto
#define LETTER_RESET ...
// versiones claras de los colores de letra:
#define LETTER_LIGHTBLACK_EX ...
#define LETTER_LIGHTRED_EX ...
#define LETTER_LIGHTGREEN_EX ...
#define LETTER_LIGHTYELLOW_EX ...
#define LETTER_LIGHTBLUE_EX ...
#define LETTER_LIGHTMAGENTA_EX ...
#define LETTER_LIGHTCYAN_EX ...
#define LETTER_LIGHTWHITE_EX ...
```
Colores de fondo:
```C
// fondo negro:
#define BACKGROUND_COLOR_BLACK ...
// fondo rojo:
#define BACKGROUND_COLOR_RED ...
#define BACKGROUND_COLOR_GREEN ...
#define BACKGROUND_COLOR_YELLOW ...
#define BACKGROUND_COLOR_BLUE ...
#define BACKGROUND_COLOR_PURPLE ...
#define BACKGROUND_COLOR_CYAN ...
#define BACKGROUND_COLOR_WHITE ...
#define BACKGROUND_COLOR_RESET ...
```
Operaciones especiales:
```C
// Mover el cursor hacia arriba:
#define UP(data, number) ...
// Mover el cursor hacia abajo:
#define DOWN(data, number) ...
// Mover el cursor hacia la derecha:
#define FORWARD(data, number) ...
// Mover el cursor hacia la izquierda
#define BACK(data, number) ...
// Mover el cursor a una posición específica
#define POS(number1, number2) ...
// cambiar titulo de la terminal:
#define SET_TITLE(title) ...
// limpiar pantalla:
#define CLEAR_DISPLAY ...
// limpiar una linea:
#define CLEAR_LINE ...
// crear un string con punto verde al inicio
#define POINTGREEN(data) ...
// esconder cursor
#define HIDDEN_SLIDER ...
// mostrar cursor
#define SHOW_SLIDER ...
// cambiar el modo del cursor
#define SET_MODE_SLIDER ...
// cambiar el tamaño del cursor
#define SET_SIZE_SLIDER(size) ...
// crear un string con punto roojo al inicio
#define POINTRED(data) ...
```
----
## Colores personalizados.
Podemos crear colores personalizados usando el sistema `RGB`. Para la tarea podemos crear una estructura `RGB_C` donde indicar los colores, usar la macro `RGB_CREATE` que crea esta misma, o podemos poner los valores red, green, blue directamente en lugar de crear la estructura.
Para crear una estructura RGB podemos hacerlo de estas maneras:
```C
RGB_C my_color_rgb = {100, 225, 30};
RGB_C my_color_rgb = RGB_CREATE(100, 225, 30);
RGB_C my_color_rgb = (RGB_C){
.r = 100,
.g = 225,
.b = 30
};
RGB_C my_color_rgb = (RGB_C){
.red = 100,
.green = 225,
.blue = 30
};
```
Todas las anteriores sirven para crear la misma estrutuctura, en este caso, tenemos un `'objeto RGB_C'` donde el rojo es 100, el verde es 225 y el azul es 30, recordar que el valor que podemos color aqui va de `0-255`.
Una vez realizado esto podemos usar 3 funciones para definir el color de fondo y la letra. Estas son:
- `foreground_color_custom(color_letra)`: para cambiar solo el color de la letra.
- `background_color_custom(color_fondo)`: para cambiar solo el color del fondo.
- `back_fore_color_custom(color_fondo, color_letra)`: para cambiar el color del fondo y la letra.
```C
RGB_C my_foreground = RGB_CREATE(100, 225, 30);
foreground_color_custom(my_foreground);
background_color_custom(RGB_CREATE(40, 30, 225));
back_fore_color_custom(RGB_CREATE(40, 30, 225), RGB_CREATE(100, 225, 30));
back_fore_color_custom(40, 30, 225, 100, 225, 30)
back_fore_color_custom(RGB_CREATE(40, 30, 225), my_foreground)
```
Todas las formas anteriormente vistas son validas y hacen lo mismo pero usando macros, estructuras directar, variables...(de distintas maneras hacer lo mismo).
----
## Funciones adicionales:
```C
// permite borrar una linea:
void clear_line();
// permite limpiar la pantalla entera:
void clear_display();
// permite cambiar el titulo de la terminal:
void set_title(char *title);
// permite mover el cursor a la cordenada (x, y) y imprimir la informacion contenida en data.
void pos(unsigned char x, unsigned char y, char *data);
// permite retroceder el cursor n veces y mostrar informacion(data).
void back(char *data, unsigned char number);
// permite mover el cursor n veces a la derecha y mostrar informacion(data).
void forward(char *data, unsigned char number);
// permite mover el cursor n veces hacia abajo y mostrar informacion.
void down(char *data, unsigned char number);
// permite mover el cursor n veces hacia arriba y mostrar informacion.
void up(char *data, unsigned char number);
// version mejorada de printf:
void printf_color(const char *format, ...);
// permite cambiar el color de la terminal segun el ANSI
void setConsoleColor(ConsoleColor foreground, ConsoleColor background);
// resetea el color de la terminal al por defecto.
void resetColorTerminal();
```
Cabe mencionar que se autoejecuta `resetColorTerminal()` al final su programa sin necesidad de que el programador llame a la misma para poder resear el color de la terminal al estado inicial.
### setConsoleColor()
Esta funcion permite cambiar el color de la letra y el fondo del terminal. Esta funcion recibe como primer argumento el `foreground` el cual a de ser un valor entero que forme parte de los colores `ANSI` del sistema deseado. Igual en el caso del segundo parametro `background`. Para facilitar la tarea tenemos un enum donde se definen los valores posibles que puede recibir la funcion:
```C
typedef enum ConsoleColor
{
C_BLACK,
C_BLUE,
C_GREEN,
C_CYAN,
C_RED,
C_MAGENTA,
C_YELLOW,
C_WHITE,
C_LIGHTBLACK,
C_LIGHTCYAN,
C_LIGHTRED,
C_LIGHTMAGENTA,
C_LIGHTYELLOW,
C_LIGHTWHITE
} ConsoleColor;
```
Hay que mencionar que los colores `C_LIGH` no estan disponibles para el `background` con esta funcion, por lo que solo puede usar las versiones relativamente oscuras.
```C
setConsoleColor(C_LIGHTYELLOW, C_GREEN);
```
La definicion anterior cambia la letra a amarillo claro y el fondo a verde
----