Aspose.3D中的公共API变化2.1.0

Contents
[ ]

内容摘要

添加Collada文件的导出

使用此最新版本 (2.1.0)，开发人员可以导出Collada 3D文件。在以前的版本 (2.0.0) 中，我们已经添加了其导入功能，因为开发人员还可以将Collada文件转换为其他受支持的3D文件格式。

为3D文件格式添加加载和保存选项

我们为每种文件格式添加了加载和保存选项。它们是从原始的IOConfig子类重构的。

添加Aspose.ThreeD.Formats.Collaadasveoptions类

它定义保存Collada 3D文件时的设置。

C#

 ColladaSaveOptions opts = new ColladaSaveOptions();

// generates indented XML document

opts.Indented = true;

// the style of node transformation

opts.TransformStyle = ColladaTransformStyle.Matrix;

// configure the look up paths to allow importer to find external dependencies.

opts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.Discreet3dsloadopons类

它定义加载谨慎3DS文件时的设置。

C#

 Discreet3DSLoadOptions loadOpts = new Discreet3DSLoadOptions();

// sets weather to use the transformation defined in the first frame of animation track.

loadOpts.ApplyAnimationTransform = true;

// flip the coordinate system

loadOpts.FlipCoordinateSystem = true;

// prefer to use gamma-corrected color if a 3ds file provides both original color and gamma-corrected color.

loadOpts.GammaCorrectedColor = true;

// configure the look up paths to allow importer to find external dependencies.

loadOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.Discreet3DSSaveOptions类

它定义了保存谨慎3DS文件的设置。

C#

 // initialize an object

Discreet3DSSaveOptions saveOpts = new Discreet3DSSaveOptions();

// the start base for generating new name for duplicated names.

saveOpts.DuplicatedNameCounterBase = 2;

// the format of the duplicated counter.

saveOpts.DuplicatedNameCounterFormat = "NameFormat";

// the separator between object's name and the duplicated counter.

saveOpts.DuplicatedNameSeparator = "Separator";

// allows to export cameras

saveOpts.ExportCamera = true;

// allows to export light

saveOpts.ExportLight = true;

// flip the coordinate system

saveOpts.FlipCoordinateSystem = true;

// prefer to use gamma-corrected color if a 3ds file provides both original color and gamma-corrected color.

saveOpts.GammaCorrectedColor = true;

// use high-precise color which each color channel will use 32bit float.

saveOpts.HighPreciseColor = true;

// configure the look up paths to allow importer to find external dependencies.

saveOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

// set the master scale

saveOpts.MasterScale = 1;

添加Aspose.ThreeD.Formats.FBXSaveOptions类

它定义保存FBX文件时的设置。

C#

 // initialize an object

FBXSaveOptions saveOpts = new FBXSaveOptions(FileFormat.FBX7500ASCII);

// generates the legacy material properties.

saveOpts.ExportLegacyMaterialProperties = true;

// fold repeated curve data using FBX's animation reference count

saveOpts.FoldRepeatedCurveData = true;

// always generates material mapping information for geometries if the attached node contains materials.

saveOpts.GenerateVertexElementMaterial = true;

// configure the look up paths to allow importer to find external dependencies.

saveOpts.LookupPaths = new List< string > (new string[]{ @"c:\temp\" });

// generates a video object for texture.

saveOpts.VideoForTexture = true;

添加Aspose.ThreeD.Formats.Objloadopons类

它定义加载Obj文件时的设置。

C#

 // initialize an object

ObjLoadOptions loadObjOpts = new ObjLoadOptions();

// import materials from external material library file

loadObjOpts.EnableMaterials = true;

// flip the coordinate system.

loadObjOpts.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

loadObjOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.ObjSaveOptions类

它定义了保存Obj文件的设置。

C#

 // initialize an object

ObjSaveOptions saveObjOpts = new ObjSaveOptions();

// import materials from external material library file

saveObjOpts.EnableMaterials = true;

// flip the coordinate system.

saveObjOpts.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

saveObjOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

// serialize W component in model's vertex position

saveObjOpts.SerializeW = true;

// generate comments for each section

saveObjOpts.Verbose = true;

添加Aspose.ThreeD.Formats.Stlloadopons类

它定义加载STL文件时的设置。

C#

 // initialize an object

STLLoadOptions loadSTLOpts = new STLLoadOptions();

// flip the coordinate system.

loadSTLOpts.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

loadSTLOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.STLSaveOptions类

它定义保存STL文件时的设置。

C#

 // initialize an object

STLSaveOptions saveSTLOpts = new STLSaveOptions();

// flip the coordinate system.

saveSTLOpts.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

saveSTLOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.U3dloadoputions类

它定义加载U3D文件时的设置。

C#

 // initialize an object

U3DLoadOptions loadU3DOpts = new U3DLoadOptions();

// flip the coordinate system.

loadU3DOpts.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

loadU3DOpts.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

添加Aspose.ThreeD.Formats.U3DSaveOptions类

它定义保存U3D文件时的设置。

C#

 // initialize an object

U3DSaveOptions saveU3DOptions = new U3DSaveOptions();

// export normal data.

saveU3DOptions.ExportNormals = true;

// export the texture coordinates.

saveU3DOptions.ExportTextureCoordinates = true;

// export the vertex diffuse color.

saveU3DOptions.ExportVertexDiffuse = true;

// export vertex specular color

saveU3DOptions.ExportVertexSpecular = true;

// flip the coordinate system.

saveU3DOptions.FlipCoordinateSystem = true;

// configure the look up paths to allow importer to find external dependencies.

saveU3DOptions.LookupPaths = new List<string>(new string[]{ @"c:\temp\" });

// compress the mesh data

saveU3DOptions.MeshCompression = true;

将方法添加到Aspose.ThreeD.Scene类

我们在场景类中重载了打开和保存方法。开发人员可以通过流对象或直接文件名来使用各种加载/保存选项导入/导出3D文件。

C#

 public void Open(System.IO.Stream stream, Aspose.ThreeD.Formats.LoadOptions options);

public void Open(string fileName, Aspose.ThreeD.Formats.LoadOptions options);

public void Save(System.IO.Stream stream, Aspose.ThreeD.Formats.SaveOptions options);

public void Save(string fileName, Aspose.ThreeD.Formats.SaveOptions options);

从Aspose.ThreeD.Formats.FBXConfig类中删除FillDummyIndexArray属性

该属性没有被使用。

C#

 System.Nullable<Boolean> FillDummyIndexArray{ get;set;}

检测3D文件的类型

Aspose.ThreeD.FileFormat类的Detect方法可以识别任何受支持的3D文件的类型。

C#

 FileFormat inputFormat = FileFormat.Detect(@"C:\ThreeD\test06\colors.fbx");

Console.WriteLine("File Format: " + inputFormat.ToString());

在Aspose.ThreeD.FileFormat类中添加Detect、CreateLoadOptions和CreateSaveOptions方法

识别3D文件类型后，开发人员可以为进一步的操作任务创建LoadOptions和SaveOptions对象。

C#

 // allows to detect file format from file stream or filename

static Aspose.ThreeD.FileFormat Detect(System.IO.Stream stream, string fileName)

// allows to detect file format from filename

static Aspose.ThreeD.FileFormat Detect(string fileName)

// create default load options for this file format

Aspose.ThreeD.Formats.LoadOptions CreateLoadOptions()

// create default save options for this file format

Aspose.ThreeD.Formats.SaveOptions CreateSaveOptions()

将排除的属性添加到Aspose.ThreeD.Entity和Aspose.ThreeD.Node类

它允许在导出过程中删除实体。

C#

 bool Excluded{ get;set;}

添加Aspose.ThreeD.RenderState类和Aspose.ThreeD.Rendrendfactor/CompareFunction/CullFaceMode/FrontFace/PolygonMode/StencilAction/StencilState Enums

渲染状态为GPU提供了将三角形栅格化为像素的参数。

添加着色器api

Shader api定义了如何将三角形从世界空间转换到屏幕空间，并在GPU端计算最终的像素颜色。

添加抽象类Aspose.ThreeD.Render.ShaderSource和子类Aspose.ThreeD.Render.GLSLSource

GLSLSource告诉渲染器，源代码是针对OpenGL着色语言的，它可以被编译为Aspose.ThreeD.Render.ShaderProgram。

添加Aspose.ThreeD.Render.ShaderException类

着色器相关的异常，主要用于着色器语言编译和链接阶段。

添加Aspose.ThreeD.Render.ShaderProgram类

它是编译后的着色器程序。

添加Aspose.ThreeD.Render.ShaderVariable类

它定义了着色器中使用的变量。

添加枚举类Aspose.ThreeD.Render.VariableSemantic

它用于识别着色器变量的语义，Aspose.3D渲染器将根据语义自动准备着色器变量值。

添加缓冲区api

缓冲区提供三角形的定义和数据。

添加接口Aspose.ThreeD.Render.IBuffer

它是IIndexBuffer和IVertexBuffer的基本接口。

添加接口Aspose.ThreeD.Render.IIndexBuffer/IVertexBuffer

它们提供了用于存储几何索引的硬件缓冲区。

添加枚举Aspose.ThreeD.Render.IndexDataType

几何索引的数据类型。

添加渲染api

添加接口Aspose.ThreeD.Renderable.IRenderable

支持渲染的对象应该实现这个接口。

添加了枚举Aspose.ThreeD。渲染。绘制操作

要绘制的原始类型。

添加枚举Aspose.ThreeD。渲染。RenderQueueGroupId

Aspose.3D API使用渲染队列来管理渲染工作流，则用于将渲染操作提交到指定的渲染队列。

添加Aspose.ThreeD.RenderResource类

基类用于将Aspose.3D的模型API桥接到硬件资源，这在内部由Aspose.3D使用，但公开释放Aspose.3D渲染的全部功能。

添加Aspose.ThreeD.Renderablesource类

RenderResource的子类，但专注于渲染。

添加Aspose.ThreeD.Entities.ManualEntity类

用户应该使用这个类来实现自己支持渲染的实体，这个类封装了渲染操作和资源管理的细节。

在Aspose.ThreeD.Entities.PolygonModifier类中添加多个三角测量方法

更多重载，以简化原始函数的使用。

C#

 public static int[][]Triangulate(IList<[Aspose.ThreeD.Utilities.Vector4> controlPoints, IList<int[]> polygons);

public static int[][]Triangulate(IList<[Aspose.ThreeD.Utilities.Vector4> controlPoints, Int32[]polygon);

public static int[][]Triangulate(IList<Aspose.ThreeD.Utilities.Vector4> controlPoints);

在Aspose.ThreeD.RenderFactory类中添加CreateVertexBuffer、CreateIndexBuffer、CreateTextureUnit、CreateRenderState和createhaderprogram方法

C#

 public Aspose.ThreeD.Render.IVertexBuffer CreateVertexBuffer(Aspose.ThreeD.Utilities.VertexDeclaration declaration)

public Aspose.ThreeD.Render.IIndexBuffer CreateIndexBuffer()

public Aspose.ThreeD.Render.ITextureUnit CreateTextureUnit()

public Aspose.ThreeD.Render.RenderState CreateRenderState()

public Aspose.ThreeD.Render.ShaderProgram CreateShaderProgram(Aspose.ThreeD.Render.ShaderSource shaderSource, IList<Aspose.ThreeD.Utilities.VertexField> inputFields)

public Aspose.ThreeD.Render.ShaderProgram CreateShaderProgram(Aspose.ThreeD.Render.ShaderSource shaderSource, Aspose.ThreeD.Utilities.VertexDeclaration vertexDeclaration)

在Aspose.ThreeD.Render.Renderer类中添加BindRenderState、DrawIndexed、Draw和SubmitRenderTask方法

C#

 public void BindRenderState(Aspose.ThreeD.Render.RenderState renderState)

public void DrawIndexed(Aspose.ThreeD.Render.DrawOperation drawOperation, Aspose.ThreeD.Render.IVertexBuffer vertexBuffer, Aspose.ThreeD.Render.IIndexBuffer indexBuffer, Int32 count)

public void Draw(Aspose.ThreeD.Render.DrawOperation drawOperation, Aspose.ThreeD.Render.IVertexBuffer vertexBuffer, Int32 first, Int32 count)

public void Draw(Aspose.ThreeD.Render.DrawOperation drawOperation, Aspose.ThreeD.Render.IVertexBuffer vertexBuffer)

public void DrawIndexed(Aspose.ThreeD.Render.DrawOperation drawOperation, Aspose.ThreeD.Render.IVertexBuffer vertexBuffer, Aspose.ThreeD.Render.IIndexBuffer indexBuffer)

public void SubmitRenderTask(Aspose.ThreeD.Render.RenderQueueGroupId groupId, Int32 priority, Aspose.ThreeD.Render.IRenderable renderableTask)

在Aspose.ThreeD.Render.Renderer类中添加RenderStage和Shader属性

C#

 public RenderStage RenderStage { get; }

public Aspose.ThreeD.Render.ShaderProgram Shader{ get;set;}
Aspose.3D中的公共API变化2.0.0