libaudiofile/loop.c

   1 /*
   2         Audio File Library
   3         Copyright (C) 1998-2000, Michael Pruett <michael@68k.org>
   4         Copyright (C) 2000, Silicon Graphics, Inc.
   5
   6         This library is free software; you can redistribute it and/or
   7         modify it under the terms of the GNU Library General Public
   8         License as published by the Free Software Foundation; either
   9         version 2 of the License, or (at your option) any later version.
  10
  11         This library is distributed in the hope that it will be useful,
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14         Library General Public License for more details.
  15
  16         You should have received a copy of the GNU Library General Public
  17         License along with this library; if not, write to the
  18         Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19         Boston, MA  02111-1307  USA.
  20 */
  21
  22 /*
  23         loop.c
  24
  25         All routines that operate on loops.
  26 */
  27
  28 #ifdef HAVE_CONFIG_H
  29 #include <config.h>
  30 #endif
  31
  32 #include "audiofile.h"
  33 #include "afinternal.h"
  34 #include "util.h"
  35 #include "setup.h"
  36 #include "instrument.h"
  37
  38 void afInitLoopIDs (AFfilesetup setup, int instid, int *loopids, int nloops)
  39 {
  40         int instno;
  41
  42         if (!_af_filesetup_ok(setup))
  43                 return;
  44
  45         if (!_af_unique_ids(loopids, nloops, "loop", AF_BAD_LOOPID))
  46                 return;
  47
  48         if ((instno = _af_setup_instrument_index_from_id(setup, instid)) == -1)
  49                 return;
  50
  51         _af_setup_free_loops(setup, instno);
  52
  53         setup->instruments[instno].loopCount = nloops;
  54         setup->instruments[instno].loopSet = true;
  55
  56         if (nloops == 0)
  57                 setup->instruments[instno].loops = NULL;
  58         else
  59         {
  60                 int i;
  61
  62                 if ((setup->instruments[instno].loops = _af_calloc(nloops, sizeof (_LoopSetup))) == NULL)
  63                         return;
  64
  65                 for (i=0; i < nloops; i++)
  66                         setup->instruments[instno].loops[i].id = loopids[i];
  67         }
  68 }
  69
  70 int afGetLoopIDs (AFfilehandle file, int instid, int *loopids)
  71 {
  72         int instno;
  73         int i;
  74
  75         if (!_af_filehandle_ok(file))
  76                 return AF_FAIL;
  77
  78         if ((instno = _af_handle_instrument_index_from_id(file, instid)) == -1)
  79                 return AF_FAIL;
  80
  81         if (loopids)
  82                 for (i=0; i < file->instruments[instno].loopCount; i++)
  83                         loopids[i] = file->instruments[instno].loops[i].id;
  84
  85         return file->instruments[instno].loopCount;
  86 }
  87
  88 int _af_handle_loop_index_from_id (AFfilehandle file, int instno, int loopid)
  89 {
  90         int     i;
  91         for (i=0; i<file->instruments[instno].loopCount; i++)
  92                 if (file->instruments[instno].loops[i].id == loopid)
  93                         return i;
  94
  95         _af_error(AF_BAD_LOOPID, "no loop with id %d for instrument %d",
  96                 loopid, file->instruments[instno].id);
  97
  98         return -1;
  99 }
 100
 101 /*
 102         getLoop returns pointer to requested loop if it exists, and if
 103         mustWrite is true, only if handle is writable.
 104 */
 105
 106 static _Loop *getLoop (AFfilehandle handle, int instid, int loopid,
 107         bool mustWrite)
 108 {
 109         int     loopno, instno;
 110
 111         if (!_af_filehandle_ok(handle))
 112                 return NULL;
 113
 114         if (mustWrite && !_af_filehandle_can_write(handle))
 115                 return NULL;
 116
 117         if ((instno = _af_handle_instrument_index_from_id(handle, instid)) == -1)
 118                 return NULL;
 119
 120         if ((loopno = _af_handle_loop_index_from_id(handle, instno, loopid)) == -1)
 121                 return NULL;
 122
 123         return &handle->instruments[instno].loops[loopno];
 124 }
 125
 126 /*
 127         Set loop mode (as in AF_LOOP_MODE_...).
 128 */
 129 void afSetLoopMode (AFfilehandle file, int instid, int loopid, int mode)
 130 {
 131         _Loop   *loop = getLoop(file, instid, loopid, true);
 132
 133         if (!loop)
 134                 return;
 135
 136         if (mode != AF_LOOP_MODE_NOLOOP &&
 137                 mode != AF_LOOP_MODE_FORW &&
 138                 mode != AF_LOOP_MODE_FORWBAKW)
 139         {
 140                 _af_error(AF_BAD_LOOPMODE, "unrecognized loop mode %d", mode);
 141                 return;
 142         }
 143
 144         loop->mode = mode;
 145 }
 146
 147 /*
 148         Get loop mode (as in AF_LOOP_MODE_...).
 149 */
 150 int afGetLoopMode (AFfilehandle file, int instid, int loopid)
 151 {
 152         _Loop   *loop = getLoop(file, instid, loopid, false);
 153
 154         if (loop == NULL)
 155                 return -1;
 156
 157         return loop->mode;
 158 }
 159
 160 /*
 161         Set loop count.
 162 */
 163 int afSetLoopCount (AFfilehandle file, int instid, int loopid, int count)
 164 {
 165         _Loop   *loop = getLoop(file, instid, loopid, true);
 166
 167         if (loop == NULL)
 168                 return AF_FAIL;
 169
 170         if (count < 1)
 171         {
 172                 _af_error(AF_BAD_LOOPCOUNT, "invalid loop count: %d", count);
 173                 return AF_FAIL;
 174         }
 175
 176         loop->count = count;
 177         return AF_SUCCEED;
 178 }
 179
 180 /*
 181         Get loop count.
 182 */
 183 int afGetLoopCount(AFfilehandle file, int instid, int loopid)
 184 {
 185         _Loop   *loop = getLoop(file, instid, loopid, false);
 186
 187         if (loop == NULL)
 188                 return -1;
 189
 190         return loop->count;
 191 }
 192
 193 /*
 194         Set loop start marker id in the file structure
 195 */
 196 void
 197 afSetLoopStart(AFfilehandle file, int instid, int loopid, int markid)
 198 {
 199         _Loop   *loop = getLoop(file, instid, loopid, true);
 200
 201         if (!loop)
 202                 return;
 203
 204         loop->beginMarker = markid;
 205 }
 206
 207 /*
 208         Get loop start marker id.
 209 */
 210 int afGetLoopStart (AFfilehandle file, int instid, int loopid)
 211 {
 212         _Loop   *loop = getLoop(file, instid, loopid, false);
 213
 214         if (loop == NULL)
 215                 return -1;
 216
 217         return loop->beginMarker;
 218 }
 219
 220 /*
 221         Set loop start frame in the file structure.
 222 */
 223 int afSetLoopStartFrame (AFfilehandle file, int instid, int loopid, AFframecount startFrame)
 224 {
 225         int     trackid, beginMarker;
 226         _Loop   *loop = getLoop(file, instid, loopid, true);
 227
 228         if (loop == NULL)
 229                 return -1;
 230
 231         if (startFrame < 0)
 232         {
 233                 _af_error(AF_BAD_FRAME, "loop start frame must not be negative");
 234                 return AF_FAIL;
 235         }
 236
 237         trackid = loop->trackid;
 238         beginMarker = loop->beginMarker;
 239
 240         afSetMarkPosition(file, trackid, beginMarker, startFrame);
 241         return AF_SUCCEED;
 242 }
 243
 244 /*
 245         Get loop start frame.
 246 */
 247 AFframecount afGetLoopStartFrame (AFfilehandle file, int instid, int loopid)
 248 {
 249         int     trackid, beginMarker;
 250         _Loop   *loop = getLoop(file, instid, loopid, false);
 251
 252         if (loop == NULL)
 253                 return -1;
 254
 255         trackid = loop->trackid;
 256         beginMarker = loop->beginMarker;
 257
 258         return afGetMarkPosition(file, trackid, beginMarker);
 259 }
 260
 261 /*
 262         Set loop track id.
 263 */
 264 void afSetLoopTrack (AFfilehandle file, int instid, int loopid, int track)
 265 {
 266         _Loop *loop = getLoop(file, instid, loopid, true);
 267
 268         if (!loop) return;
 269
 270         loop->trackid = track;
 271 }
 272
 273 /*
 274         Get loop track.
 275 */
 276 int afGetLoopTrack (AFfilehandle file, int instid, int loopid)
 277 {
 278         _Loop   *loop = getLoop(file, instid, loopid, false);
 279
 280         if (loop == NULL)
 281                 return -1;
 282
 283         return loop->trackid;
 284 }
 285
 286 /*
 287         Set loop end frame marker id.
 288 */
 289 void afSetLoopEnd (AFfilehandle file, int instid, int loopid, int markid)
 290 {
 291         _Loop   *loop = getLoop(file, instid, loopid, true);
 292
 293         if (!loop)
 294                 return;
 295
 296         loop->endMarker = markid;
 297 }
 298
 299 /*
 300         Get loop end frame marker id.
 301 */
 302 int afGetLoopEnd (AFfilehandle file, int instid, int loopid)
 303 {
 304         _Loop   *loop = getLoop(file, instid, loopid, false);
 305
 306         if (loop == NULL)
 307                 return -1;
 308
 309         return loop->endMarker;
 310 }
 311
 312 /*
 313         Set loop end frame.
 314 */
 315 int afSetLoopEndFrame (AFfilehandle file, int instid, int loopid, AFframecount endFrame)
 316 {
 317         int     trackid, endMarker;
 318         _Loop   *loop = getLoop(file, instid, loopid, true);
 319
 320         if (loop == NULL)
 321                 return -1;
 322
 323         if (endFrame < 0)
 324         {
 325                 _af_error(AF_BAD_FRAME, "loop end frame must not be negative");
 326                 return AF_FAIL;
 327         }
 328
 329         trackid = loop->trackid;
 330         endMarker = loop->endMarker;
 331
 332         afSetMarkPosition(file, trackid, endMarker, endFrame);
 333         return AF_SUCCEED;
 334 }
 335
 336 /*
 337         Get loop end frame.
 338 */
 339
 340 AFframecount afGetLoopEndFrame (AFfilehandle file, int instid, int loopid)
 341 {
 342         int     trackid, endMarker;
 343         _Loop   *loop = getLoop(file, instid, loopid, false);
 344
 345         if (loop == NULL)
 346                 return -1;
 347
 348         trackid = loop->trackid;
 349         endMarker = loop->endMarker;
 350
 351         return afGetMarkPosition(file, trackid, endMarker);
 352 }