imageBestRatio function

string imageBestRatio(searchQuery, axesRatio)

searchQuery string Search query to apply on list of all files in the workspace. See fileSearch / filesSearch for details about the syntax.

axesRatio string

"xy", "xz", "yx", "yz", "zx", "zy" Defines which scope axes ratio is used as a reference.

Returns the texture with the best ratio match (according to axesRatio).

This function returns the texture with the best ratio match, from the files specified by searchQuery, according to the specified combination of axes.

Note: In case multiple files share the best ratio, a random file is returned among those

Related

assetApproxRatiofunction assetApproxSizefunction assetBestRatiofunction assetBestSizefunction assetFitSizefunction fileBasenamefunction fileDirectoryfunction fileExtensionfunction fileNamefunction fileRandomfunction imageApproxRatiofunction

Examples

Setting up texturing based on the best pixel ratio

Textures with different image ratios

The goal is to set up the texturing, depending on the best pixel ratio of the list of desired textures. The following textures all have different resolutions.

Result of imageBestRatio texturing example 
Lot -->
    s('0.9,'0.9,'0.9)
    center(xz)
    RecursiveSplit

RecursiveSplit -->
    case scope.sx >= 1.5 && scope.sz >= 1.5:
        split(x) { ~scope.sx/3 : split(z) { ~scope.sz/3 : RecursiveSplit }* }*
    else: Texture

Texture -->
    setupProjection(0, scope.xz, scope.sx, -scope.sz)
    projectUV(0)
    texture(imageBestRatio("/myProject/assets/textures/*.jpg", "xz"))