feat(lib): add sample_objects option to TriangleMesh.sample

[jeertmans]

And renamed TriangleMesh.num_objects to TriangleMesh.num_primitives

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.37%. Comparing base (65b1d1a) to head (490b997).
⚠️ Report is 41 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #297      +/-   ##
==========================================
+ Coverage   83.16%   83.37%   +0.20%     
==========================================
  Files          32       32              
  Lines        3018     3032      +14     
==========================================
+ Hits         2510     2528      +18     
+ Misses        508      504       -4     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[codspeed-hq]

CodSpeed Performance Report

Merging #297 will degrade performances by 16.92%

_{Comparing sample-objects (490b997) with main (65b1d1a)}

Summary

⚡ 1 improvements
❌ 1 regressions
✅ 29 untouched benchmarks

⚠️ Please fix the performance issues or acknowledge them on CodSpeed.

Benchmarks breakdown

	Benchmark	BASE	HEAD	Change
❌	test_compute_paths_in_simple_street_canyon_scene[hybrid-False-20000-0]	6.7 s	8.1 s	-16.92%
⚡	test_compute_paths_in_simple_street_canyon_scene[hybrid-False-20000-1]	9.9 s	6.2 s	+58.87%