Cámara y posprocesado

Cámara

Cada jugador comienza con una cámara que lo sigue a medida que se mueve. Para ajustar el zoom o mover la cámara a otros lugares, proporcionamos un conjunto de APIs.

En CSL, la cámara es una estructura por jugador en Jugador:

• camera.follow_player: bool: cuando true, el motor mantiene la cámara siguiendo al jugador.

• camera.position: v2: el centro de la cámara en el espacio del mundo (se usa cuando follow_player = false).

• camera.size: float: cantidad de zoom. Más grande = más alejado (ves más del mundo).

Como los cambios de cámara son puramente cosméticos, aplícalos solo en el cliente local:

import "core:ao"

MyPlayer :: class : Player_Base {
    ao_late_update :: method(dt: float) {
        if is_local() {
            // Zoom simple de "configurar y olvidar"
            camera.size = 7.0;
        }
    }
}

Seguimiento personalizado (desplazamiento + suavizado)

Si quieres desplazamientos de cámara, escenas cinemáticas o suavizado personalizado, desactiva follow_player y controla camera.position tú mismo:

import "core:ao"

MyPlayer :: class : Player_Base {
    ao_late_update :: method(dt: float) {
        if !is_local() return;

        camera.follow_player = false;

        // Seguir ligeramente por encima del jugador
        target_pos := entity.world_position + v2{0, 0.5};

        // Moverse suavemente hacia el objetivo (seguro con dt)
        t := clamp(dt * 10.0, 0.0, 1.0);
        camera.position = lerp(camera.position, target_pos, t);

        // Zoom suave
        target_size := 6.0;
        camera.size = lerp(camera.size, target_size, t);
    }
}

Posprocesado

El posprocesado te permite aplicar efectos visuales a tu cámara como distorsión, gradación de color y otros efectos para que tu juego destaque.

CSL no expone actualmente APIs personalizadas de posprocesado (por ejemplo, registrar una devolución de llamada de posprocesador en tiempo de ejecución). Tienes dos opciones:

• Configurar en el editor: configura la pila predeterminada de posprocesado mediante Editar → Configuración del juego → Posprocesado. Esto se aplica al usar el comportamiento predeterminado de la cámara.

• Configurar mediante la API de C# (avanzado, no CSL): si estás usando un CameraControl personalizado mediante la API de ensamblado de C#, puedes registrar un posprocesador y llamar efectos como Bloom / Blur / Color Grade / Vignette.

Si habilitas cualquier efecto, All Out usará automáticamente la canalización HDR.