Open CASCADE Technology  7.2.0
Public Member Functions | Protected Member Functions | Protected Attributes

V3d_PositionLight Class Referenceabstract

Base class for Positional, Spot and Directional Light classes. More...

#include <V3d_PositionLight.hxx>

Inheritance diagram for V3d_PositionLight:
Inheritance graph
[legend]

Public Member Functions

virtual void SetPosition (const Standard_Real theX, const Standard_Real theY, const Standard_Real theZ)=0
 Defines the position of the light source. Should be redefined! More...
 
void SetTarget (const Standard_Real theX, const Standard_Real theY, const Standard_Real theZ)
 Defines the target of the light (the center of the sphere). More...
 
void SetRadius (const Standard_Real theRadius)
 Define the radius. More...
 
void OnHideFace (const Handle< V3d_View > &theView)
 Calculate the position of the light, on the hide face of the picking sphere. More...
 
void OnSeeFace (const Handle< V3d_View > &theView)
 Calculate the position of the light, on the seen face of the picking sphere. More...
 
void Tracking (const Handle< V3d_View > &theView, const V3d_TypeOfPickLight theWathPick, const Standard_Integer theXpix, const Standard_Integer theYpix)
 Tracking the light position, or the light space, or the radius of the light space, that depends of initial picking "theWhatPick" (see the pick method). If theWhatPick is SPACELIGHT, then the parameters theXpix, theYpix are the coordinates of a translation vector. More...
 
virtual void Display (const Handle< V3d_View > &theView, const V3d_TypeOfRepresentation theRepresentation=V3d_SIMPLE)
 Display the graphic structure of light source in the chosen view. We have three type of representation. More...
 
void Erase ()
 Erase the graphic structure of light source. More...
 
Standard_Real Radius () const
 Returns the radius of the picking sphere. More...
 
Standard_Boolean SeeOrHide (const Handle< V3d_View > &theView) const
 Returns the visibility status If True the source is visible. If False it's hidden. More...
 
virtual void Position (Standard_Real &theX, Standard_Real &theY, Standard_Real &theZ) const =0
 Returns the position of the light source. More...
 
void Target (Standard_Real &theX, Standard_Real &theY, Standard_Real &theZ) const
 Returns the position of the target of the light source. More...
 
- Public Member Functions inherited from V3d_Light
void SetColor (const Quantity_Color &theColor)
 Defines the color of a light source by giving the basic color. More...
 
Quantity_Color Color () const
 Returns the color of the light source. More...
 
V3d_TypeOfLight Type () const
 Returns the Type of the Light. More...
 
Standard_Boolean Headlight () const
 returns true if the light is a headlight More...
 
void SetHeadlight (const Standard_Boolean theValue)
 Setup headlight flag. More...
 
void SetIntensity (const Standard_Real theValue)
 Modifies the intensity of light source. More...
 
Standard_Real Intensity () const
 returns the intensity of light source More...
 
Standard_Real Smoothness () const
 returns the smoothness of light source More...
 
Standard_Boolean IsDisplayed () const
 Returns TRUE when a light representation is displayed. 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...
 

Protected Member Functions

 V3d_PositionLight (const Handle< V3d_Viewer > &theViewer)
 
- Protected Member Functions inherited from V3d_Light
 V3d_Light (const Handle< V3d_Viewer > &theViewer)
 
void SetType (const V3d_TypeOfLight theType)
 Sets type of the light. More...
 
const Graphic3d_CLightLight () const
 Return light properties associated to this light source. Hidden method exposed only to V3d_View. More...
 

Protected Attributes

Graphic3d_Vertex myTarget
 
V3d_TypeOfRepresentation myTypeOfRepresentation
 
- Protected Attributes inherited from V3d_Light
Graphic3d_CLight myLight
 
Handle< Graphic3d_StructuremyGraphicStructure
 
Handle< Graphic3d_StructuremyGraphicStructure1
 

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...
 
- Static Protected Member Functions inherited from V3d_Light
static void SymetricPointOnSphere (const Handle< V3d_View > &aView, const Graphic3d_Vertex &Center, const Graphic3d_Vertex &aPoint, const Standard_Real Radius, Standard_Real &X, Standard_Real &Y, Standard_Real &Z, Standard_Real &VX, Standard_Real &VY, Standard_Real &VZ)
 Returns the symetric point coordinates of "aPoint" on the sphere of center "Center" and radius "Radius". VX,VY,VZ is the project vector of view. More...
 

Detailed Description

Base class for Positional, Spot and Directional Light classes.

Constructor & Destructor Documentation

◆ V3d_PositionLight()

V3d_PositionLight::V3d_PositionLight ( const Handle< V3d_Viewer > &  theViewer)
protected

Member Function Documentation

◆ Display()

virtual void V3d_PositionLight::Display ( const Handle< V3d_View > &  theView,
const V3d_TypeOfRepresentation  theRepresentation = V3d_SIMPLE 
)
virtual

Display the graphic structure of light source in the chosen view. We have three type of representation.

  • SIMPLE : Only the light source is displayed.
  • PARTIAL : The light source and the light space are displayed.
  • COMPLETE : The light source, the light space and the radius of light space are displayed. We can choose the "SAMELAST" as parameter of representation In this case the graphic structure representation will be the last displayed.

Reimplemented in V3d_SpotLight, V3d_PositionalLight, and V3d_DirectionalLight.

◆ Erase()

void V3d_PositionLight::Erase ( )

Erase the graphic structure of light source.

◆ OnHideFace()

void V3d_PositionLight::OnHideFace ( const Handle< V3d_View > &  theView)

Calculate the position of the light, on the hide face of the picking sphere.

◆ OnSeeFace()

void V3d_PositionLight::OnSeeFace ( const Handle< V3d_View > &  theView)

Calculate the position of the light, on the seen face of the picking sphere.

◆ Position()

virtual void V3d_PositionLight::Position ( Standard_Real theX,
Standard_Real theY,
Standard_Real theZ 
) const
pure virtual

Returns the position of the light source.

Implemented in V3d_SpotLight, V3d_PositionalLight, and V3d_DirectionalLight.

◆ Radius()

Standard_Real V3d_PositionLight::Radius ( ) const

Returns the radius of the picking sphere.

◆ SeeOrHide()

Standard_Boolean V3d_PositionLight::SeeOrHide ( const Handle< V3d_View > &  theView) const

Returns the visibility status If True the source is visible. If False it's hidden.

◆ SetPosition()

virtual void V3d_PositionLight::SetPosition ( const Standard_Real  theX,
const Standard_Real  theY,
const Standard_Real  theZ 
)
pure virtual

Defines the position of the light source. Should be redefined!

Implemented in V3d_SpotLight, V3d_PositionalLight, and V3d_DirectionalLight.

◆ SetRadius()

void V3d_PositionLight::SetRadius ( const Standard_Real  theRadius)

Define the radius.

◆ SetTarget()

void V3d_PositionLight::SetTarget ( const Standard_Real  theX,
const Standard_Real  theY,
const Standard_Real  theZ 
)

Defines the target of the light (the center of the sphere).

◆ Target()

void V3d_PositionLight::Target ( Standard_Real theX,
Standard_Real theY,
Standard_Real theZ 
) const

Returns the position of the target of the light source.

◆ Tracking()

void V3d_PositionLight::Tracking ( const Handle< V3d_View > &  theView,
const V3d_TypeOfPickLight  theWathPick,
const Standard_Integer  theXpix,
const Standard_Integer  theYpix 
)

Tracking the light position, or the light space, or the radius of the light space, that depends of initial picking "theWhatPick" (see the pick method). If theWhatPick is SPACELIGHT, then the parameters theXpix, theYpix are the coordinates of a translation vector.

Field Documentation

◆ myTarget

Graphic3d_Vertex V3d_PositionLight::myTarget
protected

◆ myTypeOfRepresentation

V3d_TypeOfRepresentation V3d_PositionLight::myTypeOfRepresentation
protected

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