phg-vis 1.3.0__tar.gz → 1.3.1__tar.gz

{phg_vis-1.3.0/phg_vis.egg-info → phg_vis-1.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: phg_vis
-Version: 1.3.0
+Version: 1.3.1
 Summary: A package for the PHG modeling language and 3D visualization tool.
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: romeosoft
@@ -13,20 +13,21 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# PHG - Minimalist 3D Modeling Language
+# PHG - Python Hypergraphics Library
 
-PHG (Bacteriophage) is a specialized modeling language for describing 3D scene node trees. Combining concepts from group theory, it provides custom overloading capabilities for variables and operations, making it particularly suitable for describing complex 3D scenes and 2D sprite structures.
+PHG (Python Hypergraphics) is a powerful 3D modeling and visualization library that combines a minimalist modeling language with Python integration. It provides procedural 3D scene generation, shader-based rendering, and specialized pipe system visualization.
 
 ---
 
 ## 🌟 Features
 
-- **Minimalist Syntax** - Declarative node tree description
+- **Minimalist Syntax** - Declarative node tree description for 3D scenes
 - **Hierarchical Modeling** - Support for nested nodes and transform inheritance
 - **Parametric Design** - Flexible property system and function definitions
-- **Topological Structures** - Two organization methods: sequence and array composition
-- **Visualization Rendering** - Powerful offscreen rendering and screenshot capabilities
-- **Python Integration** - Convenient Python API
+- **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
+- **Python Integration** - Comprehensive Python API for all features
 
 ---
 
@@ -402,6 +403,122 @@ for size in [5, 10, 15, 20]:
 
 ---
 
+## 🔧 Pipe Visualization System
+
+PHG includes a specialized pipe visualization system for creating 3D pipe structures from simple string commands.
+
+### Pipe String Commands
+
+- **F** - Forward (move forward in current direction)
+- **B** - Back (move backward in current direction)
+- **R** - Right (turn right and move)
+- **L** - Left (turn left and move)
+- **U** - Up (turn up and move)
+- **D** - Down (turn down and move)
+
+### World Coordinate System
+
+World coordinate pipes use absolute directions regardless of current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in world coordinates
+# F moves along world Z+, R moves along world X+, etc.
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.world_pipestr_vis("FFRRUD", start_pos)
+
+# Custom pipe appearance
+phg.world_pipestr_vis(
+    "FFLLUU",
+    start_pos,
+    pipe_color=(255, 100, 50),  # Orange pipe
+    pipe_radius=0.5               # Thicker pipe
+)
+```
+
+### Local Coordinate System
+
+Local coordinate pipes use directions relative to current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in local coordinates
+# F moves forward relative to current orientation
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.local_pipestr_vis("FFRRUD", start_pos)
+
+# The same string produces different results in local vs world coordinates
+phg.local_pipestr_vis(
+    "FFRRFF",  # Forward, Forward, Right turn, Right turn, Forward, Forward
+    start_pos,
+    pipe_color=(0, 255, 100)  # Green pipe
+)
+```
+
+### Direct PHG Script Generation
+
+For advanced use cases, you can generate PHG scripts without immediate visualization:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+start = coord3(vec3(5, 0, 0), quat(1, 0, 0, 0))
+
+# Generate PHG script for world coordinates
+world_phg = phg.world_pipe_to_phg("FFRUD", start)
+
+# Generate PHG script for local coordinates
+local_phg = phg.local_pipe_to_phg("FFRUD", start)
+
+# Visualize later
+phg.vis(world_phg)
+```
+
+### Example: Complex Pipe System
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a complex pipe network
+def create_pipe_network():
+    # Main pipeline
+    main_pipe = phg.world_pipestr_vis(
+        "FFFFRRFFRRUUFFLLFF",
+        coord3(vec3(0, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(100, 100, 255),
+        pipe_radius=0.5
+    )
+
+    # Branch 1
+    branch1 = phg.world_pipestr_vis(
+        "RRUUFFFF",
+        coord3(vec3(4, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(255, 100, 100),
+        pipe_radius=0.3
+    )
+
+    # Branch 2
+    branch2 = phg.local_pipestr_vis(
+        "FFLLDDFF",
+        coord3(vec3(8, 2, 2), quat(1, 0, 0, 0)),
+        pipe_color=(100, 255, 100),
+        pipe_radius=0.3
+    )
+
+    return main_pipe, branch1, branch2
+
+# Create and visualize the network
+pipes = create_pipe_network()
+```
+
+---
+
 ## 💡 Complete Examples
 
 ### Example 1: Simple Geometry
@@ -581,7 +698,6 @@ Recommended maximum resolution is **4096 x 4096**. Excessively large resolutions
 ## 🔗 Links
 
 - [PyPI Package](https://pypi.org/project/phg/)
-- [Official Documentation](https://your.documentation.link)
 - [Mathematical Foundation](https://github.com/panguojun/Coordinate-System)
 
 ---

{phg_vis-1.3.0 → phg_vis-1.3.1}/README.md

@@ -1,17 +1,18 @@
-# PHG - Minimalist 3D Modeling Language
+# PHG - Python Hypergraphics Library
 
-PHG (Bacteriophage) is a specialized modeling language for describing 3D scene node trees. Combining concepts from group theory, it provides custom overloading capabilities for variables and operations, making it particularly suitable for describing complex 3D scenes and 2D sprite structures.
+PHG (Python Hypergraphics) is a powerful 3D modeling and visualization library that combines a minimalist modeling language with Python integration. It provides procedural 3D scene generation, shader-based rendering, and specialized pipe system visualization.
 
 ---
 
 ## 🌟 Features
 
-- **Minimalist Syntax** - Declarative node tree description
+- **Minimalist Syntax** - Declarative node tree description for 3D scenes
 - **Hierarchical Modeling** - Support for nested nodes and transform inheritance
 - **Parametric Design** - Flexible property system and function definitions
-- **Topological Structures** - Two organization methods: sequence and array composition
-- **Visualization Rendering** - Powerful offscreen rendering and screenshot capabilities
-- **Python Integration** - Convenient Python API
+- **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
+- **Python Integration** - Comprehensive Python API for all features
 
 ---
 
@@ -387,6 +388,122 @@ for size in [5, 10, 15, 20]:
 
 ---
 
+## 🔧 Pipe Visualization System
+
+PHG includes a specialized pipe visualization system for creating 3D pipe structures from simple string commands.
+
+### Pipe String Commands
+
+- **F** - Forward (move forward in current direction)
+- **B** - Back (move backward in current direction)
+- **R** - Right (turn right and move)
+- **L** - Left (turn left and move)
+- **U** - Up (turn up and move)
+- **D** - Down (turn down and move)
+
+### World Coordinate System
+
+World coordinate pipes use absolute directions regardless of current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in world coordinates
+# F moves along world Z+, R moves along world X+, etc.
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.world_pipestr_vis("FFRRUD", start_pos)
+
+# Custom pipe appearance
+phg.world_pipestr_vis(
+    "FFLLUU",
+    start_pos,
+    pipe_color=(255, 100, 50),  # Orange pipe
+    pipe_radius=0.5               # Thicker pipe
+)
+```
+
+### Local Coordinate System
+
+Local coordinate pipes use directions relative to current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in local coordinates
+# F moves forward relative to current orientation
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.local_pipestr_vis("FFRRUD", start_pos)
+
+# The same string produces different results in local vs world coordinates
+phg.local_pipestr_vis(
+    "FFRRFF",  # Forward, Forward, Right turn, Right turn, Forward, Forward
+    start_pos,
+    pipe_color=(0, 255, 100)  # Green pipe
+)
+```
+
+### Direct PHG Script Generation
+
+For advanced use cases, you can generate PHG scripts without immediate visualization:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+start = coord3(vec3(5, 0, 0), quat(1, 0, 0, 0))
+
+# Generate PHG script for world coordinates
+world_phg = phg.world_pipe_to_phg("FFRUD", start)
+
+# Generate PHG script for local coordinates
+local_phg = phg.local_pipe_to_phg("FFRUD", start)
+
+# Visualize later
+phg.vis(world_phg)
+```
+
+### Example: Complex Pipe System
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a complex pipe network
+def create_pipe_network():
+    # Main pipeline
+    main_pipe = phg.world_pipestr_vis(
+        "FFFFRRFFRRUUFFLLFF",
+        coord3(vec3(0, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(100, 100, 255),
+        pipe_radius=0.5
+    )
+
+    # Branch 1
+    branch1 = phg.world_pipestr_vis(
+        "RRUUFFFF",
+        coord3(vec3(4, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(255, 100, 100),
+        pipe_radius=0.3
+    )
+
+    # Branch 2
+    branch2 = phg.local_pipestr_vis(
+        "FFLLDDFF",
+        coord3(vec3(8, 2, 2), quat(1, 0, 0, 0)),
+        pipe_color=(100, 255, 100),
+        pipe_radius=0.3
+    )
+
+    return main_pipe, branch1, branch2
+
+# Create and visualize the network
+pipes = create_pipe_network()
+```
+
+---
+
 ## 💡 Complete Examples
 
 ### Example 1: Simple Geometry
@@ -566,7 +683,6 @@ Recommended maximum resolution is **4096 x 4096**. Excessively large resolutions
 ## 🔗 Links
 
 - [PyPI Package](https://pypi.org/project/phg/)
-- [Official Documentation](https://your.documentation.link)
 - [Mathematical Foundation](https://github.com/panguojun/Coordinate-System)
 
 ---

phg_vis-1.3.1/phg/__init__.py

@@ -0,0 +1,113 @@
+"""
+PHG - Python Hypergraphics Library
+===================================
+
+A powerful graphics library for procedural 3D visualization using PHG scripts.
+
+Main Features:
+- PHG script visualization via vis.exe
+- Shader-based rendering with GLSL conversion
+- Pipe system visualization with world/local coordinate systems
+- Real-time and image rendering capabilities
+
+Version: 0.2.0
+Author: PanGuoJun
+License: MIT
+"""
+
+from .visphg import vis, image
+from .shader_render import ShaderRenderer, render_shader
+from .phg_to_shader import PHGToShaderConverter, phg_to_shader
+from .pipe_string_phg import (
+    world_pipe_to_phg,
+    local_pipe_to_phg,
+    world_pipestr_vis,
+    local_pipestr_vis
+)
+
+# Extend ShaderRenderer class to support direct PHG rendering
+class PHGShaderRenderer(ShaderRenderer):
+    """Shader renderer that supports direct PHG rendering"""
+    
+    def render_phg(self, phg_script: str, duration=0, interactive=True):
+        """
+        Render PHG script
+        
+        Parameters:
+            phg_script: PHG script code
+            duration: Render duration
+            interactive: Whether to allow interaction
+            
+        Returns:
+            success: Whether rendering was successful
+        """
+        converter = PHGToShaderConverter()
+        shader_code = converter.generate_shader_code(phg_script)
+        
+        if not shader_code:
+            print("Error: PHG conversion failed")
+            return False
+            
+        return self.render_shader(shader_code, duration, interactive)
+
+# Convenience functions
+def render_phg(phg_script: str, width=800, height=600, duration=0, title="PHG Renderer"):
+    """
+    Directly render PHG script
+    
+    Parameters:
+        phg_script: PHG script code
+        width: Window width
+        height: Window height  
+        duration: Render duration
+        title: Window title
+    """
+    renderer = PHGShaderRenderer(width, height, title)
+    success = renderer.render_phg(phg_script, duration)
+    renderer.close()
+    return success
+
+def convert_phg_to_shader(phg_script: str) -> str:
+    """
+    Convert PHG script to GLSL shader code
+
+    Parameters:
+        phg_script: PHG script
+
+    Returns:
+        shader_code: GLSL shader code
+    """
+    return phg_to_shader(phg_script)
+
+__all__ = [
+    # Core visualization functions
+    'vis',
+    'image',
+
+    # Shader rendering
+    'ShaderRenderer',
+    'render_shader',
+    'render_phg',
+    'PHGShaderRenderer',
+
+    # PHG conversion
+    'PHGToShaderConverter',
+    'phg_to_shader',
+    'convert_phg_to_shader',
+
+    # Pipe visualization
+    'world_pipe_to_phg',
+    'local_pipe_to_phg',
+    'world_pipestr_vis',
+    'local_pipestr_vis',
+]
+
+__version__ = "1.3.1"
+__author__ = "PanGuoJun"
+__description__ = "Python Hypergraphics Library"
+
+# Package initialization information
+print(f"PHG {__version__} - {__description__}")
+print("[OK] Visualization module loaded")
+print("[OK] Shader converter loaded")
+print("[OK] Pipe visualization loaded")

phg_vis-1.3.1/phg/pipe_string_phg.py

@@ -0,0 +1,285 @@
+"""
+Pipe String to PHG Converter
+============================
+
+该模块提供了管道字符串转换为PHG（Python Graphics）脚本的功能。
+支持世界坐标系和局部坐标系两种管道描述方式。
+
+主要功能：
+- world_pipe_to_phg: 世界坐标系管道转换
+- local_pipe_to_phg: 局部坐标系管道转换
+- world_pipestr_vis: 世界坐标系管道直接可视化
+- local_pipestr_vis: 局部坐标系管道直接可视化
+
+管道字符串格式：
+- F: 前进 (Forward)
+- B: 后退 (Back)
+- R: 右转 (Right)
+- L: 左转 (Left)
+- U: 上转 (Up)
+- D: 下转 (Down)
+"""
+
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# 默认颜色和管径
+DEFAULT_PIPE_COLOR = (0, 55, 255)
+DEFAULT_PIPE_RADIUS = 0.3
+
+def world_pipe_to_phg(world_pipe_str, start_c, pipe_color=DEFAULT_PIPE_COLOR, pipe_radius=DEFAULT_PIPE_RADIUS):
+    """
+    将世界坐标系下的管道字符串转换为PHG脚本
+    
+    参数:
+        world_pipe_str: 世界坐标系管道字符串（如 "FFRUD"）
+        start_c: 起始坐标系
+        pipe_color: 管道颜色，格式为(R, G, B)元组
+        pipe_radius: 管道半径
+    
+    返回:
+        PHG脚本字符串
+    """
+    
+    # 世界坐标系方向定义
+    world_directions = {
+        'F': vec3(0, 0, 1),   # 前（世界Z+）
+        'B': vec3(0, 0, -1),  # 后（世界Z-）
+        'R': vec3(1, 0, 0),   # 右（世界X+）
+        'L': vec3(-1, 0, 0),  # 左（世界X-）
+        'U': vec3(0, 1, 0),   # 上（世界Y+）
+        'D': vec3(0, -1, 0)   # 下（世界Y-）
+    }
+
+    # 解析颜色
+    r, g, b = pipe_color
+    
+    # 管道部件映射（所有部件使用固定长度1.0）
+    pipe_components = {
+        'F': f'{{{{rgb:{r},{g},{b};md:cylinder {pipe_radius} 1.0;rx:90;z:-0.5;}};z:1.0}}',
+        'B': f'{{{{rgb:{r},{g},{b};md:cylinder {pipe_radius} 1.0;rx:-90;z:{-1.0-0.5};}};z:1.0}}',
+        'R': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}ry:90;x:1.0;z:-1.0}}}},{{x:1.0;ry:-90;}}',
+        'L': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}ry:-90;m:x;z:-1.0;x:-1.0}}}},{{x:-1.0;ry:90;}}',
+        'U': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}rz:90;y:1.0;z:-1}}}},{{y:1.0;rx:90;}}',
+        'D': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}rz:-90;y:-1;z:-1}}}},{{y:-1.0;rx:-90;}}'
+    }
+
+    # 初始化当前坐标系（使用起始坐标系）
+    cur_c = coord3(start_c.o, start_c.Q())
+    
+    # 存储所有管道部件的脚本
+    script_parts = []
+    
+    # 遍历管道字符串中的每个字符
+    for move_char in world_pipe_str:
+        if move_char not in pipe_components:
+            print(f"警告: 未知的管道字符 '{move_char}'，已跳过")
+            continue
+        
+        # 获取当前移动在世界坐标系中的方向
+        world_dir = world_directions[move_char]
+        
+        # 将世界方向转换到当前局部坐标系
+        local_dir = vec3(
+            world_dir.dot(cur_c.ux),  # 在局部X轴的分量
+            world_dir.dot(cur_c.uy),  # 在局部Y轴的分量
+            world_dir.dot(cur_c.uz)   # 在局部Z轴的分量
+        )
+        
+        # 找到绝对值最大的分量来确定主要移动方向
+        abs_components = [abs(local_dir.x), abs(local_dir.y), abs(local_dir.z)]
+        max_idx = abs_components.index(max(abs_components))
+        
+        # 根据最大分量确定局部移动方向
+        if max_idx == 0:  # X轴
+            local_move = 'R' if local_dir.x > 0 else 'L'
+        elif max_idx == 1:  # Y轴
+            local_move = 'U' if local_dir.y > 0 else 'D'
+        else:  # Z轴
+            local_move = 'F' if local_dir.z > 0 else 'B'
+        
+        # 添加对应的管道部件脚本
+        script_parts.append(pipe_components[local_move])
+        
+        # 更新当前坐标系（模拟移动后的新位置和方向）
+        if local_move == 'F':
+            # 前进：沿局部Z轴正方向移动1.0单位
+            cur_c = cur_c * coord3(vec3(0, 0, 1.0))
+        elif local_move == 'B':
+            # 后退：沿局部Z轴负方向移动1.0单位
+            cur_c = cur_c * coord3(vec3(0, 0, -1.0))
+        elif local_move == 'R':
+            # 右转：绕Y轴旋转-90度，然后沿X轴移动1.0单位
+            rotation = quat(-3.1416 / 2, cur_c.uy)
+            cur_c = cur_c * rotation
+            cur_c = cur_c * coord3(vec3(1.0, 0, 0))
+        elif local_move == 'L':
+            # 左转：绕Y轴旋转90度，然后沿X轴移动1.0单位
+            rotation = quat(3.1416 / 2, cur_c.uy)
+            cur_c = cur_c * rotation
+            cur_c = cur_c * coord3(vec3(-1.0, 0, 0))
+        elif local_move == 'U':
+            # 上转：绕X轴旋转90度，然后沿Y轴移动1.0单位
+            rotation = quat(3.1416 / 2, cur_c.ux)
+            cur_c = cur_c * rotation
+            cur_c = cur_c * coord3(vec3(0, 1.0, 0))
+        elif local_move == 'D':
+            # 下转：绕X轴旋转-90度，然后沿Y轴移动1.0单位
+            rotation = quat(-3.1416 / 2, cur_c.ux)
+            cur_c = cur_c * rotation
+            cur_c = cur_c * coord3(vec3(0, -1.0, 0))
+
+    # 组合所有管道部件的脚本
+    inner_script = ',\n'.join(script_parts)
+    
+    # 获取起始坐标系的四元数
+    q = start_c.Q()
+    
+    # 构建完整的PHG脚本
+    complete_script = f"""{{
+    {{xyz:{start_c.o.x},{start_c.o.y},{start_c.o.z};q:{q.w},{q.x},{q.y},{q.z};s:0.5;
+    <{inner_script}>}}
+    }}"""
+    
+    return complete_script
+
+
+def local_pipe_to_phg(local_pipe_str, start_c, pipe_color=DEFAULT_PIPE_COLOR, pipe_radius=DEFAULT_PIPE_RADIUS):
+    """
+    将局部坐标系下的管道字符串转换为PHG脚本
+
+    参数:
+        local_pipe_str: 局部坐标系管道字符串（如 "FFRUD"）
+        start_c: 起始坐标系
+        pipe_color: 管道颜色，格式为(R, G, B)元组
+        pipe_radius: 管道半径
+
+    返回:
+        PHG脚本字符串
+    """
+
+    # 解析颜色
+    r, g, b = pipe_color
+
+    # 管道部件映射（所有部件使用固定长度1.0）
+    pipe_components = {
+        'F': f'{{{{rgb:{r},{g},{b};md:cylinder {pipe_radius} 1.0;rx:90;z:-0.5;}};z:1.0}}',
+        'B': f'{{{{rgb:{r},{g},{b};md:cylinder {pipe_radius} 1.0;rx:-90;z:{-1.0-0.5};}};z:1.0}}',
+        'R': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}ry:90;x:1.0;z:-1.0}}}},{{x:1.0;ry:-90;}}',
+        'L': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}ry:-90;m:x;z:-1.0;x:-1.0}}}},{{x:-1.0;ry:90;}}',
+        'U': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}rz:90;y:1.0;z:-1}}}},{{y:1.0;rx:90;}}',
+        'D': f'{{{{{{rgb:{r},{g},{b};md:elbow 90 0.5 {pipe_radius};x:0.5;z:0.5;}}rz:-90;y:-1;z:-1}}}},{{y:-1.0;rx:-90;}}'
+    }
+
+    # 存储所有管道部件的脚本
+    script_parts = []
+
+    # 遍历管道字符串中的每个字符
+    for move_char in local_pipe_str:
+        if move_char not in pipe_components:
+            print(f"警告: 未知的管道字符 '{move_char}'，已跳过")
+            continue
+
+        # 直接使用局部坐标系的移动命令
+        script_parts.append(pipe_components[move_char])
+
+    # 组合所有管道部件的脚本
+    inner_script = ',\n'.join(script_parts)
+
+    # 获取起始坐标系的四元数
+    q = start_c.Q()
+
+    # 构建完整的PHG脚本
+    complete_script = f"""{{
+    {{xyz:{start_c.o.x},{start_c.o.y},{start_c.o.z};q:{q.w},{q.x},{q.y},{q.z};s:0.5;
+    <{inner_script}>}}
+    }}"""
+
+    return complete_script
+
+
+def world_pipestr_vis(world_pipe_str, start_c=None, pipe_color=DEFAULT_PIPE_COLOR, pipe_radius=DEFAULT_PIPE_RADIUS):
+    """
+    世界坐标系管道字符串直接可视化
+
+    参数:
+        world_pipe_str: 世界坐标系管道字符串（如 "FFRUD"）
+        start_c: 起始坐标系，默认为原点
+        pipe_color: 管道颜色，格式为(R, G, B)元组
+        pipe_radius: 管道半径
+
+    返回:
+        PHG脚本字符串
+    """
+    # 如果没有提供起始坐标系，使用默认原点
+    if start_c is None:
+        start_c = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+
+    # 生成PHG脚本
+    phg_script = world_pipe_to_phg(world_pipe_str, start_c, pipe_color, pipe_radius)
+
+    # 调用可视化函数
+    try:
+        from .visphg import vis
+        vis(phg_script)
+    except ImportError:
+        print("警告: 无法导入可视化模块，返回PHG脚本")
+
+    return phg_script
+
+
+def local_pipestr_vis(local_pipe_str, start_c=None, pipe_color=DEFAULT_PIPE_COLOR, pipe_radius=DEFAULT_PIPE_RADIUS):
+    """
+    局部坐标系管道字符串直接可视化
+
+    参数:
+        local_pipe_str: 局部坐标系管道字符串（如 "FFRUD"）
+        start_c: 起始坐标系，默认为原点
+        pipe_color: 管道颜色，格式为(R, G, B)元组
+        pipe_radius: 管道半径
+
+    返回:
+        PHG脚本字符串
+    """
+    # 如果没有提供起始坐标系，使用默认原点
+    if start_c is None:
+        start_c = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+
+    # 生成PHG脚本
+    phg_script = local_pipe_to_phg(local_pipe_str, start_c, pipe_color, pipe_radius)
+
+    # 调用可视化函数
+    try:
+        from .visphg import vis
+        vis(phg_script)
+    except ImportError:
+        print("警告: 无法导入可视化模块，返回PHG脚本")
+
+    return phg_script
+
+
+# 使用示例
+if __name__ == "__main__":
+    # 创建起始坐标系（示例）
+    start_coord = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+
+    # 示例1: 世界坐标系管道字符串
+    example_world_pipe = "FFRUD"  # 前进2次，右转，上转，下转
+    print("世界坐标系管道示例:")
+    phg_script = world_pipe_to_phg(example_world_pipe, start_coord)
+    print("生成的PHG脚本:")
+    print(phg_script)
+    print()
+
+    # 示例2: 局部坐标系管道字符串
+    example_local_pipe = "FFRUD"  # 在局部坐标系中的移动
+    print("局部坐标系管道示例:")
+    phg_script = local_pipe_to_phg(example_local_pipe, start_coord)
+    print("生成的PHG脚本:")
+    print(phg_script)
+    print()
+
+    # 示例3: 直接可视化
+    print("直接可视化示例:")
+    # world_pipestr_vis(example_world_pipe)  # 世界坐标系可视化
+    # local_pipestr_vis(example_local_pipe)  # 局部坐标系可视化

phg_vis-1.3.1/phg/vis/vis.ini

@@ -0,0 +1,4 @@
+CAMERA=4.057,2.604,-0.507;3.490,2.240,-0.436;0.000,1.000,0.000;0.175;1.610;0;10.000;0.000,0.000,0.000
+CONSOLE=true
+ENABLE_DUAL_SCREEN=false
+HOSTIP=127.0.0.1

{phg_vis-1.3.0 → phg_vis-1.3.1/phg_vis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: phg_vis
-Version: 1.3.0
+Version: 1.3.1
 Summary: A package for the PHG modeling language and 3D visualization tool.
 Home-page: https://github.com/panguojun/Coordinate-System
 Author: romeosoft
@@ -13,20 +13,21 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 
-# PHG - Minimalist 3D Modeling Language
+# PHG - Python Hypergraphics Library
 
-PHG (Bacteriophage) is a specialized modeling language for describing 3D scene node trees. Combining concepts from group theory, it provides custom overloading capabilities for variables and operations, making it particularly suitable for describing complex 3D scenes and 2D sprite structures.
+PHG (Python Hypergraphics) is a powerful 3D modeling and visualization library that combines a minimalist modeling language with Python integration. It provides procedural 3D scene generation, shader-based rendering, and specialized pipe system visualization.
 
 ---
 
 ## 🌟 Features
 
-- **Minimalist Syntax** - Declarative node tree description
+- **Minimalist Syntax** - Declarative node tree description for 3D scenes
 - **Hierarchical Modeling** - Support for nested nodes and transform inheritance
 - **Parametric Design** - Flexible property system and function definitions
-- **Topological Structures** - Two organization methods: sequence and array composition
-- **Visualization Rendering** - Powerful offscreen rendering and screenshot capabilities
-- **Python Integration** - Convenient Python API
+- **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
+- **Python Integration** - Comprehensive Python API for all features
 
 ---
 
@@ -402,6 +403,122 @@ for size in [5, 10, 15, 20]:
 
 ---
 
+## 🔧 Pipe Visualization System
+
+PHG includes a specialized pipe visualization system for creating 3D pipe structures from simple string commands.
+
+### Pipe String Commands
+
+- **F** - Forward (move forward in current direction)
+- **B** - Back (move backward in current direction)
+- **R** - Right (turn right and move)
+- **L** - Left (turn left and move)
+- **U** - Up (turn up and move)
+- **D** - Down (turn down and move)
+
+### World Coordinate System
+
+World coordinate pipes use absolute directions regardless of current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in world coordinates
+# F moves along world Z+, R moves along world X+, etc.
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.world_pipestr_vis("FFRRUD", start_pos)
+
+# Custom pipe appearance
+phg.world_pipestr_vis(
+    "FFLLUU",
+    start_pos,
+    pipe_color=(255, 100, 50),  # Orange pipe
+    pipe_radius=0.5               # Thicker pipe
+)
+```
+
+### Local Coordinate System
+
+Local coordinate pipes use directions relative to current orientation:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a pipe in local coordinates
+# F moves forward relative to current orientation
+start_pos = coord3(vec3(0, 0, 0), quat(1, 0, 0, 0))
+phg_script = phg.local_pipestr_vis("FFRRUD", start_pos)
+
+# The same string produces different results in local vs world coordinates
+phg.local_pipestr_vis(
+    "FFRRFF",  # Forward, Forward, Right turn, Right turn, Forward, Forward
+    start_pos,
+    pipe_color=(0, 255, 100)  # Green pipe
+)
+```
+
+### Direct PHG Script Generation
+
+For advanced use cases, you can generate PHG scripts without immediate visualization:
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+start = coord3(vec3(5, 0, 0), quat(1, 0, 0, 0))
+
+# Generate PHG script for world coordinates
+world_phg = phg.world_pipe_to_phg("FFRUD", start)
+
+# Generate PHG script for local coordinates
+local_phg = phg.local_pipe_to_phg("FFRUD", start)
+
+# Visualize later
+phg.vis(world_phg)
+```
+
+### Example: Complex Pipe System
+
+```python
+import phg
+from coordinate_system import vec3, quat, coord3
+
+# Create a complex pipe network
+def create_pipe_network():
+    # Main pipeline
+    main_pipe = phg.world_pipestr_vis(
+        "FFFFRRFFRRUUFFLLFF",
+        coord3(vec3(0, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(100, 100, 255),
+        pipe_radius=0.5
+    )
+
+    # Branch 1
+    branch1 = phg.world_pipestr_vis(
+        "RRUUFFFF",
+        coord3(vec3(4, 0, 0), quat(1, 0, 0, 0)),
+        pipe_color=(255, 100, 100),
+        pipe_radius=0.3
+    )
+
+    # Branch 2
+    branch2 = phg.local_pipestr_vis(
+        "FFLLDDFF",
+        coord3(vec3(8, 2, 2), quat(1, 0, 0, 0)),
+        pipe_color=(100, 255, 100),
+        pipe_radius=0.3
+    )
+
+    return main_pipe, branch1, branch2
+
+# Create and visualize the network
+pipes = create_pipe_network()
+```
+
+---
+
 ## 💡 Complete Examples
 
 ### Example 1: Simple Geometry
@@ -581,7 +698,6 @@ Recommended maximum resolution is **4096 x 4096**. Excessively large resolutions
 ## 🔗 Links
 
 - [PyPI Package](https://pypi.org/project/phg/)
-- [Official Documentation](https://your.documentation.link)
 - [Mathematical Foundation](https://github.com/panguojun/Coordinate-System)
 
 ---

{phg_vis-1.3.0 → phg_vis-1.3.1}/phg_vis.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ setup.py
 phg/VisPHG.py
 phg/__init__.py
 phg/phg_to_shader.py
+phg/pipe_string_phg.py
 phg/shader_render.py
 phg/visphg.py
 phg/vis/GCU.dll

{phg_vis-1.3.0 → phg_vis-1.3.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='phg_vis', 
-    version='1.3.0', 
+    version='1.3.1', 
     packages=find_packages(),
     include_package_data=True,
     description='A package for the PHG modeling language and 3D visualization tool.',

phg_vis-1.3.0/phg/__init__.py

@@ -1,82 +0,0 @@
-"""
-__init__.py
-PHG主库 - 集成PHG到Shader转换功能
-"""
-
-from .visphg import vis, image
-from .shader_render import ShaderRenderer, render_shader
-from .phg_to_shader import PHGToShaderConverter, phg_to_shader
-
-# 扩展ShaderRenderer类以支持PHG直接渲染
-class PHGShaderRenderer(ShaderRenderer):
-    """支持PHG直接渲染的Shader渲染器"""
-    
-    def render_phg(self, phg_script: str, duration=0, interactive=True):
-        """
-        渲染PHG脚本
-        
-        参数:
-            phg_script: PHG脚本代码
-            duration: 渲染持续时间
-            interactive: 是否允许交互
-            
-        返回:
-            success: 是否成功渲染
-        """
-        converter = PHGToShaderConverter()
-        shader_code = converter.generate_shader_code(phg_script)
-        
-        if not shader_code:
-            print("错误: PHG转换失败")
-            return False
-            
-        return self.render_shader(shader_code, duration, interactive)
-
-# 便捷函数
-def render_phg(phg_script: str, width=800, height=600, duration=0, title="PHG Renderer"):
-    """
-    直接渲染PHG脚本
-    
-    参数:
-        phg_script: PHG脚本代码
-        width: 窗口宽度
-        height: 窗口高度  
-        duration: 渲染持续时间
-        title: 窗口标题
-    """
-    renderer = PHGShaderRenderer(width, height, title)
-    success = renderer.render_phg(phg_script, duration)
-    renderer.close()
-    return success
-
-def convert_phg_to_shader(phg_script: str) -> str:
-    """
-    将PHG脚本转换为GLSL着色器代码
-    
-    参数:
-        phg_script: PHG脚本
-        
-    返回:
-        shader_code: GLSL着色器代码
-    """
-    return phg_to_shader(phg_script)
-
-__all__ = [
-    'vis', 
-    'image', 
-    'ShaderRenderer', 
-    'render_shader',
-    'PHGToShaderConverter',
-    'PHGShaderRenderer', 
-    'render_phg',
-    'convert_phg_to_shader',
-    'phg_to_shader'
-]
-
-__version__ = "0.2.0"
-__author__ = "PHG Development Team"
-__description__ = "Python Graphics Library with PHG to Shader conversion"
-
-# 包初始化信息
-print(f"PHG {__version__} - {__description__}")
-print("PHG to Shader转换器已加载")

phg_vis-1.3.0/phg/vis/vis.ini

@@ -1,4 +0,0 @@
-CAMERA=0.000,10.000,18.000;0.000,0.000,0.000;0.000,1.000,0.000;0.724;1.610;0;10.000;0.000,0.000,0.000
-CONSOLE=true
-ENABLE_DUAL_SCREEN=false
-HOSTIP=127.0.0.1