naramotion 0.24.0__tar.gz

naramotion-0.24.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: naramotion
+Version: 0.24.0
+Summary: NaraMotion: Ultra-Fast 2D/2.5D Vector Graphics, Motion, GIS, VFX & Video Engine powered by Blend2D
+Author: Islam Arifi, NaraMotion Developers
+Maintainer: Islam Arifi
+License: Proprietary
+Project-URL: Homepage, https://pypi.org/project/naramotion/
+Project-URL: Repository, https://pypi.org/project/naramotion/
+Project-URL: Documentation, https://pypi.org/project/naramotion/
+Keywords: naramotion,blend2d,graphics,2d,vector,rasterizer,jit,simd,motion,gis,geopandas,shapely,video,render,vfx,aftereffects
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: numpy
+Requires-Dist: numpy>=1.20; extra == "numpy"
+Provides-Extra: pil
+Requires-Dist: Pillow>=8.0; extra == "pil"
+Provides-Extra: all
+Requires-Dist: numpy>=1.20; extra == "all"
+Requires-Dist: Pillow>=8.0; extra == "all"
+Requires-Dist: geopandas>=0.10.0; extra == "all"
+Requires-Dist: shapely>=1.8.0; extra == "all"
+Requires-Dist: pytest>=7.0; extra == "all"
+Dynamic: requires-python
+
+# NaraMotion 🎨🚀
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](https://pypi.org/project/naramotion/)
+[![JIT Accelerated](https://img.shields.io/badge/JIT-AsmJit%20Hardware%20Accelerated-orange.svg)](https://blend2d.com)
+
+**Author & Creator**: Islam Arifi  
+**Official PyPI Package**: [`naramotion`](https://pypi.org/project/naramotion/) (v0.22.0)  
+
+**NaraMotion** is an ultra-fast 2D/2.5D vector graphics, GIS, motion graphics, and cinematic video engine for Python powered by **[Blend2D](https://blend2d.com)** (embedded JIT compiler and SIMD hardware acceleration).
+
+---
+
+## 🔑 License Activation & Evaluation Mode
+
+NaraMotion is distributed under a **Proprietary Commercial License** with an Evaluation Mode.
+Unlicensed evaluation renders include a subtle semi-transparent `"Auras"` watermark in the center.
+
+### To Activate Full Commercial Version:
+Call `naramotion.set_license()` at the beginning of your program with your commercial key:
+
+```python
+import naramotion
+
+# Activate official license (removes all evaluation watermarks)
+naramotion.set_license("YOUR_COMMERCIAL_KEY")
+```
+
+Or set the environment variable:
+```bash
+export NARAMOTION_LICENSE_KEY="YOUR_COMMERCIAL_KEY"  # Linux/macOS
+set NARAMOTION_LICENSE_KEY="YOUR_COMMERCIAL_KEY"     # Windows
+```
+
+---
+
+## 📦 Official Installation
+
+### 1. From PyPI:
+```bash
+pip install naramotion
+```
+
+### 2. Optional Speed & Ecosystem Extensions:
+```bash
+pip install "naramotion[numpy,pil]"     # For Zero-Copy NumPy & Pillow integration
+pip install "naramotion[all]"           # For GeoPandas, Shapely & full testing
+```
+
+### ✅ Quick Verification:
+```python
+import naramotion
+print(f"✨ NaraMotion Version: {naramotion.__version__} by {naramotion.__author__}")
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Basic Drawing & Context Manager
+
+```python
+from naramotion import Image, Context, Format
+
+# Create 800x600 surface in PRGB32 format
+img = Image(800, 600, Format.PRGB32)
+
+with Context(img) as ctx:
+    # 1. Fill dark cyberpunk canvas background
+    ctx.fill_all("#090D16")
+    
+    # 2. Draw soft glowing circle
+    ctx.fill_circle(400, 300, 140, "#38BDF8")
+    
+    # 3. Add stylish thick border with rounded corners
+    ctx.stroke_width = 8.0
+    ctx.stroke_round_rect(100, 100, 600, 400, 24.0, style="#F43F5E")
+
+# Save directly to disk
+img.save("quickstart_naramotion.png")
+```
+
+---
+
+### 2. Cinematic Post-Processing FX & Post-Pipeline
+
+```python
+from naramotion import Image, Context, fx
+
+img = Image(1280, 720)
+with Context(img) as ctx:
+    ctx.fill_all("#060810")
+    ctx.fill_circle(640, 360, 180, "#38BDF8")
+
+# Apply chained visual FX (Bloom + Vignette + Film Grain)
+fx.FXPipeline().bloom(threshold=0.5, intensity=1.5, radius=12.0).vignette(0.5).film_grain(0.05).apply(img)
+img.save("cinematic_naramotion.png")
+```
+
+---
+
+### 3. Kinetic Perspective Camera (2.5D 4K Video Flythrough)
+
+```python
+from naramotion import Image, Context, Format, CompOp
+from naramotion.motion import PerspectiveCamera
+from naramotion.video import VideoWriter
+
+WIDTH, HEIGHT = 1920, 1080
+img = Image(WIDTH, HEIGHT, Format.PRGB32)
+cam = PerspectiveCamera(width=WIDTH, height=HEIGHT, pitch=65.0, distance=900.0)
+
+with VideoWriter("flythrough.mp4", width=WIDTH, height=HEIGHT, fps=60) as vw:
+    for frame in range(120):
+        cam.target_y = (frame / 119.0) * 1200.0
+        with Context(img) as ctx:
+            ctx.fill_all("#050811")
+            cam.render_fog(ctx, fog_color="#050811", horizon_y_ratio=0.35)
+        vw.write_frame(img)
+```
+
+---
+
+## 📚 Complete API Documentation
+
+For the complete 22-section master documentation and AI guidelines, see:
+- [`DOCUMENTATION.md`](DOCUMENTATION.md)
+- [`AI_RULES.md`](AI_RULES.md)

naramotion-0.24.0/README.md

@@ -0,0 +1,128 @@
+# NaraMotion 🎨🚀
+
+[![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/License-Proprietary-red.svg)](https://pypi.org/project/naramotion/)
+[![JIT Accelerated](https://img.shields.io/badge/JIT-AsmJit%20Hardware%20Accelerated-orange.svg)](https://blend2d.com)
+
+**Author & Creator**: Islam Arifi  
+**Official PyPI Package**: [`naramotion`](https://pypi.org/project/naramotion/) (v0.22.0)  
+
+**NaraMotion** is an ultra-fast 2D/2.5D vector graphics, GIS, motion graphics, and cinematic video engine for Python powered by **[Blend2D](https://blend2d.com)** (embedded JIT compiler and SIMD hardware acceleration).
+
+---
+
+## 🔑 License Activation & Evaluation Mode
+
+NaraMotion is distributed under a **Proprietary Commercial License** with an Evaluation Mode.
+Unlicensed evaluation renders include a subtle semi-transparent `"Auras"` watermark in the center.
+
+### To Activate Full Commercial Version:
+Call `naramotion.set_license()` at the beginning of your program with your commercial key:
+
+```python
+import naramotion
+
+# Activate official license (removes all evaluation watermarks)
+naramotion.set_license("YOUR_COMMERCIAL_KEY")
+```
+
+Or set the environment variable:
+```bash
+export NARAMOTION_LICENSE_KEY="YOUR_COMMERCIAL_KEY"  # Linux/macOS
+set NARAMOTION_LICENSE_KEY="YOUR_COMMERCIAL_KEY"     # Windows
+```
+
+---
+
+## 📦 Official Installation
+
+### 1. From PyPI:
+```bash
+pip install naramotion
+```
+
+### 2. Optional Speed & Ecosystem Extensions:
+```bash
+pip install "naramotion[numpy,pil]"     # For Zero-Copy NumPy & Pillow integration
+pip install "naramotion[all]"           # For GeoPandas, Shapely & full testing
+```
+
+### ✅ Quick Verification:
+```python
+import naramotion
+print(f"✨ NaraMotion Version: {naramotion.__version__} by {naramotion.__author__}")
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. Basic Drawing & Context Manager
+
+```python
+from naramotion import Image, Context, Format
+
+# Create 800x600 surface in PRGB32 format
+img = Image(800, 600, Format.PRGB32)
+
+with Context(img) as ctx:
+    # 1. Fill dark cyberpunk canvas background
+    ctx.fill_all("#090D16")
+    
+    # 2. Draw soft glowing circle
+    ctx.fill_circle(400, 300, 140, "#38BDF8")
+    
+    # 3. Add stylish thick border with rounded corners
+    ctx.stroke_width = 8.0
+    ctx.stroke_round_rect(100, 100, 600, 400, 24.0, style="#F43F5E")
+
+# Save directly to disk
+img.save("quickstart_naramotion.png")
+```
+
+---
+
+### 2. Cinematic Post-Processing FX & Post-Pipeline
+
+```python
+from naramotion import Image, Context, fx
+
+img = Image(1280, 720)
+with Context(img) as ctx:
+    ctx.fill_all("#060810")
+    ctx.fill_circle(640, 360, 180, "#38BDF8")
+
+# Apply chained visual FX (Bloom + Vignette + Film Grain)
+fx.FXPipeline().bloom(threshold=0.5, intensity=1.5, radius=12.0).vignette(0.5).film_grain(0.05).apply(img)
+img.save("cinematic_naramotion.png")
+```
+
+---
+
+### 3. Kinetic Perspective Camera (2.5D 4K Video Flythrough)
+
+```python
+from naramotion import Image, Context, Format, CompOp
+from naramotion.motion import PerspectiveCamera
+from naramotion.video import VideoWriter
+
+WIDTH, HEIGHT = 1920, 1080
+img = Image(WIDTH, HEIGHT, Format.PRGB32)
+cam = PerspectiveCamera(width=WIDTH, height=HEIGHT, pitch=65.0, distance=900.0)
+
+with VideoWriter("flythrough.mp4", width=WIDTH, height=HEIGHT, fps=60) as vw:
+    for frame in range(120):
+        cam.target_y = (frame / 119.0) * 1200.0
+        with Context(img) as ctx:
+            ctx.fill_all("#050811")
+            cam.render_fog(ctx, fog_color="#050811", horizon_y_ratio=0.35)
+        vw.write_frame(img)
+```
+
+---
+
+## 📚 Complete API Documentation
+
+For the complete 22-section master documentation and AI guidelines, see:
+- [`DOCUMENTATION.md`](DOCUMENTATION.md)
+- [`AI_RULES.md`](AI_RULES.md)

naramotion-0.24.0/blend2d/__init__.py

@@ -0,0 +1,335 @@
+"""
+NaraMotion: High-Performance 2D Vector Graphics Engine for Python powered by Blend2D.
+"""
+
+from naramotion.enums import (
+    Format,
+    CompOp,
+    FillRule,
+    GeometryType,
+    ExtendMode,
+    GradientType,
+    StrokeCap,
+    StrokeCapPosition,
+    StrokeJoin,
+    StrokeTransformOrder,
+    TransformOp,
+    ClipOp,
+    FlattenMode,
+    RenderingEngine,
+    ResultCode,
+    ContextHint,
+    RenderingQuality,
+    GradientQuality,
+    PatternQuality,
+    RuntimeInfoType,
+    RuntimeCpuArch,
+    RuntimeCpuFeatures,
+)
+from naramotion.ffi import Blend2DError
+from naramotion.geometry import (
+    Point,
+    PointI,
+    Size,
+    SizeI,
+    Rect,
+    RectI,
+    Box,
+    BoxI,
+    Circle,
+    Ellipse,
+    RoundRect,
+    Triangle,
+    Arc,
+    Line,
+)
+from naramotion.matrix import Matrix2D
+from naramotion.color import (
+    Color,
+    Rgba32,
+    Rgba,
+    parse_color,
+    NAMED_COLORS,
+)
+from naramotion.image import Image
+from naramotion.path import Path
+from naramotion.style import (
+    Gradient,
+    LinearGradient,
+    RadialGradient,
+    ConicGradient,
+    Pattern,
+)
+from naramotion.font import (
+    FontFace,
+    Font,
+    FontMetrics,
+    TextMetrics,
+)
+from naramotion.context import Context
+from naramotion.diagnostics import (
+    diagnose_environment,
+    print_diagnostic_report,
+    get_error_details,
+    get_runtime_info,
+)
+from naramotion import svg
+from naramotion.svg import SvgContext, export_svg
+from naramotion import video
+from naramotion.video import (
+    VideoWriter,
+    VideoReader,
+    record_animation,
+    detect_hardware_encoders,
+    VideoError,
+    CodecNotFoundError,
+    FrameFormatError,
+)
+from naramotion import shapgeo
+from naramotion.shapgeo import (
+    GeoCanvas,
+    GeoTransform,
+    from_shapely,
+    from_geojson,
+    from_wkt,
+    render_gdf,
+    auto_bounds,
+    compute_center,
+    get_center,
+    get_centroid,
+    read_file,
+    read_parquet,
+    read_shapefile,
+    read_geojson,
+    proj,
+    Transformer,
+    to_web_mercator,
+    to_wgs84,
+    reproject_gdf,
+)
+from naramotion.palette import Palette
+from naramotion import motion
+from naramotion.motion import (
+    Timeline,
+    Easing,
+    Spring,
+    Action,
+    DrawReveal,
+    Create,
+    ShowCreation,
+    Uncreate,
+    Typewriter,
+    Stagger,
+    interpolate,
+    Extrapolate,
+    chaikin_smooth,
+    chaikin_smooth_points,
+    Sequence,
+    Composition,
+    delay_render,
+    CubicBezier,
+    trim_path,
+    PathFollower,
+    PathMorph,
+    ParticleSystem,
+    Camera2D,
+    PerspectiveCamera,
+    render_globe,
+    Node,
+    Layer,
+    Scene,
+)
+from naramotion import fx
+from naramotion.fx import (
+    FXPipeline,
+    gaussian_blur,
+    box_blur,
+    box_blur_integral,
+    bloom,
+    neon_glow,
+    drop_shadow,
+    chromatic_aberration,
+    vignette,
+    film_grain,
+    color_grade,
+    grayscale,
+    invert,
+    sepia,
+    tone_map_aces,
+    tone_map_reinhard,
+    scanlines,
+    glitch_displacement,
+)
+from naramotion.license import (
+    set_license,
+    is_licensed,
+)
+
+# Alias geo -> shapgeo for developer convenience
+geo = shapgeo
+
+__version__ = "0.24.0"
+__author__ = "Islam Arifi, NaraMotion Team, Blend2D Authors"
+
+# Backward compatibility alias
+import sys
+sys.modules["blend2d"] = sys.modules[__name__]
+
+__all__ = [
+    # Core
+    "Image",
+    "Context",
+    "Path",
+    "Blend2DError",
+    "set_license",
+    "is_licensed",
+    # Post-Processing FX Engine
+    "fx",
+    "FXPipeline",
+    "gaussian_blur",
+    "box_blur",
+    "bloom",
+    "neon_glow",
+    "drop_shadow",
+    "chromatic_aberration",
+    "vignette",
+    "film_grain",
+    "color_grade",
+    "grayscale",
+    "invert",
+    "sepia",
+    "scanlines",
+    "glitch_displacement",
+    # Motion Graphics & Animation Engine
+    "motion",
+    "Timeline",
+    "Easing",
+    "Spring",
+    "Action",
+    "DrawReveal",
+    "Create",
+    "ShowCreation",
+    "Uncreate",
+    "Typewriter",
+    "Stagger",
+    "interpolate",
+    "Extrapolate",
+    "chaikin_smooth",
+    "chaikin_smooth_points",
+    "Sequence",
+    "Composition",
+    "delay_render",
+    "CubicBezier",
+    "trim_path",
+    "PathFollower",
+    "PathMorph",
+    "ParticleSystem",
+    "Camera2D",
+    "PerspectiveCamera",
+    "render_globe",
+    "Node",
+    "Layer",
+    "Scene",
+    # Geospatial (GeoPandas & Shapely C++ Engine)
+    "shapgeo",
+    "geo",
+    "GeoCanvas",
+    "GeoTransform",
+    "from_shapely",
+    "from_geojson",
+    "from_wkt",
+    "render_gdf",
+    "auto_bounds",
+    "compute_center",
+    "get_center",
+    "get_centroid",
+    "read_file",
+    "read_parquet",
+    "read_shapefile",
+    "read_geojson",
+    "proj",
+    "Transformer",
+    "to_web_mercator",
+    "to_wgs84",
+    "reproject_gdf",
+    # Palette & Color Harmony
+    "Palette",
+    # Video & Native FFmpeg Engine
+    "video",
+    "VideoWriter",
+    "VideoReader",
+    "record_animation",
+    "detect_hardware_encoders",
+    "VideoError",
+    "CodecNotFoundError",
+    "FrameFormatError",
+    # SVG Vector Export
+    "svg",
+    "SvgContext",
+    "export_svg",
+    # Diagnostics & Troubleshooting
+    "diagnose_environment",
+    "print_diagnostic_report",
+    "get_error_details",
+    "get_runtime_info",
+    # Styles
+    "Gradient",
+    "LinearGradient",
+    "RadialGradient",
+    "ConicGradient",
+    "Pattern",
+    # Colors
+    "Rgba32",
+    "Rgba",
+    "parse_color",
+    "NAMED_COLORS",
+    # Typography
+    "FontFace",
+    "Font",
+    "FontMetrics",
+    "TextMetrics",
+    # Geometry
+    "Point",
+    "PointI",
+    "Size",
+    "SizeI",
+    "Rect",
+    "RectI",
+    "Box",
+    "BoxI",
+    "Circle",
+    "Ellipse",
+    "RoundRect",
+    "Triangle",
+    "Arc",
+    "Line",
+    "Matrix2D",
+    # Colors
+    "Color",
+    "Rgba32",
+    "Rgba",
+    "parse_color",
+    # Enums
+    "Format",
+    "CompOp",
+    "FillRule",
+    "GeometryType",
+    "ExtendMode",
+    "GradientType",
+    "StrokeCap",
+    "StrokeCapPosition",
+    "StrokeJoin",
+    "StrokeTransformOrder",
+    "TransformOp",
+    "ClipOp",
+    "FlattenMode",
+    "RenderingEngine",
+    "ResultCode",
+    "ContextHint",
+    "RenderingQuality",
+    "GradientQuality",
+    "PatternQuality",
+    "RuntimeInfoType",
+    "RuntimeCpuArch",
+    "RuntimeCpuFeatures",
+]