Citation :
Référenciel de la syntaxe:
* Champs:
- %fieldname% - insert le champ de donnée appelé <fieldname>, ex. "%artist%"
- %__fieldname% - insert le champ de donnée technique appelé <fieldname>, ex. "%__bitrate%"
- champs spéciaux: %_path%, %_path_raw%, %_filename%, %_filename_ext%, %_directoryname%, %_subsong%, %_foobar2000_version%, %_length%, %_length_seconds%
- champs spéciaux (commandes de la playlist et de la copie): %_isplaying%, %_ispaused%, %_playlist_number%
- champs spéciaux (barre de statut, titre de la fenêtre and commande de copie): %_time_elapsed%, %_time_remaining%, %_time_total%, %_time_elapsed_seconds%, %_time_remaining_seconds%, %_time_total_seconds%, %_ispaused%
- note: %_time_total% / %_time_total_seconds% tient ses donnée du coeur de lecture tandis que %_length% / %_length_seconds% tient ses données de la base de donnée, dans certains cas l'un des deux peut être plus fiable
- note: tous les champs %...% coupent automatiquement les chaines multi-lignes, si vous ne voulez pas cela, regardez la fonction $meta() - astuce: vous pouvez voir toutes les données (%blah%) et les données techniques (%__blah%) dans la boite info du fichier
* Couleurs (playlist et barre de statut seulement):
- XXXXXX - met la couleurs du texte à XXXXXX, où XXXXXX est la nouvelle couleur du texte en headécimal; les champs sélectionnés inversent la couleur
- XXXXXX|YYYYYY - met la couleur du texte à XXXXXX sur les chmaps non sélectionnés et à YYYYYY sur les champs sélectionnés
- - remet la couleur par défaut
* Texte aligné à droite (playlist et barre de statut seulement):
- utiliser le caractère tabulation (ou "$char(9)" ) pour indiquer l'alignement à droite du texte (ex. durée d'une piste)
* Fonctions:
- $abbr(x) - insert l'abbréviations de x, ex. "$abbr(%album%)" - convertira le nom de l'album "Final Fantasy VI" en "FFVI"
- $abbr(x,y) - insert l'abbréviations de x si x est plus long que y caractères; autrement insert la valeur complète de x, ex. "$abbr(%album%,10)"
- $lower(x), $upper(x) - converti x en minuscule/majuscule, ex. "$upper(%title%)"
- $num(x,y) - affiche le nombre x et comble avec des 0 jusqu'à y caractères (très pratique pour la numérotation des pistes), ex. $num(%tracknumber%,2)
- $caps(x) - converti la première lettre de chaque mot de x en majuscule, et toutes les autres lettres en minuscule, ex. "blah BLAH" -> "Blah Blah"
- $caps2(x) - similaire à $caps, mais laisse les lettres majuscules comme elles sont, ex. "blah BLAH" -> "Blah BLAH"
- $if(A,B,C) - si A contient au moins un tag valide, exécute/affiche B, autrement exécute/affiche C; ex. "$if(%artist%,%artist%,artist inconnu)" affichera le nom de l'artiste s'il existe; autrement il affichera "artiste inconnu"; notez que "$if(A,A,)" est est équivalent à "[A]" (voir plus bas)
- $if2(a,b) - identique à $if(a,a,b)
- $ifgreater(a,b,c,d) - si le nombre a est plus grand que le nombre b, affiche/exécute c, autrement affiche/exécute d
- $iflonger(a,b,c,d) - si la chaine a est plus longue que b caractères, affiche/exécute c, autrement affiche/exécute d
- $longest(A,B,C,....) - compare les longueurs des chaines produites par A,B,C... et affiche la plus longue, ex. "$longest(%title%,%comment%)" affichera soit le titre s'il est plus long que le commentaire; autrement il affichera le commentaire
- $len(x) - retourne la longueur de la chaine X en terme de caractères
- $pad(x,y), $pad_right(x,y) - complète x avec des espaces jusqu'à y caractères
- $cut(x,y) - tronque x à y caractères
- $padcut(x,y), $padcut_right(x,y) - complète x à y caractères et tronque à y si plus long
- $insert(a,b,n) - insert la chaine b dans la chaine a après n caractères
- $add(x,y), $sub(x,y), $mul(x,y), $div(x,y), $mod(x,y), $min(x,y), $max(x,y) - différentes opération mathématiques
- $left(x,y) - retourne les y premiers caractères de la chaine x
- $right(x,y) - retourne les y derniers caractères de la chaine x
- $and(x,y), $or(x,y), $xor(x,y), $not(x) - opérations logiques, pour utiliser avec $if()
- $fix_eol(x), $fix_eol(x,y) - tronque les chaines multi-lignes, ajoute " (...)" (version 1) ou y (version 2) à la fin
- $meta(x) - insert la valeurs du champ x, ex. "$meta(artist)"; similaire à %artist% mis à part qu'il ne tronque pas les chaines multi-lignes
- $meta(x,y) - insert la y-ème donnée du champ x, utile pour les champs à multiples valeurs (ex. multiple artists - $meta(artist,1), $meta(artist,2))
- $meta_sep(x,y), $meta_sep(x,y,z) - insert les données du champs x, avec un séparateur personnalisé pour les champs multiples, ex. "$meta(artist,', ',' and ')" pour trois artistes nommés A, B, C produira ceci - "A, B and C"
- $meta_num(x) - insert le nombre de données présentes dans le champ x
- $info(x) - insert le champs d'info technique x, ex. "$info(bitrate)" est équivalent à %__bitrate%, sauf qu'il ne tonque pas les valeurs multi-lignes
- $char(x) - insert le caractère unicode no. x, ex. "$char(3)" produit le charactère controllant la couleur dans la playlist
- $strcmp(x,y) - retourne "1" quand les chaines x et y sont identiques, un string vide dans le cas contraire; destiné à être utilisé avec $if()
- $stricmp(x,y) - version insensible à la casse de $strcmp(x,y)
- $directory(x), $directory(x,n) - extrait le nom du répertoire du fichier, optionellement remonte jusqu'à n niveaux dans l'arborescence, ex. $directory(%_path%,2)
- $greater(x,y) - compare deux entiers, teste si x>y, destiné à être utilisé avec $if() et les opérateurs logiques.
- $longer(x,y) - compare deux strings, teste si x est plus long que y, destiné à être utilisé avec $if() et les opérateurs logiques.
- $strchr(x,y) - trouve la première occurence du caractère y dans la chaine x
- $strrchr(x,y) - trouve la dernière occurence du caractère y dans la chaine x
- $strstr(x,y) - trouve la première occurence de la chaine y dans la chaine x
- $progress(a,b,c,d,e) - affiche la barre de progression, ex. $progress(%_time_elapsed_seconds%,%_time_total_seconds%,20,'#','=') affichera quelque chose comme "====#===============", avec le caractère # bougeant avec la position de la lecture
- $progress2(a,b,c,d,e) - affiche la barre de progression, ex. $progress(%_time_elapsed_seconds%,%_time_total_seconds%,20,'#','=') will display something like "#####==============="
- $select(n,a,b,c,....) - retourne le n-ième des paramètres a,b,c...
- $repeat(x,y) - répète x y fois
- $replace(a,b,c) - remplace toutes les occurences de la chaine b dans la chaine a avec la chaine c
- $ext(x) - extrait l'extension du fichier, ex. $ext(%_path%)
- $substr(a,b,c) - retourne une sous-chaine de a, démarrant du b-ième caractère et finissant au c-ième caractère, ex. $substr('blah',1,2) retourne 'bl'
- $rgb(a,b,c), $rgb(a,b,c,d,e,f) - converti une couleur "décimal" en code couleur (voir les couleur plus haut)
- $transition(a,b,c) - génère des codes couleurs entre les caractères de la chaine a, dégradé de la couleur b à c
- $blend(a,b,c,d) - génère une couleur dans c/d entre la couleur a et b
- $rand() - génère une nombre au hasard compris entre 0 et 2^32-1
* Opération variables.
Les variables vous permettent de stocker des résultats intermédiaires de génération de texte, en vue de réduite la taille de votre texte formatté.
Les variables ne sont pas gardées entre les instances de génération du titre, et ne vous permettent pas de modifier les infos actuelles du fichier.
Usage:
- $put(name,text) - met la variable appelée <name> à <text> et retourne <text>, ex. "$put(x,blah)" met la variable x à 'blah' et retourne 'blah'. - $puts(name,text) - identique à $put(name,text), mais retourne une chaine vide.
- $get(name) - retourne la valeur de la variable <name>, ex. "$puts(x,blah)$get(x)$get(x)" retournera 'blahblah'.
* Autre:
- [ .... ] - afficher le contenu entre crocher si au moins un des champs contenu a été trouvé, ex. "%artist% - [%album% / ]%title%" cachera le bloc [] si le champ album n'est pas présent; notez que mélanger les crochets avec les fonctions peut donner des résultats imprévisibleset devrait être évité (utilisez $if() à la place)
- ' (appostrophe) - retourne le texte brut sans interprétation ex. 'blah$blah%blah[][]' sortira la chaine contenue et ignorera tous les caractères réservés (%,$,[,]) présents; vous pouvez utiliser cette options pour insérer des crochets par exemple.
- les caractère de fin de lingne sont ignorés; utilisez $char() pour forcer des séquences de characètres spéciaux si vous en avez besoin; vous pouvez ainsi couper votre chaine en de multiples lignes sans affecter la sortie
- "//" - commentaires, peuvent être placés seulement au début d'une nouvelle ligne, ils évitent à tout caractères les suivant jusqu'à la fin de ligne d'être interprété
ex. "[%artist% - ][$abbr(%album%,10)[ %tracknumber%] / ]%title%"
|