SketchUp C API

- Main Page
- Related Pages
- Data Structures
- Files

- Data Structures
- Data Structure Index
- Class Hierarchy
- Data Fields

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Data Fields
SUMaterialPositionInput Struct Reference

SUMaterialInput contains information that is needed to apply a material to a face. More...

`#include <SketchUpAPI/model/geometry_input.h>`

## Data Fields
size_t | num_uv_coords
struct SUPoint2D | uv_coords [4]
| Texture coordinates.
struct SUPoint3D | points [4]
SUMaterialRef | material
| Material to be applied.
struct SUVector3D | projection

## Detailed Description

SUMaterialInput contains information that is needed to apply a material to a face.

The conventional method for applying a material to a face is to use 1 to 4 UV coordinates, which are Cartesian textures coordinates and corresponding 3D points on the face's plane. If the 3D points are not on the face's plane they will be projected onto it. Once the material input is used (e.g. with SUEntitiesFill()), the `material` object must not be released since it will be associated with a parent object.

Since
  SketchUp 2021.1, API 9.1

## Field Documentation

size_t SUMaterialPositionInput::num_uv_coords

      Number of texture coordinates. 0 if the material

should be applied using default UV coordinates. 1 to 4 otherwise.

struct SUPoint3D SUMaterialPositionInput::points[4]

3D point corresponding to the texture coordinates. The points should all lie on the plane of the face the material is applied to.

struct SUVector3D SUMaterialPositionInput::projection

Optional projection direction. Leave as invalid (0, 0, 0) for no projection.

The documentation for this struct was generated from the following file:

- SketchUpAPI/model/geometry_input.h