Soporte de API para Iluminación Dinámica

¿Eres un genio de la programación o disfrutas trabajando con la API de Roll20? Si es así, tenemos excelentes noticias para ti: ¡la Iluminación Dinámica ahora se integra con la API de Roll20! Echa un vistazo a todas las increíbles funciones y características de Iluminación y Visión que puedes usar en tu código personalizado. Recuerda, el acceso a la API solo está disponible para suscriptores Pro, así que actualiza tu cuenta si aún no lo has hecho.


Configuración de ficha

Sintaxis Contexto Tipo
tiene_visión_luz_brillante  Activa o desactiva la visión para la ficha. Booleano
tiene_visión_nocturna Activa o desactiva la visión nocturna para la ficha.  Booleano
distancia_visión_nocturna Establece el rango de visión nocturna para el token.  Entero
emits_bright_light Activa la luz brillante para el token.  Booleano
bright_light_distance Establece el rango de la cantidad de luz brillante que emite un token.  Entero
emits_low_light Activa la luz tenue para el token. Esto sería útil para una antorcha o una fuente con una pequeña cantidad de luz. Utilice los booleanos true para encender o false para apagar. Booleano
low_light_distance Establece el rango de la cantidad de luz tenue que emite un token. Al establecer este valor, debes incluir cualquier distancia de luz brillante que hayas configurado. La razón de esto es porque la Distancia de Luz Baja se calcula desde el centro de la ficha. Entonces, si has configurado la Distancia de Luz Brillante en 10, y te gustaría tener 10 pies adicionales de Distancia de Luz Baja, el valor de low_light_distance debe ser 20. Integer 
light_sensitivity_multiplier Multiplicador sobre la eficacia de las fuentes de luz. Un multiplicador de 200 permitiría que el token vea el doble de lejos que un token con un multiplicador de 100, con la misma fuente de luz. Integer
efecto_vision_nocturna
Cambia el Efecto de Visión nocturna. Otras opciones incluyen “Atenuación” y “Nocturno” Cadena

 

Visión y Iluminación Direccional

Sintaxis Contexto Tipo
has_limit_field_of_vision Activa o desactiva el límite de campo de visión para la ficha . Booleano
limit_field_of_vision_center Establece el valor desde donde comienza el centro del campo de visión. Integer
limit_field_of_vision_total Set the value for the total size of the field of vision. Integer

has_limit_field_of_night_vision

Toggles limit field of night vision for the  token. Booleano
limit_field_of_night_vision_center Sets the value for where the center of the field of night vision starts. Integer 
limit_field_of_night_vision_total Set the value for the total size of the field of night vision. Integer
has_directional_bright_light Toggles directional bright light for the  token. Booleano

centro_de_luz_brillante_direccional

Establece el valor para donde comienza el centro del campo de luz brillante. Entero
luz_brillante_direccional_total Establece el valor para el tamaño total del campo de luz brillante. Entero 

tiene_iluminacion_dirigida_en_penumbra

Alterna la penumbra direccional para el token . Booleano
centro_de_penumbra_dirigida Establece el valor para donde comienza el centro del campo de penumbra. Entero
penumbra_dirigida_total Establece el valor para el tamaño total del campo de penumbra. Entero

 


Ajustes de página

Sintaxis Contexto Tipo
dynamic_lighting_enabled Actualiza la iluminación dinámica de la página.  Booleano
daylight_mode_enabled Activa el modo diurno para la página. Esto no debe activarse si dynamic_lighting_enabled no está activado.  Booleano
explorer_mode

Activa el modo explorador para la página. Esto no debe activarse si dynamic_lighting_enabled no está activado.

Utilice las cadenas "basic" para activar o "off" para desactivar. 

Cadena

force_lighting_refresh

Provoca una actualización de la iluminación/visión de todos los tokens en una página. Se puede utilizar en una sola llamada después de colocar varios tokens en una página. (¡Se deprecará en los próximos meses!) 

Booleano

fog_opacity

Opacity of the fog of war for the GM.

Booleano

lightupdatedrop

Solo actualizar la Iluminación Dinámica cuando un objeto es soltado.

Booleano

 


Ejemplos 

on("change:graphic", function(obj) {
  obj.set({
    has_bright_light_vision: true,
    emits_bright_light: true,
    bright_light_distance: 10
  });
});

Esto agregará los valores anteriores a un token en dos instancias:

  • al agregar un nuevo token al VTT
  • al mover un token que ya existe en el VTT, con o sin configuraciones de token ya establecidas.

Sin embargo, usar on(“change es peligroso porque si actualizas las configuraciones del token para un token específico, eso desencadena un evento de cambio, que activará esta API. Por lo tanto, si tiene algo como esto en su script API, la configuración de su tokenpermanecerá siempre así para cada token, a menos que añada algunas sentencias condicionales para que funcione como usted desea.

on("change:graphic", function(obj) {
  obj.set({
    has_bright_light_vision: true,
    emits_bright_light: true,
    bright_light_distance: 10,
    emits_low_light: true,
    low_light_distance: 25
  });
});

Este ejemplo establecerá Vision en cualquier tokenque haya cambiado (movido, actualizado, añadido a laVTT, etc). La fichatambién emitirá 10 pies de distancia de luz brillante, así como 15 pies de distancia de luz baja.

Obsérvese cómolow_light_distanceestá configurado en25. Esto se debe a que el valor delow_light_distancedebe ser la suma debright_light_distancey la cantidad que desee que emita el testigoLow Light Distance - en este caso, es15.

 

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 43 de 69