CityCapture

Manual

CityCapture Manual
Setup the program

1. Set up & License

Register the license key

You need the license key for hardware mac address to use the program properly. If you run CityCapture, You will see the license manager at first.

If you send lower hardware key by email, we will send the license key by email. You have to add this license key.

-1-

CityCapture Manual
Transform the image with overview
You have to transform the image with overview for fast viewing.

1. Image Transformation

If the input type is File, a program saves all files to the output location. The file format is only TIFF.

If the input type is Folder, you have to select the input root folder and the output root folder. A program saves all files and directory to the output location with same name.

-2-

CityCapture Manual
Create new project
To operate the program, you have to create new project.

2. New Project

1. Project Name & Location

2. Coordinate System

3. Parameters

4. Limits

5. User Points

-3-

CityCapture Manual
Add the camera information
You have to insert the information of cameras

3. Setting the Camera Information

1. Camera Name

2. Sensor Information

3. Lens Distortion

-4-

CityCapture Manual
Set the DEM Information

4. Setting the DEM Information

You can add the DEM information with DEM manager. This DEM Information is used to make the georeference image and to extrude the face in process of the building modeling.

1. Add the DEM information

-5-

CityCapture Manual
Make the structural photo information

5. Preparing the Structural Photo Information

At first you have to make folders with same name of input cameras in the base directory. Next you have to make folders with the strip id in each camera directory. Finally you have to save the image files and the photo information file in each strip directory, you have to name the image file with photo id. The photo information file name is exactly PhotoInfo.txt. 1. Folder
Photo Base Directory
Camera Name Folder

Strip ID Folder

2. File
Image Files with Photo ID

Information File with EOP of Photo ID

-6-

CityCapture Manual
The photo information files file format(PhotoInfo.txt)

5. Preparing the Structural Photo Information

The photo information file includes the EOP(Exterior Orientation Parameter) information of each photo id. The Photo ID is same with image file name, and the view geometry value is 0 (Vertical) or 1(oblique). The example is as in the following.
Photo ID x

omega

phi

kappa

View Geometry

-7-

CityCapture Manual
Load the photo information
You can load the structural photo information at once with strip wizard.

6. Loading the Photo Information

1. Select the photo base directory

-8-

CityCapture Manual
Make the georeference image

7. Making the Georeference Image

You can make the georeference image of each photo. In case of no DEM file, the average ground elevation of the project information is used to make the geometric correction image. If there are the DEM files, the DEM information is used to make the ortho rectification image.

1. Set the configuration of making image Basically the program makes the georeference image for only vertical photo. If you want to make image for a oblique photo, Set the configuration of Apply the oblique images.

Basically the program makes the geometric correction image in use of the average ground elevation. If you want to make the ortho rectification image, Set the configuration of Make the ortho rectification image using a dem data.

-9-

CityCapture Manual
Add the workspace

1. Adding the Workspace

To process the building modeling, you have to make the workspace area. The workspace will include many buildings. After selecting the Add workspace menu, Digitize the workspace area in a project preview window. If you want to finish digitizing the workspace area, Double-click the left mouse button.

1. Input the workspace information

- 10 -

CityCapture Manual
Add the building

2. Adding the Building

You can make new building in the current selected workspace. After selecting the Add building menu, Digitize the building area in a project preview window. If you want to finish digitizing the building area, Double-click the left mouse button. After entering the building information, Click OK button, and then the process of the building modeling will be executed.

1. Input the building information

- 11 -

CityCapture Manual
Select the left or right photo

3. Building Modeling

Using the popup menu in a search photo list window, you can open the photo which is selected in a search photo list. After focusing the left or right work viewer. Press Page Down key or Page Up key, and then the next or prior photo is opened.

Make the 3d object

You can make the 3d object using the Shape Extraction menu, The 3d objects are point, polyline, polygon, circle, arc, cone, sphere, dome. In process of the shape extraction, you need to digitize the shape in a left work viewer at first. After you finish digitizing the conjugate points of the left digitized points in a right work viewer, you will see the created 3d object If you want to set same height of all points, after digitizing only first point in a right work viewer, Click the mouse right button to finish.
Icon Point Polyline Polygon Ortho Polygon Circle(Center, Radius) Circle(3 Point) Arc(3 Point)
Diagonal Rectangle Fixed 2P Rectangle 3P Rectangle 4P Rectangle Cone

Description

Sphere Dome

- 12 -

CityCapture Manual
Control the viewers display in extracting a shape
1. Control the viewers display by mouse

3. Building Modeling

While you digitize the shape in a left work viewer, you can move the display area with the mouse drag & drop. You can toggle the move mode with TAB key. => Mouse cursor in a move mode 2. Control the viewers display by keyboard
Key , , , Shift + a, s, d, w
Shift + e Move the view area (left, up, right, down)

Description

Move the view area (left, down, right, up) Change the display color

Edit the shape in extracting a shape

Before you digitize the object in a right work viewer, you can edit the shape in a left work viewer. You can toggle the edit mode with ESC key. => Mouse cursor in a edit mode
1. Undo and Redo
Action Ctrl + r Ctrl + z
Ctrl + y Initialize the shape edit information

Description

Undo the shape edit Redo the shape edit

- 13 -

CityCapture Manual
2. Move the point You can move the point with the mouse drag & drop. 3. Move the edge

3. Building Modeling

After you location the mouse on a edge, you can move the edge with the mouse drag & drop while pressing SHIFT key.

4. Add the point You can add the point on a edge.

5. Remove the point You can remove the point with a mouse right button.

6. Split and move the edge After you location the mouse on a edge, you can split the edge and move the edge with the mouse drag & drop while pressing CTRL key.

- 14 -

CityCapture Manual
Extend the 3d object
You can extend the 3d object using the Advance Modeling menu. You can use this process in a left or right work viewer.

3. Building Modeling

Icon

Description
Select the 3d object

Menu

Description Select the extrude direction Vert. : Vertical direction(z axis) Hor. : Horizontal direction(orthogonal of z axis) Ortho. : Normal direction of the face

Direction Make the face on a face

Make the reduced face on a face Draw the edge(Connect two points)
Connect two 3d objects

Extrude Options DEM Select the DEM extrude type By Point : Extend the point by point on a DEM Fitting : Plane fitting for all points Flatten : XY parallel plane with a minimum height
Select the face type

Extrude the face Extrude the face on a DEM

Shape Options

Free On-Face Curve Polygonizing

Set the polygonizing of the curve surface

- 15 -

CityCapture Manual
1. Make the face on a face

3. Building Modeling

After you select the target face, Digitize the face. While digitizing the face, you can remove the last point with DELETE key. If you want to cancel the process, Click the mouse right button or Press ESC key. 2. Make the reduced face on a face After you select the target face, Select the edge of the face and Move the mouse. You will see the reduced face. If you want to cancel the process, Click the mouse right button or Press ESC key. 3. Draw the edge(Connect two points)
After you select the point, Connect the next point. You will see the edge. If you want to cancel the process, Click the mouse right button or Press ESC key.

4. Connect two 3d objects

After you select the 3d object, Connect the next 3d object. You will see new faces and edges. If you want to cancel the process, Click the mouse right button or Press ESC key.

- 16 -

CityCapture Manual
5. Extrude the face

3. Building Modeling
After you select the target face, Move the mouse. You will see the extruding face. If you want to input the extrude height, Press F12 key while extruding the face. If you want to cancel the process, Click the mouse right button or Press ESC key.

Press F12 key

6. Extrude the face on a DEM If you select the target face, you will see the face which extruded on a DEM.
6.1 DEM Options : By Point After projecting all points onto a DEM, it connects two neighboring points. You will see no bottom face.

6.2 DEM Options : Fitting After projecting all points onto a DEM, it calculates the fitting plane for all points. You will see the bottom face.

6.3 DEM Options : Flatten After projecting all points onto a DEM, it projects all points onto the XY parallel plane with minimum height of all projected points. You will be the bottom face.

- 17 -

CityCapture Manual
Edit the 3d object in a 3d viewer

3. Building Modeling

You can process the building modeling in a 3d viewer. There are several menus which is only processed in a 3d viewer. Select & Move, Align face to face, Align shell to face, etc.

Icon

Description
Connect two points(Draw the edge)

Key
F2

Description
Change the display mode of the selected face

Connect two objects Extrude the face Extrude the face to a face
Select the object

F9
p

Display the edge with one face In case of selecting t wo faces, Align th e f ace to a face Hide the selected face Show all hidden faces

h u

Select

Select the surface Select the shell

Select and move the shell

Align the face to a face

Align the shell to a face

- 18 -

CityCapture Manual
1. Connect two points(Draw the edge) After you select the point, Connect the next point. You will see new edges and faces. If you want to cancel the process, Click the mouse right button.

3. Building Modeling

2. Connect two objects After selecting the object, Select the next object. You will see the linked line with a blue line. If you want to connect two objects, Press Enter key or Double-click the mouse left button on a next object. You will see new faces and edges. If you press Back key in the second step, the step is changed a first step. 3. Extrude the face After you select the target face, Move the mouse. You will see the extruding face. During extruding the face, if you click the mouse right button, you can use the popup menu for a extrude direction.

4. Extrude the face to a face After you select the target face, Select the reference face. You will see the extruded line and face with a blue line. Now if you click the mouse right button, you can use the popup menu for a extrude direction. If you want to extrude the face to a face, Press Enter key or Double-click the mouse left button on a reference face. You will see new extruded face. If you press Back key in the second step, the step is changed a first step.

- 19 -

CityCapture Manual
5. Select You can select the object.

3. Building Modeling

Key z x c
v

Description During p ressing the key, it select th e fac es which will be with a connection angle below the specific angle for the selected face.
During pressing the key, it automatically select th e volu me for the selected face.

During pressing the key, it select the face.

During pressing the key, it select the edge.

b Control Shift
Delete

During pressing the key, it select the point. Multi selection Clear the selection information
Delete the selected objects.

Space

Change the Camera direction to a selected faces normal direction

6. Select and move the shell After selecting the volume, you can move the volume with the mouse drag & drop. The horizontal position of this volume is only changed, and the vertical position of this volume is not changed.

7. Align the face to a face After you select the target face, Select the reference face. You will see the aligned face with a blue line. If you want to align the face to a face, Press Enter key or Double-click the mouse left button on a reference face. You will see new aligned face. If you press Back key in the second step, the step is changed a first step.

- 20 -

CityCapture Manual
8. Align the shell to a face

3. Building Modeling

After you select the target face of the aligned shell, Select the reference face. You will see the aligned shell with a blue line. You take notice that you select the target face of the aligned shell, because of it is the different aligned shell for each selected target face. If you want to align the shell to a face, Press Enter key or Double-click the mouse left button on a reference face. You will see new aligned shell. If you press Back key in the second step, the step is changed a first step.

- 21 -

CityCapture Manual
Make the texture of the building automatically
You can automatically make the texture of all faces in a building.

4. Texture

1. Select the option of removing a existing texture

Make the texture of the building manually

You can manually make the texture of the face in a building.

1. Select the option of editing a texture

- 22 -

CityCapture Manual

4. Texture

1.1 Use Resampling You can set the texture mapping information on the basis of the faces OBB(Oriented Bound Box). Because of each faces point is adjusted by the adjustment of OBB, the extracted texture image is saved in the shape of OBB;s rectangle with interpolation on the basis of the faces OBB(Oriented Bound Box). Because of this transformation is two-dimensional, this option is not used for the multi-faces with no same plane.

1.2 No Use Resampling You can set the texture mapping information on the basis of the faces all points. The extracted texture image is saved with no interpolation. 2. Set the texture mapping information After selecting the photo in a texture photo list, you can set the mapping information of the face in a photo image viewer. If you want to extract the texture, Select the Select Texture menu of the Command group at a top menu.
Icon Description

Set the texture mapping information of the face(Edit Face) Display the faces texture in a 3d viewer in real time Key a, s, d, w
Shift + a, s, d, w Shift + + Shift + - Shift + p Shift + t Ctrl + r Ctrl + z Ctrl + y Shift + e

Desctription Move the view area (left, down, right, up) Move the face (left, up, right, down) Zoom in the face Zoom out the face Display the index of the point, or not Display the interior mesh line of the face, or not Initialize the texture edit Information Undo the texture edit Redo the texture edit Change the display color

- 23 -

CityCapture Manual
2.1 The mode of Edit Face In this mode, you can set the texture mapping information of the face. You can move the face and each point.

4. Texture

=> Mouse cursor in a point move mode

=> Mouse cursor in a face move mode while the face is selected

2.2 Set the texture mapping information of the multi faces You can set the texture mapping information of the multi faces. If the edit option is No Use Resampling, the additional keyboard shortcut is as in the following.
Key
Shift + g Chang e th e depth w hile selecting one point in the overlap points

Description Initialize the Snap & Select Depth Information

Increase the Snap & Select Depth

Shift + h
Shift + Select the face Shift + Move the point

Snap & Select the single face Snap & Stick the point of another face

- 24 -

CityCapture Manual
Initialize the texture information of all faces in the building
You can remove all texture and initialize all texture mapping information in this building.

4. Texture

View the texture image

Using the popup menu in the face list window, you can view the texture image of each face.

1. Set the UV mapping information You can set the UV mapping information of the face in a viewer. If you want to save the UV mapping information, Select the Apply UV Mapping menu of the Command group at a top menu.
Icon Description Set the UV mapping information of the face(Edit Face)

- 25 -

CityCapture Manual
Key a, s, d, w Shift + a, s, d, w Shift + + Shift + - Shift + p Shift + t Shift + x Shift + b Ctrl + r Ctrl + z Ctrl + y Shift + e Desctription Move the view area (left, down, right, up) Move the face (left, up, right, down) Zoom in the face Zoom out the face Display the index of the point, or not Display the interior mesh line of the face, or not Display the textures boundary, or not Display the faces MBR, or not Initialize the UV edit Undo the UV edit Redo the UV edit Change the display color

4. Texture

1.1 The mode of Edit Face In this mode, you can set the UV mapping information of the face. You can move the face or MBR and each point. => Mouse cursor in a point move mode
=> Mouse cursor in a face move mode while the face is selected

1.2 Set the UV mapping information in use of the faces MBR While displaying the MBR with Shift+b, You cant edit each point and face. You can only edit the MBR, and this process is as in the following.

- 26 -

CityCapture Manual
1.2.1 Rotation

4. Texture

If you move the mouse on the corner point of the MBR, you will see the changed cursor. Now you can rotate all faces in the basis of the MBRs origin.
=> Mouse cursor in a MBR rotation mode

1.2.2 Resizing If you move the mouse on the edge of the MBR, you will see the changed cursor. Now you can resize the width or height of the MBR, and then the aspect ratio of all faces will be changed. => Mouse cursor in a MBR resizing mode

1.3 Set the UV mapping information of the multi faces You can set the UV mapping information of the multi faces. The additional keyboard shortcut is as in the following.
Key Shift + g
Shift + h

Description Chang e th e depth w hile selecting one point in the overlap points
Snap & Select the single face Snap & Stick the point of another face

Initialize the Snap & Select Depth Information Increase the Snap & Select Depth

Shift + Select the face Shift + Move the point

- 27 -

CityCapture Manual
View the 3D modeling

5. Viewing the 3D Modeling in Workspace

You can view all building model of the selected workspace in the 3d model viewing window.

- 28 -

CityCapture Manual
Export the Workspace

1. Export the Building Modeling

You can export all building models of the workspace. After selecting the Export Building menu, Select the workspace ID.

Export the Workspace By Building

Using the popup menu in the workspace list window, you can export each building model of the selected workspace.

Export One Building

Using the popup menu in the building list window, you can export the selected building model of the current workspace.

- 29 -