Spec-Zone.ru › Pygame
pygame.cdrom
pygame модуль для управления аудио CD-ROM

Предупреждение

Этот модуль не работает в pygame 2.0 и выше, если вы не скомпилировали pygame вручную с SDL1. Этот модуль в будущем не будет поддерживаться. Альтернативой для работы с CD-ROM в Python является pycdio.

Модуль cdrom управляет CD и DVD приводами на компьютере. Он также может управлять воспроизведением аудио-CD. Этот модуль должен быть инициализирован перед выполнением любых действий. Каждый объект CD , который вы создаёте, представляет привод CD-ROM и также должен быть инициализирован индивидуально, прежде чем он сможет выполнить большинство операций.

pygame.cdrom.init()
инициализация модуля cdrom
init() -> None

Инициализирует модуль cdrom. Это позволит сканировать систему на предмет всех CD устройств. Модуль должен быть инициализирован, прежде чем какие-либо другие функции будут работать. Это происходит автоматически при вызове pygame.init().

Вызов этой функции более одного раза безопасен.

pygame.cdrom.quit()
деинциализация модуля cdrom
quit() -> None

Деинициализирует модуль cdrom. После вызова этой функции любые существующие объекты CD больше не будут работать.

Вызов этой функции более одного раза безопасен.

pygame.cdrom.get_init()
истина, если модуль cdrom инициализирован
get_init() -> bool

Проверяет, инициализирован ли модуль cdrom или нет. Это отличается от CD.init(), так как каждый привод также должен быть инициализирован индивидуально.

pygame.cdrom.get_count()
количество приводов CD на системе
get_count() -> count

Возвращает количество приводов CD на системе. При создании объектов CD, вам необходимо передать целочисленный идентификатор, который должен быть меньше этого значения. Значение будет равно 0, если на системе нет приводов.

pygame.cdrom.CD
класс для управления приводом CD-ROM
CD(id) -> CD

Вы можете создать объект CD для каждого привода CD-ROM в системе. Используйте pygame.cdrom.get_count() для определения количества существующих приводов. Аргумент id — целое число, представляющее номер привода, начиная с нуля.

Объект CD не инициализирован, вы можете только вызвать CD.get_id() и CD.get_name() на неинициализированном приводе.

Безопасно создавать несколько объектов CD для одного и того же привода, они будут нормально взаимодействовать.

init()
инициализировать привод CD-ROM для использования
init() -> None

Инициализирует привод CD-ROM для использования. Привод должен быть инициализирован, чтобы большинство методов CD работали. Даже если остальная часть pygame была инициализирована.

Возможно краткое ожидание во время инициализации привода. Избегайте CD.init() , если программа не должна останавливаться на секунду или две.

quit()
деинициализировать привод CD-ROM для использования
quit() -> None

Деинициализировать привод для использования. Вызывайте эту функцию, когда ваша программа не будет обращаться к приводу в течение некоторого времени.

get_init()
истина, если это устройство CD инициализировано
get_init() -> bool

Проверить, инициализировано ли это устройство CDROM. Это отличается от pygame.cdrom.init(), поскольку каждый привод также должен быть инициализирован индивидуально.

play()
начать воспроизведение аудио
play(track, start=None, end=None) -> None

Воспроизведение аудио с аудио CD-ROM в приводе. Помимо номера трека, вы также можете указать начальное и конечное время воспроизведения. Начальное и конечное время в секундах и могут ограничить воспроизводимый фрагмент аудио трека.

Если вы передаёте начальное время, но не конечное, аудио будет воспроизводиться до конца трека. Если вы передаёте начальное время и 'None' для конечного времени, аудио будет воспроизводиться до конца всего диска.

См. CD.get_numtracks() и CD.get_track_audio() для поиска треков для воспроизведения.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.

stop()
остановить воспроизведение аудио
stop() -> None

Останавливает воспроизведение аудио с CD-ROM. При этом текущая позиция воспроизведения будет утеряна. Этот метод ничего не делает, если привод не воспроизводит аудио.

pause()
временно остановить воспроизведение аудио
pause() -> None

Временно остановить воспроизведение аудио на CD. Воспроизведение может быть возобновлено в той же точке с помощью метода CD.resume(). Если CD не воспроизводит, этот метод ничего не делает.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.

resume()
восстановить воспроизведение аудио
resume() -> None

Возобновить прерванное воспроизведение CD. Если CD не приостановлен или уже воспроизводится, этот метод ничего не делает.

eject()
извлечь или открыть привод CD-ROM
eject() -> None

Это откроет привод CD-ROM и извлечёт CD-ROM. Если привод воспроизводит или приостановлен, он будет остановлен.

get_id()
индекс привода CD-ROM
get_id() -> id

Возвращает целочисленный идентификатор, который использовался для создания экземпляра CD. Этот метод может работать с неинициализированным CD.

get_name()
системное имя привода CD-ROM
get_name() -> name

Возвращает строковое имя привода. Это системное имя, используемое для представления привода. Часто это буква привода или имя устройства. Этот метод может работать с неинициализированным CD.

get_busy()
истина, если привод воспроизводит аудио
get_busy() -> bool

Возвращает True, если привод занят воспроизведением аудио.

get_paused()
истина, если привод приостановлен
get_paused() -> bool

Возвращает True, если привод в данный момент приостановлен.

get_current()
текущая позиция воспроизведения аудио
get_current() -> track, seconds

Возвращает текущий трек и время этого трека. Этот метод работает, когда привод воспроизводит или приостановлен.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.

get_empty()
Ложь, если в приводе есть CD-ROM
get_empty() -> bool

Возвращает False, если в приводе в данный момент есть CD-ROM. Если привод пустой, возвращает True.

get_numtracks()
количество треков на CD-ROM
get_numtracks() -> count

Возвращает количество треков на CD-ROM в приводе. Возвращает ноль, если привод пустой или не содержит треков.

get_track_audio()
истина, если трек CD-ROM содержит аудиоданные
get_track_audio(track) -> bool

Определяет, содержит ли трек на CD-ROM аудиоданные. Вы также можете вызвать CD.num_tracks() и CD.get_all() для получения дополнительной информации о CD-ROM.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.

get_all()
получить всю информацию о треках
get_all() -> [(audio, start, end, length), ...]

Возвращает список с информацией о каждом треке на CD-ROM. Информация состоит из кортежа со четырьмя значениями. Значение audio — True, если трек содержит аудиоданные. Значения start, end и length — числа с плавающей точкой в секундах. Start и end представляют абсолютные временные метки на всём диске.

get_track_start()
начальное время трека CD-ROM
get_track_start(track) -> seconds

Возвращает абсолютное время в секундах, где начинается трек CD-ROM.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.

get_track_length()
длина трека CD-ROM
get_track_length(track) -> seconds

Возвращает значение с плавающей точкой в секундах, представляющее длину трека CD-ROM.

Обратите внимание, трек 0 — первый трек на CD. Номера треков начинаются с нуля.




Редактировать на GitHub

© Pygame Developers.
Licensed under the GNU LGPL License version 2.1.
https://www.pygame.org/docs/ref/cdrom.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API