Functions | |
void | Set_Camera_Field (double width, double height) |
void | QSet_Camera_Field (const char *segment, double width, double height) |
void | DSet_Camera_Field (double width, double height) |
void Set_Camera_Field | ( | double | width, | |
double | height | |||
) |
After the viewing "camera" has been positioned, adjusts the width or height of the total field of view.
width | - The width, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. | |
height | - The height, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. |
The field is stored internally as an angular field-of-view immediately upon receipt, and held constant as an angle through subsequent camera movements. This keeps your lens from accidentally turning itself into a fish-eye as you walk up to your target.
If the screen window that the view is to appear in has a different aspect ratio than the camera field, you'll just see a bit more of your scene on the left and right or bottom and top than you would otherwise. The field of view is normally scaled symmetrically to fit on the screen. You can force the view to be warped to make an exact fit into the window by asking for a "stretched" Camera Projection.
Set_Camera_Position() and Set_Camera_Target() make automatic adjustments in the Camera Field. If you're using either of these routines together with Set_Camera() _Field, the Field request should placed after the others.
Set_Camera_Field() actually calls Set_Camera() to do its work.
void QSet_Camera_Field | ( | const char * | segment, | |
double | width, | |||
double | height | |||
) |
Similar to Set_Camera_Field(), but operates on a given segment rather than the currently open one.
segment | - Name of the segment(s) to be changed. Often "?Picture". | |
width | - The width, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. | |
height | - The height, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. |
void DSet_Camera_Field | ( | double | width, | |
double | height | |||
) |
Similar to Set_Camera_Field(). This command should be used in conjunction with other set camera functions in the HOOPS double-precision header, hcd.h.
segment | - Name of the segment(s) to be changed. Often "?Picture". | |
width | - The width, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. | |
height | - The height, in object coordinates, of the largest rectangle that should just fit on the screen or in the current Window. |