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/>.
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.
El código fuente está bajo licencia GPLv3. Los archivos se encuentran el carpeta "source", y son los siguientes:
charts.fla
Archivo base. Abrir con Adobe Flash versión MX 2004 en adelante.chart_xml.as
Archivo de código fuente ActionScript 2.0 que contiene lo relativo a la carga y "parseo" del archivo XMLchart.as
El meollo de todo, en este archivo de código fuente ActionScript 2.0 están todas las funciones que se encargan del dibujado de la gráfica.charts.swf
El archivo objeto Flash listo para cargar desde un navegador. Compatible desde Flash Player 7.examples.html
Archivo HTML con más ejemplos cargados desde varios XMLs.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