timeinstk
Prev | Orchestra Opcodes and Operators | Next

## timeinstk

timeinstk — Read absolute time in k-rate cycles.

## Description

Read absolute time, in k-rate cycles, since the start of an instance of an instrument. Called at both i-time as well as k-time. NB: the returned value at k-time starts at 1

## Syntax

    kres timeinstk

## Performance

timeinstk is for time in k-rate cycles. So with:

      sr    = 44100
      kr    = 6300
      ksmps = 7

then after half a second, the timeinstk opcode would report 3150. It will always report an integer.

timeinstk produces a k-rate variable for output. There are no input parameters.

timeinstk is similar to timek except it returns the time since the start of this instance of the instrument.

## Examples

Here is an example of the timeinstk opcode. It uses the file timeinstk.csd.

Example 1059. Example of the timeinstk opcode.

See the sections Real-time Audio and Command Line Flags for more information on using command line flags.

    <CsoundSynthesizer>
    <CsOptions>
    ; Select audio/midi flags here according to platform
    ; Audio out   Audio in
    -odac           -iadc    ;;;RT audio I/O
    ; For Non-realtime ouput leave only the line below:
    ; -o timeinstk.wav -W ;;; for file output any platform
    </CsOptions>
    <CsInstruments>

    ; Initialize the global variables.
    sr = 44100
    kr = 4410
    ksmps = 10
    nchnls = 1

    ; Instrument #1.
    instr 1
      ; Print out the value from timeinstk every half-second.
      k1 timeinstk
      printks "k1 = %f samples\\n", 0.5, k1
    endin

    </CsInstruments>
    <CsScore>

    ; Play Instrument #1 for two seconds.
    i 1 0 2
    e

    </CsScore>
    </CsoundSynthesizer>

Its output should include lines like this:

    k1 = 1.000000 samples
    k1 = 2205.000000 samples
    k1 = 4410.000000 samples
    k1 = 6615.000000 samples
    k1 = 8820.000000 samples

## See Also

timeinsts, timek, times, lastcycle

## Credits

Author: Robin Whittle
Australia
May 1997

Example written by Kevin Conder.

Prev | Up | Next
timedseq | Home | timeinsts