Übergangselement

Übergänge erzeugen sanfte visuelle Effekte zwischen zwei aufeinanderfolgenden Video- oder Bildelementen.

Zeitliche Einschränkungen

  • Überlappung erforderlich: Übergänge funktionieren, indem sie das Ende eines Elements (preNodeId) mit dem Anfang eines anderen (postNodeId) überlappen
  • Maximale Dauer: Die Dauer des Übergangs darf die verfügbare Überlappungszeit zwischen den beiden Elementen nicht überschreiten
  • Positionierung: Die start-Zeit des Übergangs sollte mit der Überlappungsperiode übereinstimmen

Begrenzungen der Übergangsdauer

Die maximale Dauer für einen Übergang wird bestimmt durch:

maxDuration = min(
  availableEndTime_of_preNode,
  availableStartTime_of_postNode
)

Wenn Sie eine längere Dauer als diese festlegen, wird der Übergang möglicherweise nicht korrekt gerendert.

EigenschaftTypErforderlichBeispielWertbereichBeschreibung
preNodeIdstringtrue--Die eindeutige Kennung des vorhergehenden Elements, an dem der Übergang beginnt.
postNodeIdstringtrue--Die eindeutige Kennung des nachfolgenden Elements, an dem der Übergang endet.
transitionTypestringtrue-directionalwarp, directionalwipe, Bounce, BowTieHorizontal, BowTieVertical, ButterflyWaveScrawler, CircleCrop, ColourDistance, CrazyParametricFun, Directional, DoomScreenTransition, Dreamy, DreamyZoom, GridFlip, InvertedPageCurl, LinearBlur, Mosaic, PolkaDotsCurtain, Radial, SimpleZoom, StereoViewer, Swirl, WaterDrop, ZoomInCircles, angular, burn, cannabisleaf, circle, colorphase, crosshatch, crosswarp, cube, displacement, doorway, fade, fadecolor, fadegrayscale, flyeye, heart, hexagonalize, kaleidoscope, luma, luminance_melt, morph, multiply_blend, pinwheel, pixelize, polar_function, ripple, rotate_scale_fade, squareswire, squeeze, swap, undulatingBurnOut, wind, windowblinds, windowslice, wipeDown, wipeLeft, wipeRight, wipeUpDie Art des angewendeten Übergangseffekts. Die Namen sind groß-/kleinschreibungssensitiv.

Wichtige Hinweise:

  • Die preNodeId und postNodeId müssen auf vorhandene Elemente im view-Array verweisen
  • Groß-/Kleinschreibung: Die Namen der Übergangstypen sind groß-/kleinschreibungssensitiv. Verwenden Sie die genauen Namen wie oben aufgeführt
  • Namenskonvention: Einige Übergänge verwenden PascalCase (z. B. Bounce, CircleCrop), andere verwenden Kleinbuchstaben (z. B. fade, wipeLeft). Verwenden Sie die genauen Namen wie gezeigt
  • Dauerbegrenzung: Stellen Sie sicher, dass die Übergangsdauer die Überlappungszeit zwischen den Elementen nicht überschreitet
  • Das Übergangselement selbst benötigt keinen trackIndex - es leitet die Zeit von den referenzierten Elementen ab

Beispielanwendungsfälle:

  • Ein fade-Übergang bietet eine klassische Überblendung zwischen zwei Videos
  • wipeLeft erzeugt einen gleitenden Wisch-Effekt von rechts nach links
  • Bounce fügt während des Übergangs einen verspielten elastischen Sprung hinzu
  • Benutzerdefinierte Übergänge wie directionalwarp erzeugen Verzerrungseffekte

Beispiel: Videoübergang

Zwei Videos mit einer 2-sekündigen Übergangsüberlappung:

transitionElement.json
{
"view": [
  {
    "id": "435862f1-2358-464d-b379-26f4b63b12e3",
    "type": "Video",
    "start": 0,
    "duration": 10.218542,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video1.mp4",
    "ext": "mp4"
  },
  {
    "id": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "type": "Video",
    "start": 8.218542,
    "duration": 15,
    "trackIndex": 0,
    "externalUrl": "https://example.com/video2.mp4",
    "ext": "mp4"
  }
],
"transition": [
  {
    "id": "52b20852-e260-41aa-afab-70c22e20f62b",
    "type": "Transition",
    "start": 8.218542,
    "duration": 2,
    "preNodeId": "435862f1-2358-464d-b379-26f4b63b12e3",
    "postNodeId": "2b82ffe3-7c6e-4d28-9c11-9e3de94c5a49",
    "transitionType": "directionalwarp"
  }
]
}