assetBestSize function

Syntax

• string assetBestSize(searchQuery, axisSize)

Parameters

1. searchQuery—string
   Search query to apply on list of all files in the workspace. See fileSearch / filesSearch for details about the syntax.
2. axisSize—string
   { "x" | "y" | "z" | "xy" | "xz" | "yz" | "xyz" }—Axes for the current scope.

Returns

Asset with the best size fit (according to axisSize).

Description

The assetBestSize function returns the asset with the best fitting size, from the file list specified in searchQuery, according to the specified axisSize string.

Related

• assetApproxRatio function
• assetApproxSize function
• assetBestRatio function
• assetFitSize function
• fileBasename function
• fileDirectory function
• fileExtension function
• fileName function
• fileRandom function
• imageApproxRatio function
• imageBestRatio function

Examples

Inserting assets based on their (physical) size

The goal is to insert assets from a pool, depending on their (physical) size. The pool of assets is seen in the following image. Colors are (only) used to visually emphasize the size ratio.

Note:

Note that small parts get blue assets while large parts get red assets.

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: innerRectangle(scope) { shape : Insert } Insert --> alignScopeToAxes(y) i(assetBestSize( "/myProject/assets/cube_*.obj", "xz"))