The sc-extensions Reference Manual

Table of Contents

The sc-extensions Reference Manual

This is the sc-extensions Reference Manual, generated automatically by Declt version 3.0 "Montgomery Scott" on Mon Apr 19 17:42:37 2021 GMT+0.

1 Introduction

sc-extensions

Additional library collection for cl-collider .
this include server-side-sequencing tool / alias ugens and it implements pc library from Andrew Sorensen's Extempore

Usage:

;;; load on cl-collider and sc-extensions
(ql:quickload '(:sc :sc-extensions))

(in-package :sc-user)
(use-package :sc-extensions)
(named-readtables:in-readtable :sc)

;;; bootup server
(setf *s* (make-external-server "Lisp-collider" :port 57880))
(server-boot *s*)


;;; set bpm and run `tempo` synth
(tempo 60.0)
(server-query-all-nodes) ;; You can look nodes state on scsynth server

;; run synth
(proxy :foo
  (pan2.ar (sin-osc.ar 440 0 (env-gen.kr (perc .0 .4 .2) :gate (tr 4)))))  ;; trigger on every 1/16 beat


;;; change note and beat
(proxy :foo
  (pan2.ar (sin-osc.ar (midicps (t-choose.kr (tr 4) [60 67 71 72])) 0
                       (env-gen.kr (perc .0 .4 .2) :gate (tr 8)))))


;;; chord progression every 8 beat 
(proxy :foo
  (pan2.ar (mix (sin-osc.ar (midicps (sel-pos.kr 1 8 [(pc:make-chord 40 80 4 (pc:diatonic 0 :^ :i7))
						                              (pc:make-chord 40 80 4 (pc:diatonic 0 :^ :vi7))]))
			    0 (env-gen.kr (perc .0 .4 .2) :gate (tr 8))))))

;;; modified to gate
(proxy :foo
  (let* ((gate (g+ 4 8 [0 3 6])))
    (pan2.ar (mix (sin-osc.ar (midicps (sel-pos.kr 1 8 [(pc:make-chord 40 80 4 (pc:diatonic 0 :^ :i7))
						                            	(pc:make-chord 40 80 4 (pc:diatonic 0 :^ :vi7))]))
			      0 (env-gen.kr (perc .0 .4 .2) :gate gate))))))

;;; change tempo
(tempo 72.0)

;;; change tempo with lag time
(tempo 88.0 :lag 8.0)

;;; grid base sequencing
(proxy :foo
  (with-grid (4 8)
      ((gt [0 3 6])
       (note [60 67 71])
       (decay [.4 1.0 .2]))
    (pan2.ar (sin-osc.ar (midicps note) 0
			             (env-gen.kr (perc .0 decay .2) :gate gt)))))

;;; polyphonic grid
(proxy :foo
  (with-grid-poly (4 8)
      ((gt [0 3 6])
       (note [60 67 71]))
    (pan2.ar (mix (sin-osc.ar (midicps note) 0
			                  (env-gen.kr (perc .0 2.0 .2) :gate gt))))))

2 Systems

The main system appears first, followed by any subsystem dependency.

2.1 sc-extensions

Author

<Park Sungmin. byulparan@gmail.com>

License

Public Domain / 0-clause MIT

Description

additional library collection for cl-collider

Dependencies

• cl-collider
• alexandria
• named-readtables

Source

sc-extensions.asd (file)

Components

• package.lisp (file)
• util.lisp (file)
• ugens.lisp (file)
• server-side.lisp (file)
• client-side.lisp (file)
• pc.lisp (file)

3 Files

Files are sorted by type and then listed depth-first from the systems components trees.

3.1 Lisp

3.1.1 sc-extensions.asd

Location

sc-extensions.asd

Systems

sc-extensions (system)

3.1.2 sc-extensions/package.lisp

Parent

sc-extensions (system)

Location

package.lisp

Packages

• pc
• sc-extensions

3.1.3 sc-extensions/util.lisp

Dependency

package.lisp (file)

Parent

sc-extensions (system)

Location

util.lisp

Exported Definitions

define-code (macro)

3.1.4 sc-extensions/ugens.lisp

Dependency

util.lisp (file)

Parent

sc-extensions (system)

Location

ugens.lisp

Exported Definitions

• asr.kr (function)
• del.kr (function)
• env.kr (function)
• g+ (function)
• perc.kr (function)
• poly (function)
• proxy-handle (macro)
• r+ (function)
• rand-tr (function)
• s+ (function)
• safe-tr (function)
• sel-pos.kr (function)
• t+ (function)
• t-line.ar (function)
• t-line.kr (function)

3.1.5 sc-extensions/server-side.lisp

Dependency

ugens.lisp (file)

Parent

sc-extensions (system)

Location

server-side.lisp

Exported Definitions

• beat (function)
• cnt (function)
• div (function)
• gate-lane (function)
• metro (function)
• on-trigger (macro)
• pattern (function)
• pattern-at (macro)
• tr (function)
• wait-when (function)
• with-grid (macro)
• with-grid-poly (macro)

Internal Definitions

• *cnt-function* (special variable)
• *gate-lane-function* (special variable)
• *max-beat* (special variable)
• *tr-function* (special variable)
• metro-cnt (function)
• metro-gate-lane (function)
• metro-tr (function)

3.1.6 sc-extensions/client-side.lisp

Dependency

server-side.lisp (file)

Parent

sc-extensions (system)

Location

client-side.lisp

Exported Definitions

• bpm (function)
• cosr (macro)
• do-dolist (macro)
• next-dur (macro)
• once (macro)
• pp (macro)
• rrand (function)
• sinr (macro)

Internal Definitions

*bpm-functions* (special variable)

3.1.7 sc-extensions/pc.lisp

Dependency

client-side.lisp (file)

Parent

sc-extensions (system)

Location

pc.lisp

Exported Definitions

• chord (function)
• chord-to-scale (function)
• degree (function)
• diatonic (function)
• make-chord (function)
• pc-random (function)
• quantize (function)
• quantize-list (function)
• relative (function)
• scale (function)
• transpose (function)

Internal Definitions

• *chord->scale* (special variable)
• *chord-syms* (special variable)
• *chord-syms-scales* (special variable)
• *diatonic-major* (special variable)
• *diatonic-minor* (special variable)
• *scales* (special variable)
• invert (function)
• ivl-invert (function)
• ivl-transpose (function)
• pc (function)
• pc? (function)

4 Packages

Packages are listed by definition order.

4.1 pc

Source

package.lisp (file)

Use List

common-lisp

Exported Definitions

• chord (function)
• chord-to-scale (function)
• degree (function)
• diatonic (function)
• make-chord (function)
• pc-random (function)
• quantize (function)
• quantize-list (function)
• relative (function)
• scale (function)
• transpose (function)

Internal Definitions

• *chord->scale* (special variable)
• *chord-syms* (special variable)
• *chord-syms-scales* (special variable)
• *diatonic-major* (special variable)
• *diatonic-minor* (special variable)
• *scales* (special variable)
• invert (function)
• ivl-invert (function)
• ivl-transpose (function)
• pc (function)
• pc? (function)

4.2 sc-extensions

Source

package.lisp (file)

Use List

• cl-collider
• common-lisp

Exported Definitions

• asr.kr (function)
• beat (function)
• bpm (function)
• cnt (function)
• cosr (macro)
• define-code (macro)
• del.kr (function)
• div (function)
• do-dolist (macro)
• env.kr (function)
• g+ (function)
• gate-lane (function)
• metro (function)
• next-dur (macro)
• on-trigger (macro)
• once (macro)
• pattern (function)
• pattern-at (macro)
• perc.kr (function)
• poly (function)
• pp (macro)
• proxy-handle (macro)
• r+ (function)
• rand-tr (function)
• rrand (function)
• s+ (function)
• safe-tr (function)
• sel-pos.kr (function)
• sinr (macro)
• t+ (function)
• t-line.ar (function)
• t-line.kr (function)
• tr (function)
• wait-when (function)
• with-grid (macro)
• with-grid-poly (macro)

Internal Definitions

• *bpm-functions* (special variable)
• *cnt-function* (special variable)
• *gate-lane-function* (special variable)
• *max-beat* (special variable)
• *tr-function* (special variable)
• metro-cnt (function)
• metro-gate-lane (function)
• metro-tr (function)

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.

5.1 Exported definitions

5.1.1 Macros

Macro: cosr OFFSET GAIN RATIO

Package

sc-extensions

Source

client-side.lisp (file)

Macro: define-code NAME ARGS &body BODY

Package

sc-extensions

Source

util.lisp (file)

Macro: do-dolist BINDING &body BODY

Package

sc-extensions

Source

client-side.lisp (file)

Macro: next-dur BEAT NEW-VALUE

Package

sc-extensions

Source

client-side.lisp (file)

Macro: on-trigger (CNT DIV &optional REM) &body BODY

Package

sc-extensions

Source

server-side.lisp (file)

Macro: once FORM

Package

sc-extensions

Source

client-side.lisp (file)

Macro: pattern-at BUFFER (CNT DIV &optional REM) LIST &rest LISTS

Package

sc-extensions

Source

server-side.lisp (file)

Macro: pp &body BODY

Package

sc-extensions

Source

client-side.lisp (file)

Macro: proxy-handle KEY &optional ACTION HANDLE &key TO POS

Package

sc-extensions

Source

ugens.lisp (file)

Macro: sinr OFFSET GAIN RATIO

Package

sc-extensions

Source

client-side.lisp (file)

Macro: with-grid (DIV N &key MODE) GRID &body BODY

Package

sc-extensions

Source

server-side.lisp (file)

Macro: with-grid-poly (DIV LEN &optional SELF) GRID &body BODY

Package

sc-extensions

Source

server-side.lisp (file)

5.1.2 Functions

Function: asr.kr ATTK LEVEL REL GATE &optional RESET &key ACT

Package

sc-extensions

Source

ugens.lisp (file)

Function: beat N

Package

sc-extensions

Source

server-side.lisp (file)

Function: bpm &optional BPM &key RELAUNCH LAG PRE-TICK

Package

sc-extensions

Source

client-side.lisp (file)

Function: chord ROOT TYPE

Package

pc

Source

pc.lisp (file)

Function: chord-to-scale ROOT TYPE

Package

pc

Source

pc.lisp (file)

Function: cnt DIV

Package

sc-extensions

Source

server-side.lisp (file)

Function: degree VALUE PC

Package

pc

Source

pc.lisp (file)

Function: del.kr IN DEL

Package

sc-extensions

Source

ugens.lisp (file)

Function: diatonic ROOT MAJ-MIN DEGREE

Package

pc

Source

pc.lisp (file)

Function: div N

Package

sc-extensions

Source

server-side.lisp (file)

Function: env.kr ATTK DUR REL TRIG LEVEL &optional RESET &key ACT

Package

sc-extensions

Source

ugens.lisp (file)

Function: g+ DIV LEN CONTENTS

Package

sc-extensions

Source

ugens.lisp (file)

Function: gate-lane DIV N SEQS

Package

sc-extensions

Source

server-side.lisp (file)

Function: make-chord LOWER UPPER NUMBER PC

Package

pc

Source

pc.lisp (file)

Function: metro BPM &key RELAUNCH LAG PRE-TICK

Package

sc-extensions

Source

server-side.lisp (file)

Function: pattern BUFFER LIST &rest LISTS

Package

sc-extensions

Source

server-side.lisp (file)

Function: pc-random LOWER UPPER PC

Package

pc

Source

pc.lisp (file)

Function: perc.kr GATE &optional ATTACK RELEASE LEVEL CURVE

Package

sc-extensions

Source

ugens.lisp (file)

Function: poly N GATE

Package

sc-extensions

Source

ugens.lisp (file)

Function: quantize PITCH-IN PC

Package

pc

Source

pc.lisp (file)

Function: quantize-list LST PC

Package

pc

Source

pc.lisp (file)

Function: r+ SIG MIN MAX

Package

sc-extensions

Source

ugens.lisp (file)

Function: rand-tr TR ODDS

Package

sc-extensions

Source

ugens.lisp (file)

Function: relative PITCH I PC

Package

pc

Source

pc.lisp (file)

Function: rrand N &optional P

Package

sc-extensions

Source

client-side.lisp (file)

Function: s+ DIV CONTENTS

Package

sc-extensions

Source

ugens.lisp (file)

Function: safe-tr TR

Package

sc-extensions

Source

ugens.lisp (file)

Function: scale ROOT TYPE

Package

pc

Source

pc.lisp (file)

Function: sel-pos.kr DIV CONTENTS

Package

sc-extensions

Source

ugens.lisp (file)

Function: t+ TR CONTENTS

Package

sc-extensions

Source

ugens.lisp (file)

Function: t-line.ar START END DUR GATE

Package

sc-extensions

Source

ugens.lisp (file)

Function: t-line.kr START END DUR GATE

Package

sc-extensions

Source

ugens.lisp (file)

Function: tr DIV

Package

sc-extensions

Source

server-side.lisp (file)

Function: transpose VAL LST PC

Package

pc

Source

pc.lisp (file)

Function: wait-when DIV

Package

sc-extensions

Source

server-side.lisp (file)

5.2 Internal definitions

5.2.1 Special variables

Special Variable: *bpm-functions*

Package

sc-extensions

Source

client-side.lisp (file)

Special Variable: *chord->scale*

Package

pc

Source

pc.lisp (file)

Special Variable: *chord-syms*

Package

pc

Source

pc.lisp (file)

Special Variable: *chord-syms-scales*

Package

pc

Source

pc.lisp (file)

Special Variable: *cnt-function*

Package

sc-extensions

Source

server-side.lisp (file)

Special Variable: *diatonic-major*

Package

pc

Source

pc.lisp (file)

Special Variable: *diatonic-minor*

Package

pc

Source

pc.lisp (file)

Special Variable: *gate-lane-function*

Package

sc-extensions

Source

server-side.lisp (file)

Special Variable: *max-beat*

Package

sc-extensions

Source

server-side.lisp (file)

Special Variable: *scales*

Package

pc

Source

pc.lisp (file)

Special Variable: *tr-function*

Package

sc-extensions

Source

server-side.lisp (file)

5.2.2 Functions

Function: invert LST PC &rest ARGS

Package

pc

Source

pc.lisp (file)

Function: ivl-invert LST &rest ARGS

Package

pc

Source

pc.lisp (file)

Function: ivl-transpose VAL LST

Package

pc

Source

pc.lisp (file)

Function: metro-cnt DIV

Package

sc-extensions

Source

server-side.lisp (file)

Function: metro-gate-lane DIV N SEQS

Package

sc-extensions

Source

server-side.lisp (file)

Function: metro-tr DIV

Package

sc-extensions

Source

server-side.lisp (file)

Function: pc PITCH

Package

pc

Source

pc.lisp (file)

Function: pc? PITCH PC

Package

pc

Source

pc.lisp (file)

Appendix A Indexes

A.1 Concepts

A.2 Functions

A.3 Variables

A.4 Data types