Package net.openosrs.api.input.motion

Class ProfileScorer

java.lang.Object

net.openosrs.api.input.motion.ProfileScorer

@Singleton
public class ProfileScorer
extends java.lang.Object

Measures recorded and generated cursor movements, scores how natural they look, keeps per-category statistics and fits Fitts's law parameters.

Profiles store summary statistics and a coarse 2D density grid instead of raw coordinates, which keeps each profile under about 25 KB on disk.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ProfileScorer.CategoryStats
static class	ProfileScorer.Context
static class	ProfileScorer.ProfileSummary	Compact serializable summary representation (< 25 KB).
static class	ProfileScorer.TrajectoryMetrics	Represents an analyzed trajectory segment.

Field Summary

Fields

Modifier and Type	Field	Description
static int	HEATMAP_COLS
static int	HEATMAP_ROWS

Constructor Summary

Constructors

Constructor	Description
ProfileScorer()

Method Summary

Modifier and Type	Method	Description
void	adaptProfile(MouseProfile profile)	Perform linear regression on observed (Index of Difficulty, Movement Time) samples to update the Fitts coefficients of the given MouseProfile.
ProfileScorer.TrajectoryMetrics	analyzeTrajectory(java.util.List<net.runelite.api.Point> points, java.util.List<java.lang.Long> timestamps, int clickHoldMs, java.awt.Rectangle targetBounds)	Compute trajectory metrics and a naturalness score.
java.lang.String	exportSummaryJson(java.lang.String profileName)
java.util.Map<ProfileScorer.Context,ProfileScorer.CategoryStats>	getAllCategoryMetrics()
ProfileScorer.CategoryStats	getCategoryStats(ProfileScorer.Context ctx)
double	getOverallNaturalness()
java.util.List<java.lang.Double>	getRecentVelocities()
int[][]	getSpatialHeatmap()
long	getTotalTrajectoriesScored()
ProfileScorer.TrajectoryMetrics	recordTrajectory(java.util.List<net.runelite.api.Point> points, java.util.List<java.lang.Long> timestamps, ProfileScorer.Context context, int clickHoldMs, java.awt.Rectangle targetBounds)	Score and record a completed movement trajectory.
void	saveProfileData(java.nio.file.Path dir, java.lang.String profileName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

HEATMAP_COLS

public static final int HEATMAP_COLS

See Also:

Constant Field Values

HEATMAP_ROWS

public static final int HEATMAP_ROWS

See Also:

Constant Field Values

Constructor Detail

ProfileScorer

public ProfileScorer()

Method Detail

recordTrajectory

public ProfileScorer.TrajectoryMetrics recordTrajectory(java.util.List<net.runelite.api.Point> points,
                                                        java.util.List<java.lang.Long> timestamps,
                                                        ProfileScorer.Context context,
                                                        int clickHoldMs,
                                                        java.awt.Rectangle targetBounds)

Score and record a completed movement trajectory.

analyzeTrajectory

public ProfileScorer.TrajectoryMetrics analyzeTrajectory(java.util.List<net.runelite.api.Point> points,
                                                         java.util.List<java.lang.Long> timestamps,
                                                         int clickHoldMs,
                                                         java.awt.Rectangle targetBounds)

Compute trajectory metrics and a naturalness score.

adaptProfile

public void adaptProfile(MouseProfile profile)

Perform linear regression on observed (Index of Difficulty, Movement Time) samples to update the Fitts coefficients of the given MouseProfile.

getOverallNaturalness

public double getOverallNaturalness()

getTotalTrajectoriesScored

public long getTotalTrajectoriesScored()

getCategoryStats

public ProfileScorer.CategoryStats getCategoryStats(ProfileScorer.Context ctx)

getAllCategoryMetrics

public java.util.Map<ProfileScorer.Context,ProfileScorer.CategoryStats> getAllCategoryMetrics()

getSpatialHeatmap

public int[][] getSpatialHeatmap()

getRecentVelocities

public java.util.List<java.lang.Double> getRecentVelocities()

exportSummaryJson

public java.lang.String exportSummaryJson(java.lang.String profileName)

saveProfileData

public void saveProfileData(java.nio.file.Path dir,
                            java.lang.String profileName)
                     throws java.io.IOException

Throws:

java.io.IOException