pycapcut 0.0.1__py3-none-any.whl

pyJianYingDraft/__init__.py

@@ -0,0 +1,276 @@
+import warnings
+import sys
+
+from .local_materials import CropSettings, VideoMaterial, AudioMaterial
+from .keyframe import KeyframeProperty
+
+from .time_util import Timerange
+from .audio_segment import AudioSegment
+from .video_segment import VideoSegment, StickerSegment, ClipSettings
+from .effect_segment import EffectSegment, FilterSegment
+from .text_segment import TextSegment, TextStyle, TextBorder, TextBackground
+
+from .metadata import FontType
+from .metadata import MaskType
+from .metadata import TransitionType, FilterType
+from .metadata import IntroType, OutroType, GroupAnimationType
+from .metadata import TextIntro, TextOutro, TextLoopAnim
+from .metadata import AudioSceneEffectType
+from .metadata import VideoSceneEffectType, VideoCharacterEffectType
+
+from .track import TrackType
+from .template_mode import ShrinkMode, ExtendMode
+from .script_file import ScriptFile
+from .draft_folder import DraftFolder
+
+# 仅在Windows系统下导入jianying_controller
+ISWIN = (sys.platform == 'win32')
+if ISWIN:
+    from .jianying_controller import JianyingController, ExportResolution, ExportFramerate
+
+from .time_util import SEC, tim, trange
+
+
+def _deprecated_class_warning(old_name: str, new_name: str):
+    warnings.warn(
+        f"{old_name} is deprecated and will be removed in a future version. "
+        f"Use {new_name} instead.",
+        DeprecationWarning,
+        stacklevel=3
+    )
+
+# 保持向后兼容
+class Script_file:
+    """Deprecated: Use ScriptFile instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Script_file", "ScriptFile")
+        return ScriptFile(*args, **kwargs)
+
+class Draft_folder:
+    """Deprecated: Use DraftFolder instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Draft_folder", "DraftFolder")
+        return DraftFolder(*args, **kwargs)
+
+class Shrink_mode:
+    """Deprecated: Use ShrinkMode instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Shrink_mode", "ShrinkMode")
+        return ShrinkMode(*args, **kwargs)
+
+class Extend_mode:
+    """Deprecated: Use ExtendMode instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Extend_mode", "ExtendMode")
+        return ExtendMode(*args, **kwargs)
+
+class Clip_settings:
+    """Deprecated: Use ClipSettings instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Clip_settings", "ClipSettings")
+        return ClipSettings(*args, **kwargs)
+
+class Text_style:
+    """Deprecated: Use TextStyle instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Text_style", "TextStyle")
+        return TextStyle(*args, **kwargs)
+
+class Text_border:
+    """Deprecated: Use TextBorder instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Text_border", "TextBorder")
+        return TextBorder(*args, **kwargs)
+
+class Text_background:
+    """Deprecated: Use TextBackground instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Text_background", "TextBackground")
+        return TextBackground(*args, **kwargs)
+
+class Text_segment:
+    """Deprecated: Use TextSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Text_segment", "TextSegment")
+        return TextSegment(*args, **kwargs)
+
+class Audio_segment:
+    """Deprecated: Use AudioSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Audio_segment", "AudioSegment")
+        return AudioSegment(*args, **kwargs)
+
+class Video_segment:
+    """Deprecated: Use VideoSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Video_segment", "VideoSegment")
+        return VideoSegment(*args, **kwargs)
+
+class Sticker_segment:
+    """Deprecated: Use StickerSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Sticker_segment", "StickerSegment")
+        return StickerSegment(*args, **kwargs)
+
+class Effect_segment:
+    """Deprecated: Use EffectSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Effect_segment", "EffectSegment")
+        return EffectSegment(*args, **kwargs)
+
+class Filter_segment:
+    """Deprecated: Use FilterSegment instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Filter_segment", "FilterSegment")
+        return FilterSegment(*args, **kwargs)
+
+class Video_material:
+    """Deprecated: Use VideoMaterial instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Video_material", "VideoMaterial")
+        return VideoMaterial(*args, **kwargs)
+
+class Audio_material:
+    """Deprecated: Use AudioMaterial instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Audio_material", "AudioMaterial")
+        return AudioMaterial(*args, **kwargs)
+
+class Crop_settings:
+    """Deprecated: Use CropSettings instead."""
+    def __new__(cls, *args, **kwargs):
+        _deprecated_class_warning("Crop_settings", "CropSettings")
+        return CropSettings(*args, **kwargs)
+
+# 枚举类的向后兼容 - 使用代理类
+class _DeprecatedEnum:
+    """带deprecation警告的枚举代理类"""
+    def __init__(self, original_enum, old_name, new_name):
+        self._enum = original_enum
+        self._old_name = old_name
+        self._new_name = new_name
+
+    def __getattr__(self, name):
+        # 当访问枚举成员时显示警告
+        _deprecated_class_warning(self._old_name, self._new_name)
+        return getattr(self._enum, name)
+
+    def __getitem__(self, name):
+        # 当通过索引访问时显示警告
+        _deprecated_class_warning(self._old_name, self._new_name)
+        return self._enum[name]
+
+    def __repr__(self):
+        return f"<Deprecated {self._old_name} (use {self._new_name} instead)>"
+
+Track_type = _DeprecatedEnum(TrackType, "Track_type", "TrackType")
+Font_type = _DeprecatedEnum(FontType, "Font_type", "FontType")
+Mask_type = _DeprecatedEnum(MaskType, "Mask_type", "MaskType")
+Filter_type = _DeprecatedEnum(FilterType, "Filter_type", "FilterType")
+Transition_type = _DeprecatedEnum(TransitionType, "Transition_type", "TransitionType")
+Intro_type = _DeprecatedEnum(IntroType, "Intro_type", "IntroType")
+Outro_type = _DeprecatedEnum(OutroType, "Outro_type", "OutroType")
+Group_animation_type = _DeprecatedEnum(GroupAnimationType, "Group_animation_type", "GroupAnimationType")
+Text_intro = _DeprecatedEnum(TextIntro, "Text_intro", "TextIntro")
+Text_outro = _DeprecatedEnum(TextOutro, "Text_outro", "TextOutro")
+Text_loop_anim = _DeprecatedEnum(TextLoopAnim, "Text_loop_anim", "TextLoopAnim")
+Audio_scene_effect_type = _DeprecatedEnum(AudioSceneEffectType, "Audio_scene_effect_type", "AudioSceneEffectType")
+Video_scene_effect_type = _DeprecatedEnum(VideoSceneEffectType, "Video_scene_effect_type", "VideoSceneEffectType")
+Video_character_effect_type = _DeprecatedEnum(VideoCharacterEffectType, "Video_character_effect_type", "VideoCharacterEffectType")
+Keyframe_property = _DeprecatedEnum(KeyframeProperty, "Keyframe_property", "KeyframeProperty")
+
+# 仅在Windows系统下定义jianying_controller相关的向后兼容类
+if ISWIN:
+    class Jianying_controller:
+        """Deprecated: Use JianyingController instead."""
+        def __new__(cls, *args, **kwargs):
+            _deprecated_class_warning("Jianying_controller", "JianyingController")
+            return JianyingController(*args, **kwargs)
+
+    Export_resolution = _DeprecatedEnum(ExportResolution, "Export_resolution", "ExportResolution")
+    Export_framerate = _DeprecatedEnum(ExportFramerate, "Export_framerate", "ExportFramerate")
+
+# 基础__all__列表（所有平台通用）
+__all__ = [
+    "FontType",
+    "MaskType",
+    "FilterType",
+    "TransitionType",
+    "IntroType",
+    "OutroType",
+    "GroupAnimationType",
+    "TextIntro",
+    "TextOutro",
+    "TextLoopAnim",
+    "AudioSceneEffectType",
+    "VideoSceneEffectType",
+    "VideoCharacterEffectType",
+    "CropSettings",
+    "VideoMaterial",
+    "AudioMaterial",
+    "KeyframeProperty",
+    "Timerange",
+    "AudioSegment",
+    "VideoSegment",
+    "StickerSegment",
+    "ClipSettings",
+    "EffectSegment",
+    "FilterSegment",
+    "TextSegment",
+    "TextStyle",
+    "TextBorder",
+    "TextBackground",
+    "TrackType",
+    "ShrinkMode",
+    "ExtendMode",
+    "ScriptFile",
+    "DraftFolder",
+    "SEC",
+    "tim",
+    "trange",
+
+    # 向后兼容的snake_case类
+    "Script_file",
+    "Draft_folder",
+    "Shrink_mode",
+    "Extend_mode",
+    "Track_type",
+    "Font_type",
+    "Mask_type",
+    "Filter_type",
+    "Transition_type",
+    "Intro_type",
+    "Outro_type",
+    "Group_animation_type",
+    "Text_intro",
+    "Text_outro",
+    "Text_loop_anim",
+    "Audio_scene_effect_type",
+    "Video_scene_effect_type",
+    "Video_character_effect_type",
+    "Clip_settings",
+    "Text_style",
+    "Text_border",
+    "Text_background",
+    "Text_segment",
+    "Audio_segment",
+    "Video_segment",
+    "Sticker_segment",
+    "Effect_segment",
+    "Filter_segment",
+    "Video_material",
+    "Audio_material",
+    "Crop_settings",
+    "Keyframe_property",
+]
+
+# 仅在Windows系统下添加jianying_controller相关的导出
+if ISWIN:
+    __all__.extend([
+        "JianyingController",
+        "ExportResolution",
+        "ExportFramerate",
+        "Jianying_controller",
+        "Export_resolution",
+        "Export_framerate",
+    ])

pyJianYingDraft/animation.py

@@ -0,0 +1,140 @@
+"""定义视频/文本动画相关类"""
+
+import uuid
+
+from typing import Union, Optional
+from typing import Literal, Dict, List, Any
+
+from .time_util import Timerange
+
+from .metadata import AnimationMeta
+from .metadata import IntroType, OutroType, GroupAnimationType
+from .metadata import TextIntro, TextOutro, TextLoopAnim
+
+class Animation:
+    """一个视频/文本动画效果"""
+
+    name: str
+    """动画名称, 默认取为动画效果的名称"""
+    effect_id: str
+    """另一种动画id, 由剪映本身提供"""
+    animation_type: str
+    """动画类型, 在子类中定义"""
+    resource_id: str
+    """资源id, 由剪映本身提供"""
+
+    start: int
+    """动画相对此片段开头的偏移, 单位为微秒"""
+    duration: int
+    """动画持续时间, 单位为微秒"""
+
+    is_video_animation: bool
+    """是否为视频动画, 在子类中定义"""
+
+    def __init__(self, animation_meta: AnimationMeta, start: int, duration: int):
+        self.name = animation_meta.title
+        self.effect_id = animation_meta.effect_id
+        self.resource_id = animation_meta.resource_id
+
+        self.start = start
+        self.duration = duration
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            "anim_adjust_params": None,
+            "platform": "all",
+            "panel": "video" if self.is_video_animation else "",
+            "material_type": "video" if self.is_video_animation else "sticker",
+
+            "name": self.name,
+            "id": self.effect_id,
+            "type": self.animation_type,
+            "resource_id": self.resource_id,
+
+            "start": self.start,
+            "duration": self.duration,
+            # 不导出path和request_id
+        }
+
+class VideoAnimation(Animation):
+    """一个视频动画效果"""
+
+    animation_type: Literal["in", "out", "group"]
+
+    def __init__(self, animation_type: Union[IntroType, OutroType, GroupAnimationType],
+                 start: int, duration: int):
+        super().__init__(animation_type.value, start, duration)
+
+        if isinstance(animation_type, IntroType):
+            self.animation_type = "in"
+        elif isinstance(animation_type, OutroType):
+            self.animation_type = "out"
+        elif isinstance(animation_type, GroupAnimationType):
+            self.animation_type = "group"
+
+        self.is_video_animation = True
+
+class Text_animation(Animation):
+    """一个文本动画效果"""
+
+    animation_type: Literal["in", "out", "loop"]
+
+    def __init__(self, animation_type: Union[TextIntro, TextOutro, TextLoopAnim],
+                 start: int, duration: int):
+        super().__init__(animation_type.value, start, duration)
+
+        if isinstance(animation_type, TextIntro):
+            self.animation_type = "in"
+        elif isinstance(animation_type, TextOutro):
+            self.animation_type = "out"
+        elif isinstance(animation_type, TextLoopAnim):
+            self.animation_type = "loop"
+
+        self.is_video_animation = False
+
+class SegmentAnimations:
+    """附加于某素材上的一系列动画
+
+    对视频片段：入场、出场或组合动画；对文本片段：入场、出场或循环动画"""
+
+    animation_id: str
+    """系列动画的全局id, 自动生成"""
+
+    animations: List[Animation]
+    """动画列表"""
+
+    def __init__(self):
+        self.animation_id = uuid.uuid4().hex
+        self.animations = []
+
+    def get_animation_trange(self, animation_type: Literal["in", "out", "group", "loop"]) -> Optional[Timerange]:
+        """获取指定类型的动画的时间范围"""
+        for animation in self.animations:
+            if animation.animation_type == animation_type:
+                return Timerange(animation.start, animation.duration)
+        return None
+
+    def add_animation(self, animation: Union[VideoAnimation, Text_animation]) -> None:
+        # 不允许添加超过一个同类型的动画（如两个入场动画）
+        if animation.animation_type in [ani.animation_type for ani in self.animations]:
+            raise ValueError(f"当前片段已存在类型为 '{animation.animation_type}' 的动画")
+
+        if isinstance(animation, VideoAnimation):
+            # 不允许组合动画与出入场动画同时出现
+            if any(ani.animation_type == "group" for ani in self.animations):
+                raise ValueError("当前片段已存在组合动画, 此时不能添加其它动画")
+            if animation.animation_type == "group" and len(self.animations) > 0:
+                raise ValueError("当前片段已存在动画时, 不能添加组合动画")
+        elif isinstance(animation, Text_animation):
+            if any(ani.animation_type == "loop" for ani in self.animations):
+                raise ValueError("当前片段已存在循环动画, 若希望同时使用循环动画和入出场动画, 请先添加出入场动画再添加循环动画")
+
+        self.animations.append(animation)
+
+    def export_json(self) -> Dict[str, Any]:
+        return {
+            "id": self.animation_id,
+            "type": "sticker_animation",
+            "multi_language_current": "none",
+            "animations": [animation.export_json() for animation in self.animations]
+        }

pyJianYingDraft/assets/__init__.py

@@ -0,0 +1,45 @@
+"""
+pyJianYingDraft 的资源管理模块，提供集中管理资源文件的方式，避免硬编码路径
+"""
+
+from pathlib import Path
+
+# 获取当前模块所在目录
+ASSETS_DIR = Path(__file__).parent
+
+# 资源文件映射表 - 集中管理所有asset文件名
+ASSET_FILES = {
+    # 模板文件
+    'DRAFT_CONTENT_TEMPLATE': 'draft_content_template.json',
+    'DRAFT_META_TEMPLATE': 'draft_meta_info.json',
+}
+
+def get_asset_path(asset_name: str) -> Path:
+    """
+    获取指定资源文件的完整路径
+
+    Args:
+        asset_name: 资源名称（ASSET_FILES中的key）
+
+    Returns:
+        Path: 资源文件的完整路径
+
+    Raises:
+        KeyError: 资源名称不存在
+        FileNotFoundError: 文件不存在
+    """
+    if asset_name not in ASSET_FILES:
+        raise KeyError(f"Asset '{asset_name}' not found. Available assets: {list(ASSET_FILES.keys())}")
+
+    file_path = ASSETS_DIR / ASSET_FILES[asset_name]
+
+    if not file_path.exists():
+        raise FileNotFoundError(f"Asset file '{file_path}' does not exist")
+
+    return file_path
+
+# 导出主要接口
+__all__ = [
+    'get_asset_path',
+    'ASSET_FILES'
+]

pyJianYingDraft/assets/draft_content_template.json

@@ -0,0 +1,125 @@
+{
+    "canvas_config": {
+        "height": 1080,
+        "ratio": "original",
+        "width": 1920
+    },
+    "color_space": 0,
+    "config": {
+        "adjust_max_index": 1,
+        "attachment_info": [],
+        "combination_max_index": 1,
+        "export_range": null,
+        "extract_audio_last_index": 1,
+        "lyrics_recognition_id": "",
+        "lyrics_sync": true,
+        "lyrics_taskinfo": [],
+        "maintrack_adsorb": true,
+        "material_save_mode": 0,
+        "multi_language_current": "none",
+        "multi_language_list": [],
+        "multi_language_main": "none",
+        "multi_language_mode": "none",
+        "original_sound_last_index": 1,
+        "record_audio_last_index": 1,
+        "sticker_max_index": 1,
+        "subtitle_keywords_config": null,
+        "subtitle_recognition_id": "",
+        "subtitle_sync": true,
+        "subtitle_taskinfo": [],
+        "system_font_list": [],
+        "video_mute": false,
+        "zoom_info_params": null
+    },
+    "cover": null,
+    "create_time": 0,
+    "duration": 0,
+    "extra_info": null,
+    "fps": 30.0,
+    "free_render_index_mode_on": false,
+    "group_container": null,
+    "id": "91E08AC5-22FB-47e2-9AA0-7DC300FAEA2B",
+    "keyframe_graph_list": [],
+    "keyframes": {
+        "adjusts": [],
+        "audios": [],
+        "effects": [],
+        "filters": [],
+        "handwrites": [],
+        "stickers": [],
+        "texts": [],
+        "videos": []
+    },
+    "last_modified_platform": {
+        "app_id": 3704,
+        "app_source": "lv",
+        "app_version": "5.9.0",
+        "os": "windows"
+    },
+    "platform": {
+        "app_id": 3704,
+        "app_source": "lv",
+        "app_version": "5.9.0",
+        "os": "windows"
+    },
+    "materials": {
+        "ai_translates": [],
+        "audio_balances": [],
+        "audio_effects": [],
+        "audio_fades": [],
+        "audio_track_indexes": [],
+        "audios": [],
+        "beats": [],
+        "canvases": [],
+        "chromas": [],
+        "color_curves": [],
+        "digital_humans": [],
+        "drafts": [],
+        "effects": [],
+        "flowers": [],
+        "green_screens": [],
+        "handwrites": [],
+        "hsl": [],
+        "images": [],
+        "log_color_wheels": [],
+        "loudnesses": [],
+        "manual_deformations": [],
+        "masks": [],
+        "material_animations": [],
+        "material_colors": [],
+        "multi_language_refs": [],
+        "placeholders": [],
+        "plugin_effects": [],
+        "primary_color_wheels": [],
+        "realtime_denoises": [],
+        "shapes": [],
+        "smart_crops": [],
+        "smart_relights": [],
+        "sound_channel_mappings": [],
+        "speeds": [],
+        "stickers": [],
+        "tail_leaders": [],
+        "text_templates": [],
+        "texts": [],
+        "time_marks": [],
+        "transitions": [],
+        "video_effects": [],
+        "video_trackings": [],
+        "videos": [],
+        "vocal_beautifys": [],
+        "vocal_separations": []
+    },
+    "mutable_config": null,
+    "name": "",
+    "new_version": "110.0.0",
+    "relationships": [],
+    "render_index_track_mode_on": false,
+    "retouch_cover": null,
+    "source": "default",
+    "static_cover_image_path": "",
+    "time_marks": null,
+    "tracks": [
+    ],
+    "update_time": 0,
+    "version": 360000
+}

pyJianYingDraft/assets/draft_meta_info.json

@@ -0,0 +1,67 @@
+{
+	"cloud_package_completed_time": "",
+	"draft_cloud_capcut_purchase_info": "",
+	"draft_cloud_last_action_download": false,
+	"draft_cloud_materials": [],
+	"draft_cloud_purchase_info": "",
+	"draft_cloud_template_id": "",
+	"draft_cloud_tutorial_info": "",
+	"draft_cloud_videocut_purchase_info": "",
+	"draft_cover": "",
+	"draft_deeplink_url": "",
+	"draft_enterprise_info": {
+		"draft_enterprise_extra": "",
+		"draft_enterprise_id": "",
+		"draft_enterprise_name": "",
+		"enterprise_material": []
+	},
+	"draft_fold_path": "",
+	"draft_id": "BC69C7CD-7C5E-4185-B284-AF3E1047A664",
+	"draft_is_ai_packaging_used": false,
+	"draft_is_ai_shorts": false,
+	"draft_is_ai_translate": false,
+	"draft_is_article_video_draft": false,
+	"draft_is_from_deeplink": "false",
+	"draft_is_invisible": false,
+	"draft_materials": [
+		{
+			"type": 0,
+			"value": []
+		},
+		{
+			"type": 1,
+			"value": []
+		},
+		{
+			"type": 2,
+			"value": []
+		},
+		{
+			"type": 3,
+			"value": []
+		},
+		{
+			"type": 6,
+			"value": []
+		},
+		{
+			"type": 7,
+			"value": []
+		},
+		{
+			"type": 8,
+			"value": []
+		}
+	],
+	"draft_materials_copied_info": [],
+	"draft_name": "",
+	"draft_new_version": "",
+	"draft_removable_storage_device": "",
+	"draft_root_path": "",
+	"draft_segment_extra_info": [],
+	"draft_type": "",
+	"tm_draft_cloud_completed": "",
+	"tm_draft_cloud_modified": 0,
+	"tm_draft_removed": 0,
+	"tm_duration": 0
+}