rbcdio 0.01

data/swig/disc.swg

@@ -0,0 +1,96 @@
+/* -*- c -*-
+    $Id: disc.swg,v 1.1.1.1 2006/11/13 05:13:33 rocky Exp $
+
+    Copyright (C) 2006 Rocky Bernstein <rocky@cpan.org>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+*/
+/* See <cdio/device.h> for more extensive documentation. */
+
+%constant long int DISC_MODE_CD_DA    = CDIO_DISC_MODE_CD_DA;
+%constant long int DISC_MODE_CD_DATA  = CDIO_DISC_MODE_CD_DATA;
+%constant long int DISC_MODE_CD_XA  = CDIO_DISC_MODE_CD_XA;
+%constant long int DISC_MODE_CD_MIXED  = CDIO_DISC_MODE_CD_MIXED;
+%constant long int DISC_MODE_DVD_ROM  = CDIO_DISC_MODE_DVD_ROM;
+%constant long int DISC_MODE_DVD_RAM  = CDIO_DISC_MODE_DVD_RAM;
+%constant long int DISC_MODE_DVD_R  = CDIO_DISC_MODE_DVD_R;
+%constant long int DISC_MODE_DVD_RW  = CDIO_DISC_MODE_DVD_RW;
+%constant long int DISC_MODE_DVD_PR  = CDIO_DISC_MODE_DVD_PR;
+%constant long int DISC_MODE_DVD_PRW  = CDIO_DISC_MODE_DVD_PRW;
+%constant long int DISC_MODE_DVD_OTHER  = CDIO_DISC_MODE_DVD_OTHER;
+%constant long int DISC_MODE_NO_INFO  = CDIO_DISC_MODE_NO_INFO;
+%constant long int DISC_MODE_ERROR  = CDIO_DISC_MODE_ERROR;
+%constant long int DISC_MODE_CD_I = CDIO_DISC_MODE_CD_I;
+
+%rename cdio_get_disc_last_lsn get_disc_last_lsn;
+%feature("autodoc",
+"get_disc_last_lsn(cdio)->lsn
+Get the LSN of the end of the CD.
+
+perlcdio.INVALID_LSN is returned on error.");
+lsn_t cdio_get_disc_last_lsn(const CdIo_t *p_cdio);
+  
+
+%feature("autodoc",
+"get_disc_mode(p_cdio) -> str
+
+Get disc mode - the kind of CD (CD-DA, CD-ROM mode 1, CD-MIXED, etc.
+that we've got. The notion of 'CD' is extended a little to include
+DVD's.");
+const char *get_disc_mode (CdIo_t *p_cdio);
+
+%rename cdio_get_joliet_level get_joliet_level;
+%feature("autodoc",
+"get_joliet_level(cdio)->int
+
+Return the Joliet level recognized for cdio.
+This only makes sense for something that has an ISO-9660
+filesystem.");
+int cdio_get_joliet_level(const CdIo_t *p_cdio);
+
+/*!
+  Get the media catalog number (MCN) from the CD.
+  
+  @return the media catalog number or NULL if there is none or we
+  don't have the ability to get it.
+  
+  Note: string is malloc'd so caller has to free() the returned
+  string when done with it.
+  
+*/
+%rename cdio_get_mcn get_mcn;
+%newobject cdio_get_mcn; // free malloc'd return value
+char * cdio_get_mcn (const CdIo_t *p_cdio);
+
+%rename cdio_get_num_tracks get_num_tracks;
+%feature("autodoc",
+"get_num_tracks(p_cdio)->int
+
+Return the number of tracks on the CD. 
+On error rubycdio::INVALID_TRACK is returned.");
+track_t cdio_get_num_tracks (const CdIo_t *p_cdio);
+
+/*========================INLINE======================================*/
+
+%inline %{
+const char *
+get_disc_mode (CdIo_t *p_cdio) 
+{
+  discmode_t discmode = cdio_get_discmode(p_cdio);
+  if (CDIO_DISC_MODE_ERROR == discmode) return NULL;
+  return discmode2str[discmode];
+}
+
+%}

data/swig/read.swg

@@ -0,0 +1,164 @@
+/* -*- c -*-
+    $Id: read.swg,v 1.4 2006/11/29 01:43:28 rocky Exp $
+
+    Copyright (C) 2006 Rocky Bernstein <rocky@gnu.org>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+    02110-1301 USA.
+*/
+/* See <cdio/read.h> for more extensive documentation. */
+
+%constant long int READ_MODE_AUDIO = CDIO_READ_MODE_AUDIO;
+%constant long int READ_MODE_M1F1  = CDIO_READ_MODE_M1F1;
+%constant long int READ_MODE_M1F2  = CDIO_READ_MODE_M1F2;
+%constant long int READ_MODE_M2F1  = CDIO_READ_MODE_M2F1;
+%constant long int READ_MODE_M2F2  = CDIO_READ_MODE_M2F2;
+
+%inline %{
+typedef struct {
+  char *data;
+  size_t size;
+  driver_return_code_t drc;
+} Buf_triple_t;
+%}
+
+%rename cdio_lseek lseek;
+off_t cdio_lseek(const CdIo_t *p_cdio, off_t offset, int whence=SEEK_SET);
+
+%typemap(out) Buf_triple_t 
+{
+  if (!$1.data) 
+    return Qnil;
+  else {
+    VALUE data_triple = rb_ary_new();
+    rb_ary_push(data_triple, rb_str_new($1.data, $1.size)); 
+    rb_ary_push(data_triple, INT2NUM($1.size)); 
+    rb_ary_push(data_triple, INT2NUM($1.drc)); 
+    free($1.data);
+    return data_triple;
+  }
+  
+}
+
+Buf_triple_t read_cd(const CdIo_t *p_cdio, size_t i_size);
+
+%inline %{
+Buf_triple_t read_cd(const CdIo_t *p_cdio, size_t i_size)
+{
+  Buf_triple_t buf;
+  buf.data = calloc(1, i_size);
+  buf.size = cdio_read(p_cdio, buf.data, i_size);
+  if (buf.size == -1) {
+    free(buf.data);
+    buf.drc  = DRIVER_OP_ERROR;
+    buf.data = NULL;
+  }
+  return buf;
+}
+%}
+
+/* NOTE: arg 4 *must* be the size of the buf for the buf_t typemap. */
+Buf_triple_t read_sectors(const CdIo_t *p_cdio, lsn_t i_lsn, 
+		   cdio_read_mode_t read_mode, size_t i_size);
+%inline %{
+/* NOTE: arg 4 *must* be the size of the buf for the buf_t typemap. */
+Buf_triple_t
+read_sectors(const CdIo_t *p_cdio, lsn_t i_lsn, cdio_read_mode_t read_mode,
+	     size_t i_size)
+{
+  Buf_triple_t buf;
+  uint32_t i_blocks;
+  uint16_t i_blocksize;
+  switch (read_mode) {
+  case CDIO_READ_MODE_AUDIO: 
+    i_blocksize = CDIO_CD_FRAMESIZE_RAW;
+    break;
+  case CDIO_READ_MODE_M1F1: 
+    i_blocksize = M2RAW_SECTOR_SIZE;
+    break;
+  case CDIO_READ_MODE_M1F2: 
+    i_blocksize = M2RAW_SECTOR_SIZE;
+    break;
+  case CDIO_READ_MODE_M2F1: 
+    i_blocksize = CDIO_CD_FRAMESIZE;
+    break;
+  case CDIO_READ_MODE_M2F2: 
+    i_blocksize = M2F2_SECTOR_SIZE;
+    break;
+  default: 
+    buf.data = NULL;
+    buf.drc = DRIVER_OP_BAD_PARAMETER;
+    buf.size = -1;
+    return buf;
+  }
+  buf.data = calloc(1, i_size);
+  i_blocks = i_size / i_blocksize;
+  buf.drc = cdio_read_sectors(p_cdio, buf.data, i_lsn, read_mode, i_blocks);
+  if (buf.drc < 0) {
+    free(buf.data);
+    buf.data = NULL;
+    buf.size = -1;
+  } else {
+    buf.size = i_size;
+  }
+  return buf;
+  
+}
+ %}
+
+Buf_triple_t
+read_data_bytes(const CdIo_t *p_cdio, lsn_t i_lsn, int16_t i_blocksize,
+		size_t i_size);
+%inline %{
+Buf_triple_t
+read_data_bytes(const CdIo_t *p_cdio, lsn_t i_lsn, int16_t i_blocksize,
+		size_t i_size)
+  {
+    uint32_t i_blocks = i_size / i_blocksize;
+    Buf_triple_t buf;
+    
+    switch (i_blocksize) {
+    case CDIO_CD_FRAMESIZE:
+    case CDIO_CD_FRAMESIZE_RAW:
+    case M2F2_SECTOR_SIZE:
+    case M2RAW_SECTOR_SIZE:
+      break;
+    default:
+      /* Don't know about these block sizes */
+      buf.data = NULL;
+      buf.drc  = DRIVER_OP_BAD_PARAMETER;
+      buf.size = -1;
+      return buf;
+    }
+    buf.data = calloc(1, i_size);
+
+#if DEBUGGING
+  printf("p_cdio: %x, i_size: %d, lsn: %d, blocksize %d, blocks %d\n",
+	 p_cdio, i_size, i_lsn, i_blocksize, i_blocks);
+#endif
+  buf.drc = cdio_read_data_sectors (p_cdio, buf.data, i_lsn, 
+				 i_blocksize, i_blocks);
+#if DEBUGGING
+  printf("drc: %d\n", buf.drc);
+#endif
+  if (buf.drc < 0) {
+    buf.data = NULL;
+    buf.size = -1;
+  } else {
+    buf.size = i_size;
+  }
+  return buf;
+}
+%}

data/swig/rubycdio.swg

@@ -0,0 +1,86 @@
+/* -*- c -*-
+    $Id: rubycdio.swg,v 1.2 2006/11/13 21:44:31 rocky Exp $
+
+    Copyright (C) 2006 Rocky Bernstein <rocky@panix.com>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 2 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+    02110-1301 USA.
+*/
+%define DOCSTRING 
+"This is a wrapper for The CD Input and Control library (libcdio) which
+encapsulates CD-ROM reading and control. Python programs wishing to be
+oblivious of the OS- and device-dependent properties of a CD-ROM can
+use this library."
+%enddef
+%module(docstring=DOCSTRING) rubycdio
+%{
+/* Includes the header in the wrapper code */
+#include <cdio/cdio.h>
+#include <cdio/audio.h>
+#include <cdio/cd_types.h>
+%}
+
+#include <cdio/cdio.h> 
+#include <cdio/audio.h>
+
+%include "compat.swg"
+
+%include "typemaps.i"
+
+/* Various libcdio constants and typedefs */
+%include "types.swg"
+
+%feature("autodoc", 1);
+
+%include "audio.swg"
+%include "read.swg"
+%include "track.swg"
+
+/* In the presence of the exception handling, the order is important. 
+   The below use %exception.
+*/
+%include "device.swg"
+%include "disc.swg"
+
+/* Encapsulation is done in two parts. The lower-level python
+interface is called rubycdio and is generated by SWIG.
+
+The more object-oriented module is cdio; it is a Python class that
+uses rubycdio. Although rubycdio is perfectly usable on its own, it is
+expected that cdio is what most people will use. As rubycdio more
+closely models the C interface, it is conceivable (if unlikely) that
+diehard libcdio C users who are very familiar with that interface
+could prefer that.
+
+It is probably possible to change the SWIG in such a way to combine
+these pieces. However there are the problems. First, I'm not that much
+of a SWIG expert. Second it looks as though the resulting SWIG code
+would be more complex. Third the separation makes translation very
+straight forward to understand and maintain: first get what's in C
+into Python as a one-to-one translation. Then we implement some nice
+abstraction off of that. The abstraction can be modified without
+having to redo the underlying translation. (But the reverse is
+generally not true: usually changes to the C-to-python translation,
+rubycdio, do result in small, but obvious and straightforward changes to
+the abstraction layer cdio.)
+ */
+#define INCLUDE_CLASS 0
+#if INCLUDE_CLASS
+/* In spite of the above, if we were to do things as a one-step approach,
+   this might be how it would be done. */
+%rubycode %{
+%include "cdio.rb"
+%}
+#endif