phg-vis 1.3.1__py3-none-any.whl → 1.4.0__py3-none-any.whl

phg/shader_render.py

@@ -1,9 +1,18 @@
-import pygame
-import numpy as np
-from OpenGL.GL import *
-from OpenGL.GL.shaders import compileProgram, compileShader
-import sys
-import time
+import sys
+import time
+
+try:
+    import pygame
+    import numpy as np
+    from OpenGL.GL import *  # noqa: F401,F403 - OpenGL symbols used dynamically
+    from OpenGL.GL.shaders import compileProgram, compileShader
+    _IMPORT_ERROR = None
+except Exception as exc:  # pragma: no cover - optional dependency
+    pygame = None
+    np = None
+    compileProgram = None
+    compileShader = None
+    _IMPORT_ERROR = exc
 
 class Camera:
     """Camera class with mouse interaction controls"""
@@ -93,7 +102,7 @@ def normalize(v):
         return v
     return v / norm
 
-class ShaderRenderer:
+class ShaderRenderer:
     """
     Shader renderer class for visualizing GLSL shaders
     
@@ -102,15 +111,20 @@ class ShaderRenderer:
     renderer.render_shader(fragment_shader_code)
     """
     
-    def __init__(self, width=800, height=600, title="Shader Renderer"):
-        """
-        Initialize Shader renderer
+    def __init__(self, width=800, height=600, title="Shader Renderer"):
+        """
+        Initialize Shader renderer
         
         Args:
             width: Window width
             height: Window height  
             title: Window title
-        """
+        """
+        if _IMPORT_ERROR is not None:
+            raise ImportError(
+                "ShaderRenderer requires pygame, numpy, and PyOpenGL. "
+                "Install with: pip install phg_vis[shader]"
+            ) from _IMPORT_ERROR
         self.width = width
         self.height = height
         self.title = title
@@ -422,4 +436,4 @@ def render_shader(fragment_shader, width=800, height=600, duration=0, title="Sha
     renderer = ShaderRenderer(width, height, title)
     success = renderer.render_shader(fragment_shader, duration)
     renderer.close()
-    return success
+    return success

phg/visphg.py

@@ -1,55 +1,79 @@
-#################################
-# Launch vis.exe
-#################################
-import http.client
-import subprocess
-import os
-import psutil  # Make sure to import psutil
-
-# Set the path to vis.exe in the current directory of the current script
-current_directory = os.path.dirname(os.path.abspath(__file__))
-vis_exe_path = os.path.join(current_directory, "vis", "vis.exe")
-print(vis_exe_path)
-# Check if vis.exe is running
-def is_vis_running():
-    for proc in psutil.process_iter(['name']):
-        if proc.info['name'] == 'vis.exe':
-            return True
-    return False
-    
-# Send network message
-def HTTPPOST(ip, phg):
-    headers = {
-        "Connection": "keep-alive",
-        "Content-Type": "text/plain"
-    }
-    conn = http.client.HTTPConnection(f"{ip}:5088")
-    conn.request('POST', '/phg', phg, headers)
-    res = conn.getresponse()
-    conn.close()
-    
-# Call HTTPPOST function to send network message
-def vis(phg):
-    if not is_vis_running():  # Check if the process is running
-        subprocess.Popen(vis_exe_path)  # Start the process
-    return HTTPPOST('127.0.0.1', phg.encode())    
-    
-# Send network message
-def HTTPPOST_IMG(ip, phg, filename='shot.png'):
-    headers = {
-        "Connection": "keep-alive",
-        "Content-Type": "text/plain"
-    }
-    # 构建完整的请求体: phg代码 ||| 渲染参数(包含文件名)
-    request_body = f"{phg}|||file={filename}"
-
-    conn = http.client.HTTPConnection(f"{ip}:5088")
-    conn.request('POST', '/phg_img', request_body, headers)
-    res = conn.getresponse()
-    conn.close()
-
-# Call HTTPPOST function to send network message
-def image(phg, filename='shot.png'):
-    if not is_vis_running():  # Check if the process is running
-        subprocess.Popen(vis_exe_path)  # Start the process
-    return HTTPPOST_IMG('127.0.0.1', phg.encode('utf-8').decode('utf-8'), filename)        
+#################################
+# Launch vis.exe
+#################################
+import http.client
+import os
+import re
+import subprocess
+
+try:
+    import psutil
+except Exception:  # pragma: no cover - optional dependency
+    psutil = None
+
+# Set the path to vis.exe in the current directory of the current script
+current_directory = os.path.dirname(os.path.abspath(__file__))
+vis_exe_path = os.path.join(current_directory, "vis", "vis.exe")
+
+
+# Check if vis.exe is running
+def is_vis_running():
+    if psutil is None:
+        return False
+    for proc in psutil.process_iter(["name"]):
+        if proc.info.get("name") == "vis.exe":
+            return True
+    return False
+
+
+# Send network message
+def HTTPPOST(ip, phg):
+    headers = {
+        "Connection": "keep-alive",
+        "Content-Type": "text/plain",
+    }
+    conn = http.client.HTTPConnection(f"{ip}:5088")
+    conn.request("POST", "/phg", phg, headers)
+    conn.getresponse()
+    conn.close()
+
+
+# Call HTTPPOST function to send network message
+def vis(phg):
+    if not is_vis_running():
+        subprocess.Popen(vis_exe_path)
+    return HTTPPOST("127.0.0.1", phg.encode())
+
+
+# Build image request payload with parameters
+def _build_img_request(phg, filename):
+    if "|||" not in phg:
+        return f"{phg}|||file={filename}"
+    code, params = phg.split("|||", 1)
+    params = params.strip()
+    if "file=" in params:
+        params = re.sub(r"file=\\S+", f"file={filename}", params)
+    else:
+        params = f"{params} file={filename}".strip()
+    return f"{code}|||{params}"
+
+
+# Send image request
+def HTTPPOST_IMG(ip, phg, filename="shot.png"):
+    headers = {
+        "Connection": "keep-alive",
+        "Content-Type": "text/plain",
+    }
+    request_body = _build_img_request(phg, filename)
+
+    conn = http.client.HTTPConnection(f"{ip}:5088")
+    conn.request("POST", "/phg_img", request_body, headers)
+    conn.getresponse()
+    conn.close()
+
+
+# Call HTTPPOST function to send network message
+def image(phg, filename="shot.png"):
+    if not is_vis_running():
+        subprocess.Popen(vis_exe_path)
+    return HTTPPOST_IMG("127.0.0.1", phg.encode("utf-8").decode("utf-8"), filename)

phg/web_three.py

@@ -0,0 +1,164 @@
+"""
+Three.js web viewer for PHG OBJ exports.
+"""
+
+from __future__ import annotations
+
+import html
+import os
+from functools import partial
+from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer
+from typing import Optional
+
+
+def _relpath_for_url(path: str, base_dir: str) -> str:
+    rel = os.path.relpath(os.path.abspath(path), base_dir)
+    return rel.replace("\\", "/")
+
+
+def write_three_view_html(obj_path: str, out_html: str, title: str = "PHG Web Viewer") -> str:
+    base_dir = os.path.dirname(os.path.abspath(out_html))
+    rel_obj = _relpath_for_url(obj_path, base_dir)
+
+    doc = f"""<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>{html.escape(title)}</title>
+  <style>
+    :root {{
+      --bg: #f6f3ee;
+      --panel: #ffffff;
+      --text: #1d1d1f;
+      --line: #dcd7cf;
+      --accent: #1b5e6b;
+    }}
+    * {{ box-sizing: border-box; }}
+    body {{
+      margin: 0;
+      background: var(--bg);
+      color: var(--text);
+      font-family: "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+    }}
+    #app {{
+      position: fixed;
+      inset: 0;
+    }}
+    canvas {{ display: block; }}
+    .hud {{
+      position: absolute;
+      top: 16px;
+      left: 16px;
+      background: rgba(255,255,255,0.9);
+      border: 1px solid var(--line);
+      border-radius: 10px;
+      padding: 10px 12px;
+      box-shadow: 0 6px 18px rgba(0,0,0,0.08);
+      font-size: 12px;
+      line-height: 1.5;
+    }}
+    .hud strong {{ color: var(--accent); }}
+  </style>
+</head>
+<body>
+  <div id="app"></div>
+  <div class="hud">
+    <div><strong>PHG Web Viewer</strong></div>
+    <div>OBJ: {html.escape(os.path.basename(obj_path))}</div>
+    <div>Controls: LMB rotate, RMB pan, wheel zoom</div>
+  </div>
+  <script type="module">
+    import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.160.0/build/three.module.js";
+    import {{ OrbitControls }} from "https://cdn.jsdelivr.net/npm/three@0.160.0/examples/jsm/controls/OrbitControls.js";
+    import {{ OBJLoader }} from "https://cdn.jsdelivr.net/npm/three@0.160.0/examples/jsm/loaders/OBJLoader.js";
+
+    const container = document.getElementById("app");
+    const scene = new THREE.Scene();
+    scene.background = new THREE.Color(0xf6f3ee);
+
+    const camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 0.1, 2000);
+    camera.position.set(6, 6, 10);
+
+    const renderer = new THREE.WebGLRenderer({{ antialias: true }});
+    renderer.setPixelRatio(window.devicePixelRatio || 1);
+    renderer.setSize(window.innerWidth, window.innerHeight);
+    container.appendChild(renderer.domElement);
+
+    const controls = new OrbitControls(camera, renderer.domElement);
+    controls.enableDamping = true;
+    controls.dampingFactor = 0.08;
+
+    const lightA = new THREE.DirectionalLight(0xffffff, 0.9);
+    lightA.position.set(6, 10, 8);
+    scene.add(lightA);
+    scene.add(new THREE.AmbientLight(0xffffff, 0.35));
+
+    const loader = new OBJLoader();
+    loader.load("{html.escape(rel_obj)}", (obj) => {{
+      obj.traverse((child) => {{
+        if (child.isMesh) {{
+          child.material = new THREE.MeshStandardMaterial({{
+            color: 0x9fb3c8,
+            roughness: 0.55,
+            metalness: 0.05
+          }});
+        }}
+      }});
+      scene.add(obj);
+
+      const box = new THREE.Box3().setFromObject(obj);
+      const size = box.getSize(new THREE.Vector3());
+      const center = box.getCenter(new THREE.Vector3());
+      const maxDim = Math.max(size.x, size.y, size.z) || 1;
+      const camDist = maxDim * 2.2;
+      camera.position.set(center.x + camDist, center.y + camDist, center.z + camDist);
+      controls.target.copy(center);
+      controls.update();
+    }});
+
+    function onResize() {{
+      camera.aspect = window.innerWidth / window.innerHeight;
+      camera.updateProjectionMatrix();
+      renderer.setSize(window.innerWidth, window.innerHeight);
+    }}
+    window.addEventListener("resize", onResize);
+
+    function animate() {{
+      requestAnimationFrame(animate);
+      controls.update();
+      renderer.render(scene, camera);
+    }}
+    animate();
+  </script>
+</body>
+</html>
+"""
+    with open(out_html, "w", encoding="utf-8") as f:
+        f.write(doc)
+    return out_html
+
+
+def serve_three_view(
+    obj_path: str,
+    html_path: Optional[str] = None,
+    host: str = "127.0.0.1",
+    port: int = 8766,
+    title: str = "PHG Web Viewer",
+) -> str:
+    if html_path is None:
+        base, _ = os.path.splitext(obj_path)
+        html_path = base + ".html"
+    write_three_view_html(obj_path, html_path, title=title)
+
+    directory = os.path.dirname(os.path.abspath(html_path)) or os.getcwd()
+    handler = partial(SimpleHTTPRequestHandler, directory=directory)
+    server = ThreadingHTTPServer((host, port), handler)
+    url = f"http://{host}:{port}/{os.path.basename(html_path)}"
+    print(url)
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        pass
+    finally:
+        server.server_close()
+    return url

{phg_vis-1.3.1.dist-info → phg_vis-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: phg_vis
-Version: 1.3.1
+Version: 1.4.0
 Summary: A package for the PHG modeling language and 3D visualization tool.
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: romeosoft
@@ -12,6 +12,11 @@ Classifier: Operating System :: Microsoft :: Windows
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: psutil
+Provides-Extra: shader
+Requires-Dist: numpy; extra == "shader"
+Requires-Dist: pygame; extra == "shader"
+Requires-Dist: PyOpenGL; extra == "shader"
 
 # PHG - Python Hypergraphics Library
 
@@ -27,6 +32,8 @@ PHG (Python Hypergraphics) is a powerful 3D modeling and visualization library t
 - **Pipe Visualization** - Specialized system for visualizing pipe structures with world/local coordinate support
 - **Shader Conversion** - Convert PHG scripts to GLSL shaders for GPU rendering
 - **Dual Rendering Modes** - Both real-time visualization (vis.exe) and offscreen rendering
+- **AI Parser Bridge** - Use DGE++ PHG parser to normalize/enhance scripts before visualization
+- **Web Viewer** - Export OBJ and view in a three.js browser viewer
 - **Python Integration** - Comprehensive Python API for all features
 
 ---
@@ -42,6 +49,11 @@ Or install from source:
 pip install phg
 ```
 
+Shader renderer dependencies (optional):
+```bash
+pip install phg_vis[shader]
+```
+
 ---
 
 ## 🚀 Quick Start
@@ -86,6 +98,49 @@ phg.image(scene, filename="tower.png")
 phg.image("sphere(5);|||view=2 width=1920 height=1080", filename="top_view.png")
 ```
 
+--- 
+
+## ✨ Unified Visualization API
+
+```python
+import phg
+
+# Traditional vis.exe
+phg.visualize("box(10);", mode="vis")
+
+# Shader ray-march preview (GLSL)
+phg.visualize("sphere(5);", mode="shader", width=800, height=600)
+
+# Web (three.js) viewer
+phg.visualize("box(10);", mode="web", out_html="view.html")
+```
+
+### AI Parser Bridge (for improved PHG)
+Use DGE++ PHG parser to normalize/enhance scripts before visualization:
+
+```python
+import phg
+
+phg.visualize(script, mode="vis", ai=True)
+phg.visualize(script, mode="shader", ai=True)
+phg.visualize(script, mode="web", ai=True, out_html="ai_view.html")
+```
+
+Environment override (optional):
+```
+set PHG_AI_ROOT=C:\Users\18858\Documents\_AILab\DGE++\PHG
+```
+
+Web live server (serves HTML + OBJ):
+```python
+phg.web_serve(script, host="127.0.0.1", port=8766, ai_root=None)
+```
+
+Notes for web viewer:
+- Uses three.js CDN (requires network access)
+- Uses AI bridge to export OBJ; ensure DGE++ is available
+- Use `web_serve` to avoid file:// loader restrictions
+
 ---
 
 ## 📖 Syntax Reference

{phg_vis-1.3.1.dist-info → phg_vis-1.4.0.dist-info}/RECORD

@@ -1,8 +1,11 @@
-phg/__init__.py,sha256=TvWMc1ho6g9enlj0nhtr5eidViu6xyt0CrUOW31Q9F4,3097
+phg/__init__.py,sha256=PcG3uC0eL2vY7L4cpNqE-e6Q1AjUbT4kn-18eBSNhZg,13241
+phg/ai_bridge.py,sha256=ZH4X-Sa8C3cbgeI5chi6Valsm0G1B__NrWMjy1YVbM8,5283
+phg/gcu_api.py,sha256=yjCWAJPyIAL_fAdj2umX39wNmw56-LmkcmUPqt3V8DI,22957
 phg/phg_to_shader.py,sha256=rb_LnGE1Py08oz72ES5CnjyCDbjVWDU3If0cYZq4SUU,15172
-phg/pipe_string_phg.py,sha256=FPFatph2WCVoUzEflIJWRotwH0Yb79VJaKvmyaj4zDI,10654
-phg/shader_render.py,sha256=_T8IFp1h5Hcj8TMMHwFMbxhGdHLnOqka7pJ4pde7zMA,16780
-phg/visphg.py,sha256=CtALoNJs0eDT8wnXk_76XG4UsOcV6cWucvWqz7AhOSc,1923
+phg/pipe_string_phg.py,sha256=9YW5wewLUmyqGUnYNBYpCyk_SMS6fBfyPWTnniy6xdY,16589
+phg/shader_render.py,sha256=ncQQHp5OMlOVeTsoIHOL2xnc6SQct7B8YRKPA-D9FlM,17278
+phg/visphg.py,sha256=TpT6icBoBmPCbCm212qKC9zft9MQ2UK2dWvmgnlupwQ,2163
+phg/web_three.py,sha256=GPftXoSUBfAMHfEAn4qapmJ1tsnfoxtKu2JiJwOBqAg,4979
 phg/vis/GCU.dll,sha256=k_slWZ5nOzZNi9zCe0_SKc0F7zXoLyRuRDomyirPY4I,2687488
 phg/vis/dragpad.exe,sha256=4qWG4VH1vginIGpKkBHwEBFlpTY8G6xPejeloJurNkE,51712
 phg/vis/dragpad_config.ini,sha256=MD5no-RjzzcBxyz3JWuI88qH5Q4WVivRLqk_1GE5VQY,78
@@ -15,8 +18,8 @@ phg/vis/vis.exe,sha256=9LGgETiO4lwhz_gJzdUg6gPP9EwGLT5SuLjN3wR2sso,1388032
 phg/vis/vis.ini,sha256=IjS0Av2BqresPR2oGCOoq5zliXN2wFRMK3rXcU15vKs,161
 phg/vis/zlib1.dll,sha256=oVw_r326ve3oveVZhlSiF8BloZQ6lfqXJEAhUYfMjOQ,89088
 phg/vis/imgui/main.lua,sha256=AIB5dpGrPHXuRiNW7Bg7eu5Lpi2DDcn6n4JS7OS1Hdk,4742
-phg_vis-1.3.1.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
-phg_vis-1.3.1.dist-info/METADATA,sha256=rJB_6RA15BncZfzq2BPKCgI02cesmNrB67eIzPtdpbM,17945
-phg_vis-1.3.1.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
-phg_vis-1.3.1.dist-info/top_level.txt,sha256=5GGhpTP8yi-zTXwW2HrI-zcxKxIM_nHXhL7r0iIDE_k,4
-phg_vis-1.3.1.dist-info/RECORD,,
+phg_vis-1.4.0.dist-info/LICENSE,sha256=tDnRkJxBYPzWdfh2gArRqrUPJxQZRZHJVs68qqBHIq4,1083
+phg_vis-1.4.0.dist-info/METADATA,sha256=wHVu7Q42AzQ_jcuvhjPYHE8EaJkmIqQIRX9hBJFSUbA,19424
+phg_vis-1.4.0.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+phg_vis-1.4.0.dist-info/top_level.txt,sha256=5GGhpTP8yi-zTXwW2HrI-zcxKxIM_nHXhL7r0iIDE_k,4
+phg_vis-1.4.0.dist-info/RECORD,,