Description mismatch for `AspectRatio` parameter in Translator options

[atsushi_kuno]

Hi, everyone

I am writing a plugin to export an .obj file. When I reading the description of `AspectRatio` parameter for Translator options, I noticed a description mismatch. The figure immediately below is an excerpt from "Definitions of Export Values" section (source page😞

The other figure below is another excerpt from "Export options for CATIA V5, IGES, JT, Parasolid, Pro/ENGINEER, SAT, STEP, STL and OBJ." section:

As you can see, the valid value range for `AspectRatio` should be between 0 to 21.5 in Float or Double while its default value is 40 in Integer. What is the correct value range and data type for the option?

Thanks in advance!

[WCrihfield · Accepted solution]

Hi @atsushi_kuno.  Good point.  Looks like maybe a mistake in the help documentation, or maybe an old value that needs to be updated after some changes at some point along the way.  That is not an export file type that I commonly use, but as a test, I just attempted to manually export an assembly I had open as an OBJ file, then clicked on the Options button in the Save As window, and this is what it shows.  That bottom slider does not change its max value, no matter which 'High, Medium, Low, Custom, Brep option is chosen.  I would say this proves that 21.5 is its upper limit, but that specification is only available when one of the options other than 'Brep' is chosen.  Plus, the documentation seems to indicate that it will be ignored unless the 'Resolution' is set to Custom.

[atsushi_kuno]

Hi, @WCrihfield 

I see. Thanks for your answer. Let me check my understanding. The valid value range for the AspectRatio option is from 0 to 21.5 in real value, and the option is effective only when High, Medium, or Low is selected for the Resolution option. Is that correct?

[WCrihfield]

When doing it manually, that setting is greyed out while the Resolution is set to Brep, but is no longer greyed out while any of the other resolution settings are being used.  However, once you change that one setting from its default, that will go to the Custom setting, so if you want to specify a custom setting for the aspect ratio, it must be on Custom resolution.  The same is true when doing it by code.  If you need/want to specify a custom value for the aspect ratio, then the resolution must be set to custom, which apparently is represented by the numerical value 3.  Edit:  The numerical value for Resolution is specified on that online help page you provided that link to in your original post.  I missed that originally. 🙄  My brain is getting tired.

[atsushi_kuno]

Got it. Thanks a lot!