---
title: chardisplay
slug: develop/es/chardisplay
docTags: 
createdAt: 2025-03-11T07:07:19.526Z
---

El objeto *chardisplay* le permite configurar las propiedades de los caracteres en una pantalla. Está disponible en BOS 9.0.203 y posteriores, y BOS 9.1.29 y posteriores.

**IDL de chardisplay**

```text
interface CharDisplay {
    Promise<void> show(in unsigned long row, in unsigned long col, in DOMString text)
    Promise<void> clear()
    Promise<void> setPos(in unsigned long row, in unsigned long col)
    Promise<void> setCursor(in unsigned long cursor) // 0=off, 1=blink, 2=underline, 3=both
    Promise<void> setContrast(in unsigned long contrast) // 0-100
    Promise<int> getContrast()
    Promise<void> setBrightness(in unsigned long brightness) // 0-100
    Promise<int> getBrightness()
    Promise<int> getColumns()
    Promise<int> getRows()
}
```

## Creación de objetos

Para crear un objeto *chardisplay* , cargue el módulo *@brightsign/chardisplay* utilizando el método require() de Node.js®:

```javascript
var chardisplayClass = require("@brightsign/chardisplay");
var chardisplay = new chardisplayClass();
```

## CharDisplay

### show()

```javascript
Promise<void> show(in unsigned long row, in unsigned long col, in DOMString text)
```

Muestra texto en una posición determinada

### clear()

```javascript
Promise<void> clear()
```

Limpia la pantalla

### setPos()

```javascript
Promise<void> setPos(in unsigned long row, in unsigned long col)
```

Posiciona el cursor

### setCursor()

```javascript
Promise<void> setCursor(in unsigned long cursor)
```

Configura el estilo del cursor:&#x20;

- 0 es apagado
- 1 es parpadeo
- 2 es subrayado
- 3 es ambos

### setContrast()

```javascript
Promise<void> setContrast(in unsigned long contrast)
```

Configura el contraste de la pantalla en valores de 0 a 100

### getContrast()

```javascript
Promise<void> getContrast()
```

Obtiene el contraste de la pantalla

### setBrightness()

```javascript
Promise<void> setBrightness(in unsigned long brightness)
```

Configura el brillo de la pantalla en valores de 0 a 100

### getBrightness()

```javascript
Promise<int> getBrightness()
```

Obtiene el brillo de la pantalla

### getColumns()

```javascript
Promise<int> getColumns()
```

Devuelve el número de columnas. Esto es útil para escribir código que recorra en bucle las filas y columnas disponibles. 

### getRows()

```javascript
Promise<int> getRows()
```

Devuelve el número de filas. Esto es útil para escribir código que recorra en bucle las filas y columnas disponibles.