# VertexTextureCoordinates

is an option for graphics primitives that specifies the texture coordinates to assign to vertices.

# Details  • VertexTextureCoordinates can be used with various primitives that defined filled shapes, including Polygon, FilledCurve, and GraphicsComplex.
• VertexTextureCoordinates->{t1,t2,} specifies that coordinate ti should be assigned to vertex i.
• The texture coordinates ti for each vertex can have the following forms:
•  {u} 1D coordinates {u,v} 2D coordinates {u,v,w} 3D coordinates
• The texture coordinates u, v, and w are assumed to range from 0 to 1.
• Coordinates outside the range 0 to 1 are taken be periodic and equivalent to Mod[u,1] etc.
• VertexTextureCoordinates->{{t1,t2,},{u1,u2,},} specifies lists of coordinates that should be mapped to the corresponding shapes of a multi-shape specification.
• VertexTextureCoordinatesAutomatic textures a 2D primitive relative to its axis-aligned bounding box.
• Textures are taken to be arrays of colors.
• Texture coordinates follow the same convention as position numbers.
• For a particular dimension the texture coordinate 0 corresponds to the smallest position and texture coordinate 1 corresponds to the largest position.
• For a 1D texture, coordinates correspond to:
•  {0} position 1, first element {1} position -1, last element
• For a 2D texture, coordinates correspond to:
•  {0,0} position {1,1}, first row and column {1,1} position {-1,-1}, last row and column
• For a 3D texture, coordinates correspond to:
•  {0,0,0} position {1,1,1}, first row, column, and tube {1,1,1} position {-1,-1,-1}, last row, column, and tube
• The texture coordinates in the interior of the polygon effectively correspond to interpolating between the texture coordinates specified by VertexTextureCoordinates.
• The texture color corresponding to a texture coordinate is computed by interpolating between neighboring colors in the texture.

# Examples

open allclose all

## Basic Examples(3)

Specify vertex coordinates for a 1D texture:

Specify vertex coordinates for a 2D texture:

Specify vertex coordinates for a 3D texture:

## Scope(5)

The 1D texture coordinates are assumed to range from {0} to {1}:

Specify a portion of 1D texture by using coordinates between {0} and {1}:

Repeat 1D texture by using coordinate values outside of {0} and {1}:

The 2D texture coordinates are assumed to range from {0,0} to {1,1}:

Specify a portion of 2D texture by using coordinates within the range of {0,0} and {1,1}:

Repeat 2D texture by using coordinate values outside of {0,0} and {1,1}:

The 3D texture coordinates are assumed to range from {0,0,0} to {1,1,1}:

Multi-polygons are mapped to sublists of texture coordinates:

Components of filled curves are mapped to sublists of texture coordinates:

## Properties & Relations(1)

Texture coordinates of plot functions can be specified by TextureCoordinateFunction: