Coordenadas de ruta SVG: leer el atributo d y pasarlo a JSON

PublicadoHerramientaExtractor de Coordenadas de Ruta SVG

Contenido
  1. Cuando te llega un atributo d entero
  2. Primero, cómo leer el atributo d sin ninguna herramienta
  3. Cómo extrae los números esta herramienta
  4. Las confusiones más habituales al leer el resultado
  5. Cómo verificar por tu cuenta que las coordenadas son correctas
  6. Resumen
  7. Preguntas frecuentes

Si al pasar un icono SVG a Canvas, a un motor de juego o a una librería de animación la cadena d="M10 10 L20 20 C..." dentro de la etiqueta <path> te pareció un mensaje cifrado, te doy la respuesta de entrada: esa cadena no es más que una repetición de «letra de comando + coordenadas numéricas».

Con solo conocer las reglas puedes extraer las coordenadas a mano, y este conversor traslada esa regla repetitiva a código para ordenarlas en tres formatos: JSON, lista de puntos y CSV. Dicho esto, hay un par de puntos en los que es fácil leer mal el resultado, así que los señalaré junto con el proceso de cálculo.

Resumen ① El atributo d representa coordenadas con letras de comando como M (mover), L (línea recta), C (curva) y Z (cerrar), seguidas de sus números. ② Esta herramienta toma la letra como comando y agrupa el resto de los números de dos en dos como x e y para exportarlos a JSON, puntos y CSV. ③ Las mayúsculas son coordenadas absolutas y las minúsculas, relativas; en la curva C también se capturan como coordenadas los puntos de control.

Cuando te llega un atributo d entero

Imagina que copiaste una sola línea de <path d="..."> del icono SVG que te pasó el diseñador. Ya sea para dibujarla igual en un <canvas> de HTML, para convertirla en el arreglo de vértices de Three.js o para meterla como coordenadas de keyframes en una librería de animación, al final lo que necesitas es una lista de coordenadas numéricas.

El problema es que el atributo d no está ordenado para que lo lea una persona. Cadenas como M10,10L20,20C30,30 40,30 50,20Z tienen espacios irregulares y los comandos pegados a los números, así que cuesta contar a ojo dónde termina cada coordenada.

Además, es habitual que un solo icono contenga decenas o cientos de coordenadas. Leerlas y separarlas una por una a mano es justo el problema que aborda este artículo.

Primero, cómo leer el atributo d sin ninguna herramienta

La sintaxis del atributo d es sencilla. Cuando aparece una letra (un comando) empieza una nueva instrucción, y los números que van detrás son sus valores. Cada comando tiene una cantidad fija de números que necesita.

  • M x y — mueve el lápiz a (x, y) (sin dibujar línea, solo cambia el punto de inicio)
  • L x y — línea recta desde el punto actual hasta (x, y)
  • H x — línea horizontal (un solo valor de x)
  • V y — línea vertical (un solo valor de y)
  • C x1 y1 x2 y2 x y — curva Bézier cúbica (2 puntos de control + punto final)
  • Z — vuelve al punto de inicio y cierra el trazado (sin números)

Y aquí va la regla más importante: las mayúsculas son coordenadas absolutas y las minúsculas, coordenadas relativas. L20 20 significa «hasta (20,20) tomando como referencia el origen del SVG (0,0) en la esquina superior izquierda», mientras que l20 20 significa «20 a la derecha y 20 hacia abajo desde el punto actual». Con los mismos números y solo cambiando la letra, la posición real es completamente distinta.

Leamos a mano el ejemplo básico M10,10 L20,20 C30,30 40,30 50,20 Z.

  • M10,10 → mueve el lápiz a (10, 10)
  • L20,20 → línea recta de (10,10) a (20,20)
  • C30,30 40,30 50,20 → curva. Punto de control 1 = (30,30), punto de control 2 = (40,30), punto final = (50,20)
  • Z → cierra volviendo al punto de inicio (10,10)

De todos ellos, el único punto por el que la curva pasa de verdad es el punto final (50,20). (30,30) y (40,30) son solo las «asas» que curvan el trazo; el dibujo no pasa por ahí. Esta distinción es clave cuando leas los resultados más adelante.

Así, con solo saber cuántos números lleva cada comando (M y L = 2, H y V = 1, C = 6, Z = 0) puedes separar cualquier atributo d y sacar sus coordenadas a mano. El problema es que con cientos de coordenadas la tarea cansa y aparecen los errores.

Compruébalo con nuestra herramienta.

Extractor de Coordenadas de Ruta SVG

Funciona en el navegador, sin instalar nada ni iniciar sesión, y no envía al servidor el atributo d que introduces: lo convierte en JSON, puntos y CSV.

Cómo extrae los números esta herramienta

Este conversor hace en código exactamente lo que acabas de hacer a mano. Todo se procesa dentro del navegador, sin enviar nada a un servidor. El orden es el siguiente.

Paso 1: corta por comandos. Divide la cadena d introducida en bloques de «una letra + los números que la siguen». Así, M10,10 L20,20 C... Z se separa en cuatro bloques: el de M, el de L, el de C y el de Z.

Paso 2: separa las letras de los números. La primera letra de cada bloque se toma como comando y el resto de la cadena se divide por espacios y comas para convertirla en un arreglo de números. Si un número negativo viene pegado, como en 10-20, se inserta un espacio delante y se separa como 10 -20.

Paso 3: genera la salida en el formato elegido. Hay tres formatos, y el resultado solo aparece al pulsar el botón «Extraer coordenadas». Si solo cambias la entrada, no se actualiza automáticamente.

JSON estructurado — guarda los comandos y sus parámetros tal cual.

[
  { "command": "M", "parameters": [10, 10] },
  { "command": "L", "parameters": [20, 20] },
  { "command": "C", "parameters": [30, 30, 40, 30, 50, 20] },
  { "command": "Z", "parameters": [] }
]

Lista de puntos X, Y — agrupa los números de cada comando de dos en dos y los aplana en pares de coordenadas.

[
  { "x": 10, "y": 10, "cmd": "M" },
  { "x": 20, "y": 20, "cmd": "L" },
  { "x": 30, "y": 30, "cmd": "C" },
  { "x": 40, "y": 30, "cmd": "C" },
  { "x": 50, "y": 20, "cmd": "C" }
]

Tabla CSV — genera una tabla Command,X,Y.

Command,X,Y
M,10,10
L,20,20
C,30,30
C,40,30
C,50,20
Z,,

Si comparas los tres formatos, la regla salta a la vista. El JSON muestra todos los números de cada comando como un bloque, mientras que la lista de puntos y el CSV emparejan siempre esos números de dos en dos como x e y. Ese emparejamiento de dos en dos es cómodo, pero también es el origen de las confusiones que veremos a continuación.

Las confusiones más habituales al leer el resultado

Primero: los puntos de control de la curva también se capturan como coordenadas. En la lista de puntos anterior, (30,30), (40,30) y (50,20) aparecen los tres como coordenadas del comando C. Pero, como vimos antes, el único punto por el que pasa el dibujo es (50,20); los dos primeros son puntos de control. Si los usas todos como «puntos de paso», obtendrás una forma extraña en lugar de la curva.

Segundo: los comandos con un solo número descolocan las columnas. Como la herramienta siempre empieza a rellenar por la x, el 80 de V80 (línea vertical) es en realidad un valor de y, pero en el CSV acaba en la columna X y la columna Y queda vacía. En la lista de puntos ni siquiera aparece, porque no tiene pareja.

Tercero: la distinción entre mayúsculas y minúsculas se conserva, pero no se convierte en posiciones. La herramienta conserva en cmd la letra original (si era M o m), pero no calcula las minúsculas (coordenadas relativas) como coordenadas absolutas. Con los números de un comando en minúscula tienes que tener en cuenta por tu cuenta que son «desplazamientos respecto al punto anterior».

ComandoNúmero de valoresSignificadoCómo aparece en el resultado
M / L2mover / línea rectaun par x, y tal cual
H1 (x)línea horizontalel CSV llena solo X y deja Y vacía; no aparece en la lista de puntos
V1 (y)línea verticaligual que arriba, pero el valor (y) va en la columna X
C6curva2 puntos de control + punto final: los tres pares se capturan como coordenadas
Z0cerrarel JSON muestra un arreglo vacío, el CSV una fila vacía Z,,, y no aparece en la lista de puntos

Como referencia, el comando A (arco) lleva 7 números: dos radios, el ángulo de rotación, dos indicadores (flags) y las x e y del punto final. Esta herramienta también los empareja de dos en dos, así que los radios o los flags aparecen mezclados como si fueran coordenadas. Si la ruta contiene A o Q, tendrás que comprobar por separado qué significa cada número.

Cómo verificar por tu cuenta que las coordenadas son correctas

Si no estás seguro de que las coordenadas extraídas sean correctas, lo más fiable es hacer el camino inverso y compararlas con el dibujo. Hay dos formas de hacerlo.

Dibujar tal cual el d que introdujiste. Pega la misma cadena en <svg><path d="..."/></svg>, ábrela en el navegador o pégala en una herramienta de visualización de paths y obtendrás la forma real. Después compara a simple vista si las coordenadas de los puntos finales extraídos coinciden con los vértices del dibujo.

Marcar las coordenadas en papel o en una gráfica. Representa la x y la y de la lista de puntos en el plano cartesiano, pero ten en cuenta que en SVG el eje y crece hacia abajo. La esquina superior izquierda es (0,0), así que la orientación vertical está invertida respecto a las coordenadas que aprendiste en clase de matemáticas. Si pasas esto por alto, acabarás pensando que "las coordenadas están bien, pero la forma sale al revés de arriba abajo".

Resumen

  • El atributo d es una repetición de "letra de comando + números". La letra inicia el comando y la cantidad de números está fijada para cada uno (M·L=2, H·V=1, C=6, Z=0).
  • Las mayúsculas son coordenadas absolutas y las minúsculas, relativas. Esta herramienta solo conserva la letra; no convierte de relativo a absoluto.
  • La salida tiene tres formatos: JSON (números por comando), lista de puntos y CSV (en ambos, x e y de dos en dos), y solo aparece al pulsar el botón "Extraer coordenadas".
  • Como empareja siempre los números de dos en dos, también toma como coordenadas los puntos de control de C, y en comandos con otra cantidad de números, como H·V·Z·A, las casillas se desalinean o faltan.
  • Si tienes dudas, dibuja el mismo d y compara, teniendo en cuenta que en SVG el eje y crece hacia abajo.
Extractor de Coordenadas de Ruta SVG

Funciona en el navegador, sin instalar nada ni iniciar sesión, y no envía al servidor el atributo d que introduces: lo convierte en JSON, puntos y CSV.

Preguntas frecuentes

¿Se pueden obtener solo los puntos de paso y descartar los puntos de control de las curvas (C)?

La herramienta por sí sola no los filtra. Como empareja de dos en dos los 6 números de C y los exporta como tres coordenadas, aparecen juntos los 2 puntos de control y el punto final. Si solo necesitas los puntos de paso, basta con tomar de la salida el último par (el punto final) de cada comando C. Si extraes en el formato JSON estructurado, los datos vienen agrupados por comando, así que es fácil quedarse con los dos últimos números.

¿Qué pasa si hay comandos en minúscula (coordenadas relativas) mezclados?

Los números salen tal cual, pero ese valor no es una "posición absoluta", sino un desplazamiento respecto al punto anterior. La herramienta solo conserva la minúscula en el campo cmd; no la convierte a coordenadas absolutas. Si necesitas la posición absoluta, tendrás que ir sumando cada coordenada relativa al punto inmediatamente anterior, en orden.

¿El atributo d que introduzco se envía a un servidor?

No. Todo el análisis se realiza dentro del navegador, sin comunicación con servidores ni recogida de datos personales. Por eso puedes usarla directamente, sin iniciar sesión ni instalar nada.

El resultado no cambia.

Después de modificar la cadena d tienes que volver a pulsar el botón "Extraer coordenadas". Está pensado para que no se actualice automáticamente al cambiar solo la entrada.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Convertir SVG en componente React: qué cambia realmenteAl pegar SVG en JSX, atributos como stroke-width o class generan advertencias. Aprende la regla camelCase, el patrón {...props} y nombres de componente.
  2. Texto a binario UTF-8: cómo se convierte cada letra en 0 y 1Cómo pasa un texto a ceros y unos con UTF-8: por qué el inglés ocupa 1 byte, el coreano 3 y los emojis 4, y cómo se recupera el texto.
  3. Comparar textos: cómo leer el diff en verde, rojo y grisCompara dos textos línea por línea: verde lo añadido, rojo lo eliminado y gris lo idéntico. Explicamos el LCS y por qué una letra cambia toda la línea.
  4. CSV coreano ilegible en Excel: cómo recuperar el textoPor qué el coreano de un CSV se ve como '뷁뷁' en Excel, qué son CP949, ANSI, UTF-8 y BOM, y cómo detectar la codificación y recuperar el texto.
  5. Quitar saltos de línea: unir el texto en una sola líneaPor qué aparecen saltos de línea al copiar de un PDF o una web y cómo unir todo en una línea cambiándolos por un espacio, sin palabras pegadas.
  6. Ajustar el número de caracteres de un texto: cómo se calculaDescubre dónde se rellena cada línea al alinear a la izquierda, derecha o ambos lados, cómo se cuentan los caracteres y qué pasa con las líneas más largas.

Herramientas relacionadas