Skip to Content
defold-typescript libraries
glorius-silver

glorius-silver/defold-xoshiro256/xoshiro256

Functions for interacting with the Xoshiro256 native extension

  • GitHub: glorius-silver/defold-xoshiro256 — pinned to 4116a0d
    1. This repo publishes no releases or tags. Add a commit archive URL — for the pinned commit, https://github.com/glorius-silver/defold-xoshiro256/archive/4116a0d88e3c63e3cd639a8ece2578b319ca0a96.zip — to game.project under [project] dependencies, then Fetch Libraries in the Defold editor.
    2. Run bunx @defold-typescript/cli resolve to materialize its types.
    3. Import it under a namespace alias of your choice:
      import * as xoshiro256 from "xoshiro256"
  • Asset Portal: defold-xoshiro256

Functions

xoshiro256.seed(seed: number | string): userdata

Create state for the pseudo-random generator: equal seeds produce equal sequences of numbers. Accepts a number or a string (decimal representation of uint64, max 20 digits in the string) if full 64-bit precision required. State is seeded using splitmix64 algorithm.

Parameters

  • seed: number | string

Returns

  • state: userdata

xoshiro256.random(state: userdata, m?: number, n?: number): number

When called without arguments, returns a uniform pseudo-random real number in the range [0,1). When called with an integer number m, returns a uniform pseudo-random integer in the range [1, m]. When called with two integer numbers m and n, returns a uniform pseudo-random integer in the range [m, n].

Parameters

  • state: userdata
  • m?: number
  • n?: number

Returns

  • value: number

xoshiro256.float_range(state: userdata, m: number, n: number): number

Generates a random number in floating range [m, n)

Parameters

  • state: userdata
  • m: number
  • n: number

Returns

  • value: number

xoshiro256.clone(state: userdata, out?: userdata): userdata

Creates and returns an independent copy of the state

Parameters

  • state: userdata
  • out?: userdata

Returns

  • cloned_state: userdata

xoshiro256.to_string(state: userdata): string

Convert state to string. Used for saving the state. String is formed as 4 uint64 values separated by ':', e.g. "s0:s1:s2:s3".

Parameters

  • state: userdata

Returns

  • serialized_state: string

xoshiro256.from_string(serialized_state: string): userdata

Convert previously saved string back to state.

Parameters

  • serialized_state: string

Returns

  • state: userdata

On this page