تصور کنید که یک صحنه 3D کاملاً تعاملی را مستقیماً در یک صفحه وب بدون هیچ افزونه یا کد پایه WebGL جاسازی کنید، فقط HTML تمیزی که بلافاصله کار می‌کند. می‌توانید به سادگی این کار را با Aspose.3D for Java انجام دهید.

اگر در حال ساخت یک پیکربند محصول، یک مرور معماری یا یک ابزار تجسم داده‌ها هستید، تبدیل صحنه‌های 3D به HTML دسترسی کاربران شما را به سطح جدیدی می‌رساند. در این راهنما، گام به گام نحوه انجام این کار را از بارگذاری یک صحنه 3D تا پیکربندی گزینه‌های خروجی و تولید خروجی سبک وزن HTML که آماده قرارگیری در هر صفحه وب است، مرور می‌کنیم.

در پایان، یک قطعه کد تمیز و قابل استفاده مجدد خواهید داشت که می‌توانید آن را مستقیماً در پروژهٔ جاوا خود قرار دهید و امروز شروع به ارائه تجربه‌های تعاملی سه‌بعدی در وب کنید.

چرا از Aspose.3D برای تبدیل یک صحنه 3D به HTML استفاده کنیم

Aspose.3D for Java یک SDK قدرتمند است که به توسعه‌دهندگان جاوا امکان می‌دهد مدل‌های 3D را به‌صورت برنامه‌نویسی ایجاد، ویرایش و رندر کنند. این SDK کارهای سنگین را بر عهده می‌گیرد و خروجی HTML5 سبک‌وزنی تولید می‌کند که به‌راحتی در هر صفحه وب جاسازی می‌شود. Aspose.3D یک صحنه 3D را به صفحه HTML5 تعاملی با استفاده از WebGL برای گرافیک زمان واقعی رندر می‌کند و HTML تولید شده به‌طور کامل خودکفا است و تمام JavaScript، شیدرها و داده‌های بافت مورد نیاز را به‌صورت پیش‌فرض در خود دارد.

پیش‌نیازها و راه‌اندازی

برای دنبال کردن این آموزش، به موارد زیر نیاز دارید:

  • Java Development Kit (JDK) 8 یا بالاتر.
  • Maven 3.5+ برای مدیریت وابستگی‌ها.
  • یک IDE مانند IntelliJ IDEA یا Eclipse.

جدیدترین Aspose.3D SDK را از نسخه‌ها دانلود کنید.

SDK را به فایل pom.xml Maven خود اضافه کنید:

<repositories>
    <repository>
        <id>AsposeJavaAPI</id>
        <name>Aspose Java API</name>
        <url>https://repository.aspose.com/repo/</url>
    </repository>
</repositories>

پس از افزودن وابستگی، پروژه Maven خود را تازه کنید تا کتابخانه به مخزن محلی شما دانلود شود.

نحوه تبدیل یک صحنه 3D به HTML در جاوا

SDK کلاس Html5SaveOptions را فراهم می‌کند که به شما امکان پیکربندی نحوه خروجی صحنه 3D به HTML5 را می‌دهد. این کلاس از کلاس SaveOptions ارث می‌برد و چندین تنظیم خاص HTML5 را برای کنترل نمایشگر خروجی و رفتار رندرینگ ارائه می‌کند. با استفاده از این کلاس، می‌توانید شبکه را نشان یا مخفی کنید، رابط کاربری را روشن یا خاموش کنید، جعبه جهت‌گیری را پیکربندی کنید، خط‌کش‌های محور را نمایش دهید و ویژگی‌های دوربین مانند موقعیت، میدان دید، صفحه نزدیک و صفحه دور را تنظیم کنید. همچنین از خروجی بافت‌ها و تنظیم رمزگذاری متن برای خروجی پشتیبانی می‌کند. این گزینه‌ها به سفارشی‌سازی صحنه HTML5 تولید شده برای نیازهای مختلف نمایش و ارائه کمک می‌کند.

مراحل تبدیل صحنه 3D به HTML

  1. Add the Aspose.3D SDK to your project: از مختصات Maven نشان داده شده در بخش پیش‌نیازها استفاده کنید.
  2. Load the 3D scene: یک شیء کلاس Scene ایجاد کنید و متد open() را با مسیر فایل منبع فراخوانی کنید.
  3. Create and configure Html5SaveOptions: برای نمایش یک شبکه یا نشان دادن رابط کاربری در صحنه تنظیم کنید.
  4. Save the Scene: متد save() را بر روی نمونه کلاس Scene فراخوانی کنید و نام فایل خروجی HTML را همراه با گزینه‌های پیکربندی شده پاس دهید.

فایل HTML تولید شده را در مرورگر باز کنید: اطمینان حاصل کنید که مدل به‌درستی رندر می‌شود و همان‌طور که انتظار می‌رود تعامل می‌کند.

برای اطلاعات دقیق API، به مستندات کلاس Scene و به مرجع Html5SaveOptions مراجعه کنید.

تبدیل یک صحنه 3D به HTML - مثال کامل کد

مثال زیر یک تبدیل کامل انتها‑به‑انتها از یک فایل OBJ به یک صفحه HTML تعاملی را نشان می‌دهد.

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (sample.obj, sample.html) را به مکان‌های واقعی خود به‌روز کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

نتیجه‌گیری

شما اکنون یاد گرفته‌اید که چگونه یک صحنه 3D را به HTML در جاوا با استفاده از Aspose.3D for Java SDK تبدیل کنید، از تنظیم پروژه تا تولید یک صفحه HTML5 کاملاً تعاملی. این قابلیت به شما امکان می‌دهد تجسم‌های 3D غنی را به‌صورت مستقیم در برنامه‌های وب بدون نیاز به افزونه‌های خارجی جاسازی کنید. برای استقرارهای تولیدی، یک لایسنس مناسب را از صفحهٔ صفحه قیمت‌گذاری دریافت کنید یا از لایسنس موقت موجود در صفحهٔ صفحه لایسنس موقت استفاده کنید. ویژگی‌های پیشرفته‌تری مانند شیدرهای سفارشی و پشتیبانی از انیمیشن را در مستندات گسترده SDK بررسی کنید.

FAQs

آیا می‌توانم یک صحنه 3D را به HTML در جاوا تبدیل کنم بدون نصب SDK؟
خیر. تبدیل نیاز به Aspose.3D for Java SDK دارد که باید بر روی ماشین توسعه یا سرور شما نصب شود. SDK کلاس‌ها و موتور رندرینگ لازم را فراهم می‌کند.

کدام فرمت‌های ورودی برای تبدیل به HTML پشتیبانی می‌شوند؟
Aspose.3D از OBJ، STL، FBX، 3DS، GLTF، و بسیاری از فرمت‌های رایج 3D دیگر پشتیبانی می‌کند. برای مشاهده فهرست کامل به مستندات مراجعه کنید.

چگونه می‌توانم ظاهر صفحه HTML تولید شده را سفارشی کنم؟
می‌توانید نورپردازی، کنترل‌های دوربین و رنگ پس‌زمینه را از طریق Html5SaveOptions تغییر دهید. برای سفارشی‌سازی عمیق‌تر، پس از تولید HTML، JavaScript سفارشی یا CSS را تزریق کنید.

آیا فایل HTML تولید شده برای مرورگرهای موبایل مناسب است؟
بله. خروجی از اندازه‌گیری واکنش‌گرا بوم و WebGL استفاده می‌کند که در مرورگرهای مدرن موبایل که از WebGL پشتیبانی می‌کنند، کار می‌کند. برای نمایش بهینه در موبایل، ابعاد بوم را در Html5SaveOptions تنظیم کنید.

بیشتر بخوانید