class csoundengine.renderjob.RenderJob(outfile, samplerate, encoding='', starttime=0.0, endtime=0.0, process=None)[source]#

Represent an offline render process

A RenderJob is generated each time Renderer.render() is called. Each new process is appended to Renderer.renderedJobs. The last render job can be accesses via Renderer.lastRenderJob()

Attributes:

outfile

The soundfile rendered / being rendererd

samplerate

Samplerate of the rendered soundfile

encoding

Encoding of the rendered soundfile

starttime

Start time of the rendered timeline

endtime

Endtime of the rendered timeline

process

The csound subprocess used to render the soundfile

args

The args used to render this job, if a process was used

Methods:

openOutfile([timeout, appwait, app])

Open outfile in external app

wait([timeout])

Wait for the render process to finish

outfile: str#

The soundfile rendered / being rendererd

samplerate: int#

Samplerate of the rendered soundfile

encoding: str = ''#

Encoding of the rendered soundfile

starttime: float = 0.0#

Start time of the rendered timeline

endtime: float = 0.0#

Endtime of the rendered timeline

process: Popen | None = None#

The csound subprocess used to render the soundfile

property args: list[str]#

The args used to render this job, if a process was used

openOutfile(timeout=None, appwait=True, app='')[source]#

Open outfile in external app

Parameters:
  • timeout – if still rendering, timeout after this number of seconds. None means to wait until rendering is finished

  • app – if given, use the given application. Otherwise the default application

  • appwait – if True, wait until the external app exits before returning from this method

wait(timeout=None)[source]#

Wait for the render process to finish