Overview

Element

Effect

Elemento de Transição

Transições criam efeitos visuais suaves entre dois elementos de vídeo ou imagem consecutivos.

Restrições de Tempo

  • Sobreposição Necessária: As transições funcionam sobrepondo o final de um elemento (preNodeId) com o início de outro (postNodeId)
  • Duração Máxima: A duração da transição não pode exceder o tempo de sobreposição disponível entre os dois elementos
  • Posicionamento: O tempo de início da transição deve alinhar-se com o período de sobreposição

Limites de Duração da Transição

A duração máxima para uma transição é determinada por:

maxDuration = min(
  availableEndTime_of_preNode,
  availableStartTime_of_postNode
)

Se você definir uma duração maior do que isso, a transição pode não ser renderizada corretamente.

PropriedadeTipoNecessárioExemploFaixa de ValoresDescrição
preNodeIdstringtrue--O identificador exclusivo do elemento anterior onde a transição começa.
postNodeIdstringtrue--O identificador exclusivo do elemento seguinte onde a transição termina.
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, wipeUpO tipo de efeito de transição aplicado. Os nomes são sensíveis a maiúsculas.

Notas Importantes:

  • O preNodeId e o postNodeId devem referenciar elementos existentes no array view
  • Sensibilidade a Maiúsculas: Os nomes dos tipos de transição são sensíveis a maiúsculas. Use os nomes exatos conforme listados acima
  • Convenção de Nomeação: Algumas transições usam PascalCase (por exemplo, Bounce, CircleCrop), outras usam letras minúsculas (por exemplo, fade, wipeLeft). Use os nomes exatos conforme mostrado
  • Limite de Duração: Certifique-se de que a duração da transição não exceda o tempo de sobreposição entre os elementos
  • O próprio elemento de transição não precisa de um trackIndex - ele deriva o tempo dos elementos referenciados

Casos de Uso Exemplares:

  • Uma transição fade fornece um clássico cross-dissolve entre dois vídeos
  • wipeLeft cria um efeito de deslizar de direita para esquerda
  • Bounce adiciona um salto elástico e brincalhão durante a transição
  • Transições personalizadas como directionalwarp criam efeitos de distorção

Exemplo: Transição de Vídeo

Dois vídeos com uma sobreposição de transição de 2 segundos:

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"
  }
]
}