magnum

Commit Graph

Author	SHA1	Message	Date
Vladimír Vondruš	43c70b11dd	doc: cnsistently reference all Magnum CLI tools from related APIs.	5 years ago
Vladimír Vondruš	3629b5d4c8	Trade: MSVC, your insistence on deprecation-as-error is not helping.	5 years ago
Vladimír Vondruš	27044a4fef	Trade: ability to open non-temporary memory. Using openMemory() instead of openData() allows the implementation to assume the data will stay in scope for as long as needed, which can prevent unnecessary copies in some plugin implementations. It warranted a new flag, DataFlag::ExternallyOwned, to describe this kind of memory. I couldn't reuse Owned as that's used for allocations owned by the instance, which is too little for certain future use cases. For example returning *Data instances referencing an Owned memory would mean the user has to assume the memory is gone when the importer instance is gone, and that's generally not true for memory passed to openMemory(). Originally I thought I would do this later, but then realized the existing plugin implementations would need to get all updated again to be aware of the new flag, with some being forgotten, and it's just easier to do the whole thing in a single step.	5 years ago
Vladimír Vondruš	440ece15fb	Audio,Text,Trade: accept void ArrayViews in importer plugins. This makes it much less annoying to pass arbitrarily typed data, such as std::uint8_t or char8_t and what not. It was already done like this for the new shader converter plugins, where the input is often 32-bit ints for SPIR-V. OTOH the internal virtual API is kept with ArrayView<const char>, as that makes it easier to operate on by the implementations.	5 years ago
Vladimír Vondruš	116d327a64	Trade: AbstractImporter::doOpenData() now takes a rvalue Array. This allows to better describe memory ownership and transfer it instead of forcing the plugins to allocate their own local copy if the import happens in-place on the imported data. Right now that's mainly for the openFile() use case, which implicitly allocated an Array with file contents only to pass it to openData() which then made a copy because it could not make any assumption about data scope. In other words, certain plugins (TgaImporter, KtxImporter, DdsImporter, CgltfImporter and possibly others) will now have their peak memory usage halved.	5 years ago
Vladimír Vondruš	602f08881b	Trade: ensure AbstractImporter::fooForName() returns indices in bounds. I just accidentally returned a wrong index from a SceneData backwards compatibility wrapper and realized it'd be good to have that checked always.	5 years ago
Vladimír Vondruš	781c5c3e08	Trade: doc++	5 years ago
Vladimír Vondruš	9b41947dbc	Trade: doc++	5 years ago
Vladimír Vondruš	2b2b7d5f2f	Trade: provide a clear doc snippet for AbstractImporter::openData(). The snippet with callbacks was too heavyweight for this kind of operation and workflow with in-memory data may be non-obvious to some users.	5 years ago
Vladimír Vondruš	90e8798d36	Trade: "flip Y" is not a good idea, "Y up" is clearer.	5 years ago
Vladimír Vondruš	4a06f4d048	Trade: improve docs for the main importer / converter plugins. Interestingly enough, there were no docs whatsoever for image and scene conversion, and neither it was mentioned what all scene data can be imported. Sigh.	5 years ago
Aaron Gokaslan	ca677c69fe	Fix typos	5 years ago
Vladimír Vondruš	29ac7b5a4d	Trade,ShaderTools: add addFlags() / clearFlags() to all plugin interfaces. There will be Flag::FlipY for images at some point, enabled by default for compatibility with existing GL code, and so it makes sense to start discouraging setFlags() as early as possible to avoid people resetting the default by accident. Also update the imageconverter, sceneconverter and shaderconverter utils to use these instead of setFlags().	5 years ago
Vladimír Vondruš	e3c72b36ee	Trade: doc++	5 years ago
Vladimír Vondruš	3d136503d8	Updated copyright year.	5 years ago
Vladimír Vondruš	5c223d2045	doc: reference CLI utils from plugin interface classes.	6 years ago
Vladimír Vondruš	13dfb6472f	ShaderTools: bootstrap new library. Currently there's just a plugin interface for shader converters. More stuff (probably something like SPIR-V reflection) will come later.	6 years ago
Vladimír Vondruš	7231a48fbf	Trade,Text: this is a much better example for template file callbacks.	6 years ago
Vladimír Vondruš	78f38b89ad	Trade: doc++ Huh, so much copypaste bullshit.	6 years ago
Vladimír Vondruš	9c14f1d367	Trade: clarify AbstractImporter::do*Count() error handling.	6 years ago
Vladimír Vondruš	ddb7185417	Trade: make AbstractImporter::defaultScene() const. Makes more sense as the function isn't expected to fail (and thus any kind of lazy population is not possible as it would be too late for error checks anyway). Not updating interface strings even though this is an ABI break because we're doing that right after the skin import interface bump.	6 years ago
Vladimír Vondruš	5217f48499	Trade: disallow custom deleters in AbstractImporter::skinXD().	6 years ago
Vladimír Vondruš	8c24ea19d3	Trade: skin import in AbstractImporter.	6 years ago
Vladimír Vondruš	b9413d3ff5	doc: avoid plugin interface strings getting out of sync with docs.	6 years ago
Vladimír Vondruš	1be899d7fb	Trade: doc++	6 years ago
Vladimír Vondruš	0ec8e002fb	Trade: return Optional instead of Pointer from *Importer::material(). The plugin interface version got bumped to avoid ABI issues when loading plugins that weren't updated for the change, but apart from that this shouldn't be a breaking change, as the API returns a type that can be both an Optional and a Pointer.	6 years ago
Vladimír Vondruš	18fffd6fdf	Trade: remove compatibility include of PointerStl from AbstractImporter. For some reason forgotten in `868843c9bb`.	6 years ago
Vladimír Vondruš	5222cf3478	doc: change all "latest" additions/deprecations to 2020.06.	6 years ago
Vladimír Vondruš	769e27340f	Trade: AbstractImporter::importerState() expects a file to be opened. The restriction was there always, but was undocumented and untested.	6 years ago
Vladimír Vondruš	19e0e96d74	Updated copyright year.	6 years ago
Vladimír Vondruš	0bdb70fcf6	Trade: add flags to AbstractImporter and AbstractImageConverter.	6 years ago
Vladimír Vondruš	4090a88c97	Rework plugin search paths using new Corrade APIs.	6 years ago
Vladimír Vondruš	3b4093da14	Doc++	6 years ago
Vladimír Vondruš	c3299ad3c5	Trade: print a message when named thing is not found. Otherwise it's hard to distinguish whether it's a particular importer fault (failing without a message) or if the name is not found.	6 years ago
Vladimír Vondruš	081dd8981f	Doxygen, FFS.	6 years ago
Vladimír Vondruš	9425c23d0a	Trade: support mesh level import in AbstractImporter. Similar to image mip level import, but this is largely left to be importer-specific. For example PLY defines per-face data and sometimes one might want to import them as-is, without them being turned into a per-vertex property.	6 years ago
Vladimír Vondruš	a02e9465d6	Trade: allow retrieving importer data directly by name.	6 years ago
Vladimír Vondruš	006790969a	Trade, MeshTools: deprecate MeshDataXD and everything that uses it.	6 years ago
Vladimír Vondruš	0f4a5adb4d	Trade: deprecate AbstractImporter interfaces for MeshDataXD. For backwards compatibility these will delegate to the new MeshData interfaces for 3D (and nothing for 2D, because so far there were no 2D scene importers).	6 years ago
Vladimír Vondruš	036fced749	Trade: whitelist (exported) growable array deleters in imported data.	6 years ago
Vladimír Vondruš	4011e3006d	Trade: allow non-owning aray deleters passed through Importer APIs.	6 years ago
Vladimír Vondruš	fb1fdf6105	Trade: implement Importer interfaces for the new MeshData. Deprecating of the old ones comes later.	6 years ago
Vladimír Vondruš	8f52397027	Trade: mark new APIs as such.	6 years ago
Vladimír Vondruš	dfacd7fb2d	Trade: support mip levels in image import. There's a new level option in each imageND() API, plus an imageNDLevelCount() query to get image level count.	6 years ago
Vladimír Vondruš	d14655aa1d	doc: fix outdated docs about plugin search paths.	6 years ago
Vladimír Vondruš	19dd7a0176	Move Feature[s] enums from inside plugin classes outside. Too annoyingly long to type. Also added a debug output operator for the FontConverterFeature enums, for some reason there were none.	6 years ago
Vladimír Vondruš	a920722839	doc: label deprecated APIs and stuff new since 2019.10 with version info. Should make new things more discoverable, avoid confusion when a documented API isn't there and reduce the need for maintaining multiple separate versions of the docs.	7 years ago
Vladimír Vondruš	84fc685c87	Trade, Audio: explicitly disallow custom deleters returned from plugins.	7 years ago
Vladimír Vondruš	0d71c1d1cc	Search plugins relative to library DLLs on Windows. Makes Windows users' lives slightly easier.	7 years ago
Vladimír Vondruš	10d5894e50	Trade: doc++	7 years ago

1 2 3

105 Commits (43c70b11ddd9942d0ca0d413eab0129ba02abfe8)