assetApproxSize function

Syntax

• string assetApproxSize(searchQuery, axisSize, n)

Parameters

1. searchQuery—string
   Search query to apply on list of all files in the workspace. See fileSearch for details about the syntax.
2. axisSize—string
   { "x" | "y" | "z" | "xy" | "yz" | "xyz" }—Axes for the current scope.
3. n—float
   Number (integer >= 1) of possible returned result strings (1 returned randomly out of n possibilities).

Returns

Asset with one of the best n size fits (according to axisSize).

Description

The assetApproxSize function returns one of the n best size fitting assets, from the files specified in searchQuery, according to the specified axisSize string.

Note:

assetApproxSize(searchQuery, axesSize, 1) = assetBestSize(searchQuery, axesSize)

Related

• assetApproxRatio function
• assetBestRatio function
• assetBestSize 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.

CGA examples with n = 1, n = 2 and n = 3:

Note:

• The geometry varies in the next three images by using only the n parameter.
• Small parts get blue assets while large parts get red assets.

n = 1: Lot --> s('.9,'.9,'.9) center(xz) recursiveSplit(0) recursiveSplit(n) --> case scope.sx >= 1.5 && scope.sz >= 1.5: split(x){~scope.sx/3: split(z){~scope.sz/3 : recursiveSplit(n+1)}*}* else: innerRectangle(scope) { shape : doInsert } doInsert --> alignScopeToAxes(y) i(assetApproxSize("/myProject/assets/cube_*.obj", "xz",1))
n = 2: .. i(assetApproxSize("/myProject/assets/cube_*.obj", "xz",2))
n = 3: .. i(assetApproxSize("/myProject/assets/cube_*.obj", "xz",3))