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
|
// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
/**
* @class vtkImageReader2Factory
* @brief Superclass of binary file readers.
*
* vtkImageReader2Factory: This class is used to create a vtkImageReader2
* object given a path name to a file. It calls CanReadFile on all
* available readers until one of them returns true. The available reader
* list comes from three places. In the InitializeReaders function of this
* class, built-in VTK classes are added to the list, users can call
* RegisterReader, or users can create a vtkObjectFactory that has
* CreateObject method that returns a new vtkImageReader2 sub class when
* given the string "vtkImageReaderObject". This way applications can be
* extended with new readers via a plugin dll or by calling RegisterReader.
* Of course all of the readers that are part of the vtk release are made
* automatically available.
*
* @sa
* vtkImageReader2
*/
#ifndef vtkImageReader2Factory_h
#define vtkImageReader2Factory_h
#include "vtkIOImageModule.h" // For export macro
#include "vtkObject.h"
VTK_ABI_NAMESPACE_BEGIN
class vtkImageReader2;
class vtkImageReader2Collection;
class vtkImageReader2FactoryCleanup;
class VTKIOIMAGE_EXPORT vtkImageReader2Factory : public vtkObject
{
public:
static vtkImageReader2Factory* New();
vtkTypeMacro(vtkImageReader2Factory, vtkObject);
void PrintSelf(ostream& os, vtkIndent indent) override;
/**
* registered readers will be queried in CreateImageReader2 to
* see if they can load a given file.
*/
static void RegisterReader(vtkImageReader2* r);
/**
* open the image file, it is the callers responsibility to call
* Delete on the returned object. If no reader is found, nullptr
* is returned.
*/
VTK_NEWINSTANCE
static vtkImageReader2* CreateImageReader2(const char* path);
/**
* Create a vtkImageReader2 from a (dotted or not) file extension.
* If multiple readers support the same extension, only one reader
* will be returned.
* It is the callers responsibility to call Delete on the returned object.
* If no reader is found, nullptr is returned.
*/
VTK_NEWINSTANCE
static vtkImageReader2* CreateImageReader2FromExtension(const char* extension);
/**
* The caller must allocate the vtkImageReader2Collection and pass in the
* pointer to this method.
*/
static void GetRegisteredReaders(vtkImageReader2Collection*);
/*
* An utility method to check if a (dotted or not) file extension is present
* in a list a whitespace separated list of dotted file extensions
*/
static bool CheckExtensionIsInExtensions(const char* extension, const char* extensions);
protected:
vtkImageReader2Factory() = default;
~vtkImageReader2Factory() override = default;
static void InitializeReaders();
private:
static vtkImageReader2Collection* AvailableReaders;
vtkImageReader2Factory(const vtkImageReader2Factory&) = delete;
void operator=(const vtkImageReader2Factory&) = delete;
friend class vtkImageReader2FactoryCleanup;
};
VTK_ABI_NAMESPACE_END
#endif
|
