Skip to content

Small-Fish-Dev/ShrimpleProfiler

Repository files navigation

ShrimpleProfiler

A screenshot of ShrimpleProfiler in action

What is this?

ShrimpleProfiler is a tool that allows s&box gamemode developers to measure the time it takes some piece of code to execute. This is crucial when you're trying to improve the performance!

Features

  • Multiple measurements at the same time
  • No external dependencies

Usage

Getting Started

  1. Include fish.shrimpleprofiler in your s&box project's settings -> Packages -> Package References
  2. Add an instance of panel <ShrimpleProfiler.UI.ProfilerPanel></ShrimpleProfiler.UI.ProfilerPanel> to your UI (see Known Issues №1)
  3. Add the following piece of code to your project:
using (new ShrimpleProfiler.Measure(resolution: 10, interval: 0.016))
{
	// your code goes here...
}

API

ShrimpleProfiler.Measure.ctr

public Measure([CallerMemberName] string caller = "Unknown method", int resolution = 5, double interval = 0.05, bool showBars = true)

Measure the time it takes to execute the code.

Arguments:

  • string caller - name of the measurement. Automatically filled with the method's name if not provided.
  • int resolution - amount of bars in the chart
  • double interval - how often should we sample the performance
  • bool showBars - show or hide the histogram

Known Issues

  1. We have tried to make use of the RootPanel to shrimplify the usage even further and get rid of the second step in Getting Started, but it didn't work. We are still not sure if the issue is in our code or in the s&box itself
  2. The measurements might be imprecise. Contributions are welcome.

License

MIT. See LICENSE.md for more info.

About

A shrimple library made for profiling your code

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •