C API does not indicate internal and file stored geometric values are in inches

[DanRathbun]

SketchUp C API Documentation Issue

ISSUE: The C API does not indicate anywhere that SketchUp internal geometric values (and those stored in .skp and .layout file formats,) for length, area and volume are in inches.

This causes problems for C API users unfamiliar with SketchUp and/or it's Ruby API.

REF Public forum thread: Reading Drawing Scale (or Units)

---

The description for the coordinates and magnitudes should have an additional ..."in inches." for geometry structs:

• SUPoint2D
• SUPoint3D
• SUVector2D
• SUVector3D
• SUUVQ

Certain submatrix values (ie, not the scale value) for:

• SUTransformation
• SUTransformation2D

Possibly the factors for the SUPlane3D equation.

And in several places should explain SketchUp uses inches internally for length, area, and volume values, as well as storing such values in the SKP file format (and that the internal tolerance is 0.001".)

Good places for this note (or link to it) might be:

• the Main API introductory page (perhaps a Units section?)
• SUEntitiesFill() function
• SUGeometryInputRef
• SULengthFormatterRef

~

[michkowalczuk]

@thomthom, why we have to wait for this simple fix for so long?