This is the official site for the SDK of CityEngine, a 3D city modeling software for urban design, visual effects, and VR/AR production. Using the CityEngine SDK, a number of open source plugins and APIs have been built, allowing to integrate CityEngine technology into other tools.
The CityEngine SDK can be used for the development of:
Custom importers and exporters for CityEngine.
This means the SDK enables you to develop CityEngine plugins to read or write additional 3D and image formats or your own proprietary 3D data format. A simple use case example is 3D printing where the STL geometry format is often needed. STL support is not provided out-of-the-box in CityEngine, but you can develop your own STL exporter as described below.
3D apps which need a procedural geometry engine.
The core of CityEngine is its unique geometry generation engine, called Procedural Runtime (PRT). PRT takes as input an initial geometry and then applies a given rule package (= CGA rules authored in CityEngine) to generate more detailed 3D geometry as output. For example, PRT can generate - based on given rules - a 3D model of a building out of a parcel polygon. With the SDK you can integrate PRT in your own 3D applications taking full advantage of the procedural geometry generation without running CityEngine. An interesting use case example is Palladio, a plugin for SideFX’s Houdini software. Palladio includes PRT and therefore extends Houdini with the procedural geometry engine of CityEngine. Another use case example could be a specific cultural heritage 3D application which automatically generates detailed 3D models of temples based on input attributes.
This document explains how to install the CityEngine SDK and how to work with the source-code examples contained in this repository. The CityEngine SDK is packaged into three parts:
- This git repository with the example sources.
- An archive per platform with the SDK binaries and offline documentation. The archives are attached to the releases.
- An archive with example data (e.g. rule packages and initial shapes), attached to the releases as well.
Clone or download this repository.
Download the example data and unpack it into a
datadirectory next to
examplesinside the repo:
/cityengine-sdk/ data/... examples/...
Table of Contents
- Related Software Products
- General Software Requirements
- Release History and Changelog
- CityEngine Resources
- Issues and Contributions
You can manually download the SDK archive, the open-source examples in this repository and the example data from the Assets section on the Releases page.
This repository contains a number of source code examples in the
examples directory. Each example contains a platform-specific README with detailed instructions how to build and use it:
- prt4cmd: a simple command line utility to apply rule packages onto initial shapes and generate models.
- stlenc: demonstrates how to write a custom encoder (exporter), in this case for the STL geometry format.
- stldec: demonstrates how to write a custom decoder (importer) for the STL geometry format.
Related Software Products
- PyPRT: Python language bindings for the Procedural Runtime (PRT)
- Palladio: CityEngine plugin for SideFX Houdini
- Puma: CityEngine plugin for McNeel Rhino3d
- Serlio: CityEngine plugin for Autodesk Maya
- Vitruvio: CityEngine plugin for Epic Unreal Engine
General Software Requirements
Please note that the individual example READMEs may include further requirements.
- To load custom encoders built with the latest SDK, CityEngine 2022.1 is required. For older versions of CityEngine an older version of the SDK might have to be used, see Release History. Some SDK versions don't have a matching CityEngine.
- A license for the corresponding CityEngine version. For example, a license for CityEngine 2022.1 to author Rule Packages for the current SDK release.
- CMake 3.3 or later (https://www.cmake.org)
- Windows 8.1, 10 or 11 (64bit)
- Required C++ compiler: Visual Studio 2019 with Toolset MSVC 14.27 or later
- Required flags for extension libraries release mode:
/std:c++17 /bigobj /GR /EHsc /MD(use
- RedHat Enterprise Linux 7.x, 8.x or compatible
- Required C++ compiler: GCC 9.3 or later (RedHat Enterprise Linux DevToolSet 9)
- Required flags for extension libraries:
-std=c++17 -D_GLIBCXX_USE_CXX11_ABI=0 -march=nocona -fvisibility=hidden -fvisibility-inlines-hidden -Wl,--exclude-libs,ALL
Release History and Changelog
A detailed list of changes to the API, CGA language and built-in codecs can be found in the Changelog.
- v2.7.8538 (2022-10-24, CityEngine 2022.1)
- v2.6.8300 (2022-06-16, CityEngine 2022.0)
- v2.6.8135 (2022-01-07, no matching CityEngine version)
- v2.5.7799 (2021-10-22, CityEngine 2021.1)
- v2.4.7316 (2021-05-27, CityEngine 2021.0)
- v2.3.6821 (2020-10-22, CityEngine 2020.1)
- v2.2.6332 (2020-06-09, CityEngine 2020.0)
- v2.1.5705 (2019-12-11, CityEngine 2019.1)
- v2.1.5704 (2019-09-25, CityEngine 2019.1, replaced by v2.1.5705 with minor documentation fix)
- v2.0.5403 (2019-05-08, CityEngine 2019.0)
- v1.10.4198 (2018-09-17, CityEngine 2018.1)
- v1.10.4051 (2018-05-11, CityEngine 2018.0)
- v1.9.3786 (2017-11-06, CityEngine 2017.1)
- v1.8.3501 (2017-06-29, CityEngine 2017.0)
- v1.7.2915 (2016-10-03, CityEngine 2016.1)
- v1.6.2663 (2016-06-21, CityEngine 2016.0)
- v1.4.2074 (2015-10-06, CityEngine 2015.2)
- v1.3.1969 (2015-06-17, CityEngine 2015.1)
- v1.3.1888 (2015-03-31, CityEngine 2015.0)
- v1.2.1591 (2014-09-01, CityEngine 2014.1)
- v1.1.1471 (2014-05-29, CityEngine 2014.0)
- v1.0.1209 (2014-01-15, CityEngine 2013.1)
- CityEngine Community Forum
- CityEngine Free Trial
- CityEngine Product Page
- CityEngine Resources, Tutorials, Examples, Release Notes
- CityEngine Integrations (Urban, Plugins)
- Youtube: https://www.youtube.com/c/CityEngineTV
- Facebook: https://www.facebook.com/CityEngine
- Twitter: https://twitter.com/CityEngine
Issues and Contributions
Did you find a bug or do you want to request a new feature? Please let us know by submitting an issue. Anyone and everyone is welcome to contribute and to extend and improve the examples by sending us pull requests.
The CityEngine SDK is free for personal, educational, and non-commercial use. Commercial use requires at least one commercial license of the latest CityEngine version installed in the organization. Redistribution or web service offerings are not allowed unless expressly permitted.
- All content in the "Examples" directory/section is licensed under the APACHE 2.0 license. You may obtain a copy of this license at https://www.apache.org/licenses/LICENSE-2.0.
- For questions or enquiries regarding licensing, please contact the CityEngine team at firstname.lastname@example.org.