stride3d/stride · error · ArgumentNullException

Value cannot be null. (Parameter 'renderer')

Error message

Value cannot be null. (Parameter 'renderer')

What it means

Argument-null validation in RendererManager.RegisterRenderer: the renderer parameter is null. Caching a null renderer would cause GetRenderer to return nothing useful on later frames; the registration therefore rejects a null IElementRenderer with ArgumentNullException named 'renderer'.

Solutions

1. Pass a non-null IElementRenderer instance as the renderer argument to RegisterRenderer.
2. Create the renderer first; if renderer construction can fail or return null, skip the registration and log instead of passing null.
3. Guard the call site so a failed renderer lookup does not flow a null reference into RegisterRenderer.

When it happens

Trigger: Thrown at sources/engine/Stride.UI/Renderers/RendererManager.cs:76 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of stride3d/stride@96fad776d2 (2026-09-14). Data as JSON: /api/errors/954f06872f4a09e3. Report an issue: GitHub.

Appendix: source

Thrown at sources/engine/Stride.UI/Renderers/RendererManager.cs:76

            return elementRenderer;
        }

        public void RegisterRendererFactory(Type uiElementType, IElementRendererFactory factory)
        {
            if (uiElementType == null) throw new ArgumentNullException(nameof(uiElementType));
            if (factory == null) throw new ArgumentNullException(nameof(factory));

            if (!typeof(UIElement).GetTypeInfo().IsAssignableFrom(uiElementType.GetTypeInfo()))
                throw new InvalidOperationException(uiElementType + " is not a descendant of UIElement.");

            typesToUserFactories[uiElementType] = factory;
        }

        public void RegisterRenderer(UIElement element, ElementRenderer renderer)
        {
            if (element == null) throw new ArgumentNullException(nameof(element));
            if (renderer == null) throw new ArgumentNullException(nameof(renderer));

            elementIdToRenderer[element.Id] = renderer;
        }

        public void Dispose()
        {
            foreach (var renderer in elementIdToRenderer.Values)
            {
                if (!renderer.IsDisposed)
                    renderer.Dispose();
            }
            elementIdToRenderer.Clear();
        }
    }
}

View on GitHub (pinned to 96fad776d2)