
  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/>.


    Cmo usarlo

Para usar estas grficas, slo necesitas dos cosas: un archivo XML que
proporcione los datos, y el archivo charts.swf, que es el encargado de
pintar la grfica.

Inserta el objeto de Flash charts.swf en una pgina 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 parmetro
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 algn servidor con descarga directa.


    Cdigo fuente

El cdigo fuente est bajo licencia GPLv3
<http://www.gnu.org/copyleft/gpl.html>. Los archivos se encuentran el
carpeta "source", y son los siguientes:

    * |charts.fla| Archivo base. Abrir con Adobe Flash versin MX 2004
      en adelante.
    * |chart_xml.as| Archivo de cdigo fuente ActionScript 2.0 que
      contiene lo relativo a la carga y "parseo" del archivo XML
    * |chart.as| El meollo de todo, en este archivo de cdigo fuente
      ActionScript 2.0 estn todas las funciones que se encargan del
      dibujado de la grfica.
    * |charts.swf| El archivo objeto Flash listo para cargar desde un
      navegador. Compatible desde Flash Player 7.
    * |examples.html| Archivo HTML con ms ejemplos cargados desde
      varios XMLs.
    * Varios archivos XMLs, que se usan para los ejemplos.


    Referencia completa de parmetros en el archivo XML

parmetro (obligatorios*)      valores posibles (valor por defecto)      descripcin
title*                         cadena de texto                           Ttulo de la grfica
subtitle                       cadena de texto                           Subttulo de la grfica
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 grfica, *bars* para grficos de barras y *pie* para grficos 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 grfica 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 nmeros de las barras. Aplicable slo a barras
refresh_time                   nmero entero                             Nmero de segundos hasta la recarga del archivo XML
chart_animation_speed          nmero entero                             Velocidad de la animacin. 0 para no tener animacin.
bars_chart_max_value           auto / nmero entero (auto)               Forzar el valor mximo de la grfica. Aplicable slo a barras
bars_chart_min_value           auto / nmero entero (auto)               Forzar el valor mnimo de la grfica. Aplicable slo a barras
header_height*                 nmero entero                             Alto del encabezado de la grfica, donde van el titulo, el subttulo y el nombre de lo representado
pie_footer_height              nmero entero                             Alto del pie de la grfica donde ir la leyenda de la tarta. Aplicable slo a tarta
pie_show_total                 true false (true)                         Mostrar o no el total en el centro de la tarta. Aplicable slo a tarta
pie_hole_size                  auto / nmero entero (auto)               Tamao en pxeles del agujero de la tarta. Aplicable slo a tarta
font_sizes > title             nmero entero (18)                        Tamao de la fuente del ttulo
font_sizes > subtitle          nmero entero (11)                        Tamao de la fuente del subttulo
font_sizes > name_value        nmero entero (14)                        Tamao de la fuente del nombre del valor representado
font_sizes > numbers           nmero entero (11)                        Tamao de la fuente de los nmeros de las barras
font_sizes > labels            nmero entero (11)                        Tamao de la fuente de las etiquetas de texto
font_sizes > tips              nmero entero (11)                        Tamao de la fuente del tooltip que aparece al pasar el ratn por algna barra o sector de la tarta
font_sizes > pie_total         nmero entero (20)                        Tamao de la fuente de la suma total de elementos que sale en el centro de la tarta. Aplicable slo a tarta
colours > colour               nmero 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*   nmero                                    Valor 1 del dato
chart_data > piece > value2*   nmero                                    Valor 2 del dato


 

