Merge pull request #3340 from devshahofficial:devshahofficial/mjr-renderer-info

PiperOrigin-RevId: 948183711
Change-Id: I28b256eca22e86ec0ba05a4fa26458d678aca130

doc/APIreference/APItypes.rst

@@ -1286,6 +1286,16 @@ This structure specifies the attributes for a single vertex.
 
 
 
+.. _mjrRendererInfo:
+
+mjrRendererInfo
+~~~~~~~~~~~~~~~
+
+This structure contains information about the available renderer and its current context.
+
+.. mujoco-include:: mjrRendererInfo
+
+
 .. _mjrContext:
 
 mjrContext

doc/APIreference/functions.rst

@@ -2797,6 +2797,24 @@ of how to use these functions.
 
 Set default mjrContext.
 
+.. _mjr_defaultRendererInfo:
+
+`mjr_defaultRendererInfo <#mjr_defaultRendererInfo>`__
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. mujoco-include:: mjr_defaultRendererInfo
+
+Set default mjrRendererInfo.
+
+.. _mjr_getRendererInfo:
+
+`mjr_getRendererInfo <#mjr_getRendererInfo>`__
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. mujoco-include:: mjr_getRendererInfo
+
+Get active renderer information.
+
 .. _mjr_makeContext:
 
 `mjr_makeContext <#mjr_makeContext>`__

doc/includes/references.h

@@ -1378,6 +1378,10 @@ typedef struct mjrRect_ {         // OpenGL rectangle
   int width;                      // width (usually buffer width)
   int height;                     // height (usually buffer height)
 } mjrRect;
+typedef struct mjrRendererInfo_ {  // active renderer identity
+  const char* renderer;            // renderer family: classic, filament, noop
+  const char* backend;             // graphics backend: opengl, vulkan; empty if uninitialized
+} mjrRendererInfo;
 typedef struct mjrVertexAttribute_ {  // vertex attribute format specification
   const void* bytes;                  // vertex data
   int usage;                          // position, normal, etc [mjrVertexAttributeUsage]
@@ -3471,6 +3475,8 @@ void mjv_cameraFrame(mjtNum headpos[3], mjtNum forward[3], mjtNum up[3], mjtNum
 void mjv_cameraFrustum(float zver[2], float zhor[2], float zclip[2],  const mjModel* m,
                        const mjvCamera* cam);
 void mjr_defaultContext(mjrContext* con);
+void mjr_defaultRendererInfo(mjrRendererInfo* info);
+void mjr_getRendererInfo(mjrRendererInfo* info);
 void mjr_makeContext(const mjModel* m, mjrContext* con, int fontscale);
 void mjr_changeFont(int fontscale, mjrContext* con);
 void mjr_addAux(int index, int width, int height, int samples, mjrContext* con);