Visão Geral

Elemento

Efeito

Introdução

A API Chillin Render permite que você especifique o conteúdo de vídeo e os parâmetros a serem renderizados definindo uma estrutura JSON como a abaixo.

  • Acesse Render Console para obter créditos da API Render e gerar sua chave da API Render.

  • Envie uma solicitação POST para o endpoint da API Render com sua chave da API:

curl-example.sh
request.json

A API opera em modo assíncrono e retorna uma resposta como esta:

async_response.json

Conceitos Básicos

Todos os objetos JSON incluem um objeto de projeto de vídeo, especificando a largura composta do vídeo, a altura composta e a resolução.

O objeto do projeto contém os parâmetros básicos para renderizar o vídeo, como largura, altura, duração, cor de fundo e mais.

O projeto também inclui um ou mais elementos, onde cada elemento representa um componente de vídeo, como um vídeo, imagem, texto, forma, áudio ou efeito.

Cada elemento contém parâmetros específicos para o componente, como posição, tamanho, cor, conteúdo, e assim por diante.

project.json

Espaço 3D & Câmera

O mecanismo de renderização suporta tanto elementos 2D quanto 3D. Enquanto a tela é definida com largura e altura em pixels, o motor usa uma câmera de perspectiva para a renderização 3D:

  • Sistema de Coordenadas: As coordenadas x e y representam posições no plano da tela 2D. A coordenada z controla a profundidade no espaço 3D.
  • Projeção Perfeita em Pixels: Em z=0, uma unidade de mundo equivale a um pixel, mantendo a compatibilidade com fluxos de trabalho 2D.
  • Rotações 3D: Os elementos podem ser rotacionados em torno dos eixos X, Y e Z usando as propriedades rotationX, rotationY e rotation (eixo Z).

Esse design permite a mistura contínua de elementos 2D e 3D no mesmo projeto. Elementos 2D tradicionais (com z=0) renderizam exatamente como antes, enquanto elementos 3D podem ser posicionados e rotacionados no espaço tridimensional.

Exemplo de Elemento 3D

Aqui está um exemplo simples de um elemento cubo 3D:

3d-cube-example.json

Diferenças principais em relação aos elementos 2D:

  • type: "3D" identifica isso como um elemento 3D
  • z, rotationX, rotationY e scaleZ permitem transformações 3D
  • geometryType especifica a forma 3D (cubo, esfera, cilindro, etc.)
  • geometryColor define a cor base da geometria 3D

Para mais detalhes sobre elementos 3D, consulte a documentação Elemento 3D.

Esquema JSON

Seu JSON de solicitação deve aderir estritamente ao esquema JSON definido neste documento. Você pode testar e gerar o JSON de solicitação correspondente no Editor de Vídeo Chillin.