Struct rosu_pp::taiko::TaikoPerformance

pub struct TaikoPerformance<'map> { /* private fields */ }

Performance calculator on osu!taiko maps.

Implementations

impl<'map> TaikoPerformance<'map>

pub fn new(map_or_attrs: impl IntoModePerformance<'map, Taiko>) -> Self

Create a new performance calculator for osu!taiko maps.

The argument map_or_attrs must be either

• previously calculated attributes (TaikoDifficultyAttributes or TaikoPerformanceAttributes)
• a beatmap (TaikoBeatmap<'map>)

If a map is given, difficulty attributes will need to be calculated internally which is a costly operation. Hence, passing attributes should be prefered.

However, when passing previously calculated attributes, make sure they have been calculated for the same map and Difficulty settings. Otherwise, the final attributes will be incorrect.

pub fn try_new(map_or_attrs: impl IntoPerformance<'map>) -> Option<Self>

Try to create a new performance calculator for osu!taiko maps.

Returns None if map_or_attrs does not belong to osu!taiko e.g. a Converted, DifficultyAttributes, or PerformanceAttributes of a different mode.

See TaikoPerformance::new for more information.

pub const fn mods(self, mods: u32) -> Self

Specify mods through their bit values.

See https://github.com/ppy/osu-api/wiki#mods

pub const fn combo(self, combo: u32) -> Self

Specify the max combo of the play.

pub const fn hitresult_priority(self, priority: HitResultPriority) -> Self

Specify how hitresults should be generated.

Defauls to HitResultPriority::BestCase.

pub const fn n300(self, n300: u32) -> Self

Specify the amount of 300s of a play.

pub const fn n100(self, n100: u32) -> Self

Specify the amount of 100s of a play.

pub const fn misses(self, n_misses: u32) -> Self

Specify the amount of misses of the play.

pub fn accuracy(self, acc: f64) -> Self

Specify the accuracy of a play between 0.0 and 100.0. This will be used to generate matching hitresults.

pub const fn difficulty(self, difficulty: Difficulty) -> Self

Use the specified settings of the given Difficulty.

pub const fn passed_objects(self, passed_objects: u32) -> Self

Amount of passed objects for partial plays, e.g. a fail.

If you want to calculate the performance after every few objects, instead of using TaikoPerformance multiple times with different passed_objects, you should use TaikoGradualPerformance.

pub fn clock_rate(self, clock_rate: f64) -> Self

Adjust the clock rate used in the calculation.

If none is specified, it will take the clock rate based on the mods i.e. 1.5 for DT, 0.75 for HT and 1.0 otherwise.

Minimum	Maximum
0.01	100

pub fn hp(self, hp: f32, with_mods: bool) -> Self

Override a beatmap’s set HP.

with_mods determines if the given value should be used before or after accounting for mods, e.g. on true the value will be used as is and on false it will be modified based on the mods.

Minimum	Maximum
-20	20

pub fn od(self, od: f32, with_mods: bool) -> Self

Override a beatmap’s set OD.

with_mods determines if the given value should be used before or after accounting for mods, e.g. on true the value will be used as is and on false it will be modified based on the mods.

Minimum	Maximum
-20	20

pub const fn state(self, state: TaikoScoreState) -> Self

Provide parameters through a TaikoScoreState.

pub fn generate_state(&mut self) -> TaikoScoreState

Create the TaikoScoreState that will be used for performance calculation.

pub fn calculate(self) -> TaikoPerformanceAttributes

Calculate all performance related values, including pp and stars.

Trait Implementations

impl<'map> Clone for TaikoPerformance<'map>

fn clone(&self) -> TaikoPerformance<'map>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'map> Debug for TaikoPerformance<'map>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'map, T: IntoModePerformance<'map, Taiko>> From<T> for TaikoPerformance<'map>

fn from(into: T) -> Self

Converts to this type from the input type.

impl<'map> PartialEq for TaikoPerformance<'map>

fn eq(&self, other: &TaikoPerformance<'map>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'map> TryFrom<OsuPerformance<'map>> for TaikoPerformance<'map>

fn try_from(osu: OsuPerformance<'map>) -> Result<Self, Self::Error>

Try to create TaikoPerformance through OsuPerformance.

Returns None if OsuPerformance does not contain a beatmap, i.e. if it was constructed through attributes or OsuPerformance::generate_state was called.

type Error = OsuPerformance<'map>

The type returned in the event of a conversion error.

impl<'map> StructuralPartialEq for TaikoPerformance<'map>