---
title: "(ES) cameraZoom()"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/2216692512/(ES)%20cameraZoom()"
format: markdown
---
> ℹ️ **Información**
> ℹ️ 
> ℹ️ Versión de implementación: beta 1.02

# Descripción

Mueve la cámara del visor en el sentido de la vista hacia adelante o hacia atrás, con una relación de movimiento de la enésima parte de la altura de la cámara. Esto se hace para conseguir que cerca del terreno el zoom sea suave, y a gran altitud sea más grande la variación. El límite de de zoom se encuentra en los 100 metros, valor a partir del cual dejará de aumentar (o de disminuir, en caso de enfoques poco comunes de la cámara).

# Invocación

```javascript
cameraZoom(
	zoomDirection,
	divisor*
)
```

<span style="color: #091e42">* Parámetro opcional</span>

# Parámetros de entrada

## zoomDirection

Recoge si el zoom va a ser hacia adelante o hacia atrás. Esto se introduce como una cadena de texto, que acepta una de estas dos opciones:

1. **zoomIn**: para que el zoom vaya hacia adelante (se acerque hacia donde mire la cámara del visor)
2. **zoomOut**: para que el zoom vaya hacia atrás (se aleje de hacia donde mire la cámara del visor)

## divisor

<span style="color: #091e42">Parámetro opcional; de no incluirse, usará el valor de 3.0. Corresponde al valor numérico que controla la relación del paso de movimiento de la cámara, dividiendo la altitud a la que se encuentra la cámara respecto a este valor.</span>

# Ejemplos de uso

Acercar el zoom de la cámara un paso:

```javascript
cameraZoom(
	'zoomIn'
)
```

Alejar el zoom de la cámara un paso:

```javascript
cameraZoom(
	'zoomOut'
)
```

![image](media://81594d90-53ee-4d84-aa04-2df4220769dc)