openskp 0.1.1

A pure Dart implementation of the OpenSKP parser to extract geometry, metadata, layers, and materials from SketchUp (.skp) files.

OpenSKP — Pure Dart SketchUp Binary Parser

OpenSKP is a pure Dart library designed to parse SketchUp (.skp) binary files directly in Dart and Flutter applications without requiring any native Trimble SketchUp SDK dependencies.

---

🌟 Vision & Platform Coverage

Enable mobile (iOS/Android), desktop, and web developers to parse and build 3D SketchUp file viewer pipelines natively inside Flutter.

• Mobile: Flutter iOS & Android apps
• Desktop: Flutter Windows, macOS, and Linux
• Web: Compile client-side for browser-based parsers
• Server: Dart shelf backend parsing services

🌐 Try the Live Web Viewer (Drag-and-Drop)

---

✨ Features

• Zero Native Dependencies: 100% pure Dart implementation.
• TLV Binary Decoding: Decodes SketchUp's internal Tag-Length-Value records.
• VFF ZIP Extractors: Decompresses and validates VFF file containers to extract model.dat and material XML assets.
• Geometry & Hierarchy: Recovers vertices, edges, face loops, component definitions, and nested instance transformations.
• Steelframer properties: Reads custom dynamic component attribute values.

---

🚀 Installation

Add the library to your Dart or Flutter project:

# For Dart projects
dart pub add openskp

# For Flutter projects
flutter pub add openskp

---

💻 Quick Start

1. Parsing a SketchUp File

Open a .skp file, read the byte buffer, and load the data model:

import 'dart:io';
import 'package:openskp/openskp.dart';

void main() async {
  // Read SKP file bytes
  final file = File('my_model.skp');
  final bytes = await file.readAsBytes();

  // Load and parse SKP model
  final skpFile = SkpFile.fromBuffer(bytes);
  final model = skpFile.parse();

  print('SketchUp File Version: ${model.version}');

  // Inspect Layers
  print('Layers:');
  for (var layer in model.layers) {
    print('- ${layer.name} (RGB: ${layer.color.r}, ${layer.color.g}, ${layer.color.b})');
  }

  // Inspect Materials
  print('Materials:');
  for (var material in model.materials) {
    print('- ${material.name} (Opacity: ${material.transparency})');
  }
}

---

📐 API Data Model Reference

The public API is designed to mirror the cross-platform OpenSKP specification:

SkpModel

• String version — The parsed SketchUp application version.
• Map<int, Definition> definitions — Component geometry definitions by index.
• List<Layer> layers — Layer names and color configurations.
• List<Material> materials — Material names, color channels, and transparency values.
• InstanceNode sceneHierarchy — The root of the hierarchical instance tree.

---

📄 License

This library is open-source software licensed under the MIT License — see the LICENSE file for details.