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
|
// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-FileCopyrightText: Copyright 2008 Sandia Corporation
// SPDX-License-Identifier: LicenseRef-BSD-3-Clause-Sandia-USGov
/**
* @class vtkTextCodecFactory
* @brief maintain a list of text codecs and return instances
*
*
* A single class to hold registered codecs and return instances of them based
* on either a descriptive name (UTF16 or latin-1) or by asking who can handle a
* given std::vector<unsigned char>
*
* @par Thanks:
* Thanks to Tim Shed from Sandia National Laboratories for his work
* on the concepts and to Marcus Hanwell and Jeff Baumes of Kitware for
* keeping me out of the weeds
*
* @sa
* vtkTextCodec
*
*/
#ifndef vtkTextCodecFactory_h
#define vtkTextCodecFactory_h
#include "vtkIOCoreModule.h" // For export macro
#include "vtkObject.h"
VTK_ABI_NAMESPACE_BEGIN
class vtkTextCodec;
class VTKIOCORE_EXPORT vtkTextCodecFactory : public vtkObject
{
public:
vtkTypeMacro(vtkTextCodecFactory, vtkObject);
static vtkTextCodecFactory* New();
void PrintSelf(ostream& os, vtkIndent indent) override;
/**
* Type for Creation callback.
*/
typedef vtkTextCodec* (*CreateFunction)();
///@{
/**
* Provides mechanism to register/unregister additional callbacks to create
* concrete subclasses of vtkTextCodecFactory to handle different protocols.
* The registered callbacks are tried in the order they are registered.
*/
static void RegisterCreateCallback(CreateFunction callback);
static void UnRegisterCreateCallback(CreateFunction callback);
static void UnRegisterAllCreateCallbacks();
///@}
/**
* Given a codec/storage name try to find one of our registered codecs that
* can handle it. This is non-deterministic, very messy and should not be
* your first thing to try.
* The registered callbacks are tried in the order they are registered.
*/
static vtkTextCodec* CodecForName(const char* CodecName);
/**
* Given a snippet of the stored data name try to find one of our registered
* codecs that can handle transforming it into unicode.
* The registered callbacks are tried in the order they are registered.
*/
static vtkTextCodec* CodecToHandle(istream& InputStream);
/**
* Initialize core text codecs - needed for the static compilation case.
*/
static void Initialize();
protected:
vtkTextCodecFactory();
~vtkTextCodecFactory() override;
private:
vtkTextCodecFactory(const vtkTextCodecFactory&) = delete;
void operator=(const vtkTextCodecFactory&) = delete;
///@{
/**
* Data structure used to store registered callbacks.
*/
class CallbackVector;
static CallbackVector* Callbacks;
///@}
};
VTK_ABI_NAMESPACE_END
#endif // vtkTextCodecFactory_h
|
