UV Mapping Tool

Koru needs meshes to have texture mapping in order to apply textures to them. Sometimes models don’t have that mapping or have incorrect one. The UV Mapping tool helps you generate or correct the mapping, if necessary.

We’ll start with a koru model with incorrect texture mapping and a sample checkers texture applied:

Koru with a koru model

As you may see, texture mapping is not perfect, as the front face doesn’t look mapped at all. Let’s fix it with UV Mapping tool. To do so, click the Tools -> Generate UV Mapping in the menu, or click the UV Mapping tool button in the toolbar. The UV Mapping generator window will pop up:

UV Mapping generator in Koru

Note that the mapping in background becomes better. Here’s what you can configure:

  • Mapping - defines the mapping type (see below);
  • Fit to - lets you choose how to fit mapping: by using mesh (geometry), node, selection or the whole scene;
  • Flip U/V - lets you flip the generated mapping horizontally, vertically or both.
  • Normalize - normalizes the box Koru uses for UV calculations. This helps to evenly distribute the mapping;
  • Scale - lets you scale the bounding box used to calculate mapping. Again, this helps to apply a better mapping especially in “box” mode;
  • Repeat - lets you tile the applied UV coordinates.

Koru supports 4 standard mapping types: Box, Planar, Cylindrical and Spherical. For all the types (except the Box one) you can choose the main axis. For instance by selecting “Spherical Z” you choose the spherical mapping along the Z axis.