annotate base/constructors.lisp @ 330:2fbff655ba47 tip

Removed cpitch-adj and cents SQL columns

(cl:in-package #:amuse)

;; Time classes

(defun make-standard-moment (time)
  "Returns a new standard-moment, taking a number as input for
the time point."
  (make-instance 'standard-moment :time time))

;; N.B. period should never be constructed directly - it's either
;; floating or anchored or some other subclass.

(defun make-standard-period (interval)
  "Returns a new (floating) period, taking a number for the
duration."
  (make-instance 'standard-period :interval interval))


;; Should this take a moment and/or a period too?
(defun make-standard-anchored-period (onset interval)
  "Returns a new floating-period, taking numbers for onset and
duration."
  (make-instance 'standard-anchored-period
		 :time onset
		 :interval interval))

;; Pitch classes (no, not that sort of pitch class)

(defun make-chromatic-pitch (pitch-number)
"Returns a new chromatic pitch, taking a number for the
pitch."
  (make-instance 'chromatic-pitch :number pitch-number))

(defun make-diatonic-pitch (name accidental octave)
  "Returns a new diatonic pitch, taking as input a character for the name,
a positive or negative number for the accidental (+ve for sharps,
-ve for flats) and another for octave. (Is this description right?)"
  (flet ((asa-string (name accidental octave)
           (with-output-to-string (s)
             (write-char name s)
             (if (zerop accidental)
                 (write-char #\n s)
                 (let ((achar (if (plusp accidental) #\s #\f)))
                   (dotimes (i (abs accidental))
                     (write-char achar s))))
             (write octave :stream s :base 10 :radix nil :pretty nil))))
    (let* ((name (if (numberp name) (elt "ABCDEFG" name) name))
           (asa-string (asa-string name accidental octave))
           (p (mips:pn-p asa-string)))
      (make-instance 'diatonic-pitch :cp (first p) :mp (second p)))))

(defun make-mips-pitch (cp mp)
  (make-instance 'diatonic-pitch :cp cp :mp mp))

(defun make-chromatic-pitch-interval (span)
  (make-instance 'chromatic-pitch-interval :span span))

(defun make-mips-pitch-interval (cspan mspan)
  (make-instance 'diatonic-pitch-interval :span (list cspan mspan)))

(defun make-diatonic-pitch-interval (interval accidentals)
  "Returns a diatonic pitch interval given a number for the interval which corresponds to a major/perfect diatonic interval (unison=1,second=2,third=3, ...), if accidentals=0. If accidental>0 (<0), the interval is modified by |accidentals| sharps (flats). The sign of the given interval number determines whether the interval is raising or falling"
(let*
    ((direction (signum interval))                         ; -1:falling interval, +1:raising interval , 0: undefined interval
     (octave (floor (/ (abs interval) 8)))                 ; determines the ocatve of the interval
     (ref-pitch (make-diatonic-pitch #\C 0 0))             ; use reference pitch for the calculation later
     (pitch-name                                           ; calculate pitch from interval according to reference pitch
      (elt "CDEFGAB" (mod (1- (abs interval)) 7)))
     (diatonic-interval (pitch- (make-diatonic-pitch pitch-name accidentals octave) ref-pitch)))  ; calculate interval
  (cond ((> direction 0) diatonic-interval)                         ; raising interval
	((< direction 0) (pitch- (make-instance 'amuse:diatonic-pitch-interval :span '(0 0)) diatonic-interval)) ; falling interval
	((= direction 0)  (error 'invalid-argument :function 'make-diatonic-pitch-interval
				 :argument "inverval = 0" )))))  ; the constructor is not defined if interval = 0

;; Events

(defun make-chromatic-pitched-event (pitch-number onset duration)
  (make-instance 'standard-chromatic-pitched-event
		 :number pitch-number
		 :time onset
		 :interval duration))

(defun make-standard-time-signature (numerator denominator)
  (make-instance 'standard-time-signature
		 :numerator numerator
		 :denominator denominator))

(defun make-standard-time-signature-period (numerator denominator onset duration)
  (make-instance 'standard-time-signature-period
		 :numerator numerator
		 :denominator denominator
		 :time onset
		 :interval duration))

(defun make-standard-key-signature (sharp-count)
  (make-instance 'standard-key-signature
		 :sharp-count sharp-count))

(defun make-standard-key-signature-period (sharp-count onset duration)
  (make-instance 'standard-key-signature-period
		 :sharp-count sharp-count
		 :time onset
		 :interval duration))

(defun make-midi-key-signature (sharp-count mode)
  (make-instance 'midi-key-signature
		 :sharp-count sharp-count
		 :mode mode))

(defun make-midi-key-signature-period (sharp-count mode onset duration)
  (make-instance 'midi-key-signature-period
		 :sharp-count sharp-count
		 :mode mode
		 :time onset
		 :interval duration))

(defun make-standard-tempo (bpm)
  (make-instance 'standard-tempo
		 :bpm bpm))

(defun make-standard-tempo-period (bpm onset duration)
  (make-instance 'standard-tempo-period
		 :bpm bpm
		 :time onset
		 :interval duration))

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;
;; Experimental:
;;

(defun make-standard-clef-period (type line onset duration &key octave-shift)
  "Constructor for standard-clef-periods"
  (make-instance 'standard-clef-period
                 :type type
                 :line line
                 :octave-shift octave-shift
                 :time onset
                 :interval duration))

(defun make-standard-treble-clef-period (onset duration)
  "Convenience function for making treble clefs"
  (make-instance 'standard-clef-period
                 :type :G
                 :line 2
                 :octave-shift nil
                 :time onset
                 :interval duration))

(defun make-standard-bass-clef-period (onset duration)
  "Convenience function for making bass clefs"
  (make-instance 'standard-clef-period
                 :type :F
                 :line 4
                 :octave-shift nil
                 :time onset
                 :interval duration))

(defun make-standard-alto-clef-period (onset duration)
  "Convenience function for making alto clefs"
  (make-instance 'standard-clef-period
                 :type :C
                 :line 3
                 :octave-shift nil
                 :time onset
                 :interval duration))