Public API Changements dans Aspose.3D 2.0.0

Résumé du contenu

Ajoute le format Collada

Dans cette version (2.0.0), les développeurs peuvent importer des fichiers Collada 3D, de sorte que la propriété Collada est ajoutée dans la classe Aspose.ThreeD.FileFormat.

Ajoute les interfaces Aspose.ThreeD.Render.IRenderTarget/IRenderTexture/IRenderWindow/ITextureUnit et les classes Aspose.ThreeD.Render.Viewport/InitializationException/Renderer/TextureType/DriverException/RenderFactory/RenderParameters

Les nouvelles classes Viewport et Renderer sont les classes principales qui permettent de capturer les vues d’une scène 3D et de les enregistrer dans une texture ou une fenêtre. Tous les détails des autres classes d’aide sont les suivants:

  • Aspose.ThreeD.Render.DriverException classe-Les exceptions du moteur de rendu interne sont emballées comme DriverException.
  • Aspose.ThreeD.Render.InitializationException classe-Cette exception est levée sans initialiser le moteur de rendu, par exemple pour l’initialiser sur un ordinateur qui n’a pas de support matériel d’OpenGL 4.0.
  • Interface IRenderTarget-C’est l’interface de base d’IRenderTexture/IRenderWindow.
  • Interface IRenderTexture-Il permet de rendre la scène à une ou plusieurs textures (les textures sont situées dans la mémoire vidéo et peuvent être transférées à la mémoire système).
  • Interface de fenêtre IRender-Il permet de rendre la scène à la fenêtre en temps réel.
  • ItextureUnit interface-ItextureUnit est l’échantillonneur de texture du côté GPU et les données de texture dans la mémoire CPU ou GPU.
  • TextureType enum-Il définit le type de textures, comme Texture1D, Texture2D, Texture3D, CubeMap et Array2D.
  • Classe RenderFactory-Il aide à rendre une scène à des textures ou une fenêtre en temps réel.
  • Classe de RenderParamètres-Il définit les paramètres sur la façon de créer la cible de rendu comme les bits de couleur, les bits de profondeur, les bits de pochoir et la double mémoire tampon.

Capturer les Viewports d’une scène 3D et les rendre à une texture ou une fenêtre

C#

 // load an existing 3D scene

Scene scene = new Scene("scene.obj");

// create an instance of the camera

Camera camera = new Camera();

scene.RootNode.CreateChildNode("camera", camera).Transform.Translation = new Vector3(2, 44, 66);

// set the target

camera.LookAt = new Vector3(50, 12, 0);

//create a light

scene.RootNode.CreateChildNode("light", new Light() {Color = new Vector3(Color.White), LightType =  LightType.Point}).Transform.Translation = new Vector3(26, 57, 43);

// the CreateRenderer will create a hardware OpenGL-backend renderer

// and some internal initializations will be done.

// when the renderer left using the scope, the unmanaged hardware resources will also be disposed

using (var renderer = Renderer.CreateRenderer())

{

    renderer.EnableShadows = false;

    // create a new render target that renders the scene to texture(s)

    // use default render parameters

    // and one output targets

    // size is 1024 x 1024

    // this render target can have multiple render output textures, but here we only need one output.

    // The other textures and depth textures are mainly used by deferred shading in the future.

    // but you can also access the depth texture through IRenderTexture.DepthTeture

    // use CreateRenderWindow method to render in window, like:

    // window = renderer.RenderFactory.CreateRenderWindow(new RenderParameters(), Handle);

    using (IRenderTexture rt = renderer.RenderFactory.CreateRenderTexture(new RenderParameters(), 1, 1024, 1024))

    {

        //this render target has one viewport to render, the viewport occupies the 100% width and 100% height

        Viewport vp = rt.CreateViewport(camera, new RelativeRectangle() {ScaleWidth = 1, ScaleHeight = 1});

        //render the target and save the target texture to external file

        renderer.Render(rt);

        rt.Targets[0].Save("file-1viewports.png", ImageFormat.Png);

        //now let's change the previous viewport only uses the half left side(50% width and 100% height)

        vp.Area = new RelativeRectangle() {ScaleWidth = 0.5f, ScaleHeight = 1};

        //and create a new viewport that occupies the 50% width and 100% height and starts from 50%

        //both of them are using the same camera, so the rendered content should be the same

        rt.CreateViewport(camera, new RelativeRectangle() {ScaleX = 0.5f, ScaleWidth = 0.5f, ScaleHeight = 1});

        //but this time let's increase the field of view of the camera to 90 degree so it can see more part of the scene

        camera.FieldOfView = 90;

        renderer.Render(rt);

        rt.Targets[0].Save("file-2viewports.png", ImageFormat.Png);

    }

}

Ajoute Aspose.ThreeD.Render.PostProcessing classe

La classe PostProcessing permet aux développeurs d’appliquer un filtre de traitement d’image en temps réel à l’image rendue. Dans cette version 2.0.0, nous avons fourni 4 effets de post-traitement intégrés. Nous autoriserons les développeurs à avoir leur propre algorithme de post-traitement personnalisé dans la future version.

Appliquer des effets visuels sur les vues de Saving 3D

C#

 // load an existing 3D scene

Scene scene = new Scene("scene.obj");

// create an instance of the camera

Camera camera = new Camera();

scene.RootNode.CreateChildNode("camera", camera).Transform.Translation = new Vector3(2, 44, 66);

// set the target

camera.LookAt = new Vector3(50, 12, 0);

//create a light

scene.RootNode.CreateChildNode("light", new Light() { Color = new Vector3(Color.White), LightType = LightType.Point }).Transform.Translation = new Vector3(26, 57, 43);

// the CreateRenderer will create a hardware OpenGL-backend renderer, more renderer will be added in the future

// and some internal initializations will be done.

// when the renderer left using the scope, the unmanaged hardware resources will also be disposed

using (var renderer = Renderer.CreateRenderer())

{

    renderer.EnableShadows = false;

    // create a new render target that renders the scene to texture(s)

    // use default render parameters

    // and one output targets

    // size is 1024 x 1024

    // this render target can have multiple render output textures, but here we only need one output.

    // The other textures and depth textures are mainly used by deferred shading in the future.

    // but you can also access the depth texture through IRenderTexture.DepthTeture

    using (IRenderTexture rt = renderer.RenderFactory.CreateRenderTexture(new RenderParameters(), 1, 1024, 1024))

    {

        // this render target has one viewport to render, the viewport occupies the 100% width and 100% height

        Viewport vp = rt.CreateViewport(camera, new RelativeRectangle() { ScaleWidth = 1, ScaleHeight = 1 });

        //render the target and save the target texture to external file

        renderer.Render(rt);

        rt.Targets[0].Save("Original_viewport.png", ImageFormat.Png);

        // create a post-processing effect

        PostProcessing pixelation = renderer.GetPostProcessing("pixelation");

        renderer.PostProcessings.Add(pixelation);

        renderer.Render(rt);

        rt.Targets[0].Save("VisualEffect_pixelation.png", ImageFormat.Png);

        //clear previous post-processing effects and try another one

        PostProcessing grayscale = renderer.GetPostProcessing("grayscale");

        renderer.PostProcessings.Clear();

        renderer.PostProcessings.Add(grayscale);

        renderer.Render(rt);

        rt.Targets[0].Save("VisualEffect_grayscale.png", ImageFormat.Png);

        //we can also combine post-processing effects

        renderer.PostProcessings.Clear();

        renderer.PostProcessings.Add(grayscale);

        renderer.PostProcessings.Add(pixelation);

        renderer.Render(rt);

        rt.Targets[0].Save("VisualEffect_grayscale+pixelation.png", ImageFormat.Png);

        //clear previous post-processing effects and try another one

        PostProcessing edgedetection = renderer.GetPostProcessing("edge-detection");

        renderer.PostProcessings.Clear();

        renderer.PostProcessings.Add(edgedetection);

        renderer.Render(rt);

        rt.Targets[0].Save("VisualEffect_edgedetection.png", ImageFormat.Png);

        //clear previous post-processing effects and try another one

        PostProcessing blur = renderer.GetPostProcessing("blur");

        renderer.PostProcessings.Clear();

        renderer.PostProcessings.Add(blur);

        renderer.Render(rt);

        rt.Targets[0].Save("VisualEffect_blur.png", ImageFormat.Png);

    }

}

Ajoute la méthode GetBoundingBox à la classe Aspose.ThreeD.Node, Ajoute de nouvelles classes Aspose.ThreeD.Utilities.BoundingBox et Aspose.ThreeD.Utilities.BoundingBoxExtent

Les classes BoundingBox et BoundingBoxExtent représentent la boîte de délimitation d’un nœud 3D. Les développeurs peuvent réinitialiser la caméra et calculer l’altitude à partir de la boîte de délimitation. La boîte de délimitation infinie ou nulle signifie que la scène n’a pas de géométries et n’ajuste l’élévation de la caméra que lorsqu’elle est finie.

Rendu en temps réel

Il permet aux développeurs d’effectuer un rendu en temps réel haute performance sur un framework GUI comme WinForms, il est indépendant du cadre GUI, donc les autres frameworks GUI devraient également prendre en charge cela.

Les méthodes AddData sont ajoutées à la classe Aspose.ThreeD.Entities.VertexElementUV

La classe de base du VertexElementUV a changé de VertexElementTemplateÀ VertexElementTemplate, Il ne stockera Vector4 que depuis 2.0.0, donc deux méthodes d’assistance ont été ajoutées pour permettre à l’utilisateur d’ajouter une liste de Vector2 et Vector3 à VertexElementUV, il étendra en interne Vector2/Vector3 à Vector4 et laissera les champs de repos zéro:

Public API Changements dans Aspose.3D 2.1.0