Coin Logo http://www.sim.no/
http://www.coin3d.org/

SoInput.h
1#ifndef COIN_SOINPUT_H
2#define COIN_SOINPUT_H
3
4/**************************************************************************\
5 *
6 * This file is part of the Coin 3D visualization library.
7 * Copyright (C) by Kongsberg Oil & Gas Technologies.
8 *
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * ("GPL") version 2 as published by the Free Software Foundation.
12 * See the file LICENSE.GPL at the root directory of this source
13 * distribution for additional information about the GNU GPL.
14 *
15 * For using Coin with software that can not be combined with the GNU
16 * GPL, and for taking advantage of the additional benefits of our
17 * support services, please contact Kongsberg Oil & Gas Technologies
18 * about acquiring a Coin Professional Edition License.
19 *
20 * See http://www.coin3d.org/ for more information.
21 *
22 * Kongsberg Oil & Gas Technologies, Bygdoy Alle 5, 0257 Oslo, NORWAY.
23 * http://www.sim.no/ sales@sim.no coin-support@coin3d.org
24 *
25\**************************************************************************/
26
27#include <Inventor/system/inttypes.h>
28#include <Inventor/SbBasic.h>
29#include <Inventor/lists/SbList.h>
30#include <stdio.h> // FILE
31#ifndef COIN_INTERNAL
32 // For Open Inventor compatibility.
33 #include <Inventor/SoDB.h>
34#endif // COIN_INTERNAL
35
36// *************************************************************************
37
38class SbDict;
39class SoBase;
40class SbString;
41class SbTime;
42class SbName;
43class SbStringList;
44class SoInput_FileInfo;
45class SoProto;
46class SoField;
48class SoInputP;
49
50// *************************************************************************
51
52class COIN_DLL_API SoInput {
53public:
54 SoInput(void);
55 SoInput(SoInput * dictIn);
56
57 SoProto * findProto(const SbName & name);
58 void addProto(SoProto * proto);
59 void pushProto(SoProto * proto);
60 SoProto * getCurrentProto(void) const;
61 void popProto(void);
62
63 void addRoute(const SbName & fromnode, const SbName & fromfield,
64 const SbName & tonode, const SbName & tofield);
65 SbBool checkISReference(SoFieldContainer * container, const SbName & fieldname,
66 SbBool & readok);
67
68 virtual ~SoInput(void);
69
70 virtual void setFilePointer(FILE * newFP);
71 virtual SbBool openFile(const char * fileName, SbBool okIfNotFound = FALSE);
72 virtual SbBool pushFile(const char * fileName);
73 virtual void closeFile(void);
74 virtual SbBool isValidFile(void);
75 virtual SbBool isValidBuffer(void);
76 virtual FILE * getCurFile(void) const;
77 virtual const char * getCurFileName(void) const;
78 virtual void setBuffer(void * bufpointer, size_t bufsize);
79 void setStringArray(const char * strings[]);
80 virtual size_t getNumBytesRead(void) const;
81 virtual SbString getHeader(void);
82 virtual float getIVVersion(void);
83 virtual SbBool isBinary(void);
84
85 virtual SbBool get(char & c);
86 virtual SbBool getASCIIBuffer(char & c);
87 virtual SbBool getASCIIFile(char & c);
88 virtual SbBool readHex(uint32_t & l);
89 virtual SbBool read(char & c);
90 virtual SbBool read(char & c, SbBool skip);
91 virtual SbBool read(SbString & s);
92 virtual SbBool read(SbName & n, SbBool validIdent = FALSE);
93 virtual SbBool read(int & i);
94 virtual SbBool read(unsigned int & i);
95 virtual SbBool read(short & s);
96 virtual SbBool read(unsigned short & s);
97 virtual SbBool read(float & f);
98 virtual SbBool read(double & d);
99 virtual SbBool readByte(int8_t & b);
100 virtual SbBool readByte(uint8_t & b);
101 virtual SbBool readBinaryArray(unsigned char * c, int length);
102 virtual SbBool readBinaryArray(int32_t * l, int length);
103 virtual SbBool readBinaryArray(float * f, int length);
104 virtual SbBool readBinaryArray(double * d, int length);
105 virtual SbBool eof(void) const;
106
107 SbBool isFileVRML1(void);
108 SbBool isFileVRML2(void);
109 virtual void resetFilePointer(FILE * fptr);
110
111 virtual void getLocationString(SbString & string) const;
112 virtual void putBack(const char c);
113 virtual void putBack(const char * str);
114 virtual void addReference(const SbName & name, SoBase * base,
115 SbBool addToGlobalDict = TRUE);
116 virtual void removeReference(const SbName & name);
117 virtual SoBase * findReference(const SbName & name) const;
118
119 static void addDirectoryFirst(const char * dirName);
120 static void addDirectoryLast(const char * dirName);
121 static void addEnvDirectoriesFirst(const char * envVarName,
122 const char * separator = ":\t ");
123 static void addEnvDirectoriesLast(const char * envVarName,
124 const char * separator = ":\t ");
125 static void removeDirectory(const char * dirName);
126 static void clearDirectories(void);
127 static const SbStringList & getDirectories(void);
128
129 static void init(void);
130
131 static SbString getPathname(const char * const filename);
132 static SbString getPathname(const SbString & s);
133 static SbString getBasename(const char * const filename);
134 static SbString getBasename(const SbString & s);
135
136 static SbString searchForFile(const SbString & basename,
137 const SbStringList & directories,
138 const SbStringList & subdirectories);
139
140
141protected:
142 virtual SbBool popFile(void);
143 void setIVVersion(float version);
144 FILE * findFile(const char * fileName, SbString & fullName);
145 void initFile(FILE * newFP, const char * fileName, SbString * fullName,
146 SbBool openedHere, SbDict * refDict = NULL);
147 SbBool checkHeader(SbBool bValidateBufferHeader = FALSE);
148 SbBool fromBuffer(void) const;
149 SbBool skipWhiteSpace(void);
150 size_t freeBytesInBuf(void) const;
151 SbBool readInteger(int32_t & l);
152 SbBool readUnsignedInteger(uint32_t & l);
153 SbBool readReal(double & d);
154 SbBool readUnsignedIntegerString(char * str);
155 int readDigits(char * str);
156 int readHexDigits(char * str);
157 int readChar(char * str, char charToRead);
158
159 SbBool makeRoomInBuf(size_t nBytes);
160 void convertShort(char * from, short * s);
161 void convertInt32(char * from, int32_t * l);
162 void convertFloat(char * from, float * f);
163 void convertDouble(char * from, double * d);
164 void convertShortArray(char * from, short * to, int len);
165 void convertInt32Array(char * from, int32_t * to, int len);
166 void convertFloatArray(char * from, float * to, int len);
167 void convertDoubleArray(char * from, double * to, int len);
168 SbBool isFileURL(const char * url);
169 char * URLToFile(char * out_buf, const char * in_buf);
170 SbBool IsURL(const char * c_strng);
171
172 static void setDirectories(SbStringList * dirs);
173
174private:
175 friend class SoDB;
176 friend class SoInputP;
177
178 static void clean(void);
179 void constructorsCommon(void);
180
181 static void addDirectoryIdx(const int idx, const char * dirName);
182 static void addEnvDirectoriesIdx(int startidx, const char * envVarName,
183 const char * separator);
184 static SbStringList * dirsearchlist;
185
187 SoInput_FileInfo * getTopOfStack(void) const {
188 return this->filestack[0];
189 }
190
191 SoInputP * pimpl;
192};
193
194#endif // !COIN_SOINPUT_H
The SbDict class organizes a dictionary of keys and values.
Definition SbDict.h:54
The SbList class is a template container class for lists.
Definition SbList.h:61
The SbName class stores strings by reference.
Definition SbName.h:31
The SbStringList class is a container for arrays of SbString pointers.
Definition SbStringList.h:31
The SbString class is a string class with convenience functions for string operations.
Definition SbString.h:42
The SbTime class instances represents time values.
Definition SbTime.h:41
The SoBase class is the top-level superclass for a number of class-hierarchies.
Definition SoBase.h:36
The SoFieldContainer class is a base class for all classes that contain fields.
Definition SoFieldContainer.h:34
The SoField class is the top-level abstract base class for fields.
Definition SoField.h:38
static void addEnvDirectoriesLast(const char *envVarName, const char *separator=":\t ")
Definition SoInput.cpp:1948
virtual void closeFile(void)
Definition SoInput.cpp:825
void convertDouble(char *from, double *d)
Definition SoInput.cpp:2562
virtual size_t getNumBytesRead(void) const
Definition SoInput.cpp:1013
virtual void setFilePointer(FILE *newFP)
Definition SoInput.cpp:710
virtual const char * getCurFileName(void) const
Definition SoInput.cpp:908
virtual void setBuffer(void *bufpointer, size_t bufsize)
Definition SoInput.cpp:980
virtual SbBool eof(void) const
Definition SoInput.cpp:1735
int readChar(char *str, char charToRead)
Definition SoInput.cpp:2506
SbBool skipWhiteSpace(void)
Definition SoInput.cpp:2371
SbBool isFileVRML1(void)
Definition SoInput.cpp:2635
virtual SbBool popFile(void)
Definition SoInput.cpp:2386
virtual float getIVVersion(void)
Definition SoInput.cpp:1038
int readDigits(char *str)
Definition SoInput.cpp:2480
void convertShort(char *from, short *s)
Definition SoInput.cpp:2529
virtual SbString getHeader(void)
Definition SoInput.cpp:1024
SbBool checkISReference(SoFieldContainer *container, const SbName &fieldname, SbBool &readok)
Definition SoInput.cpp:633
SbBool readUnsignedIntegerString(char *str)
Definition SoInput.cpp:2468
void convertInt32(char *from, int32_t *l)
Definition SoInput.cpp:2540
SbBool isFileURL(const char *url)
Definition SoInput.cpp:2671
virtual SbBool isBinary(void)
Definition SoInput.cpp:1048
void addRoute(const SbName &fromnode, const SbName &fromfield, const SbName &tonode, const SbName &tofield)
Definition SoInput.cpp:532
static void addEnvDirectoriesFirst(const char *envVarName, const char *separator=":\t ")
Definition SoInput.cpp:1931
virtual void removeReference(const SbName &name)
Definition SoInput.cpp:1815
virtual SbBool get(char &c)
Definition SoInput.cpp:1065
static void init(void)
Definition SoInput.cpp:2083
virtual SbBool isValidFile(void)
Definition SoInput.cpp:847
static void clearDirectories(void)
Definition SoInput.cpp:2055
virtual SbBool isValidBuffer(void)
Definition SoInput.cpp:869
void addProto(SoProto *proto)
Definition SoInput.cpp:566
virtual void putBack(const char c)
Definition SoInput.cpp:1773
virtual void resetFilePointer(FILE *fptr)
Definition SoInput.cpp:2661
virtual SbBool readHex(uint32_t &l)
Definition SoInput.cpp:1106
SbBool readReal(double &d)
Definition SoInput.cpp:2453
void initFile(FILE *newFP, const char *fileName, SbString *fullName, SbBool openedHere, SbDict *refDict=NULL)
Definition SoInput.cpp:2315
static SbString searchForFile(const SbString &basename, const SbStringList &directories, const SbStringList &subdirectories)
Definition SoInput.cpp:2230
SbBool makeRoomInBuf(size_t nBytes)
Definition SoInput.cpp:2517
void convertInt32Array(char *from, int32_t *to, int len)
Definition SoInput.cpp:2588
virtual SbBool openFile(const char *fileName, SbBool okIfNotFound=FALSE)
Definition SoInput.cpp:742
static SbString getBasename(const char *const filename)
Definition SoInput.cpp:2160
virtual SbBool pushFile(const char *fileName)
Definition SoInput.cpp:775
virtual SbBool getASCIIFile(char &c)
Definition SoInput.cpp:1091
static void removeDirectory(const char *dirName)
Definition SoInput.cpp:2017
SbBool checkHeader(SbBool bValidateBufferHeader=FALSE)
Definition SoInput.cpp:2332
SbBool fromBuffer(void) const
Definition SoInput.cpp:2359
size_t freeBytesInBuf(void) const
Definition SoInput.cpp:2417
void setIVVersion(float version)
Definition SoInput.cpp:2304
virtual void getLocationString(SbString &string) const
Definition SoInput.cpp:1747
static void setDirectories(SbStringList *dirs)
Definition SoInput.cpp:2705
void convertFloat(char *from, float *f)
Definition SoInput.cpp:2551
void convertFloatArray(char *from, float *to, int len)
Definition SoInput.cpp:2604
SbBool isFileVRML2(void)
Definition SoInput.cpp:2649
void pushProto(SoProto *proto)
Definition SoInput.cpp:584
virtual SbBool readBinaryArray(unsigned char *c, int length)
Definition SoInput.cpp:1669
virtual SoBase * findReference(const SbName &name) const
Definition SoInput.cpp:1839
virtual SbBool getASCIIBuffer(char &c)
Definition SoInput.cpp:1080
SoInput(void)
Definition SoInput.cpp:435
virtual SbBool readByte(int8_t &b)
Definition SoInput.cpp:1570
int readHexDigits(char *str)
Definition SoInput.cpp:2492
static void addDirectoryLast(const char *dirName)
Definition SoInput.cpp:1885
virtual void addReference(const SbName &name, SoBase *base, SbBool addToGlobalDict=TRUE)
Definition SoInput.cpp:1797
SbBool readInteger(int32_t &l)
Definition SoInput.cpp:2428
SbBool IsURL(const char *c_strng)
Definition SoInput.cpp:2693
static void addDirectoryFirst(const char *dirName)
Definition SoInput.cpp:1872
char * URLToFile(char *out_buf, const char *in_buf)
Definition SoInput.cpp:2682
SoProto * findProto(const SbName &name)
Definition SoInput.cpp:549
virtual FILE * getCurFile(void) const
Definition SoInput.cpp:894
static const SbStringList & getDirectories(void)
Definition SoInput.cpp:2069
virtual SbBool read(char &c)
Definition SoInput.cpp:1132
SbBool readUnsignedInteger(uint32_t &l)
Definition SoInput.cpp:2440
void convertShortArray(char *from, short *to, int len)
Definition SoInput.cpp:2573
void setStringArray(const char *strings[])
Definition SoInput.cpp:952
FILE * findFile(const char *fileName, SbString &fullName)
Definition SoInput.cpp:2746
void popProto(void)
Definition SoInput.cpp:600
static SbString getPathname(const char *const filename)
Definition SoInput.cpp:2117
SoProto * getCurrentProto(void) const
Definition SoInput.cpp:616
void convertDoubleArray(char *from, double *to, int len)
Definition SoInput.cpp:2620
The SoProto class handles PROTO definitions.
Definition SoProto.h:41

Copyright © 1998-2010 by Kongsberg Oil & Gas Technologies. All rights reserved.

Generated for Coin by Doxygen 1.13.1.