Créer des transitions vidéo professionnelles entre clips en C¶

// Définir les chemins vers nos fichiers vidéo sources
string[] files = { @"c:\samples\video1.avi", @"c:\samples\video2.avi" };

// Créer la première source vidéo - ce sera le premier clip de notre timeline
var videoFile = new VideoSource(
        files[0],                         // Chemin du premier fichier vidéo
        TimeSpan.Zero,                    // Démarrer depuis le début du fichier source
        TimeSpan.FromMilliseconds(5000),  // Utiliser 5 secondes de la vidéo
        VideoEditStretchMode.Letterbox,   // Conserver le rapport d'aspect, ajouter des bandes noires si nécessaire
        0,                                // Pas de rotation (0 degrés)
        1.0);                             // Vitesse de lecture normale (1.0x)

// Créer la seconde source vidéo - ce sera notre second clip avec chevauchement
var videoFile2 = new VideoSource(
        files[1],                         // Chemin du second fichier vidéo
        TimeSpan.Zero,                    // Démarrer depuis le début du fichier source
        TimeSpan.FromMilliseconds(5000),  // Utiliser 5 secondes de la vidéo
        VideoEditStretchMode.Letterbox,   // Conserver le rapport d'aspect, ajouter des bandes noires si nécessaire
        0,                                // Pas de rotation (0 degrés)
        1.0);                             // Vitesse de lecture normale (1.0x)

// Ajouter la première vidéo au début de la timeline (position 0 ms)
await VideoEdit1.Input_AddVideoFileAsync(
        videoFile,
        TimeSpan.FromMilliseconds(0));    // Position sur la timeline : 0 ms (début)

// Ajouter la seconde vidéo à 4 secondes, créant un chevauchement d'une seconde avec la première vidéo
// Ce chevauchement sera l'endroit où notre transition se produira
await VideoEdit1.Input_AddVideoFileAsync(
        videoFile2,
        TimeSpan.FromMilliseconds(4000)); // Position sur la timeline : 4000 ms (4 secondes)

// Définir les chemins vers nos fichiers vidéo sources
string[] files = { @"c:\samples\video1.avi", @"c:\samples\video2.avi" };

// Créer la première source vidéo - ce sera le premier clip de notre timeline.
// VideoFileSource(filename, startTime, stopTime, streamNumber, rate) — l'argument int
// est l'index de flux audio/vidéo, pas un angle de rotation. Passez 0 pour utiliser
// le flux par défaut.
var videoFile = new VideoFileSource(
        files[0],                         // Chemin du premier fichier vidéo
        TimeSpan.Zero,                    // Démarrer depuis le début du fichier source
        TimeSpan.FromMilliseconds(5000),  // Utiliser 5 secondes de la vidéo
        0,                                // streamNumber — 0 sélectionne le flux vidéo par défaut
        1.0);                             // Vitesse de lecture normale (1.0x)

// Créer la seconde source vidéo - ce sera notre second clip avec chevauchement
var videoFile2 = new VideoFileSource(
        files[1],                         // Chemin du second fichier vidéo
        TimeSpan.Zero,                    // Démarrer depuis le début du fichier source
        TimeSpan.FromMilliseconds(5000),  // Utiliser 5 secondes de la vidéo
        0,                                // streamNumber — 0 sélectionne le flux vidéo par défaut
        1.0);                             // Vitesse de lecture normale (1.0x)

// Ajouter la première vidéo au début de la timeline (position 0 ms)
VideoEdit1.Input_AddVideoFile(
        videoFile,
        TimeSpan.FromMilliseconds(0));    // Position sur la timeline : 0 ms (début)

// Ajouter la seconde vidéo à 4 secondes, créant un chevauchement d'une seconde avec la première vidéo
// Ce chevauchement crée la région où notre transition se produira
VideoEdit1.Input_AddVideoFile(
        videoFile2,
        TimeSpan.FromMilliseconds(4000)); // Position sur la timeline : 4000 ms (4 secondes)

// Obtenir l'ID pour l'effet de transition « Upper right ».
// Les API Video_Transition_* sont des méthodes d'instance sur VideoEditCore — appelez-les sur l'instance du moteur, pas sur le type.
int id = VideoEdit1.Video_Transition_GetIDFromName("Upper right");

// Ajouter la transition à la timeline
// Paramètres :
// - Heure de début : 4000 ms (où commence le second clip et où débute le chevauchement)
// - Heure de fin : 5000 ms (où se termine le premier clip et où se termine le chevauchement)
// - ID de transition : l'ID que nous avons récupéré pour la transition « Upper right »
VideoEdit1.Video_Transition_Add(TimeSpan.FromMilliseconds(4000), TimeSpan.FromMilliseconds(5000), id);

// Obtenir la collection de tous les noms d'effets de transition disponibles (méthode d'instance).
ObservableCollection<string> availableTransitions = VideoEdit1.Video_Transition_Names();

// Exemple d'itération sur toutes les transitions disponibles
foreach (string transitionName in availableTransitions)
{
    // Obtenir l'ID pour chaque transition
    int transitionId = VideoEdit1.Video_Transition_GetIDFromName(transitionName);
    // Vous pourriez l'utiliser dans l'UI de votre application pour permettre aux utilisateurs de choisir des transitions
    Console.WriteLine($"Transition: {transitionName}, ID: {transitionId}");
}

// Obtenir tous les noms de transitions disponibles sous forme de tableau
var transitionNames = VideoEdit1.Video_Transitions_Names();

// Sélectionner une transition spécifique par index
// Note : le tableau commence à zéro, donc l'index 10 est la 11e transition de la liste
var transitionName = transitionNames[10]; 

// Vous pourriez également itérer sur toutes les transitions pour les afficher dans une liste déroulante d'UI
// foreach (var name in transitionNames)
// {
//     Console.WriteLine($"Available transition: {name}");
// }

// Créer un nouvel objet de transition en spécifiant :
// - Le nom de la transition sélectionnée ci-dessus
// - Heure de début (4000 ms) - où commence le chevauchement
// - Heure de fin (5000 ms) - où se termine le chevauchement
var trans = new VideoTransition(
        transitionName,                          // Le nom de la transition 
        TimeSpan.FromMilliseconds(4000),         // Heure de début de la transition
        TimeSpan.FromMilliseconds(5000));        // Heure de fin de la transition

// Ajouter la transition à la collection de transitions du composant VideoEdit
VideoEdit1.Video_Transitions.Add(trans);

// Créer une transition en utilisant un nom spécifique sans le rechercher au préalable.
// Le constructeur prenant une string analyse via Enum.Parse(typeof(VideoTransitionType), name).
// Les véritables membres de VideoTransitionType sont : "Crossfade", "FadeIn", "FadeOut",
// plus 100+ wipes SMPTE (par ex. "BarWipeLr", "BarWipeTb", "BoxWipeTl",
// "BoxWipeTr", "ClockCw12", "IrisRect", "IrisDiamond", etc.). Passez tout
// autre identifiant (comme "Fade", "FadeFromBlack", "Push", "Slide",
// "Iris", "Pixelate") et Enum.Parse lèvera ArgumentException à l'exécution.
// La liste énumérable des noms disponibles retournée par
// Video_Transitions_GetList est la source de vérité la plus sûre.
var trans = new VideoTransition(
        "Crossfade",                             // Utilisation d'un identifiant VideoTransitionType réel
        TimeSpan.FromMilliseconds(4000),         // Heure de début de la transition
        TimeSpan.FromMilliseconds(5000));        // Heure de fin de la transition

// Ajouter la transition au composant VideoEdit
VideoEdit1.Video_Transitions.Add(trans);

// Vous pouvez également créer plusieurs transitions entre différents clips :
// var secondTrans = new VideoTransition("FadeIn", TimeSpan.FromMilliseconds(9000), TimeSpan.FromMilliseconds(10000));
// VideoEdit1.Video_Transitions.Add(secondTrans);

// ÉTAPE 1 : configurer le chemin du fichier de sortie
VideoEdit1.Output_Filename = "output.mp4";  // Définir le chemin du fichier de destination

// ÉTAPE 2 : créer et configurer le format de sortie
var outputFormat = new MP4Output();
// Ajustez les paramètres de l'encodeur via les sous-paramètres imbriqués Video / Audio, par ex. :
// (outputFormat.Video as MP4OutputH264Settings).Bitrate = 5000;  // kbit/s
// La taille de sortie et la fréquence d'images sont déterminées par VideoEdit1.Video_FrameRate et la résolution de la timeline.

// ÉTAPE 3 : assigner le format de sortie au composant VideoEdit
VideoEdit1.Output_Format = outputFormat;

// ÉTAPE 4 : démarrer le traitement asynchrone
// Ceci effectuera le rendu de la vidéo avec la transition et l'enregistrera dans le fichier de sortie
await VideoEdit1.StartAsync();

// Après cet appel, vous devriez écouter les événements de traitement comme :
// - VideoEdit1.OnProgress pour suivre la progression du traitement
// - VideoEdit1.OnStop pour détecter la fin du traitement

// ÉTAPE 1 : créer et configurer le format de sortie
// Dans VideoEditCoreX, nous spécifions le nom du fichier de sortie directement dans le constructeur
var outputFormat = new MP4Output("output.mp4");

// Ajustez les paramètres de l'encodeur via les sous-paramètres imbriqués Video / Audio sur MP4Output, par ex. :
// (outputFormat.Video as H264EncoderSettings).Bitrate = 5000;  // kbit/s
// (outputFormat.Audio as AACEncoderSettings).Bitrate = 192;    // kbit/s
// La taille de l'image de sortie provient de VideoEdit1.Output_VideoSize et la fréquence d'images de Output_VideoFrameRate.

// ÉTAPE 2 : assigner le format de sortie au composant VideoEdit
VideoEdit1.Output_Format = outputFormat;

// ÉTAPE 3 : démarrer le traitement (appel synchrone ; retourne true en cas de succès)
// Ceci effectuera le rendu de la vidéo avec la transition et l'enregistrera dans le fichier de sortie.
VideoEdit1.Start();

// Vous devriez également configurer les gestionnaires d'événements avant d'appeler Start() :
// VideoEdit1.OnProgress += (s, e) => { Console.WriteLine($"Progress: {e.Progress}%"); };
// VideoEdit1.OnStop += (s, e) => { Console.WriteLine("Processing completed!"); };