zjf
2023-03-06 392b76515f40376b6d36f40a114850ef63650384
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
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
/////////////////////////////////////////////////////////////////////////////// 
// Copyright (C) 2002-2016, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2016 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
///////////////////////////////////////////////////////////////////////////////
 
 
 
#ifndef OD_AVEDEFS_H
#define OD_AVEDEFS_H
 
#include "Ve/AveExport.h"
#include "OdString.h"
#include "RxIterator.h"
 
/** \details
 
    <group TD_Namespaces>
*/
namespace OdAve
{
  enum MaterialType
  {
    kStandard     = 0,
    kGranite      = 1,
    kMarble       = 2,
    kWood         = 3
  };
 
  enum MaterialAttrib
  {
    kAmbient        = 0x1,  
    kDiffuse        = 0x2,  
    kSpecular       = 0x4,  
    kTransparency   = 0x8,  
    kRoughness      = 0x20, 
    kBumpMap        = 0x40, 
    kReflectionProp = 0x100,
    kRefraction     = 0x200
  };
 
  enum RenderType
  {
    kRndSimple      = 30,
    kRndPhotoReal   = 50,
    kRndRaytrace    = 60
  };
 
  enum RenderDestination
  {
    kDestViewport   = 20,
    kDestWindow     = 30,
    kDestFile       = 40
  };
 
  enum RenderQuality
  {
    kGouraud        = 0,
    kPhong          = 1
  };
 
  enum AntiAliasing
  {
    kAntiAliasNone      = 1,
    kAntiAliasMinimal   = 2,
    kAntiAliasLow       = 3,
    kAntiAliasMedium    = 4,
    kAntiAliasHigh      = 5
  };
 
  enum TextureMapSampling
  {
    kTMapSampPoint    = 1,
    kTMapSampLinear   = 2,
    kTMapSampMipMap   = 3
  };
 
  enum BackgroundType
  {
    kBackgroundSolid      = 0,
    kBackgroundGradient   = 1,
    kBackgroundImage      = 2,
    kBackgroundMerge      = 3
  };
 
  enum OptionType
  {
    kRndPref              = 0,
    kRndFullOpt           = 1,
    kRndQuickOpt          = 2,
    kRndScanlOpt          = 3,
    kRndRaytrOpt          = 4, 
    kRndRFileOpt          = 5,
    kRndFogOpt            = 6,
    kRndBGOpt             = 7,  
    kRndOptAmount         = 8
  };
 
  enum ProjectionMethod
  {
    kPlanar               = 1,
    kBox                  = 2,
    kCylinder             = 3,
    kSphere               = 4
  };
 
  enum TileMethod
  {
    kTmDefault    = 0, // Tiling as set for the material.
    kTmTile       = 1, // Tiled.
    kTmCrop       = 2, // Cropped.
    kTmClamp      = 3  // Clamped.
  };
 
  enum SetuvType
  {
    kSetuvPlanar      = 1,
    kSetuvCylindrical = 2,
    kSetuvSpherical   = 3,
    kSetuvSolid       = 6
  };
}
 
/** \details
    This class is the base class for AVE Bitmap objects.
    
    Library: TD_Ave
    <group OdAve_Classes>
*/
class AVE_EXPORT OdAveBitmap
{
public:
  virtual ~OdAveBitmap() {}
 
  /** \details
    Returns the blend factor for this Bitmap object.
 
    \remarks
    Returns a value in the range [0.0 .. 1.0]
 
    A blend factor of 0.0 makes the Bitmap invisible. A blend factor of 1.0 makes it opaque.
    In between, the Bitmap is transparent.
  */
  virtual double blendFactor() = 0;
  
  /** \details
    Sets the source filename of this Bitmap object.
 
    \param filename [out] Receives the filename.
  */
  virtual void source(OdString& filename) = 0;
  
  /** \details
    Returns the scale of this Bitmap object in the U-direction.
    
    \remarks
    This is the number of repetitions of this Bitmap object in the specified direction.
  */
  virtual double scaleU() = 0;
  /** \details
    Returns the scale of this Bitmap object in the V-direction.
    
    \remarks
    This is the number of repetitions of this Bitmap object in the specified direction.
  */
  virtual double scaleV() = 0;
  /** \details
    Returns the offset of this Bitmap object in the U-direction.
    \remarks
    Returns a value in the range [-1.0 .. 1.0].
  */
  virtual double offsetU() = 0;
  /** \details
    Returns the offset of this Bitmap object in the V-direction.
    \remarks
    Returns a value in the range [-1.0 .. 1.0].
  */
  virtual double offsetV() = 0;
  /** \details
    Returns the tile method of this Bitmap object.
    \remarks
    Returns one of the following:
    
    <table>
    Name          Value   Description
    kTmDefault    0       Tiling as set for the material.
    kTmTile       1       Tiled.
    kTmCrop       2       Cropped.
    kTmClamp      3       Clamped.
    </table>
  */
  virtual OdAve::TileMethod tileMethod() = 0;
  /** \details
    Returns true if and only if this Bitmap object uses Auto Axis.
    \remarks
    AutoAxis automatically maps materials to surfaces 
    whose normals are the X, Y, and Z axes.
    
    If AutoAxis is not used, only surfaces whose normal is the Z axis are mapped.
  */
  virtual bool useAutoAxis() = 0;
  /** \details
    Returns true if and only if this Bitmap object is automatically scaled
    to the object to which this bitmap is attached.
  */
  virtual bool fitToObject() = 0;
 
  /** \details
    Sets the blend factor for this Bitmap object.
    \param blendFactor [in]  Blend factor. [0.0 .. 1.0]
    \remarks
    A blend factor of 0.0 makes the Bitmap invisible. A blend factor of 1.0 makes it opaque.
    In between, the Bitmap is transparent.
  */
  virtual void setBlendFactor(double blendFactor) = 0;
  /** \details
    Returns the source filename of this Bitmap object.
 
    \remarks
    \param filename [in] Filename.
  */
  virtual void setSource(const OdString& filename) = 0;
  /** \details
    Sets the scale of this Bitmap object in the U-direction.
    \param scaleU [in]  Scale in U-direction.
    \remarks
    This is the number of repetitions of this Bitmap object in the specified direction.
  */
  virtual void setScaleU(double scaleU) = 0;
  /** \details
    Sets the scale of this Bitmap object in the V-direction.
    \param scaleV [in]  Scale in V-direction.
    \remarks
    This is the number of repetitions of this Bitmap object in the specified direction.
  */
  virtual void setScaleV(double scaleV) = 0;
  /** \details
    Sets the offset of this Bitmap object in the U-direction.
    \param offsetU [in]  Offset in U-direction. [-1.0 .. 1.0].
  */
  virtual void setOffsetU(double offsetU) = 0;
  /** \details
    Sets the offset of this Bitmap object in the V-direction.
    \param offsetV [in]  Offset in V-direction. [-1.0 .. 1.0].
  */
  virtual void setOffsetV(double offsetV) = 0;
  /** \details
    Sets the tile method of this Bitmap object.
    
    \param tileMethod [in]  Tile method.
    
    \remarks
    tileMethod must be one of the following:
    
    <table>
    Name          Value   Description
    kTmDefault    0       Tiling as set for the material.
    kTmTile       1       Tiled.
    kTmCrop       2       Cropped.
    kTmClamp      3       Clamped.
    </table>
  */
  virtual void setTileMethod(OdAve::TileMethod tileMethod) = 0;
  /** \details
    Controls the use of Auto Axis by this Bitmap object.
    \param useAutoAxis [in]  Controls use of Auto Axis.
    \remarks
    AutoAxis automatically maps materials to surfaces 
    whose normals are the X, Y, and Z axes.
    
    If AutoAxis is not used, only surfaces whose normal is the Z axis are mapped.
  */
  virtual void setUseAutoAxis(bool useAutoAxis) = 0;
 
  /** \details
    Controls the automatically scaling of this Bitmap object to the object to which
    it is attached.
    \param fitToObject [in]  Controls automatic scaling.
  */
  virtual void setFitToObject(bool fitToObject) = 0;
};
 
#endif // OD_AVEDEFS_H