|
Action:
|
Sets a view's hither clip distance.
|
|
|
Filename:
|
scm/scmext/view_scm.cxx
|
|
|
Syntax:
|
(view:set-hither hither=0.025 [view=active])
|
|
|
Arg Types:
|
hither
|
real
|
|
view
|
view
|
|
|
Returns:
|
view
|
|
|
Description:
|
This extension sets the hither clip distance from the active view unless the optional argument
view is specified. A view's hither plane is a plane perpendicular to the view's line of sight. Objects located on the same side of the hither plane as the eye position are invisible; they are not pictured in the view. The distance along the line of sight from the eye position to its hither plane is the hither clipping distance. The default hither clipping distance is 0.025.
|
|
|
Hither and yon settings are very useful for perspective views or for views where the eye point is inside of the object. Establish clipping such that it clips out everything behind the eye point. It can also be used to clip out foreground and backgrounds objects.
|
|
|
Specifies the
hither clipping distance. Hither specifies the near distance and must be greater than 0.
|
|
|
The optional
view specifies the view to set the font size. If
view is not specified, the active view is used.
|
|
|
Limitations:
|
This extension is available on all platforms, but produces results only on NT using OpenGL.
|
|
|
Example:
|
; view:set-hither
|
|
; Get the hither clip distance.
|
|
(view:hither)
|
|
;; 0.025
|
|
(define block1
|
|
|
(solid:block (position -30 -30 -30)
|
|
|
(position 20 50 20)))
|
|
;; block1
|
|
; OUTPUT Original
|
|
|
; Set the hither clip distance.
|
|
(view:set-hither 220)
|
|
;; #[view 1075519376]
|
|
(view:refresh)
|
|
;; #[view 1075519376]
|
|
; OUTPUT Result
|
|
|
|
|
 
|
|
|
Figure 4-14. view:set-hither
|