PyCriCodecsEx 0.0.4__cp312-cp312-win32.whl → 0.0.5__cp312-cp312-win32.whl

PyCriCodecsEx/__init__.py

@@ -1 +1 @@
-__version__ = "0.0.4"
+__version__ = "0.0.5"

PyCriCodecsEx/acb.py

@@ -188,10 +188,17 @@ class ACB(UTF):
         """Returns the AWB object associated with the ACB."""
         return AWB(self.view.AwbFile)
 
-    def get_waveforms(self) -> List[HCACodec | ADXCodec | Tuple[AcbEncodeTypes, int, int, int,  bytes]]:
+    def get_waveforms(self, **kwargs) -> List[HCACodec | ADXCodec | Tuple[AcbEncodeTypes, int, int, int,  bytes]]:
         """Returns a list of decoded waveforms.
 
         Item may be a codec (if known), or a tuple of (Codec ID, Channel Count, Sample Count, Sample Rate, Raw data).
+
+        Additional keyword arguments are passed to the codec constructors. e.g. for encrypted HCA payloads,
+        you may do the following:
+        ```python
+        get_waveforms(key=..., subkey=...)
+        ```
+        See also the respective docs (ADXCodec, HCACodec) for more details.
         """
         CODEC_TABLE = {
             AcbEncodeTypes.ADX: ADXCodec,
@@ -204,7 +211,7 @@ class ACB(UTF):
             encode = AcbEncodeTypes(wav.EncodeType)
             codec = (CODEC_TABLE.get(encode, None))
             if codec:
-                wavs.append(codec(awb.get_file_at(wav.MemoryAwbId)))
+                wavs.append(codec(awb.get_file_at(wav.MemoryAwbId), **kwargs))
             else:
                 wavs.append((encode, wav.NumChannels, wav.NumSamples, wav.SamplingRate, awb.get_file_at(wav.MemoryAwbId)))
         return wavs
@@ -214,7 +221,7 @@ class ACB(UTF):
 
         Input item may be a codec (if known), or a tuple of (Codec ID, Channel Count, Sample Count, Sample Rate, Raw data).
 
-        NOTE: Cue duration is not set. You need to change that manually.
+        NOTE: Cue duration is not set. You need to change that manually - this is usually unecessary as the player will just play until the end of the waveform.
         """
         WAVEFORM = self.view.WaveformTable[0]._payload.copy()
         encoded = []

PyCriCodecsEx/adx.py

@@ -57,7 +57,7 @@ class ADXCodec(ADX):
 
         Args:
             stream (str | bytes): Path to the ADX or WAV file, or a BinaryIO stream. WAV files will be automatically encoded with the given settings first.
-            filename (str, optional): Output filename. Defaults to "default.adx".
+            filename (str, optional): Filename, used by USMBuilder. Defaults to "default.adx".
             bitdepth (int, optional): Audio bit depth within [2,15]. Defaults to 4.
         """
         if type(stream) == str:

PyCriCodecsEx/hca.py

@@ -332,7 +332,7 @@ class HCACodec(HCA):
 
         Args:
             stream (str | bytes): Path to the HCA or WAV file, or a BinaryIO stream. WAV files will be automatically encoded with the given settings first.
-            filename (str, optional): USM filename. Defaults to "default.hca".
+            filename (str, optional): Filename, used by USMBuilder. Defaults to "default.hca".
             quality (CriHcaQuality, optional): Encoding quality. Defaults to CriHcaQuality.High.
             key (int, optional): HCA key. Defaults to 0.
             subkey (int, optional): HCA subkey. Defaults to 0.

PyCriCodecsEx/usm.py

@@ -13,11 +13,7 @@ except ImportError:
 import tempfile
 
 # Big thanks and credit for k0lb3 and 9th helping me write this specific code.
-# Also credit for the original C++ code from Nyagamon/bnnm.
-
-# Apparently there is an older USM format called SofDec? This is for SofDec2 though.
-# Extraction working only for now, although check https://github.com/donmai-me/WannaCRI/
-# code for a complete breakdown of the USM format.
+# Also credit for the original C++ code from Nyagamon/bnnm and https://github.com/donmai-me/WannaCRI/
 
 class USMCrypt:
     """USM related crypto functions"""

{pycricodecsex-0.0.4.dist-info → pycricodecsex-0.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: PyCriCodecsEx
-Version: 0.0.4
+Version: 0.0.5
 Summary: Criware formats library for Python
 Home-page: https://mos9527.github.io/PyCriCodecsEx/
 Classifier: Programming Language :: Python :: 3

pycricodecsex-0.0.5.dist-info/RECORD

@@ -0,0 +1,15 @@
+CriCodecsEx.cp312-win32.pyd,sha256=TmLC8PrEbJC24pGWvKOnq2CCFaFAiqGZTBo2Zwin5fk,68608
+PyCriCodecsEx/__init__.py,sha256=vucW-Fe97d2P_nl7TMRJ2Cp458lb7VTRk6EckM_ozdM,23
+PyCriCodecsEx/acb.py,sha256=_YpxIsdWW9vgz0KefKkb8zFnc2WKUwSTDqtgYaPDKp0,11956
+PyCriCodecsEx/adx.py,sha256=LHr1YjVv6W0yzm1ZIGw54bM7rDW-Qozci0_GS8J4CrE,6130
+PyCriCodecsEx/awb.py,sha256=SCTkKvn855bpr1I8Kq24P1es89I2unJaEGgDw7hg1Do,6395
+PyCriCodecsEx/chunk.py,sha256=xmc92tONmXpdbOW2g-KckTeppTXFo8Km0J95UYbbvQg,2810
+PyCriCodecsEx/cpk.py,sha256=er_eBLMG8eiXUvYp0h_lDWLN8Vx8CCDJ8COE9B5Rv_A,38125
+PyCriCodecsEx/hca.py,sha256=TokIvd8IENZXxBw_3Na_o6vAoKvC8m_ooWIQ4qhmUqk,19603
+PyCriCodecsEx/usm.py,sha256=Z6ETFy98Gl0KFot9zRE7Qg8_Dv9wsFUFybZgFvVXT_U,37173
+PyCriCodecsEx/utf.py,sha256=0LBzpIbJiyL_4KOf_QpEJytr3PbHj8_M4Bd-Lay4wuk,28247
+pycricodecsex-0.0.5.dist-info/licenses/LICENSE,sha256=B47Qr_82CmMyuL-wNFAH_P6PNJWaonv5dxo9MfgjEXw,1083
+pycricodecsex-0.0.5.dist-info/METADATA,sha256=h3K2wCbl1h3WyL5-7AU6dFeW9hIxKcR3_FlFnf7KJWc,1291
+pycricodecsex-0.0.5.dist-info/WHEEL,sha256=LwxTQZ0gyDP_uaeNCLm-ZIktY9hv6x0e22Q-hgFd-po,97
+pycricodecsex-0.0.5.dist-info/top_level.txt,sha256=mSrrEse9hT0s6nl-sWAQWAhNRuZ6jo98pbFoN3L2MXk,26
+pycricodecsex-0.0.5.dist-info/RECORD,,

pycricodecsex-0.0.4.dist-info/RECORD

@@ -1,15 +0,0 @@
-CriCodecsEx.cp312-win32.pyd,sha256=uE4Um0q6GskE_qqeVmr726oCNrpo5cSK_zyItAcgHmg,68096
-PyCriCodecsEx/__init__.py,sha256=b8Tfyn46wV92NWm_uziWVxCW3zTxPV8EyFKcI9HhXcA,23
-PyCriCodecsEx/acb.py,sha256=7eKR_pxn7gqhFONRUsdrIdHczxqJUnfRrVEe4vA6pFM,11549
-PyCriCodecsEx/adx.py,sha256=HvYyRTjOWXnV9kY0qzxTW3YRB-4m35czxDd-RjEhG1c,6117
-PyCriCodecsEx/awb.py,sha256=SCTkKvn855bpr1I8Kq24P1es89I2unJaEGgDw7hg1Do,6395
-PyCriCodecsEx/chunk.py,sha256=xmc92tONmXpdbOW2g-KckTeppTXFo8Km0J95UYbbvQg,2810
-PyCriCodecsEx/cpk.py,sha256=er_eBLMG8eiXUvYp0h_lDWLN8Vx8CCDJ8COE9B5Rv_A,38125
-PyCriCodecsEx/hca.py,sha256=9GgAOS-mkd4pdXAF5YX0hzKt7nI7_LE5dZT5I--5Tbo,19587
-PyCriCodecsEx/usm.py,sha256=MQg229op95pGw46bvdXjwDBOdwZqlEXOc2SWGggLivU,37361
-PyCriCodecsEx/utf.py,sha256=0LBzpIbJiyL_4KOf_QpEJytr3PbHj8_M4Bd-Lay4wuk,28247
-pycricodecsex-0.0.4.dist-info/licenses/LICENSE,sha256=B47Qr_82CmMyuL-wNFAH_P6PNJWaonv5dxo9MfgjEXw,1083
-pycricodecsex-0.0.4.dist-info/METADATA,sha256=gGvEr_w5BQsqBT68VHnsnqoz2sPkCPqU1IqQy4Xk92E,1291
-pycricodecsex-0.0.4.dist-info/WHEEL,sha256=LwxTQZ0gyDP_uaeNCLm-ZIktY9hv6x0e22Q-hgFd-po,97
-pycricodecsex-0.0.4.dist-info/top_level.txt,sha256=mSrrEse9hT0s6nl-sWAQWAhNRuZ6jo98pbFoN3L2MXk,26
-pycricodecsex-0.0.4.dist-info/RECORD,,