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

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

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

• InstallFileFormat.Drako: بسته FileFormat.Drako را از طریق NuGet Package Manager یا NET CLI نصب کنید.
• با پروژه خود ادغام کنید: به کتابخانه FileFormat.Drako در پروژه C# خود مراجعه کنید.
• شروع به تبدیل: از API ساده ارائه شده توسط FileFormat.Drako برای خواندن و نوشتن فایل های Draco استفاده کنید.

روش توصیه شده برای نصبFileFormat.Drako برای NET استفاده از NuGet است. لطفا از دستور زیر برای نصب راحت استفاده کنید.

NuGet> Install-PackageFileFormat.Drako 

خواندن فایل Draco به DracoMesh در سی شارپ

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

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

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

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

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

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

• فایل Draco با نام "input.drc" را با استفاده از File.ReadAllBytesباز کنید.
• مش Draco را از بایت ها در یک شی DracoMeshبارگیری کنید.
• ویژگی موقعیت را با استفاده از DracoMesh.GetNamedAttributeپیدا کنید و محتوای آن را به Span<float>تبدیل کنید.
• نقاط کنترل را با استفاده از قالب OBJ روی خروجی بنویسید.
• خواندن هر گوشه صورت با استفاده از DracoMesh.ReadFace
• گوشه‌های صورت را با استفاده از PointAttribute.MappedIndexبه نمایه نقاط کنترل نگاشت کنید.
• چهره ها را با استفاده از قالب OBJ در خروجی بنویسید.

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

 
    //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());

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

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

• یک نمونه 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+)
  };

  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 یک API بصری، پشتیبانی از فرمت جامع، و یکپارچه‌سازی یکپارچه با برنامه‌های C# ارائه می‌دهد که به توسعه‌دهندگان و کاربران امکان می‌دهد تا فایل‌های Draco را بدون زحمت مدیریت کنند. چه در حال تبدیل فایل‌های draco به فایل‌های دیگر باشید، چه در حال بارگیری draco برای رندر کردن، FileFormat.Drako این فرآیند را ساده می‌کند و کارایی و کیفیت مطلوب را در هر مرحله تضمین می‌کند.

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