Safe Haskell	Safe-Inferred

Synth.Sampler.Sample

Contents

util

Synopsis

type SamplePath = FilePath
data Note = Note {
- start :: !Frames
- duration :: !Frames
- effectControls :: Map Control.Control Signal.Signal
- sample :: Sample
- hash :: Note.Hash
}
end :: Note -> Frames
note :: Frames -> Frames -> Map Control.Control Signal.Signal -> Sample -> Note
makeHash :: Frames -> Frames -> Map Control.Control Signal.Signal -> Sample -> Note.Hash
data Sample = Sample {
- filename :: !SamplePath
- offset :: !Frames
- envelope :: !Signal.Signal
- pan :: !Signal.Signal
- ratios :: !Signal.Signal
- stretch :: !Stretch
}
data Stretch = Stretch {
- stretchMode :: !StretchMode
- timeRatio :: !Y
- pitchRatio :: !Y
}
data StretchMode
- = StretchDefault
- | StretchPercussive
make :: SamplePath -> Sample
modifyFilename :: (SamplePath -> SamplePath) -> Sample -> Sample
prettyNote :: Note -> Text
forever :: RealTime
pitchToRatio :: Pitch.NoteNumber -> Pitch.NoteNumber -> Y
pitchToRatioSignal :: Pitch.NoteNumber -> Note.Note -> Signal.Signal
relativePitchToRatio :: Pitch.NoteNumber -> Y
ratioToPitch :: Double -> Pitch.NoteNumber
srate :: RealTime
toThru :: FilePath -> Sample -> Thru.Play

Documentation

type SamplePath = FilePath Source #

Path to a sample, relative to the instrument db root.

data Note Source #

Low level representation of a note. This corresponds to a single sample played.

Constructors

Note

Fields

start :: !Frames
duration :: !Frames
This is the actual duration of the sample at the given ratios, not the requested Note.duration. TODO maybe move duration to Sample then.
effectControls :: Map Control.Control Signal.Signal
sample :: Sample
hash :: Note.Hash
Hash of (start, duration, effectControls, sample). Putting it here means I can memoize its creation but also that changing Note will make it out of sync.

Instances

Instances details

Show Note Source #
Instance details Defined in Synth.Sampler.Sample Methods showsPrec :: Int -> Note -> ShowS # show :: Note -> String # showList :: [Note] -> ShowS #
Pretty.Pretty Note Source #
Instance details Defined in Synth.Sampler.Sample Methods pretty :: Note -> Text Source # format :: Note -> Doc Source # formatList :: [Note] -> Doc Source #

end :: Note -> Frames Source #

note :: Frames -> Frames -> Map Control.Control Signal.Signal -> Sample -> Note Source #

makeHash :: Frames -> Frames -> Map Control.Control Signal.Signal -> Sample -> Note.Hash Source #

data Sample Source #

The actual sample played by a Note.

Constructors

Sample
Fields filename :: !SamplePath This is initially relative to `_rootDir`, and will have the root dir prepended before rendering. offset :: !Frames Sample start offset. envelope :: !Signal.Signal The sample ends when it runs out of samples, or when envelope ends on 0. pan :: !Signal.Signal ratios :: !Signal.Signal Sample rate conversion ratio. This controls the pitch. stretch :: !Stretch

Instances

Instances details

Show Sample Source #
Instance details Defined in Synth.Sampler.Sample Methods showsPrec :: Int -> Sample -> ShowS # show :: Sample -> String # showList :: [Sample] -> ShowS #
Pretty.Pretty Sample Source #
Instance details Defined in Synth.Sampler.Sample Methods pretty :: Sample -> Text Source # format :: Sample -> Doc Source # formatList :: [Sample] -> Doc Source #
Serialize.Serialize Sample Source #
Instance details Defined in Synth.Sampler.Sample Methods put :: Putter Sample Source # get :: Serialize.Get Sample Source #

data Stretch Source #

Constructors

Stretch
Fields stretchMode :: !StretchMode timeRatio :: !Y pitchRatio :: !Y

Instances

Instances details

Show Stretch Source #
Instance details Defined in Synth.Sampler.Sample Methods showsPrec :: Int -> Stretch -> ShowS # show :: Stretch -> String # showList :: [Stretch] -> ShowS #
Pretty.Pretty Stretch Source #
Instance details Defined in Synth.Sampler.Sample Methods pretty :: Stretch -> Text Source # format :: Stretch -> Doc Source # formatList :: [Stretch] -> Doc Source #
Serialize.Serialize Stretch Source #
Instance details Defined in Synth.Sampler.Sample Methods put :: Putter Stretch Source # get :: Serialize.Get Stretch Source #

data StretchMode Source #

This maps to [Rubberband.Option]. It's indirect to avoid a dependency on RubberbandC, and hence the C library.

Constructors

StretchDefault
StretchPercussive

Instances

Instances details

Bounded StretchMode Source #
Instance details Defined in Synth.Sampler.Sample Methods minBound :: StretchMode # maxBound :: StretchMode #
Enum StretchMode Source #
Instance details Defined in Synth.Sampler.Sample Methods succ :: StretchMode -> StretchMode # pred :: StretchMode -> StretchMode # toEnum :: Int -> StretchMode # fromEnum :: StretchMode -> Int # enumFrom :: StretchMode -> [StretchMode] # enumFromThen :: StretchMode -> StretchMode -> [StretchMode] # enumFromTo :: StretchMode -> StretchMode -> [StretchMode] # enumFromThenTo :: StretchMode -> StretchMode -> StretchMode -> [StretchMode] #
Show StretchMode Source #
Instance details Defined in Synth.Sampler.Sample Methods showsPrec :: Int -> StretchMode -> ShowS # show :: StretchMode -> String # showList :: [StretchMode] -> ShowS #
Serialize.Serialize StretchMode Source #
Instance details Defined in Synth.Sampler.Sample Methods put :: Putter StretchMode Source # get :: Serialize.Get StretchMode Source #

make :: SamplePath -> Sample Source #

modifyFilename :: (SamplePath -> SamplePath) -> Sample -> Sample Source #

prettyNote :: Note -> Text Source #

Like Pretty Note, but shorter.

forever :: RealTime Source #

The duration of a note which plays the entire sample. This should be longer than any sample, and will be clipped to sample duration.

util

pitchToRatio :: Pitch.NoteNumber -> Pitch.NoteNumber -> Y Source #

This is the resampling ratio, which is inverse to the pitch ratio, which is pretty confusing. E.g. When I go up *2, I should be skipping every other sample. So srate should be *2. Number of frames is /2. So the resampling ratio for +12nn is 1/2, while the pitch ratio is 2.

pitchToRatioSignal :: Pitch.NoteNumber -> Note.Note -> Signal.Signal Source #

relativePitchToRatio :: Pitch.NoteNumber -> Y Source #

ratioToPitch :: Double -> Pitch.NoteNumber Source #

This is pitch ratio, not resample ratio!

srate :: RealTime Source #

toThru :: FilePath -> Sample -> Thru.Play Source #