Open Inventor Reference
SoConcatenate.h
Go to the documentation of this file.
1 /*
2  *
3  * Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved.
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2.1 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * Further, this software is distributed without any warranty that it is
16  * free of the rightful claim of any third person regarding infringement
17  * or the like. Any license provided herein, whether implied or
18  * otherwise, applies only to this software file. Patent licenses, if
19  * any, provided herein do not apply to combinations of this program with
20  * other software, or any other product whatsoever.
21  *
22  * You should have received a copy of the GNU Lesser General Public
23  * License along with this library; if not, write to the Free Software
24  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25  *
26  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
27  * Mountain View, CA 94043, or:
28  *
29  * http://www.sgi.com
30  *
31  * For further information regarding this notice, see:
32  *
33  * http://oss.sgi.com/projects/GenInfo/NoticeExplan/
34  *
35  */
36 
37 
38 /*
39  * Copyright (C) 1990,91 Silicon Graphics, Inc.
40  *
41  _______________________________________________________________________
42  ______________ S I L I C O N G R A P H I C S I N C . ____________
43  |
44  | $Revision: 1.2 $
45  |
46  | Description:
47  | This file defines the "concatenation" engine that joins
48  | together several (up to 10) fields. Its inputs are several
49  | multi-valued fields (automatic field conversion will do the
50  | right thing, so you can attach single-valued fields) of the
51  | same type, output is a multi-value field of the same type.
52  |
53  | If you need to concatenate more than 10 fields together,
54  | concatenate the outputs of several of these into yet another
55  | concatenate engine.
56  |
57  | Classes:
58  | SoConcatenate
59  |
60  | Author(s) : Ronen Barzel, Gavin Bell
61  |
62  ______________ S I L I C O N G R A P H I C S I N C . ____________
63  _______________________________________________________________________
64  */
65 
66 #ifndef _SO_CONCATENATE_
67 #define _SO_CONCATENATE_
68 
72 
73 
74 class SoMField;
75 
78 
108 
110 
112 
113  public:
114 
116  SoConcatenate(SoType mfInputType);
117 
122  SoMField *input[10];
123 
127 
128  SoINTERNAL public:
130  static void initClass();
131 
132  protected:
133 
135 
136  private:
139  SoConcatenate();
140  ~SoConcatenate();
141 
144  virtual bool readInstance(SoInput *in, unsigned short flags);
145  virtual void writeInstance(SoOutput *out);
146 
147  void setup(SoType);
148  virtual void evaluate();
149 
150  int conversionCase;
151 
152  SoFieldData *myInputData;
153  SoEngineOutputData *myOutputData;
154 
155  SoSFName typeField;
156 };
157 
158 #endif /* _SO_CONCATENATE_ */
#define SoINTERNAL
Definition: SbBasic.h:155
#define INVENTOR_API
Disable some annoying warnings on MSVC 6.
Definition: SbSystem.h:81
#define SO_ENGINE_HEADER(className)
Definition: SoSubEngine.h:166
Joins separate fields into a single multiple-value field.
virtual SoFieldContainer * copyThroughConnection() const
Copies an instance that is encountered through a field connection.
static void initClass()
Initializes engine class.
SoConcatenate(SoType mfInputType)
Constructor. The argument specifies the type of values to concatenate.
SoEngineOutput * output
Output.
The SoEngineOutputData class holds data about engine outputs: the number of outputs the engine has,...
Definition: SoOutputData.h:86
Class for all engine outputs.
Definition: SoEngine.h:228
Base class for all engines.
Definition: SoEngine.h:102
virtual void evaluate()=0
User-written evaluation engine.
virtual void writeInstance(SoOutput *out)
Writes instance to SoOutput. (Used only for last stage of writing)
virtual bool readInstance(SoInput *in, unsigned short flags)
Reads stuff into instance. Returns FALSE on error.
Abstract base class for objects that contain fields.
The SoFieldData class holds data about fields of an object: the number of fields the object has,...
Definition: SoFieldData.h:88
Used to read Inventor data files.
Definition: SoInput.h:128
Base class for all multiple-valued fields.
Definition: SoField.h:628
Used to write Inventor data files.
Definition: SoOutput.h:90
Field containg a name.
Definition: SoSFName.h:84
SoType has no virtual functions to keep it small...
Definition: SoType.h:103