Sophie

Sophie

distrib > Mageia > 7 > armv7hl > media > core-updates > by-pkgid > e1011ddec34cda34f3a002b121247943 > files > 702

python-docs-2.7.17-1.1.mga7.noarch.rpm


<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta charset="utf-8" />
    <title>39.3. cd — CD-ROM access on SGI systems &#8212; Python 2.7.17 documentation</title>
    <link rel="stylesheet" href="../_static/classic.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
    
    <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
    <script type="text/javascript" src="../_static/jquery.js"></script>
    <script type="text/javascript" src="../_static/underscore.js"></script>
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <script type="text/javascript" src="../_static/language_data.js"></script>
    
    <script type="text/javascript" src="../_static/sidebar.js"></script>
    
    <link rel="search" type="application/opensearchdescription+xml"
          title="Search within Python 2.7.17 documentation"
          href="../_static/opensearch.xml"/>
    <link rel="author" title="About these documents" href="../about.html" />
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="copyright" title="Copyright" href="../copyright.html" />
    <link rel="next" title="39.4. fl — FORMS library for graphical user interfaces" href="fl.html" />
    <link rel="prev" title="39.1. al — Audio functions on the SGI" href="al.html" />
    <link rel="shortcut icon" type="image/png" href="../_static/py.png" />
    <link rel="canonical" href="https://docs.python.org/2/library/cd.html" />
    <script type="text/javascript" src="../_static/copybutton.js"></script>
    
 
    

  </head><body>  
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="../genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="../py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="fl.html" title="39.4. fl — FORMS library for graphical user interfaces"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="al.html" title="39.1. al — Audio functions on the SGI"
             accesskey="P">previous</a> |</li>
        <li><img src="../_static/py.png" alt=""
                 style="vertical-align: middle; margin-top: -1px"/></li>
        <li><a href="https://www.python.org/">Python</a> &#187;</li>
        <li>
          <a href="../index.html">Python 2.7.17 documentation</a> &#187;
        </li>

          <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
          <li class="nav-item nav-item-2"><a href="sgi.html" accesskey="U">39. SGI IRIX Specific Services</a> &#187;</li> 
      </ul>
    </div>    

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="module-cd">
<span id="cd-cd-rom-access-on-sgi-systems"></span><h1>39.3. <a class="reference internal" href="#module-cd" title="cd: Interface to the CD-ROM on Silicon Graphics systems. (deprecated) (IRIX)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">cd</span></code></a> — CD-ROM access on SGI systems<a class="headerlink" href="#module-cd" title="Permalink to this headline">¶</a></h1>
<div class="deprecated">
<p><span class="versionmodified deprecated">Deprecated since version 2.6: </span>The <a class="reference internal" href="#module-cd" title="cd: Interface to the CD-ROM on Silicon Graphics systems. (deprecated) (IRIX)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">cd</span></code></a> module has been removed in Python 3.</p>
</div>
<p>This module provides an interface to the Silicon Graphics CD library. It is
available only on Silicon Graphics systems.</p>
<p>The way the library works is as follows.  A program opens the CD-ROM device with
<a class="reference internal" href="#cd.open" title="cd.open"><code class="xref py py-func docutils literal notranslate"><span class="pre">open()</span></code></a> and creates a parser to parse the data from the CD with
<a class="reference internal" href="#cd.createparser" title="cd.createparser"><code class="xref py py-func docutils literal notranslate"><span class="pre">createparser()</span></code></a>.  The object returned by <a class="reference internal" href="#cd.open" title="cd.open"><code class="xref py py-func docutils literal notranslate"><span class="pre">open()</span></code></a> can be used to read
data from the CD, but also to get status information for the CD-ROM device, and
to get information about the CD, such as the table of contents.  Data from the
CD is passed to the parser, which parses the frames, and calls any callback
functions that have previously been added.</p>
<p>An audio CD is divided into <em class="dfn">tracks</em> or <em class="dfn">programs</em> (the terms are used
interchangeably).  Tracks can be subdivided into <em class="dfn">indices</em>.  An audio CD
contains a <em class="dfn">table of contents</em> which gives the starts of the tracks on the
CD.  Index 0 is usually the pause before the start of a track.  The start of the
track as given by the table of contents is normally the start of index 1.</p>
<p>Positions on a CD can be represented in two ways.  Either a frame number or a
tuple of three values, minutes, seconds and frames.  Most functions use the
latter representation.  Positions can be both relative to the beginning of the
CD, and to the beginning of the track.</p>
<p>Module <a class="reference internal" href="#module-cd" title="cd: Interface to the CD-ROM on Silicon Graphics systems. (deprecated) (IRIX)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">cd</span></code></a> defines the following functions and constants:</p>
<dl class="function">
<dt id="cd.createparser">
<code class="descclassname">cd.</code><code class="descname">createparser</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#cd.createparser" title="Permalink to this definition">¶</a></dt>
<dd><p>Create and return an opaque parser object.  The methods of the parser object are
described below.</p>
</dd></dl>

<dl class="function">
<dt id="cd.msftoframe">
<code class="descclassname">cd.</code><code class="descname">msftoframe</code><span class="sig-paren">(</span><em>minutes</em>, <em>seconds</em>, <em>frames</em><span class="sig-paren">)</span><a class="headerlink" href="#cd.msftoframe" title="Permalink to this definition">¶</a></dt>
<dd><p>Converts a <code class="docutils literal notranslate"><span class="pre">(minutes,</span> <span class="pre">seconds,</span> <span class="pre">frames)</span></code> triple representing time in absolute
time code into the corresponding CD frame number.</p>
</dd></dl>

<dl class="function">
<dt id="cd.open">
<code class="descclassname">cd.</code><code class="descname">open</code><span class="sig-paren">(</span><span class="optional">[</span><em>device</em><span class="optional">[</span>, <em>mode</em><span class="optional">]</span><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#cd.open" title="Permalink to this definition">¶</a></dt>
<dd><p>Open the CD-ROM device.  The return value is an opaque player object; methods of
the player object are described below.  The device is the name of the SCSI
device file, e.g. <code class="docutils literal notranslate"><span class="pre">'/dev/scsi/sc0d4l0'</span></code>, or <code class="docutils literal notranslate"><span class="pre">None</span></code>.  If omitted or <code class="docutils literal notranslate"><span class="pre">None</span></code>,
the hardware inventory is consulted to locate a CD-ROM drive.  The <em>mode</em>, if
not omitted, should be the string <code class="docutils literal notranslate"><span class="pre">'r'</span></code>.</p>
</dd></dl>

<p>The module defines the following variables:</p>
<dl class="exception">
<dt id="cd.error">
<em class="property">exception </em><code class="descclassname">cd.</code><code class="descname">error</code><a class="headerlink" href="#cd.error" title="Permalink to this definition">¶</a></dt>
<dd><p>Exception raised on various errors.</p>
</dd></dl>

<dl class="data">
<dt id="cd.DATASIZE">
<code class="descclassname">cd.</code><code class="descname">DATASIZE</code><a class="headerlink" href="#cd.DATASIZE" title="Permalink to this definition">¶</a></dt>
<dd><p>The size of one frame’s worth of audio data.  This is the size of the audio data
as passed to the callback of type <code class="docutils literal notranslate"><span class="pre">audio</span></code>.</p>
</dd></dl>

<dl class="data">
<dt id="cd.BLOCKSIZE">
<code class="descclassname">cd.</code><code class="descname">BLOCKSIZE</code><a class="headerlink" href="#cd.BLOCKSIZE" title="Permalink to this definition">¶</a></dt>
<dd><p>The size of one uninterpreted frame of audio data.</p>
</dd></dl>

<p>The following variables are states as returned by <code class="xref py py-func docutils literal notranslate"><span class="pre">getstatus()</span></code>:</p>
<dl class="data">
<dt id="cd.READY">
<code class="descclassname">cd.</code><code class="descname">READY</code><a class="headerlink" href="#cd.READY" title="Permalink to this definition">¶</a></dt>
<dd><p>The drive is ready for operation loaded with an audio CD.</p>
</dd></dl>

<dl class="data">
<dt id="cd.NODISC">
<code class="descclassname">cd.</code><code class="descname">NODISC</code><a class="headerlink" href="#cd.NODISC" title="Permalink to this definition">¶</a></dt>
<dd><p>The drive does not have a CD loaded.</p>
</dd></dl>

<dl class="data">
<dt id="cd.CDROM">
<code class="descclassname">cd.</code><code class="descname">CDROM</code><a class="headerlink" href="#cd.CDROM" title="Permalink to this definition">¶</a></dt>
<dd><p>The drive is loaded with a CD-ROM.  Subsequent play or read operations will
return I/O errors.</p>
</dd></dl>

<dl class="data">
<dt id="cd.ERROR">
<code class="descclassname">cd.</code><code class="descname">ERROR</code><a class="headerlink" href="#cd.ERROR" title="Permalink to this definition">¶</a></dt>
<dd><p>An error occurred while trying to read the disc or its table of contents.</p>
</dd></dl>

<dl class="data">
<dt id="cd.PLAYING">
<code class="descclassname">cd.</code><code class="descname">PLAYING</code><a class="headerlink" href="#cd.PLAYING" title="Permalink to this definition">¶</a></dt>
<dd><p>The drive is in CD player mode playing an audio CD through its audio jacks.</p>
</dd></dl>

<dl class="data">
<dt id="cd.PAUSED">
<code class="descclassname">cd.</code><code class="descname">PAUSED</code><a class="headerlink" href="#cd.PAUSED" title="Permalink to this definition">¶</a></dt>
<dd><p>The drive is in CD layer mode with play paused.</p>
</dd></dl>

<dl class="data">
<dt id="cd.STILL">
<code class="descclassname">cd.</code><code class="descname">STILL</code><a class="headerlink" href="#cd.STILL" title="Permalink to this definition">¶</a></dt>
<dd><p>The equivalent of <a class="reference internal" href="#cd.PAUSED" title="cd.PAUSED"><code class="xref py py-const docutils literal notranslate"><span class="pre">PAUSED</span></code></a> on older (non 3301) model Toshiba CD-ROM
drives.  Such drives have never been shipped by SGI.</p>
</dd></dl>

<dl class="data">
<dt id="cd.audio">
<code class="descclassname">cd.</code><code class="descname">audio</code><a class="headerlink" href="#cd.audio" title="Permalink to this definition">¶</a></dt>
<dt id="cd.pnum">
<code class="descclassname">cd.</code><code class="descname">pnum</code><a class="headerlink" href="#cd.pnum" title="Permalink to this definition">¶</a></dt>
<dt id="cd.index">
<code class="descclassname">cd.</code><code class="descname">index</code><a class="headerlink" href="#cd.index" title="Permalink to this definition">¶</a></dt>
<dt id="cd.ptime">
<code class="descclassname">cd.</code><code class="descname">ptime</code><a class="headerlink" href="#cd.ptime" title="Permalink to this definition">¶</a></dt>
<dt id="cd.atime">
<code class="descclassname">cd.</code><code class="descname">atime</code><a class="headerlink" href="#cd.atime" title="Permalink to this definition">¶</a></dt>
<dt id="cd.catalog">
<code class="descclassname">cd.</code><code class="descname">catalog</code><a class="headerlink" href="#cd.catalog" title="Permalink to this definition">¶</a></dt>
<dt id="cd.ident">
<code class="descclassname">cd.</code><code class="descname">ident</code><a class="headerlink" href="#cd.ident" title="Permalink to this definition">¶</a></dt>
<dt id="cd.control">
<code class="descclassname">cd.</code><code class="descname">control</code><a class="headerlink" href="#cd.control" title="Permalink to this definition">¶</a></dt>
<dd><p>Integer constants describing the various types of parser callbacks that can be
set by the <code class="xref py py-meth docutils literal notranslate"><span class="pre">addcallback()</span></code> method of CD parser objects (see below).</p>
</dd></dl>

<div class="section" id="player-objects">
<span id="id1"></span><h2>39.3.1. Player Objects<a class="headerlink" href="#player-objects" title="Permalink to this headline">¶</a></h2>
<p>Player objects (returned by <a class="reference internal" href="#cd.open" title="cd.open"><code class="xref py py-func docutils literal notranslate"><span class="pre">open()</span></code></a>) have the following methods:</p>
<dl class="method">
<dt>
<code class="descname">CD player.allowremoval()</code></dt>
<dd><p>Unlocks the eject button on the CD-ROM drive permitting the user to eject the
caddy if desired.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.bestreadsize()</code></dt>
<dd><p>Returns the best value to use for the <em>num_frames</em> parameter of the
<code class="xref py py-meth docutils literal notranslate"><span class="pre">readda()</span></code> method.  Best is defined as the value that permits a continuous
flow of data from the CD-ROM drive.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.close()</code></dt>
<dd><p>Frees the resources associated with the player object.  After calling
<code class="xref py py-meth docutils literal notranslate"><span class="pre">close()</span></code>, the methods of the object should no longer be used.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.eject()</code></dt>
<dd><p>Ejects the caddy from the CD-ROM drive.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.getstatus()</code></dt>
<dd><p>Returns information pertaining to the current state of the CD-ROM drive.  The
returned information is a tuple with the following values: <em>state</em>, <em>track</em>,
<em>rtime</em>, <em>atime</em>, <em>ttime</em>, <em>first</em>, <em>last</em>, <em>scsi_audio</em>, <em>cur_block</em>. <em>rtime</em>
is the time relative to the start of the current track; <em>atime</em> is the time
relative to the beginning of the disc; <em>ttime</em> is the total time on the disc.
For more information on the meaning of the values, see the man page
<em class="manpage">CDgetstatus(3dm)</em>. The value of <em>state</em> is one of the following:
<a class="reference internal" href="#cd.ERROR" title="cd.ERROR"><code class="xref py py-const docutils literal notranslate"><span class="pre">ERROR</span></code></a>, <a class="reference internal" href="#cd.NODISC" title="cd.NODISC"><code class="xref py py-const docutils literal notranslate"><span class="pre">NODISC</span></code></a>, <a class="reference internal" href="#cd.READY" title="cd.READY"><code class="xref py py-const docutils literal notranslate"><span class="pre">READY</span></code></a>, <a class="reference internal" href="#cd.PLAYING" title="cd.PLAYING"><code class="xref py py-const docutils literal notranslate"><span class="pre">PLAYING</span></code></a>,
<a class="reference internal" href="#cd.PAUSED" title="cd.PAUSED"><code class="xref py py-const docutils literal notranslate"><span class="pre">PAUSED</span></code></a>, <a class="reference internal" href="#cd.STILL" title="cd.STILL"><code class="xref py py-const docutils literal notranslate"><span class="pre">STILL</span></code></a>, or <a class="reference internal" href="#cd.CDROM" title="cd.CDROM"><code class="xref py py-const docutils literal notranslate"><span class="pre">CDROM</span></code></a>.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.gettrackinfo(track)</code></dt>
<dd><p>Returns information about the specified track.  The returned information is a
tuple consisting of two elements, the start time of the track and the duration
of the track.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.msftoblock(min, sec, frame)</code></dt>
<dd><p>Converts a minutes, seconds, frames triple representing a time in absolute time
code into the corresponding logical block number for the given CD-ROM drive.
You should use <a class="reference internal" href="#cd.msftoframe" title="cd.msftoframe"><code class="xref py py-func docutils literal notranslate"><span class="pre">msftoframe()</span></code></a> rather than <code class="xref py py-meth docutils literal notranslate"><span class="pre">msftoblock()</span></code> for comparing
times.  The logical block number differs from the frame number by an offset
required by certain CD-ROM drives.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.play(start, play)</code></dt>
<dd><p>Starts playback of an audio CD in the CD-ROM drive at the specified track.  The
audio output appears on the CD-ROM drive’s headphone and audio jacks (if
fitted).  Play stops at the end of the disc. <em>start</em> is the number of the track
at which to start playing the CD; if <em>play</em> is 0, the CD will be set to an
initial paused state.  The method <code class="xref py py-meth docutils literal notranslate"><span class="pre">togglepause()</span></code> can then be used to
commence play.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.playabs(minutes, seconds, frames, play)</code></dt>
<dd><p>Like <code class="xref py py-meth docutils literal notranslate"><span class="pre">play()</span></code>, except that the start is given in minutes, seconds, and
frames instead of a track number.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.playtrack(start, play)</code></dt>
<dd><p>Like <code class="xref py py-meth docutils literal notranslate"><span class="pre">play()</span></code>, except that playing stops at the end of the track.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.playtrackabs(track, minutes, seconds, frames, play)</code></dt>
<dd><p>Like <code class="xref py py-meth docutils literal notranslate"><span class="pre">play()</span></code>, except that playing begins at the specified absolute time and
ends at the end of the specified track.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.preventremoval()</code></dt>
<dd><p>Locks the eject button on the CD-ROM drive thus preventing the user from
arbitrarily ejecting the caddy.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.readda(num_frames)</code></dt>
<dd><p>Reads the specified number of frames from an audio CD mounted in the CD-ROM
drive.  The return value is a string representing the audio frames.  This string
can be passed unaltered to the <code class="xref py py-meth docutils literal notranslate"><span class="pre">parseframe()</span></code> method of the parser object.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.seek(minutes, seconds, frames)</code></dt>
<dd><p>Sets the pointer that indicates the starting point of the next read of digital
audio data from a CD-ROM.  The pointer is set to an absolute time code location
specified in <em>minutes</em>, <em>seconds</em>, and <em>frames</em>.  The return value is the
logical block number to which the pointer has been set.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.seekblock(block)</code></dt>
<dd><p>Sets the pointer that indicates the starting point of the next read of digital
audio data from a CD-ROM.  The pointer is set to the specified logical block
number.  The return value is the logical block number to which the pointer has
been set.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.seektrack(track)</code></dt>
<dd><p>Sets the pointer that indicates the starting point of the next read of digital
audio data from a CD-ROM.  The pointer is set to the specified track.  The
return value is the logical block number to which the pointer has been set.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.stop()</code></dt>
<dd><p>Stops the current playing operation.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD player.togglepause()</code></dt>
<dd><p>Pauses the CD if it is playing, and makes it play if it is paused.</p>
</dd></dl>

</div>
<div class="section" id="parser-objects">
<span id="cd-parser-objects"></span><h2>39.3.2. Parser Objects<a class="headerlink" href="#parser-objects" title="Permalink to this headline">¶</a></h2>
<p>Parser objects (returned by <a class="reference internal" href="#cd.createparser" title="cd.createparser"><code class="xref py py-func docutils literal notranslate"><span class="pre">createparser()</span></code></a>) have the following methods:</p>
<dl class="method">
<dt>
<code class="descname">CD parser.addcallback(type, func, arg)</code></dt>
<dd><p>Adds a callback for the parser.  The parser has callbacks for eight different
types of data in the digital audio data stream.  Constants for these types are
defined at the <a class="reference internal" href="#module-cd" title="cd: Interface to the CD-ROM on Silicon Graphics systems. (deprecated) (IRIX)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">cd</span></code></a> module level (see above). The callback is called as
follows: <code class="docutils literal notranslate"><span class="pre">func(arg,</span> <span class="pre">type,</span> <span class="pre">data)</span></code>, where <em>arg</em> is the user supplied argument,
<em>type</em> is the particular type of callback, and <em>data</em> is the data returned for
this <em>type</em> of callback.  The type of the data depends on the <em>type</em> of callback
as follows:</p>
<table class="docutils align-center">
<colgroup>
<col style="width: 22%" />
<col style="width: 78%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Type</p></th>
<th class="head"><p>Value</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">audio</span></code></p></td>
<td><p>String which can be passed unmodified to
<code class="xref py py-func docutils literal notranslate"><span class="pre">al.writesamps()</span></code>.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">pnum</span></code></p></td>
<td><p>Integer giving the program (track) number.</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">index</span></code></p></td>
<td><p>Integer giving the index number.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ptime</span></code></p></td>
<td><p>Tuple consisting of the program time in
minutes, seconds, and frames.</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">atime</span></code></p></td>
<td><p>Tuple consisting of the absolute time in
minutes, seconds, and frames.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">catalog</span></code></p></td>
<td><p>String of 13 characters, giving the catalog
number of the CD.</p></td>
</tr>
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ident</span></code></p></td>
<td><p>String of 12 characters, giving the ISRC
identification number of the recording.
The string consists of two characters
country code, three characters owner code,
two characters giving the year, and five
characters giving a serial number.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">control</span></code></p></td>
<td><p>Integer giving the control bits from the CD
subcode data</p></td>
</tr>
</tbody>
</table>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD parser.deleteparser()</code></dt>
<dd><p>Deletes the parser and frees the memory it was using.  The object should not be
used after this call.  This call is done automatically when the last reference
to the object is removed.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD parser.parseframe(frame)</code></dt>
<dd><p>Parses one or more frames of digital audio data from a CD such as returned by
<code class="xref py py-meth docutils literal notranslate"><span class="pre">readda()</span></code>.  It determines which subcodes are present in the data.  If these
subcodes have changed since the last frame, then <code class="xref py py-meth docutils literal notranslate"><span class="pre">parseframe()</span></code> executes a
callback of the appropriate type passing to it the subcode data found in the
frame. Unlike the C function, more than one frame of digital audio data can be
passed to this method.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD parser.removecallback(type)</code></dt>
<dd><p>Removes the callback for the given <em>type</em>.</p>
</dd></dl>

<dl class="method">
<dt>
<code class="descname">CD parser.resetparser()</code></dt>
<dd><p>Resets the fields of the parser used for tracking subcodes to an initial state.
<code class="xref py py-meth docutils literal notranslate"><span class="pre">resetparser()</span></code> should be called after the disc has been changed.</p>
</dd></dl>

</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="../contents.html">Table of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">39.3. <code class="xref py py-mod docutils literal notranslate"><span class="pre">cd</span></code> — CD-ROM access on SGI systems</a><ul>
<li><a class="reference internal" href="#player-objects">39.3.1. Player Objects</a></li>
<li><a class="reference internal" href="#parser-objects">39.3.2. Parser Objects</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="al.html"
                        title="previous chapter">39.1. <code class="xref py py-mod docutils literal notranslate"><span class="pre">al</span></code> — Audio functions on the SGI</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="fl.html"
                        title="next chapter">39.4. <code class="xref py py-mod docutils literal notranslate"><span class="pre">fl</span></code> — FORMS library for graphical user interfaces</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="../_sources/library/cd.rst.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <div class="searchformwrapper">
    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
    </form>
    </div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>  
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="../genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="../py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="fl.html" title="39.4. fl — FORMS library for graphical user interfaces"
             >next</a> |</li>
        <li class="right" >
          <a href="al.html" title="39.1. al — Audio functions on the SGI"
             >previous</a> |</li>
        <li><img src="../_static/py.png" alt=""
                 style="vertical-align: middle; margin-top: -1px"/></li>
        <li><a href="https://www.python.org/">Python</a> &#187;</li>
        <li>
          <a href="../index.html">Python 2.7.17 documentation</a> &#187;
        </li>

          <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>
          <li class="nav-item nav-item-2"><a href="sgi.html" >39. SGI IRIX Specific Services</a> &#187;</li> 
      </ul>
    </div>  
    <div class="footer">
    &copy; <a href="../copyright.html">Copyright</a> 1990-2019, Python Software Foundation.
    <br />
    The Python Software Foundation is a non-profit corporation.
    <a href="https://www.python.org/psf/donations/">Please donate.</a>
    <br />
    Last updated on Oct 19, 2019.
    <a href="../bugs.html">Found a bug</a>?
    <br />
    Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 2.0.1.
    </div>

  </body>
</html>