Anderson Mendoza

Ingeniero de sistemas Cartagena, Colombia

Todos los artículos

Cómo está hecho este sitio

El globo de esta página

· 5 min de lectura

El globo de la página de inicio: la tierra dibujada con puntos, y una marca con anillos en Cartagena

En la primera página de este sitio hay un globo pequeño que marca dónde vivo. Es lo único que se mueve en la página, y son unas ochenta líneas de JavaScript sobre un canvas sencillo, sin ninguna biblioteca detrás. Así funciona.

Por qué no una biblioteca

La opción habitual para un globo de puntos es cobe, y es buena. Dibuja con WebGL, y lo que dibuja es una esfera iluminada, con un resplandor alrededor. Este sitio está hecho sobre un sistema de diseño cuyas reglas incluyen tonos planos, sin degradados ni resplandores, así que una bola iluminada habría sido lo único en la página que no encajaba. Yo quería el globo en los dos colores del panel: su tinta para la tierra y un tono más profundo de su fondo para el mar.

Hacerlo a mano pide tres cosas: un mapa, puntos sobre una esfera y una forma de girarla.

Un mapa en un kilobyte

El globo tiene que saber dónde hay tierra, y nada más. Por eso el mapa es una cuadrícula de 128 por 64 celdas que cubre toda la Tierra, con un bit por celda: tierra o no. Son 8.192 bits, es decir 1.024 bytes, y están en el script como una sola línea en base64. Lo muestreé del mapa que dibuja cobe (cobe tiene licencia MIT).

const mask = Uint8Array.from(atob(LAND), c => c.charCodeAt(0));
const isLand = (lat, lon) => {
  const k = Math.min(63, Math.floor((.5 - lat / Math.PI) * 64)) * 128
          + Math.min(127, Math.floor((lon / Math.PI + 1) * 64));
  return mask[k >> 3] & (128 >> (k & 7));
};

Una celda mide casi tres grados de ancho, unos 310 km en el ecuador. Es poco detalle, pero el globo se dibuja con 216 píxeles de diámetro como máximo, y a ese tamaño nada más fino se notaría.

Puntos repartidos por igual

Un punto en cada cruce de latitud y longitud amontonaría puntos en los polos. La manera habitual de evitarlo es una espiral de Fibonacci: se va de un polo al otro en pasos iguales de altura, girando el ángulo áureo en cada paso, y los puntos quedan repartidos por igual en toda la esfera.

for (let n = 0, N = 7200; n < N; n++) {
  const y = 1 - (2 * n + 1) / N, r = Math.sqrt(1 - y * y);
  const a = n * 2.39996323, x = r * Math.sin(a), z = r * Math.cos(a);
  if (isLand(Math.asin(y), Math.atan2(x, z))) dots.push(x, y, z);
}

De los 7.200 puntos, 2.405 caen en tierra y se conservan. Esto corre una sola vez, al cargar la página.

Dibujarlo

En cada cuadro se gira cada punto según la rotación del globo, se descartan los de la cara de atrás y el resto se dibuja como círculos pequeños. La profundidad hace el trabajo que en un globo iluminado hace la luz: un punto que mira hacia ti es más grande y más oscuro, y uno cerca del borde es pequeño y tenue.

Darle a cada uno de dos mil puntos su propia opacidad serían dos mil rellenos separados. Por eso los puntos se reparten en cuatro franjas según su profundidad, y cada franja se dibuja como un solo trazado con un solo relleno. Son cuatro rellenos por cuadro, y a este tamaño cuatro niveles de opacidad se ven como una caída suave.

for (let band = 0; band < 4; band++) {
  ctx.globalAlpha = .16 + band * .17; ctx.beginPath();
  for (let i = 0; i < dots.length; i += 3) {
    const [sx, sy, depth] = see(dots[i], dots[i + 1], dots[i + 2]);
    if (depth <= 0) continue;
    if (Math.min(3, Math.floor(depth * 4)) !== band) continue;
    const dot = R * (.0075 + .006 * depth);
    ctx.moveTo(sx + dot, sy); ctx.arc(sx, sy, dot, 0, TURN);
  }
  ctx.fill();
}

Los colores no están escritos en el script. Lee de la página el color del texto y el fondo del globo, y los vuelve a leer cuando cambia el tema, así que queda bien de día y de noche sin conocer ninguna de las dos paletas. Con una salvedad: los colores del panel pasan al tema nuevo en cerca de medio segundo, y leídos en el instante del cambio, Firefox y Safari devuelven los anteriores. Por eso el globo sigue leyendo durante ese medio segundo y cambia junto con el panel.

Cómo se mueve

El globo mira hacia Cartagena, inclinado un poco para que se vea ligeramente desde arriba, y se mece unos 17 grados a cada lado a lo largo de 26 segundos. Se puede arrastrar: un arrastre del largo del radio lo gira un radián, de modo que la tierra sigue al puntero. Si lo sueltas con impulso sigue girando, y luego un resorte suave lo trae de vuelta:

turn += vTurn + (rest - turn) * .03;   // un poco del camino de vuelta
vTurn *= .94;                          // y el impulso se apaga

En la marca, dos anillos se abren y se desvanecen, con medio ciclo de diferencia.

Cuando nadie mira

Tres cosas evitan que cueste más de lo debido. Deja de dibujarse cuando sale de la ventana. Con el movimiento reducido activado no se mece ni late; todavía se puede girar a mano, y una vez vuelve a su sitio deja de dibujarse del todo. Y sin JavaScript el panel muestra el lugar, las coordenadas y la zona horaria, sin un círculo vacío donde habría estado el globo.

Todo el script del sitio, del que el globo es la parte mayor, pesa 4 kB con gzip.

Lo que el mapa deja fuera

Una isla más pequeña que una celda puede caer entre las muestras. Jamaica, Puerto Rico y Hawái no están en este globo, y Cuba y La Española sí. Un mapa de 256 por 128 las tendría y pesaría cuatro kilobytes. A 216 píxeles la diferencia son unos pocos puntos.

A continuación

  • El sistema de diseño de esta página

    · 6 min de lectura

    Este sitio está dibujado con Mereframe Components, el sistema de diseño que escribí para mis propios productos. Sus seis reglas, cómo una superficie saca sus colores de un solo número, por qué el estado se escribe en ARIA y qué parte carga esta página.

  • Cómo hacen imágenes los modelos de difusión

    · 5 min de lectura

    Un generador de imágenes parte de ruido y lo va quitando poco a poco. Qué tuvo que aprender para lograrlo, dónde entra el prompt, y por qué es rápido.

Para trabajo, o sobre cualquier cosa que haya construido: hello@mereframe.com