##### pygame documentation

Pygame Home || Help Contents || Reference Index

Most useful stuff: Color

Advanced stuff: cursors | BufferProxy

Other: camera

`pygame.cdrom`
  pygame module for audio cdrom control

  Advertencia

  Este módulo no es funcional en pygame 2.0 y versiones superiores, a menos que hayas compilado manualmente pygame con SDL1. Este módulo no estará soportado en el futuro. Una alternativa para la funcionalidad de cdrom de Python es pycdio.

  El módulo cdrom administra las unidades de `CD` y `DVD` en la computadora. También puede controlar la reproducción de CD de audio. Este módulo debe inicializarse antes de poder hacer algo. Cada objeto ``CD``que crees representa una unidad de cdrom y también debe inicializarse individualmente antes de poder realizar la mayoría de las acciones.

  pygame.cdrom.init()
    initialize the cdrom module
    init() -> None

    Inicializa el módulo de cdrom. Esto escaneará el sistema en busca de todos los dispositivos `CD`. El módulo debe inicializarse antes de que funcionen cualquier otra función. Esto ocurre automáticamente cuando llamas `pygame.init()`.

    Es seguro llamar a este función más de una vez.

  pygame.cdrom.quit()
    uninitialize the cdrom module
    quit() -> None

    Decinicializa el módulo cdrom. Después de llamar a esta función, cualquier objeto `CD` existente dejará de funcionar.

    Es seguro llamar a esta función más de una vez.

  pygame.cdrom.get_init()
    true if the cdrom module is initialized
    get_init() -> bool

    Comprueba si el módulo cdrom está inicializado o no. Esto es diferente de `CD.init()` ya que cada unidad también debe inicializarse individualmente.

  pygame.cdrom.get_count()
    number of cd drives on the system
    get_count() -> count

    Devuelve el número de unidades de CD en el sistema. Cuando creas objetos `CD`, debes pasar un ID entero que debe ser menor que este recuento. El recuento será 0 si no hay unidades en el sistema.

  pygame.cdrom.CD
    class to manage a cdrom drive
    CD(id) -> CD

    Podés crear un objeto `CD` para cada unidad de CD en el sistema. Usa `pygame.cdrom.get_count()` para determinar cuántas unidades existen realmente. El argumento 'id' es un número entero que representa la unidad, comenzando en cero.

    El objeto `CD` no está inicializado, solo podés llamar `CD.get_id()` y ``CD.get_name()` en una unidad no inicializada.

    Es seguro crear múltiples objetos ``CD``para la misma unidad, todos cooperarán normalmente.

    init()
      initialize a cdrom drive for use
      init() -> None

      Inicializa la unidad de CD para ser utilizada. El debe estar inicializada para que la mayoría de los métodos `CD` funcionen. Incluso si el resto de pygame está inicializado.

      Puede haber una breve pausa mientras la unidad se inicializa. Evitá utilizar `CD.init()` si el programa no debe detenerse durante uno o dos segundos.

    quit()
      uninitialize a cdrom drive for use
      quit() -> None

      Desinicializa una unidad para su uso. Hacé un llamado a esto cuando tu programa no vaya a acceder a la unidad durante un tiempo.

    get_init()
      true if this cd device initialized
      get_init() -> bool

      Comprueba si este dispositivo `CDROM` está inicializado. Esto es diferente de `pygame.cdrom.init()` ya que cada unidad también debe inicializarse individualmente.

    play()
      start playing audio
      play(track, start=None, end=None) -> None

      Reproduce audio desde un CD de audio en la unidad. Además del argumento del número de pista, también podés introducir un tiempo de inicio y fin para la reproducción. El tiempo de inicio y fin está en segundos y puede limintar la selección de una pista de audio reproducida.

      Si introducir un tiempo de inicio pero no de fin, el audio se reproducirá hasta el final de la pista. Si introducis un tiempo de inicio y 'None' para el tiempo final, el audio se reproducirá hasta el final de todo el disco.

      Véase `CD.get_numtracks()` y `CD.get_track_audio()` para encontrar las pistas que se van a reproducir.

      Nota: la pista 0 es la primera pista en el `CD`. Los números de pistas comienzan en 0.

    stop()
      stop audio playback
      stop() -> None

      Detiene la reproducción del audio desde el CD-ROM. También se perderá la posición actual de reproducción. Este método no hace nada si la unidad no está reproduciendo audio.

    pause()
      temporarily stop audio playback
      pause() -> None

      Detiene temporalmente la reproducción del audio en el `CD`. La reproducción puede reanudarse en el mismo punto con el método `CD.resume()`. Si el `CD` no está reproduciendo, este método no hace nada.

      Nota: la pista 0 es la primera en el `CD`. Los números de pista comienzan en cero.

    resume()
      unpause audio playback
      resume() -> None

      Reanuda la reproducción de un `CD`. Si el `CD` no está en pausa o ya se está reproduciendo, este método no hace nada.

    eject()
      eject or open the cdrom drive
      eject() -> None

      Esto abrirá la unidad de CD y expulsará el CD-ROM. Si la unidad está reproduciendo o en pausa, se detendrá.

    get_id()
      the index of the cdrom drive
      get_id() -> id

      Devuelve el ID entero que se utilizó para crear la instancia de `CD`. Este método puede funcionar en un `CD` no inicializado.

    get_name()
      the system name of the cdrom drive
      get_name() -> name

      Devuelve el nombre de la unidad en forma de cadena. Este es el nombre de sitema utilizado para representar la unidad, a menudo es la letra de la unidad o el nombre del dispositivo. Este método puede funcionar en un `CD` no inicializado.

    get_busy()
      true if the drive is playing audio
      get_busy() -> bool

      Devuelve True (verdadero) si la unidad está ocupada reproduciendo audio.

    get_paused()
      true if the drive is paused
      get_paused() -> bool

      Devuelve True (verdadero) si la unidad está actualmente en pausa.

    get_current()
      the current audio playback position
      get_current() -> track, seconds

      Devuelve tanto la pista actual como el tiempo de esa pista. Este método funciona cuando la unidad está reproduciendo o en pausa.

      Nota: la pista 0 es la primera pista en el `CD`. Los números de pista comienzan en cero.

    get_empty()
      False if a cdrom is in the drive
      get_empty() -> bool

      Devuelve False (falso) si hay un CD-ROM en la unidad actualmente. Si la unidad está vacía devolverá True (verdadero).

    get_numtracks()
      the number of tracks on the cdrom
      get_numtracks() -> count

      Devuelve el número de pistas en el CD-ROM de la unidad. Esto devolverá cero si la unidad está vacía o no tiene pistas.

    get_track_audio()
      true if the cdrom track has audio data
      get_track_audio(track) -> bool

      Determina si una pista en un CD-ROM contiene datos de audio. También podés llamar a `CD.num_tracks()` y `CD.get_all()` para obtener más información sobre el CD-ROM.

      Nota: la pista 0 es la primera pista en el `CD`. Los números de pistas comienzan en cero.

    get_all()
      get all track information
      get_all() -> [(audio, start, end, length), ...]

      Devuelve una lista con información para cada pista en el CD-ROM. La información consiste en una tupla con cuatro valores. El valor "audio" es True (verdadero) si la pista contiene data de audio. Los valores de inicio, fin y longitud son números de puntos flotantes en segundos. "Start" (inicio) y "end" (fin) representan tiempos absolutos en todo el disco.

    get_track_start()
      start time of a cdrom track
      get_track_start(track) -> seconds

      Devuelve el tiempo absoluto en segundos al inicio de la pista del CD-ROM.

      Nota: la pista 0 es la primera pista del `CD`. Los números de pista comienzan en cero.

    get_track_length()
      length of a cdrom track
      get_track_length(track) -> seconds

      Devuelve un valor de punto flotante en segundos de la duración de la pista del CD-ROM.

      Nota: la pista 0 es la primera pista del `CD`. Los números de pista comienzan en cero.

Edit on GitHub