Open Inventor Reference
|
00001 /* 00002 * 00003 * Copyright (C) 2000 Silicon Graphics, Inc. All Rights Reserved. 00004 * 00005 * This library is free software; you can redistribute it and/or 00006 * modify it under the terms of the GNU Lesser General Public 00007 * License as published by the Free Software Foundation; either 00008 * version 2.1 of the License, or (at your option) any later version. 00009 * 00010 * This library is distributed in the hope that it will be useful, 00011 * but WITHOUT ANY WARRANTY; without even the implied warranty of 00012 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00013 * Lesser General Public License for more details. 00014 * 00015 * Further, this software is distributed without any warranty that it is 00016 * free of the rightful claim of any third person regarding infringement 00017 * or the like. Any license provided herein, whether implied or 00018 * otherwise, applies only to this software file. Patent licenses, if 00019 * any, provided herein do not apply to combinations of this program with 00020 * other software, or any other product whatsoever. 00021 * 00022 * You should have received a copy of the GNU Lesser General Public 00023 * License along with this library; if not, write to the Free Software 00024 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 00025 * 00026 * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy, 00027 * Mountain View, CA 94043, or: 00028 * 00029 * http://www.sgi.com 00030 * 00031 * For further information regarding this notice, see: 00032 * 00033 * http://oss.sgi.com/projects/GenInfo/NoticeExplan/ 00034 * 00035 */ 00036 00037 00038 /* 00039 * Copyright (C) 1990,91 Silicon Graphics, Inc. 00040 * 00041 _______________________________________________________________________ 00042 ______________ S I L I C O N G R A P H I C S I N C . ____________ 00043 | 00044 | $Revision: 1.1.1.1 $ 00045 | 00046 | Description: 00047 | This file defines the SoUpgrader class, which is used to 00048 | read in and convert old nodes into new nodes. 00049 | 00050 | Author(s) : Gavin Bell 00051 | 00052 ______________ S I L I C O N G R A P H I C S I N C . ____________ 00053 _______________________________________________________________________ 00054 */ 00055 00056 #ifndef _SO_UPGRADER_ 00057 #define _SO_UPGRADER_ 00058 00059 #include <Inventor/nodes/SoGroup.h> 00060 00066 00067 class SbDict; 00068 class INVENTOR_API SoUpgrader : public SoGroup { 00069 00070 SO_NODE_ABSTRACT_HEADER(SoUpgrader); 00071 00072 public: 00075 static SoUpgrader *getUpgrader(const SbName &className, 00076 float fileFormatVersion); 00077 protected: 00080 static void registerUpgrader(const SoType &type, 00081 const SbName &className, 00082 float version); 00083 SoINTERNAL public: 00084 static void initClass(); 00085 00087 static void initClasses(); 00088 00094 virtual SbBool upgrade(SoInput *in, const SbName &refName, 00095 SoBase *&result); 00096 00097 protected: 00103 SbBool isGroup; 00104 00106 virtual SoNode *createNewNode() = 0; 00107 00111 SoUpgrader(); 00112 00113 virtual ~SoUpgrader(); 00114 00115 private: 00117 static SbDict *getUpgradeDict(float version); 00118 static SbDict *upgradeDictV1; 00119 static SbDict *upgradeDictV2; 00120 }; 00121 00124 #define SO_UPGRADER_INIT_CLASS(className) \ 00125 SO__NODE_INIT_CLASS(className, SO__QUOTE(className), SoUpgrader) 00126 00134 #define SO_REGISTER_UPGRADER(oldClassName, version) \ 00135 do { \ 00136 classTypeId.makeInternal(); \ 00137 registerUpgrader(classTypeId, SO__QUOTE(oldClassName), version); \ 00138 } while (0) 00139 00143 #define SO_UPGRADER_COPY_FIELD2(oldName, newName, nodeVar) \ 00144 do { \ 00145 if (! oldName.isDefault()) \ 00146 nodeVar->newName = oldName; \ 00147 if (oldName.isIgnored()) \ 00148 nodeVar->newName.setIgnored(TRUE); \ 00149 } while (0) 00150 00151 #define SO_UPGRADER_COPY_FIELD(fieldName, nodeVar) \ 00152 SO_UPGRADER_COPY_FIELD2(fieldName, fieldName, nodeVar) 00153 00156 #define SO_UPGRADER_CREATE_NEW(className) \ 00157 ((className *) className::getClassTypeId().createInstance()) 00158 00159 #endif /* _SO_UPGRADER_ */