2023 April Release 1

This is a minor update that updates FPSci to build using Visual Studio 2022 as expected by recent revisions of G3D.

The binary distribution uses G3D revisions r7220.

What's Changed

• Updates for VS 2022 by @bboudaoud-nv in #422
• Aim assist by @bboudaoud-nv in #405

Full Changelog: v23.01.03...v23.04.01

2023 January Release 3

This is a major release, and may have some bugs, particularly related to the new features. The big new feature is the task-flow method for specifying experiments, that allows for grouping trial types into a task along with a related question (#396). This is useful in-particular for specifying two interval forced-choice types of experiments, and a sample is provided to show how this might be done.

If you don't need the task-flow specification, you may want to use v23.01.02 just in case there are bugs in this version.

The build uses G3D version r7206

What's Changed

• Task flow integration by @bboudaoud-nv in #396
• Don't modify widget manager prior to reinit by @bboudaoud-nv in #411
• Don't load weapon sounds if audio disabled by @bboudaoud-nv in #414

Full Changelog: v23.01.02...v23.01.03

2023 January Release 2

This is primarily a bug fix release, fixing the issue with lack of experiment progress from the earlier January release.

It also adds a two interval forced choice sample experiment.

The build uses G3D version r7206

What's Changed

• Update packager FMOD dll (G3D r7202) by @jspjutNV in #409
• Add a two interval forced choice sample by @jspjutNV in #401
• Session progress fix by @bboudaoud-nv in #410

Full Changelog: v23.01.01...v23.01.02

2023 January Release 1

This release has some experiment-flow related issues See #410 for details. We recommend not using this release for anything important.

This release is mostly a minor update, but has a significant change from #406 which increases the in-game field of view by roughly 5% compared to before. It's a bug fix, meaning that previous versions displayed only ~95% of the specified field of view.

The build uses G3D version r7206

What's Changed

• Packager script ordering by @jspjutNV in #403
• Set guard band to 0 by @jspjutNV in #406
• Fix for crash on load w/ experiment complete by @bboudaoud-nv in #408
• Fixes for reticle preview and allowReticleChange by @bboudaoud-nv in #404

Full Changelog: v22.12.01...v23.01.01

2022 December Release 1

Binary built with G3D revision r7188.

This release includes the minor fixes from the November pre-release, and the major new features is the trial-level configuration, which allows most parameters to be set per trial now in addition to being settable at the experiment and session levels.

The trial field ids is now deprecated and targetIds should be used instead. ids will continue to work to avoid breaking past experiments, but may stop working in a future version of FPSci. The name was confusing now that trials can have their own id.

What's Changed

• Trial-level configuration by @bboudaoud-nv in #392
• Reset weapon cooldowns at the start of kill tests by @bboudaoud-nv in #402

Full Changelog: v22.11.01...v22.12.01

2022 November Pre-release 1

This release is a pre-release version intended primarily for testing new features and reporting potential bugs. We recommend using a regular release (such as the August one) for running experiments.

What's Changed

• Getenv null check by @bboudaoud-nv in #399
• Add cylinder to targetmodels renamed sample by @jspjutNV in #400
• The in-progress trial level config by @bboudaoud-nv in #392

Full Changelog: v22.08.01...v22.11.01

2022 August Release 1

This release includes a few minor bug fixes and enhancements.

The main feature additions are the following:

• Various scoring models are now available to use instead of just time remaining per trial.
• The requireUserAdd parameter forces a new user to be created on startup if enabled.

What's Changed

• Add target models to the packager by @jspjutNV in #377
• Use allSessionsCompleteFeedback at startup by @bboudaoud-nv in #380
• Add logSessionDropDownUpdate parameter by @bboudaoud-nv in #382
• Close on complete fix by @bboudaoud-nv in #388
• Add requireUserAdd parameter by @bboudaoud-nv in #379
• Add alternate scoring models by @bboudaoud-nv in #381
• Pre-play audio on first load by @jspjutNV in #376

Full Changelog: v22.05.01...v22.08.01

2022 May Release 1

Binary built with G3D revision r7188.

This release makes some major changes that may break compatibility with work in progress.

1. In particular, #260 changes a bunch of database column names and improves consistency. Analysis scripts written for FPSci results from earlier versions will need to be updated to account for these changes. See the pull request for details of the change.
2. #365 splits user session completion out from the user status file into a related .csv. This .csv file is what needs to be changed to reset progress for individual users, or it can be deleted or renamed to reset the entire experiment.
3. Questions are now used for the hash, so results file names may have a new hash #367

Additionally there are a couple of added features:

1. #368 added target models without black outlines
2. #366 makes sure the results filename will be legal, even when using otherwise illegal names in the experiment description
3. #369 allows control of target's "emissive" material parameter

What's Changed

• Add no outline models by @bboudaoud-nv in #368
• Check for legal results filename by @bboudaoud-nv in #366
• Remove duplicate save of user status by @bboudaoud-nv in #364
• Target emissive control by @bboudaoud-nv in #369
• Reorganization of SQL and Database by @jspjutNV in #260
• Questions to Any by @bboudaoud-nv in #367
• User session status split by @bboudaoud-nv in #365

Full Changelog: v22.04.01...v22.05.01

2022 April Release 1

This release has a few changes that will change the behavior of experiments designed for older versions of FPSci.

Binary built with G3D revision r7188.

To retain the old behavior on glossiness of targets, you can put the following line in your experiment config:

targetGloss = Color4(0.4f, 0.2f, 0.1f, 0.8f);

To retain the old target model, you should do the following at the experiment config level:

        referenceTargetModelSpec = ArticulatedModel::Specification{
            filename = "model/target/target.obj";
            cleanGeometrySettings = ArticulatedModel::CleanGeometrySettings{
			            allowVertexMerging = true;
			            forceComputeNormals = false;
			            forceComputeTangents = false;
			            forceVertexMerging = true;
			            maxEdgeLength = inf;
			            maxNormalWeldAngleDegrees = 0;
			            maxSmoothAngleDegrees = 0;
            };
        };

And you need to add the following to each target config:

        modelSpec = ArticulatedModel::Specification{
            filename = "model/target/target.obj";
            cleanGeometrySettings = ArticulatedModel::CleanGeometrySettings{
			            allowVertexMerging = true;
			            forceComputeNormals = false;
			            forceComputeTangents = false;
			            forceVertexMerging = true;
			            maxEdgeLength = inf;
			            maxNormalWeldAngleDegrees = 0;
			            maxSmoothAngleDegrees = 0;
            };
        };

What's Changed

• Add reference target model config by @bboudaoud-nv in #354
• Random order question key bind fix by @bboudaoud-nv in #357
• Random order keypress fix by @bboudaoud-nv in #360
• Add specification of target glossiness to configuration by @bboudaoud-nv in #359
• Log time, options and keys for questions by @jspjutNV in #358
• Destination target offset fix by @bboudaoud-nv in #353
• Experiment Configured Reticle by @bboudaoud-nv in #350
• Documentation Updates by @bboudaoud-nv in #343
• Add Sphere models by @jspjutNV in #362

Full Changelog: v22.02.01...v22.04.01

2022 February Release 1

This is a minor change adding some samples and question font sizing.

Binary built with G3D revision r7167.

What's Changed

• Improve Question Specification by @bboudaoud-nv in #346
• SIGGRAPH Asia 2019 Sample Experiments by @jspjutNV in #347

Full Changelog: v21.11.02...v22.02.01