vibephysics 0.1.0__py3-none-any.whl

vibephysics/__init__.py

@@ -0,0 +1,84 @@
+"""
+VibePhysics - Physics Simulation and Annotation Tools for Blender
+
+A Python library for creating physics-based simulations in Blender,
+with support for water dynamics, rigid body physics, robot animation,
+and comprehensive annotation tools.
+
+Usage:
+    from vibephysics import foundation, annotation
+    
+    # Or import specific modules
+    from vibephysics.foundation import scene, physics, water
+    from vibephysics.annotation import AnnotationManager
+
+Note: This package requires Blender 5.0's Python environment (bpy).
+Run scripts through Blender:
+    blender -b -P your_script.py
+"""
+
+__version__ = "0.1.0"
+__author__ = "Your Name"
+
+# Check if running inside Blender
+def _check_blender_environment():
+    """Check if bpy is available and provide helpful error if not."""
+    try:
+        import bpy
+        return True
+    except ImportError:
+        import sys
+        
+        error_message = """
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                     VibePhysics - Blender 5.0 Required                       ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  This package requires Blender 5.0's Python environment (bpy module).        ║
+║                                                                              ║
+║  ⚠️  You are running Python outside of Blender!                              ║
+║                                                                              ║
+║  To use vibephysics, run your scripts through Blender:                       ║
+║                                                                              ║
+║    # Run in background mode:                                                 ║
+║    blender -b -P your_script.py                                              ║
+║                                                                              ║
+║    # Run with GUI:                                                           ║
+║    blender -P your_script.py                                                 ║
+║                                                                              ║
+║    # Pass arguments to your script:                                          ║
+║    blender -b -P your_script.py -- --your-arg value                          ║
+║                                                                              ║
+╠══════════════════════════════════════════════════════════════════════════════╣
+║  REQUIREMENTS:                                                               ║
+║    • Blender 5.0                                                             ║
+║    • Download: https://www.blender.org/download/                             ║
+║    • Install guide: https://docs.blender.org/manual/en/latest/               ║
+║                     getting_started/installing/                              ║
+║                                                                              ║
+║  Verify Blender is installed:                                                ║
+║    blender --version                                                         ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+"""
+        print(error_message, file=sys.stderr)
+        raise ImportError(
+            "vibephysics requires Blender 5.0's Python environment. "
+            "Run your script with: blender -b -P your_script.py"
+        )
+
+# Check environment before importing submodules
+_check_blender_environment()
+
+# Import subpackages for convenient access
+from . import foundation
+from . import annotation
+
+# Quick access to commonly used classes
+from .annotation import AnnotationManager, quick_annotate
+
+__all__ = [
+    "__version__",
+    "foundation",
+    "annotation",
+    "AnnotationManager",
+    "quick_annotate",
+]

vibephysics/annotation/__init__.py

@@ -0,0 +1,139 @@
+"""
+Annotation Utilities
+
+Point tracking, bounding boxes, motion trails, and visualization tools 
+for annotating Blender simulations.
+
+Unified API:
+    from annotation import manager
+    mgr = manager.AnnotationManager()
+    mgr.add_bbox(cube)
+    mgr.add_motion_trail(cube)
+    mgr.add_point_tracking([cube, sphere])
+    mgr.finalize()
+
+Or use the quick API:
+    from annotation import manager
+    manager.quick_annotate([cube, sphere], bbox=True, trail=True)
+
+Individual modules:
+    from annotation import bbox, motion_trail, point_tracking, viewport
+"""
+
+# Base utilities (for extension)
+from .base import (
+    DEFAULT_COLLECTION_NAME,
+    ensure_collection,
+    create_emission_material,
+    create_vertex_color_material,
+    register_frame_handler,
+    unregister_frame_handler,
+    create_embedded_script,
+    get_object_world_bounds,
+    get_evaluated_object,
+    get_depsgraph,
+    BaseAnnotation,
+    AnnotationType,
+    create_annotation,
+    # Tracking configuration
+    TrackingTarget,
+    TrackingConfig,
+)
+
+# Individual annotation modules
+from .point_tracking import (
+    setup_point_tracking_visualization,
+    create_point_cloud_tracker,
+    register_frame_handler as register_point_tracking_handler,
+    create_embedded_tracking_script,
+    sample_mesh_surface_points,
+    generate_distinct_colors,
+)
+
+from .bbox import (
+    create_bbox_annotation,
+    update_bbox,
+    update_all_bboxes,
+    register as register_bbox,
+    create_embedded_bbox_script,
+)
+
+from .motion_trail import (
+    create_motion_trail,
+    create_motion_trails,
+)
+
+from .viewport import (
+    setup_dual_viewport,
+    split_viewport_horizontal,
+    configure_viewport_shading,
+    configure_viewport_overlays,
+    enter_local_view,
+    register_viewport_restore_handler,
+    create_viewport_restore_script,
+)
+
+# Manager (unified API)
+from .manager import (
+    AnnotationManager,
+    get_manager,
+    reset_manager,
+    quick_annotate,
+)
+
+__all__ = [
+    # Constants
+    'DEFAULT_COLLECTION_NAME',
+    
+    # Base utilities
+    'ensure_collection',
+    'create_emission_material',
+    'create_vertex_color_material',
+    'register_frame_handler',
+    'unregister_frame_handler',
+    'create_embedded_script',
+    'get_object_world_bounds',
+    'get_evaluated_object',
+    'get_depsgraph',
+    'BaseAnnotation',
+    'AnnotationType',
+    'create_annotation',
+    
+    # Tracking configuration
+    'TrackingTarget',
+    'TrackingConfig',
+    
+    # BBox
+    'create_bbox_annotation',
+    'update_bbox',
+    'update_all_bboxes',
+    'register_bbox',
+    'create_embedded_bbox_script',
+    
+    # Motion Trail
+    'create_motion_trail',
+    'create_motion_trails',
+    
+    # Point Tracking
+    'setup_point_tracking_visualization',
+    'create_point_cloud_tracker',
+    'register_point_tracking_handler',
+    'create_embedded_tracking_script',
+    'sample_mesh_surface_points',
+    'generate_distinct_colors',
+    
+    # Viewport
+    'setup_dual_viewport',
+    'split_viewport_horizontal',
+    'configure_viewport_shading',
+    'configure_viewport_overlays',
+    'enter_local_view',
+    'register_viewport_restore_handler',
+    'create_viewport_restore_script',
+    
+    # Manager (unified API)
+    'AnnotationManager',
+    'get_manager',
+    'reset_manager',
+    'quick_annotate',
+]