1 /**************************************************************************\
2  * Copyright (c) Kongsberg Oil & Gas Technologies AS
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are
7  * met:
8  *
9  * Redistributions of source code must retain the above copyright notice,
10  * this list of conditions and the following disclaimer.
11  *
12  * Redistributions in binary form must reproduce the above copyright
13  * notice, this list of conditions and the following disclaimer in the
14  * documentation and/or other materials provided with the distribution.
15  *
16  * Neither the name of the copyright holder nor the names of its
17  * contributors may be used to endorse or promote products derived from
18  * this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
23  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24  * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
26  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
30  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31 \**************************************************************************/
32 
33 /*!
34   \class SoViewingMatrixElement Inventor/elements/SoViewingMatrixElement.h
35   \brief The SoViewingMatrixElement class stores the world-to-camera transformation.
36 
37   \ingroup elements
38 
39   \sa SoModelMatrixElement
40 */
41 
42 #include <Inventor/elements/SoViewingMatrixElement.h>
43 
44 #include "SbBasicP.h"
45 
46 #include <cassert>
47 
48 /*!
49   \fn SoViewingMatrixElement::viewingMatrix
50 
51   FIXME: write doc.
52 */
53 
54 SO_ELEMENT_SOURCE(SoViewingMatrixElement);
55 
56 /*!
57   This static method initializes static data for the SoViewingMatrixElement
58   class.
59 */
60 
61 void
initClass(void)62 SoViewingMatrixElement::initClass(void)
63 {
64   SO_ELEMENT_INIT_CLASS(SoViewingMatrixElement, inherited);
65 }
66 
67 /*!
68   The destructor.
69 */
70 
~SoViewingMatrixElement(void)71 SoViewingMatrixElement::~SoViewingMatrixElement(void)
72 {
73 }
74 
75 //! FIXME: write doc.
76 
77 void
set(SoState * const state,SoNode * const node,const SbMatrix & viewingMatrix)78 SoViewingMatrixElement::set(SoState * const state,
79                             SoNode * const node,
80                             const SbMatrix & viewingMatrix)
81 {
82   SoViewingMatrixElement * element = coin_safe_cast<SoViewingMatrixElement *>
83     (
84      SoReplacedElement::getElement(state, classStackIndex, node)
85      );
86   if (element) {
87     element->setElt(viewingMatrix);
88   }
89 }
90 
91 //! FIXME: write doc.
92 
93 const SbMatrix &
get(SoState * const state)94 SoViewingMatrixElement::get(SoState * const state)
95 {
96   const SoViewingMatrixElement * element =
97     coin_assert_cast<const SoViewingMatrixElement *>
98     (
99      SoElement::getConstElement(state, classStackIndex)
100      );
101   return element->viewingMatrix;
102 }
103 
104 //! FIXME: write doc.
105 
106 void
init(SoState * state)107 SoViewingMatrixElement::init(SoState * state)
108 {
109   inherited::init(state);
110   viewingMatrix.makeIdentity();
111 #if 0 // debug
112   SoDebugError::postInfo("SoViewingMatrixElement::init",
113                          "matrix set to identity");
114 #endif // debug
115 }
116 
117 //! FIXME: write doc.
118 
119 void
setElt(const SbMatrix & matrix)120 SoViewingMatrixElement::setElt(const SbMatrix &matrix)
121 {
122   this->viewingMatrix = matrix;
123 #if 0 // debug
124   SoDebugError::postInfo("SoViewingMatrixElement::setElt",
125                          "viewingmatrix:");
126   matrix.print(stdout);
127 #endif // debug
128 }
129