ProntoScript. Guide de Poche. ProntoScript Guide de Poche Page 1

Transcription

1 ProntoScript Guide de Poche ProntoScript Guide de Poche Page 1

2 ProntoScript Guide de Poche Page 2

3 ProntoPro Sommaire Sommaire Opérateur de Comparaison Opérateur d Affectation Opérateur liais au Chaîne de Caractères.. 5 Opérateur Hold () Release () Syntaxe Générale Function Number (), String () Widget Test Conditionnel Les Timers Port RS Les Relais Opération sur les chaines de Caractères La molette ProntoScript Guide de Poche Page 3

4 Opérateurs de Comparaison Nom Description = Permet d assigner une valeur = = Renvoie vrai si les opérandes sont égaux.!= Renvoie vrai si les opérandes ne sont pas égaux. = = = Renvoie vrai si les opérandes sont égaux et du même type.!= = Renvoie vrai si les opérandes ne sont pas égaux et/ou pas du même type. > Renvoie vrai si l'opérande de gauche est plus grand que l'opérande de droite. > = Renvoie vrai si l'opérande de gauche est plus grand ou égal à l'opérande de droite. < Renvoie vrai si l'opérande de gauche est plus petit que l'opérande de droite. <= Renvoie true si l'opérande de gauche est plus petit ou égal à l'opérande de droite. ProntoScript Guide de Poche Page 4

5 Opérateurs d Affectation Nom Description + Addition - Soustraction / Division * Multiplication % Module (Reste de la division) i ++ i=1 et a=i++ // a=1 et i=2 ++ i i=1 et a=i++ // a=2 et i=2 Nom X += Y X - = Y X * = Y X / = Y X % = Y X <<= Y X >>= Y X >>> = Y X &= Y X ^ = Y X = Y Description X = X + Y X = X - Y X = X * Y X = X / Y X = X % Y X = X << Y X = X >> Y X = X >>> Y X = X & Y X = X ^ Y X = X Y Nom Description parseint( ) Partie entière Floor( ) Retourne la valeur inférieur (Math.floor(2.5) ; 2) ceil( ) Retourne la valeur supérieure (Math.ceil(2.5) ; 3) abs( ) Retourne la valeur absolue (Math.abs(-3) ; 3) random( ) Génère un nombre aléatoire entre 0.0 et 1.0 PI Le nombre Pi ( ProntoScript Guide de Poche Page 5

6 Opérateurs Liés aux Chaines En plus des opérateurs de comparaison, qui peuvent être utilisés avec des chaînes, l'opérateur de concaténation (+) permet de concaténer deux chaînes, c'est-à-dire qu'il renvoie une autre chaîne formée par l'union des deux chaînes spécifiées en opérandes. À titre d'exemple, "ma " + "chaîne" renvoie la chaîne "ma chaîne". L'opérateur d'affectation += peut aussi servir à concaténer des chaînes. À titre d'exemple, si la variable machaine contient la valeur "alpha", alors l'expression machaine += "bet" renvoie "alphabet" lorsqu'évaluée et affecte cette valeur à machaine. ProntoScript Guide de Poche Page 6

7 Opérateurs Hold / Release HOLD Appui Prolongé Il est parfoit nécessaire d envoyer plusieurs fois un ordre lorsqu un bouton reste appuyé. Pour ce faire il vous faut écrire une fonction onhold dans votre bouton. Pour cela, placez le code suivant dans le code ProntoScript de votre bouton : onhold = function ( ) // Action à répéter } onholdinterval = 1000 ; // Temps en msec RELEASE Action lorsque l on relache le bouton Il est possible d effectué une action lorsque l on appui sur un bouton et une seconde lorsque l on relachera celui-ci. Pour ce faire on utilisera la fonction onrelease : info.visible = true; onrelease = function() info.visible = false; }; ProntoScript Guide de Poche Page 7

8 Opérateurs Précédence des Type d opérateur Opérateurs de ce type membre. [] Appel/création d instance () new Négation/incrémentation Multiplication/Division * / % Addition/Soustraction + - Décalage bit-à-bit << >> >>>! ~ typeof void delete comparaison < <= > >= in instanceof égalité ==!= ===!== et bit-à-bit & ou exclusif bit-à-bit ^ ou bit-à-bit et logique && ou logique condition?: = += -= *= /= %= <<= >>= affectation >>>= &= ^= = virgule, ProntoScript Guide de Poche Page 8

9 Fonctions Number / String Les fonctions Number et String permettent de convertir un objet en un nombre ou une chaîne de caractères. Leur syntaxe est : Number(objRef); String(objRef); où objref est une référence à un objet. L'exemple suivant convertit l'objet Date en une chaîne lisible. D = new Date ( ); // La ligne suivante renvoie // "Thu Aug :37:43 GMT+0200" x = String(D); ProntoScript Guide de Poche Page 9

10 ProntoScript Widget Var mybutton = GUI.widget(«MY BUTTON») ; Var mybuttontext = mybutton.label; // utilise la propriété Label de la classe Bouton Nom Description height Détermine la Hauteur d un objet label Texte qui s affiche dans le bouton/panel left Détermine la position Horizontale de l objet onhold Contient la fonction appelée lors d un appui long onholdinterval Définit l intervalle de répétition de l appui long. onrelease Fonction déclenché lorsque l on relache un bouton. stretchimage Permet à l image d un objet de s adapter à sa taille. tag Récupére le nom de l objet. top Détermine la position verticale d un objet. visible Permet masquer ou d afficher un objet. width Détermine la Largeur d un objet Nom executeactions() getimage() setimage() Description Exécute les actions présentent dans la programmation d un bouton, s il y en a. Récupère l image d un objet. Change l image d un objet pour un état donné (pressed ou released). onhold = function() // Code à exécuter } onholdinterval = 1000; // Temp entre répétition en ms var pnl1 = CF.widget( _PANEL_1 ); var pnl2 = CF.widget( _PANEL_2 ); // Prend l image du panel 2 et l affecte au panel 1 pnl1.setimage(pnl2.getimage()); ProntoScript Guide de Poche Page 10

11 ProntoScript RS Déclaration Afin de pouvoir contrôler les boitiers d extensions, il faut les déclarer : Port RS Var e = CF.extender[0]; s = e.serial[0]; Nom Description s.bitrate = 9600; bitrate Vitesse de communication s.datavits = 8; s.stopbits = 1; databits Bit de Data s.parity = 0; // stopbits Bit de Stop None Var parity Parité Envoi d une commande s.send( PWON \r ); Récupération d information La commande suivante envoie une demande de niveau de volume à un processeur audio (MV?) et capture les réponses jusqu'à recevoir un retour chariot (\r). La valeur 250 indique que Var volume = s.match( MV? \r, \r,250); Afin de ne pas bloquer le boitier de contrôle, on écrira le script suivant dans la page avec une répétition toutes les secondes. De cette manière le boitier sera vérouillé peu de temps toutes les secondes. d = s.match("","\r",0); // Synchronous read with timeout=0.../* parse d for data to be displayed */ ProntoScript Guide de Poche Page 11

12 ProntoScript Relais Déclaration Afin de pouvoir contrôler les boitiers d extensions, il faut les déclarer : Action Var r = CF.extender[0].relay[0]; If(r.get() == false) r.set(true); } Nom Get( ) Set( ) Toggle( ) Description Récupère l état du relais Passe l état du relais à ON ou OFF Inverse l état du relais ProntoScript Guide de Poche Page 12

13 ProntoScript Test Conditionnel If / Else If (expression) Statement 1 Else Statement 2 Block Switch Var dayname ; Switch(dayNumber) Case 0: dayname = Dimanche ; break; Case 1: dayname = Lundi ; break; Default: dayname = Indéfini ; break; } Boucle while Var i=0; While (i<10) i++; Diagnostics.log(i); } Boucle For For(var i=0;i<10;i++) var messages = [ one, two, three ]; for (var I in messages) Diagnostics.log(i); } Diagnostics.log(i); } ProntoScript Guide de Poche Page 13

14 ProntoScript Les Timers System.delay() Permet de stopper le fonctionnement de la télécommande durant un certain temps. page("ircodes").widget("hall_lights_on").executeactions(); System.delay(10*60*1000); // msec page("ircodes").widget("hall_lights_off").executeactions(); Page Timer Exécute le timer de la page en cours. page("ircodes").widget("hall_lights_on").executeactions(); halllightstimer = 10; // seconds scheduleafter() Exécute une fonction spécifique après un temps donné. page("ircodes").widget("hall_lights_on").executeactions(); function halllightsoff() page("ircodes").widget("hall_lights_off").executeactions(); } scheduleafter(10*60*1000, halllightsoff); Il faut noter que lorsque l écran est en veille, tous les timers sont stoppés. Ils reprendront a la valeur qu ils avaient avant le passage en mode veille. Il existe seulement 2 cas où l écran peut passer en veille tout en permettant le fonctionnement des timers : Lorsque l écran est sur sa station d accueil Lorsque l écran est raccordé à un PC via le cordon USB ProntoScript Guide de Poche Page 14

15 Les chaines de caractères La concaténation L'opération de base est la concaténation de chaînes. Elle consiste à assembler deux chaînes en une seule. L'opérateur est le +, à ne pas confondre avec l'opérateur addition qui s'applique aux nombres. var chaine1="vive le "; var chaine2="javascript"; var chaine=chaine1+chaine2; La variable chaine contient après ce script "Vive le JavaScript". La concaténation est une opération simple et très utile. La longueur d'une chaîne Une chaîne de caractères en javascript est un objet string sur lequel s'appliquent des propriétés et des méthodes. La propriété length indique le nombre de caractères de la chaîne. Pour une chaîne définie par var chaine="azerty";, chaine.length retourne le nombre de caractères, ici 6 caractères. Récupérer le n ième caractère La méthode charat(n) récupère le caractère n. Attention, le premier caractère a comme indice 0. Pour une chaîne initialisée par var chaine="azerty", chaine.charat(1) retourne "z". ProntoScript Guide de Poche Page 15

16 Les chaines de caractères Extraire une sous-chaîne Il est utile de pouvoir extraire un morceau d'une chaîne. Par exemple, déclarons la variable date="15/08/2000". La question est de récupérer le jour, le mois et l'année dans 3 variables différentes. var date = "15/08/2000"; var jour = date.substring(0,2); var mois = date.substring(3,5); var annee = date.substring(6,10); Après ce script, jour vaut 15, mois vaut 08 et annee vaut La méthode substring attend 2 paramètres : - l'indice du premier caractère (inclus), - l'indice du dernier caractère (exclus). Si les deux paramètres sont inversés, javascript rétablit l'ordre logique : chaine.substring(6,10) et chaine.substring(10,6) auront le même effet. Si le deuxième paramètre est omis, la chaine retournée commence à l'indice indiqué et se termine à la fin de la chaîne. Retrouver une sous-chaîne dans une chaîne Deux méthodes permettent de retrouver une sous-chaîne d'une chaîne. Ces méthodes retrouvent la position d'une chaîne et retourne son indice. Par exemple, vous avez dans une variable javascript un nom de domaine et vous souhaitez retrouver l'extension : var domaine=" var extension=domaine.substring(domaine.lastindexof(".")); La méthode lastindexof(souschaine) retourne l'indice de la dernière occurrence de souschaine. Si la sous-chaîne n'est pas trouvée, lastindexof retourne -1. ProntoScript Guide de Poche Page 16

17 Les chaines de caractères Retrouver une sous-chaîne dans une chaîne, le retour Il existe une autre méthode très proche chaine.indexof(souschaine,debut) qui retourne l'indice de la première occurrence de souschaine trouvée à partir du caractère debut de chaine. Cette méthode permet par exemple d'extraire le domaine d'une url complète : var url=" var domaine=url.substring(7,url.indexof("/",7)); La variable domaine contient dans cet exemple qui est une sous-chaine de url qui commence au caractère 7 et qui se termine au premier slash (/) après " MAJUSCULES / minuscules JavaScript offre deux méthodes pour transformer les lettres (et uniquement les lettres) d'un mot en majuscules ou en minuscules. var chaine="ceci est un texte"; var maj=chaine.touppercase(); var min=chaine.tolowercase(); A la fin de ce script, maj contient : CECI EST UN TEXTE et min contient : ceci est un texte On peut penser que ces traitements sont superflus. Ils permettent en fait de rendre plus homogène une saisie. Imaginez que vos visiteurs remplissent un formulaire avec leurs coordonnées postales, certains mettront sans doute leur nom sans majuscule, le pays en minuscules... Grâce à ces méthodes, vous pourrez corriger leur saisie et avoir un fichier client homogène. Un exemple complet est traité dans le paragraphe suivant. ProntoScript Guide de Poche Page 17

18 Pour utiliser la molette en ProntoScript, on utilisera un événement onrotary. Il vous permet de capturer le mouvement de la molette et ainsi de déclencher des actions en conséquence : Gestion de volume Gestion de température Défilement dans une liste Etc Utilisation basique : onrotary = function(clicks) //Placer votre programmation ici. }; Utilisation avancée : La molette peut servir, pour de multiples applications, très rapidement. Un bon exemple est avec un serveur multimédia. Dans un tel cas, l utilisateur se servira de la molette pour parcourir les centaines de morceaux de musique de son serveur. Mais pour ne pas rentre trop fastidieuse cette navigation, on pourra compléter le script pour qu il gère l accélération de la rotation. onrotary = function(clicks) var accclicks = 0; // Si la valeur de rotation est supérieure à x (3) il y a accélération if (Math.abs(clicks) > 3) // accélération accclicks = (Math.exp(Math.abs(clicks)-1))/(Math.abs(clicks)-1); // set the direction of the rotation (left / right) accclicks = parseint((clicks > 0)? accclicks : -accclicks); } else // Sinon pas d accélération accclicks = clicks; } /*Utilisation normale (accclicks) */ }; La molette ProntoScript Guide de Poche Page 18

19 Covert Arts Une utilisation possible de cette fonctionnalité est de récupérer des images de jacquette depuis un serveur. En plus la configuration de la connexion réseau pour récupérer les données, l image devra être créée à partir des données reçues et ensuite affichée dans un objet. var socket = new TCPSocket(); var receiveddata = ""; socket.onconnect = function() write("get /images/imagefilename.jpg + " HTTP/1.0\n\n"); }; socket.ondata = function() receiveddata += read(); }; socket.onioerror = function (e) widget( output ).label = "IOError " + e; }; socket.onclose = function () // remove the HTTP information from the received data var imagestartindex = receiveddata.indexof("\r\n\r\n"); var bitmapdata = receiveddata.substring(imagestartindex+4); // make and display the image var MyImage = new Image(bitmapData); widget( output ).setimage(myimage); }; socket.connect( MyServer.com,80,3000); Ajustement de l image à l objet var w = CF.widget("PANEL1","HOME1","HOME"); w.stretchimage = true; w.setimage(cf.widget("source1","resources","home").getimage()); ProntoScript Guide de Poche Page 19

20 Classe Widget ProntoScript Guide de Poche Page 20