Flash charts

Version 1.0

Copyright (C) 2008, Juan Jesus G. Hinestrosa (soitu.es)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

Cómo usarlo

Para usar estas gráficas, sólo necesitas dos cosas: un archivo XML que proporcione los datos, y el archivo charts.swf, que es el encargado de pintar la gráfica.

Inserta el objeto de Flash charts.swf en una página HTML y coloca charts.xml en la misma carpeta. Si necesitas otro nombre de archivo, puedes especificarlo en la llamada a charts.swf, usando el parámetro xmlfile. Por ejemplo, charts.swf?xmlfile=mi_archivo.xml

Si vas a usarlo online, ten en cuenta que el archivo XML debe estar alojado en algún servidor con descarga directa.

Código fuente

El código fuente está bajo licencia GPLv3. Los archivos se encuentran el carpeta "source", y son los siguientes:

Referencia completa de parámetros en el archivo XML
parámetro (en amarillo obligatorios) valores posibles (valor por defecto) descripción
title cadena de texto Título de la gráfica
subtitle cadena de texto Subtítulo de la gráfica
name_value1 cadena de texto Nombre 1 de lo que representa
name_value2 cadena de texto Nombre 2 de lo que representa
type bars / pie Tipo de gráfica, bars para gráficos de barras y pie para gráficos de tarta
active_value 1 / 2 (1) El identificador del valor de lo que representa
order_by_what 0 / 1 / 2 (0) Especifica si queremos ordenar la gráfica de mayor a menor, y el identificador del valor. 0 si no queremos ordenar
rotate_bars_numbers true false (false) Especifica si queremos rotar las etiquetas de los números de las barras. Aplicable sólo a barras
refresh_time número entero Número de segundos hasta la recarga del archivo XML
chart_animation_speed número entero Velocidad de la animación. 0 para no tener animación.
bars_chart_max_value auto / número entero (auto) Forzar el valor máximo de la gráfica. Aplicable sólo a barras
bars_chart_min_value auto / número entero (auto) Forzar el valor mínimo de la gráfica. Aplicable sólo a barras
header_height número entero Alto del encabezado de la gráfica, donde van el titulo, el subtítulo y el nombre de lo representado
pie_footer_height número entero Alto del pie de la gráfica donde irá la leyenda de la tarta. Aplicable sólo a tarta
pie_show_total true false (true) Mostrar o no el total en el centro de la tarta. Aplicable sólo a tarta
pie_hole_size auto / número entero (auto) Tamaño en píxeles del agujero de la tarta. Aplicable sólo a tarta
font_sizes > title número entero (18) Tamaño de la fuente del título
font_sizes > subtitle número entero (11) Tamaño de la fuente del subtítulo
font_sizes > name_value número entero (14) Tamaño de la fuente del nombre del valor representado
font_sizes > numbers número entero (11) Tamaño de la fuente de los números de las barras
font_sizes > labels número entero (11) Tamaño de la fuente de las etiquetas de texto
font_sizes > tips número entero (11) Tamaño de la fuente del tooltip que aparece al pasar el ratón por algúna barra o sector de la tarta
font_sizes > pie_total número entero (20) Tamaño de la fuente de la suma total de elementos que sale en el centro de la tarta. Aplicable sólo a tarta
colours > colour número hexadecimal Lista de colores. Si no son suficientes para representar todos los datos, vuelve al primero
chart_data > piece > name cadena de texto Nombre del dato
chart_data > piece > value1 número Valor 1 del dato
chart_data > piece > value2 número Valor 2 del dato

Esquema gráfico de la gráfica