2 * Copyright 2006 Stefan Dösinger
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2.1 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
19 #ifndef __WINE_DLLS_DDRAW_DDRAW_PRIVATE_H
20 #define __WINE_DLLS_DDRAW_DDRAW_PRIVATE_H
24 #define NONAMELESSSTRUCT
25 #define NONAMELESSUNION
26 #include "wine/debug.h"
34 #ifdef DDRAW_INIT_GUID
37 #include "wine/list.h"
38 #include "wine/wined3d.h"
40 extern const struct wined3d_parent_ops ddraw_surface_wined3d_parent_ops DECLSPEC_HIDDEN;
41 extern const struct wined3d_parent_ops ddraw_null_wined3d_parent_ops DECLSPEC_HIDDEN;
43 /* Typdef the interfaces */
44 typedef struct IDirectDrawImpl IDirectDrawImpl;
45 typedef struct IDirectDrawSurfaceImpl IDirectDrawSurfaceImpl;
46 typedef struct IDirectDrawClipperImpl IDirectDrawClipperImpl;
47 typedef struct IDirectDrawPaletteImpl IDirectDrawPaletteImpl;
48 typedef struct IDirect3DDeviceImpl IDirect3DDeviceImpl;
49 typedef struct IDirect3DLightImpl IDirect3DLightImpl;
50 typedef struct IDirect3DViewportImpl IDirect3DViewportImpl;
51 typedef struct IDirect3DMaterialImpl IDirect3DMaterialImpl;
52 typedef struct IDirect3DExecuteBufferImpl IDirect3DExecuteBufferImpl;
53 typedef struct IDirect3DVertexBufferImpl IDirect3DVertexBufferImpl;
55 /* Global critical section */
56 extern CRITICAL_SECTION ddraw_cs DECLSPEC_HIDDEN;
58 extern DWORD force_refresh_rate DECLSPEC_HIDDEN;
60 /*****************************************************************************
61 * IDirectDraw implementation structure
62 *****************************************************************************/
66 struct wined3d_vertex_declaration *decl;
69 struct IDirectDrawImpl
72 IDirectDraw7 IDirectDraw7_iface;
73 IDirectDraw4 IDirectDraw4_iface;
74 IDirectDraw3 IDirectDraw3_iface;
75 IDirectDraw2 IDirectDraw2_iface;
76 IDirectDraw IDirectDraw_iface;
77 IDirect3D7 IDirect3D7_iface;
78 IDirect3D3 IDirect3D3_iface;
79 IDirect3D2 IDirect3D2_iface;
80 IDirect3D IDirect3D_iface;
81 struct wined3d_device_parent device_parent;
83 /* See comment in IDirectDraw::AddRef */
84 LONG ref7, ref4, ref2, ref3, ref1, numIfaces;
87 struct wined3d *wineD3D;
88 struct wined3d_device *wined3d_device;
91 /* Misc ddraw fields */
97 /* DirectDraw things, which are not handled by WineD3D */
98 DWORD cooperative_level;
100 DWORD orig_width, orig_height;
104 IDirectDrawSurfaceImpl *d3d_target;
106 IDirect3DDeviceImpl *d3ddevice;
114 /* The surface type to request */
115 WINED3DSURFTYPE ImplType;
117 /* Helpers for surface creation */
118 IDirectDrawSurfaceImpl *tex_root;
121 /* For the dll unload cleanup code */
122 struct list ddraw_list_entry;
123 /* The surface list - can't relay this to WineD3D
126 struct list surface_list;
130 struct FvfToDecl *decls;
131 UINT numConvertedDecls, declArraySize;
134 #define DDRAW_WINDOW_CLASS_NAME "ddraw_wc"
136 HRESULT ddraw_init(IDirectDrawImpl *ddraw, WINED3DDEVTYPE device_type) DECLSPEC_HIDDEN;
138 /* Utility functions */
139 void DDRAW_Convert_DDSCAPS_1_To_2(const DDSCAPS *pIn, DDSCAPS2 *pOut) DECLSPEC_HIDDEN;
140 void DDRAW_Convert_DDDEVICEIDENTIFIER_2_To_1(const DDDEVICEIDENTIFIER2 *pIn, DDDEVICEIDENTIFIER *pOut) DECLSPEC_HIDDEN;
141 HRESULT WINAPI ddraw_recreate_surfaces_cb(IDirectDrawSurface7 *surf,
142 DDSURFACEDESC2 *desc, void *Context) DECLSPEC_HIDDEN;
143 struct wined3d_vertex_declaration *ddraw_find_decl(IDirectDrawImpl *This, DWORD fvf) DECLSPEC_HIDDEN;
145 /* The default surface type */
146 extern WINED3DSURFTYPE DefaultSurfaceType DECLSPEC_HIDDEN;
148 /*****************************************************************************
149 * IDirectDrawSurface implementation structure
150 *****************************************************************************/
152 struct IDirectDrawSurfaceImpl
154 /* IUnknown fields */
155 IDirectDrawSurface7 IDirectDrawSurface7_iface;
156 IDirectDrawSurface4 IDirectDrawSurface4_iface;
157 IDirectDrawSurface3 IDirectDrawSurface3_iface;
158 IDirectDrawSurface2 IDirectDrawSurface2_iface;
159 IDirectDrawSurface IDirectDrawSurface_iface;
160 IDirectDrawGammaControl IDirectDrawGammaControl_iface;
161 IDirect3DTexture2 IDirect3DTexture2_iface;
162 IDirect3DTexture IDirect3DTexture_iface;
164 LONG ref7, ref4, ref3, ref2, ref1, iface_count, gamma_count;
165 IUnknown *ifaceToRelease;
169 /* Connections to other Objects */
170 IDirectDrawImpl *ddraw;
171 struct wined3d_surface *wined3d_surface;
172 struct wined3d_texture *wined3d_texture;
173 struct wined3d_swapchain *wined3d_swapchain;
175 /* This implementation handles attaching surfaces to other surfaces */
176 IDirectDrawSurfaceImpl *next_attached;
177 IDirectDrawSurfaceImpl *first_attached;
179 /* Complex surfaces are organized in a tree, although the tree is degenerated to a list in most cases.
180 * In mipmap and primary surfaces each level has only one attachment, which is the next surface level.
181 * Only the cube texture root has 6 surfaces attached, which then have a normal mipmap chain attached
182 * to them. So hardcode the array to 6, a dynamic array or a list would be an overkill.
184 #define MAX_COMPLEX_ATTACHED 6
185 IDirectDrawSurfaceImpl *complex_array[MAX_COMPLEX_ATTACHED];
186 /* You can't traverse the tree upwards. Only a flag for Surface::Release because its needed there,
187 * but no pointer to prevent temptations to traverse it in the wrong direction.
189 BOOL is_complex_root;
191 /* Surface description, for GetAttachedSurface */
192 DDSURFACEDESC2 surface_desc;
195 DWORD uniqueness_value;
197 WINED3DSURFTYPE ImplType;
199 /* For D3DDevice creation */
202 /* Clipper objects */
203 IDirectDrawClipperImpl *clipper;
205 /* For the ddraw surface list */
206 struct list surface_list_entry;
211 HRESULT ddraw_surface_create_texture(IDirectDrawSurfaceImpl *surface) DECLSPEC_HIDDEN;
212 void ddraw_surface_destroy(IDirectDrawSurfaceImpl *surface) DECLSPEC_HIDDEN;
213 HRESULT ddraw_surface_init(IDirectDrawSurfaceImpl *surface, IDirectDrawImpl *ddraw,
214 DDSURFACEDESC2 *desc, UINT mip_level, WINED3DSURFTYPE surface_type, UINT version) DECLSPEC_HIDDEN;
215 ULONG ddraw_surface_release_iface(IDirectDrawSurfaceImpl *This) DECLSPEC_HIDDEN;
217 static inline IDirectDrawSurfaceImpl *impl_from_IDirect3DTexture(IDirect3DTexture *iface)
219 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirect3DTexture_iface);
222 static inline IDirectDrawSurfaceImpl *impl_from_IDirect3DTexture2(IDirect3DTexture2 *iface)
224 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirect3DTexture2_iface);
227 static inline IDirectDrawSurfaceImpl *impl_from_IDirectDrawSurface(IDirectDrawSurface *iface)
229 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirectDrawSurface_iface);
232 static inline IDirectDrawSurfaceImpl *impl_from_IDirectDrawSurface2(IDirectDrawSurface2 *iface)
234 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirectDrawSurface2_iface);
237 static inline IDirectDrawSurfaceImpl *impl_from_IDirectDrawSurface3(IDirectDrawSurface3 *iface)
239 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirectDrawSurface3_iface);
242 static inline IDirectDrawSurfaceImpl *impl_from_IDirectDrawSurface4(IDirectDrawSurface4 *iface)
244 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirectDrawSurface4_iface);
247 static inline IDirectDrawSurfaceImpl *impl_from_IDirectDrawSurface7(IDirectDrawSurface7 *iface)
249 return CONTAINING_RECORD(iface, IDirectDrawSurfaceImpl, IDirectDrawSurface7_iface);
252 IDirectDrawSurfaceImpl *unsafe_impl_from_IDirectDrawSurface(IDirectDrawSurface *iface) DECLSPEC_HIDDEN;
253 IDirectDrawSurfaceImpl *unsafe_impl_from_IDirectDrawSurface4(IDirectDrawSurface4 *iface) DECLSPEC_HIDDEN;
254 IDirectDrawSurfaceImpl *unsafe_impl_from_IDirectDrawSurface7(IDirectDrawSurface7 *iface) DECLSPEC_HIDDEN;
256 IDirectDrawSurfaceImpl *unsafe_impl_from_IDirect3DTexture(IDirect3DTexture *iface) DECLSPEC_HIDDEN;
257 IDirectDrawSurfaceImpl *unsafe_impl_from_IDirect3DTexture2(IDirect3DTexture2 *iface) DECLSPEC_HIDDEN;
259 /* Get the number of bytes per pixel for a given surface */
260 #define PFGET_BPP(pf) (pf.dwFlags&DDPF_PALETTEINDEXED8?1:((pf.dwRGBBitCount+7)/8))
261 #define GET_BPP(desc) PFGET_BPP(desc.ddpfPixelFormat)
263 #define DDRAW_INVALID_HANDLE ~0U
265 enum ddraw_handle_type
268 DDRAW_HANDLE_MATERIAL,
270 DDRAW_HANDLE_STATEBLOCK,
271 DDRAW_HANDLE_SURFACE,
274 struct ddraw_handle_entry
277 enum ddraw_handle_type type;
280 struct ddraw_handle_table
282 struct ddraw_handle_entry *entries;
283 struct ddraw_handle_entry *free_entries;
288 BOOL ddraw_handle_table_init(struct ddraw_handle_table *t, UINT initial_size) DECLSPEC_HIDDEN;
289 void ddraw_handle_table_destroy(struct ddraw_handle_table *t) DECLSPEC_HIDDEN;
290 DWORD ddraw_allocate_handle(struct ddraw_handle_table *t, void *object, enum ddraw_handle_type type) DECLSPEC_HIDDEN;
291 void *ddraw_free_handle(struct ddraw_handle_table *t, DWORD handle, enum ddraw_handle_type type) DECLSPEC_HIDDEN;
292 void *ddraw_get_object(struct ddraw_handle_table *t, DWORD handle, enum ddraw_handle_type type) DECLSPEC_HIDDEN;
294 struct IDirect3DDeviceImpl
297 const IDirect3DDevice7Vtbl *lpVtbl;
298 const IDirect3DDevice3Vtbl *IDirect3DDevice3_vtbl;
299 const IDirect3DDevice2Vtbl *IDirect3DDevice2_vtbl;
300 const IDirect3DDeviceVtbl *IDirect3DDevice_vtbl;
303 /* Other object connections */
304 struct wined3d_device *wined3d_device;
305 IDirectDrawImpl *ddraw;
306 struct wined3d_buffer *indexbuffer;
307 IDirectDrawSurfaceImpl *target;
309 /* Viewport management */
310 struct list viewport_list;
311 IDirect3DViewportImpl *current_viewport;
312 D3DVIEWPORT7 active_viewport;
314 /* Required to keep track which of two available texture blending modes in d3ddevice3 is used */
315 BOOL legacyTextureBlending;
320 /* Rendering functions to wrap D3D(1-3) to D3D7 */
321 D3DPRIMITIVETYPE primitive_type;
325 LPBYTE vertex_buffer;
329 /* Handle management */
330 struct ddraw_handle_table handle_table;
331 D3DMATRIXHANDLE world, proj, view;
334 HRESULT d3d_device_init(IDirect3DDeviceImpl *device, IDirectDrawImpl *ddraw,
335 IDirectDrawSurfaceImpl *target) DECLSPEC_HIDDEN;
338 extern const GUID IID_D3DDEVICE_WineD3D DECLSPEC_HIDDEN;
340 /* Helper functions */
341 HRESULT IDirect3DImpl_GetCaps(const struct wined3d *wined3d,
342 D3DDEVICEDESC *Desc123, D3DDEVICEDESC7 *Desc7) DECLSPEC_HIDDEN;
343 WINED3DZBUFFERTYPE IDirect3DDeviceImpl_UpdateDepthStencil(IDirect3DDeviceImpl *This) DECLSPEC_HIDDEN;
345 static inline IDirect3DDeviceImpl *device_from_device1(IDirect3DDevice *iface)
347 return (IDirect3DDeviceImpl *)((char*)iface - FIELD_OFFSET(IDirect3DDeviceImpl, IDirect3DDevice_vtbl));
350 static inline IDirect3DDeviceImpl *device_from_device2(IDirect3DDevice2 *iface)
352 return (IDirect3DDeviceImpl *)((char*)iface - FIELD_OFFSET(IDirect3DDeviceImpl, IDirect3DDevice2_vtbl));
355 static inline IDirect3DDeviceImpl *device_from_device3(IDirect3DDevice3 *iface)
357 return (IDirect3DDeviceImpl *)((char*)iface - FIELD_OFFSET(IDirect3DDeviceImpl, IDirect3DDevice3_vtbl));
360 /*****************************************************************************
361 * IDirectDrawClipper implementation structure
362 *****************************************************************************/
363 struct IDirectDrawClipperImpl
365 IDirectDrawClipper IDirectDrawClipper_iface;
368 struct wined3d_clipper *wineD3DClipper;
372 HRESULT ddraw_clipper_init(IDirectDrawClipperImpl *clipper) DECLSPEC_HIDDEN;
373 IDirectDrawClipperImpl *unsafe_impl_from_IDirectDrawClipper(IDirectDrawClipper *iface) DECLSPEC_HIDDEN;
375 /*****************************************************************************
376 * IDirectDrawPalette implementation structure
377 *****************************************************************************/
378 struct IDirectDrawPaletteImpl
380 /* IUnknown fields */
381 const IDirectDrawPaletteVtbl *lpVtbl;
384 struct wined3d_palette *wineD3DPalette;
386 /* IDirectDrawPalette fields */
387 IUnknown *ifaceToRelease;
390 HRESULT ddraw_palette_init(IDirectDrawPaletteImpl *palette,
391 IDirectDrawImpl *ddraw, DWORD flags, PALETTEENTRY *entries) DECLSPEC_HIDDEN;
393 /* Helper structures */
394 struct object_creation_info
397 HRESULT (*pfnCreateInstance)(IUnknown *pUnkOuter, REFIID riid,
401 /******************************************************************************
402 * IDirect3DLight implementation structure - Wraps to D3D7
403 ******************************************************************************/
404 struct IDirect3DLightImpl
406 IDirect3DLight IDirect3DLight_iface;
409 /* IDirect3DLight fields */
410 IDirectDrawImpl *ddraw;
412 /* If this light is active for one viewport, put the viewport here */
413 IDirect3DViewportImpl *active_viewport;
423 /* Helper functions */
424 void light_activate(IDirect3DLightImpl *light) DECLSPEC_HIDDEN;
425 void light_deactivate(IDirect3DLightImpl *light) DECLSPEC_HIDDEN;
426 void d3d_light_init(IDirect3DLightImpl *light, IDirectDrawImpl *ddraw) DECLSPEC_HIDDEN;
427 IDirect3DLightImpl *unsafe_impl_from_IDirect3DLight(IDirect3DLight *iface) DECLSPEC_HIDDEN;
429 /******************************************************************************
430 * IDirect3DMaterial implementation structure - Wraps to D3D7
431 ******************************************************************************/
432 struct IDirect3DMaterialImpl
434 IDirect3DMaterial3 IDirect3DMaterial3_iface;
435 IDirect3DMaterial2 IDirect3DMaterial2_iface;
436 IDirect3DMaterial IDirect3DMaterial_iface;
439 /* IDirect3DMaterial2 fields */
440 IDirectDrawImpl *ddraw;
441 IDirect3DDeviceImpl *active_device;
447 /* Helper functions */
448 void material_activate(IDirect3DMaterialImpl* This) DECLSPEC_HIDDEN;
449 IDirect3DMaterialImpl *d3d_material_create(IDirectDrawImpl *ddraw) DECLSPEC_HIDDEN;
451 /*****************************************************************************
452 * IDirect3DViewport - Wraps to D3D7
453 *****************************************************************************/
454 struct IDirect3DViewportImpl
456 const IDirect3DViewport3Vtbl *lpVtbl;
459 /* IDirect3DViewport fields */
460 IDirectDrawImpl *ddraw;
462 /* If this viewport is active for one device, put the device here */
463 IDirect3DDeviceImpl *active_device;
477 struct list light_list;
479 /* Background material */
480 IDirect3DMaterialImpl *background;
483 /* Helper functions */
484 void viewport_activate(IDirect3DViewportImpl* This, BOOL ignore_lights) DECLSPEC_HIDDEN;
485 void d3d_viewport_init(IDirect3DViewportImpl *viewport, IDirectDrawImpl *ddraw) DECLSPEC_HIDDEN;
487 /*****************************************************************************
488 * IDirect3DExecuteBuffer - Wraps to D3D7
489 *****************************************************************************/
490 struct IDirect3DExecuteBufferImpl
492 IDirect3DExecuteBuffer IDirect3DExecuteBuffer_iface;
494 /* IDirect3DExecuteBuffer fields */
495 IDirectDrawImpl *ddraw;
496 IDirect3DDeviceImpl *d3ddev;
498 D3DEXECUTEBUFFERDESC desc;
501 /* This buffer will store the transformed vertices */
506 /* This flags is set to TRUE if we allocated ourselves the
512 HRESULT d3d_execute_buffer_init(IDirect3DExecuteBufferImpl *execute_buffer,
513 IDirect3DDeviceImpl *device, D3DEXECUTEBUFFERDESC *desc) DECLSPEC_HIDDEN;
514 IDirect3DExecuteBufferImpl *unsafe_impl_from_IDirect3DExecuteBuffer(IDirect3DExecuteBuffer *iface) DECLSPEC_HIDDEN;
516 /* The execute function */
517 HRESULT d3d_execute_buffer_execute(IDirect3DExecuteBufferImpl *execute_buffer,
518 IDirect3DDeviceImpl *device, IDirect3DViewportImpl *viewport) DECLSPEC_HIDDEN;
520 /*****************************************************************************
521 * IDirect3DVertexBuffer
522 *****************************************************************************/
523 struct IDirect3DVertexBufferImpl
525 IDirect3DVertexBuffer7 IDirect3DVertexBuffer7_iface;
526 IDirect3DVertexBuffer IDirect3DVertexBuffer_iface;
529 /*** WineD3D and ddraw links ***/
530 struct wined3d_buffer *wineD3DVertexBuffer;
531 struct wined3d_vertex_declaration *wineD3DVertexDeclaration;
532 IDirectDrawImpl *ddraw;
534 /*** Storage for D3D7 specific things ***/
539 HRESULT d3d_vertex_buffer_create(IDirect3DVertexBufferImpl **vertex_buf, IDirectDrawImpl *ddraw,
540 D3DVERTEXBUFFERDESC *desc) DECLSPEC_HIDDEN;
541 IDirect3DVertexBufferImpl *unsafe_impl_from_IDirect3DVertexBuffer(IDirect3DVertexBuffer *iface) DECLSPEC_HIDDEN;
542 IDirect3DVertexBufferImpl *unsafe_impl_from_IDirect3DVertexBuffer7(IDirect3DVertexBuffer7 *iface) DECLSPEC_HIDDEN;
544 /*****************************************************************************
545 * Helper functions from utils.c
546 *****************************************************************************/
548 #define GET_TEXCOUNT_FROM_FVF(d3dvtVertexType) \
549 (((d3dvtVertexType) & D3DFVF_TEXCOUNT_MASK) >> D3DFVF_TEXCOUNT_SHIFT)
551 #define GET_TEXCOORD_SIZE_FROM_FVF(d3dvtVertexType, tex_num) \
552 (((((d3dvtVertexType) >> (16 + (2 * (tex_num)))) + 1) & 0x03) + 1)
554 void PixelFormat_WineD3DtoDD(DDPIXELFORMAT *DDPixelFormat, enum wined3d_format_id WineD3DFormat) DECLSPEC_HIDDEN;
555 enum wined3d_format_id PixelFormat_DD2WineD3D(const DDPIXELFORMAT *DDPixelFormat) DECLSPEC_HIDDEN;
556 void DDRAW_dump_surface_desc(const DDSURFACEDESC2 *lpddsd) DECLSPEC_HIDDEN;
557 void dump_D3DMATRIX(const D3DMATRIX *mat) DECLSPEC_HIDDEN;
558 void DDRAW_dump_DDCAPS(const DDCAPS *lpcaps) DECLSPEC_HIDDEN;
559 DWORD get_flexible_vertex_size(DWORD d3dvtVertexType) DECLSPEC_HIDDEN;
560 void DDRAW_dump_DDSCAPS2(const DDSCAPS2 *in) DECLSPEC_HIDDEN;
561 void DDRAW_dump_cooperativelevel(DWORD cooplevel) DECLSPEC_HIDDEN;
563 /* This only needs to be here as long the processvertices functionality of
564 * IDirect3DExecuteBuffer isn't in WineD3D */
565 void multiply_matrix(LPD3DMATRIX dest, const D3DMATRIX *src1, const D3DMATRIX *src2) DECLSPEC_HIDDEN;
567 /* Used for generic dumping */
574 #define FE(x) { x, #x }
580 void (*func)(const void *);
585 #define ME(x,f,e) { x, #x, (void (*)(const void *))(f), offsetof(STRUCT, e) }
587 #define DD_STRUCT_COPY_BYSIZE_(to,from,from_size) \
589 DWORD __size = (to)->dwSize; \
590 DWORD __resetsize = min(__size, sizeof(*to)); \
591 DWORD __copysize = min(__resetsize, from_size); \
592 assert(to != from); \
593 memcpy(to, from, __copysize); \
594 memset((char*)(to) + __copysize, 0, __resetsize - __copysize); \
595 (to)->dwSize = __size; /* restore size */ \
598 #define DD_STRUCT_COPY_BYSIZE(to,from) DD_STRUCT_COPY_BYSIZE_(to,from,(from)->dwSize)
600 #define SIZEOF_END_PADDING(type, last_field) \
601 (sizeof(type) - offsetof(type, last_field) - sizeof(((type *)0)->last_field))
603 static inline void copy_to_surfacedesc2(DDSURFACEDESC2 *to, DDSURFACEDESC2 *from)
605 DWORD from_size = from->dwSize;
606 if (from_size == sizeof(DDSURFACEDESC))
607 from_size -= SIZEOF_END_PADDING(DDSURFACEDESC, ddsCaps);
608 to->dwSize = sizeof(DDSURFACEDESC2); /* for struct copy */
609 DD_STRUCT_COPY_BYSIZE_(to, from, from_size);
612 HRESULT hr_ddraw_from_wined3d(HRESULT hr) DECLSPEC_HIDDEN;