assetBestRatio

Syntax

string assetBestRatio(searchQuery, axesRatio)

Parameters

• 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", "yz", "xyz"

  Axes for the currect scope.

Returns

Asset (according to axesRatio) with the best ratio.

Description

This function returns the asset with the best fitting ratio, from the files specified by 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"))

Copyright ©2008-2024 Esri R&D Center Zurich. All rights reserved.