7.1. Creating Textured Objects

What Is a Texture Map?

SoTexture2⁽^C++^\|^Java^\|^.NET⁾	specifies a 2D texture map to be used and associated parameters for texture mapping.
SoTextureCoordinate2⁽^C++^\|^Java^\|^.NET⁾	explicitly defines the set of 2D texture coordinates to be used by subsequent vertex shapes.
SoTextureCoordinateBinding⁽^C++^\|^Java^\|^.NET⁾	specifies how the current texture coordinates are to be bound to subsequent shape nodes.
SoTextureCoordinatePlane⁽^C++^\|^Java^\|^.NET⁾	SoTextureCoordinateEnvironment⁽^C++^\|^Java^\|^.NET⁾ allow you to use a function to map from spatial coordinates to texture coordinates.
SoTextureCoordinateDefault⁽^C++^\|^Java^\|^.NET⁾	turns off any previous texture-coordinate function so that all following shapes use their default texture coordinates.
SoTexture2Transform⁽^C++^\|^Java^\|^.NET⁾	defines a 2D transformation for the texture map. Figure 7.2. Texture Coordinates

The SoComplexity⁽^C++^|^Java^|^.NET⁾ node has a textureQuality field that relates to texture mapping as well. It allows you to specify a value between 0.0 and 1.0, with 0.0 for the fastest rendering and 1.0 for the finest texturing. (In general, there is a trade-off between speed and the quality of texturing.) The default value for this field is 0.5.

Using the Defaults

Although you can affect how a texture is applied to an object in many ways, the simplest way to use textures is to use the default values. If you use textures, you need only an SoTexture2⁽^C++^|^Java^|^.NET⁾ node (for the texture) and a shape node (the target object). Example 7.1, “ Using the Default Texture Values ”, which displays a textured cube, illustrates this method. See Section 7.3, “Texture Nodes” for a detailed description of the SoTexture2⁽^C++^|^Java^|^.NET⁾ node and its defaults.

Example 7.1. Using the Default Texture Values

C++

#include <Inventor/Xt/SoXt.h>
#include <Inventor/Xt/viewers/SoXtExaminerViewer.h>
#include <Inventor/nodes/SoCube.h>
#include <Inventor/nodes/SoSeparator.h>
#include <Inventor/nodes/SoTexture2.h>

main(int , char **argv)
{
   Widget myWindow = SoXt::init(argv[0]);
   if(myWindow == NULL) exit(1);

   SoSeparator *root = new SoSeparator;
   root->ref();

   // Choose a texture 
   SoTexture2 *rock = new SoTexture2;
   root->addChild(rock);
   rock->filename.setValue("brick.1.rgb");

   // Make a cube
   root->addChild(new SoCube);

   SoXtExaminerViewer *myViewer = 
            new SoXtExaminerViewer(myWindow);
   myViewer->setSceneGraph(root);
   myViewer->setTitle("Default Texture Coords");
   myViewer->show();
   
   SoXt::show(myWindow);
   SoXt::mainLoop();
}

.NET

using System.Windows.Forms;

using OIV.Inventor.Nodes;
using OIV.Inventor.Win.Viewers;

namespace _07_1_BasicTexture
{
  public partial class MainForm : Form
  {
    SoWinExaminerViewer myViewer;

    public MainForm()
    {
      InitializeComponent();
      CreateSample();
    }

    public void CreateSample()
    {
      SoSeparator root = new SoSeparator();

      // Choose a texture 
      SoTexture2 rock = new SoTexture2();
      root.AddChild(rock);
      rock.filename.Value = "../../../../../data/brick.1.png";

      // Make a cube
      root.AddChild(new SoCube());

      myViewer = new SoWinExaminerViewer(this, "", true,
          SoWinFullViewer.BuildFlags.BUILD_ALL, SoWinViewer.Types.BROWSER);
      myViewer.SetSceneGraph(root);
      myViewer.SetTitle("Default Texture Coords");

      // In Inventor 2.1, if the machine does not have hardware texture
      // mapping, we must override the default drawStyle to display textures.
      myViewer.SetDrawStyle(SoWinViewer.DrawTypes.STILL, SoWinViewer.DrawStyles.VIEW_AS_IS);
    }
  }
}

Java

import tools.*;

import com.openinventor.inventor.nodes.*;
import com.openinventor.inventor.awt.*;
import com.openinventor.util.Scene;

import java.awt.*;

public class Main extends DemoInventor
{

  public static void main(String[] args)
  {
    Main applet = new Main();
    applet.isAnApplet = false;
    applet.start();
    demoMain(applet, "Basic Texture");
  }

  public void start()
  {
    super.start();

    // Choose a texture
    SoTexture2 rock = new SoTexture2();
    rock.filename.setValue(m_prefix + "../../../../data/textures/rgb/brick.1.rgb");

    SoSeparator root = new SoSeparator();
    { // Assemble scene graph
      root.addChild(rock);
      // Make a cube
      root.addChild(new SoCube());
    }

    SwSimpleViewer myViewer = new SwSimpleViewer();
    myViewer.setSceneGraph(root);

    // In Inventor 2.1, if the machine does not have hardware texture
    // mapping, we must override the default drawStyle to display textures.
    myViewer.getArea().setDrawStyle(SwActiveArea.STILL, Scene.DrawStyle.VIEW_AS_IS);

    setLayout(new BorderLayout());
    add(myViewer, BorderLayout.CENTER);
  }
}


	Tip: If several nodes use the same texture, position the texture node so that it can be used by all the nodes. When possible, group nodes to share textures first, then to share materials, because it is expensive to switch textures.

Prev	Up	Next
Chapter 7. Textures	Home	7.2. Key Concepts

7.1. Creating Textured Objects

What Is a Texture Map?

2D Texture

3D Texture

Cube Map Texture

Nodes Used for Texture Mapping

Using the Defaults