Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

SDL_CDOpen (3)

Name

SDL_CDOpen - ROM drive for access.

Synopsis

#include "SDL.h"

SDL_CD *SDL_CDOpen(int drive);

Description

SDL_CDOpen(3)                  SDL API Reference                 SDL_CDOpen(3)



NAME
       SDL_CDOpen - Opens a CD-ROM drive for access.

SYNOPSIS
       #include "SDL.h"

       SDL_CD *SDL_CDOpen(int drive);

DESCRIPTION
       Opens  a CD-ROM drive for access. It returns a SDL_CD structure on suc-
       cess, or NULL if the drive was invalid or busy. This newly  opened  CD-
       ROM  becomes  the  default CD used when other CD functions are passed a
       NULL CD-ROM handle.

       Drives are numbered starting with 0. Drive 0 is the system default  CD-
       ROM.

EXAMPLES
       SDL_CD *cdrom;
       int cur_track;
       int min, sec, frame;
       SDL_Init(SDL_INIT_CDROM);
       atexit(SDL_Quit);

       /* Check for CD drives */
       if(!SDL_CDNumDrives()){
         /* None found */
         fprintf(stderr, "No CDROM devices available
       ");
         exit(-1);
       }

       /* Open the default drive */
       cdrom=SDL_CDOpen(0);

       /* Did if open? Check if cdrom is NULL */
       if(!cdrom){
         fprintf(stderr, "Couldn't open drive: %s
       ", SDL_GetError());
         exit(-1);
       }

       /* Print Volume info */
       printf("Name: %s
       ", SDL_CDName(0));
       printf("Tracks: %d
       ", cdrom->numtracks);
       for(cur_track=0;cur_track < cdrom->numtracks; cur_track++){
         FRAMES_TO_MSF(cdrom->track[cur_track].length, &min, &sec, &frame);
         printf("     Track %d: Length %d:%d
       ", cur_track, min, sec);
       }

       SDL_CDClose(cdrom);

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/sdl      |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+
SEE ALSO
       SDL_CD, SDL_CDtrack, SDL_CDClose



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source        was        downloaded        from        https://www.lib-
       sdl.org/release/SDL-1.2.15.tar.gz

       Further information about this software can be found on the open source
       community website at https://www.libsdl.org/.



SDL                         Tue 11 Sep 2001, 22:58               SDL_CDOpen(3)