Softanza
DémarrerEnglish
Softanza
DémarrerEnglish
Référence · Entrées-sorties, formats, extensibilité, médias

Son

62 fonctions dans 24 classes, groupées par ce qu'elles font, chacune avec l'explication que la bibliothèque donne d'elle-même.

Le récit de ce domaine, pour un lecteur général : ce qu'un artisan en fait, un exemple exécuté et ses couloirs notés, est sur sa page de la Plateforme.

Les fonctions, par ce qu'elles font

Tester et vérifier

  • IsSilentValue Muted is the one value whose rendering is nothing. Asking is legitimate. dans stzEarcons
  • CanAcknowledgeWithin Rule 18 allows 100 ms. This answers whether a sound can be the acknowledgement, and on this pipeline the answer is no. dans stzEarcons
  • IsRunning what happened dans stzSoundLive
  • Check The movement rules this mode declares, held against a phrase: a list of what breaks them, each as text. An empty list is a phrase the declaration permits -- not a phrase a musician would call right. dans stzSoundUniverse
  • IsUsable can this machine speak at all? -------------------------------------- ASK THIS FIRST. A machine with no speech engine is a supported configuration, not a broken install, and every other path still works. dans stzVoice
  • IsStarted what it is doing dans stzVoicePool
  • IsAvailable readers ------------------------------------------------------------- Is there anything to record WITH? A machine with no input, or no device DLL at all, is a supported configuration -- CI is one. dans stzMicrophone
  • IsAllStrokes True when every word is a stroke: the pattern names its own drum. dans stzSoundPattern

Trouver

  • PositionInFrames Frames the DEVICE has consumed, not frames the graph has produced: the producer runs ahead by a ring's worth, so asking it would report a position up to a third of a second in the future. What the listener has heard is what the device has taken. dans stzSoundTransport

Remplacer et modifier

  • SetDuckDepth SS3: ducking -------------------------------------------------------- How deep, in dB. Declared, never inferred -- a caller who wants a different depth argues with a number. dans stzEarcons
  • SetAmbientFloor Colour's doctrine, transposed: a sound system that cannot fail an audibility check does not have one. The check is a MARGIN over the floor. dans stzEarcons
  • SetVoiceLanguage VC4: SAY -- the earcon, then the phrase that says WHICH ------------- Which language the phrase is spoken in. REFUSED rather than substituted if the machine has no voice for it -- speaking French to an operator who asked for English is worse than saying nothing. dans stzEarcons
  • SetTempo settings dans stzSoundLive
  • SetLength The length in beats, set outright -- a pattern's cycles end where they end, whatever their last note does. dans stzSoundScore
  • SetVelocity The velocity of notes ADDED FROM NOW ON, 0 < v <= 1. dans stzSoundScore
  • SetOutputTo output -------------------------------------------------------------- Which node the graph hands to the world. Defaults to the last thing added, which is right far more often than not. dans stzSoundGraph
  • SetRate SAPI takes rate -10..10 and volume 0..100 and IGNORES anything else. The engine clamps and reports, because a setting that silently does nothing is worse than one that is visibly limited. dans stzVoice
  • SetLookahead settings ------------------------------------------------------------ Frames of lookahead. Set it small only to PROVE the engine counts lateness -- the negative sibling in the guard does exactly that. dans stzSoundScheduler
  • SetVoiceGain The write is a single atomic store on a node the render already reads every block. Nothing is allocated, nothing is rebuilt, and the audio thread never learns that a duck happened. dans stzVoicePool
  • SetNote One line under the plot saying what the picture MEANS. A chart that needs a paragraph of explanation elsewhere is a chart that failed. dans stzSoundPlot

Ajouter

  • AddNotes Space-separated names, one beat each; the octave carries; ~ rests. dans stzSoundScore
  • AddMixOf mixing -------------------------------------------------------------- Mix several named nodes into one. The engine requires every input to EXIST before the mix does -- that is what makes a cycle impossible -- so this verb takes them all at once rather than letting you add to a mix later and discover the refusal. dans stzSoundGraph
  • AddSound Play an existing sound (a stzSound, or an engine buffer id) as a source. dans stzSoundGraph
  • AddEchoOn ECHO, not "reverb". SN4's challenge pass refused to call a delay a reverb: one repeat fading out is not a diffuse room, and a name that promises a hall and delivers a slapback survives into documentation. dans stzSoundGraph
  • AddGainOn the shapers: each takes WHAT it acts on, by name dans stzSoundGraph
  • AddTimeline MU2: a node whose output is the notes placed on it, each at the frame asked -- inside a block, not at its top. It has no input. Returns the node (1-based), which StzEngineSoundGraphTimelinePlace takes. dans stzSoundGraph
  • AddMasterGain This is what a transport fades on pause. It exists as a verb here rather than in the transport because only the graph knows what its output IS -- and putting one gain at the end means a pause is one click-free ramp instead of a walk over every voice, whatever the caller built upstream. dans stzSoundGraph
  • AddOscillator the sources --------------------------------------------------------- WAVEFORM BY NAME, not by number: :Sine :Triangle :Square :Saw. dans stzSoundGraph
  • AddEnvelopeOnAt The same envelope, starting nStart seconds in. THIS is what makes a score possible: a voice that knows WHEN it sounds is a note. dans stzSoundGraph
  • AddVoice building it --------------------------------------------------------- A voice made from an existing sound. pnSlots is how many of it may sound at the same time. dans stzVoicePool
  • AddToneVoice A voice made from an oscillator and an envelope -- a blip, a coin, a beep. pnSeconds is how long one shot lasts. dans stzVoicePool

Convertir

  • ToSoundOf what a meaning sounds like (no device needed) ----------------------- The motif as DATA. Works with no audio hardware, which is what lets a CI machine assert the vocabulary. dans stzEarcons
  • ToSoundOfSaying Needs no audio device, which is what lets a guard measure the composition on a machine that cannot play it. dans stzEarcons
  • ToList The samples of one channel, as a Haro list. DATA, so To... is right. Be aware this crosses the FFI once per sample -- fine for a look at a few thousand frames, wrong for a whole song. dans stzSound
  • ToOnsets Where notes START, in seconds -- a one-row grid of times. dans stzSound
  • ToSpectrum To...() because these RETURN things. A spectrum is a stzSoundGrid: rows by columns of numbers, with x_step and y_step saying what a row and a column MEAN. Drawing one is the graphics plane's job, and keeping that boundary is what makes the analysis assertable -- "the 1 kHz sine is in the 1 kHz bin" is a claim about numbers; "the picture looks right" is a claim about nothing. The magnitude spectrum of one window. Default 4096 points: about 12 Hz resolution at 48 kHz, which resolves musical pitch without smearing time. dans stzSound
  • ToWavBytes The symmetric half of loading from memory, and its absence was a real gap: a sound could be decoded FROM bytes but not encoded back TO them, so handing a buffer to another tier meant a temporary file. VC1 went to some trouble to keep a voice out of the filesystem; without this, VC3 would have put it straight back to feed a recogniser. dans stzSound
  • ToSpectrogram Frequency against time: one row per window. MULTICORE by default -- every row is an independent FFT over a different slice of the same immutable buffer, which is the one analysis here that parallelises without an argument. dans stzSound
  • ToSound performing it ------------------------------------------------------- The whole performance, rendered offline into one sound. Every note is the instrument's (MU1), placed at FrameOf() by mixInto. dans stzSoundScore
  • ToVoiceList The whole capability matrix for this direction: [ [name, tag], ... ] dans stzVoice
  • ToSoundOfSsml The same, with SSML prosody. The engine validates the markup, because the platform does not: handed an unclosed tag SAPI silently discards it and speaks the words, so a typo means the prosody never happens and nobody is told. dans stzVoice
  • ToTransportOf never left it: the phrase ended, the transport kept rendering silence, and IsPlaying stayed true forever. A spoken phrase has a KNOWN length, so the transport is given it. The trap was real enough to hang this face's own demo before it was found. dans stzVoice
  • ToPNG PNG goes through the GPU tier, so it needs a device. SVG does not. dans stzSoundGrid

et 13 autres dans la référence

Afficher, dessiner et mettre en forme

  • RenderThroughRing The SAME real-time path -- a producer thread rendering the graph into a ring, this thread posting notes ahead of it -- with this thread also draining the ring instead of a sound card. It runs as fast as the machine can, which is HARDER for the scheduler than a device: the producer is never waiting for the speaker. What comes out is returned as a sound, so a guard can hold it against the offline render sample for sample. dans stzSoundScheduler
  • DrawWave THE WAVEFORM dans stzSoundPlot
  • DrawSpectra THE SPECTRUM (one or more series) ----------------------------------- paSeries: [ [cLabel, oGrid], ... ] -- each a one-row spectrum grid. Log frequency across, decibels up. Several series is a CATEGORICAL job: fixed hue order, a legend always, and a direct label on each line. dans stzSoundPlot
  • DrawSpectrogram THE SPECTROGRAM ----------------------------------------------------- Time across, frequency up, magnitude as lightness. nMaxHz crops the top: nearly all musical energy lives low, and drawing to Nyquist spends most of the picture on silence. dans stzSoundPlot

Parcourir et appliquer

  • PerformQ performing a phrase --------------------------------------------------- The phrase, once per cycle for `pnCycles` cycles, in this mode, over this cycle, with its ornaments and accents, as a stzSoundScore. One phrase cycle fills one rhythmic cycle, however many beats that has. dans stzSoundUniverse
  • RunToEnd Tick until it stops, without a reactive loop. This DOES occupy the thread -- it is the honest version of PlayFor for a script that has nothing else to do, and it still reports the position while it runs. dans stzSoundTransport

Les explications sont celles que la bibliothèque donne d'elle-même, en anglais, lues dans ses commentaires de documentation le 2026-10-01 04:14, from the library at commit 0e72e2e2c, by the library's own stzSelfDoc over 635 class sources.

Les classes de ce domaine

Les narrations sur ce domaine

Aucune narration n'est encore rattachée à ce domaine.