VTK  9.4.20241221
vtkObjectManager.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2// SPDX-License-Identifier: BSD-3-Clause
19#ifndef vtkObjectManager_h
20#define vtkObjectManager_h
21
22#include "vtkObject.h"
23
24#include "vtkDeserializer.h" // for vtkDeserializer
25#include "vtkLogger.h" // for vtkLogger::Verbosity enum
26#include "vtkNew.h" // for vtkNew
27#include "vtkSerializationManagerModule.h" // for export macro
28#include "vtkSerializer.h" // for vtkSerializer
29#include "vtkSmartPointer.h" // for vtkSmartPointer
30
31#include <string> // for string
32#include <vector> // for vector
33
34VTK_ABI_NAMESPACE_BEGIN
36class vtkTypeUInt8Array;
37
38class VTKSERIALIZATIONMANAGER_EXPORT vtkObjectManager : public vtkObject
39{
40public:
43 void PrintSelf(ostream& os, vtkIndent indent) override;
44
46
49 virtual bool Initialize();
52
56 using RegistrarType = std::function<int(void* ser, void* deser, const char** error)>;
57 bool InitializeExtensionModuleHandlers(const std::vector<RegistrarType>& registrars);
58
64
69 bool UnRegisterObject(vtkTypeUInt32 identifier);
70
77 bool RegisterState(const std::string& state);
78
82 bool UnRegisterState(vtkTypeUInt32 identifier);
83
89 vtkTypeUInt32 GetId(vtkSmartPointer<vtkObjectBase> objectBase);
90
96 std::string GetState(vtkTypeUInt32 id);
97
103
110 std::vector<vtkTypeUInt32> GetAllDependencies(vtkTypeUInt32 identifier);
111
116 std::vector<std::string> GetBlobHashes(const std::vector<vtkTypeUInt32>& ids);
117
121 vtkSmartPointer<vtkTypeUInt8Array> GetBlob(const std::string& hash) const;
122
127 bool RegisterBlob(const std::string& hash, vtkSmartPointer<vtkTypeUInt8Array> blob);
128
132 bool UnRegisterBlob(const std::string& hash);
133
139
144
149
153 void UpdateObjectFromState(const std::string& state);
154
158 void UpdateStateFromObject(vtkTypeUInt32 identifier);
159
166 void Clear();
167
170
175 void Export(const std::string& filename, int indentLevel = -1, char indentChar = ' ');
176
182 void Import(const std::string& stateFileName, const std::string& blobFileName);
183
184 static vtkTypeUInt32 ROOT() { return 0; }
185
188
190
205
206protected:
209
214
215 static const char* OWNERSHIP_KEY() { return "manager"; }
216
221
226
227private:
228 vtkObjectManager(const vtkObjectManager&) = delete;
229 void operator=(const vtkObjectManager&) = delete;
230};
231VTK_ABI_NAMESPACE_END
232#endif
Deserialize VTK objects from JSON.
a simple class to control print indentation
Definition vtkIndent.h:108
@ VERBOSITY_INVALID
Definition vtkLogger.h:214
Shared context used by vtkSerializer and vtkDeserializer
Allocate and hold a VTK object.
Definition vtkNew.h:167
vtkObjectManager maintains internal instances of vtkSerializer and a vtkDeserializer to serialize and...
void Import(const std::string &stateFileName, const std::string &blobFileName)
Reads state from state file and blobs from blob file.
bool InitializeDefaultHandlers()
Loads the default (de)serialization handlers and constructors for VTK classes.
void UpdateObjectFromState(const std::string &state)
Deserialize the state into vtk object.
bool RegisterState(const std::string &state)
Adds state into an internal container and returns a unique identifier.
bool UnRegisterObject(vtkTypeUInt32 identifier)
Removes an object and it's state.
vtkNew< vtkDeserializer > Deserializer
vtkSmartPointer< vtkTypeUInt8Array > GetBlob(const std::string &hash) const
Returns a blob stored at hash.
void UpdateStatesFromObjects()
Serialize registered objects into vtk states.
bool UnRegisterBlob(const std::string &hash)
Removes a blob stored at hash.
vtkSmartPointer< vtkObjectBase > GetObjectAtId(vtkTypeUInt32 id)
Get object at id.
void Export(const std::string &filename, int indentLevel=-1, char indentChar=' ')
Writes state of all registered objects to filename.json The blobs are written into filename....
void SetObjectManagerLogVerbosity(vtkLogger::Verbosity verbosity)
Set/Get the log verbosity of messages that are emitted when data is uploaded to GPU memory.
vtkSmartPointer< vtkMarshalContext > Context
bool InitializeExtensionModuleHandlers(const std::vector< RegistrarType > &registrars)
std::size_t GetTotalBlobMemoryUsage()
vtkLogger::Verbosity GetObjectManagerLogVerbosity()
Set/Get the log verbosity of messages that are emitted when data is uploaded to GPU memory.
void PruneUnusedObjects()
Removes all objects that are neither referenced by this manager or any other object.
~vtkObjectManager() override
bool UnRegisterState(vtkTypeUInt32 identifier)
Removes a state at id.
void UpdateObjectsFromStates()
Deserialize registered states into vtk objects.
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkNew< vtkSerializer > Serializer
void PruneUnusedStates()
Removes all objects that are neither referenced by this manager or any other object.
static vtkTypeUInt32 ROOT()
void UpdateStateFromObject(vtkTypeUInt32 identifier)
Serialize object at identifier into the state.
vtkTypeUInt32 RegisterObject(vtkSmartPointer< vtkObjectBase > objectBase)
Adds object into an internal container and returns a unique identifier.
vtkTypeUInt32 GetId(vtkSmartPointer< vtkObjectBase > objectBase)
Get the identifier for object.
bool RegisterBlob(const std::string &hash, vtkSmartPointer< vtkTypeUInt8Array > blob)
Specifies a blob for hash.
virtual bool Initialize()
Loads the default (de)serialization handlers and constructors for VTK classes.
void PruneUnusedBlobs()
Removes all blob(s) whose hash is not found in the state of any object registered directly or indirec...
vtkGetSmartPointerMacro(Serializer, vtkSerializer)
std::vector< std::string > GetBlobHashes(const std::vector< vtkTypeUInt32 > &ids)
Returns a non-empty vector of hash strings that correspond to blobs used by the registered objects at...
std::size_t GetTotalVTKDataObjectMemoryUsage()
std::vector< vtkTypeUInt32 > GetAllDependencies(vtkTypeUInt32 identifier)
Returns a non-empty vector of identifiers of all objects that depend on an object with the given iden...
std::function< int(void *ser, void *deser, const char **error)> RegistrarType
Loads user provided handlers.
std::string GetState(vtkTypeUInt32 id)
Get state of the object at id.
static vtkObjectManager * New()
static const char * OWNERSHIP_KEY()
vtkGetSmartPointerMacro(Deserializer, vtkDeserializer)
void Clear()
Reset to initial state.
abstract base class for most VTK objects
Definition vtkObject.h:162
Serialize VTK objects to JSON.
Hold a reference to a vtkObjectBase instance.