Metadata-Version: 2.1
Name: dvfile
Version: 0.0.3
Summary: Read deepvocal dv file
Home-page: https://gitee.com/oxygendioxide/dvfile
Author: oxygen dioxide
Author-email: 1463567152@qq.com
License: Apache
Description: 
        # dvfile-python
        
        #### 介绍
        
        解析[deepvocal](https://www.deep-vocal.com/) dv文件的python库。
        
        本python库依赖numpy utaufile mido
        
        由于dv文件为二进制文件，且没有官方文档或解析器，本项目无法保证与deepvocal完美兼容，如遇到文件解析错误欢迎在issue中提出。
        
        #### 安装
        
        > pip install dvfile
        
        #### 功能
        
        - 解析dv文件
        - 导出为ust、midi文件
        - 批量获取歌词
        
        目前可以解析的内容：
        
        - 曲速标记：位置、曲速
        - 节拍标记：位置、每小节拍数、音符分数
        - 音轨属性：音轨名、音轨音量、独奏、静音
        - 区段属性：区段名、区段音源名、起点、长度
        - 音符属性：起点、长度、音高、歌词汉字、歌词拼音、滑音(弯曲深度、弯曲长度、头部滑音长度、尾部滑音长度)、颤音(颤音幅度、颤音速度、渲染出的颤音曲线)
        - 伴奏音轨：音轨名、音轨音量、独奏、静音、文件名、起点
        
        目前不能解析的内容：
        
        - 音轨属性：双声道平衡
        - 区段参数：音量、音调、气声、声线
        - 音符属性：音素、颤音长度
        
        #### 示例
        
        ```py
        import dvfile as df
        
        #打开dv文件
        d=df.opendv("myproject.dv")
        
        #导出为mid文件
        d.to_midi_file().save("myproject.mid")
        
        #每个音轨单独导出为ust文件
        for (i,t) in enumerate(d.track):
            t.to_ust_file().save('myproject{}.ust'.format(i))
        
        #获取第0音轨第0区段的歌词（拼音与汉字）列表
        tr=d.track[0]
        seg=tr.segment[0]
        pinyin=seg.getlyric()
        hanzi=seg.getlyric(use_hanzi=True)
        
        #将第0音轨的所有区段合并
        tr.segment=[sum(tr.segment)]
        ```
        
        #### 参与贡献
        
        1.  Fork 本仓库
        2.  新建 Feat_xxx 分支
        3.  提交代码
        4.  新建 Pull Request
        
        #### 相关链接
        
        [deepvocal官网](https://www.deep-vocal.com/)
        
        [sharpkey（deepvocal前身）视频教程](https://www.bilibili.com/video/BV1Us411r7u5)
        
        [deepvocal toolbox 文档](https://share.weiyun.com/5snXMol)
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
