CitySketch User Manual

CitySketch is a visual CityJSON editor with interactive building placement, basemap overlays, and real-time 3D height editing.

Contents

User Guide

• 1. Getting Started
  • 1.1. Installation
  • 1.2. First Launch
  • 1.3. Your First Project
  • 1.4. Understanding the Interface
  • 1.5. Coordinate Systems
  • 1.6. Files
  • 1.7. Troubleshooting
• 2. User Interface
  • 2.1. Interface Overview
  • 2.2. Menu Bar
  • 2.3. Toolbar
  • 2.4. Canvas
  • 2.5. Mouse Interaction
  • 2.6. Status Bar
  • 2.7. Keyboard Shortcuts
  • 2.8. Context Sensitivity
  • 2.9. Customization
• 3. Creating Buildings
  • 3.1. Building Creation Modes
  • 3.2. Advanced Building Techniques
  • 3.3. Building Properties
  • 3.4. Troubleshooting Creation Issues
  • 3.5. Quality Control
• 4. Editing Buildings
  • 4.1. Building Selection
  • 4.2. Building Properties
  • 4.3. Building Geometry
  • 4.4. Advanced Editing Operations
• 5. Basemaps and GeoTIFF
  • 5.1. Understanding Basemaps
  • 5.2. Configuring Basemaps
  • 5.3. Working with Map Tiles
  • 5.4. Performance Considerations
  • 5.5. Basemap vs. Performance Trade-offs
  • 5.6. GeoTIFF Overlay Support
  • 5.7. Loading GeoTIFF Files
  • 5.8. GeoTIFF Display Options
  • 5.9. Layer Order
  • 5.10. Coordinate System Handling
  • 5.11. Coordinate System Warnings
  • 5.12. GeoTIFF Optimization
  • 5.13. Data Type Handling
  • 5.14. Troubleshooting GeoTIFF Issues
  • 5.15. Display Problems
  • 5.16. Integration Strategies
• 6. 3D Visualization
  • 6.1. 3D View Overview
  • 6.2. Accessing 3D View
  • 6.3. 3D View Interface
  • 6.4. 3D Navigation Controls
  • 6.5. Visual Quality Settings
  • 6.6. Snapshot Export
  • 6.7. Troubleshooting 3D Issues
• 7. File Formats
  • 7.1. CitySketch Project Format (.csp)
  • 7.2. GeoJSON Format (.geojson)
  • 7.3. AUSTAL Format (austal.txt)
  • 7.4. GeoTIFF Overlay Support
  • 7.5. File Format Comparison
  • 7.6. Settings File Format (settings.ini)
• 8. Keyboard Shortcuts
  • 8.1. Quick Reference Card
• 9. Troubleshooting
  • 9.1. Installation Issues
  • 9.2. GeoTIFF Issues
  • 9.3. Getting Additional Help
  • 9.4. Common Error Message Reference

Technical Reference

• API Reference
  • Building Class
  • MapCanvas Class
  • Utility Functions

Appendices

• License
• Acknowledgments

Key Features

• Interactive Building Creation

• Real-time 3D Visualization

• Basemap Integration

• GeoTIFF Overlay Support

• CityJSON Export

• AUSTAL Integration

Quick Start

1. Launch CitySketch

2. Select a basemap location

3. Add buildings with toolbar buttons

4. Edit properties with number keys

5. View in 3D with F3

6. Save your project

Indices and tables

• Index

• Module Index

• Search Page