## Variables

Beaucoup d'informations sont extraites des fichiers ou peuvent être calculées à partir de différents éléments.
Chacune de ces informations peut être utilisée dans une expression de renommage par l'intermédiaire d'une "variable".

En se basant sur leurs origines, elle ont été assemblées en différents groupes :

- Base
- Audio
- Tag id3v1
- Tag audio
- Vidéo
- Tag vidéo
- Image
- Exif
- Iptc
- Document

Ne soyez pas effrayé par leur nombre. Des outils comme la fenêtre de complétion ou le clic droit sur une valeur vous permettront d'éviter d'avoir à les retenir.

Certaines variables sont des liens cliquables. Ils pointent vers le modificateur spécifique qui leur est associé.

#### Groupe d'informations "de base"

Disponible pour tous les fichiers quel que soit leur type.
Pour les systèmes autres que Windows, les variables "DOS" sont identiques à leur équivalent "non DOS".

`%f` | le nom sans le chemin
`%fa` | le nom avec le chemin absolu
`%fc` | le nom tel qu'affiché (ou calculé)
`%fd` | le nom DOS sans le chemin
`%b` | le nom de "base" (par ex, pour "autoexec.bat" c'est "autoexec")
`%bd` | le nom de base du nom DOS
`%e` | l'extension du nom (par ex, pour "autoexec.bat" c'est "bat")
`%ed` | l'extension du nom DOS
`%s` | la taille dans l'unité la mieux adaptée
`%sb` | la taille en octets
`%sk` | la taille en kibioctets
`%sm` | la taille en mébioctets
`%sg` | la taille en gibioctets
`%a` | quelques attributs
`%y` | le type
`%dm` | la date et l'heure de modification
`%dmd` | la date de modification
`%dmt` | l'heure de modification
`%dc` | la date et l'heure de création
`%dcd` | la date de création
`%dct` | l'heure de création
`%da` | la date et l'heure du dernier accès
`%dad` | la date du dernier accès
`%dat` | l'heure du dernier accès
`%cm` | checksum MD5
`%cs` | checksum SHA1
`%cc` | checksum CRC32
`%N` | un numéro contenu dans le nom de base du fichier. Un chiffre peut indiquer sa position (1 par défaut). Par exemple, pour `"Fic2_15zzz784.txt"` :
`%N` |  | vaut |  | `2`
`%N1` |  | vaut |  | `2`
`%N2` |  | vaut |  | `15`
`%N3` |  | vaut |  | `784`
`%N4` |  | vaut |  | "" (chaîne vide)
`%NN` | l'"inverse" de `%N` : une chaîne non numérique contenue dans le nom de base du fichier. Un chiffre peut indiquer sa position (1 par défaut). Par exemple, pour `"Fic2_15zzz784.txt"` :
`%NN` |  | vaut |  | `Fic`
`%NN1` |  | vaut |  | `Fic`
`%NN2` |  | vaut |  | `_`
`%NN3` |  | vaut |  | `zzz`
`%NN4` |  | vaut |  | `"" (chaîne vide)`
`%n` | le numéro de sélection
`%np` | le numéro de sélection relatif au chemin du fichier. Par exemple : `
Fichier |  | %n |  | %np
\Dir1\Img1.jpg |  | 001 |  | 001
\Dir1\Img2.jpg |  | 002 |  | 002
\Dir2\Img3.jpg |  | 003 |  | 001
\Dir2\Img4.jpg |  | 004 |  | 002
`
`%nc` | le numéro de sélection relatif à une "collision" de noms (débuts identiques), la partie de l'expression suivant `"%nc"` n'est pas prise en compte. Par exemple, avec l'expression : `%dmd_%nc.%e` `
Fichier |  | Date de modification |  | Résultat
Image1.jpg |  | 01/01/2004 |  | 20040101_001.jpg
Image2.jpg |  | 12/12/2004 |  | 20041212_001.jpg
Image3.jpg |  | 01/01/2004 |  | 20040101_002.jpg
Image4.jpg |  | 12/12/2004 |  | 20041212_002.jpg
Image5.jpg |  | 12/12/2004 |  | 20041212_003.jpg
Image6.gif |  | 12/12/2004 |  | 20041212_004.gif
`
`%ncs` | même principe que pour `"%nc"` excepté qu'il est vide pour le premier élément du "groupe de collision" et est préfixé par un `"_"` pour les autres. Par exemple, avec l'expression : `%dmd%ncs.%e` `
Fichier |  | Date de modification |  | Résultat
Image1.jpg |  | 01/01/2004 |  | 20040101.jpg
Image2.jpg |  | 12/12/2004 |  | 20041212.jpg
Image3.jpg |  | 01/01/2004 |  | 20040101_001.jpg
Image4.jpg |  | 12/12/2004 |  | 20041212_001.jpg
Image5.jpg |  | 12/12/2004 |  | 20041212_002.jpg
Image6.gif |  | 12/12/2004 |  | 20041212_003.gif
`
`%ncf` | identique à `"%nc"` sauf que le chemin n'est pas pris en compte. Seuls les noms de fichiers sont comparés
`%ncfs` | identique à `"%ncs"` mais sur les noms de fichiers
`%ns` | le nombre de fichiers sélectionnés
`%p` | un répertoire père (un chiffre peut indiquer le niveau). Par exemple, pour `"C:\IMAGE\SPORT\2006\IMG001.jpg"` : `
%p |  | vaut |  | 2006
%p2 |  | vaut |  | SPORT
%p3 |  | vaut |  | IMAGE
`
`%pa` | le chemin absolu menant au fichier (terminé par un caractère séparateur de chemin, `'\'` sous Windows)
`%pr` | le chemin relatif menant au fichier (terminé par un caractère séparateur de chemin, `'\'` sous Windows)
Les variables qui suivent sont indépendantes du fichier sur lequel elles sont calculées.
`%P` | le chemin courant de Siren. Par exemple, pour `"C:\IMAGE\SPORT\2006\IMG001.jpg"` : En mode de chargement standard : `
%pa |  | vaut |  | C:\IMAGE\SPORT\2006\
%pr |  | vaut |  | "" (chaîne vide)
%P |  | vaut |  | C:\IMAGE\SPORT\2006\
` En mode de chargement avec les sous-répertoires, si le répertoire courant de Siren est `"C:\IMAGE"` : `
%pa |  | vaut |  | C:\IMAGE\SPORT\2006\
%pr |  | vaut |  | SPORT\2006\
%P |  | vaut |  | C:\IMAGE\
`
`%Pe` | le chemin menant au fichier exécutable de Siren
`%D` | la date et l'heure courantes
`%Dd` | la date courante
`%Dt` | l'heure courante
`%Rn` | une chaîne numérique pseudo aléatoire. Elle peut être suivie par un modificateur `"{}"`. L'utilisation est la suivante : `{ l, i, a }` `l` : longueur `i` : valeur minimum, optionnelle `a` : valeur maximum, optionnelle
`%Ra` | une chaîne alphabétique pseudo aléatoire
`%Rs` | une chaîne alphanumérique pseudo aléatoire
`%C` | ligne extraite du presse-papiers suivant l'ordre de sélection des fichiers. Un chiffre peut indiquer un numéro de ligne absolu. Il peut aussi être spécifié entre `"{}"`. Exemples : `
The Group - %C.%e
%C1 - %C{2} - %f
`
`%T` | ligne extraite d'un fichier texte suivant l'ordre de sélection des fichiers. Un chiffre peut indiquer un numéro de ligne absolu. Elle peut être suivie par un modificateur `"{}"`. L'utilisation est la suivante : `{ "f", n }` `f` : le nom du fichier duquel la ligne doit être extraite, optionnel `n` : numéro de ligne, optionnel Le caractère `'\'` étant un caractère d'échappement, ceux présents dans les chemins doivent être doublés. Ne pas indiquer de nom de fichier revient à faire référence à celui précédemment cité. Il n'y a pas de limite au nombre de fichiers utilisables dans une expression. Exemples : `
%T{"C:\\fr.txt"}
%T{"C:\\fr.txt",2}
%T1{"C:\\fr.txt"}_%T2(10,2)
Fic_%T{"C:\\temp\\fa.txt"} - %T1 - %T{"D:\\fb.txt"}.txt
`

#### Groupe d'informations "audio"

`%Ab` | le bitrate
`%As` | la fréquence d'échantillonnage (sampling rate)
`%AM` | le mode (mono/stéréo/...)
`%Ad` | la durée
`%Ai` | de l'information

#### Groupe d'informations "tag id3v1"

`%mt` | le titre
`%ma` | l'artiste
`%mA` | l'album
`%my` | l'année
`%mc` | le commentaire
`%mT` | le numéro de piste
`%mg` | le genre

#### Groupe d'informations "tag audio"

`%At` | le titre
`%Aa` | l'artiste
`%AA` | l'album
`%Ay` | l'année
`%Ac` | le commentaire
`%AT` | le numéro de piste
`%An` | le nombre de pistes
`%Ak` | la piste (texte)
`%AD` | le disque
`%Ag` | le genre
`%Ap` | le compositeur
`%Ao` | l'artiste original
`%AC` | le copyright
`%Au` | l'URL
`%Ae` | encodé par
`%AIf` | le format d'une image attachée

#### Groupe d'informations "vidéo"

`%Vx` | la largeur
`%Vy` | la hauteur
`%Vs` | la fréquence d'échantillonnage (sampling rate)
`%VM` | le mode (mono/stéréo/...)
`%Vd` | la durée
`%Vf` | le nombre d'images par seconde
`%Vi` | de l'information

#### Groupe d'informations "tag vidéo"

`%Vt` | le titre
`%VU` | le sujet
`%Va` | l'artiste
`%Vc` | le commentaire
`%Vk` | les mots clés
`%VE` | l'ingénieur
`%VT` | le technicien
`%Vg` | le genre
`%Vn` | la date de création
`%VO` | la source
`%VC` | le copyright
`%VS` | le logiciel utilisé pour créer le fichier (software)
`%VIf` | le format d'une image attachée
`%VDd` | la date d'un DV avi
`%VDdd` | la date d'un DV avi "partie date"
`%VDdt` | la date d'un DV avi "partie temps"
`%VDt` | le time code d'un DV avi

#### Groupe d'informations "image"

`%Ix` | la largeur
`%Iy` | la hauteur
`%Ib` | le nombre de bits par pixel
`%Ii` | de l'information

#### Groupe d'informations "exif"

Le nom "officiel" du tag est utilisé comme description.

`%Xde` | ImageDescription
`%Xmk` | Make
`%Xmo` | Model
`%Xor` | Orientation
`%Xxr` | XResolution
`%Xyr` | YResolution
`%Xru` | ResolutionUnit
`%Xso` | Software
`%Xar` | Artist
`%Xdt` | DateTime
`%Xdtd` | DateTime "partie date"
`%Xdtt` | DateTime "partie temps"
`%XSt` | SubsecTime
`%Xwp` | WhitePoint
`%Xpc` | PrimaryChromaticities
`%Xyc` | YCbCrCoefficients
`%Xyp` | YCbCrPositioning
`%Xbw` | ReferenceBlackWhite
`%Xcy` | Copyright
`%Xeo` | ExifOffset
`%Xgo` | GPSOffset
`%Xto` | ThumbnailOffset
`%Xts` | ThumbnailSize
`%Xet` | ExposureTime
`%Xfn` | FNumber
`%Xep` | ExposureProgram
`%Xsy` | SpectralSensitivity
`%Xsr` | ISOSpeedRatings
`%Xve` | ExifVersion
`%Xdo` | DateTimeOriginal
`%Xdod` | DateTimeOriginal "partie date"
`%Xdot` | DateTimeOriginal "partie temps"
`%XSo` | SubsecTimeOriginal
`%Xdd` | DateTimeDigitized
`%Xddd` | DateTimeDigitized "partie date"
`%Xddt` | DateTimeDigitized "partie temps"
`%XSd` | SubsecTimeDigitized
`%Xcc` | ComponentConfiguration
`%Xbp` | CompressedBitsPerPixel
`%Xss` | ShutterSpeedValue
`%Xav` | ApertureValue
`%Xbv` | BrightnessValue
`%Xev` | ExposureBiasValue
`%Xma` | MaxApertureValue
`%Xsd` | SubjectDistance
`%Xmm` | MeteringMode
`%Xls` | LightSource
`%Xfa` | Flash
`%Xfl` | FocalLength
`%Xfe` | FlashEnergy
`%Xuc` | UserComment
`%Xfv` | FlashPixVersion
`%Xcs` | ColorSpace
`%Xiw` | ExifImageWidth
`%Xih` | ExifImageHeight
`%Xsf` | RelatedSoundFile
`%Xfx` | FocalPlaneXResolution
`%Xfy` | FocalPlaneYResolution
`%Xfu` | FocalPlaneResolutionUnit
`%Xei` | ExposureIndex
`%Xsm` | SensingMethod
`%Xfs` | FileSource
`%Xst` | SceneType
`%Xcr` | CustomRendered
`%Xem` | ExposureMode
`%Xwb` | WhiteBalance
`%Xdz` | DigitalZoomRatio
`%XfL` | FocalLengthIn35mmFilm
`%Xsc` | SceneCaptureType
`%Xgc` | GainControl
`%Xct` | Contrast
`%Xsu` | Saturation
`%Xsh` | Sharpness
`%XsD` | SubjectDistanceRange
`%Xui` | ImageUniqueID
`%Xgv` | GPSVersionID
`%XlA` | GPSLatitudeRef
`%Xla` | GPSLatitude
`%XlO` | GPSLongitudeRef
`%Xlo` | GPSLongitude
`%XaL` | GPSAltitudeRef
`%Xal` | GPSAltitude
`%XTS` | GPSTimeStamp
`%Xsa` | GPSSatellites
`%Xus` | GPSStatus
`%XmM` | GPSMeasureMode
`%Xdp` | GPSDOP
`%XsP` | GPSSpeedRef
`%Xsp` | GPSSpeed
`%XtR` | GPSTrackRef
`%Xtr` | GPSTrack
`%XiD` | GPSImgDirectionRef
`%Xid` | GPSImgDirection
`%Xmd` | GPSMapDatum
`%XLA` | GPSDestLatitudeRef
`%XLa` | GPSDestLatitude
`%XLO` | GPSDestLongitudeRef
`%XLo` | GPSDestLongitude
`%XbE` | GPSDestBearingRef
`%Xbe` | GPSDestBearing
`%XDR` | GPSDestDistanceRef
`%XDr` | GPSDestDistance

#### Groupe d'informations "iptc"

Le nom "officiel" du tag est utilisé comme description.

`%Ybl` | ByLine
`%Ybt` | BylineTitle
`%Ycy` | Copyright
`%Ycr` | Credit
`%Ysr` | Source
`%Ycw` | CaptionWriter
`%Ycp` | Caption
`%Yhl` | HeadLine
`%Ysi` | SpecialInstr
`%Yon` | ObjectName
`%Ydc` | DateTimeCreated
`%Ydcd` | DateTimeCreated "partie date"
`%Ydct` | DateTimeCreated "partie temps"
`%Ydr` | DateTimeReleased
`%Ydrd` | DateTimeCreated "partie date"
`%Ydrt` | DateTimeCreated "partie temps"
`%Yct` | City
`%Ysl` | SubLocation
`%Yst` | State
`%Ycc` | CountryCode
`%Yco` | Country
`%Yot` | OriginalTrsf
`%Yca` | Category
`%Ysc` | SupplCategories
`%Yes` | EditStatus
`%Yji` | JobId
`%Ypg` | Program
`%Ypv` | ProgramVersion
`%Ypr` | Priority
`%Yoc` | ObjectCycle
`%Ykw` | Keywords

#### Groupe d'informations "document"

`%Ot` | le titre
`%Os` | le sujet
`%Ov` | la version
`%Oa` | l'auteur
`%Od` | la destination
`%Oc` | le commentaire
`%Oi` | de l'information
`%OI` | l'ID
`%Ok` | les mots clés
`%On` | la date de création
`%Ond` | la date de création "partie date"
`%Ont` | la date de création "partie temps"
`%Om` | la date de modification
`%Omd` | la date de modification "partie date"
`%Omt` | la date de modification "partie temps"
`%OA` | l'application
`%ON` | l'entreprise
`%OC` | le copyright
`%OT` | le trademark
`%Ou` | l'URL
`%OF` | le nombre de fichiers
`%OP` | le nombre de pages
`%OL` | le nombre de lignes
`%OW` | le nombre de mots
`%OB` | le nombre de caractères