Đơn giản hóa quy trình đọc và ghi tệp Google Draco bằng API .NET

Cách bắt đầu vớiFileFormat.Drako cho .NET

Bắt đầu vớiFileFormat.Drako thật nhanh chóng và dễ dàng. Chỉ cần làm theo các bước sau:

• InstallFileFormat.Drako: Cài đặt gói FileFormat.Drako thông qua Trình quản lý gói NuGet hoặc .NET CLI.
• Tích hợp với dự án của bạn: Tham khảo thư viện FileFormat.Drako trong dự án C# của bạn.
• Bắt đầu chuyển đổi: Sử dụng API đơn giản doFileFormat.Drako cung cấp để đọc và ghi các tệp Draco.

Cách cài đặtFileFormat.Drako cho .NET được khuyến nghị là sử dụng NuGet. Vui lòng sử dụng lệnh sau để cài đặt suôn sẻ.

NuGet> Install-PackageFileFormat.Drako 

Đọc tệp Draco vào DracoMesh trong C#

Đoạn mã này tải tệp Draco một cách hiệu quả và lưu trữ tệp đó trong phiên bản DracoMesh cho các hoạt động tiếp theo.

• Mở tệp DRC có tên "cube.drc" bằng cách sử dụng File.ReadAllBytes.
• Tải lưới 3D từ các byte vào đối tượng DracoMesh.

Sao chép và dán đoạn mã bên dưới vào tệp chính của bạn và thực thi chương trình.

 
    byte[] cube = File.ReadAllBytes("cube.drc");
    DracoMesh dm = (DracoMesh)Draco.Decode(cube);

Đọc tệp Draco và ghi vào Wavefront OBJ trong C#

Đoạn mã sau minh họa cách mở tệp 3D Draco hiện có và ghi sang định dạng obj để xử lý thêm:

• Mở tệp tệp Draco có tên "input.drc" bằng cách sử dụng File.ReadAllBytes.
• Tải lưới Draco từ các byte vào đối tượng DracoMesh.
• Tìm thuộc tính vị trí bằng cách sử dụng DracoMesh.GetNamedAttributionvà chuyển nội dung của nó thành Span<float>.
• Ghi các điểm kiểm soát vào đầu ra bằng định dạng của OBJ.
• Đọc từng góc mặt bằng DracoMesh.ReadFace
• Ánh xạ các góc mặt tới chỉ mục của các điểm kiểm soát bằng cách sử dụng PointAttribution.MappedIndex.
• Ghi khuôn mặt vào đầu ra bằng định dạng của OBJ.

Sao chép và dán đoạn mã bên dưới vào tệp chính của bạn và thực thi chương trình.

 
    //load draco file
    var bytes = File.ReadAllBytes("input.drc");
    var mesh = Draco.Decode(bytes) as DracoMesh;
    if (mesh == null)
        throw new InvalidDataException("Input file is not a valid draco file.");
    var attrPos = mesh.GetNamedAttribute(AttributeType.Position);
    var points = MemoryMarshal.Cast(attrPos.Buffer.AsSpan());
    var sb = new StringBuilder();
    for (int i = 0; i < points.Length; i += 3)
    {
        sb.AppendLine($"v {points[i]} {points[i + 1]} {points[i + 2]}");
    }
    Span face = stackalloc int[3];
    for (int i = 0; i < mesh.NumFaces; i++)
    {
        mesh.ReadFace(i, face);
        var a = attrPos.MappedIndex(face[0]) + 1;
        var b = attrPos.MappedIndex(face[1]) + 1;
        var c = attrPos.MappedIndex(face[2]) + 1;
        sb.AppendLine($"f {a} {b} {c}");
    }
    File.WriteAllText("output.obj", sb.ToString());

Mã hóa các điểm kiểm soát, hình tam giác thành tệp Draco theo lập trình trong C#

Mã được cung cấp minh họa cách tạo tệp Draco theo chương trình từ các điểm kiểm soát và hình tam giác, đồng thời lưu tệp đó dưới dạng "output.drc" bằng C#. Dưới đây là bảng phân tích các bước:

• Tạo một phiên bản DracoMesh.
• Gói các điểm kiểm soát thành PointAttribution.
• Thêm PointAttributionvào DracoMesh.
• Thêm chỉ số tam giác.
• Tạo đối tượng DracoEncodeOptionsvới các tham số mã hóa được chỉ định.
• Mã hóa lưới thành byte bằng Draco.Encode.

Sao chép và dán đoạn mã bên dưới vào tệp chính của bạn và thực thi chương trình.

 
  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+)
  };

  var mesh = new DracoMesh();
  //construct an attribute for position, with type float[3], 
  var attrPos = PointAttribute.Wrap(AttributeType.Position, controlPoints);
  mesh.AddAttribute(attrPos);
  //add triangle indices
  mesh.Indices.AddRange(indices);
  //number of the control points, it's required for the encoder to produce correct result.
  mesh.NumPoints = 8;
  //You can also use following methods to deduplicate the attributes to reduce the file size
  //mesh.DeduplicateAttributeValues();
  //mesh.DeduplicatePointIds();

  var opt = new DracoEncodeOptions();
  var drcBytes = Draco.Encode(mesh, opt);
  File.WriteAllBytes("output.drc", drcBytes);

FileFormat.Drako cung cấp API trực quan, hỗ trợ định dạng toàn diện và tích hợp liền mạch với các ứng dụng C#, trao quyền cho các nhà phát triển cũng như người dùng quản lý các tệp Draco một cách dễ dàng. Cho dù bạn đang chuyển đổi tệp draco sang tệp khác hay tải draco để kết xuất, FileFormat.Drako đều đơn giản hóa quy trình, đảm bảo hiệu quả và chất lượng tối ưu ở mọi bước.

Khám phá kho lưu trữ GitHub của chúng tôi để đóng góp, đề xuất cải tiến và nâng cao API nguồn mở này: FileFormat.Drako -for-.NET