assetApproxRatio function

Syntax

• string assetApproxRatio(searchQuery, axesRatio, 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. axesRatio—string
   { "xy" | "xz" | "yz" | "xyz" }—Axes for the current scope.
3. n—float
   Number (integer >= 1) of assets to consider (one is randomly picked out of the n best assets).

Returns

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

Description

The assetApproxRatio function returns one of the n best assets of the best ratio, from the files specified in searchQuery, according to the specified axesRatio string.

Note:

assetApproxRatio(searchQuery, axesRatio, 1) = assetBestRatio(searchQuery, axesRatio)

Related

• assetApproxSize 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 approximate ratio

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

CGA examples with n = 1 and n = 3

Note:

• Since the assets are color coded with their ratio, it is visible that "long" and "wide" Lots utilize black and pink assets, while "square-ish" Lots utilize red and blue assets.
• The color variations in the next two examples by using only the "best ratio" (n = 1) and "choose randomly one of the best three ratios" (n = 3).

n=1 Lot --> innerRectangle(scope) { shape : doInsert } doInsert --> alignScopeToAxes(y) s('1,0,'1) i(assetApproxRatio("/myProject/assets/cube_*.obj", "xz", 1))
n = 3 Lot --> innerRectangle(scope) { shape : doInsert } doInsert --> alignScopeToAxes(y) s('1,0,'1) i(assetApproxRatio("/myProject/assets/cube_*.obj", "xz", 3))