API Documentation
Loading...
Searching...
No Matches
ModelFactory.h
Go to the documentation of this file.
1/*--------------------------------------------------------------------------------------------
2Copyright (c) 2019, NDEVR LLC
3tyler.parke@ndevr.org
4 __ __ ____ _____ __ __ _______
5 | \ | | | __ \ | ___|\ \ / / | __ \
6 | \ | | | | \ \ | |___ \ \ / / | |__) |
7 | . \| | | |__/ / | |___ \ V / | _ /
8 | |\ |_|_____/__|_____|___\_/____| | \ \
9 |__| \__________________________________| \__\
10
11Subject to the terms of the Enterprise+ Agreement, NDEVR hereby grants
12Licensee a limited, non-exclusive, non-transferable, royalty-free license
13(without the right to sublicense) to use the API solely for the purpose of
14Licensee's internal development efforts to develop applications for which
15the API was provided.
16
17The above copyright notice and this permission notice shall be included in all
18copies or substantial portions of the Software.
19
20THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
21INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
22PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
23FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
24OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
25DEALINGS IN THE SOFTWARE.
26
27Library: IOFactory
28File: ModelFactory
29Included in API: True
30Author(s): Tyler Parke
31 *-----------------------------------------------------------------------------------------**/
32#pragma once
33#include <NDEVR/IOFactory.h>
34#include <NDEVR/File.h>
35#include <NDEVR/FactoryOptions.h>
36namespace NDEVR
37{
38 /**--------------------------------------------------------------------------------------------------
39 \brief The core logic for importing and exporting files from the model heirarchy. Stores a series
40 of IOFactory children that can define when and how they are able to export or import data.
41
42 Based on options will select the proper IOFactory to perform the import or export task.
43 **/
45 {
46 protected:
49 public:
51 virtual void getSupportedFormats(Buffer<FileFormat>& formats, bool is_read) override;
52 virtual void getSupportedFormats(Buffer<FileFormat>& formats, const File& file) override { IOFactory::getSupportedFormats(formats, file); };
53 virtual void getSupportedFormatsByModelType(Buffer<FileFormat>& formats, bool is_read, const String& model_type) override;
54 virtual void getSupportedFormats(Buffer<FileFormat>& formats, DesignObjectLookup* lookup, const Buffer<UUID>& models) override;
55 virtual String getIcon(const File& file) override;
56 virtual bool canRead(const FactoryParameters& file) override;
57 virtual bool canWrite(const FactoryParameters& file) override;
58 virtual bool determineExtension(const File& file, String& extension) override;
59 virtual FactoryOptions defaultReadOptions(const FactoryParameters& file) const override;
60 virtual FactoryOptions defaultWriteOptions(const FactoryParameters& file) const override;
61 virtual Buffer<UUID> filterModelsToExport(Buffer<UUID> models_to_check, const DesignObjectLookup* lookup, const FileFormat& export_format) const override;
62 FactoryFeatures factoryFeatures(const FactoryParameters& file, bool is_import) const override;
63 virtual bool canRead(const File& file) override;
64 virtual bool canWrite(const File& file) override;
65 virtual bool readFile(FactoryParameters& file) override;
66 virtual bool updateFromFile(const FactoryParameters& file, const FactoryOptions& old_options) override;
67 virtual bool writeFile(FactoryParameters& file) override;
68 void addFactory(IOFactory* factory);
69 void addFactory(String extension, IOFactory* factory);
70 void enableExtension(String extension, const String& read_password, const String& write_password);
71 void enableFactory(IOFactory* factory, const String& read_password, const String& write_password);
72 void enableFactory(const String& factory, const String& read_password, const String& write_password);
74 protected:
80 };
81}
#define NDEVR_FACTORY_API
Definition DLLInfo.h:57
The equivelent of std::vector but with a bit more control. The basic array unit of the library.
Definition Buffer.hpp:56
A core class where all Design Objects including models, materials, and geometries are stored....
Definition DesignObjectLookup.h:65
A hash-based key-value store, useful for quick associative lookups. Key features include:
Definition Dictionary.h:61
Allows IOFactories to report what features they support to make the import/export dialogs easier to s...
Definition FactoryFeatures.h:44
User-defined options that define preferences for importing and exporting using IOFactory objects.
Definition FactoryOptions.h:49
Data that describes a particular file format and how to use the format with the program....
Definition FileFormat.h:43
Logic for reading or writing to a file as well as navigating filesystems.
Definition File.h:48
A service that provides Import/Export functionality for a model heirarchy. These can be registered wi...
Definition IOFactory.h:117
The core logic for importing and exporting files from the model heirarchy. Stores a series of IOFacto...
Definition ModelFactory.h:45
Dictionary< String, String > m_extension_read_passwords
Definition ModelFactory.h:78
Dictionary< String, IOFactory * > m_named_factories
Definition ModelFactory.h:77
virtual FactoryOptions defaultWriteOptions(const FactoryParameters &file) const override
virtual void getSupportedFormats(Buffer< FileFormat > &formats, const File &file) override
Definition ModelFactory.h:52
virtual bool determineExtension(const File &file, String &extension) override
Buffer< IOFactory * > * m_factory_objects
Definition ModelFactory.h:75
virtual bool canRead(const FactoryParameters &file) override
virtual bool readFile(FactoryParameters &file) override
void enableFactory(const String &factory, const String &read_password, const String &write_password)
virtual String getIcon(const File &file) override
static ModelFactory & DefaultFactory()
virtual Buffer< UUID > filterModelsToExport(Buffer< UUID > models_to_check, const DesignObjectLookup *lookup, const FileFormat &export_format) const override
FactoryFeatures factoryFeatures(const FactoryParameters &file, bool is_import) const override
virtual void getSupportedFormatsByModelType(Buffer< FileFormat > &formats, bool is_read, const String &model_type) override
virtual bool writeFile(FactoryParameters &file) override
virtual bool canWrite(const File &file) override
virtual FactoryOptions defaultReadOptions(const FactoryParameters &file) const override
virtual bool updateFromFile(const FactoryParameters &file, const FactoryOptions &old_options) override
virtual void getSupportedFormats(Buffer< FileFormat > &formats, bool is_read) override
virtual void getSupportedFormats(Buffer< FileFormat > &formats, DesignObjectLookup *lookup, const Buffer< UUID > &models) override
void addFactory(String extension, IOFactory *factory)
Dictionary< String, String > m_extension_write_passwords
Definition ModelFactory.h:79
void enableExtension(String extension, const String &read_password, const String &write_password)
void enableFactory(IOFactory *factory, const String &read_password, const String &write_password)
void addFactory(IOFactory *factory)
virtual bool canWrite(const FactoryParameters &file) override
virtual bool canRead(const File &file) override
Dictionary< String, IOFactory * > m_extension_factories
Definition ModelFactory.h:76
Software Service Managers take a Software service to modify the behavior of the software.
Definition SoftwareService.h:15
The core String class for the NDEVR API.
Definition String.h:69
Definition ACIColor.h:37
A container of input information that is to be filled with output information by an IOFactory.
Definition IOFactory.h:61