Classe PHP de génération de cartes de températures

Depuis la version 1.2, la génération des cartes de températures se fait dans une classe PHP. Vous pouvez donc vous en servir sans utiliser ClickHeat, dans votre application (tant que vous conservez les informations de licence GPL et la provenance de cette classe, à savoir Labsmedia). Merci de noter qu'il n'y a actuellement aucune transparence sur les images générées, la transparence utilisée dans ClickHeat est faite en CSS : "filter:alpha(opacity=0...100);" sous Internet Explorer, et "opacity:0...1;" sous les navigateurs Gecko (Mozilla, Firefox, etc). Ce sera peut-être une option dans les futures versions (le fait de pouvoir sortir une image transparente)

Comment s'en servir:

Un exemple est encore la façon la plus simple de l'expliquer. Faites donc un tour dans le répertoire examples/, et regardez les 2 exemples qui s'y trouvent

Fonction de la classe principale (Heatmap):

generate($width, $height) : génère une suite d'images représentant une carte de température avec une largeur fixe de $width. Si $height est absent ou vaut 0, la hauteur $height est calculée à partir de la mémoire disponible (pour éviter un dépassement de mémoire). Le résultat de cette fonction est un tableau contenant diverses valeurs, notamment la largeur, la hauteur, le nombre d'images et les chemins de la carte finale

Paramètres de la classe principale (Heatmap):

$memory : Limite de mémoire en octets. Lisez Performance et optimisation pour plus d'information
$step : Groupement des pixels : plutôt que de mettre un point à chaque position X,Y, les clics sont regroupés sur un pixel au centre d'un carré de $step x $step pixels (ce qui accélère le traitement en traitant moins de pixels)
$startStep : variable interne
$dot : Taille des points de chaleur, diamètre des points en pixels
$heatmap : Affichage sous forme de carte de température (booléen)
$palette : Correctif pour la gestion de palette, cas des carrés rouges qui s'affichent au lieu des points dégradés (booléen)
$rainbow : Affichage de l'arc-en-ciel en haut à gauche avec le nombre de clics
$copyleft : Affichage du copyleft en bas à droite
$width : variable interne
$height : variable interne
$maxClicks : variable interne
$maxY : variable interne
$image : variable interne
$file : Nom du fichier de destination, incluant un %d qui sera remplacé par le numéro de l'image, par exemple : image-%d.png sera remplacé par image-0.png pour la première partie de l'image, image-1.png pour la deuxième partie etc
$path : Répertoire où seront stockées les images après création (en utilisant le format $file)
$cache : Répertoire où seront stockées les images temporaires pendant la création (en utilisant le format $file)
$error : variable interne, à lire si generate() retourne faux
$__colors : Niveaux de dégradés: 5 valeurs ascendantes dans l'intervalle 0...127, définissant ces niveaux: bleu, bleu clair, vert, jaune, rouge
$__low : Niveau bas de couleur : de 0 à 255 (essayez-le car c'est vraiment difficile à expliquer)
$__high : Niveau haut de couleur : de 0 à 255 (doit être plus haut que $__low)
$__grey : Niveau de gris là où il n'y a pas de clics : de 0 (noir) à 255 (blanc)

Paramètres de la classe de base de données (HeatmapFromDatabase):

$host : Hôte (serveur) MySQL
$user : Utilisateur MySQL
$password : Mot de passe MySQL
$database : Base de données MySQL à utiliser
$limit : Limite du nombre de résultats renvoyés par la requête à chaque appel (limite l'utilisation de la mémoire)
$link : variable interne
$query : Requête renvoyant les coordonnées des clics (doit contenir deux %d pour la limite de hauteur), par exemple: SELECT COORDS_X, COORDS_Y FROM CLICKS WHERE COORDS_Y BETWEEN %d AND %d
$maxQuery : Requête renvoyant la coordonnées Y maximale, par exemple: SELECT MAX(COORDS_Y) FROM CLICKS

Fonction additionnelle de la classe de fichiers (HeatmapFromFile):

addFile($file) : ajoute le fichier $file à la liste des fichiers qui seront importés (vérifie l'existence du fichier, mais ne retourne pas d'erreur)

Paramètres de la classe de fichiers (HeatmapFromFile):

$files : variable interne (liste des fichiers à importer)
$regular : Expression régulière pour lire les enregistrements du fichier. La première valeur du résultat est la position X, la seconde Y. Pour plus d'information sur les expressions régulières, lisez la syntaxe des expressions régulières

 
Publié par 76 le 4 juin 2010, 11:42.

Commentaires

Aucun commentaire pour le moment

Nom(Champ obligatoire)
Email(Champ obligatoire)
Email(Champ obligatoire)
Site internet ou blog
Caractères restants : 1000