Question on CreateRenderAPI

[podborski]

Sorry for bothering you guys, but I really would like to understand one thing.

Can somebody explain to me why RegisterPlugin() is called only for WEBGL?

NativeRenderingPlugin/UnityProject/Assets/UseRenderingPlugin.cs

Lines 56 to 57 in 2b8ca29

	#if UNITY_WEBGL && !UNITY_EDITOR
	RegisterPlugin();

I don't quite understand from the code how OnGraphicsDeviceEvent (which creates an instance of the RenderAPI) gets called.

In other words, when not using UNITY_WEBGL how does CreateRenderAPI gets called?

NativeRenderingPlugin/PluginSource/source/RenderingPlugin.cpp

Line 144 in 2b8ca29

s_CurrentAPI = CreateRenderAPI(s_DeviceType);

I know that I am missing something, since the code seems to work just fine.

Thank you very much.

[samjacobson]

I'm not affiliated with Unity.

Unity calls UnityPluginLoad in the plugin dll when the plugin is first accessed. This calls OnGraphicsDeviceEvent directly (at the end of the function), and also registers that function with Unity here:

NativeRenderingPlugin/PluginSource/source/RenderingPlugin.cpp

Line 98 in 2b8ca29

s_Graphics->RegisterDeviceEventCallback(OnGraphicsDeviceEvent);

so that it will be called when a graphics device event occurs (e.g. shutdown).

[podborski]

@samjacobson Thank you :) This explains it. I just tested it and indeed, UnityPluginLoad gets called automatically.
Is there any documentation on it that I have missed?

[samjacobson]

https://docs.unity3d.com/Manual/NativePluginInterface.html
mentions the UnityPluginLoad.

[podborski]

Wow, how could I miss that?
Thank you again!