شروع کرنا

Chillin Render API آپ کو ویڈیو مواد اور پیرامیٹرز کو بیان کرنے کی اجازت دیتا ہے جو کہ نیچے دی گئی JSON ساخت کو بیان کرکے رینڈر کیا جائے گا۔

  • Render Console پر جائیں تاکہ Render API کریڈٹس حاصل کریں اور اپنا Render API کلید بنائیں

  • اپنے API کلید کے ساتھ Render API کے اینڈپوائنٹ پر ایک POST درخواست بھیجیں:

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 غیر ہم وقتی موڈ میں کام کرتا ہے اور اس طرح کا جواب واپس کرتا ہے:

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

بنیادی تصورات

تمام JSON اشیاء میں ایک ویڈیو پروجیکٹ کی شے شامل ہوتی ہے، جو ویڈیو کی مجموعی چوڑائی، مجموعی اونچائی، اور قرارداد کی وضاحت کرتی ہے۔

پروجیکٹ کی شے ویڈیو کو رینڈر کرنے کے بنیادی پیرامیٹرز پر مشتمل ہوتی ہے، جیسے کہ چوڑائی، اونچائی، دورانیہ، پس منظر کا رنگ، اور مزید۔

پروجیکٹ میں ایک یا زیادہ عناصر بھی شامل ہیں، جہاں ہر عنصر ایک ویڈیو کمپوننٹ کی نمائندگی کرتا ہے، جیسے ویڈیو، تصویر، متن، شکل، آڈیو، یا اثر۔

ہر عنصر میں کمپوننٹ کے لیے مخصوص پیرامیٹرز شامل ہوتے ہیں، جیسے کہ جگہ، سائز، رنگ، مواد، وغیرہ۔

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

3D جگہ اور کیمرہ

رینڈرنگ انجن 2D اور 3D عناصر دونوں کی حمایت کرتا ہے۔ جبکہ کینوس کو width اور height میں پکسلز کے ساتھ بیان کیا جاتا ہے، انجن 3D رینڈرنگ کے لیے ایک منظر کیمرہ استعمال کرتا ہے:

  • ہم آہنگی کا نظام: x اور y ہم آہنگیاں 2D کینوس کے طیارے پر جگہوں کی نمائندگی کرتی ہیں۔ z ہم آہنگی 3D جگہ میں گہرائی کو کنٹرول کرتی ہے۔
  • پکسل-پرفیکٹ پروجیکشن: z=0 پر، ایک دنیا کی اکائی ایک پکسل کے برابر ہے، جو 2D ورک فلو کے ساتھ ہم آہنگی برقرار رکھتا ہے۔
  • 3D گھماؤ: عناصر کو rotationX، rotationY، اور rotation (Z-axis) خصوصیات کا استعمال کرتے ہوئے X، Y، اور Z محور کے گرد گھمایا جا سکتا ہے۔

یہ ڈیزائن ایک ہی پروجیکٹ میں 2D اور 3D عناصر کے ہموار مرکب کی اجازت دیتا ہے۔ روایتی 2D عناصر (z=0 کے ساتھ) پہلے کی طرح درست رینڈر کرتے ہیں، جبکہ 3D عناصر کو تین جہتی جگہ میں رکھا اور گھمایا جا سکتا ہے۔

3D عنصر کی مثال

یہاں ایک سادہ 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

2D عناصر سے کلیدی اختلافات:

  • type: "3D" اسے 3D عنصر کے طور پر شناخت کرتا ہے
  • z، rotationX، rotationY، اور scaleZ 3D تبدیلیوں کو فعال کرتے ہیں
  • geometryType 3D شکل (مکعب، کرہ، سلنڈر، وغیرہ) کی وضاحت کرتا ہے
  • geometryColor 3D جیومیٹری کا بنیادی رنگ طے کرتا ہے

3D عناصر کی مزید تفصیلات کے لیے، 3D Element دستاویزات دیکھیں۔

JSON سکیمہ

آپ کی درخواست JSON کو اس دستاویز میں بیان کردہ JSON سکیمہ کے مطابق ہونا چاہیے۔ آپ Chillin Video Editor میں متعلقہ درخواست JSON کو جانچ اور تیار کر سکتے ہیں۔