Ākāṅkṣa

Tattva

Effectus

Inceptio

Chillin Render API sinitium permittit ut contentum video et parametra ad rendendum definiendo structura JSON similem illi inferius.

  • I ad Render Console ad obtinendum Render API credita et generandum tuum Render API clavem

  • Mitte postulatum POST ad Render API terminum cum tua API clavi:

curl-example.sh
1curl -X POST https://render-api.chillin.online/render/v1 \ 2-H "Accept: application/json" \ 3-H "Content-Type: application/json" \ 4-H "Authorization: Bearer YOUR_API_KEY" \ 5-d @request.json
request.json
1{ 2"compositeWidth": 1920, 3"compositeHeight": 1080, 4"fps": 30, 5"projectData": { 6 "type": "", 7 "width": 1920, 8 "height": 1080, 9 "fill": "#000000", 10 "view": [ 11 { 12 "id": "bba95c7f-652b-4380-b166-6bece989f527", 13 "type": "Image", 14 "start": 0, 15 "duration": 5, 16 "trackIndex": 0, 17 "x": 0, 18 "y": 0, 19 "width": 3629, 20 "height": 5444, 21 "blendMode": "normal", 22 "anchorX": 1814.5, 23 "anchorY": 2722, 24 "rotation": 0, 25 "scaleX": 0.19838354151359294, 26 "scaleY": 0.19838354151359294, 27 "alpha": 1, 28 "skewX": 0, 29 "skewY": 0, 30 "hidden": false, 31 "locked": false, 32 "keyframes": [], 33 "externalUrl": "https://images.pexels.com/photos/33189512/pexels-photo-33189512.jpeg", 34 "ext": "jpeg" 35 } 36 ], 37 "audio": [], 38 "effect": [], 39 "transition": [], 40 "version": 0, 41 "duration": 5 42} 43}; 44

API in modo async operatur et responsum huiusmodi reddit:

async_response.json
1{ 2"code": 0, 3"data": { 4 "message": "Async render request submitted successfully", 5 "render_id": 100000, 6 "status": "processing" 7}, 8"msg": "success" 9} 10

Notiones Fundamentales

Omnes obiecta JSON includunt obiectum projecti video, specificans latitudinem compositum video, altitudinem compositum, et resolutionem.

Obiectum projecti continet parameters fundamentales ad rendendum video, sicut latitudo, altitudo, duratio, color background, et plura.

Projectum etiam includit unum vel plura elementa, ubi singula elementa repraesentant componentem video, sicut video, imago, textus, figura, audio, vel effectus.

Singulum elementum continet specifica parameters pro componenti, sicut positionem, magnitudinem, colorem, contentum, et cetera.

project.json
1{ 2"compositeWidth": 1920, 3"compositeHeight": 1080, 4"fps": 30, 5"projectData": { 6 "type": "", 7 "width": 1920, 8 "height": 1080, 9 "fill": "#000000", 10 "view": [ 11 { 12 "id": "8ecf7475-2c6c-47f9-827b-a09c7913f4c0", 13 "type": "Image", 14 "start": 0, 15 "duration": 5, 16 "trackIndex": 0, 17 "x": -570.0335392757963, 18 "y": -170.90659033307685, 19 "blendMode": "normal", 20 "anchorX": 1302, 21 "anchorY": 2312, 22 "rotation": 0, 23 "scaleX": 0.23356401384083045, 24 "scaleY": 0.23356401384083045, 25 "alpha": 1, 26 "skewX": 0, 27 "skewY": 0, 28 "keyframes": [], 29 "externalUrl": "https://images.pexels.com/photos/30465303/pexels-photo-30465303.jpeg", 30 "ext": "jpeg" 31 } 32 ], 33 "audio": [], 34 "effect": [], 35 "transition": [], 36 "version": 0, 37 "duration": 5 38} 39}; 40

Spatium 3D & Camera

Machina rendendi tam 2D quam 3D elementa sustinet. Dum canvas definitur cum width et height in pixelibus, machina utitur camera perspectiva ad rendendum 3D:

  • Systema Coordinatarum: Coordinatae x et y repraesentant positiones in plano canvas 2D. Coordinata z profunditatem in spatio 3D moderatur.
  • Proiectio Pixel-Perfect: Ad z=0, unus unitas mundi aequat unum pixel, compatibilitatem cum fluxibus 2D servans.
  • Rotationes 3D: Elementa circum axibus X, Y, et Z rotari possunt usque ad proprietates rotationX, rotationY, et rotation (axis Z).

Haec consilium sinit sine interruptione miscere elementa 2D et 3D in eodem project. Elementa traditionalia 2D (cum z=0) renderuntur exacte ut ante, dum elementa 3D in spatio tridimensionali ponuntur et rotantur.

Exemplum Elementi 3D

Hic est simplex exemplum elementis cubi 3D:

3d-cube-example.json
1{ 2"id": "3d-cube-001", 3"type": "3D", 4"start": 0, 5"duration": 5, 6"trackIndex": 0, 7"x": 960, 8"y": 540, 9"z": 0, 10"width": 200, 11"height": 200, 12"anchorX": 100, 13"anchorY": 100, 14"rotation": 0, 15"rotationX": 30, 16"rotationY": 45, 17"scaleX": 1, 18"scaleY": 1, 19"scaleZ": 1, 20"alpha": 1, 21"ext": "geometry", 22"geometryType": "cube", 23"nodeCategory": "basic", 24"geometryColor": "#4A90E2" 25} 26

Differences principales a elementis 2D:

  • type: "3D" hoc identificat ut elementum 3D
  • z, rotationX, rotationY, et scaleZ transformationes 3D enable
  • geometryType specificat formam 3D (cubus, sphaera, cylindrus, etc.)
  • geometryColor color basis geometriae 3D constituit

Ad plura de elementis 3D, vide 3D Element documentationem.

Schema JSON

Tuum postulatum JSON stricte adhaerere debet schema JSON in hoc documento definito. Potestatem habes probare et generare correspondens postulatum JSON in Chillin Video Editor.