]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Initial revision
authorGuido van Rossum <guido@python.org>
Wed, 22 Apr 1992 13:24:13 +0000 (13:24 +0000)
committerGuido van Rossum <guido@python.org>
Wed, 22 Apr 1992 13:24:13 +0000 (13:24 +0000)
Lib/irix5/readcd.doc [new file with mode: 0755]
Lib/irix5/readcd.py [new file with mode: 0755]
Lib/plat-irix5/readcd.doc [new file with mode: 0755]
Lib/plat-irix5/readcd.py [new file with mode: 0755]

diff --git a/Lib/irix5/readcd.doc b/Lib/irix5/readcd.doc
new file mode 100755 (executable)
index 0000000..b827ccc
--- /dev/null
@@ -0,0 +1,104 @@
+Interface to CD-ROM player.
+
+This module implements an interface to the built-in cd module.  The
+intention is to provide a more user-friendly interface than the
+built-in module.
+
+The module defines a class Readcd with several methods.  The
+initialization of the class will try to open the CD player.  This
+means that initialization will fail if the CD player is already in
+use.  A RuntimeError will be raised by the cd module in that case.
+
+The way to work with this module is as follows.  The user specifies
+the parts of the CD that are to be read and he specifies callback
+functions which are to be called by the system.  At some point he can
+tell the system to play.  The specified parts of the CD will then be
+read and the callbacks will be called.
+
+Initialization.
+===============
+
+r = readcd.Readcd().init([cd-player [, mode]])
+
+The optional arguments are the name of the CD device and the mode.
+When "mode" is not specified, it defaults to 'r' (which is the only
+possible value); when "cd-player" also isn't specified, it defaults
+to "None" which indicates the default CD player.
+
+Methods.
+========
+
+eject() -- Eject the CD from the player.
+
+reset() -- Reset the list of data stretches to be played.
+
+appendtrack(track) -- Append the specified track to the list of music
+stretches.
+
+appendstretch(first, last) -- Append the stretch from "first" to "last"
+to the list of music stretches.  Both "first" and "last" can be in one
+of four forms.  "None": for "first", the beginning of the CD, for
+"last" the end of the CD; a single integer: a track number--playing
+starts at the beginning of the track or ends at the end of the
+specified track; a three-tuple: the absolute time from the start of
+the CD in minutes, seconds, frames; a four-tuple: track number and
+relative time within the track in minutes, seconds, frames.
+
+settracks(tracklist) -- The argument is a list of integers.  The list
+of stretches is set to argument list.  The old list is discarded.
+
+setcallback(type, func, arg) -- Set a callback function for "type".
+The function will be called as func(arg, type, data) where "arg" is
+the third argument of setcallback, "type" is the type of callback,
+"data" is type-dependent data.  See the CDsetcallback(3) manual page
+for more information.  The possible "type" arguments are defined in
+the CD module.
+
+removecallback(type) -- Remove the callback for "type".
+
+gettrackinfo([tracklist]) -- Return a list of tuples.  Each tuple
+consists of start and length information of a track.  The start and
+length information consist of three-tuples with minutes, seconds and
+frames.  The optional tracklist argument gives a list of interesting
+track numbers.  If no tracklist is specified, information about all
+tracks is returned.
+
+getstatus() -- Return the status information of the CD.
+
+play() -- Play the preprogrammed stretches of music from the CD.  When
+nothing was programmed, the whole CD is played.
+
+Specifying stretches.
+=====================
+
+There are three methods available to specify a stretch of music to be
+played.  The easiest way is to use "settracklist(tracklist)" with which
+a list of tracks can be specified.  "settracklist(tracklist)" is
+equivalent to the sequence
+       reset()
+       for track in tracklist:
+               appendtrack(track)
+
+The next method is "appendtrack(track)" with which a whole track can be
+added to the list of music to be played.  "appendtrack(track)" is
+equivalent to "appendstretch(track, track)".
+
+The most complete method is "appendstretch(first, last)".  Using this
+method, it is possible to specify any stretch of music.
+
+When two consecutive tracks are played, it is possible to choose
+whether the pause that may be between the tracks is played as well or
+whether the pause should be skipped.  When the end of a stretch is
+specified using a track number and the next stretch starts at the
+beginning of the following track and that was also specified using the
+track number (that is, both were specified as integers, not as tuples),
+the pause is played.  When either value was specified using absolute
+time or track-relative time (that is, as three-tuple or as
+four-tuple), the pause will not be played.
+
+Errors.
+=======
+
+When an error occurs, an exception will be raised.  Depending on where
+the error occurs, the exception may either be "readcd.Error" or
+"RuntimeError".
diff --git a/Lib/irix5/readcd.py b/Lib/irix5/readcd.py
new file mode 100755 (executable)
index 0000000..11ac87b
--- /dev/null
@@ -0,0 +1,230 @@
+# Class interface to the CD module.
+
+import cd, CD
+
+Error = 'Readcd.Error'
+_Stop = 'Readcd.Stop'
+
+def _doatime(self, type, data):
+       if ((data[0] * 60) + data[1]) * 75 + data[2] > self.end:
+               print 'done with list entry',`self.listindex`
+               raise _Stop
+       func, arg = self.callbacks[type]
+       if func:
+               func(arg, type, data)
+
+def _dopnum(self, type, data):
+       if data > self.end:
+               print 'done with list entry',`self.listindex`
+               raise _Stop
+       func, arg = self.callbacks[type]
+       if func:
+               func(arg, type, data)
+
+class Readcd():
+       def init(self, *arg):
+               if len(arg) == 0:
+                       self.player = cd.open()
+               elif len(arg) == 1:
+                       self.player = cd.open(arg[0])
+               elif len(arg) == 2:
+                       self.player = cd.open(arg[0], arg[1])
+               else:
+                       raise Error, 'bad init call'
+               self.list = []
+               self.callbacks = [(None, None)] * 8
+               self.parser = cd.createparser()
+               self.playing = 0
+               self.end = 0
+               self.status = None
+               self.trackinfo = None
+               return self
+
+       def eject(self):
+               self.player.eject()
+               self.list = []
+               self.end = 0
+               self.listindex = 0
+               self.status = None
+               self.trackinfo = None
+               if self.playing:
+                       print 'stop playing from eject'
+                       raise _Stop
+
+       def pmsf2msf(self, track, min, sec, frame):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not self.trackinfo:
+                       dummy = self.gettrackinfo()
+               if track < self.status[5] or track > self.status[6]:
+                       raise Error, 'track number out of range'
+               start, total = self.trackinfo[track]
+               start = ((start[0] * 60) + start[1]) * 75 + start[2]
+               total = ((total[0] * 60) + total[1]) * 75 + total[2]
+               block = ((min * 60) + sec) * 75 + frame
+               if block > total:
+                       raise Error, 'out of range'
+               block = start + block
+               min, block = divmod(block, 75*60)
+               sec, frame = divmod(block, 75)
+               return min, sec, frame
+
+       def reset(self):
+               self.list = []
+
+       def appendtrack(self, track):
+               self.appendstretch(track, track)
+                               
+       def appendstretch(self, start, end):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not start:
+                       start = 1
+               if not end:
+                       end = self.status[6]
+               try:
+                       l = len(end)
+                       if l == 4:
+                               prog, min, sec, frame = end
+                               if prog < self.status[5] or prog > self.status[6]:
+                                       raise Error, 'range error'
+                               end = self.pmsf2msf(prog, min, sec, frame)
+                       elif l <> 3:
+                               raise Error, 'syntax error'
+               except TypeError:
+                       if end < self.status[5] or end > self.status[6]:
+                               raise Error, 'range error'
+               try:
+                       l = len(start)
+                       if l == 4:
+                               prog, min, sec, frame = start
+                               if prog < self.status[5] or prog > self.status[6]:
+                                       raise Error, 'range error'
+                               start = self.pmsf2msf(prog, min, sec, frame)
+                       elif l <> 3:
+                               raise Error, 'syntax error'
+               except TypeError:
+                       if start < self.status[5] or start > self.status[6]:
+                               raise Error, 'range error'
+                       if len(self.list) > 0:
+                               s, e = self.list[-1]
+                               try:
+                                       l = len(e)
+                               except TypeError:
+                                       if start == e+1:
+                                               start = s
+                                               del self.list[-1]
+               self.list.append((start, end))
+
+       def settracks(self, list):
+               self.list = []
+               for track in list:
+                       self.appendtrack(track)
+
+       def setcallback(self, type, func, arg):
+               if type < 0 or type >= 8:
+                       raise Error, 'type out of range'
+               self.callbacks[type] = (func, arg)
+               if self.playing:
+                       try:
+                               l = len(end)
+                               if type <> CD.ATIME:
+                                       self.parser.setcallback(type, func, arg)
+                       except TypeError:
+                               if type <> CD.PNUM:
+                                       self.parser.setcallback(type, func, arg)
+
+       def removecallback(self, type):
+               if type < 0 or type >= 8:
+                       raise Error, 'type out of range'
+               self.callbacks[type] = (None, None)
+               if self.playing:
+                       try:
+                               l = len(end)
+                               if type <> CD.ATIME:
+                                       self.parser.removecallback(type)
+                       except TypeError:
+                               if type <> CD.PNUM:
+                                       self.parser.removecallback(type)
+
+       def gettrackinfo(self, *arg):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not self.trackinfo:
+                       self.trackinfo = []
+                       for i in range(self.status[5]):
+                               self.trackinfo.append(None)
+                       for i in range(self.status[5], self.status[6]+1):
+                               self.trackinfo.append(self.player.gettrackinfo(i))
+               if len(arg) == 0:
+                       return self.trackinfo[self.status[5]:self.status[6]+1]
+               result = []
+               for i in arg:
+                       if i < self.status[5] or i > self.status[6]:
+                               raise Error, 'range error'
+                       result.append(self.trackinfo[i])
+               return result
+
+       def getstatus(self):
+               if not self.status:
+                       status = self.player.getstatus()
+                       if status[0] <> CD.NODISC:
+                               self.status = status
+               else:
+                       status = self.status
+               return status
+
+       def play(self):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               size = self.player.bestreadsize()
+               self.listindex = 0
+               self.playing = 0
+               for i in range(8):
+                       func, arg = self.callbacks[i]
+                       if func:
+                               self.parser.setcallback(i, func, arg)
+                       else:
+                               self.parser.removecallback(i)
+               if len(self.list) == 0:
+                       for i in range(self.status[5], self.status[6]+1):
+                               self.appendtrack(i)
+               while 1:
+                       if not self.playing:
+                               if self.listindex >= len(self.list):
+                                       return
+                               start, end = self.list[self.listindex]
+                               print 'starting with',`(start, end)`
+                               try:
+                                       min, sec, frame = start
+                                       dummy = self.player.seek(min, sec, frame)
+                               except TypeError:
+                                       dummy = self.player.seektrack(start)
+                               try:
+                                       min, sec, frame = end
+                                       self.parser.setcallback(CD.ATIME, _doatime, self)
+                                       self.end = (min * 60 + sec) * 75 + frame
+                                       func, arg = self.callbacks[CD.PNUM]
+                                       if func:
+                                               self.parser.setcallback(CD.PNUM, func, arg)
+                                       else:
+                                               self.parser.removecallback(CD.PNUM)
+                               except TypeError:
+                                       self.parser.setcallback(CD.PNUM, _dopnum, self)
+                                       self.end = end
+                                       func, arg = self.callbacks[CD.ATIME]
+                                       if func:
+                                               self.parser.setcallback(CD.ATIME, func, arg)
+                                       else:
+                                               self.parser.removecallback(CD.ATIME)
+                               self.playing = 1
+                       data = self.player.readda(size)
+                       if data == '':
+                               self.playing = 0
+                               self.listindex = self.listindex + 1
+                               continue
+                       try:
+                               self.parser.parseframe(data)
+                       except _Stop:
+                               self.playing = 0
+                               self.listindex = self.listindex + 1
diff --git a/Lib/plat-irix5/readcd.doc b/Lib/plat-irix5/readcd.doc
new file mode 100755 (executable)
index 0000000..b827ccc
--- /dev/null
@@ -0,0 +1,104 @@
+Interface to CD-ROM player.
+
+This module implements an interface to the built-in cd module.  The
+intention is to provide a more user-friendly interface than the
+built-in module.
+
+The module defines a class Readcd with several methods.  The
+initialization of the class will try to open the CD player.  This
+means that initialization will fail if the CD player is already in
+use.  A RuntimeError will be raised by the cd module in that case.
+
+The way to work with this module is as follows.  The user specifies
+the parts of the CD that are to be read and he specifies callback
+functions which are to be called by the system.  At some point he can
+tell the system to play.  The specified parts of the CD will then be
+read and the callbacks will be called.
+
+Initialization.
+===============
+
+r = readcd.Readcd().init([cd-player [, mode]])
+
+The optional arguments are the name of the CD device and the mode.
+When "mode" is not specified, it defaults to 'r' (which is the only
+possible value); when "cd-player" also isn't specified, it defaults
+to "None" which indicates the default CD player.
+
+Methods.
+========
+
+eject() -- Eject the CD from the player.
+
+reset() -- Reset the list of data stretches to be played.
+
+appendtrack(track) -- Append the specified track to the list of music
+stretches.
+
+appendstretch(first, last) -- Append the stretch from "first" to "last"
+to the list of music stretches.  Both "first" and "last" can be in one
+of four forms.  "None": for "first", the beginning of the CD, for
+"last" the end of the CD; a single integer: a track number--playing
+starts at the beginning of the track or ends at the end of the
+specified track; a three-tuple: the absolute time from the start of
+the CD in minutes, seconds, frames; a four-tuple: track number and
+relative time within the track in minutes, seconds, frames.
+
+settracks(tracklist) -- The argument is a list of integers.  The list
+of stretches is set to argument list.  The old list is discarded.
+
+setcallback(type, func, arg) -- Set a callback function for "type".
+The function will be called as func(arg, type, data) where "arg" is
+the third argument of setcallback, "type" is the type of callback,
+"data" is type-dependent data.  See the CDsetcallback(3) manual page
+for more information.  The possible "type" arguments are defined in
+the CD module.
+
+removecallback(type) -- Remove the callback for "type".
+
+gettrackinfo([tracklist]) -- Return a list of tuples.  Each tuple
+consists of start and length information of a track.  The start and
+length information consist of three-tuples with minutes, seconds and
+frames.  The optional tracklist argument gives a list of interesting
+track numbers.  If no tracklist is specified, information about all
+tracks is returned.
+
+getstatus() -- Return the status information of the CD.
+
+play() -- Play the preprogrammed stretches of music from the CD.  When
+nothing was programmed, the whole CD is played.
+
+Specifying stretches.
+=====================
+
+There are three methods available to specify a stretch of music to be
+played.  The easiest way is to use "settracklist(tracklist)" with which
+a list of tracks can be specified.  "settracklist(tracklist)" is
+equivalent to the sequence
+       reset()
+       for track in tracklist:
+               appendtrack(track)
+
+The next method is "appendtrack(track)" with which a whole track can be
+added to the list of music to be played.  "appendtrack(track)" is
+equivalent to "appendstretch(track, track)".
+
+The most complete method is "appendstretch(first, last)".  Using this
+method, it is possible to specify any stretch of music.
+
+When two consecutive tracks are played, it is possible to choose
+whether the pause that may be between the tracks is played as well or
+whether the pause should be skipped.  When the end of a stretch is
+specified using a track number and the next stretch starts at the
+beginning of the following track and that was also specified using the
+track number (that is, both were specified as integers, not as tuples),
+the pause is played.  When either value was specified using absolute
+time or track-relative time (that is, as three-tuple or as
+four-tuple), the pause will not be played.
+
+Errors.
+=======
+
+When an error occurs, an exception will be raised.  Depending on where
+the error occurs, the exception may either be "readcd.Error" or
+"RuntimeError".
diff --git a/Lib/plat-irix5/readcd.py b/Lib/plat-irix5/readcd.py
new file mode 100755 (executable)
index 0000000..11ac87b
--- /dev/null
@@ -0,0 +1,230 @@
+# Class interface to the CD module.
+
+import cd, CD
+
+Error = 'Readcd.Error'
+_Stop = 'Readcd.Stop'
+
+def _doatime(self, type, data):
+       if ((data[0] * 60) + data[1]) * 75 + data[2] > self.end:
+               print 'done with list entry',`self.listindex`
+               raise _Stop
+       func, arg = self.callbacks[type]
+       if func:
+               func(arg, type, data)
+
+def _dopnum(self, type, data):
+       if data > self.end:
+               print 'done with list entry',`self.listindex`
+               raise _Stop
+       func, arg = self.callbacks[type]
+       if func:
+               func(arg, type, data)
+
+class Readcd():
+       def init(self, *arg):
+               if len(arg) == 0:
+                       self.player = cd.open()
+               elif len(arg) == 1:
+                       self.player = cd.open(arg[0])
+               elif len(arg) == 2:
+                       self.player = cd.open(arg[0], arg[1])
+               else:
+                       raise Error, 'bad init call'
+               self.list = []
+               self.callbacks = [(None, None)] * 8
+               self.parser = cd.createparser()
+               self.playing = 0
+               self.end = 0
+               self.status = None
+               self.trackinfo = None
+               return self
+
+       def eject(self):
+               self.player.eject()
+               self.list = []
+               self.end = 0
+               self.listindex = 0
+               self.status = None
+               self.trackinfo = None
+               if self.playing:
+                       print 'stop playing from eject'
+                       raise _Stop
+
+       def pmsf2msf(self, track, min, sec, frame):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not self.trackinfo:
+                       dummy = self.gettrackinfo()
+               if track < self.status[5] or track > self.status[6]:
+                       raise Error, 'track number out of range'
+               start, total = self.trackinfo[track]
+               start = ((start[0] * 60) + start[1]) * 75 + start[2]
+               total = ((total[0] * 60) + total[1]) * 75 + total[2]
+               block = ((min * 60) + sec) * 75 + frame
+               if block > total:
+                       raise Error, 'out of range'
+               block = start + block
+               min, block = divmod(block, 75*60)
+               sec, frame = divmod(block, 75)
+               return min, sec, frame
+
+       def reset(self):
+               self.list = []
+
+       def appendtrack(self, track):
+               self.appendstretch(track, track)
+                               
+       def appendstretch(self, start, end):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not start:
+                       start = 1
+               if not end:
+                       end = self.status[6]
+               try:
+                       l = len(end)
+                       if l == 4:
+                               prog, min, sec, frame = end
+                               if prog < self.status[5] or prog > self.status[6]:
+                                       raise Error, 'range error'
+                               end = self.pmsf2msf(prog, min, sec, frame)
+                       elif l <> 3:
+                               raise Error, 'syntax error'
+               except TypeError:
+                       if end < self.status[5] or end > self.status[6]:
+                               raise Error, 'range error'
+               try:
+                       l = len(start)
+                       if l == 4:
+                               prog, min, sec, frame = start
+                               if prog < self.status[5] or prog > self.status[6]:
+                                       raise Error, 'range error'
+                               start = self.pmsf2msf(prog, min, sec, frame)
+                       elif l <> 3:
+                               raise Error, 'syntax error'
+               except TypeError:
+                       if start < self.status[5] or start > self.status[6]:
+                               raise Error, 'range error'
+                       if len(self.list) > 0:
+                               s, e = self.list[-1]
+                               try:
+                                       l = len(e)
+                               except TypeError:
+                                       if start == e+1:
+                                               start = s
+                                               del self.list[-1]
+               self.list.append((start, end))
+
+       def settracks(self, list):
+               self.list = []
+               for track in list:
+                       self.appendtrack(track)
+
+       def setcallback(self, type, func, arg):
+               if type < 0 or type >= 8:
+                       raise Error, 'type out of range'
+               self.callbacks[type] = (func, arg)
+               if self.playing:
+                       try:
+                               l = len(end)
+                               if type <> CD.ATIME:
+                                       self.parser.setcallback(type, func, arg)
+                       except TypeError:
+                               if type <> CD.PNUM:
+                                       self.parser.setcallback(type, func, arg)
+
+       def removecallback(self, type):
+               if type < 0 or type >= 8:
+                       raise Error, 'type out of range'
+               self.callbacks[type] = (None, None)
+               if self.playing:
+                       try:
+                               l = len(end)
+                               if type <> CD.ATIME:
+                                       self.parser.removecallback(type)
+                       except TypeError:
+                               if type <> CD.PNUM:
+                                       self.parser.removecallback(type)
+
+       def gettrackinfo(self, *arg):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               if not self.trackinfo:
+                       self.trackinfo = []
+                       for i in range(self.status[5]):
+                               self.trackinfo.append(None)
+                       for i in range(self.status[5], self.status[6]+1):
+                               self.trackinfo.append(self.player.gettrackinfo(i))
+               if len(arg) == 0:
+                       return self.trackinfo[self.status[5]:self.status[6]+1]
+               result = []
+               for i in arg:
+                       if i < self.status[5] or i > self.status[6]:
+                               raise Error, 'range error'
+                       result.append(self.trackinfo[i])
+               return result
+
+       def getstatus(self):
+               if not self.status:
+                       status = self.player.getstatus()
+                       if status[0] <> CD.NODISC:
+                               self.status = status
+               else:
+                       status = self.status
+               return status
+
+       def play(self):
+               if not self.status:
+                       self.status = self.player.getstatus()
+               size = self.player.bestreadsize()
+               self.listindex = 0
+               self.playing = 0
+               for i in range(8):
+                       func, arg = self.callbacks[i]
+                       if func:
+                               self.parser.setcallback(i, func, arg)
+                       else:
+                               self.parser.removecallback(i)
+               if len(self.list) == 0:
+                       for i in range(self.status[5], self.status[6]+1):
+                               self.appendtrack(i)
+               while 1:
+                       if not self.playing:
+                               if self.listindex >= len(self.list):
+                                       return
+                               start, end = self.list[self.listindex]
+                               print 'starting with',`(start, end)`
+                               try:
+                                       min, sec, frame = start
+                                       dummy = self.player.seek(min, sec, frame)
+                               except TypeError:
+                                       dummy = self.player.seektrack(start)
+                               try:
+                                       min, sec, frame = end
+                                       self.parser.setcallback(CD.ATIME, _doatime, self)
+                                       self.end = (min * 60 + sec) * 75 + frame
+                                       func, arg = self.callbacks[CD.PNUM]
+                                       if func:
+                                               self.parser.setcallback(CD.PNUM, func, arg)
+                                       else:
+                                               self.parser.removecallback(CD.PNUM)
+                               except TypeError:
+                                       self.parser.setcallback(CD.PNUM, _dopnum, self)
+                                       self.end = end
+                                       func, arg = self.callbacks[CD.ATIME]
+                                       if func:
+                                               self.parser.setcallback(CD.ATIME, func, arg)
+                                       else:
+                                               self.parser.removecallback(CD.ATIME)
+                               self.playing = 1
+                       data = self.player.readda(size)
+                       if data == '':
+                               self.playing = 0
+                               self.listindex = self.listindex + 1
+                               continue
+                       try:
+                               self.parser.parseframe(data)
+                       except _Stop:
+                               self.playing = 0
+                               self.listindex = self.listindex + 1