Blender Web Pipeline

# Blender Web Pipeline Assets

Template files and resources for Blender to web workflows.

## Included Assets

### export_template.blend
Pre-configured Blender template with:
- Optimized export settings
- PBR material setup
- LOD examples
- Proper UV unwrapping

### shader_library/
Collection of web-optimized PBR shaders:
- Basic PBR material
- Emissive material
- Transparent material
- Metallic material

## Usage

1. Open `export_template.blend` in Blender
2. Replace placeholder geometry with your models
3. Use pre-configured materials from shader_library
4. Export using File → Export → glTF 2.0 (.glb)
5. Test in web viewer before deploying

## Quick Start

```bash
# Open template
blender export_template.blend

# Or use as base for new projects
blender --factory-startup export_template.blend --save-as mynewproject.blend
```


# Blender Python API Quick Reference

Essential bpy (Blender Python) API commands for automation.

## Accessing Data

```python
import bpy

# Scene and Objects
bpy.context.scene  # Active scene
bpy.data.objects  # All objects
bpy.data.objects['Name']  # Get object by name
bpy.context.selected_objects  # Selected objects
bpy.context.active_object  # Active object

# Collections
bpy.data.collections  # All collections
bpy.context.collection  # Active collection

# Materials and Textures
bpy.data.materials  # All materials
bpy.data.images  # All images/textures

# Meshes
bpy.data.meshes  # All mesh data
```

## Object Operations

```python
# Selection
bpy.ops.object.select_all(action='SELECT')  # Select all
bpy.ops.object.select_all(action='DESELECT')  # Deselect all
obj.select_set(True)  # Select specific object

# Transformation
obj.location = (x, y, z)
obj.rotation_euler = (rx, ry, rz)
obj.scale = (sx, sy, sz)

# Modifiers
modifier = obj.modifiers.new(name='Name', type='TYPE')
bpy.ops.object.modifier_apply(modifier='Name')

# Duplication
new_obj = obj.copy()
new_obj.data = obj.data.copy()
bpy.context.collection.objects.link(new_obj)
```

## Mesh Editing

```python
# Edit Mode
bpy.ops.object.mode_set(mode='EDIT')

# Common Operations
bpy.ops.mesh.select_all(action='SELECT')
bpy.ops.mesh.remove_doubles(threshold=0.0001)  # Merge vertices
bpy.ops.mesh.quads_convert_to_tris()  # Triangulate
bpy.ops.uv.smart_project()  # UV unwrap

# Return to Object Mode
bpy.ops.object.mode_set(mode='OBJECT')
```

## File Operations

```python
# Open File
bpy.ops.wm.open_mainfile(filepath='/path/to/file.blend')

# Save File
bpy.ops.wm.save_as_mainfile(filepath='/path/to/file.blend')

# Import/Export
bpy.ops.import_scene.obj(filepath='/path/to/model.obj')
bpy.ops.export_scene.gltf(filepath='/path/to/model.glb')
```


# Blender glTF Export Complete Guide

Reference guide for glTF 2.0 export settings and options in Blender.

## Export Format Options

```python
export_format='GLB'  # or 'GLTF_SEPARATE' or 'GLTF_EMBEDDED'
```

- **GLB**: Single binary file (recommended for web)
- **GLTF_SEPARATE**: JSON + separate .bin + separate textures
- **GLTF_EMBEDDED**: JSON with embedded Base64 data (large file)

## All Export Parameters

```python
bpy.ops.export_scene.gltf(
    # File Settings
    filepath='/path/to/output.glb',
    export_format='GLB',  # 'GLB', 'GLTF_SEPARATE', 'GLTF_EMBEDDED'

    # Include Settings
    use_selection=False,  # Export selected objects only
    use_visible=False,  # Export visible objects only
    use_renderable=False,  # Export renderable objects only
    use_active_collection=False,  # Export active collection only
    use_active_scene=False,  # Export active scene only

    # Transform Settings
    export_yup=True,  # Y-axis up (default for glTF)
    export_apply=False,  # Apply modifiers (True recommended)

    # Data Settings
    export_texcoords=True,  # UV coordinates
    export_normals=True,  # Normals
    export_draco_mesh_compression_enable=False,  # Enable Draco compression
    export_draco_mesh_compression_level=6,  # 0-10 (higher = smaller + slower)
    export_draco_position_quantization=14,