File: NormalManager.hpp

package info (click to toggle)
freefem3d 1.0pre10-3.4
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 25,016 kB
  • ctags: 8,675
  • sloc: cpp: 57,204; sh: 8,788; yacc: 2,975; makefile: 1,149; ansic: 508; perl: 110
file content (164 lines) | stat: -rw-r--r-- 3,701 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

//  This file is part of ff3d - http://www.freefem.org/ff3d
//  Copyright (C) 2005 Stephane Del Pino
//
//  This program is free software; you can redistribute it and/or modify
//  it under the terms of the GNU General Public License as published by
//  the Free Software Foundation; either version 2, or (at your option)
//  any later version.
//
//  This program is distributed in the hope that it will be useful,
//  but WITHOUT ANY WARRANTY; without even the implied warranty of
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//  GNU General Public License for more details.
//
//  You should have received a copy of the GNU General Public License
//  along with this program; if not, write to the Free Software Foundation,
//  Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
//
//  $Id: NormalManager.hpp,v 1.3 2007/05/20 23:02:47 delpinux Exp $

#ifndef NORMAL_MANAGER_HPP
#define NORMAL_MANAGER_HPP

#include <ThreadStaticBase.hpp>

#include <SurfElem.hpp>
#include <DiscretizationType.hpp>
#include <ReferenceCounting.hpp>

/**
 * @file   NormalManager.hpp
 * @author Stephane Del Pino
 * @date   Sun Oct 30 23:48:45 2005
 * 
 * @brief  Manages normal
 * 
 * This class manages the current normal of when iterating over
 * surface elements. This implementation is very simple and consideres
 * that the normal is evaluated over one surface element at once,
 * which seems quite natural.
 */
class NormalManager
  : public ThreadStaticBase<NormalManager>
{
private:
  const SurfElem* __surfElem;	/**< The current surface element */

  size_t __counter;		/**< counts the current number of subscriptions */

  mutable ReferenceCounting<TinyVector<3, real_t> >
  __normal;			/**< This vector contains the normal vector */

  /** 
   * Builds the normal vector if it is not built
   * 
   */
  void __buildNormal() const
  {
    if (__surfElem == 0) {
      throw ErrorHandler(__FILE__,__LINE__,
			 "Cannot evaluate normal, no surface is defined",
			 ErrorHandler::unexpected);
    }
    if (__normal == 0) {
      __normal = new TinyVector<3, real_t>(__surfElem->normal());
    }
  }

public:
  /** 
   * Subscribes the element @a s for whom the normal may be computed.
   * 
   * @param s the element to subscribe
   */
  void subscribe(const SurfElem* s)
  {
    __counter++;
    __surfElem = s;
  }

  /** 
   * Uses a new surface element
   * 
   * @param s the new surface element
   */
  void update(const SurfElem* s)
  {
    ASSERT(__surfElem != 0);
    __surfElem = s;
    __normal = 0; // normal is to recompute
  }

  /** 
   * This is called to inform the NormalManager that the surface have
   * been iterated, this avoid the use of wrong normal value
   */
  void unsubscribe()
  {
    ASSERT(__counter != 0);
    __counter--;
    if (__counter == 0) {
      __surfElem = 0;
      __normal = 0;
    }
  }
  
  /** 
   * Access to the first component of the normal
   * 
   * @return \f$ n_x \f$
   */
  real_t nx() const
  {
    __buildNormal();
    return (*__normal)[0];
  }

  /** 
   * Access to the second component of the normal
   * 
   * @return \f$ n_y \f$
   */
  real_t ny() const
  {
    __buildNormal();
    return (*__normal)[1];
  }

  /** 
   * Access to the third component of the normal
   * 
   * @return \f$ n_z \f$
   */
  real_t nz() const
  {
    __buildNormal();
    return (*__normal)[2];
  }

  /** 
   * Default constructor
   * 
   */
  explicit NormalManager()
    : __surfElem(0),
      __counter(0),
      __normal(0)
  {
    ;
  }

  /** 
   * Destructor
   * 
   */
  ~NormalManager()
  {
    ASSERT(__counter  == 0);
    ASSERT(__surfElem == 0);
    ASSERT(__normal   == 0);
  }
};

#endif // NORMAL_MANAGER_HPP