Sam Haves
57f7145806
- plugin system similar to mjpResourceProvider, but instead of loading a resource it converts an existing mjResource into an mjSpec. - The returned spec is then composed into the referencing spec. - This enables different file types to generate arbitrary specs, and allows us to separate format parsing from compilation code. Follow up CLs will move some of the logic in src/engine for PNG, USD, KTX, OBJ loading into decoders. The mj_parse function MjSpec from a given file, it's a more generic version of mj_parseXML. In it's implementation, mj_parse as opposed to mj_parseXML will look for any registered decoder and not assume we are striclty dealing with MJCF. PiperOrigin-RevId: 826149497 Change-Id: I0ece26904280cb94bd5ded6dd5a565c539d60254
96 lines
3.7 KiB
C
96 lines
3.7 KiB
C
// Copyright 2022 DeepMind Technologies Limited
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef MUJOCO_SRC_ENGINE_ENGINE_PLUGIN_H_
|
|
#define MUJOCO_SRC_ENGINE_ENGINE_PLUGIN_H_
|
|
|
|
#include <mujoco/mjexport.h>
|
|
#include <mujoco/mjplugin.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// set default plugin definition
|
|
MJAPI void mjp_defaultPlugin(mjpPlugin* plugin);
|
|
|
|
// globally register a plugin (thread-safe), return new slot id
|
|
MJAPI int mjp_registerPlugin(const mjpPlugin* plugin);
|
|
|
|
// globally register a resource provider (thread-safe), return new slot id
|
|
MJAPI int mjp_registerResourceProvider(const mjpResourceProvider* provider);
|
|
|
|
// return the number of globally registered plugins
|
|
MJAPI int mjp_pluginCount(void);
|
|
|
|
// return the number of globally registered resource providers
|
|
MJAPI int mjp_resourceProviderCount(void);
|
|
|
|
// look up a plugin by name, optionally also get its registered slot number
|
|
MJAPI const mjpPlugin* mjp_getPlugin(const char* name, int* slot);
|
|
|
|
// set default resource provider definition
|
|
MJAPI void mjp_defaultResourceProvider(mjpResourceProvider* provider);
|
|
|
|
// look up a resource provider that matches its prefix against the given resource name
|
|
MJAPI const mjpResourceProvider* mjp_getResourceProvider(const char* resource_name);
|
|
|
|
// look up a plugin by slot number
|
|
MJAPI const mjpPlugin* mjp_getPluginAtSlot(int slot);
|
|
|
|
// look up a resource provider by slot number
|
|
MJAPI const mjpResourceProvider* mjp_getResourceProviderAtSlot(int slot);
|
|
|
|
// return a config attribute of a plugin instance
|
|
// NULL: invalid plugin instance ID or attribute name
|
|
MJAPI const char* mj_getPluginConfig(const mjModel* m, int plugin_id, const char* attrib);
|
|
|
|
// load plugins from a dynamic library
|
|
MJAPI void mj_loadPluginLibrary(const char* path);
|
|
|
|
// scan a directory and load all dynamic libraries
|
|
MJAPI void mj_loadAllPluginLibraries(const char* directory, mjfPluginLibraryLoadCallback callback);
|
|
|
|
// registers a resource decoder
|
|
MJAPI void mjp_registerDecoder(const mjpDecoder* decoder);
|
|
|
|
// set default decoder definition
|
|
MJAPI void mjp_defaultDecoder(mjpDecoder* decoder);
|
|
|
|
// find a decoder that can process a given resource
|
|
MJAPI const mjpDecoder* mjp_findDecoder(const mjResource* resource, const char* content_type);
|
|
|
|
// =================================================================================================
|
|
// MuJoCo-internal functions beyond this point.
|
|
// "Unsafe" suffix indicates that improper use of these functions may result in data races.
|
|
//
|
|
// The unsafe functions assume that mjp_pluginCount has already been called, and that all plugins
|
|
// up to `count` have been completely written into the global table.
|
|
// =================================================================================================
|
|
|
|
// internal version of mjp_registerResourceProvider without prechecks on reserved prefixes
|
|
MJAPI int mjp_registerResourceProviderInternal(const mjpResourceProvider* provider);
|
|
|
|
// look up a plugin by name, assuming that mjp_pluginCount has already been called
|
|
const mjpPlugin* mjp_getPluginUnsafe(const char* name, int* slot, int nslot);
|
|
|
|
// look up a plugin by slot number, assuming that mjp_pluginCount has already been called
|
|
const mjpPlugin* mjp_getPluginAtSlotUnsafe(int slot, int nslot);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // MUJOCO_SRC_ENGINE_ENGINE_PLUGIN_H_
|