ساده‌سازی فرآیند خواندن و نوشتن فایل‌های Google Draco با استفاده از API جاوا

چگونه با FileFormat.Drako برای جاوا شروع کنیم

شروع با FileFormat.Drako سریع و آسان است. به سادگی این مراحل را دنبال کنید:

• InstallFileFormat.Drako: بسته FileFormat.Drako را از طریق Maven یا Gradle نصب کنید.
• شروع به تبدیل: از API ساده ارائه شده توسط FileFormat.Drako برای خواندن و نوشتن فایل های Draco استفاده کنید.

روش توصیه شده برای نصبFileFormat.Drako برای جاوا استفاده از maven است. لطفاً از قطعه وابستگی pom زیر برای نصب روان استفاده کنید.

<dependency>
  <groupId>org.openize</groupId>
  <artifactId>drako</artifactId>
  <version>1.4.0</version>
</dependency>
 

خواندن فایل Draco به DracoMesh در جاوا

این قطعه کد به طور موثر فایل Draco را بارگیری می کند و آن را در یک نمونه DracoMesh برای عملیات بعدی ذخیره می کند.

• فایل DRC با نام "cube.drc" را با استفاده از Files.readAllBytesباز کنید.
• مش سه بعدی را از بایت ها در یک شی DracoMeshبارگذاری کنید.

قطعه کد زیر را کپی و در فایل اصلی خود جایگذاری کنید و برنامه را اجرا کنید.

 
    byte[] cube = Files.readAllBytes(Paths.get("cube.drc"));
    DracoMesh dm = (DracoMesh)Draco.decode(cube);

فایل Draco را بخوانید و در Wavefront OBJ در جاوا بنویسید

کد زیر نحوه باز کردن فایل 3D Draco موجود و نوشتن در فرمت obj برای پردازش بیشتر را نشان می دهد:

• فایل دراکو با نام "input.drc" را با استفاده از Files.readAllBytesباز کنید.
• مش Draco را از بایت ها در یک شی DracoMeshبارگیری کنید.
• ویژگی موقعیت را با استفاده از DracoMesh.getNamedAttributeپیدا کنید و محتوای آن را به FloatSpanتبدیل کنید.
• نقاط کنترل را با استفاده از قالب OBJ روی خروجی بنویسید.
• خواندن هر گوشه صورت با استفاده از DracoMesh.readFace
• گوشه‌های صورت را با استفاده از PointAttribute.mappedIndexبه نمایه نقاط کنترل نگاشت کنید.
• چهره ها را با استفاده از قالب OBJ در خروجی بنویسید.

قطعه کد زیر را کپی و در فایل اصلی خود جایگذاری کنید و برنامه را اجرا کنید.

 
  //load draco file
  byte[] bytes = Files.readAllBytes(Paths.get("input.drc"));
  DracoMesh mesh = (DracoMesh)Draco.decode(bytes);
  if (mesh == null)
      throw new IllegalStateException("Input file is not a valid draco file.");
  PointAttribute attrPos = mesh.getNamedAttribute(AttributeType.POSITION);
  FloatSpan points = attrPos.getBuffer().asSpan().asFloatSpan();
  
  try(FileOutputStream fos = new FileOutputStream("output.obj", false)) {
      try (OutputStreamWriter writer = new OutputStreamWriter(fos)) {
          for (int i = 0; i < points.size(); i += 3) {
              writer.write(String.format("v %f %f %f\n", points.get(i), points.get(i + 1), points.get(i + 2)));
          }
          int[] face = new int[3];
          for (int i = 0; i < mesh.getNumFaces(); i++) {
              mesh.readFace(i, face);
              int a = attrPos.mappedIndex(face[0]) + 1;
              int b = attrPos.mappedIndex(face[1]) + 1;
              int c = attrPos.mappedIndex(face[2]) + 1;
              writer.write(String.format("f %d %d %d\n", a, b, c));
          }
      }
  }

کدگذاری نقاط کنترل، مثلث ها در فایل دراکو به صورت برنامه ریزی شده در جاوا

کد ارائه شده نشان می دهد که چگونه می توان به صورت برنامه ریزی شده یک فایل Draco را از نقاط کنترل و مثلث ها ایجاد کرد و آن را به عنوان "output.drc" با استفاده از جاوا ذخیره کرد. در اینجا خلاصه ای از مراحل است:

• یک نمونه DracoMeshایجاد کنید.
• نقاط کنترل را به PointAttributeبپیچید.
• PointAttributeرا به DracoMeshاضافه کنید.
• شاخص های مثلث را اضافه کنید.
• یک شی DracoEncodeOptionsبا پارامترهای رمزگذاری مشخص شده ایجاد کنید.
• مش را با استفاده از Draco.encodeبه بایت رمزگذاری کنید.

قطعه کد زیر را کپی و در فایل اصلی خود جایگذاری کنید و برنامه را اجرا کنید.

 
  Vector3[] controlPoints = new Vector3[]
  {
          new Vector3( -5, 0, 5.0f),
          new Vector3( 5, 0, 5.0f),
          new Vector3( 5, 10, 5.0f),
          new Vector3( -5, 10, 5.0f),
          new Vector3( -5, 0, -5.0f),
          new Vector3( 5, 0, -5.0f),
          new Vector3( 5, 10, -5.0f),
          new Vector3( -5, 10, -5.0f)
  };

  int[] indices = new int[]
  {
          0,1,2, 0, 2, 3, // Front face (Z+)
          1,5,6, 1, 6, 2, // Right side (X+)
          5,4,7, 5, 7, 6, // Back face (Z-)
          4,0,3, 4, 3, 7, // Left side (X-)
          0,4,5, 0, 5, 1, // Bottom face (Y-)
          3,2,6, 3, 6, 7 // Top face (Y+)
  };

  DracoMesh mesh = new DracoMesh();
  PointAttribute attrPos = PointAttribute.wrap(AttributeType.POSITION, controlPoints);
  mesh.addAttribute(attrPos);
  //add triangle indices
  mesh.getIndices().addRange(indices);
  //number of the control points, it's required for the encoder to produce correct result.
  mesh.setNumPoints(8);
  //You can also use following methods to deduplicate the attributes to reduce the file size
  //mesh.deduplicateAttributeValues();
  //mesh.deduplicatePointIds();
  DracoEncodeOptions opt = new DracoEncodeOptions();
  byte[] drcBytes = Draco.encode(mesh, opt);

  Files.write(Paths.get("output.drc"), drcBytes);

FileFormat.Drako یک API بصری، پشتیبانی از فرمت جامع، و یکپارچه‌سازی یکپارچه با برنامه‌های جاوا را ارائه می‌دهد که به توسعه‌دهندگان و کاربران امکان می‌دهد تا فایل‌های Draco را بدون زحمت مدیریت کنند. چه در حال تبدیل فایل‌های draco به فایل‌های دیگر باشید، چه در حال بارگیری draco برای رندر کردن، FileFormat.Drako این فرآیند را ساده می‌کند و کارایی و کیفیت مطلوب را در هر مرحله تضمین می‌کند.

مخزن GitHub ما را برای مشارکت، پیشنهاد بهبودها و بهبود این API منبع باز کاوش کنید: FileFormat.Drako- for-Java