Skip to content

Latest commit

 

History

History
56 lines (38 loc) · 2.73 KB

README_windows.md

File metadata and controls

56 lines (38 loc) · 2.73 KB
Raw

prt4cmd - CityEngine SDK Command Line Utility

Disclaimer

This is an example for using the CityEngine SDK. There is no support for this application. If you find a bug or want to enhance functionality you have to fix/do this yourself.

Prerequisites

Before you start working with this example, please make sure you follow the main installation instructions for the CityEngine SDK in the README.md file at the root of this example repository. This will explain how to get the sdk binaries and example data.

Software Requirements

  • See "General Software Requirements" (Windows)

Build Instructions

  1. Open a VS2019 x64 Native Tools Command Prompt
  2. Change into the example directory: cd <your path to>\cityengine-sdk\examples\prt4cmd
  3. Prepare build directory: mkdir build
  4. And change into it: cd build
  5. Run cmake: cmake -G "NMake Makefiles" ..\src
  6. Compile: nmake install
  7. The build result will appear in an install directory in parallal to the build directory.

Using prt4cmd

  1. Open a cmd shell and cd into the above install directory.

  2. Type bin\prt4cmd.exe -h to see the list of options.

  3. Type the following to generate the "candler" building model in the wavefront obj format:

    bin\prt4cmd.exe -l 3 -g ..\..\..\data\candler_footprint.obj -p ..\..\..\data\candler.rpk -e com.esri.prt.codecs.OBJEncoder -z baseName:string=theCandler

  4. The result is placed in a new output directory inside the install directory:

    • theCandler_0.obj
    • theCandler.mtl
    • Bunch of texture files

  5. To regenerate the same model with a different height, use the following command (note the additional -a BuildingHeight... statement):

    bin\prt4cmd.exe -l 3 -g ..\..\..\data\candler_footprint.obj -p ..\..\..\data\candler.rpk -a BuildingHeight:float=30 -e com.esri.prt.codecs.OBJEncoder -z baseName:string=theCandler

  6. The obj file will now contain a model which is 30m high instead of the default 62m.

Licensing

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.

The CityEngine SDK is licensed under the Esri Terms of Use: