LiveCodeClips scripts version 2.20

La pile LiveCodeClips.rev contient un certain nombre de scripts multi-plateformes permettant de réaliser des piles fonctionnant dans tous les environnements systèmes. Il y a aussi des astuces LiveCode mises en exemple. Libre à vous de vous de fouiner dedans et de vous en inspirer pour vos propres réalisations !

Les « Libimages » de LiveCodeClips

J'ai regroupé - au sein d'images prêtes à copier-coller - des ensembles de scripts servant souvent comme : déterminer l'environnement technique, accéder aux réglages système, manipuler des images, etc. Tout ceci se fait habituellement avec une pile spécialisée qu'il n'y a plus qu'à mettre « in use » ; l'inconvénient de ceci est que si l'on veut diffuser une pile, il faut le faire en incluant l'autre pile.
Je voulais une sorte de plugin Livecode constitué d'un objet unique et qui puisse se placer dans n'importe quelle pile autonome. Et j'ai pensé à une image pour que l'objet ait une icone.
J'ai donc pompeusement baptisé « Libimage » des images contenant les scripts et les custom properties nécessaires à leur bon fonctionnement.
Elles fonctionnent en "backscripts", c'est à dire qu'elles interprètent les messages après tous les objets de la pile, à comme une "stack in use".

Installer une Libimage dans une pile

Il est conseillé de les coller dans un groupe que l'on rendra invisible et ensuite de mettre à l'endroit approprié le script d'insertion (et de retrait) des backscripts. Ceci se fait au moyen du bouton « scripts d'insertion » :

Un dialogue permet de choisir le message qui activera la Libimage (preOpenStack, preOpenCard...) et celui qui la retirera des backscripts.
Exemple de script généré :
on preOpenBackground
  insert the script of image "XPlatform" into back
end preOpenBackground
on CloseCard
  remove the script of image "XPlatform" from back
end CloseCard

Mise à jour d'une Libimage

Un outil permet de vérifier les Libimages installées dans vos piles et de les remplacer par une version plus récente dans LiveCodeClips sans être obligé de la réinstaller.

Les cartes de LiveCodeClips

Boutons de commande

	Permet d'accéder à la présente aide en ligne, ainsi que vérifier la disponibilité d'une nouvelle version.
	Permet de tester le script de la carte.
	Permet d'installer les éléments présents sur la carte.

Adresses du texte d'un mail

Récupère les adresses mail et les noms contenus dans le texte d'un message.
Enregistrez votre message au format texte et glissez le fichier obtenu sur la dragzone métallisée.
Vous pouvez également copier une portion du texte du message et cliquer la dragzone.
Les adresses mail sont récupérées sous la forme d'une liste <nom, adresse mail> séparée par des tabulations et des retours ligne.

Aidesaisie noms et rues

Ce script présent dans la Libimage XPlatfForm permet de placer en capitale l'initiale de chaque mot en tenant compte « de l'usage orthographique » français : dans un patronyme, la particule n'est pas capitalisée et dans les noms de rue, il est plus correct de ne pas capitaliser les articles. Bien utile pour un carnet d'adresses !

Syntaxe :
Aidesaisie(string,[cmode])
cmode : paramètre facultatif indiquant comment convertir le string;

• "nom" : valeur par défaut, traite un nom ou prénom ;
• "rue" ;
• "chq" : libellé d'opération bancaire.

Alertprompt 2.0

AlertPrompt est une alternative au « Answer » classique : le message est affiché pendant le délai nécessaire à la lecture du message et disparaît sans que l'utilisateur ait besoin de cliquer un bouton "OK".
Modifié pour ajouter une barre d'avancement d'un traitement de lot.

Commande ou fonction	Usage et paramètres
alert [typealerte],message,[dontclose]	Affiche un message pendant le temps nécessaire à la lecture et le fait disparaître automatiquement. Syntaxe : typealerte peut être vide ou prendre les valeurs : stop, info, warning, note ou le nom d'une image de la pile (taille maxi 27 x 27px). message: message affiché dontclose : vide : le groupe se masque automatiquement. "dontclose" : le groupe reste affiché. alert "info","Message d'information" alert "stop","Message d'erreur" alert "","Pas d'icone"
initProgress nbitems,message,[hideOK],[typealerte]	Initialise le traitement d'un lot d'éléments en déclarant le nombre d'éléments à traiter, le message affiché pendant, l'affichage ou non d'un bouton Stop permettant de l'arrêter et l'icone qui l'illustre. Syntaxe : nbitems : nombre d'éléments à traiter. message: message affiché hideOK : visibilité du bouton stop permettant d'arrêter le traitement : "hideOK" le masque. typealerte : stop, info& ou nom d'une image. initProgress 20, "Message traitement",,"info"
progressShow [compteur],[message]	Affiche l'avancement du traitement pour un élément donné : barre d'avancement. Syntaxe : compteur : valeur du compteur dans la boucle. Passer ici rien (incrément automatique de 1) ou valeur de compteur. message: le changer si nécessaire. progressShow progressShow 10,"Veuillez patienter."
GetStopRequest()	Fonction permettant de tester si l'utilisateur a cliqué le bouton Stop pendant le traitement. Syntaxe : à invoquer dans le traitement d'un item pour quitter la boucle repeat. if GetStopRequest() then exit repeat
CloseAlertPrompt	Permet de fermer le message affiché. Syntaxe : Aucun paramètre, masquage du groupe. CloseAlertPrompt

Avant de copier le groupe, déterminez sa largeur au moyen de la barre de réglages :

Copiez le script à placer au niveau des handlers de la pile principale au moyen du bouton . Le script s'appliquera à tous les groupes alertprompt des substacks de la pile.

Analyse d'une erreur Revolution

La pile "revErrorDisplay" contient le libellé correspondant aux codes d'erreur décelés par Revolution.
Ces codes ne sont pas directement interprétables et la fonction ErrorLabels() explicite leur sens.
On peut clarifier les choses en mettant ce handler dans une pile :

on errorDialog x
  answer error ErrorLabels(x)
end errorDialog

Barre d'avancement

Un modèle de pile visualisant l'exécution d'un traitement.
Le bouton « stop » permet d'interrompre le traitement en cours.
Passer par the dialogdata la liste des éléments à traiter et appeler la pile en mode "palette".
on AppelPile
  set the dialogdata to liste_données
  palette stack [nom de la pile barre]
  answer the dialogdata &"lignes traitées" -- en retour, nombre de lignes traitées
end AppelPile

Script de la pile à adapter :
on DoProcess
  (…)
    -- partie à personnaliser
    put "Traitement "&J &"/" &maxi into fld "avance"
    [traitement d'une ligne de données]
    --
  (…)
end DoProcess

Calendaricon

Groupes formant une icone de calendrier à la date donnée en paramètre.

La date en paramètre doit être au format « short system date » (format correspondant à l'affichage régional).
get "25/12/1995"
call "SetCalendarDate "&it to grp "[nom du groupe calendrier]"

A défaut de date, le calendrier affiche la date du jour :
call "SetCalendarDate" to grp "[nom du groupe calendrier]"

Choisissez le modèle de calendrier et cliquez sur le bouton « Installer… » pour copier le groupe.

Calendrier

Groupe permettant la saisie d'une date dans un calendrier.
Basé sur FLC calendar.rev de The Flexible Learning Company. Utilise la libimage XPLatForm pour déterminer le premier jour de la semaine afin de mettre en forme le calendrier selon l'usage dans le pays de l'utilisateur.
A l'ouverture de la carte faire :
send "SetCalendar" to grp "calendar"

La date par défaut est celle du jour. On peut également passer une date initiale en secondes :
send "SetCalendar " &quote &myDate &quote to grp "calendar"

Le résultat est retourné dans la globale gCalResult.Le bouton OK retourne la date choisie en secondes et le bouton Annuler retourne "cancel".

Cliquez le bouton « Installer …» pour copier le groupe dans une carte. Si le groupe doit être installé seul dans une pile, cliquer le bouton « modèle de script de pile » pour copier un template de script de pile.

CancelPending suppression message en attente

Script permettant de purger un message de la file d'attente. « the pendingmessages » contient tous les messages planifiés par une instruction du genre :
send message to object in 20

Ce script permet de les détruire si besoin.
Syntaxe :
CancelPending pMsg
pMsg : nom du message à éliminer ou "all" pour vider toute la file d'attente.

Chronomètre

Chronomètre pour mesurer la performance (temps d'exécution) d'un script.
Installer le script dans votre pile.
Faire un premier appel à Chrono en début du traitement à chronométrer
Deuxième appel à Chrono[message facultatif] en fin de traitement : affiche le temps écoulé depuis le premier appel en secondes et millièmes.

on exemple
  Chrono -- premier appel
  sortcds
  Chrono "Tri des cartes et construction index" -- deuxième appel en fin de traitement
end exemple

Clonage répertoires

Recrée à un autre endroit l'arborescence des répertoires d'un répertoire précis, sans les fichiers qu'ils contiennent.

Colornames

Noms des couleurs de Revolution : outil affichant la valeur correspondante RGB et hexa. Cliquer sur la valeur RGB ou hexa équivalente la copie.

Contenu Clipboarddata

Permet de visualiser le contenu du Presse-Papier (clipboardData) sur toutes les clés existantes : text, html, rtf, etc.

Conversion textedit

Utilise TextEdit pour procéder aux conversions de documents d'un type vers un autre : par exemple, word vers html.

Convertir au format Legacy

Glissez sur la dragzone les piles que vous souhaitez convertir à une version antérieure.

Les piles converties sont créées dans un dossier « Legacy stacks » sur le Bureau.

Si la version de moteur LiveCode est inférieure à 3, les piles sont enregistrées au format 2.4 (MetaCard), sinon au format 2.7 (Revolution). Ne fonctionne qu'en environnement « Developpement ».

Dates

Exemples de divers formats de la date.
Cocher un format de date pour visualiser le résultat.

Dragdata

Outil de démonstration des données obtenues lors d'un drag selon le paramètre donné à dragdata.
Choisissez le type de drag et glissez sur la dragzone un fichier ou une portion de texte.

Décoder un fichier

Tente de déterminer le charset d'un fichier; s'il n'est pas trouvé, affiche une pile permettant de prévisualiser le fichier et de choisir un charset, puis propose de le convertir.
Glissez sur la Dragzone le fichier à analyser ou cliquez le bouton « Test ».
Utilise la fonction xpConvertTextfile() appartenant la Libimage XPlatForm pour déterminer l'encodage d'un fichier contenu dans la globale gdocCharset (3 items : charset,type de saut de ligne,type de fichier).

A défaut de pouvoir déterminer l'encodage, le handler affiche un modèle de pile « preview » pour demander à l'utilisateur de choisir le charset le plus proche. Une prévisualisation du fichier permet de se rendre compte si le charset choisi convient.

Propose ensuite la conversion du fichier avec les éléments trouvés ou choisis.

Cliquez le bouton « Installer… » pour installer au choix la pile Preview ou le handler de conversion du fichier.

Exemples AppleScript avec LiveCode

Exemples de scripts de la Librairie-image AScriptLib

Fichier tri par item

Script permettant de trier un fichier texte sur un item donné.

• choisissez le séparateur d'item du fichier et le rang de l'item servant de critère de tri, ainsi que le type de tri (numérique, texte, date).
• triez le fichier
• « Lister les doubles » crée un fichier des lignes en double sur la clé considérée,
• « Eliminer les doubles » crée un fichier sans double sur la clé considérée.

Cliquez le bouton « copier… » pour copier le le script de tri généré.

Fichiers

Exemple de script listant les fichiers d'un répertoire au moyen de la fonction XPFileList() de XPlatForm.
Le script explore les répertoires inclus dans le répertoire sélectionné, peut filtrer par type de fichier, faire la somme des tailles par type de fichier, etc.

fonctions stacks

Différentes fonctions permettant de recenser des piles :

• revLoadedStacks() renvoie la liste des noms courts de toutes les piles chargées.
• openStacks() renvoie la liste par le nom court de chaque pile ouverte.
• stacks() renvoie une liste des chemins de fichiers des piles ouvertes.
• topStack() permet de savoir quelle pile se trouve dans la pile actuelle.
• mainStacks() renvoie la liste par le nom court de chaque pile principale.
• substacks d'une pile donne la liste des sous piles, une par ligne.
• stacksInUse indique les piles placées dans le chemin du message par une commande start using.

Groupe Plus-Moins

Groupe de 2 boutons destinés, par exemple, à créer une nouvelle carte ou en supprimer une.
Chaque bouton possède 3 icones : normal, désactivé et contrasté.
L'outil affiche un modèle pour chaque bouton : vous pouvez modifier le nom, le label, le tooltip, ainsi que le script.
Apportez les modifications nécessaires au modèle et copiez votre groupe personnalisé avec le bouton « Installer… ». Collez-le à l'endroit désiré.

Hypercard

On peut importer une pile HyperCard dans LiveCode. La pile convertie possède une propriété "HCAddressing" qui vaut "true" et qui permet à LiveCode d'interpréter automatiquement les scripts faisant référence à des champs ou boutons de fond ou de carte.
Le script de cette carte permet de remettre la propriété à "false" (à condition d'adapter auparavant les scripts en conséquence : supprimer la référence au fond).

Icones des boîtes de dialogue

Sous Mac OSX, LiveCode gère deux icones dans les dialogues Answer, Ask et Ask password:

• une icone d'application (celle de LiveCode) dont la taille est 64x64 pixels ;
• une mini-icone d'application, dont la taille est 32x32 pixels, qui se juxtapose en bas à droite de celle qui qualifie le message (ex: answer error "Message" au lieu de answer "Message") ;
• fonctionnement plus aléatoire sous StackRunner.

On peut personnaliser ces icones en alimentant 2 variables globales :
grevAppIcon -- id de l'icone application
gREVSmallAppIcon -- id de la "small icon" de l'application qui se place en bas à droite de la grande icone :"information", "question", "error" ou "warning".
Le bouton « Installer… » fournit un modèle de script installant les icones spécifiques et restaurant les valeurs standards.

Jet de dé

Un dé à lancer : animation sur un bouton qui se déplace en changeant d'icone.
Juste pour l'exemple…

Keydown sur un champs liste

Script de prépositionnement sur la ligne commençant par les caractères tapés.
Le script positionne une puce sur la ligne choisie.
Peut être adapté pour positionner un ou plusieurs boutons de traitement de la ligne sélectionnée.

Launch

Lancer une appli ou un fichier avec une appli (ne marche pas avec un document html).

Lecture Colors Styles

Script lisant les couleurs d'une feuille de styles css pour colorier les champs avec la couleur de fond.

La feuille de style possède des sélecteurs dont le nom correspond à celui d'un champs de l'exemple. En cliquant le champs, on peut changer la couleur de fond et celle du texte.
Le bouton « Restaurer couleurs » rétablit les couleurs d'origine.
Le bouton « générer CSS » applique les changements à feuille de style et produit sur le Bureau une page HTML que l'on peut visualiser.
Exemple à transposer.

Lecture de Resources

Les fichiers Macintosh possèdent 2 branches : un datas-fork (partie données) identique à un fichier classique ASCII et un resource-fork, ou fichier de ressources, structuré en entités diverses représentant des données système : icônes, menus, strings, etc.
Cet exemple permet de lire le resource fork et de vider « en clair » certaines ressources : TEXT, STR, STR# …
Le nom court du fichier ne doit pas dépasser 31 caractères pour pouvoir être lu (contrainte du Resource Manager qui provient de l'architecture Classic, antérieure à OSX). Sous OS X, LiveCode restitue le nom des ressources sous une forme inversée (GOLD au lieu de DLOG, par exemple) : le script les restitue d'une manière correcte.

Libimage AScriptLib version 2.02

Cette librairie-image contient des fonctions pilotées par AppleScript sous MacOSX. Requiert l'installation de la Libimage XPlatform. Seul « ChangeFileDate » fonctionne aussi sous Windows et Linux.

Libimage Backupstack version 1.69

Libimage de sauvegarde d'une pile, qui exporte dans un fichier les données de chaque carte et permet de les réimporter dans une nouvelle version de la pile. Le fichier généré est en fait un script qui regénère chaque le carte en alimentant son contenu.
Backupstack permet d'ajouter à la pile un mot de passe :

• Administrateur : protège l'export et l'import de données si le mot de passe existe dans la pile ;
• Utilisateur : si ce mot de passe existe dans la pile, la pile est cryptée avec (pile illisible avec un éditeur de texte); si on ne le fournit pas, la pile est refermée.

Scripts très complets, mais à tester ! : vérifiez l'exhaustivité de la sauvegarde dans le contexte propre à votre pile. Sauvegardez votre pile avant d'installer la gestion du mot de passe utilisateur : ce mot de passe cryptant la pile, vous pourriez ne plus pouvoir l'ouvrir en cas de fausse manip dans la programmation ou d'oubli du mot de passe.

Appel initial de Backupstack

Les scripts sont incorporés à l'image qu'il suffit de copier puis de coller dans la pile désirée.
A l'ouverture de votre pile, il faut appeler les scripts contenus dans la Libimage au moyen des instructions suivantes (par exemple).
on preopenstack
  insert the script of image "Backupstack" into back (…)
end preopenstack
on closestack
  remove the script of image "Backupstack" from back
end closestack

Libimage Customslib version 1.4

Libimage de gestion des custom properties de tous les objets : piles, cartes, contrôles.
Tous les messages doivent être envoyés à l'objet dont on veut manipuler les custom properties :

Send "exportcustoms2file" to this card

En exemple, un inspecteur permettant de visualiser les customs, de les importer et exporter à partir de fichiers. Les boutons ont une bulle d'info permettant se savoir ce qu'ils font.

Libimage ImagesTools version 1.45

Libimage de manipulation d'images et d'extraction des données EXIF. Réalisée à partir de getExif1.4(<filePath>) -- http://homepage.mac.com/udi/
Intègre les routines de manipulation d'images antérieurement implémentées dans XPlatform (SetthumbSize,SetThumb ,ExportThumbImage et ResizeObject) et AppleScriptLib (getImageLegende).
Requiert l'installation de XPlatform et AppleScriptLib.
Nouveautés v 1.3: support de la librairie Perl ExifTool de Phil Harvey si elle est installée dans le système. Voir ici pour l'installation d'exiftool.
Correction d'un bug sous Yosemite et El Capitan pour lesquels Exiftool n'est plus installé au même endroit qu'auparavant.

Libimage LCDownloadlib version 1.3

Une libimage pour télécharger une URL.

• « supprimer les javascripts » retire les scripts présents dans la page;
• « ajouter base href » place l'adresse absolue de la page pour un positionnement correct des objets donnés en URL relative.

Libimage Revo2HTML version 1.5

Demande la sélection d'une pile et l'exporte les scripts de tous les objets sous forme d'une page HTML créée sur le Bureau.
Les customs properties de chaque objet sont listées avant son script.

Syntaxe :
exportRevo2html [garderformat]
garderformat : paramètre facultatif;

• aucune valeur : le HTML extrait est converti par défaut en HTML stylé CSS, plus compact.
• une valeur quelconque (x par exemple) : le HTML extrait est restitué tel quel, sans conversion de styles.

Les scripts d'une pile cryptée par mot de passe ne sont pas extraits.

Libimage XPlatform version 2.26

Permet de réaliser des scripts fonctionnant sur toutes les plateformes et de réaliser des équivalences d'emplacements de dossiers, par exemple : « Documents » sur Mac et « Mes documents » sur Windows.

Appel initial de la Library XPlatform

Les scripts sont incorporés à l'image qu'il suffit de copier puis de coller dans la pile désirée.
Ces scripts chargent les paramètres d'environnement (locales) de la plateforme : version du système, langue de l'utilisateur et organisation du Bureau.
A l'ouverture de votre pile, il faut appeler les scripts contenus dans l'image au moyen des instructions suivantes (par exemple).
on preopenstack (ou preopencard& )
  insert the script of image "XPlatform" into back
  LookPlatform -- à placer pour initialiser les globales d'environnement !
  [...]
end preopenstack
on closestack
  remove the script of image "XPlatform" from back
end closestack

L'appel initial renseigne les globales suivantes :

Commandes et fonctions disponibles

Limiter les lignes saisies dans un champs

Outil générant un script permettant de limiter le nombre de lignes saisissables dans un champs.
Choisissez le nombre de lignes maxi désiré, la longueur souhaitée pour le champs et un style d'arrondi.
L'outil génère un groupe « légende » comportant une icone d'effacement du contenu.
Cliquez le bouton « Installer… » pour copier le groupe généré ou le script approprié seulement.

Lineoffset en série

Utilise LineOffset() de manière itérative pour retrouver toutes les occurrences d'une même chaîne.
Peut être transposé à itemOffset(), WordOffset(), etc.

Function SearchLines stringToSearch,Content
  -- utilise LineOffset de manière itérative
  -- rend le numéro des lignes où le motif recherché est trouvé
  put "" into myResult
  put 0 into line2skip -- nombre de lignes à ignorer
  repeat
    get lineOffset(stringToSearch,Content,line2skip) -- par rapport au point de départ, numéro de la prochaine ligne où se trouve la chaîne recherchée.
    if it = 0 then exit repeat
    add it to line2skip -- ajouter it, car c'est un nombre relatif !
    put line2skip &comma after myResult
  end repeat
  delete char -1 of myResult
  return myResult
end SearchLines

Lire plist Macintosh

Un script pour lire le contenu d'une plist Macintosh; exemple avec un simulateur de votre Bureau.
Ne fonctionne actuellement que pour Capitan.

Mail Apple export en HTML

Enregistrer le message au format « Source du message brut ».
Glisser le fichier obtenu sur la dragzone pour le convertir en page html.

makeExcel

Cette fonction appartient à XPlatform.

makeExcel(theText,header,exportmode)

theText: texte à convertir (format Iso ou Mac); chaque cellule est séparée des autres par une tabulation
header : descripteurs du type de chaque colonne du tableau, séparés par une virgule;
valeurs supportées :

exportmode : mode d'export des données.

• csv : fichier CSV lisible dans Excel et OpenOffice,
• txt : texte tabulé,
• slk : fichier SYLK lisible dans Excel et OpenOffice. Format des cellules précis et totalisation automatique des montants.

Le fichier généré est de l'UTF-8.

Outil de paramétrage du header pour makeExcel

Destiné à affecter visuellement les descripteurs du header, il permet de générer le script d'export correspondant. Mais rien n'empêche de donner les valeurs directement, par exemple :
put "T,M,M,%,M,M,MF" into myheader

Cliquez d'abord le bouton importer pour ouvrir un fichier tabulé :

L'exemple affiché est une facture de garagiste. La ligne verte en haut est destinée à accueillir les formats de chaque colonne de la feuille qui sera exportée par makeExcelfile ; par défaut, le format est texte.

Choisissez ensuite pour chaque colonne le format qui vous convient le mieux en cliquant l'en-tête de la colonne. Un menu local permet de choisir le format approprié.

Une fois les formats précisés, exportez le fichier au format désiré et voyez si le résultat vous convient.

Générez ensuite un script correspondant aux réglages choisis avec le bouton qui le place dans le Presse-Papier.

on makeExcelfile filecontent
   -- alimenter <filecontent> avant !
   ask file "Enregistrer la feuille de calcul :" with "extrait.slk"
   if it = "" then exit to top
   put it into fnom
   put makeExcel(filecontent,"T,M,M,%,M,M,MF","slk") into myOut
   XPfile2Url myOut,it
end makeExcelfile

N'oubliez pas de copier la library XPlatform dans votre pile…

Utilisation de l'outil pour makeExcel comme convertisseur

Une fois le fichier tabulé importé, vous pouvez vous servir de makeExcel comme convertisseur : le bouton permet d'éliminer les lignes superflues.

Mise à jour Libimages

Affiche la version des Libimages installées dans vos piles et de les mettre à jour (version plus récente présente dans LiveCodeClips).
Le bouton «Export» enregistre le tableau au format CSV.

Pile ChooseList

Modèle de pile affichant une liste ou tableau et retournant la valeur ou le n° des lignes sélectionnées.

Exemple de sélection disjointe sur un tableau :

Alimenter la variable the dialogdata avec la liste à présenter en séparant chaque ligne par un "CR". Si la liste est tabulée, elle est présentée comme une tableau (colonnes).
Alimenter la variable global gChooselist, qui gère la présentation, comme suit :
Ligne 1 : [prompt] message affiché au dessus de la liste.
Ligne 2 : (5 items facultatifs) [selection_mode],[modeResultat],[listeWidth],[colSeparator],[cadrage] :

1. selection_mode : 1 = une seule ligne à la fois (valeur par défaut), 2 = multi-lignes, 3 = sélection disjointe.
2. modeResultat : true pour obtenir la liste des numéros de lignes choisies séparée par des virgules, false (valeur par défaut) pour obtenir le texte sélectionné.
3. listeWidth : largeur en pixels d'affichage de la liste ou auto (valeur par défaut) : affichage sur toute sa largeur dans la limite de la taille de l'écran.
4. colSeparator : tab par défaut, chaîne de caractères séparant les items dans la liste; les constantes : backslash, colon, comma, empty, null, quote, slash et space sont acceptées.Les constantes : cr, crlf, lf, linefeed et return sont interdites.
5. cadrage : la valeur target place la fenêtre au plus près du point cliqué pour appeler la liste.

Ligne 3 : valeur ou rang de la ligne présélectionnée (facultatif).
Ligne 4 : labels à imposer aux boutons « Choisir » et « Annuler », séparés par une virgule (facultatif). Les boutons ne sont pas redimensionnés.
Résultat : Texte sélectionné ou numéros d'ordre des lignes choisies dans la liste, "Cancel" sinon.
En mettant « ? » dans gChooselist, la présente aide est affichée.

L'outil placé sur la carte permet de paramétrer les éléments de présentation de la liste et de les copier au moyen de l'icone .

Pile pour importer une image

Pile permettant de sélectionner une portion d'une image pour l'importer dans une carte. La pile utilise la Libimage ImagesTools. Elle permet de faire des rotations de l'image, de zoomer sur l'original en le déplaçant à l'intérieur du rectangle de sélection.

Cliquez le bouton « Installer… » pour installer la pile dans une autre pile.

Appeler la pile en mode "modal" après avoir alimenté the dialogdata de la façon suivante :
Ligne 1 : path d'une image ;
Ligne 2 : longueur et largeur en pixels (ex : "250,200") de la portion à extraire.

En retour, the dialogdata vaut "cancel" si l'utilisateur à annulé le traitement, sinon il contient le "text" de la portion d'image sélectionnée ; ce text peut être placé dans une image pré-existante.
Exemple de script :

on placerExtrait imagepath
  set the dialogdata to imagepath & cr & "250,200"
  modal stack "template_captureimage"
  put the dialogdata into theimgDatas
  if theimgDatas = "cancel" then exit to top
  -- retourne un "text" d'image importable directement dans une autre image
  set the text of image "thumb" to theimgDatas
end placerExtrait

Pile pour transferts

Cette pile comporte 3 onglets :

• Un onglet Transfert permettant de choisir d'exporter les données de tout ou partie des cartes vers une url locale (Disque) ou réseau (FTP).
• Les onglets Disque et FTP permettent de paramétrer les destinations respectives : url locale (Disque) ou adresse FTP avec logon et mot de passe.
• Une option permet de choisir l'onglet préaffiché et de verrouiller l'accès aux autres.

Le script d'installation permet de choisir le nom de la substack installée dans la pile principale.

Paramètres

Un outil permet de préparer les paramètres à passer en dialogdata à la pile transferts.

Copiez les paramètres au moyen de l'icone .

Préférences d'une pile XPStackPrefs()

La fonction XPStackPrefs() appartient à la Libimage XPlatForm et restitue le path d'un fichier dans lequel vous pourrez enregistrer des options.

Paramètre

Un nom quelconque. Par défaut, XPStackPrefs() prend le "short name" de la pile courante.

Résultat

[chemin d'accès aux préférences]/[nom donné en paramètre]/[nom de la plateforme].data", par exemple :

sous MacOSX :   /Users/NomUser/Library/Preferences/MaPileMacOSX prefs.data
sous Windows :   C:/Documents and Settings/NomUser/Application Data/MaPileWindows prefs.data

Astuce : le fichier de préférences peut être un script initialisant les variables nécessaires. A l'ouverture de la pile, on le lit et on l'exécute :

on exportprefsglobales
      -- Exemple d'export de globales et de propriétés
         -- chargement des globales…
      put the rect of this stack into gprevStakRect
      put 9 into gAppCellDelimiter
      put "anything" into gAppcreator

      -- nom des globales à exporter…
      put "gprevStakRect,gAppCellDelimiter,gAppcreator" into myList
      -- déclaration des globales en première ligne du script généré…
      put "Global " &myList & cr into valeurs
      repeat for each item aGlobal in myList
            do "get " & aGlobal
            -- si la globale contient plusieurs lignes : remplacement des retours ligne
            replace cr with "^r" in it
            put "get " & quote & it & quote & cr after valeurs
            put "replace " & quote & "^r" & quote & "with cr in it" & cr after valeurs
            put "put it into " & aGlobal & cr after valeurs
      end repeat
      put "set the mark of this card to " & the mark of this card &cr after valeurs
      -- écriture dans le fichier mesOptionsxxxxx prefs.data
      XPExportPrefs valeurs,"mesOptions"
end exportprefsglobales

on readprefs
      -- lecture des valeurs stockées
      XPreadprefs "mesOptions"
      -- (suite d'instructions après lecture)
end readprefs

Rawkeyup

Affiche le keycode de la clé pressée.
Contient le modèle d'un script "on rawkeyUp" avec un trigger sur les valeurs courantes.
transposable à RawKeyDown.

Recherche Spotlight

Ce groupe comporte un champs de recherche permettant de filtrer un index au moyen du message "placeindex".
Un bouton permet d'effacer la recherche entrée.

L'outil présent sur la carte permet de paramétrer la largeur du champs.
Copiez votre groupe avec le bouton « Installer… ».
Collez-le à l'endroit désiré et mettez en place votre script de filtrage des données.

Exemple de filtrage d'une globale "myIndex" :
on placeindex
  put line 1 of fld "filter" into mySelector
  if mySelector <> "" then filter myIndex with "*" &mySelector &"*"
  put myIndex into fld "index"
end placeindex

Redimensionner les colonnes d'un champs

Un script pour redimensionner la largeur des colonnes d'un champs tableau selon la largeur effective du contenu.
Faire un send "resetchamps" au champs concerné.

SendAppleMail

Exemple de mail HTML avec AppleScript (Mac OSX seulement).

Le script génère un message stylé ou pas avec AppleMail.
Utilise le handler "SendAppleMail" de la Libimage AScriptlib.
Un jeu de paramètres permet de tester différents scénarios.

StackRipper

Revolution Stack Ripper est une transposition à LiveCode de mcRipper, un ripper MetaCard, et a surtout été un exercice destiné à étudier comment recréer des objets par script.
Que fait-il ?

• Il exporte (Rip) tous les objets d'une pile et leurs propriétés dans un fichier XML. Ce fichier permet d'analyser la manière dont LiveCode alimente les propriétés d'un objet selon son style et il est possible de le modifier manuellement.
• Il permet d'importer ce fichier XML et de re-créer une nouvelle pile (Burn).

Avertissement
Sauvegardez soigneusement l'original de votre pile avant de procéder : la pile a été soigneusement testée et elle n'affecte normalement pas une pile rippée ; mais on ne peut garantir un tel fonctionnement dans tous les cas de figure.
Lors d'un Burn, la pile est recréée avec le même nom que la pile originale : pour éviter les conflits, l'original doit être fermé.
Utilisation
Ouvrez «Revolution Stack Ripper».
Cliquer le bouton «Rip».
Cliquer le bouton «Save» pour enregistrer le texte produit au format xml.
Cliquer le bouton «load» pour charger un rippage xml.
Cliquer le bouton «Burn» pour générer une pile.
Limitations

• la colorisation des scripts n'est pas reprise et la taille de la pile générée est inférieure à celle de l'original (en octets).
• lors d'un «Burn», les id de tous les objets sont regénérés : les id des icones de boutons sont transposées, mais les scripts faisant référence à l'ID d'un objet ne sont pas toujours transposés : vous serez probablement amené à corriger manuellement les scripts concernés.
• les players ne sont pas exportés.

Séparateur de champs

Exemple de poignées permettant de déplacer la limite de 2 champs juxtaposés.

Choisissez le modèle (horizontal ou vertical) au moyen des boutons radios.
Cliquez le bouton « Installer… » pour copier le bouton poignée.
Groupez ensembles vos deux champs juxtaposés (auxquels vous attribuez le short name que vous voulez) et éditez le groupe.
Collez-le bouton poignée entre les deux champs à séparer, puis éditez le script pour modifier les 3 constantes :

constant CfldGauche="A",CfldDroit="B",Cscrlimite=80

• CfldGauche, CfldDroit (ou « Cfldhaut » et « Cfldbas ») : short name des champs à séparer ;
• Cscrlimite : largeur (ou hauteur) minimale préservée pour chacun des champs lors du déplacement.

Redimensionnez le bouton poignée à la largeur et longueur désirée : les champs s'ajusteront.
Le script fait apparaître automatiquement les scrollbars des champs lorsque le nombre de lignes qu'ils contiennent excède leur hauteur.

Tableau trié

Groupe formant un tableau dont on peut trier les lignes.
Les colonnes peuvent être re-dimensionnées au moyen de la souris et les lignes peuvent être triées en cliquant le titre des colonnes.
Les boutons permettent de copier, coller et effacer le contenu du tableau.

Cliquez sur le bouton « Installer… » pour copier le groupe dans une autre pile.

TitleWidth d'un bouton

Cette propriété n'est pas accessible dans l'inspecteur standard : un inspecteur pour le faire.
titleWidth et labelWidth sont synonymes;
positionner la propriété ne sert à mon avis que dans le cas des "option menu" : pour les autres styles de bouton, je ne vois pas l'intérêt.

Tri des boutons d'un groupe

Réarrange un groupe de boutons en fonction de la largeur et de la hauteur du groupe.
Cliquer le bouton « Installer… » pour copier le script ; Il peut être adapté à d'autres objets.
Envoyer un send send "Placebuttons" au groupe après avoir installé le script au niveau du groupe.

Les boutons « avant » :

Les boutons « après » :

Visual Effect

Composez l'effet visuel désiré au moyen des menus ;
copiez les instructions générées au moyen du bouton « Installer… » ;

N'oubliez pas qu'un effet visuel ne marche qu'après un « go cd… ».

Vérifier connection à Internet

Appelle la fonction XPCheckConnection() de XPlatForm pour faire un test de connection à internet.

Rend les valeurs suivantes :

1. = Connecté
2. = Non connecté à Internet
3. = Connexion Internet défectueuse
4. = Non connecté au réseau

Whatclicked

Un script permettant de visualiser les différentes variables LiveCode utilisables dans le clic et la sélection d'un champ de texte.

Xpask/ Xpanswerfile (with type)

Un générateur de script pour ouvrir ou créer un fichier d'une façon portable dans tous les environnements avec la libimage XPlatForm.

Les scripts peuvent être générés selon trois modes :

• Script XPlatform pur ;
• folder libellé au moyen d'un sélecteur XPFolder() ;
• valeurs « en clair » interprétées selon le contexte de la machine (non portables).

Copiez le script généré au moyen de l'icone .

XPdefaultbrowser

Rend le navigateur, le mail et le client FTP par défaut au moyen de la fonction XPDefaultBrowser([protocol] de la libimage XPlatForm.
Protocole spécifié : http (valeur par défaut), ftp, mailto.

Le bouton "Mime Type" donne le type Mime d'un fichier.

Le bouton "Encoder image..." donne une data url de l'image en base 64.

Correction accents fichiers Ubuntu

Réencode correctement les noms de fichiers importés depuis un Mac vers Ubuntu.

Les fichiers de MacOs dont le nom contient des accents peuvent poser des problèmes quand on les importe dans Ubuntu. Si l'on liste le contenu d'une directory, que l'on cherche à utiliser les éléments, certains sont vus comme inexistants même si la machine fonctionne en UTF-8. Pourquoi ? (Voir cette page Wikipedia sur l’équivalence Unicode.)
En effet, UTF-8 permet d’encoder les caractères accentués de deux façons différentes :

• soit un caractère accentué « direct » dit composé (format NFC = Fully Composed) — U+00E9 pour le « é » — ;
• soit un caractère dit décomposé (format NFD = Fully Decomposed), c’est à dire la lettre de base U+0065 pour la lettre e, accompagnée d’un caractère dit combinant, l’accent aigu (U+0301).

MacOS encode les caractères de manière décomposée, notamment les caractères accentués. Sous Linux, on peut corriger cela avec l’utilitaire convmv :

convmv -f utf8 -t utf8 --nfc -r --notest <dossier>

Au cas où le Terminal retourne La commande « convmv » n'a pas été trouvée, mais peut être installée… tapez :
sudo apt install convmv
Utilisez cette carte pour faire vos conversions, une fois convmv installé.

XPFileList parambuilder

Outil de création des paramètres nécessaires à la fonction XPFileList()

XPFileList() appartient à la Libimage XPlatForm et donne une liste des fichiers (ou des dossiers) avec une ligne pour chaque élément. Les items sont séparées par des tabulations, le premier item étant le nom (ou le fullpath) du fichier, suivi des attributs demandés :
XPFileList(theFolder,extensionsList,attributs)

Saisissez les extensions de fichiers souhaitées et les attributs de filtrage (visibilité, sous dossiers, fullpath) puis cliquez dans l'ordre souhaité les attributs désirés. Le script est généré automatiquement et peut être testé.
Copiez le script généré au moyen de l'icone .

Xpfolderpath()

XPfolderpath() appartient à la Libimage XPlatForm et remplace la fonction specialFolderPath() qui rend le chemin d'un dossier du Bureau Utilisateur en fonction d'un sélecteur.
Dans LiveCode, les sélecteurs de dossier utilisables par specialFolderPath dépendent de la plateforme.
XPfolderpath permet d'utiliser les valeurs de sélecteur propres à chaque plateforme système, mais aussi un jeu de « valeurs communes » d'une plateforme à une autre :

Le nom restitué tient compte de la langue du compte utilisateur.
La variable globale gXPFolderpathResult rend "Folder not found" lorsqu'il n'existe pas de dossier correspondant au sélecteur fourni, elle est vide sinon.

Un outil permet de tester Xpfolderpath() :

• le menu local du haut correspond aux jeu de sélecteurs de dossiers disponibles sur votre plateforme;
• le menu local « Communs » correspond aux jeu de sélecteurs multi-plateforme;

En déroulant chacun des menus, vous pouvez voir le path du dossier correspondant sur votre plateforme, s'il existe.
Ouvrez l'emplacement correspondant au moyen du bouton .

XPGetMetas lecture metas d'une page

Fonction de lecture des metas d'une page HTML appartenant à la libimage XPlatForm : alimente un array dans la global gExtMetas avec les clés suivantes si elles sont trouvées dans le contenu d'une page HTML.

^(*) meta dépendant du doctype de la page : html4 ou html5.

Zipper sans Resource Fork

Routine pour Mac OS X compressant un répertoire et les fichiers qu'il contient au format ZIP compatible Windows et Linux (la partie resource-fork des fichiers Mac est ignorée).
Syntaxe :
CompressFormatPC theSource,theDestination
  theSource : path du répertoire /Users/UserName/Documents)
  theDestination : path de l'archive (/Users/UserName/Desktop/archive.zip

Histoire d'un passage de Revolution Studio 2.7.4 à LiveCodeCommunity 9.6.3

Le 3/10/2022, arrivée de mon nouvel iMac sous Monterey qui remplace un autre iMac sous El Capitan que j'avais depuis 13 ans ; en migrant les données, je constate qu'un certain nombre d'applications n'est plus compatible avec le nouveau système, Revolution notamment. Heureusement, je trouve encore un LiveCodeCommunity 9.6.3, gratuit, pour me permettre de transposer mes piles au nouvel environnement système.

Format des piles et environnement

J'envisage d'abord une stratégie de portage des piles au nouvel environnement, puis d'enregistrer les piles au format Revolution 2.7 pour continuer de m'en servir sur mes vieux ordinateurs. Mais l'ajout de nouvelles propriétés et fonctions fait que, souvent, une pile « rétro-enregistrée» ne fonctionne pas et quelquefois ne s'ouvre même pas. Et comme LiveCodeCommunity 9.6.3 fonctionne sous Capitan, on peut passer à cette version sur toutes les machines.

Problèmes de compatibilité

Impressions sur la nouvelle version du produit

Il faut un peu de temps pour s'habituer au nouveau style des outils :

• Éditeur de scripts : les onglets du bas ne sont pas ergonomiques : pas assez de place pour voir source et variables dans une même fenêtre !
• Project browser : la vue hiérarchique est illogique car il faut déployer la vue par carte pour voir ensuite les substacks…
• Object inspector : l'éditeur de customs est inadapté, le champ de saisie est trop petit et instable, on voit très peu ce que l'on fait et on a très vite fait d'écraser la propriété voisine par mauvaise manipulation.

Le style de l'interface est plus moderne mais il est globalement moins ergonomique.

Cette interface est modernisée grâce au « Datagrid » si j'ai bien compris, mais comme ce n'est pas documenté, je n'ai pas envie de chercher des heures comment peaufiner l'aspect des champs et boutons : Datagrid me sert à rien.

Une approche logique aurait été de rendre LiveCode « CSS compatible » : en soi, LiveCode est un browser HTML, un certain nombre de propriétés css sont gérées et il y a une stratégie tournée vers le web ; alors pourquoi réinventer l'eau chaude ?

Problèmes de migration

La migration des piles à la nouvelle version m'a réservé quelques surprises :

• certaines customs maison sont devenues des propriétés standard (avec un usage différent bien sûr) par exemple : get the theme of this card…
• le nom et le style des "inks" ont totalement changés et n'étaient pas convertis ;
• le script au format html des objets était enregistré dans cREVGeneral[script] en version 2.74; le transfert en 9.6.3 ne retire pas ces données puisque l'éditeur ne s'en sert plus : résultat, on a le vrai script et une copie périmée en custom property ! J'ai dû écrire un script traitant tous les objets pour retirer les propriétés obsolètes de cRevGeneral. Gain de taille global des piles : 33% en moyenne…

Bilan avril 2023

La migration a été bien laborieuse : presque un mois de tâtonnements pour rétablir le fonctionnement de mes principales piles. 4 mois encore, pour fignoler et avec un gain d'ergonomie minime : au fond, une version 2.7.4 compatible 64 bits aurait suffi. Je pensais trouver beaucoup de nouvelles possibilités, ce n'est à mon avis pas le cas.

Problèmes rencontrés avec Ubuntu

• les players ne marchent pas. Essayé sans succès de mettre : set the videoClipPlayer to "/usr/bin/totem" (vidéo standard de gnome). Le Player reste invisible et non jouable. Apparemment pas de solution sous Linux.
• problème avec les fichiers importés depuis macOS vers Ubuntu dont le nom contient des accents : la commande get files(thefolder, "detailed-utf8") restitue des fichiers qui n’existent pas. En revanche cela marche si l’on crée ou renomme un fichier dans Ubuntu. L’anomalie provient du fait que macOS et Linux n'utilisent pas unicode de la même manière, le même caractère est codé différemment. Les fichiers macOS sont codés en unicode décomposé ce qui n'est pas le cas sous Ubuntu. La solution est de passer l'utilitaire convmv -f utf8 -t utf8 --nfc -r --notest <dossier> pour corriger les accents d’un dossier importé.
• le Presse-Papier ne marche pas entre Clipboard LiveCode et Linux : résolu en installant gnome-shell-extensions-gpaste. Pourquoi le Presse-Papier Ubuntu n’est il pas standard ? Mystère !

En conclusion : LiveCode peut fonctionner sous Linux si l’installateur fonctionne lui-même (L'installation sur Fedora38 échoue "Failed to load library 'gdk' (tried libgdk-x11-2.0.so.0) "), mais il faudra résoudre certains problèmes propres à la distribution.