Open CASCADE Technology  7.7.0
Public Member Functions

V3d_View Class Reference

Defines the application object VIEW for the VIEWER application. The methods of this class allow the editing and inquiring the parameters linked to the view. Provides a set of services common to all types of view. Warning: The default parameters are defined by the class Viewer (Example : SetDefaultViewSize()). Certain methods are mouse oriented, and it is necessary to know the difference between the start and the continuation of this gesture in putting the method into operation. Example : Shifting the eye-view along the screen axes. More...

#include <V3d_View.hxx>

Inheritance diagram for V3d_View:
Inheritance graph
[legend]

Public Member Functions

 V3d_View (const Handle< V3d_Viewer > &theViewer, const V3d_TypeOfView theType=V3d_ORTHOGRAPHIC)
 Initializes the view. More...
 
 V3d_View (const Handle< V3d_Viewer > &theViewer, const Handle< V3d_View > &theView)
 Initializes the view by copying. More...
 
virtual ~V3d_View ()
 Default destructor. More...
 
void SetWindow (const Handle< Aspect_Window > &theWindow, const Aspect_RenderingContext theContext=NULL)
 Activates the view in the specified Window If <aContext> is not NULL the graphic context is used to draw something in this view. Otherwise an internal graphic context is created. Warning: The view is centered and resized to preserve the height/width ratio of the window. More...
 
void SetWindow (const Handle< V3d_View > &theParentView, const Graphic3d_Vec2d &theSize, Aspect_TypeOfTriedronPosition theCorner=Aspect_TOTP_LEFT_UPPER, const Graphic3d_Vec2d &theOffset=Graphic3d_Vec2d(), const Graphic3d_Vec2i &theMargins=Graphic3d_Vec2i())
 Activates the view as subview of another view. More...
 
void SetMagnify (const Handle< Aspect_Window > &theWindow, const Handle< V3d_View > &thePreviousView, const Standard_Integer theX1, const Standard_Integer theY1, const Standard_Integer theX2, const Standard_Integer theY2)
 
void Remove ()
 Destroys the view. More...
 
void Update () const
 Deprecated, Redraw() should be used instead. More...
 
virtual void Redraw () const
 Redisplays the view even if there has not been any modification. Must be called if the view is shown. (Ex: DeIconification ) . More...
 
virtual void RedrawImmediate () const
 Updates layer of immediate presentations. More...
 
void Invalidate () const
 Invalidates view content but does not redraw it. More...
 
Standard_Boolean IsInvalidated () const
 Returns true if cached view content has been invalidated. More...
 
Standard_Boolean IsInvalidatedImmediate () const
 Returns true if immediate layer content has been invalidated. More...
 
void InvalidateImmediate ()
 Invalidates view content within immediate layer but does not redraw it. More...
 
void MustBeResized ()
 Must be called when the window supporting the view changes size. if the view is not mapped on a window. Warning: The view is centered and resized to preserve the height/width ratio of the window. More...
 
void DoMapping ()
 Must be called when the window supporting the view is mapped or unmapped. More...
 
Standard_Boolean IsEmpty () const
 Returns the status of the view regarding the displayed structures inside Returns True is The View is empty. More...
 
void UpdateLights () const
 Updates the lights of the view. More...
 
void SetAutoZFitMode (const Standard_Boolean theIsOn, const Standard_Real theScaleFactor=1.0)
 Sets the automatic z-fit mode and its parameters. The auto z-fit has extra parameters which can controlled from application level to ensure that the size of viewing volume will be sufficiently large to cover the depth of unmanaged objects, for example, transformation persistent ones. More...
 
Standard_Boolean AutoZFitMode () const
 returns TRUE if automatic z-fit mode is turned on. More...
 
Standard_Real AutoZFitScaleFactor () const
 returns scale factor parameter of automatic z-fit mode. More...
 
void AutoZFit () const
 If automatic z-range fitting is turned on, adjusts Z-min and Z-max projection volume planes with call to ZFitAll. More...
 
void ZFitAll (const Standard_Real theScaleFactor=1.0) const
 Change Z-min and Z-max planes of projection volume to match the displayed objects. More...
 
void SetBackgroundColor (const Quantity_TypeOfColor theType, const Standard_Real theV1, const Standard_Real theV2, const Standard_Real theV3)
 Defines the background color of the view by the color definition type and the three corresponding values. More...
 
void SetBackgroundColor (const Quantity_Color &theColor)
 Defines the background color of the view. More...
 
void SetBgGradientColors (const Quantity_Color &theColor1, const Quantity_Color &theColor2, const Aspect_GradientFillMethod theFillStyle=Aspect_GradientFillMethod_Horizontal, const Standard_Boolean theToUpdate=Standard_False)
 Defines the gradient background colors of the view by supplying the colors and the fill method (horizontal by default). More...
 
void SetBgGradientStyle (const Aspect_GradientFillMethod theMethod=Aspect_GradientFillMethod_Horizontal, const Standard_Boolean theToUpdate=Standard_False)
 Defines the gradient background fill method of the view. More...
 
void SetBackgroundImage (const Standard_CString theFileName, const Aspect_FillMethod theFillStyle=Aspect_FM_CENTERED, const Standard_Boolean theToUpdate=Standard_False)
 Defines the background texture of the view by supplying the texture image file name and fill method (centered by default). More...
 
void SetBackgroundImage (const Handle< Graphic3d_Texture2D > &theTexture, const Aspect_FillMethod theFillStyle=Aspect_FM_CENTERED, const Standard_Boolean theToUpdate=Standard_False)
 Defines the background texture of the view by supplying the texture and fill method (centered by default) More...
 
void SetBgImageStyle (const Aspect_FillMethod theFillStyle, const Standard_Boolean theToUpdate=Standard_False)
 Defines the textured background fill method of the view. More...
 
void SetBackgroundCubeMap (const Handle< Graphic3d_CubeMap > &theCubeMap, Standard_Boolean theToUpdatePBREnv=Standard_True, Standard_Boolean theToUpdate=Standard_False)
 Sets environment cubemap as background. More...
 
const Aspect_SkydomeBackgroundBackgroundSkydome () const
 Returns skydome aspect;. More...
 
void SetBackgroundSkydome (const Aspect_SkydomeBackground &theAspect, Standard_Boolean theToUpdatePBREnv=Standard_True)
 Sets skydome aspect. More...
 
Standard_Boolean IsImageBasedLighting () const
 Returns TRUE if IBL (Image Based Lighting) from background cubemap is enabled. More...
 
void SetImageBasedLighting (Standard_Boolean theToEnableIBL, Standard_Boolean theToUpdate=Standard_False)
 Enables or disables IBL (Image Based Lighting) from background cubemap. Has no effect if PBR is not used. More...
 
void GeneratePBREnvironment (Standard_Boolean theToUpdate=Standard_False)
 Activates IBL from background cubemap. More...
 
void ClearPBREnvironment (Standard_Boolean theToUpdate=Standard_False)
 Disables IBL from background cubemap; fills PBR specular probe and irradiance map with white color. More...
 
void SetTextureEnv (const Handle< Graphic3d_TextureEnv > &theTexture)
 Sets the environment texture to use. No environment texture by default. More...
 
void SetAxis (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Real Vx, const Standard_Real Vy, const Standard_Real Vz)
 Definition of an axis from its origin and its orientation . This will be the current axis for rotations and movements. Warning! raises BadValue from V3d if the vector normal is NULL. . More...
 
void SetVisualization (const V3d_TypeOfVisualization theType)
 Defines the visualization type in the view. More...
 
void SetLightOn (const Handle< V3d_Light > &theLight)
 Activates theLight in the view. More...
 
void SetLightOn ()
 Activates all the lights defined in this view. More...
 
void SetLightOff (const Handle< V3d_Light > &theLight)
 Deactivate theLight in this view. More...
 
void SetLightOff ()
 Deactivate all the Lights defined in this view. More...
 
Standard_Boolean IsActiveLight (const Handle< V3d_Light > &theLight) const
 Returns TRUE when the light is active in this view. More...
 
Standard_Boolean SetImmediateUpdate (const Standard_Boolean theImmediateUpdate)
 sets the immediate update mode and returns the previous one. More...
 
const Handle< V3d_Trihedron > & Trihedron (bool theToCreate=true)
 Returns trihedron object. More...
 
void ZBufferTriedronSetup (const Quantity_Color &theXColor=Quantity_NOC_RED, const Quantity_Color &theYColor=Quantity_NOC_GREEN, const Quantity_Color &theZColor=Quantity_NOC_BLUE1, const Standard_Real theSizeRatio=0.8, const Standard_Real theAxisDiametr=0.05, const Standard_Integer theNbFacettes=12)
 Customization of the ZBUFFER Triedron. XColor,YColor,ZColor - colors of axis SizeRatio - ratio of decreasing of the trihedron size when its physical position comes out of the view AxisDiametr - diameter relatively to axis length NbFacettes - number of facets of cylinders and cones. More...
 
void TriedronDisplay (const Aspect_TypeOfTriedronPosition thePosition=Aspect_TOTP_CENTER, const Quantity_Color &theColor=Quantity_NOC_WHITE, const Standard_Real theScale=0.02, const V3d_TypeOfVisualization theMode=V3d_WIREFRAME)
 Display of the Triedron. Initialize position, color and length of Triedron axes. The scale is a percent of the window width. More...
 
void TriedronErase ()
 Erases the Triedron. More...
 
const Graphic3d_GraduatedTrihedronGetGraduatedTrihedron () const
 Returns data of a graduated trihedron. More...
 
void GraduatedTrihedronDisplay (const Graphic3d_GraduatedTrihedron &theTrihedronData)
 Displays a graduated trihedron. More...
 
void GraduatedTrihedronErase ()
 Erases a graduated trihedron from the view. More...
 
void SetFront ()
 modify the Projection of the view perpendicularly to the privileged plane of the viewer. More...
 
void Rotate (const Standard_Real Ax, const Standard_Real Ay, const Standard_Real Az, const Standard_Boolean Start=Standard_True)
 Rotates the eye about the coordinate system of reference of the screen for which the origin is the view point of the projection, with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True Warning! raises BadValue from V3d If the eye, the view point, or the high point are aligned or confused. More...
 
void Rotate (const Standard_Real Ax, const Standard_Real Ay, const Standard_Real Az, const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Boolean Start=Standard_True)
 Rotates the eye about the coordinate system of reference of the screen for which the origin is Gravity point {X,Y,Z}, with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True If the eye, the view point, or the high point are aligned or confused. More...
 
void Rotate (const V3d_TypeOfAxe Axe, const Standard_Real Angle, const Standard_Real X, const Standard_Real Y, const Standard_Real Z, const Standard_Boolean Start=Standard_True)
 Rotates the eye about one of the coordinate axes of of the view for which the origin is the Gravity point{X,Y,Z} with an relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True. More...
 
void Rotate (const V3d_TypeOfAxe Axe, const Standard_Real Angle, const Standard_Boolean Start=Standard_True)
 Rotates the eye about one of the coordinate axes of of the view for which the origin is the view point of the projection with an relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True. More...
 
void Rotate (const Standard_Real Angle, const Standard_Boolean Start=Standard_True)
 Rotates the eye around the current axis a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True. More...
 
void Move (const Standard_Real Dx, const Standard_Real Dy, const Standard_Real Dz, const Standard_Boolean Start=Standard_True)
 Movement of the eye parallel to the coordinate system of reference of the screen a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Move (const V3d_TypeOfAxe Axe, const Standard_Real Length, const Standard_Boolean Start=Standard_True)
 Movement of the eye parallel to one of the axes of the coordinate system of reference of the view a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Move (const Standard_Real Length, const Standard_Boolean Start=Standard_True)
 Movement of the eye parllel to the current axis a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Translate (const Standard_Real Dx, const Standard_Real Dy, const Standard_Real Dz, const Standard_Boolean Start=Standard_True)
 Movement of the ye and the view point parallel to the frame of reference of the screen a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Translate (const V3d_TypeOfAxe Axe, const Standard_Real Length, const Standard_Boolean Start=Standard_True)
 Movement of the eye and the view point parallel to one of the axes of the fame of reference of the view a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Translate (const Standard_Real Length, const Standard_Boolean Start=Standard_True)
 Movement of the eye and view point parallel to the current axis a distance relative to the initial position expressed by Start = Standard_True. More...
 
void Place (const Standard_Integer theXp, const Standard_Integer theYp, const Standard_Real theZoomFactor=1)
 places the point of the view corresponding at the pixel position x,y at the center of the window and updates the view. More...
 
void Turn (const Standard_Real Ax, const Standard_Real Ay, const Standard_Real Az, const Standard_Boolean Start=Standard_True)
 Rotation of the view point around the frame of reference of the screen for which the origin is the eye of the projection with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True. More...
 
void Turn (const V3d_TypeOfAxe Axe, const Standard_Real Angle, const Standard_Boolean Start=Standard_True)
 Rotation of the view point around one of the axes of the frame of reference of the view for which the origin is the eye of the projection with an angular value in RADIANS relative to the initial position expressed by Start = Standard_True. More...
 
void Turn (const Standard_Real Angle, const Standard_Boolean Start=Standard_True)
 Rotation of the view point around the current axis an angular value in RADIANS relative to the initial position expressed by Start = Standard_True. More...
 
void SetTwist (const Standard_Real Angle)
 Defines the angular position of the high point of the reference frame of the view with respect to the Y screen axis with an absolute angular value in RADIANS. More...
 
void SetEye (const Standard_Real X, const Standard_Real Y, const Standard_Real Z)
 Defines the position of the eye.. More...
 
void SetDepth (const Standard_Real Depth)
 Defines the Depth of the eye from the view point without update the projection . More...
 
void SetProj (const Standard_Real Vx, const Standard_Real Vy, const Standard_Real Vz)
 Defines the orientation of the projection. More...
 
void SetProj (const V3d_TypeOfOrientation theOrientation, const Standard_Boolean theIsYup=Standard_False)
 Defines the orientation of the projection . More...
 
void SetAt (const Standard_Real X, const Standard_Real Y, const Standard_Real Z)
 Defines the position of the view point. More...
 
void SetUp (const Standard_Real Vx, const Standard_Real Vy, const Standard_Real Vz)
 Defines the orientation of the high point. More...
 
void SetUp (const V3d_TypeOfOrientation Orientation)
 Defines the orientation(SO) of the high point. More...
 
void SetViewOrientationDefault ()
 Saves the current state of the orientation of the view which will be the return state at ResetViewOrientation. More...
 
void ResetViewOrientation ()
 Resets the orientation of the view. Updates the view. More...
 
void Panning (const Standard_Real theDXv, const Standard_Real theDYv, const Standard_Real theZoomFactor=1, const Standard_Boolean theToStart=Standard_True)
 Translates the center of the view along "x" and "y" axes of view projection. Can be used to perform interactive panning operation. In that case the DXv, DXy parameters specify panning relative to the point where the operation is started. More...
 
void SetCenter (const Standard_Integer theXp, const Standard_Integer theYp)
 Relocates center of screen to the point, determined by {Xp, Yp} pixel coordinates relative to the bottom-left corner of screen. To calculate pixel coordinates for any point from world coordinate space, it can be projected using "Project". More...
 
void SetSize (const Standard_Real theSize)
 Defines the view projection size in its maximum dimension, keeping the initial height/width ratio unchanged. More...
 
void SetZSize (const Standard_Real SetZSize)
 Defines the Depth size of the view Front Plane will be set to Size/2. Back Plane will be set to -Size/2. Any Object located Above the Front Plane or behind the Back Plane will be Clipped . NOTE than the XY Size of the View is NOT modified . More...
 
void SetZoom (const Standard_Real Coef, const Standard_Boolean Start=Standard_True)
 Zooms the view by a factor relative to the initial value expressed by Start = Standard_True Updates the view. More...
 
void SetScale (const Standard_Real Coef)
 Zooms the view by a factor relative to the value initialised by SetViewMappingDefault(). Updates the view. More...
 
void SetAxialScale (const Standard_Real Sx, const Standard_Real Sy, const Standard_Real Sz)
 Sets anisotropic (axial) scale factors <Sx>, <Sy>, <Sz> for view <me>. Anisotropic scaling operation is performed through multiplying the current view orientation matrix by a scaling matrix: || Sx 0 0 0 || || 0 Sy 0 0 || || 0 0 Sz 0 || || 0 0 0 1 || Updates the view. More...
 
void FitAll (const Standard_Real theMargin=0.01, const Standard_Boolean theToUpdate=Standard_True)
 Adjust view parameters to fit the displayed scene, respecting height / width ratio. The Z clipping range (depth range) is fitted if AutoZFit flag is TRUE. Throws program error exception if margin coefficient is < 0 or >= 1. Updates the view. More...
 
void FitAll (const Bnd_Box &theBox, const Standard_Real theMargin=0.01, const Standard_Boolean theToUpdate=Standard_True)
 Adjust view parameters to fit the displayed scene, respecting height / width ratio according to the custom bounding box given. Throws program error exception if margin coefficient is < 0 or >= 1. Updates the view. More...
 
void DepthFitAll (const Standard_Real Aspect=0.01, const Standard_Real Margin=0.01)
 Adjusts the viewing volume so as not to clip the displayed objects by front and back and back clipping planes. Also sets depth value automatically depending on the calculated Z size and Aspect parameter. NOTE than the original XY size of the view is NOT modified . More...
 
void FitAll (const Standard_Real theMinXv, const Standard_Real theMinYv, const Standard_Real theMaxXv, const Standard_Real theMaxYv)
 Centers the defined projection window so that it occupies the maximum space while respecting the initial height/width ratio. NOTE than the original Z size of the view is NOT modified . More...
 
void WindowFit (const Standard_Integer theMinXp, const Standard_Integer theMinYp, const Standard_Integer theMaxXp, const Standard_Integer theMaxYp)
 Centers the defined PIXEL window so that it occupies the maximum space while respecting the initial height/width ratio. NOTE than the original Z size of the view is NOT modified. More...
 
void SetViewMappingDefault ()
 Saves the current view mapping. This will be the state returned from ResetViewmapping. More...
 
void ResetViewMapping ()
 Resets the centering of the view. Updates the view. More...
 
void Reset (const Standard_Boolean theToUpdate=Standard_True)
 Resets the centering and the orientation of the view. More...
 
Standard_Real Convert (const Standard_Integer Vp) const
 Converts the PIXEL value to a value in the projection plane. More...
 
void Convert (const Standard_Integer Xp, const Standard_Integer Yp, Standard_Real &Xv, Standard_Real &Yv) const
 Converts the point PIXEL into a point projected in the reference frame of the projection plane. More...
 
Standard_Integer Convert (const Standard_Real Vv) const
 Converts tha value of the projection plane into a PIXEL value. More...
 
void Convert (const Standard_Real Xv, const Standard_Real Yv, Standard_Integer &Xp, Standard_Integer &Yp) const
 Converts the point defined in the reference frame of the projection plane into a point PIXEL. More...
 
void Convert (const Standard_Integer Xp, const Standard_Integer Yp, Standard_Real &X, Standard_Real &Y, Standard_Real &Z) const
 Converts the projected point into a point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector. More...
 
void ConvertWithProj (const Standard_Integer Xp, const Standard_Integer Yp, Standard_Real &X, Standard_Real &Y, Standard_Real &Z, Standard_Real &Vx, Standard_Real &Vy, Standard_Real &Vz) const
 Converts the projected point into a point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector and returns the projection ray for further computations. More...
 
void ConvertToGrid (const Standard_Integer Xp, const Standard_Integer Yp, Standard_Real &Xg, Standard_Real &Yg, Standard_Real &Zg) const
 Converts the projected point into the nearest grid point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector and display the grid marker. Warning: When the grid is not active the result is identical to the above Convert() method. How to use: 1) Enable the grid echo display myViewer->SetGridEcho(Standard_True); 2) When application receive a move event: 2.1) Check if any object is detected if( myInteractiveContext->MoveTo(x,y) == AIS_SOD_Nothing ) { 2.2) Check if the grid is active if( myViewer->Grid()->IsActive() ) { 2.3) Display the grid echo and gets the grid point myView->ConvertToGrid(x,y,X,Y,Z); myView->Viewer()->ShowGridEcho (myView, Graphic3d_Vertex (X,Y,Z)); myView->RedrawImmediate(); 2.4) Else this is the standard case } else myView->Convert(x,y,X,Y,Z);. More...
 
void ConvertToGrid (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, Standard_Real &Xg, Standard_Real &Yg, Standard_Real &Zg) const
 Converts the point into the nearest grid point and display the grid marker. More...
 
void Convert (const Standard_Real X, const Standard_Real Y, const Standard_Real Z, Standard_Integer &Xp, Standard_Integer &Yp) const
 Projects the point defined in the reference frame of the view into the projected point in the associated window. More...
 
void Project (const Standard_Real theX, const Standard_Real theY, const Standard_Real theZ, Standard_Real &theXp, Standard_Real &theYp) const
 Converts the point defined in the user space of the view to the projection plane at the depth relative to theZ. More...
 
void Project (const Standard_Real theX, const Standard_Real theY, const Standard_Real theZ, Standard_Real &theXp, Standard_Real &theYp, Standard_Real &theZp) const
 Converts the point defined in the user space of the view to the projection plane at the depth relative to theZ. More...
 
void BackgroundColor (const Quantity_TypeOfColor Type, Standard_Real &V1, Standard_Real &V2, Standard_Real &V3) const
 Returns the Background color values of the view depending of the color Type. More...
 
Quantity_Color BackgroundColor () const
 Returns the Background color object of the view. More...
 
void GradientBackgroundColors (Quantity_Color &theColor1, Quantity_Color &theColor2) const
 Returns the gradient background colors of the view. More...
 
Aspect_GradientBackground GradientBackground () const
 Returns the gradient background of the view. More...
 
Standard_Real Scale () const
 Returns the current value of the zoom expressed with respect to SetViewMappingDefault(). More...
 
void AxialScale (Standard_Real &Sx, Standard_Real &Sy, Standard_Real &Sz) const
 Returns the current values of the anisotropic (axial) scale factors. More...
 
void Size (Standard_Real &Width, Standard_Real &Height) const
 Returns the height and width of the view. More...
 
Standard_Real ZSize () const
 Returns the Depth of the view . More...
 
void Eye (Standard_Real &X, Standard_Real &Y, Standard_Real &Z) const
 Returns the position of the eye. More...
 
void FocalReferencePoint (Standard_Real &X, Standard_Real &Y, Standard_Real &Z) const
 Returns the position of point which emanating the projections. More...
 
void ProjReferenceAxe (const Standard_Integer Xpix, const Standard_Integer Ypix, Standard_Real &XP, Standard_Real &YP, Standard_Real &ZP, Standard_Real &VX, Standard_Real &VY, Standard_Real &VZ) const
 Returns the coordinate of the point (Xpix,Ypix) in the view (XP,YP,ZP), and the projection vector of the view passing by the point (for PerspectiveView). More...
 
Standard_Real Depth () const
 Returns the Distance between the Eye and View Point. More...
 
void Proj (Standard_Real &Vx, Standard_Real &Vy, Standard_Real &Vz) const
 Returns the projection vector. More...
 
void At (Standard_Real &X, Standard_Real &Y, Standard_Real &Z) const
 Returns the position of the view point. More...
 
void Up (Standard_Real &Vx, Standard_Real &Vy, Standard_Real &Vz) const
 Returns the vector giving the position of the high point. More...
 
Standard_Real Twist () const
 Returns in RADIANS the orientation of the view around the visual axis measured from the Y axis of the screen. More...
 
Graphic3d_TypeOfShadingModel ShadingModel () const
 Returns the current shading model; Graphic3d_TypeOfShadingModel_Phong by default. More...
 
void SetShadingModel (const Graphic3d_TypeOfShadingModel theShadingModel)
 Defines the shading model for the visualization. More...
 
Handle< Graphic3d_TextureEnvTextureEnv () const
 
V3d_TypeOfVisualization Visualization () const
 Returns the current visualisation mode. More...
 
const V3d_ListOfLightActiveLights () const
 Returns a list of active lights. More...
 
V3d_ListOfLightIterator ActiveLightIterator () const
 Return iterator for defined lights. More...
 
Standard_Integer LightLimit () const
 Returns the MAX number of light associated to the view. More...
 
Handle< V3d_ViewerViewer () const
 Returns the viewer in which the view has been created. More...
 
Standard_Boolean IfWindow () const
 Returns True if MyView is associated with a window . More...
 
const Handle< Aspect_Window > & Window () const
 Returns the Aspect Window associated with the view. More...
 
V3d_TypeOfView Type () const
 Returns the Type of the View. More...
 
void Pan (const Standard_Integer theDXp, const Standard_Integer theDYp, const Standard_Real theZoomFactor=1, const Standard_Boolean theToStart=Standard_True)
 Translates the center of the view along "x" and "y" axes of view projection. Can be used to perform interactive panning operation. In that case the DXp, DXp parameters specify panning relative to the point where the operation is started. More...
 
void Zoom (const Standard_Integer theXp1, const Standard_Integer theYp1, const Standard_Integer theXp2, const Standard_Integer theYp2)
 Zoom the view according to a zoom factor computed from the distance between the 2 mouse position. More...
 
void StartZoomAtPoint (const Standard_Integer theXp, const Standard_Integer theYp)
 Defines starting point for ZoomAtPoint view operation. More...
 
void ZoomAtPoint (const Standard_Integer theMouseStartX, const Standard_Integer theMouseStartY, const Standard_Integer theMouseEndX, const Standard_Integer theMouseEndY)
 Zooms the model at a pixel defined by the method StartZoomAtPoint(). More...
 
void AxialScale (const Standard_Integer Dx, const Standard_Integer Dy, const V3d_TypeOfAxe Axis)
 Performs anisotropic scaling of <me> view along the given <Axis>. The scale factor is calculated on a basis of the mouse pointer displacement <Dx,Dy>. The calculated scale factor is then passed to SetAxialScale(Sx, Sy, Sz) method. More...
 
void StartRotation (const Standard_Integer X, const Standard_Integer Y, const Standard_Real zRotationThreshold=0.0)
 Begin the rotation of the view around the screen axis according to the mouse position <X,Y>. Warning: Enable rotation around the Z screen axis when <zRotationThreshold> factor is > 0 soon the distance from the start point and the center of the view is > (medium viewSize * <zRotationThreshold> ). Generally a value of 0.4 is usable to rotate around XY screen axis inside the circular threshold area and to rotate around Z screen axis outside this area. More...
 
void Rotation (const Standard_Integer X, const Standard_Integer Y)
 Continues the rotation of the view with an angle computed from the last and new mouse position <X,Y>. More...
 
void SetFocale (const Standard_Real Focale)
 Change View Plane Distance for Perspective Views Warning! raises TypeMismatch from Standard if the view is not a perspective view. More...
 
Standard_Real Focale () const
 Returns the View Plane Distance for Perspective Views. More...
 
const Handle< Graphic3d_CView > & View () const
 Returns the associated Graphic3d view. More...
 
void SetComputedMode (const Standard_Boolean theMode)
 Switches computed HLR mode in the view. More...
 
Standard_Boolean ComputedMode () const
 Returns the computed HLR mode state. More...
 
void WindowFitAll (const Standard_Integer Xmin, const Standard_Integer Ymin, const Standard_Integer Xmax, const Standard_Integer Ymax)
 idem than WindowFit More...
 
Standard_Boolean FitMinMax (const Handle< Graphic3d_Camera > &theCamera, const Bnd_Box &theBox, const Standard_Real theMargin, const Standard_Real theResolution=0.0, const Standard_Boolean theToEnlargeIfLine=Standard_True) const
 Transform camera eye, center and scale to fit in the passed bounding box specified in WCS. More...
 
void SetGrid (const gp_Ax3 &aPlane, const Handle< Aspect_Grid > &aGrid)
 Defines or Updates the definition of the grid in <me> More...
 
void SetGridActivity (const Standard_Boolean aFlag)
 Defines or Updates the activity of the grid in <me> More...
 
Standard_Boolean Dump (const Standard_CString theFile, const Graphic3d_BufferType &theBufferType=Graphic3d_BT_RGB)
 Dumps the full contents of the View into the image file. This is an alias for ToPixMap() with Image_AlienPixMap. More...
 
Standard_Boolean ToPixMap (Image_PixMap &theImage, const V3d_ImageDumpOptions &theParams)
 Dumps the full contents of the view to a pixmap with specified parameters. Internally this method calls Redraw() with an offscreen render buffer of requested target size (theWidth x theHeight), so that there is no need resizing a window control for making a dump of different size. More...
 
Standard_Boolean ToPixMap (Image_PixMap &theImage, const Standard_Integer theWidth, const Standard_Integer theHeight, const Graphic3d_BufferType &theBufferType=Graphic3d_BT_RGB, const Standard_Boolean theToAdjustAspect=Standard_True, const V3d_StereoDumpOptions theStereoOptions=V3d_SDO_MONO)
 Dumps the full contents of the view to a pixmap. Internally this method calls Redraw() with an offscreen render buffer of requested target size (theWidth x theHeight), so that there is no need resizing a window control for making a dump of different size. More...
 
void SetBackFacingModel (const Graphic3d_TypeOfBackfacingModel theModel=Graphic3d_TypeOfBackfacingModel_Auto)
 Manages display of the back faces. More...
 
Graphic3d_TypeOfBackfacingModel BackFacingModel () const
 Returns current state of the back faces display; Graphic3d_TypeOfBackfacingModel_Auto by default, which means that backface culling is defined by each presentation. More...
 
virtual void AddClipPlane (const Handle< Graphic3d_ClipPlane > &thePlane)
 Adds clip plane to the view. The composition of clip planes truncates the rendering space to convex volume. Number of supported clip planes can be consulted by PlaneLimit method of associated Graphic3d_GraphicDriver. Please be aware that the planes which exceed the limit are ignored during rendering. More...
 
virtual void RemoveClipPlane (const Handle< Graphic3d_ClipPlane > &thePlane)
 Removes clip plane from the view. More...
 
const Handle< Graphic3d_SequenceOfHClipPlane > & ClipPlanes () const
 Get clip planes. More...
 
void SetClipPlanes (const Handle< Graphic3d_SequenceOfHClipPlane > &thePlanes)
 Sets sequence of clip planes to the view. The planes that have been set before are removed from the view. The composition of clip planes truncates the rendering space to convex volume. Number of supported clip planes can be consulted by InquirePlaneLimit method of Graphic3d_GraphicDriver. Please be aware that the planes that exceed the limit are ignored during rendering. More...
 
Standard_Integer PlaneLimit () const
 Returns the MAX number of clipping planes associated to the view. More...
 
void SetCamera (const Handle< Graphic3d_Camera > &theCamera)
 Change camera used by view. More...
 
const Handle< Graphic3d_Camera > & Camera () const
 Returns camera object of the view. More...
 
const Handle< Graphic3d_Camera > & DefaultCamera () const
 Return default camera. More...
 
const Graphic3d_RenderingParamsRenderingParams () const
 Returns current rendering parameters and effect settings. By default it returns default parameters of current viewer. To define view-specific settings use method V3d_View::ChangeRenderingParams(). More...
 
Graphic3d_RenderingParamsChangeRenderingParams ()
 Returns reference to current rendering parameters and effect settings. More...
 
Standard_Boolean IsCullingEnabled () const
 
void SetFrustumCulling (Standard_Boolean theMode)
 Turn on/off automatic culling of objects outside frustum (ON by default) More...
 
void DiagnosticInformation (TColStd_IndexedDataMapOfStringString &theDict, Graphic3d_DiagnosticInfo theFlags) const
 Fill in the dictionary with diagnostic info. Should be called within rendering thread. More...
 
TCollection_AsciiString StatisticInformation () const
 Returns string with statistic performance info. More...
 
void StatisticInformation (TColStd_IndexedDataMapOfStringString &theDict) const
 Fills in the dictionary with statistic performance info. More...
 
gp_Pnt GravityPoint () const
 Returns the Objects number and the gravity center of ALL viewable points in the view. More...
 
void DumpJson (Standard_OStream &theOStream, Standard_Integer theDepth=-1) const
 Dumps the content of me into the stream. More...
 
subvew management
bool IsSubview () const
 Return TRUE if this is a subview of another view. More...
 
V3d_ViewParentView ()
 Return parent View or NULL if this is not a subview. More...
 
const NCollection_Sequence< Handle< V3d_View > > & Subviews () const
 Return subview list. More...
 
Handle< V3d_ViewPickSubview (const Graphic3d_Vec2i &thePnt) const
 Pick subview from the given 2D point. More...
 
void AddSubview (const Handle< V3d_View > &theView)
 Add subview to the list. More...
 
bool RemoveSubview (const V3d_View *theView)
 Remove subview from the list. More...
 
- Public Member Functions inherited from Standard_Transient
 Standard_Transient ()
 Empty constructor. More...
 
 Standard_Transient (const Standard_Transient &)
 Copy constructor – does nothing. More...
 
Standard_Transientoperator= (const Standard_Transient &)
 Assignment operator, needed to avoid copying reference counter. More...
 
virtual ~Standard_Transient ()
 Destructor must be virtual. More...
 
virtual void Delete () const
 Memory deallocator for transient classes. More...
 
virtual const opencascade::handle< Standard_Type > & DynamicType () const
 Returns a type descriptor about this object. More...
 
Standard_Boolean IsInstance (const opencascade::handle< Standard_Type > &theType) const
 Returns a true value if this is an instance of Type. More...
 
Standard_Boolean IsInstance (const Standard_CString theTypeName) const
 Returns a true value if this is an instance of TypeName. More...
 
Standard_Boolean IsKind (const opencascade::handle< Standard_Type > &theType) const
 Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_Boolean IsKind (const Standard_CString theTypeName) const
 Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...
 
Standard_TransientThis () const
 Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...
 
Standard_Integer GetRefCount () const
 Get the reference counter of this object. More...
 
void IncrementRefCounter () const
 Increments the reference counter of this object. More...
 
Standard_Integer DecrementRefCounter () const
 Decrements the reference counter of this object; returns the decremented value. More...
 

deprecated methods

Standard_Real myOldMouseX
 Returns True if One light more can be activated in this View. More...
 
Standard_Real myOldMouseY
 Returns True if One light more can be activated in this View. More...
 
gp_Dir myCamStartOpUp
 Returns True if One light more can be activated in this View. More...
 
gp_Dir myCamStartOpDir
 Returns True if One light more can be activated in this View. More...
 
gp_Pnt myCamStartOpEye
 Returns True if One light more can be activated in this View. More...
 
gp_Pnt myCamStartOpCenter
 Returns True if One light more can be activated in this View. More...
 
Handle< Graphic3d_CameramyDefaultCamera
 Returns True if One light more can be activated in this View. More...
 
Handle< Graphic3d_CViewmyView
 Returns True if One light more can be activated in this View. More...
 
Standard_Boolean myImmediateUpdate
 Returns True if One light more can be activated in this View. More...
 
Standard_Boolean myIsInvalidatedImmediate
 Returns True if One light more can be activated in this View. More...
 
Standard_Boolean IfMoreLights () const
 Returns True if One light more can be activated in this View. More...
 
void InitActiveLights ()
 initializes an iteration on the active Lights. More...
 
Standard_Boolean MoreActiveLights () const
 returns true if there are more active Light(s) to return. More...
 
void NextActiveLights ()
 Go to the next active Light (if there is not, ActiveLight will raise an exception) More...
 
const Handle< V3d_Light > & ActiveLight () const
 
void ImmediateUpdate () const
 Returns True if One light more can be activated in this View. More...
 
void Scale (const Handle< Graphic3d_Camera > &theCamera, const Standard_Real theSizeXv, const Standard_Real theSizeYv) const
 Scales camera to fit the view frame of defined width and height keeping the aspect. For orthogonal camera the method changes scale, for perspective adjusts Eye location about the Center point. More...
 
void Translate (const Handle< Graphic3d_Camera > &theCamera, const Standard_Real theDXv, const Standard_Real theDYv) const
 Returns True if One light more can be activated in this View. More...
 

Additional Inherited Members

- Public Types inherited from Standard_Transient
typedef void base_type
 Returns a type descriptor about this object. More...
 
- Static Public Member Functions inherited from Standard_Transient
static const char * get_type_name ()
 Returns a type descriptor about this object. More...
 
static const opencascade::handle< Standard_Type > & get_type_descriptor ()
 Returns type descriptor of Standard_Transient class. More...
 

Detailed Description

Defines the application object VIEW for the VIEWER application. The methods of this class allow the editing and inquiring the parameters linked to the view. Provides a set of services common to all types of view. Warning: The default parameters are defined by the class Viewer (Example : SetDefaultViewSize()). Certain methods are mouse oriented, and it is necessary to know the difference between the start and the continuation of this gesture in putting the method into operation. Example : Shifting the eye-view along the screen axes.

View->Move(10.,20.,0.,True) (Starting motion) View->Move(15.,-5.,0.,False) (Next motion)

Constructor & Destructor Documentation

◆ V3d_View() [1/2]

V3d_View::V3d_View ( const Handle< V3d_Viewer > &  theViewer,
const V3d_TypeOfView  theType = V3d_ORTHOGRAPHIC 
)

Initializes the view.

◆ V3d_View() [2/2]

V3d_View::V3d_View ( const Handle< V3d_Viewer > &  theViewer,
const Handle< V3d_View > &  theView 
)

Initializes the view by copying.

◆ ~V3d_View()

virtual V3d_View::~V3d_View ( )
virtual

Default destructor.

Member Function Documentation

◆ ActiveLight()

const Handle< V3d_Light >& V3d_View::ActiveLight ( ) const
inline
Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ ActiveLightIterator()

V3d_ListOfLightIterator V3d_View::ActiveLightIterator ( ) const
inline

Return iterator for defined lights.

◆ ActiveLights()

const V3d_ListOfLight& V3d_View::ActiveLights ( ) const
inline

Returns a list of active lights.

◆ AddClipPlane()

virtual void V3d_View::AddClipPlane ( const Handle< Graphic3d_ClipPlane > &  thePlane)
virtual

Adds clip plane to the view. The composition of clip planes truncates the rendering space to convex volume. Number of supported clip planes can be consulted by PlaneLimit method of associated Graphic3d_GraphicDriver. Please be aware that the planes which exceed the limit are ignored during rendering.

Parameters
thePlane[in] the clip plane to be added to view.

◆ AddSubview()

void V3d_View::AddSubview ( const Handle< V3d_View > &  theView)

Add subview to the list.

◆ At()

void V3d_View::At ( Standard_Real X,
Standard_Real Y,
Standard_Real Z 
) const

Returns the position of the view point.

◆ AutoZFit()

void V3d_View::AutoZFit ( ) const

If automatic z-range fitting is turned on, adjusts Z-min and Z-max projection volume planes with call to ZFitAll.

◆ AutoZFitMode()

Standard_Boolean V3d_View::AutoZFitMode ( ) const
inline

returns TRUE if automatic z-fit mode is turned on.

◆ AutoZFitScaleFactor()

Standard_Real V3d_View::AutoZFitScaleFactor ( ) const
inline

returns scale factor parameter of automatic z-fit mode.

◆ AxialScale() [1/2]

void V3d_View::AxialScale ( const Standard_Integer  Dx,
const Standard_Integer  Dy,
const V3d_TypeOfAxe  Axis 
)

Performs anisotropic scaling of <me> view along the given <Axis>. The scale factor is calculated on a basis of the mouse pointer displacement <Dx,Dy>. The calculated scale factor is then passed to SetAxialScale(Sx, Sy, Sz) method.

◆ AxialScale() [2/2]

void V3d_View::AxialScale ( Standard_Real Sx,
Standard_Real Sy,
Standard_Real Sz 
) const

Returns the current values of the anisotropic (axial) scale factors.

◆ BackFacingModel()

Graphic3d_TypeOfBackfacingModel V3d_View::BackFacingModel ( ) const

Returns current state of the back faces display; Graphic3d_TypeOfBackfacingModel_Auto by default, which means that backface culling is defined by each presentation.

◆ BackgroundColor() [1/2]

Quantity_Color V3d_View::BackgroundColor ( ) const

Returns the Background color object of the view.

◆ BackgroundColor() [2/2]

void V3d_View::BackgroundColor ( const Quantity_TypeOfColor  Type,
Standard_Real V1,
Standard_Real V2,
Standard_Real V3 
) const

Returns the Background color values of the view depending of the color Type.

◆ BackgroundSkydome()

const Aspect_SkydomeBackground& V3d_View::BackgroundSkydome ( ) const
inline

Returns skydome aspect;.

◆ Camera()

const Handle< Graphic3d_Camera >& V3d_View::Camera ( ) const

Returns camera object of the view.

Returns
: handle to camera object, or NULL if 3D view does not use the camera approach.

◆ ChangeRenderingParams()

Graphic3d_RenderingParams& V3d_View::ChangeRenderingParams ( )

Returns reference to current rendering parameters and effect settings.

◆ ClearPBREnvironment()

void V3d_View::ClearPBREnvironment ( Standard_Boolean  theToUpdate = Standard_False)
inline

Disables IBL from background cubemap; fills PBR specular probe and irradiance map with white color.

◆ ClipPlanes()

const Handle< Graphic3d_SequenceOfHClipPlane >& V3d_View::ClipPlanes ( ) const

Get clip planes.

Returns
sequence clip planes that have been set for the view

◆ ComputedMode()

Standard_Boolean V3d_View::ComputedMode ( ) const

Returns the computed HLR mode state.

◆ Convert() [1/6]

Standard_Real V3d_View::Convert ( const Standard_Integer  Vp) const

Converts the PIXEL value to a value in the projection plane.

◆ Convert() [2/6]

void V3d_View::Convert ( const Standard_Integer  Xp,
const Standard_Integer  Yp,
Standard_Real X,
Standard_Real Y,
Standard_Real Z 
) const

Converts the projected point into a point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector.

◆ Convert() [3/6]

void V3d_View::Convert ( const Standard_Integer  Xp,
const Standard_Integer  Yp,
Standard_Real Xv,
Standard_Real Yv 
) const

Converts the point PIXEL into a point projected in the reference frame of the projection plane.

◆ Convert() [4/6]

Standard_Integer V3d_View::Convert ( const Standard_Real  Vv) const

Converts tha value of the projection plane into a PIXEL value.

◆ Convert() [5/6]

void V3d_View::Convert ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
Standard_Integer Xp,
Standard_Integer Yp 
) const

Projects the point defined in the reference frame of the view into the projected point in the associated window.

◆ Convert() [6/6]

void V3d_View::Convert ( const Standard_Real  Xv,
const Standard_Real  Yv,
Standard_Integer Xp,
Standard_Integer Yp 
) const

Converts the point defined in the reference frame of the projection plane into a point PIXEL.

◆ ConvertToGrid() [1/2]

void V3d_View::ConvertToGrid ( const Standard_Integer  Xp,
const Standard_Integer  Yp,
Standard_Real Xg,
Standard_Real Yg,
Standard_Real Zg 
) const

Converts the projected point into the nearest grid point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector and display the grid marker. Warning: When the grid is not active the result is identical to the above Convert() method. How to use: 1) Enable the grid echo display myViewer->SetGridEcho(Standard_True); 2) When application receive a move event: 2.1) Check if any object is detected if( myInteractiveContext->MoveTo(x,y) == AIS_SOD_Nothing ) { 2.2) Check if the grid is active if( myViewer->Grid()->IsActive() ) { 2.3) Display the grid echo and gets the grid point myView->ConvertToGrid(x,y,X,Y,Z); myView->Viewer()->ShowGridEcho (myView, Graphic3d_Vertex (X,Y,Z)); myView->RedrawImmediate(); 2.4) Else this is the standard case } else myView->Convert(x,y,X,Y,Z);.

◆ ConvertToGrid() [2/2]

void V3d_View::ConvertToGrid ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
Standard_Real Xg,
Standard_Real Yg,
Standard_Real Zg 
) const

Converts the point into the nearest grid point and display the grid marker.

◆ ConvertWithProj()

void V3d_View::ConvertWithProj ( const Standard_Integer  Xp,
const Standard_Integer  Yp,
Standard_Real X,
Standard_Real Y,
Standard_Real Z,
Standard_Real Vx,
Standard_Real Vy,
Standard_Real Vz 
) const

Converts the projected point into a point in the reference frame of the view corresponding to the intersection with the projection plane of the eye/view point vector and returns the projection ray for further computations.

◆ DefaultCamera()

const Handle< Graphic3d_Camera >& V3d_View::DefaultCamera ( ) const
inline

Return default camera.

◆ Depth()

Standard_Real V3d_View::Depth ( ) const

Returns the Distance between the Eye and View Point.

◆ DepthFitAll()

void V3d_View::DepthFitAll ( const Standard_Real  Aspect = 0.01,
const Standard_Real  Margin = 0.01 
)

Adjusts the viewing volume so as not to clip the displayed objects by front and back and back clipping planes. Also sets depth value automatically depending on the calculated Z size and Aspect parameter. NOTE than the original XY size of the view is NOT modified .

◆ DiagnosticInformation()

void V3d_View::DiagnosticInformation ( TColStd_IndexedDataMapOfStringString theDict,
Graphic3d_DiagnosticInfo  theFlags 
) const

Fill in the dictionary with diagnostic info. Should be called within rendering thread.

This API should be used only for user output or for creating automated reports. The format of returned information (e.g. key-value layout) is NOT part of this API and can be changed at any time. Thus application should not parse returned information to weed out specific parameters.

Parameters
theDictdestination map for information
theFlagsdefines the information to be retrieved

◆ DoMapping()

void V3d_View::DoMapping ( )

Must be called when the window supporting the view is mapped or unmapped.

◆ Dump()

Standard_Boolean V3d_View::Dump ( const Standard_CString  theFile,
const Graphic3d_BufferType theBufferType = Graphic3d_BT_RGB 
)

Dumps the full contents of the View into the image file. This is an alias for ToPixMap() with Image_AlienPixMap.

Parameters
theFiledestination image file (image format is determined by file extension like .png, .bmp, .jpg)
theBufferTypebuffer to dump
Returns
FALSE when the dump has failed

◆ DumpJson()

void V3d_View::DumpJson ( Standard_OStream theOStream,
Standard_Integer  theDepth = -1 
) const

Dumps the content of me into the stream.

◆ Eye()

void V3d_View::Eye ( Standard_Real X,
Standard_Real Y,
Standard_Real Z 
) const

Returns the position of the eye.

◆ FitAll() [1/3]

void V3d_View::FitAll ( const Bnd_Box theBox,
const Standard_Real  theMargin = 0.01,
const Standard_Boolean  theToUpdate = Standard_True 
)

Adjust view parameters to fit the displayed scene, respecting height / width ratio according to the custom bounding box given. Throws program error exception if margin coefficient is < 0 or >= 1. Updates the view.

Parameters
theBox[in] the custom bounding box to fit.
theMargin[in] the margin coefficient for view borders.
theToUpdate[in] flag to perform view update.

◆ FitAll() [2/3]

void V3d_View::FitAll ( const Standard_Real  theMargin = 0.01,
const Standard_Boolean  theToUpdate = Standard_True 
)

Adjust view parameters to fit the displayed scene, respecting height / width ratio. The Z clipping range (depth range) is fitted if AutoZFit flag is TRUE. Throws program error exception if margin coefficient is < 0 or >= 1. Updates the view.

Parameters
theMargin[in] the margin coefficient for view borders.
theToUpdate[in] flag to perform view update.

◆ FitAll() [3/3]

void V3d_View::FitAll ( const Standard_Real  theMinXv,
const Standard_Real  theMinYv,
const Standard_Real  theMaxXv,
const Standard_Real  theMaxYv 
)

Centers the defined projection window so that it occupies the maximum space while respecting the initial height/width ratio. NOTE than the original Z size of the view is NOT modified .

◆ FitMinMax()

Standard_Boolean V3d_View::FitMinMax ( const Handle< Graphic3d_Camera > &  theCamera,
const Bnd_Box theBox,
const Standard_Real  theMargin,
const Standard_Real  theResolution = 0.0,
const Standard_Boolean  theToEnlargeIfLine = Standard_True 
) const

Transform camera eye, center and scale to fit in the passed bounding box specified in WCS.

Parameters
theCamera[in] the camera
theBox[in] the bounding box
theMargin[in] the margin coefficient for view borders
theResolution[in] the minimum size of projection of bounding box in Xv or Yv direction when it considered to be a thin plane or point (without a volume); in this case only the center of camera is adjusted
theToEnlargeIfLine[in] when TRUE - in cases when the whole bounding box projected into thin line going along Z-axis of screen, the view plane is enlarged such thatwe see the whole line on rotation, otherwise only the center of camera is adjusted.
Returns
TRUE if the fit all operation can be done

◆ Focale()

Standard_Real V3d_View::Focale ( ) const

Returns the View Plane Distance for Perspective Views.

◆ FocalReferencePoint()

void V3d_View::FocalReferencePoint ( Standard_Real X,
Standard_Real Y,
Standard_Real Z 
) const
inline

Returns the position of point which emanating the projections.

◆ GeneratePBREnvironment()

void V3d_View::GeneratePBREnvironment ( Standard_Boolean  theToUpdate = Standard_False)
inline

Activates IBL from background cubemap.

◆ GetGraduatedTrihedron()

const Graphic3d_GraduatedTrihedron& V3d_View::GetGraduatedTrihedron ( ) const

Returns data of a graduated trihedron.

◆ GradientBackground()

Aspect_GradientBackground V3d_View::GradientBackground ( ) const

Returns the gradient background of the view.

◆ GradientBackgroundColors()

void V3d_View::GradientBackgroundColors ( Quantity_Color theColor1,
Quantity_Color theColor2 
) const

Returns the gradient background colors of the view.

◆ GraduatedTrihedronDisplay()

void V3d_View::GraduatedTrihedronDisplay ( const Graphic3d_GraduatedTrihedron theTrihedronData)

Displays a graduated trihedron.

◆ GraduatedTrihedronErase()

void V3d_View::GraduatedTrihedronErase ( )

Erases a graduated trihedron from the view.

◆ GravityPoint()

gp_Pnt V3d_View::GravityPoint ( ) const

Returns the Objects number and the gravity center of ALL viewable points in the view.

◆ IfMoreLights()

Standard_Boolean V3d_View::IfMoreLights ( ) const

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ IfWindow()

Standard_Boolean V3d_View::IfWindow ( ) const

Returns True if MyView is associated with a window .

◆ ImmediateUpdate()

void V3d_View::ImmediateUpdate ( ) const
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ InitActiveLights()

void V3d_View::InitActiveLights ( )
inline

initializes an iteration on the active Lights.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ Invalidate()

void V3d_View::Invalidate ( ) const

Invalidates view content but does not redraw it.

◆ InvalidateImmediate()

void V3d_View::InvalidateImmediate ( )
inline

Invalidates view content within immediate layer but does not redraw it.

◆ IsActiveLight()

Standard_Boolean V3d_View::IsActiveLight ( const Handle< V3d_Light > &  theLight) const

Returns TRUE when the light is active in this view.

◆ IsCullingEnabled()

Standard_Boolean V3d_View::IsCullingEnabled ( ) const
inline
Returns
flag value of objects culling mechanism

◆ IsEmpty()

Standard_Boolean V3d_View::IsEmpty ( ) const

Returns the status of the view regarding the displayed structures inside Returns True is The View is empty.

◆ IsImageBasedLighting()

Standard_Boolean V3d_View::IsImageBasedLighting ( ) const

Returns TRUE if IBL (Image Based Lighting) from background cubemap is enabled.

◆ IsInvalidated()

Standard_Boolean V3d_View::IsInvalidated ( ) const

Returns true if cached view content has been invalidated.

◆ IsInvalidatedImmediate()

Standard_Boolean V3d_View::IsInvalidatedImmediate ( ) const
inline

Returns true if immediate layer content has been invalidated.

◆ IsSubview()

bool V3d_View::IsSubview ( ) const
inline

Return TRUE if this is a subview of another view.

◆ LightLimit()

Standard_Integer V3d_View::LightLimit ( ) const

Returns the MAX number of light associated to the view.

◆ MoreActiveLights()

Standard_Boolean V3d_View::MoreActiveLights ( ) const
inline

returns true if there are more active Light(s) to return.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ Move() [1/3]

void V3d_View::Move ( const Standard_Real  Dx,
const Standard_Real  Dy,
const Standard_Real  Dz,
const Standard_Boolean  Start = Standard_True 
)

Movement of the eye parallel to the coordinate system of reference of the screen a distance relative to the initial position expressed by Start = Standard_True.

◆ Move() [2/3]

void V3d_View::Move ( const Standard_Real  Length,
const Standard_Boolean  Start = Standard_True 
)

Movement of the eye parllel to the current axis a distance relative to the initial position expressed by Start = Standard_True.

◆ Move() [3/3]

void V3d_View::Move ( const V3d_TypeOfAxe  Axe,
const Standard_Real  Length,
const Standard_Boolean  Start = Standard_True 
)

Movement of the eye parallel to one of the axes of the coordinate system of reference of the view a distance relative to the initial position expressed by Start = Standard_True.

◆ MustBeResized()

void V3d_View::MustBeResized ( )

Must be called when the window supporting the view changes size. if the view is not mapped on a window. Warning: The view is centered and resized to preserve the height/width ratio of the window.

◆ NextActiveLights()

void V3d_View::NextActiveLights ( )
inline

Go to the next active Light (if there is not, ActiveLight will raise an exception)

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ Pan()

void V3d_View::Pan ( const Standard_Integer  theDXp,
const Standard_Integer  theDYp,
const Standard_Real  theZoomFactor = 1,
const Standard_Boolean  theToStart = Standard_True 
)

Translates the center of the view along "x" and "y" axes of view projection. Can be used to perform interactive panning operation. In that case the DXp, DXp parameters specify panning relative to the point where the operation is started.

Parameters
theDXp[in] the relative panning on "x" axis of view projection, in pixels.
theDYp[in] the relative panning on "y" axis of view projection, in pixels.
theZoomFactor[in] the zooming factor.
theToStart[in] pass TRUE when starting panning to remember view state prior to panning for relative arguments. Passing 0 for relative panning parameter should return view panning to initial state. Performs update of view.

◆ Panning()

void V3d_View::Panning ( const Standard_Real  theDXv,
const Standard_Real  theDYv,
const Standard_Real  theZoomFactor = 1,
const Standard_Boolean  theToStart = Standard_True 
)

Translates the center of the view along "x" and "y" axes of view projection. Can be used to perform interactive panning operation. In that case the DXv, DXy parameters specify panning relative to the point where the operation is started.

Parameters
theDXv[in] the relative panning on "x" axis of view projection, in view space coordinates.
theDYv[in] the relative panning on "y" axis of view projection, in view space coordinates.
theZoomFactor[in] the zooming factor.
theToStart[in] pass TRUE when starting panning to remember view state prior to panning for relative arguments. If panning is started, passing {0, 0} for {theDXv, theDYv} will return view to initial state. Performs update of view.

◆ ParentView()

V3d_View* V3d_View::ParentView ( )
inline

Return parent View or NULL if this is not a subview.

◆ PickSubview()

Handle< V3d_View > V3d_View::PickSubview ( const Graphic3d_Vec2i thePnt) const

Pick subview from the given 2D point.

◆ Place()

void V3d_View::Place ( const Standard_Integer  theXp,
const Standard_Integer  theYp,
const Standard_Real  theZoomFactor = 1 
)

places the point of the view corresponding at the pixel position x,y at the center of the window and updates the view.

◆ PlaneLimit()

Standard_Integer V3d_View::PlaneLimit ( ) const

Returns the MAX number of clipping planes associated to the view.

◆ Proj()

void V3d_View::Proj ( Standard_Real Vx,
Standard_Real Vy,
Standard_Real Vz 
) const

Returns the projection vector.

◆ Project() [1/2]

void V3d_View::Project ( const Standard_Real  theX,
const Standard_Real  theY,
const Standard_Real  theZ,
Standard_Real theXp,
Standard_Real theYp 
) const

Converts the point defined in the user space of the view to the projection plane at the depth relative to theZ.

◆ Project() [2/2]

void V3d_View::Project ( const Standard_Real  theX,
const Standard_Real  theY,
const Standard_Real  theZ,
Standard_Real theXp,
Standard_Real theYp,
Standard_Real theZp 
) const

Converts the point defined in the user space of the view to the projection plane at the depth relative to theZ.

◆ ProjReferenceAxe()

void V3d_View::ProjReferenceAxe ( const Standard_Integer  Xpix,
const Standard_Integer  Ypix,
Standard_Real XP,
Standard_Real YP,
Standard_Real ZP,
Standard_Real VX,
Standard_Real VY,
Standard_Real VZ 
) const

Returns the coordinate of the point (Xpix,Ypix) in the view (XP,YP,ZP), and the projection vector of the view passing by the point (for PerspectiveView).

◆ Redraw()

virtual void V3d_View::Redraw ( ) const
virtual

Redisplays the view even if there has not been any modification. Must be called if the view is shown. (Ex: DeIconification ) .

◆ RedrawImmediate()

virtual void V3d_View::RedrawImmediate ( ) const
virtual

Updates layer of immediate presentations.

◆ Remove()

void V3d_View::Remove ( )

Destroys the view.

◆ RemoveClipPlane()

virtual void V3d_View::RemoveClipPlane ( const Handle< Graphic3d_ClipPlane > &  thePlane)
virtual

Removes clip plane from the view.

Parameters
thePlane[in] the clip plane to be removed from view.

◆ RemoveSubview()

bool V3d_View::RemoveSubview ( const V3d_View theView)

Remove subview from the list.

◆ RenderingParams()

const Graphic3d_RenderingParams& V3d_View::RenderingParams ( ) const

Returns current rendering parameters and effect settings. By default it returns default parameters of current viewer. To define view-specific settings use method V3d_View::ChangeRenderingParams().

See also
V3d_Viewer::DefaultRenderingParams()

◆ Reset()

void V3d_View::Reset ( const Standard_Boolean  theToUpdate = Standard_True)

Resets the centering and the orientation of the view.

◆ ResetViewMapping()

void V3d_View::ResetViewMapping ( )

Resets the centering of the view. Updates the view.

◆ ResetViewOrientation()

void V3d_View::ResetViewOrientation ( )

Resets the orientation of the view. Updates the view.

◆ Rotate() [1/5]

void V3d_View::Rotate ( const Standard_Real  Angle,
const Standard_Boolean  Start = Standard_True 
)

Rotates the eye around the current axis a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True.

◆ Rotate() [2/5]

void V3d_View::Rotate ( const Standard_Real  Ax,
const Standard_Real  Ay,
const Standard_Real  Az,
const Standard_Boolean  Start = Standard_True 
)

Rotates the eye about the coordinate system of reference of the screen for which the origin is the view point of the projection, with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True Warning! raises BadValue from V3d If the eye, the view point, or the high point are aligned or confused.

◆ Rotate() [3/5]

void V3d_View::Rotate ( const Standard_Real  Ax,
const Standard_Real  Ay,
const Standard_Real  Az,
const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Boolean  Start = Standard_True 
)

Rotates the eye about the coordinate system of reference of the screen for which the origin is Gravity point {X,Y,Z}, with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True If the eye, the view point, or the high point are aligned or confused.

◆ Rotate() [4/5]

void V3d_View::Rotate ( const V3d_TypeOfAxe  Axe,
const Standard_Real  Angle,
const Standard_Boolean  Start = Standard_True 
)

Rotates the eye about one of the coordinate axes of of the view for which the origin is the view point of the projection with an relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True.

◆ Rotate() [5/5]

void V3d_View::Rotate ( const V3d_TypeOfAxe  Axe,
const Standard_Real  Angle,
const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Boolean  Start = Standard_True 
)

Rotates the eye about one of the coordinate axes of of the view for which the origin is the Gravity point{X,Y,Z} with an relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True.

◆ Rotation()

void V3d_View::Rotation ( const Standard_Integer  X,
const Standard_Integer  Y 
)

Continues the rotation of the view with an angle computed from the last and new mouse position <X,Y>.

◆ Scale() [1/2]

Standard_Real V3d_View::Scale ( ) const

Returns the current value of the zoom expressed with respect to SetViewMappingDefault().

◆ Scale() [2/2]

void V3d_View::Scale ( const Handle< Graphic3d_Camera > &  theCamera,
const Standard_Real  theSizeXv,
const Standard_Real  theSizeYv 
) const
protected

Scales camera to fit the view frame of defined width and height keeping the aspect. For orthogonal camera the method changes scale, for perspective adjusts Eye location about the Center point.

Parameters
theSizeXv[in] size of viewport frame on "x" axis.
theSizeYv[in] size of viewport frame on "y" axis.

◆ SetAt()

void V3d_View::SetAt ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z 
)

Defines the position of the view point.

◆ SetAutoZFitMode()

void V3d_View::SetAutoZFitMode ( const Standard_Boolean  theIsOn,
const Standard_Real  theScaleFactor = 1.0 
)

Sets the automatic z-fit mode and its parameters. The auto z-fit has extra parameters which can controlled from application level to ensure that the size of viewing volume will be sufficiently large to cover the depth of unmanaged objects, for example, transformation persistent ones.

Parameters
theScaleFactor[in] the scale factor for Z-range. The range between Z-min, Z-max projection volume planes evaluated by z fitting method will be scaled using this coefficient. Program error exception is thrown if negative or zero value is passed.

◆ SetAxialScale()

void V3d_View::SetAxialScale ( const Standard_Real  Sx,
const Standard_Real  Sy,
const Standard_Real  Sz 
)

Sets anisotropic (axial) scale factors <Sx>, <Sy>, <Sz> for view <me>. Anisotropic scaling operation is performed through multiplying the current view orientation matrix by a scaling matrix: || Sx 0 0 0 || || 0 Sy 0 0 || || 0 0 Sz 0 || || 0 0 0 1 || Updates the view.

◆ SetAxis()

void V3d_View::SetAxis ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z,
const Standard_Real  Vx,
const Standard_Real  Vy,
const Standard_Real  Vz 
)

Definition of an axis from its origin and its orientation . This will be the current axis for rotations and movements. Warning! raises BadValue from V3d if the vector normal is NULL. .

◆ SetBackFacingModel()

void V3d_View::SetBackFacingModel ( const Graphic3d_TypeOfBackfacingModel  theModel = Graphic3d_TypeOfBackfacingModel_Auto)

Manages display of the back faces.

◆ SetBackgroundColor() [1/2]

void V3d_View::SetBackgroundColor ( const Quantity_Color theColor)

Defines the background color of the view.

◆ SetBackgroundColor() [2/2]

void V3d_View::SetBackgroundColor ( const Quantity_TypeOfColor  theType,
const Standard_Real  theV1,
const Standard_Real  theV2,
const Standard_Real  theV3 
)

Defines the background color of the view by the color definition type and the three corresponding values.

◆ SetBackgroundCubeMap()

void V3d_View::SetBackgroundCubeMap ( const Handle< Graphic3d_CubeMap > &  theCubeMap,
Standard_Boolean  theToUpdatePBREnv = Standard_True,
Standard_Boolean  theToUpdate = Standard_False 
)

Sets environment cubemap as background.

Parameters
theCubeMapcubemap source to be set as background
theToUpdatePBREnvdefines whether IBL maps will be generated or not (see 'GeneratePBREnvironment')

◆ SetBackgroundImage() [1/2]

void V3d_View::SetBackgroundImage ( const Handle< Graphic3d_Texture2D > &  theTexture,
const Aspect_FillMethod  theFillStyle = Aspect_FM_CENTERED,
const Standard_Boolean  theToUpdate = Standard_False 
)

Defines the background texture of the view by supplying the texture and fill method (centered by default)

◆ SetBackgroundImage() [2/2]

void V3d_View::SetBackgroundImage ( const Standard_CString  theFileName,
const Aspect_FillMethod  theFillStyle = Aspect_FM_CENTERED,
const Standard_Boolean  theToUpdate = Standard_False 
)

Defines the background texture of the view by supplying the texture image file name and fill method (centered by default).

◆ SetBackgroundSkydome()

void V3d_View::SetBackgroundSkydome ( const Aspect_SkydomeBackground theAspect,
Standard_Boolean  theToUpdatePBREnv = Standard_True 
)

Sets skydome aspect.

Parameters
theAspectcubemap generation parameters
theToUpdatePBREnvdefines whether IBL maps will be generated or not

◆ SetBgGradientColors()

void V3d_View::SetBgGradientColors ( const Quantity_Color theColor1,
const Quantity_Color theColor2,
const Aspect_GradientFillMethod  theFillStyle = Aspect_GradientFillMethod_Horizontal,
const Standard_Boolean  theToUpdate = Standard_False 
)

Defines the gradient background colors of the view by supplying the colors and the fill method (horizontal by default).

◆ SetBgGradientStyle()

void V3d_View::SetBgGradientStyle ( const Aspect_GradientFillMethod  theMethod = Aspect_GradientFillMethod_Horizontal,
const Standard_Boolean  theToUpdate = Standard_False 
)

Defines the gradient background fill method of the view.

◆ SetBgImageStyle()

void V3d_View::SetBgImageStyle ( const Aspect_FillMethod  theFillStyle,
const Standard_Boolean  theToUpdate = Standard_False 
)

Defines the textured background fill method of the view.

◆ SetCamera()

void V3d_View::SetCamera ( const Handle< Graphic3d_Camera > &  theCamera)

Change camera used by view.

◆ SetCenter()

void V3d_View::SetCenter ( const Standard_Integer  theXp,
const Standard_Integer  theYp 
)

Relocates center of screen to the point, determined by {Xp, Yp} pixel coordinates relative to the bottom-left corner of screen. To calculate pixel coordinates for any point from world coordinate space, it can be projected using "Project".

Parameters
theXp[in] the x coordinate.
theYp[in] the y coordinate.

◆ SetClipPlanes()

void V3d_View::SetClipPlanes ( const Handle< Graphic3d_SequenceOfHClipPlane > &  thePlanes)

Sets sequence of clip planes to the view. The planes that have been set before are removed from the view. The composition of clip planes truncates the rendering space to convex volume. Number of supported clip planes can be consulted by InquirePlaneLimit method of Graphic3d_GraphicDriver. Please be aware that the planes that exceed the limit are ignored during rendering.

Parameters
thePlanes[in] the clip planes to set.

◆ SetComputedMode()

void V3d_View::SetComputedMode ( const Standard_Boolean  theMode)

Switches computed HLR mode in the view.

◆ SetDepth()

void V3d_View::SetDepth ( const Standard_Real  Depth)

Defines the Depth of the eye from the view point without update the projection .

◆ SetEye()

void V3d_View::SetEye ( const Standard_Real  X,
const Standard_Real  Y,
const Standard_Real  Z 
)

Defines the position of the eye..

◆ SetFocale()

void V3d_View::SetFocale ( const Standard_Real  Focale)

Change View Plane Distance for Perspective Views Warning! raises TypeMismatch from Standard if the view is not a perspective view.

◆ SetFront()

void V3d_View::SetFront ( )

modify the Projection of the view perpendicularly to the privileged plane of the viewer.

◆ SetFrustumCulling()

void V3d_View::SetFrustumCulling ( Standard_Boolean  theMode)
inline

Turn on/off automatic culling of objects outside frustum (ON by default)

◆ SetGrid()

void V3d_View::SetGrid ( const gp_Ax3 aPlane,
const Handle< Aspect_Grid > &  aGrid 
)

Defines or Updates the definition of the grid in <me>

◆ SetGridActivity()

void V3d_View::SetGridActivity ( const Standard_Boolean  aFlag)

Defines or Updates the activity of the grid in <me>

◆ SetImageBasedLighting()

void V3d_View::SetImageBasedLighting ( Standard_Boolean  theToEnableIBL,
Standard_Boolean  theToUpdate = Standard_False 
)

Enables or disables IBL (Image Based Lighting) from background cubemap. Has no effect if PBR is not used.

Parameters
[in]theToEnableIBLenable or disable IBL from background cubemap
[in]theToUpdateredraw the view

◆ SetImmediateUpdate()

Standard_Boolean V3d_View::SetImmediateUpdate ( const Standard_Boolean  theImmediateUpdate)

sets the immediate update mode and returns the previous one.

◆ SetLightOff() [1/2]

void V3d_View::SetLightOff ( )

Deactivate all the Lights defined in this view.

◆ SetLightOff() [2/2]

void V3d_View::SetLightOff ( const Handle< V3d_Light > &  theLight)

Deactivate theLight in this view.

◆ SetLightOn() [1/2]

void V3d_View::SetLightOn ( )

Activates all the lights defined in this view.

◆ SetLightOn() [2/2]

void V3d_View::SetLightOn ( const Handle< V3d_Light > &  theLight)

Activates theLight in the view.

◆ SetMagnify()

void V3d_View::SetMagnify ( const Handle< Aspect_Window > &  theWindow,
const Handle< V3d_View > &  thePreviousView,
const Standard_Integer  theX1,
const Standard_Integer  theY1,
const Standard_Integer  theX2,
const Standard_Integer  theY2 
)

◆ SetProj() [1/2]

void V3d_View::SetProj ( const Standard_Real  Vx,
const Standard_Real  Vy,
const Standard_Real  Vz 
)

Defines the orientation of the projection.

◆ SetProj() [2/2]

void V3d_View::SetProj ( const V3d_TypeOfOrientation  theOrientation,
const Standard_Boolean  theIsYup = Standard_False 
)

Defines the orientation of the projection .

Parameters
theOrientationcamera direction
theIsYupflag indicating Y-up (TRUE) or Z-up (FALSE) convention

◆ SetScale()

void V3d_View::SetScale ( const Standard_Real  Coef)

Zooms the view by a factor relative to the value initialised by SetViewMappingDefault(). Updates the view.

◆ SetShadingModel()

void V3d_View::SetShadingModel ( const Graphic3d_TypeOfShadingModel  theShadingModel)

Defines the shading model for the visualization.

◆ SetSize()

void V3d_View::SetSize ( const Standard_Real  theSize)

Defines the view projection size in its maximum dimension, keeping the initial height/width ratio unchanged.

◆ SetTextureEnv()

void V3d_View::SetTextureEnv ( const Handle< Graphic3d_TextureEnv > &  theTexture)

Sets the environment texture to use. No environment texture by default.

◆ SetTwist()

void V3d_View::SetTwist ( const Standard_Real  Angle)

Defines the angular position of the high point of the reference frame of the view with respect to the Y screen axis with an absolute angular value in RADIANS.

◆ SetUp() [1/2]

void V3d_View::SetUp ( const Standard_Real  Vx,
const Standard_Real  Vy,
const Standard_Real  Vz 
)

Defines the orientation of the high point.

◆ SetUp() [2/2]

void V3d_View::SetUp ( const V3d_TypeOfOrientation  Orientation)

Defines the orientation(SO) of the high point.

◆ SetViewMappingDefault()

void V3d_View::SetViewMappingDefault ( )

Saves the current view mapping. This will be the state returned from ResetViewmapping.

◆ SetViewOrientationDefault()

void V3d_View::SetViewOrientationDefault ( )

Saves the current state of the orientation of the view which will be the return state at ResetViewOrientation.

◆ SetVisualization()

void V3d_View::SetVisualization ( const V3d_TypeOfVisualization  theType)

Defines the visualization type in the view.

◆ SetWindow() [1/2]

void V3d_View::SetWindow ( const Handle< Aspect_Window > &  theWindow,
const Aspect_RenderingContext  theContext = NULL 
)

Activates the view in the specified Window If <aContext> is not NULL the graphic context is used to draw something in this view. Otherwise an internal graphic context is created. Warning: The view is centered and resized to preserve the height/width ratio of the window.

◆ SetWindow() [2/2]

void V3d_View::SetWindow ( const Handle< V3d_View > &  theParentView,
const Graphic3d_Vec2d theSize,
Aspect_TypeOfTriedronPosition  theCorner = Aspect_TOTP_LEFT_UPPER,
const Graphic3d_Vec2d theOffset = Graphic3d_Vec2d(),
const Graphic3d_Vec2i theMargins = Graphic3d_Vec2i() 
)

Activates the view as subview of another view.

Parameters
[in]theParentViewparent view to put subview into
[in]theSizesubview dimensions; values >= 2 define size in pixels, values <= 1.0 define size as a fraction of parent view
[in]theCornercorner within parent view
[in]theOffsetoffset from the corner; values >= 1 define offset in pixels, values < 1.0 define offset as a fraction of parent view
[in]theMarginssubview margins in pixels

Example: to split parent view horizontally into 2 subview, define one subview with Size=(0.5,1.0),Offset=(0.0,0.0), and 2nd with Size=(0.5,1.0),Offset=(5.0,0.0);

◆ SetZoom()

void V3d_View::SetZoom ( const Standard_Real  Coef,
const Standard_Boolean  Start = Standard_True 
)

Zooms the view by a factor relative to the initial value expressed by Start = Standard_True Updates the view.

◆ SetZSize()

void V3d_View::SetZSize ( const Standard_Real  SetZSize)

Defines the Depth size of the view Front Plane will be set to Size/2. Back Plane will be set to -Size/2. Any Object located Above the Front Plane or behind the Back Plane will be Clipped . NOTE than the XY Size of the View is NOT modified .

◆ ShadingModel()

Graphic3d_TypeOfShadingModel V3d_View::ShadingModel ( ) const

Returns the current shading model; Graphic3d_TypeOfShadingModel_Phong by default.

◆ Size()

void V3d_View::Size ( Standard_Real Width,
Standard_Real Height 
) const

Returns the height and width of the view.

◆ StartRotation()

void V3d_View::StartRotation ( const Standard_Integer  X,
const Standard_Integer  Y,
const Standard_Real  zRotationThreshold = 0.0 
)

Begin the rotation of the view around the screen axis according to the mouse position <X,Y>. Warning: Enable rotation around the Z screen axis when <zRotationThreshold> factor is > 0 soon the distance from the start point and the center of the view is > (medium viewSize * <zRotationThreshold> ). Generally a value of 0.4 is usable to rotate around XY screen axis inside the circular threshold area and to rotate around Z screen axis outside this area.

◆ StartZoomAtPoint()

void V3d_View::StartZoomAtPoint ( const Standard_Integer  theXp,
const Standard_Integer  theYp 
)

Defines starting point for ZoomAtPoint view operation.

Parameters
theXp[in] the x mouse coordinate, in pixels.
theYp[in] the y mouse coordinate, in pixels.

◆ StatisticInformation() [1/2]

TCollection_AsciiString V3d_View::StatisticInformation ( ) const

Returns string with statistic performance info.

◆ StatisticInformation() [2/2]

void V3d_View::StatisticInformation ( TColStd_IndexedDataMapOfStringString theDict) const

Fills in the dictionary with statistic performance info.

◆ Subviews()

const NCollection_Sequence<Handle< V3d_View > >& V3d_View::Subviews ( ) const
inline

Return subview list.

◆ TextureEnv()

Handle< Graphic3d_TextureEnv > V3d_View::TextureEnv ( ) const

◆ ToPixMap() [1/2]

Standard_Boolean V3d_View::ToPixMap ( Image_PixMap theImage,
const Standard_Integer  theWidth,
const Standard_Integer  theHeight,
const Graphic3d_BufferType theBufferType = Graphic3d_BT_RGB,
const Standard_Boolean  theToAdjustAspect = Standard_True,
const V3d_StereoDumpOptions  theStereoOptions = V3d_SDO_MONO 
)
inline

Dumps the full contents of the view to a pixmap. Internally this method calls Redraw() with an offscreen render buffer of requested target size (theWidth x theHeight), so that there is no need resizing a window control for making a dump of different size.

Parameters
theImagetarget image, will be re-allocated to match theWidth x theHeight
theWidthtarget image width
theHeighttarget image height
theBufferTypetype of the view buffer to dump (color / depth)
theToAdjustAspectwhen true, active view aspect ratio will be overridden by (theWidth / theHeight)
theStereoOptionshow to dump stereographic camera

◆ ToPixMap() [2/2]

Standard_Boolean V3d_View::ToPixMap ( Image_PixMap theImage,
const V3d_ImageDumpOptions theParams 
)

Dumps the full contents of the view to a pixmap with specified parameters. Internally this method calls Redraw() with an offscreen render buffer of requested target size (theWidth x theHeight), so that there is no need resizing a window control for making a dump of different size.

◆ Translate() [1/4]

void V3d_View::Translate ( const Handle< Graphic3d_Camera > &  theCamera,
const Standard_Real  theDXv,
const Standard_Real  theDYv 
) const
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ Translate() [2/4]

void V3d_View::Translate ( const Standard_Real  Dx,
const Standard_Real  Dy,
const Standard_Real  Dz,
const Standard_Boolean  Start = Standard_True 
)

Movement of the ye and the view point parallel to the frame of reference of the screen a distance relative to the initial position expressed by Start = Standard_True.

◆ Translate() [3/4]

void V3d_View::Translate ( const Standard_Real  Length,
const Standard_Boolean  Start = Standard_True 
)

Movement of the eye and view point parallel to the current axis a distance relative to the initial position expressed by Start = Standard_True.

◆ Translate() [4/4]

void V3d_View::Translate ( const V3d_TypeOfAxe  Axe,
const Standard_Real  Length,
const Standard_Boolean  Start = Standard_True 
)

Movement of the eye and the view point parallel to one of the axes of the fame of reference of the view a distance relative to the initial position expressed by Start = Standard_True.

◆ TriedronDisplay()

void V3d_View::TriedronDisplay ( const Aspect_TypeOfTriedronPosition  thePosition = Aspect_TOTP_CENTER,
const Quantity_Color theColor = Quantity_NOC_WHITE,
const Standard_Real  theScale = 0.02,
const V3d_TypeOfVisualization  theMode = V3d_WIREFRAME 
)

Display of the Triedron. Initialize position, color and length of Triedron axes. The scale is a percent of the window width.

◆ TriedronErase()

void V3d_View::TriedronErase ( )

Erases the Triedron.

◆ Trihedron()

const Handle< V3d_Trihedron >& V3d_View::Trihedron ( bool  theToCreate = true)
inline

Returns trihedron object.

◆ Turn() [1/3]

void V3d_View::Turn ( const Standard_Real  Angle,
const Standard_Boolean  Start = Standard_True 
)

Rotation of the view point around the current axis an angular value in RADIANS relative to the initial position expressed by Start = Standard_True.

◆ Turn() [2/3]

void V3d_View::Turn ( const Standard_Real  Ax,
const Standard_Real  Ay,
const Standard_Real  Az,
const Standard_Boolean  Start = Standard_True 
)

Rotation of the view point around the frame of reference of the screen for which the origin is the eye of the projection with a relative angular value in RADIANS with respect to the initial position expressed by Start = Standard_True.

◆ Turn() [3/3]

void V3d_View::Turn ( const V3d_TypeOfAxe  Axe,
const Standard_Real  Angle,
const Standard_Boolean  Start = Standard_True 
)

Rotation of the view point around one of the axes of the frame of reference of the view for which the origin is the eye of the projection with an angular value in RADIANS relative to the initial position expressed by Start = Standard_True.

◆ Twist()

Standard_Real V3d_View::Twist ( ) const

Returns in RADIANS the orientation of the view around the visual axis measured from the Y axis of the screen.

◆ Type()

V3d_TypeOfView V3d_View::Type ( ) const

Returns the Type of the View.

◆ Up()

void V3d_View::Up ( Standard_Real Vx,
Standard_Real Vy,
Standard_Real Vz 
) const

Returns the vector giving the position of the high point.

◆ Update()

void V3d_View::Update ( ) const

Deprecated, Redraw() should be used instead.

◆ UpdateLights()

void V3d_View::UpdateLights ( ) const

Updates the lights of the view.

◆ View()

const Handle< Graphic3d_CView >& V3d_View::View ( ) const
inline

Returns the associated Graphic3d view.

◆ Viewer()

Handle< V3d_Viewer > V3d_View::Viewer ( ) const
inline

Returns the viewer in which the view has been created.

◆ Visualization()

V3d_TypeOfVisualization V3d_View::Visualization ( ) const

Returns the current visualisation mode.

◆ Window()

const Handle< Aspect_Window >& V3d_View::Window ( ) const
inline

Returns the Aspect Window associated with the view.

◆ WindowFit()

void V3d_View::WindowFit ( const Standard_Integer  theMinXp,
const Standard_Integer  theMinYp,
const Standard_Integer  theMaxXp,
const Standard_Integer  theMaxYp 
)

Centers the defined PIXEL window so that it occupies the maximum space while respecting the initial height/width ratio. NOTE than the original Z size of the view is NOT modified.

Parameters
theMinXp[in] pixel coordinates of minimal corner on x screen axis.
theMinYp[in] pixel coordinates of minimal corner on y screen axis.
theMaxXp[in] pixel coordinates of maximal corner on x screen axis.
theMaxYp[in] pixel coordinates of maximal corner on y screen axis.

◆ WindowFitAll()

void V3d_View::WindowFitAll ( const Standard_Integer  Xmin,
const Standard_Integer  Ymin,
const Standard_Integer  Xmax,
const Standard_Integer  Ymax 
)
inline

idem than WindowFit

◆ ZBufferTriedronSetup()

void V3d_View::ZBufferTriedronSetup ( const Quantity_Color theXColor = Quantity_NOC_RED,
const Quantity_Color theYColor = Quantity_NOC_GREEN,
const Quantity_Color theZColor = Quantity_NOC_BLUE1,
const Standard_Real  theSizeRatio = 0.8,
const Standard_Real  theAxisDiametr = 0.05,
const Standard_Integer  theNbFacettes = 12 
)

Customization of the ZBUFFER Triedron. XColor,YColor,ZColor - colors of axis SizeRatio - ratio of decreasing of the trihedron size when its physical position comes out of the view AxisDiametr - diameter relatively to axis length NbFacettes - number of facets of cylinders and cones.

◆ ZFitAll()

void V3d_View::ZFitAll ( const Standard_Real  theScaleFactor = 1.0) const

Change Z-min and Z-max planes of projection volume to match the displayed objects.

◆ Zoom()

void V3d_View::Zoom ( const Standard_Integer  theXp1,
const Standard_Integer  theYp1,
const Standard_Integer  theXp2,
const Standard_Integer  theYp2 
)

Zoom the view according to a zoom factor computed from the distance between the 2 mouse position.

Parameters
theXp1[in] the x coordinate of first mouse position, in pixels.
theYp1[in] the y coordinate of first mouse position, in pixels.
theXp2[in] the x coordinate of second mouse position, in pixels.
theYp2[in] the y coordinate of second mouse position, in pixels.

◆ ZoomAtPoint()

void V3d_View::ZoomAtPoint ( const Standard_Integer  theMouseStartX,
const Standard_Integer  theMouseStartY,
const Standard_Integer  theMouseEndX,
const Standard_Integer  theMouseEndY 
)

Zooms the model at a pixel defined by the method StartZoomAtPoint().

◆ ZSize()

Standard_Real V3d_View::ZSize ( ) const

Returns the Depth of the view .

Field Documentation

◆ myCamStartOpCenter

gp_Pnt V3d_View::myCamStartOpCenter
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myCamStartOpDir

gp_Dir V3d_View::myCamStartOpDir
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myCamStartOpEye

gp_Pnt V3d_View::myCamStartOpEye
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myCamStartOpUp

gp_Dir V3d_View::myCamStartOpUp
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myDefaultCamera

Handle< Graphic3d_Camera > V3d_View::myDefaultCamera
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myImmediateUpdate

Standard_Boolean V3d_View::myImmediateUpdate
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myIsInvalidatedImmediate

Standard_Boolean V3d_View::myIsInvalidatedImmediate
mutableprotected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myOldMouseX

Standard_Real V3d_View::myOldMouseX
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myOldMouseY

Standard_Real V3d_View::myOldMouseY
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

◆ myView

Handle< Graphic3d_CView > V3d_View::myView
protected

Returns True if One light more can be activated in this View.

Deprecated:
("Deprecated method - ActiveLights() should be used instead")

The documentation for this class was generated from the following file: