The IG.GFX.PhotoCreator is a tool, to download a scene from the server. It is intended to be used to create renderings. This is done together with a second tool, the Blender PhotoCreator.

The IG.GFX.PhotoCreator is located inside the IG.Graphics.Data.Tools repo. Ask the admin for access if needed. Save the latest Zip Version on your PC and unzip it.

As soon as the Zip is unpacked, the execution file can be run from the command line or the terminal.

Open a command line or terminal inside the IG.GFX.PhotoCreator folder and run the excecution file by typing it into the command line:

Command for Windows cmd

 <SomePath>\IG.GFX.PhotoCreator> PhotoCreator.exe 

Command for Linux or Mac terminal

 <SomePath>/IG.GFX.PhotoCreator> mono PhotoCreator.exe 

Because nothing is setup, the program will return all available parameters.

IG.GFX.PhotoCreator 1.2.6
Command Line Options:
        -service=<ADDRESS> - Defines the address of the IG.GFX.Server. Required.
        -job=<FILE.json> - Path to a PhotoCreator Job file, activates Job mode.
        -scene=<FILE.json> - Path to an IGXP Scene file, activates Scene mode.
        NOTE. If both -job and -scene are specified, the scene file will be processed.
        -output=<PATH> - Path where the output should be created. Default: ./Photos
        -mode={IGXC|IGX2GO|OC|OCZIP} - The output format to be created. Default: IGXC
        -geometry={OBJ|CTM|FBX} - The primary geometry format to be requested from the server. Default: OBJ
        -high-resolution - Use high-resolution assets if possible.
        -default-camera=<CAMERA> - Defines a default camera, if no camera is specified. Default: FrontRight
        -default-environment=<ENVIRONMENT> - Defines a default environment, if no environment is specified. Default: ?01
        -synchronize - In Job mode, the synchronization of the Database(s) is requested.
        -skip-assets - In IGXC mode, the asset download will be skipped.
        -help,? - Print this information.


Specify a Job file: -job=<path to json file> or a Scene file: -scene=<path to json file>
Specify the service using the -service option: -service=<service address incl. port>
License available for user XYZ

To run the IG.GFX.PhotoCreator correctly, two files need to be set up.

Requirements

• Photo.json
• create.bat
• IG.Creator Login

The first file is a so-called Photo.json file. It holds information about the project, articles, configurations, and renders settings that will be processed. This file can be downloaded from the IG.Creator or created manually. Use this Link for a table with parameters and a template script.

The second file is a so-called create batch or shell file (depends on OS), that gives the Photo.json to the server and asks for the assets and article structure. Inside this file, the parameters form the first start of the IG.GFX.PhotoCreator will be inserted.

Setting up the create file

It is recommended to save the create a file in another folder than the IG.GFX.PhotoCreator. The easiest way is to put it into a subfolder called “Create”.Make sure the create.bat & Photo.json files should be in the same folder.

Service-URL and GFX

The current url is https://3d.intelligentgraphics.biz/services/gfx/. If this address is not correct, no error is output. But you can see that no assets are loaded and stored.

Normally it is not necessary to synchronize the GFX data from IG.Creator to the GFX Server. However, you can try to trigger this sync manually at the URL https://3d.intelligentgraphics.biz/services/gfx.

For access to the required workspaces, corresponding activations in the user license may be necessary!

 <SomePath>/IG.GFX.PhotoCreator/Create> 

Inside the Create folder create the create.bat or create.sh file.

Type in the following parameters:

for Windows

REM Path to IG.GFX.PhotoCreator executable
SET IG_GFX_PHOTO_CREATOR=<SomePath>\IG.GFX.PhotoCreator\PhotoCreator.exe

REM server address to download assets
SET SERVICE=https://3d.intelligentgraphics.biz/services/gfx/

REM IG.Creator login user
SET IG_GFX_USER=XYZ

REM IG.Creator login user password
SET IG_GFX_PWD=CreatorPasswort
 
%IG_GFX_PHOTO_CREATOR% -service=%SERVICE% -mode=OC -geometry=CTM -job=Photo.json

Make sure you are not giving this file to other people while your user credentials are typed in here. In case you are going to share this file, create the IG_GFX_USER and IG_GFX_PWD as global system variables and delete them from this file

for Linux or Mac

# Path to IG.GFX.PhotoCreator executable
IG_GFX_PHOTO_CREATOR=<SomePath>/IG.GFX.PhotoCreator/PhotoCreator.exe
 
# server address to download assets
SERVICE=https://3d.intelligentgraphics.biz/services/gfx/
 
# IG.Creator login user
IG_GFX_USER=XYZ
 
# IG.Creator login user password
IG_GFX_PWD=CreatorPasswort
 
$IG_GFX_PHOTO_CREATOR -service=$IG_GFX_SERVICE -mode=OC -format=CTM -job=Photo.json

Make sure you are not giving this file to other people while your user credentials are typed in here. In case you are going to share this file, create the IG_GFX_USER and IG_GFX_PWD as global system variables and delete them from this file

Run the create file from the command line or terminal. It will download all assets and saves them inside a Photos folder.

Have a look at this folder. This folder should hold several text files as well as an index.txt file and a subfolder. Opening this subfolder leads to more subfolders, with the single assets at the end. These assets are used later to create a rendering.

After terminating the IG.GFX.PhotoCreator process a bundle of files is provided. Usually the structure looks similar to this:

-Photos
    -Domain
        -Subdomain
            + TexturesFolder.tex
            + AssetFolder.geo
    -test01-scene.json
    -test01-env.json

    -test02-scene.json
    -test02-env.json

Domain, Subdomain, TexturesFolder.tex and AssetFolder.geo hold the downloaded assets. All scene descriptions lay inside the Photos folder.

• test01-scene.json holds the scene description that is needed for renderings
• test01-env.json is holding additional rendersettings that were processed from the input.

Make sure the scene and the environment file have the same prefix. E.g. test01.

You need to specify a valid user and password by environment variables IG_GFX_USER and IG_GFX_PWD.

• Make sure to use a valid Creator login. Ask the admin for help.

Unbehandelte Ausnahme: System.ArgumentException: Illegales Zeichen im Pfad.
   bei System.IO.Path.CheckInvalidPathChars(String path, Boolean checkAdditional)
   bei System.IO.Path.Combine(String path1, String path2)
   bei PhotoCreator.Program.ProcessZip[T](String id, String loopId, T scene, String[] media, String basePath) in
XXX\PhotoCreator\Program.cs:Zeile 1330.
   bei PhotoCreator.Program.<>c__DisplayClass18_2.<Main>b__1() in
XXX\IG\ig.data.gfx\Tools\PhotoCreator\Program.cs:Zeile 735.
   bei PhotoCreator.Program.Main(String[] args) in 
XXX\IG\ig.data.gfx\Tools\PhotoCreator\Program.cs:Zeile 1151.

• Check the json file for unallowed characters
• The following characters can lead to this error
  • | inside the Id
  • ä, ö, ü, ß
• Check using valid json code

The Photos folder is empty, but no error was thrown

• Make sure the Scope and Password inside the Photo.json is correct.

Several text files are downloaded inside the Photos folder but no subfolders with assets

• Make sure the data from the IG.Creator is synchronized to the server.

Using the IG.Creator to get the Photo.json template, my article XYZ was not created automaticaly inside the Photo.json

• Make sure the article state is set to Ready for Release“ or the Export settings are set to Work in Progress.