tpaviot / oce

OpenCASCADE Community Edition (OCE): a community driven fork of the Open CASCADE library.
http://groups.google.com/group/oce-dev
GNU Lesser General Public License v2.1
808 stars 284 forks source link

Confusing documentation for gp::XOY. #734

Open ghost opened 3 years ago

ghost commented 3 years ago

The documentation for the gp::XOY() reads:

Identifies a coordinate system where its origin is Origin, and its "main Direction" and "X Direction" coordinates Z = 1.0, X = Y =0.0 and X direction coordinates X = 1.0, Y = Z = 0.0.

I find it confusing. How can "main Direction" and "X Direction" have the same coordinates?

How could X direction have two different coordinates?

Why you do not define the meaning of this static function simply as:

Identifies a coordinate system where its origin is Origin, and its "main Direction" and "X Direction" coordinates Z = 1.0, X = Y =0.0 and X direction coordinates X = 1.0, Y = Z = 0.0.

?

The definition of gp::YOZ() and gp:ZOX() have a similar problem.