# Le manuel de &kdenlive;

## Introduction

&kapp; est une application de montage vidéo non linéaire pour KDE. Pour rapporter des bogues ou pour proposer de nouvelles fonctionnalités, Veulliez envoyer un courrier électronique à jasonwood@blueyonder.co.uk

### Qu'est ce qu'un logiciel de montage vidéo ?

Un logiciel de montage vidéo est une application qui permet de créer une séquence vidéo à partir de plusieurs plans vidéo indépendants ou à partir d'autres séquences vidéo.

### Différences entre le montage vidéo « linéaire » et « non linéaire »

Dans le passé, le montage vidéo sur l'ordinateur était possible à l'aide d'un éditeur vidéo dit « linéaire », en utilisant essentiellement deux magnétoscopes. Le premier contenait les séquences vidéo cibles, et le second était employé pour rechercher les plans vidéo à monter dans les séquences vidéo cibles. L'opération consistait à trouver un plan vidéo, à l'enregistrer dans la séquence vidéo cible, à trouver le plan vidéo suivant, à l'enregistrer dans une autre séquence vidéo cible, etc. Cette méthode s'appelle « l'édition vidéo linéaire » car l'utilisation de bande vidéo nécessitait une édition des séquences vidéo de manières séquentielles. Par exemple, il est très difficile de libérer de l'espace vide pour ajouter un nouveau plan vidéo à une séquence vidéo d'une durée globale de 10 minutes, après les cinq premières minutes de celle ci.

Le montage vidéo « non linéaire » est un procédé plus flexible. Vous pouvez placer des nouveaux plans vidéo n'importe où dans votre séquence vidéo cible (dans &kdenlive;, ceci est représenté par l'intermédiaire de la table de montage), et les déplacer n'importe où autant de fois que vous voulez. Vous pouvez aussi les réarranger dans un ordre complètement différent et avec un ordinateur suffisamment puissant, observer le résultat final.

## Présentation rapide

&kdenlive; est une application qui va vous faire plonger dans l'univers du montage vidéo numérique. Cette présentation rapide vous aidera à réaliser quelques opérations de base pour le montage de votre premier film.

### La fenêtre principale

Lorsque vous lancez &kdenlive; pour la première fois, vous devez obtenir une fenêtre similaire à celle ci :

La fenêtre principale

Dans l'interface graphique par défaut de &kdenlive;, il y a trois panneaux importants. Les positions de tous ces panneaux peuvent être configurés individuellement en fonction de vos besoins.

#### Le panneau du projet

Le panneau du projet

Ce panneau propose différents options nécessaires au montage vidéo du projet. L'onglet le plus important est la liste du projet. Il affiche l'ensemble des plans vidéo qui sont inclus dans le projet.

#### Le panneau de prévisualisation

Le panneau de prévisualisation

Ce panneau présente la liste des fenêtres de prévisualisation de &kdenlive;. L'onglet « Montage vidéo » affiche le montage vidéo final. L'onglet « Plan vidéo » affiche une prévisualisation du plan vidéo courant, et permet de sélectionner une section d'un plan vidéo à ajouter à la table de montage.

#### La table de montage vidéo

La table de montage vidéo

Le panneau située en bas de la fenêtre principale est appelée la table de montage vidéo. Elle offre une représentation visuelle de votre projet. Elle affiche l'état de lecture et de non lecture des plans vidéo, le chevauchement de plans vidéo, et le plan vidéo courant. Les versions actuelles de &kdenlive; / &piave; ne gère pas encore les effets spéciaux. Les futures versions implanteront cette fonctionnalité et elle sera visible dans la table de montage.

### Ajouter un plan vidéo à votre projet

Maintenant que vous avez une vue d'ensemble de &kdenlive;, il est temps d'ajouter quelques plans vidéo à votre projet. Vous devez disposer de quelques plans vidéo sur votre ordinateur pour réaliser cette opération. Actuellement, &kdenlive; ne dispose pas encore des fonctionnalités de capture vidéo, et vous devez utiliser une autre application pour réaliser cette opération. Nous recommandons le programme « kino » qui peut être téléchargé à l'adresse http://kino.schirmacher.de/.

Après avoir récupérer quelques plans vidéo sur votre ordinateur, vous pourrez les ajouter à votre projet. Sélectionnez l'onglet « Projet » dans le panneau relatif au projet, et activez le menu contextuel avec le bouton droit de la souris. Sélectionnez l'option Ajouter des plans vidéo qui ouvrira la boîte de dialogue de sélection de fichiers de &kde;. Rechercher vos plans vidéo, choisissez les, et validez votre sélection.

Si vous essayez d'ajouter des fichiers vidéo non valables dans la liste du projet, cela peut entraîner un arrêt anormal du programme de rendu vidéo (Piave). Ceci est un bogue connu. Lorsqu'il apparaît, enregistrer votre projet (si possible dans un nom diffèrent si c'est un projet déjà existant et en cours de modification), arrêter &kdenlive; et relancer le. Consulter la section Problèmes connus et solutions pour plus de détails.

Les plans vidéo que vous avez ajouter doivent apparaître dans la liste du projet, avec leurs durées ainsi que d'autres informations.

La table de montage vidéo

### Glisser / déposer des plans vidéo dans la table de montage

Maintenant que vous avez quelques plans vidéo dans votre projet, vous pouvez commencer les opérations correspondantes au montage vidéo. Il existe deux méthodes pour ajouter un plan vidéo à la table de montage.

Vous pouvez utiliser le « glisser / déposer » directement entre la liste du projet et la table de montage. Choisissez un plan vidéo dans la liste du projet et glisser le sur la table de montage à l'aide de la souris. La piste vidéo doit apparaître dans la table de montage et peut y être déplacer à volonté. Cette méthode place la totalité du plan vidéo dans la table de montage.

Lorsque vous cliquez sur un plan vidéo dans la liste du projet, l'onglet « Plan vidéo » du panneau de prévisualisation affichera automatiquement la première trame du plan vidéo. Vous pouvez appuyer sur le bouton de lecture pour avoir une idée du contenu avant de le placer dans la table de montage. Déplacez le curseur de lecture à la position ou vous voulez commencer votre plan et appuyez sur le bouton « Point d'entrée ». De même, déplacez le curseur de lecture à la position ou vous voulez terminer votre plan et appuyez sur le bouton « Point de sortie ». Enfin faite un « glisser / déposer » entre la prévisualisation du plan vidéo et la table de montage pour ajouter le plan vidéo. Celui ci apparaîtra découpé aux limites préalablement définies dans le panneau de prévisualisation.

### Sélection de plans vidéo dans la table de montage

Vous pouvez sélectionner un plan vidéo dans la table de montage en clicquant dessus avec le bouton gauche de la souris. Si vous voulez ajouter des plans vidéo à la sélection courante, appuyez sur la touche « Maj » et sélectionnez de nouveaux plans vidéo dans la table de montage. Vous pouvez sélectionner ou désélectionner un plan vidéo d'une sélection en utilisant la touche « Ctrl » avec le bouton gauche de la souris.

### Déplacement et redimensionnement des plans vidéo dans la table de montage

Pour déplacer les plans vidéo dans la table de montage, utiliser le « glisser / déposer » avec le bouton gauche de la souris. Vous pouvez redimensionner un plan vidéo directement dans la table de montage en déplaçant le curseur de la souris sur le début ou la fin de celui ci, puis en utilisant le le « glisser / déposer » avec le bouton gauche de la souris afin d'obtenir la bonne dimension.

Le redimensionnement d'un plan vidéo change automatiquement les points d'entrée et de sortie qui lui sont associés. Si vous resélectionnez le plan vidéo et que vous l'affichez dans la fenêtre de prévisualisation des plans vidéo, vous apercevrez alors leurs nouvelles positions.

Il n'est pas possible de redimensionner un plan vidéo au dessus de sa taille d'origine. Par exemple, si un plan vidéo a une durée de 30 secondes, vous ne pourrez pas le redimensionner à une durée de 35 secondes.

Quand vous redimensionnez et déplacez des plans vidéo, les options « Utiliser les trames » et « Utiliser les bords » du menu « Montage vidéo » vous permettent d'ajuster la position des plans vidéo dans la table de montage. Ceci peut être utile pour aligner rapidement l'un derrière l'autre les plans vidéo.

### Suppression de plans vidéo dans la table de montage

Il existe deux méthodes pour supprimer un plan vidéo de la table de montage. La première est de sélectionner le plan ou les plans vidéo à supprimer et d'appuyer sur la touche Suppr.

La seconde méthode consiste à sélectionner les plans vidéo et de les « glisser / déposer » en dehors de la table de montage.

L'équipe de développement n'a pas encore décidé si cette dernière méthode est correcte ou non. Elle pourrait être supprimé dans des versions futures de &kdenlive;

## Utilisation de &kdenlive;

### La liste du projet

La liste du projet affiche tous les plans vidéo qui sont disponibles dans le projet.

Vous pouvez voir le nombre de fois qu'un plan vidéo est utilisé dans une séquence vidéo. Ceci inclut tous les usages du plan vidéo, dont la prévisualisation de celui ci.

#### Ajouter un plan vidéo au projet

Si vous utilisez le glisser / déposer sur la table de montage un plan vidéo qui n'est pas dans votre projet (par exemple en utilisant un fichier au format « DV » à partir de Konqueror), alors celui ci sera automatiquement ajouté au projet.

Vous pouvez ajouter vous même un plan vidéo dans la liste du projet. On utilise pour cela le menu contextuel de la liste du projet avec le bouton droit de la souris, ou le menu « Projet » dans la barre de menu de l'application. Sélectionnez l'option « Ajouter des plans vidéo » pour ouvrir une boîte de dialogue de sélection de fichiers. Si les fichiers vidéo choisis sont valides, il apparaîtront dans la liste du projet.

#### Suppression des plans vidéo via la liste du projet

La suppression de plans vidéo n'est pas encore opérationnelle. La seule manière de supprimer des plans vidéo est de purger le projet.

#### Consultation des propriétés des plans vidéo

L'affichage des propriétes d'un plan vidéo n'est pas encore opérationnelle. La seule solution existante pour avoir des informations sur un fichier vidéo est d'utiliser la fenêtre de débogage.

#### Purger le projet - Suppression des plans vidéo non utilisés

Utiliser l'option « Purger le projet » pour supprimer de la liste du projet tous les plans vidéo non utilisés. Cette option est intéressante lorsque la liste du projet contient un très grand nombre de plans vidéo. La purge du projet n'affecte pas le montage vidéo final. Seul les plans vidéo qui ne sont pas utilisés dans le montage vidéo seront supprimés de la liste du projet.

### The Debug Panel

The Debug Panel

Le panneau de débogage est très utilisé par l'équipe de développement de &kdenlive;. Il affiche de nombreuses informations concernant les processus de traitement des plans vidéo effectués par &kdenlive;. Cette section ne vous aidera pas à comprendre les informations contenu dans le panneau de débogage, mais vous expliquera pourquoi il existe et comment il opère.

À la gauche du panneau de débogage, on trouve la liste des processus nécessaires aux rendus vidéo de &kdenlive;. Chaque processus est nommé en fonction de son utilisation dans &kdenlive;. Il y a trois processus dans la version actuelle de &kdenlive;. Le processus « Plan vidéo » permet la prévisualisation des plans vidéo. Le processus « Montage vidéo » permet la prévisualisation du projet. Le processus « Projet » permet toutes les autres tâches, tel que la détermination des durées des plans vidéo et l'exportation finale du montage vidéo.

Si vous choisissez un des processus de rendu vidéo dans la liste, la zone de texte affichera les messages de débogage correspondants. En général, il n'est pas nécessaire de connaître la signification des messages, mais dans certain cas il est important de pouvoir récupérer ces informations pour les rapports de bogues. Cliquez sur le bouton « Enregistrer les messages » pour préciser le fichier cible de sauvegarde des messages.

Le bouton « Enregistrer les messages » vous permet de sauvegarder une trace de tous les messages issus des programmes de rendu vidéo. Il n'est pas nécessaire de sauvegarder individuellement les vues de tous les programmes de rendu vidéo.

Une option est disponible dans le panneau de débogage pour pouvoir activer ou désactiver l'affichage des messages de débogage. Cela peut être nécessaire sur les ordinateurs peu puissants, ou lorsque vous exécuter de longue session de &kdenlive;. En effet, l'affichage des messages de débogage ralentissent le programme et consomment beaucoup de mémoire.

### La liste des effets

Cette fonctionnalité n'est pas encore implantée dans la version actuelle de &kdenlive;.

### Le panneau de configuration des effets

Cette fonctionnalité n'est pas encore implantée dans la version actuelle de &kdenlive;.

### La table de montage vidéo

À faire...

### La prévisualisation des plans vidéo

À faire...

### La prévisualisation du montage vidéo

La prévisualisation du montage vidéo affiche la vidéo résultante du contenu de la table de montage. Son fonctionnement est similaire à la prévisualisation des plans vidéo.

Les points d'entrée et de sortie de la fenêtre de prévisualisation du montage vidéo ont les mêmes fonctions que ceux présent dans la fenêtre de prévisualisation des plans vidéo. Vous pouvez obtenir ainsi un « plan vidéo du projet », qui sera une séquence vidéo contenant tous les plans vidéo présent dans la table de montage. Cette fonction est utile pour regrouper ensemble un certain nombre de plans vidéo quand vous avez fini de les associer dans la table de montage et que vous voulez les manipuler comme un simple plan vidéo.

### Le rendu vidéo du projet

Quand vous avez terminé votre montage vidéo, vous pouvez l'exporter en utilisant le menu « Rendu vidéo / Exporter le montage vidéo ». Ce menu affichera une boîte de dialogue qui vous permettra de choisir le format, les options, et le nom du fichier pour l'exportation de votre montage vidéo.

La boîte de dialogue pour le rendu vidéo du projet.

Les versions actuelles des programmes &kdenlive; et &piave; ne gèrent uniquement l'exportation vidéo au format « DV » brut (RAW).

### L'ouverture et l'enregistrement de votre projet

Charger votre projet avec le menu « Fichier / Ouvrir ». Enregistrer votre projet avec le menu « Fichier / Enregistrer sous ».

### La configuration du programme de rendu vidéo

Avec cette boîte de dialogue, vous pouvez configurer tous les paramètres nécessaires au fonctionnement du programme effectuant le rendu vidéo.

La boîte de dialogue de configuration du programme de rendu vidéo

## Les commandes de référence

### La fenêtre principale de &kdenlive;

#### Le menu « Fichier »

Ctrl n Fichier Nouveau

- Création d'un nouveau projet de montage vidéo.

Ctrl o Fichier Ouvrir

- Ouvrir un projet préalablement enregistré.

Fichier Récemment ouvert(s)

- Ouvre un projet qui a été précédemment ouvert dans &kdenlive;.

Ctrl s Fichier Enregistrer

- Enregistre le projet courant.

Fichier Enregistrer sous...

- Enregistre le projet avec un nom différent.

Ctrl q Fichier Quitter

- Quitte &kapp;

#### Le menu « Édition »

Ctrl z Édition Annuler

- Annule la dernière opération faite dans la table de montage.

Ctrl Shift z Édition Refaire

- Réitère la précédente opération faite dans la table de montage.

Ctrl x Édition Couper

- Cette fonction n'est pas encore opérationnelle

Ctrl c Édition Copier

- Cette fonction n'est pas encore opérationnelle

Ctrl v Édition Coller

- Cette fonction n'est pas encore opérationnelle

#### Le menu « Projet »

Projet Ajouter des plans vidéo

- Ajoute des plans vidéo dans la liste du projet.

Projet Supprimer des plans vidéo

- Delete the selected clip from the project. This deletes all references to the clip, including those on the timeline, or those within composite clips.

Projet Purger le projet

- Suppression de la liste des plans vidéo inutilisés dans le projet.

Projet Propriétés du plan vidéo

- Cette fonction n'est pas encore opérationnelle

#### Le menu « Montage vidéo »

q Montage vidéo Outil de déplacement / redimensionnement

- Choisir l'outil de déplacement / redimensionnement de la table de montage. Cet outil vous permet de déplacer et de redimensionner les plans vidéo dans la table de montage. C'est l'outil qui est utilisé par défaut dans la table de montage.

w Montage vidéo Outil de découpage

- Choisir l'outil de découpage de la table de montage. Cet outil vous permet de découper en deux pièces les plans vidéo à l'emplacement du curseur dans la table de montage.

e Montage vidéo Outil de séparation

- Choisir l'outil de séparation de la table de montage. Cette outil vous permet de sélectionner tous les plans vidéo situés à la droite du curseur dans la table de montage.

Montage vidéo Utiliser les trames

- Si cette option est activée, toutes les opérations faites sur les plans vidéo dans la table de montage utiliseront les trames vidéo comme éléments de travail.

Montage vidéo Utiliser les bords

- Si cette option est activée, le déplacement et le redimensionnement des plans vidéo seront réalisés en utilisant les bords et les marqueurs de la table de montage.

#### Le menu « Rendu vidéo »

Rendu vidéo Exporter le montage vidéo

- Exporte le contenu de la table de montage dans une séquence vidéo. Cette opération est aussi appelée le « rendu vidéo ».

#### Le menu « Fenêtre »

F9 Fenêtre Charger la fenêtre 1

- Charge la configuration de la fenêtre d'édition vidéo précédemment enregistré.

F10 Fenêtre Charger la fenêtre 2

- Charge la configuration de la fenêtre d'édition vidéo précédemment enregistré.

F11 Fenêtre Charger la fenêtre 3

- Charge la configuration de la fenêtre d'édition vidéo précédemment enregistré.

F12 Fenêtre Charger la fenêtre 4

- Charge la configuration de la fenêtre d'édition vidéo précédemment enregistré.

Ctrl Shift F9 Fenêtre Enregistrer la fenêtre 1

- Enregistre la fenêtre d'édition vidéo courante en tant que fenêtre 1.

Ctrl Shift F10 Fenêtre Enregistrer la fenêtre 2

- Enregistre la fenêtre d'édition vidéo courante en tant que fenêtre 2.

Ctrl Shift F11 Fenêtre Enregistrer la fenêtre 3

- Enregistre la fenêtre d'édition vidéo courante en tant que fenêtre 3.

Ctrl Shift F12 Fenêtre Enregistrer la fenêtre 4

- Enregistre la fenêtre d'édition vidéo courante en tant que fenêtre 4.

#### Le menu « Configuration »

Configuration Afficher la barre d'outils

- Affiche ou cache la barre d'outils.

Configuration Afficher la barre d'état

- Affiche ou cache la barre d'état.

Configuration Configurer les raccourcis clavier...

- Configure les raccourcis clavier de &kdenlive;.

Configuration Configurer les barres d'outils...

- Configure les barres d'outils de &kdenlive;.

Configuration Configurer &kdenlive;...

- Configure &kdenlive;

#### Le menu « Aide »

Aide Manuel de &kdenlive;

- Affiche le manuel de &kdenlive; (ce document).

Shift F1 Aide Qu'est ce que c'est ?

- Après avoir sélectionner cette option, cliquez sur une partie de l'interface graphique pour obtenir de de plus amples informations la concernant.

Aide Rapport de bogue...

- Rapporte un bogue à propos de &kdenlive;

Aide À propos de &kdenlive;

- Affiche les informations concernant &kdenlive;, dont la licence, les auteurs, et les contributeurs.

Aide À propos de KDE

- Affiche les informations concernant le projet KDE.

## Le guide du développeur de &kdenlive;

À faire...

## Problèmes connus et solutions

Si une session de &kdenlive; ou une des sessions de &piave; s'arrête anormalement, il est possible que la session courante ou une nouvelle session de &kdenlive; ne puisse pas correctement s'exécuter.

Il y a deux raisons à ce problème. La première est qu'une des sessions de &piave; ne s'arrête pas correctement lors d'une précédente session de &kdenlive;. La solution la plus simple est d'arrêter &kdenlive; et de saisir la ligne de commande suivante :

    % killall -9 piave

Cette opération arrêtera toutes les instances du programme &piave;. De cette manière, &kdenlive; doit pouvoir s'exécuter correctement.

Si la ligne de commande précédente vous renvoie un message du genre piave : no process killed, il est fort probable que des ports de communication associés au programme &piave; n'ont pas été libéré lors d'une précédente instance du programme. Attendez une minute avant de relancer une nouvelle session de &kdenlive; (les ports TCP devrai être normalement libérés après cette durée).

## Questions fréquemment posées (FAQ)

&reporting.bugs;

What file formats does &kapp; support?

Currently, &kapp; supports playback of AVI files that use the DV codec (other types of AVI file will fail) and Raw DV files. Both of these formats are exported by &kino;.

On a technical note, &kapp; does not provide any video formats itself; all video formats are provided by the backend renderer, &piave;.

When will &kapp; support divx/mpeg files?

Short answer : When somebody codes the relevant plugin for &piave;.

The long answer : Supporting divx files in an editing application is difficult. divx and mpeg formats are not designed for video editing. Some frames contain only part of the information required to display that frame, which makes the random acces required by a video editing application difficult to achieve. There are also quality issues with decompressing and recompressing files that need to be taken into account. For these reasons, support for these formats in &kapp; itself are of low priority compared to the effect framework, the capture program and other such features.

If somebody is interested is adding divx/mpeg support to &kapp; (or to be technically correct, &piave;) then please contact me, and I will point you in the right direction. In the meantime, it is suggested that you capture video directly in Raw DV using &kino;, or convert your files to Raw DV format for use with &kapp;

When will &kapp; support mp3 files and other audio formats?

Sometime in the future, perhaps version 0.4.0 or 0.5.0. The roadmap on the website gives a rough idea of the order in which features are being added to &kapp;. The next priority is the effect framework, which will be the made addition for the 0.3.0 release. Once &kapp; 0.3.0 is released, we will decide on the next most important feature. This may be separate audio tracks.

Quand j'ajoute des plans vidéo au projet, la durée des fichiers vidéo est annotée « inconnue ». Ces fichiers sont pourtant des fichiers vidéo dont le format est connu. Que se passe t'il ?

This is a sign that something has gone wrong with &piave;. Whilst &kapp; will do it's best to pull itself back into working order, this is still relatively new software and it doesn't manage it as often as one would hope! The best solution is to quit &kapp; (if you have done any work, then you are quite safe to save it), perform the following operation:

    % killall -9 piave.

Wait a few seconds, and then restart kdenlive.

L'interface de &kdenlive; ne tient pas compte des opérations de l'utilisateur lorsqu'un plan vidéo est prévisualisé. Quel est le problème ?

Aller dans l'onglet « Déboguer » et essayer de valider l'option « Ignorer les messages entrants ». Cela désactivera l'affichage des messages de débogage qui peuvent ralentir considérablement l'interface graphique pendant la lecture de longs plans vidéo.

## Remerciements et licences

&kapp;

Copyright Jason Wood jasonwood@blueyonder.co.uk, 2002-2003

Contributeurs :

- Caulier Gilles caulier.Gilles@free.fr : internationalisation des programmes &kdenlive; et &piave;, traductions Françaises, logo de démarrage.

- Rolf Dubitzky dubitzky@pktw06.phy.tu-dresden.de : auteur et mainteneur du programme &piave;.

Documentation de Kdenlive : copyright Jason Wood jasonwood@blueyonder.co.uk, 2003

Traductions : Caulier Gilles caulier.gilles@free.fr.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kdenlive;

La page WEB de &kdenlive; est http://www.uchian.pwp.blueyonder.co.uk/kdenlive.html. &kdenlive; peut être trouvé à la page du projet http://sourceforge.net/projects/kdenlive/ du serveur SourceForge.

### Programmes requis

Pour pouvoir utiliser &kdenlive;, il est nécessaire d'avoir l'environnement de bureau KDE en version 3.0 ou supérieure. De plus, il est nécessaire d'avoir le programme « piave » pour pouvoir faire des opérations sur les fichiers vidéo. Kdenlive est une interface graphique pour ce programme.

Toutes les bibliothèques ainsi le programme &kdenlive; peuvent être trouvés sur la page WEB du projet.

Vous pouvez trouver la liste des dernières modifications de Kdenlive à l'adresse http://pwp.blueyonder.co.uk/kdenlive.html.

### Compilation et installation

Pour compiler et installer &kdenlive; sur votre système, saisissez les lignes de commande suivantes dans le dossier de base contenant les sources du programme :

    % ./configure --prefix=`kde-config --prefix`

    % make

    % make install

Des paramètres supplémentaires peuvent être nécessaires au script «./configure ». Saisissez la ligne de commande suivante dans le dossier de base contenant les sources du programme :

    % ./configure --help

Depuis que &kdenlive; utilise les programmes « autoconf » et « automake », vous ne devriez pas avoir de problèmes pour compiler celui ci. Si vous rencontrez des difficultés, veulliez contacter l'auteur à l'adresse jasonwood@blueyonder.co.uk.

&documentation.index;