^ jQddlmZddlZddlZddlmZddlmZmZm Z m Z m Z ddl m Z mZerddlmZddlmZddlmZdd lmZdd lmZGd d ZeGd dZGddZeGddZGddZGddeZGddeZGddeZ GddZ!dS)) annotationsN) dataclass) TYPE_CHECKINGBinaryIOListOptionalUnion)CannotSeekExceptionMediaException) AbstractImage) Animation) MediaEncoder) MediaEventPlayercBeZdZdZddZdd Zdd ZddZddZddZ dS) AudioFormataAudio details. An instance of this class is provided by sources with audio tracks. You should not modify the fields, as they are used internally to describe the format of data provided by the source. Args: channels (int): The number of channels: 1 for mono or 2 for stereo (pyglet does not yet support surround-sound sources). sample_size (int): Bits per sample; only 8 or 16 are supported. sample_rate (int): Samples per second (in Hertz). channelsint sample_size sample_ratereturnNonec||_||_||_|dz|z|_|j|z|_|j|_dS)N)rrrbytes_per_framebytes_per_secondbytes_per_sample)selfrrrs S/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/media/codecs/base.py__init__zAudioFormat.__init__ sR  &&!,q 0H< $ 4{ B $ 4  num_bytesc|||jzz S)zgAlign a given amount of bytes to the audio frame size of this audio format, downwards. rrr#s r alignzAudioFormat.align3sI(<<==r"c|| |jzzS)zeAlign a given amount of bytes to the audio frame size of this audio format, upwards. r%r&s r align_ceilzAudioFormat.align_ceil9sYJ)==>>r" timestampfloatcV|t||jzS)zGiven a timestamp, return the amount of bytes that an emitter with this audio format would have to have played to reach it, aligned to the audio frame size. )r'rrrr*s r timestamp_to_bytes_alignedz&AudioFormat.timestamp_to_bytes_aligned?s& zz#i$*??@@AAAr"otherobjectboolct|tr0|j|jko|j|jko|j|jkSt SN) isinstancerrrrNotImplemented)rr/s r __eq__zAudioFormat.__eq__FsS e[ ) ) ;MU^3:$(99:$(99 ;r"strcFd|jj|j|j|jfzS)Nz/%s(channels=%d, sample_size=%d, sample_rate=%d)) __class____name__rrrrs r __repr__zAudioFormat.__repr__Ms,@ N #T]D4D  D r"N)rrrrrrrr)r#rrr)r*r+rr)r/r0rr1)rr7) r: __module__ __qualname____doc__r!r'r)r.r6r<r"r rrs      &>>>> ???? BBBBr"rcDeZdZUdZded<ded<dZded<dZd ed <dS) VideoFormataVideo details. An instance of this class is provided by sources with a video stream. You should not modify the fields. Note that the sample aspect has no relation to the aspect ratio of the video image. For example, a video image of 640x480 with sample aspect 2.0 should be displayed at 1280x480. It is the responsibility of the application to perform this scaling. Args: width (int): Width of video image, in pixels. height (int): Height of video image, in pixels. sample_aspect (float): Aspect ratio (width over height) of a single video pixel. frame_rate (float): Frame rate (frames per second) of the video. .. versionadded:: 1.2 rwidthheightr+ sample_aspectNz float | None frame_rate)r:r=r>r?__annotations__rFrGr@r"r rBrBRsR&JJJKKKM#J######r"rBc&eZdZdZdZ dddZdS) AudioDataaA single packet of audio data. This class is used internally by pyglet. Args: data (bytes, ctypes array, or supporting buffer protocol): Sample data. length (int): Size of sample data, in bytes. timestamp (float): Time of the first sample, in seconds. duration (float): Total data duration, in seconds. events (List[:class:`pyglet.media.drivers.base.MediaEvent`]): List of events contained within this packet. Events are timestamped relative to this audio packet. .. deprecated:: 2.0.10 `timestamp` and `duration` are unused and will be removed eventually. )datadurationeventslengthpointerr*rENrKbytes | ctypes.ArrayrNrr*r+rLrMlist[MediaEvent] | Nonerrct|tr*tj|tjj|_nt|tjrtj||_nU tjtj ||_n#t$rtdwxYw||_ ||_ ||_||_|gn||_dS)NzUnsupported AudioData type.)r4bytesctypescastc_void_pvaluerOArray addressofc_int from_buffer TypeErrorrKrNr*rLrM)rrKrNr*rLrMs r r!zAudioData.__init__s dE " " ?";tV_==CDLL fl + + ?!+D11DLL ?%/ 0H0H0N0NOO  ? ? ? =>>> ?  "  "Nbb s 56B,,C)rErEN) rKrPrNrr*r+rLr+rMrQrr)r:r=r>r? __slots__r!r@r"r rJrJmsJ"OI %(#&37 7777777r"rJceZdZUdZdZded<dZded<dZded<dZded<dZ ded<d Z d ed <d Z d ed <dZ ded <dS) SourceInfoaSource metadata information. Fields are the empty string or zero if the information is not available. Args: title (str): Title author (str): Author copyright (str): Copyright statement comment (str): Comment album (str): Album name year (int): Year track (int): Track number genre (str): Genre .. versionadded:: 1.2 r7titleauthor copyrightcommentalbumrryeartrackgenreN) r:r=r>r?rarHrbrcrdrerfrgrhr@r"r r_r_s EOOOOFIGEOOOODMMMMENNNNEOOOOOOr"r_ceZdZUdZdZgZded<dZdZdZ dZ e d$dZ d%d Z d&d Zd'dZd(dZ d)d*dZd+dZd,dZd-dZd.d/d#ZdS)0SourceaAn audio and/or video source. Args: audio_format (:class:`.AudioFormat`): Format of the audio in this source, or ``None`` if the source is silent. video_format (:class:`.VideoFormat`): Format of the video in this source, or ``None`` if there is no video. info (:class:`.SourceInfo`): Source metadata such as title, artist, etc; or ``None`` if the` information is not available. .. versionadded:: 1.2 Attributes: is_player_source (bool): Determine if this source is a player current source. Check on a :py:class:`~pyglet.media.player.Player` if this source is the current source. NzList['Player']_playersFrr+c|jS)zfloat: The length of the source, in seconds. Not all source durations can be determined; in this case the value is ``None``. Read-only. ) _durationr;s r rLzSource.durations ~r"'Player'cddlm}||tjfd}|_S)zPlay the source. This is a convenience method which creates a Player for this source and plays it immediately. Returns: :class:`.Player` rrc|tjd_dSr3)rjrkremove on_player_eosdelete)playersr _on_player_eosz#Source.play.._on_player_eoss2 O " "6 * * *#'F MMOOOOOr")pyglet.media.playerrqueueplayrjrkappendrr)rrrurts @r rxz Source.plays /..... T v&&&      . r"r c$ddlm}m}|js |gSg}d}|}|R|}|&||z }|||||}|}|R||S)a Import all video frames into memory. An empty animation will be returned if the source has no video. Otherwise, the animation will contain all unplayed video frames (the entire source, if it has not been queued on a player). After creating the animation, the source will be at EOS (end of stream). This method is unsuitable for videos running longer than a few seconds. .. versionadded:: 1.1 Returns: :class:`pyglet.image.Animation` r)r AnimationFrame) pyglet.imager r{ video_formatget_next_video_timestampget_next_video_framery)rr r{frameslast_tsnext_tsimagedelays r get_animationzSource.get_animations ;:::::::  %9R== FG3355G%1133$#g-EMM..">">???%G7799 %9V$$ $r"Optional[float]cdS)zGet the timestamp of the next video frame. .. versionadded:: 1.1 Returns: float: The next timestamp, or ``None`` if there are no more video frames. Nr@r;s r r~zSource.get_next_video_timestamps  r"Optional['AbstractImage']cdS)aGet the next video frame. .. versionadded:: 1.1 Returns: :class:`pyglet.image.AbstractImage`: The next video frame image, or ``None`` if the video frame could not be decoded or there are no more video frames. Nr@r;s r rzSource.get_next_video_frame&s  r"filenamer7fileOptional[BinaryIO]encoderOptional['MediaEncoder']rc|r||||Sddl}|jjj|||S)aSave this Source to a file. :Parameters: `filename` : str Used to set the file format, and to open the output file if `file` is unspecified. `file` : file-like object or None File to write audio data to. `encoder` : MediaEncoder or None If unspecified, all encoders matching the filename extension are tried. If all fail, the exception from the first one attempted is raised. rN)encodepyglet.media.codecsmediacodecsregistry)rrrrpyglets r savez Source.save2sO$  M>>$$77 7 & & & &<&/66tXtLL Lr"r1cdS)abool: Whether this source is considered precise. ``x`` bytes on source ``s`` are considered aligned if ``x % s.audio_format.bytes_per_frame == 0``, so there'd be no partial audio frame in the returned data. A source is precise if - for an aligned request of ``x`` bytes - it returns:\ - If ``x`` or more bytes are available, ``x`` bytes. - If not enough bytes are available anymore, ``r`` bytes where ``r < x`` and ``r`` is aligned. A source is **not** precise if it does any of these: - Return less than ``x`` bytes for an aligned request of ``x`` bytes although data still remains so that an additional request would return additional :class:`.AudioData` / not ``None``. - Return more bytes than requested. - Return an unaligned amount of bytes for an aligned request. pyglet's internals are guaranteed to never make unaligned requests, or requests of less than 1024 bytes. If this method returns ``False``, pyglet will wrap the source in an alignment-forcing buffer creating additional overhead. If this method is overridden to return ``True`` although the source does not comply with the requirements above, audio playback may be negatively impacted at best and memory access violations occur at worst. :Returns: bool: Whether the source is precise. Fr@r;s r is_precisezSource.is_preciseLs Hur"r*ct)zSeek to given timestamp. Args: timestamp (float): Time where to seek in the source. The ``timestamp`` will be clamped to the duration of the source. )r r-s r seekz Source.seekrs"###r"'Source'c|S)zReturn the ``Source`` to be used as the queue source for a player. Default implementation returns ``self``. Returns: :class:`Source` r@r;s r get_queue_sourcezSource.get_queue_source{s  r"rEr#rOptional[AudioData]cdS)a7Get next packet of audio data. Args: num_bytes (int): A size hint for the amount of bytes to return, but the returned amount may be lower or higher. compensation_time (float): Time in sec to compensate due to a difference between the master clock and the audio clock. .. deprecated:: 2.0.10 compensation_time: Will always be given as ``0.0``. Returns: :class:`.AudioData`: Next packet of audio data, or ``None`` if there is no (more) data. Nr@rr#compensation_times r get_audio_datazSource.get_audio_datas tr")rr+)rrn)rr )rr)rr)NN)rr7rrrrrrrr1r*r+rr)rrrE)r#rrr)r:r=r>r?rmrkrH audio_formatr}infois_player_sourcepropertyrLrxrr~rrrrrrr@r"r rjrjs8(I!H!!!!LL D X0%%%%B          )-15MMMMM4$$$$L$$$$r"rjc,eZdZdZdfd ZddZxZS) StreamingSourcezA source that is decoded as it is being played. The source can only be played once at a time on any :class:`~pyglet.media.player.Player`. r'StreamingSource'c~|jrtdd|_tS)zReturn the ``Source`` to be used as the source for a player. Default implementation returns self. Returns: :class:`.Source` z*This source is already queued on a player.T)rr superr)rr9s r rz StreamingSource.get_queue_sources>   O !MNN N $ww'')))r"rcdS)z3Release the resources held by this StreamingSource.Nr@r;s r rszStreamingSource.deletes r")rrrr)r:r=r>r?rrs __classcell__)r9s@r rrs[ * * * * * *        r"rc,eZdZdZddZddZdddZdS) StaticSourceaEA source that has been completely decoded in memory. This source can be queued onto multiple players any number of times. Construct a :py:class:`~pyglet.media.StaticSource` for the data in ``source``. Args: source (Source): The source to read and decode audio and video data from. sourcerjrrc|}|jrtd|j|_|jd|_d|_dSd}t j} ||}|n| |j 3| |_t|j|jj z |_dS)Nz'Static sources not supported for video.rEi)rr}NotImplementedErrorr_datarmioBytesIOrwriterKgetvaluelenr)rr buffer_sizerK audio_datas r r!zStaticSource.__init__s((**   Q%&OPP P"/   $DJ DN F z|| (..{;;J! JJz ' ' '  ( ]]__ TZ4+<+MMr"Optional['StaticMemorySource']cH|jt|j|jSdSr3)rStaticMemorySourcerr;s r rzStaticSource.get_queue_sources$ : !%dj$2CDD Dtr"rEr#r+rrc td)a+The StaticSource does not provide audio data. When the StaticSource is queued on a :class:`~pyglet.media.player.Player`, it creates a :class:`.StaticMemorySource` containing its internal audio data and audio format. Raises: RuntimeError zStaticSource cannot be queued.) RuntimeErrorrs r rzStaticSource.get_audio_datas;<<r?r!rrr@r"r rrsc  NNNN4 = = = = = = =r"rc4eZdZdZddZddZdd ZdddZdS)ra Helper class for default implementation of :class:`.StaticSource`. Do not use directly. This class is used internally by pyglet. Args: data (readable buffer): The audio data. audio_format (AudioFormat): The audio format. rrrrctj||_t||_||_t|t |jz |_dS)z5Construct a memory source over the given data buffer.N) rr_filer _max_offsetrr+rrm)rrKrs r r!zStaticMemorySource.__init__sJZ%% t99(TU<+H%I%IIr"r1cdS)NTr@r;s r rzStaticMemorySource.is_precisestr"r*r+ct||jjz}|j|j|dS)zqSeek to given timestamp. Args: timestamp (float): Time where to seek in the source. N)rrrrrr')rr*offsets r rzStaticMemorySource.seeksG Y!2!CCDD )//7788888r"rEr#rrc|j}|j|}|sdSt||jjz }t ||jjz }t|t |||S)aGet next packet of audio data. Args: num_bytes (int): Maximum number of bytes of data to return. Returns: :class:`.AudioData`: Next packet of audio data, or ``None`` if there is no (more) data. N)rtellreadr+rrrrJ)rr#r offset_beforerKr*rLs r rz!StaticMemorySource.get_audio_data s} )) zy)) 4-((4+<+MM t99t0AAs4yy)X>>>r"N)rrrrrrrr)r:r=r>r?r!rrrr@r"r rrswJJJJ9999???????r"rcTeZdZdZddZddZdd Zdd Zdd ZddZ ddZ dddZ dS) SourceGroupzGroup of like sources to allow gapless playback. Seamlessly read data from a group of sources to allow for gapless playback. All sources must share the same audio format. The first source added sets the format. rrcvd|_d|_d|_d|_d|_g|_g|_d|_dS)NrEF)rr}rrL_timestamp_offset_dequeued_durations_sourcesrr;s r r!zSourceGroup.__init__'sE    !$#%  %r"r1cdS)NFr@r;s r rzSourceGroup.is_precise1sur"timer+cX|jr"|jd|dSdSNr)rr)rrs r rzSourceGroup.seek4s7 = ( M!  ! !$ ' ' ' ' ' ( (r"rrjc |jp|j|_|jp|j|_|}|j|jks Jd|j||xj|jz c_dS)Nz)Sources must share the same audio format.)rrrrryrL)rrs r addzSourceGroup.add8s -D1DI, ((**#t'8888;f888 V$$$ ( r"c2t|jdkS)N)rrr;s r has_nextzSourceGroup.has_next@s4=!!A%%r" 'SourceGroup'c|Sr3r@r;s r rzSourceGroup.get_queue_sourceCs r"cb|jr|xj|jdjz c_|jd|jdj|jd}|xj|jzc_t |tr|dSdSdSr) rrrLrinsertpopr4rrs)r old_sources r _advancezSourceGroup._advanceFs = $  " "dmA&6&? ? " "  $ + +At}Q/?/H I I I**1--J MMZ0 0MM*o66 $!!##### $ $  $ $r"rEr#rcp|jsdSd}d}d}t||krv|jro|jd|}|r||jz }||jz }||jz }n|t||kr|jot|t|||S)zGet next audio packet. :Parameters: `num_bytes` : int Hint for preferred size of audio packet; may be ignored. :rtype: `AudioData` :return: Audio data, or None if there is no more data. Nr"rEr)rrrrKrLrrrJ)rr#rbufferrLr* audiodatas r rzSourceGroup.get_audio_dataPs} 4 &kkI%%$-% a(77 BBI ).(I..T33  &kkI%%$-%ViBBBr"Nrr)rr+rrr)rrr)r#r+rr) r:r=r>r?r!rrrrrrrr@r"r rrs&&&&(((())))&&&&$$$$CCCCCCCr"r)" __future__rrTr dataclassesrtypingrrrrr pyglet.media.exceptionsr r r|r pyglet.image.animationr rrpyglet.media.drivers.baserrvrrrBrJr_rjrrrrr@r"r rs"""""" !!!!!!AAAAAAAAAAAAAAGGGGGGGG+******000000000000444444******>>>>>>>>@ $$$$$$$ $4.7.7.7.7.7.7.7.7b  6[[[[[[[[|     f   27=7=7=7=7=67=7=7=t1?1?1?1?1?1?1?1?hLCLCLCLCLCLCLCLCLCLCr"