Brief Index      Full Index      I.M. Reference

Scale_Object


Functions

void Scale_Object (double x, double y, double z)
void QScale_Object (const char *segment, double x, double y, double z)

Function Documentation

void Scale_Object ( double  x,
double  y,
double  z 
)

Enlarges or reduces objects within the user data space. Not to be confused with Zoom_Camera.

Parameters:
x - Factor to stretch things by along the X -axis. x < 1 reduces size
y - Stretch, along the Y-axis.
z - Likewise, along Z.

DETAILS

Everything in the segment is made larger or smaller. A scale factor of 2 will result in an object that's twice as big, while 0.5 yields one of half size.

The transform that is supplied to Append_Modelling_Matrix() is defined as

scale.gif

The three scale factors are usually equal, to give uniform scaling in all dimensions. If a scale factor is zero, the object becomes 2 dimensional. If all three are zero, all the objects are transformed to a point. If scale factors are negative, you can obtain mirroring.

Scale_Object() is a modelling transformation---it should be thought of as changing the effective size of the object you have drawn. If you want the scene on the screen to look bigger or smaller, try Dollying in or out or Zooming.

NOTES

If z is given as zero, it will, given no Rotations, make a 3-D object qualify as 2-D and speed up display.

RESTRICTIONS

See also:
Translate_Object, Rotate_Object, Append_Modelling_Matrix, Set_Modelling_Matrix, Dolly_Camera, Zoom_Camera.

void QScale_Object ( const char *  segment,
double  x,
double  y,
double  z 
)

Similar to Scale_Object(), but operates on a given segment rather than the currently open one.

Parameters:
segment - Name of the segment(s) to be changed.
x - Factor to stretch things by along the X -axis. x < 1 reduces size
y - Stretch, along the Y-axis.
z - Likewise, along Z.

DETAILS

No additional details. See Scale_Object()

Main Index
Brief Index      Full Index      I.M. Functions