Home

Welcome to the BlocBenchs wiki!

Install

1. Download Pharo 11, 12 or 13

2. Load the baseline with:

Metacello new
        baseline: 'BlocBenchs';
        repository: 'github://pharo-graphics/BlocBenchs:master/src';
        load

Lock dependencies

The following script may be convenient to prepare your image, before loading BlocBenchs, if you already have dependencies loaded with non-master branches.

#('Spec-Toplo' Toplo Album Bloc Alexandrie) do: [ :each |
	Metacello new
		baseline: each;
		lock ].

Build bash script

We have a build script that downloads Pharo and loads the project. It's prepared to work on MacOS, Linux and Windows (tested with the bash shell terminal that comes with git for Windows).

To use it:

1. Clone this repository (this will be the <repo_path>)
2. Create anywhere in your system a directory where the image will be build, and open a terminal there.
3. Execute <repo_path>/scripts/build.sh

Switch to dev branches

This script can save you time, to switch to dev branch (assuming there are no conflicts)

"Replace any matching repositories by shared clones"
{
	'alexandrie'.
	'bloc'.
	'album'.
	'toplo'.
	'spec-toplo'.
} do: [ :repoName |
	(IceRepository registry
		select: [ :each | each name asLowercase = repoName ])
		do:[ :each |
			(each branchNamed: 'dev') checkout.
			each fetch; pull ] ]
	displayingProgress: [ :each | each ]

How to use

You can find executable entry-points here:

• Run examples at class-side of PCBenchmarker
• Run examples at class-side of BlProfileRunner
• Run BlMouseMoveBenchmark class>>#exampleRun
• Run AeBenchFigureGridRunner in BlocBenchs-Alexandrie
• Build and run circle_bench.c to compare it with AeBenchAthensCircleGrid
• Evaluate BlbSpaceTallyPrinter runToStdout

Code snippets

The following snippet serves to benchmark FPS (frames per second) of Bloc's rounded rectangle geometry. You can easily create a new case (to replace PCRoundedRectanglesBenchCase). See FPS report in Transcript.

PCBenchmarkSuite new
   addCase: PCRoundedRectanglesBenchCase new;
   numberOfSeconds: 7;
   addAlexandrieBenchmarker;
   runInForkWithGUI

Variations of the following snippet serves to benchmark multiple performance aspects:

[ case := BlBoidsProfileCase new.
case duration: 7 seconds.
case hostClass: BlOSWindowSDL2Host.
(BlProfileRunner newForCase: case)
   enableFPS;
   run;
   openMeterReports ] fork

This will execute the Boids demo for 7 seconds. You can replace BlBoidsProfileCase by your own.

• Sending enableFPS makes you get a FPS report for each execution second.
• Replace enableFPS by enableFFICounter to get a ranking of FFI calls per frame sorted by frequency.
• Replace by enableASProfiler to get a profiler.