glSnoop
Description:	Trace and profile OGLES2 and W3D Nova applications
Download:	glsnoop.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	198kb
Version:	1.1
Date:	04 Dec 2022
Author:	Juha Niemimäki
Submitter:	Juha Niemimäki
Homepage:	https://github.com/capehill/glsnoop
Requirements:	OpenGL ES 2.0, Warp3D Nova
Category:	development/utility
Replaces:	development/utility/glsnoop.lha
License:	Public domain
Distribute:	yes
Min OS Version:	4.1
FileID:	12332
Snapshots:   Videos:
Comments:	0
Snapshots:	1
Videos:	1
Downloads:	55  (Current version)
	262  (Accumulated)
Votes:	4 (0/0)  (30 days/7 days)

# glSnoop

An experimental graphics API tracing tool for AmigaOS 4

## Tracing support

glSnoop supports logging of:

- ogles2.library 3.3
- Warp3DNova.library 54.16

These are the current public and recommended library versions to use.

Pausing stops the serial logging of functions until resumed.

## Profiling

glSnoop records the call count and duration of known OpenGL ES 2.0
and Warp3D Nova functions. Profiling summaries are logged when
contexts are being destroyed, or when user finishes profiling manually
using the GUI. Re-starting profiling clears the current statistics.

Time spent inside OpenGL ES 2.0 functions includes also time spent
inside Warp3D Nova functions.

## Filtering

Filtering can be used to patch only a subset of OGLES2/NOVA
functions. This produces less logs and is faster. Filtering
impacts also profiling, because non-patched functions
cannot be profiled either.

## Command-line parameters

- OGLES2: enable ogles2.library tracing and profiling
- NOVA: enable Warp3DNova.library tracing and profiling
- GUI: launch the graphical user interface
- PROFILE: disable function tracing in serial logs but keep profiling stats
- FILTER filename: define a subset of patched functions
- STARTTIME time: set a time in seconds for profiler start
- DURATION time: set a profiling time in seconds

Example 1) glSnoop PROFILE STARTTIME 5 DURATION 10
- profile only
- initialize counters 5 seconds after context creation
- profile for 10 seconds

## Tips

glSnoop uses serial port for logging. To redirect logs
to a file (for speed), one may use the Sashimi tool:

Sashimi > RAM:MyLogFile.txt

Download Sashimi:
http://os4depot.net/index.php?function=showfile&file=development/debug/sashimi.l
ha

## License

PUBLIC DOMAIN

## Thanks

- kas1e for ideas, testing and AmigaGuide document
- Mason for icons
- samo79 for ideas
- Hans for ideas
- jabirulo for ideas
- Daniel for ideas