Package org.joml.sampling

Class BestCandidateSampling.Disk

  • Enclosing class:
    BestCandidateSampling

    public static class BestCandidateSampling.Disk
extends Object
    Generates Best Candidate samples on a unit disk.
    Author:
    Kai Burjack

    • Constructor Detail

      • Disk

        public Disk​()
        Create a new instance of BestCandidateSampling.Disk to configure and generate 'best candidate' sample positions on the unit disk.

    • Method Detail

      • seed

        public BestCandidateSampling.Disk seed​(long seed)
        Set the seed to initialize the pseudo-random number generator with.
        Parameters:
        seed - the seed value
        Returns:
        this

      • numSamples

        public BestCandidateSampling.Disk numSamples​(int numSamples)
        Set the number of samples to generate.
        Parameters:
        numSamples - the number of samples
        Returns:
        this

      • numCandidates

        public BestCandidateSampling.Disk numCandidates​(int numCandidates)
        Set the number of candidates to try for each generated sample.
        Parameters:
        numCandidates - the number of candidates to try
        Returns:
        this

      • generate

        public BestCandidateSampling.Disk generate​(float[] xys)
        Generate 'best candidate' sample positions and store the coordinates of all generated samples into the given xys float array.

        This method performs heap allocations, so should be used sparingly.

        Parameters:
        xys - will hold the x and y coordinates of all samples in the order XYXYXY.... This array must have a length of at least numSamples
        Returns:
        this

      • generate

        public BestCandidateSampling.Disk generate​(Callback2d callback)
        Generate 'best candidate' sample positions and call the given callback for each generated sample.

        This method performs heap allocations, so should be used sparingly.

        Parameters:
        callback - will be called with the coordinates of each generated sample position
        Returns:
        this