mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-05-06 10:36:12 +03:00
d5f74e42d6
License statement text corrected; compiler warnings caused by Bison 2.41 disabled for MSVC; a few other compiler warnings on 54-bit Windows eliminated by appropriate type cast Wrong license statements corrected in several files. Copyright and license statements added in XSD and GLSL files. Copyright year updated in some files. Obsolete documentation files removed from DrawResources.
93 lines
4.3 KiB
C++
93 lines
4.3 KiB
C++
// Copyright (c) 1999-2014 OPEN CASCADE SAS
|
|
//
|
|
// This file is part of Open CASCADE Technology software library.
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License version 2.1 as published
|
|
// by the Free Software Foundation, with special exception defined in the file
|
|
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
// distribution for complete text of the license and disclaimer of any warranty.
|
|
//
|
|
// Alternatively, this file may be used under the terms of Open CASCADE
|
|
// commercial license or contractual agreement.
|
|
|
|
// Macros to help static Handles not to be "constructed" before main run
|
|
// In order to avoid it, the Handle to be statically reserved is encapsulated
|
|
// in a structure itself designated through a Null Pointer :
|
|
// Only the pointer is declared static, and initialized to NULL : then,
|
|
// there is no routine to call for static construction
|
|
|
|
// Remember that the objet designated by a static Handle should not be created
|
|
// in the static declaration, but must anyway be created, during main run,
|
|
// once before its first use : this is the initialization step.
|
|
|
|
|
|
// This set of macros allows user to simply declare and use "static" Handles.
|
|
// It is available once having included this file :
|
|
// ***************************************************
|
|
// #include <Interface_Statics.hxx>
|
|
|
|
// Static construction is replaced by using the macro StaticHandle :
|
|
// ***************************************************
|
|
// Old statement : static Handle(pk_class) object;
|
|
// Is replaced by : StaticHandle(pk_class,object);
|
|
// which creates a null pointer called 'object_s' and typed 'pk_class_struc'
|
|
|
|
// For first initialisation and use, several ways are available, all of them
|
|
// give an access to the Handle through a reference.
|
|
// It is required to initialize the static structure once, the macros Init*
|
|
// assume that it is created once and only once, even if they are called
|
|
// more than once.
|
|
// It is possible : to create the object at initialization time by a macro,
|
|
// or to create it after the macro call through its reference :
|
|
|
|
// ***************************************************
|
|
// Old statement (in a routine, not static) :
|
|
// if (object.IsNull()) object = new pk_class (..args if any..);
|
|
// can be maintained, but preceeded by an initialization :
|
|
// InitHandle(pk_class,object); // -> Null Handle
|
|
|
|
// ***************************************************
|
|
// or it can be replaced by a direct formula (creation called only once) :
|
|
// InitHandleVoid(pk_class,object); // for a void constructor
|
|
// or InitHandleArgs(pk_class,object,(..args..));
|
|
// (the arglist between embedded parentheses)
|
|
// or InitHandleVal(pk_class,object,val); // i.e. object = val;
|
|
|
|
// To simply use this pseudo-static object, consider
|
|
// either the static variable object_s->H
|
|
// ***************************************************
|
|
// or take it by the macro (which does not initialize it)
|
|
// UseHandle(pk_class,object);
|
|
|
|
|
|
// Declaration of a static Handle : first use for a given type
|
|
#define StaticHandle(type,var) static struct type##_struc { Handle(type) H; } *var##_s = NULL
|
|
|
|
// Another declaration for an already declared type (with StaticHandle)
|
|
#define StaticHandleA(type,var) static struct type##_struc *var##_s = NULL
|
|
|
|
// Using it (IT MUST HAVE BEEN FORMERLY INITIALIZED)
|
|
#define UseHandle(type,var) Handle(type)& var = var##_s->H
|
|
|
|
// Initializing it (as Null Handle)
|
|
#define InitHandle(type,var) \
|
|
if(!var##_s) { var##_s=new type##_struc; }\
|
|
Handle(type)& var = var##_s->H;
|
|
|
|
// Initializing it and Creating it by a Void Constructor
|
|
#define InitHandleVoid(type,var) \
|
|
if(!var##_s) { var##_s=new type##_struc; var##_s->H=new type; }\
|
|
Handle(type)& var = var##_s->H;
|
|
|
|
// Initializing it and Creating it by a Constructor with Arguments
|
|
// (give them grouped in their parentheses)
|
|
#define InitHandleArgs(type,var,args) \
|
|
if(!var##_s) { var##_s=new type##_struc; var##_s->H=new type args; }\
|
|
Handle(type)& var = var##_s->H;
|
|
|
|
// Initializing it from an already determined Value
|
|
#define InitHandleVal(type,var,value) \
|
|
if(!var##_s) { var##_s=new type##_struc; var##_s->H=value; }\
|
|
Handle(type)& var = var##_s->H;
|