O3D_Y_SCALE()

O3D_Y_SCALE(N)

RETURNS THE SCALE FACTOR OF THE 3D OBJECT NUMBER N ALONG ITS Y AXIS

  • Type: Function
  • Parameter: 1
  • Group: 3D Objects

ACTION

The function O3D_Y_SCALE(N) returns the scale factor of the 3D object designated by its number N, along its own Y axis.

The own Y axis of the 3D object is the axis of the object which was parallel to the world Y axis when the 3D object was created.

If Returned Value =1, no scale has been made.

If Returned Value >1, the 3D object is stretched on its Y axis.

If Returned Value <1, the 3D object is shrinked on its Y axis.

SYNTAX: Result=O3D_Y_SCALE(N)

  • N = 3D object number (integer or real). Must be greater than 0 and less than or equal to the allowed maximum number of 3D objects.

USE

  • The function O3D_Y_SCALE() is used to know the scale factor of a 3D object on its Y axis.

ERROR

  • If number N is not a correct expression.
  • If number N exceeds the allowed maximum number of 3D objects.
  • If number N is not greater than 0.
  • If 3D object number N does not exist.

EXAMPLE

rem create a 3D world

scene3d 1

rem create a sphere number 1

3d_sphere 1,2

rem turn it into an ovoid

3d_y_scale 1,3

rem display its scale factor on Y axis

print o3d_y_scale(1)

SEE ALSO

O3D_X_SCALE()

O3D_Z_SCALE()