تبسيط عملية قراءة وكتابة ملفات Google Draco باستخدام واجهة برمجة التطبيقات لجافا

كيفية البدء باستخدام FileFormat.Drako لجافا

تعتبر عملية البدء باستخدام FileFormat.Drako عملية سريعة وسهلة. ما عليك سوى اتباع الخطوات التالية:

• InstallFileFormat.Drako: قم بتثبيت حزمة FileFormat.Drako عبر Maven أو Gradle.
• بدء التحويل: استخدم واجهة برمجة التطبيقات البسيطة التي يوفرها FileFormat.Drako لقراءة ملفات Draco وكتابتها.

الطريقة الموصى بها لتثبيت FileFormat.Drako لـ Java هي استخدام maven. الرجاء استخدام مقتطف تبعية pom التالي للتثبيت السلس.

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

اقرأ ملف Draco في DracoMesh في Java

يقوم مقتطف التعليمات البرمجية هذا بتحميل ملف 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 في Java

يوضح التعليمة البرمجية التالية كيفية فتح ملف Draco ثلاثي الأبعاد موجود، والكتابة بتنسيق obj لمزيد من المعالجة:

• افتح ملف Draco المسمى "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 برمجيًا في Java

يوضح الكود المقدم كيفية إنشاء ملف Draco برمجيًا من نقاط التحكم والمثلثات، وحفظه باسم "output.drc" باستخدام Java. فيما يلي تفاصيل الخطوات:

• قم بإنشاء مثيل 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 واجهة برمجة تطبيقات بديهية، ودعمًا شاملاً للتنسيق، وتكاملًا سلسًا مع تطبيقات Java، مما يمكّن المطورين والمستخدمين على حدٍ سواء من إدارة ملفات Draco دون عناء. سواء كنت تقوم بتحويل ملفات draco إلى ملفات أخرى، أو تحميل draco للعرض، فإن FileFormat.Drako يبسط العملية، مما يضمن الكفاءة والجودة المثلى في كل خطوة.

استكشف مستودع GitHub الخاص بنا للمساهمة واقتراح التحسينات وتعزيز واجهة برمجة التطبيقات مفتوحة المصدر هذه: FileFormat.Drako- لجافا