assetBestRatio function

Syntax

• string assetBestRatio(searchQuery, axesRatio)

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. axesRatio—string
   { "xy" | "xz" | "yz" | "xyz" }—Axes for the current scope.

Returns

Asset (according to axesRatio) with the best ratio.

Description

The assetBestRatio function returns the asset with the best fitting ratio, from the file list specified in searchQuery, according to the specified axesRatio string.

Related

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

Examples

Inserting assets based on the best 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.

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.

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