Image 2D Pixel (RealityKit)

A texture with RealityKit properties and pixel texture coordinates.

Overview

Adjustable level of detail. Pixel texture coordinates

Parameter Types

Parameter descriptions

File: The image file to use for the texture.
U Wrap Mode: The way the node handles U values outside of the range of 0-1. The default value is clamp_to_edge.
V Wrap Mode: The way the node handles V values outside of the range of 0-1. The default value is clamp_to_edge.
Border Color: A color that fills in areas of a material’s surface not covered by the material property’s image contents. The default value is transparent_black.
Filter: Both the magnification and the minification filter the node uses to render the image contents at a size larger or smaller than the original image.
Max Anisotropy: The amount of anisotropic texture filtering applied when rendering the texture’s image contents. Used when rendering the image contents at an extreme angle relative to the camera. This parameter is used only in conjunction with mipmapping, so it only has an effect if Mip Filter isn’t None. The default value is 1.
Max Lod Clamp: The maximum level of detail allowed for the rendered image contents. As an object gets closer to the camera, the level of detail used to render the texture of that object increases up to the maximum defined by this parameter. The default value is 65504.
Min Lod Clamp: The minimum level of detail allowed for the rendered image contents. As an object gets farther from the camera, the level of detail used to render the texture of that object decreases to the minimum defined by this parameter. The default value is 0.
Default: The default value to use if the File parameter fails to resolve.
Texture Coordinates: The 2D coordinate at which the data is read in order to map the texture onto a surface. The default is the current UV coordinates, in which U is the horizontal axis and V is the vertical axis.
Bias: The bias for the level of detail of the rendered image contents. When the size of the rendered texture is between two LOD levels, this parameter weights the choice of which level the renderer uses toward either the more detailed level or the less detailed level. When the value is between 0 and 1, the node favors less detail. If the value is greater than 1, the node favors more detail. The default value is 0.
Dynamic Min Lod Clamp: The minimum level of detail allowed for the rendered image contents. Similar to the Min Lod Clamp parameter, except this parameter may be changed dynamically during runtime, while the Min Lod Clamp parameter can’t.
Offset: The integer values added to the texture coordinates before looking up each pixel. The value must be within the range -8-7. The default value is 0.

Discussion

The Image 2D Pixel node produces a texture using the contents of the image file specified in the File parameter. It has a multitude of parameters that affect the properties of the rendered textures.

For the wrap mode parameters, the possible values are:

clamp_to_border: The node sets texture coordinates outside the normal range to the color specified by the Border Color parameter.
clamp_to_edge: The node clamps texture coordinates outside the normal range to the normal range. The node will set any values greater than 1 to 1, and any values less than 0 to 0. This means the color’s on the edge of the image will extend to fill the rest of the texture.
clamp_to_zero: The node sets texture coordinates outside the normal range to a color of value of 0 or black. This is equivalent to the clamp_to_border option with a border color of transparent_black.
mirrored_repeat: The node mirrors texture coordinates outside the normal range.
repeat: The node will cause texture coordinates outside the normal range to “wrap around.” This behavior is effectively equivalent to the node applying modulo 1 to the coordinates.

For the Filter parameters, the possible values are:

linear: The filter uses linear interpolation of the closest values in order to determine the rendered contents.
nearest: The filter uses the nearest value in order to determine the rendered contents.

For an example on how to use this node, see the bottom of the Image 2D (RealityKit) node page.