Implemented based on Unity 2018.3.1f1, OpenCV plugin needs to be purchased separately. It supports Smart3D format camera internal and external parameter XML files.
- Create a new project.
- Add an image folder.
- Add a model file.
- Add Smart3D data.
- Set offset parameters.
- Texture mapping:
- ​Automatic mapping: Click on the "Automatic Mapping" button.
- ​Manual mapping: Set the point size and line thickness, and follow the instructions below.
- Save the project. The project saves the image path, model path, camera parameters, offset, point size, and line thickness.
HowToUse.mp4
- ObliqueMap - Automatic Texture Mapping Software for Oblique Photogrammetry Models
- 1. File
- 2. Tools
- 3. Help
- 4. Software Operation
Project files have the .omp extension (Oblique Map Project). .omp files are in XML format and store information including image paths, model paths, terrain paths, camera information, and settings panel data.
Create a new .omp project. The project name is displayed in the middle of the menu bar. If the project information changes, an * is added after the project name as a reminder.
Open a .omp project. A progress bar indicates the loading progress.
Close the current project.
Save the current project.
Save the current project as another .omp file.
Add a folder of aerial images to the project. This operation adds all .jpg images in the folder to the project, but does not include images in subfolders. When loading images, the software checks if thumbnails exist in the thumb subfolder. If not, it creates them. Note that creating thumbnails is slow, but as long as the thumbnails in the thumb folder are not cleared, the same images do not need to be processed again. The purpose of creating thumbnails is to improve the loading speed of the image filter window.
Before adding images, ensure all images are converted to .dds files in r5g6b5 format and placed in the same directory (original .jpg files are retained). Using .dds files improves the loading speed of the original images.
Add 3D models. You can select single or multiple 3D model files in the dialog box. Both white models and textured models saved during the mapping process can be added. When loading models, the software checks if UV-complete .obj files exist in the CompleteUvModel subfolder. If not, it creates them. Creating UV-complete .obj files supplements incomplete UV lists in the original white models. As long as the .obj files in the CompleteUvModel folder are not cleared, the same models do not need to be processed again.
Add terrain models in .obj format. Ensure the .obj files have correct material and texture paths.
The software currently supports Smart3D format camera internal and external parameter XML files.
Exit the software.
Set the local Photoshop path for editing extracted textures. You can select the Photoshop .exe path using the settings button or directly paste the .exe path into the input box. Ensure the path includes the .exe filename, e.g., C:\Program Files\Adobe\Adobe Photoshop CC 2018\Photoshop.exe.
Before texture mapping, the vertex coordinates of the white model should be uniformly offset to move them to a smaller coordinate range. Enter the XY offset here. The software adds this offset to the camera's external parameter position information during internal calculations. For example, x offset = -490000, y offset = -3800000.
Set the diameter of UV points in the image window.
Set the width of UV lines in the image window.
During the mapping process, each texture mapping operation generates a .jpg file in the same directory as the .obj file. However, each face of the model only uses the last generated texture. This button clears unused .jpg files, retaining only the .jpg files referenced in the material file.
During software operation, memory is recycled when loading and unloading images and models, but memory garbage may still accumulate. This button manually releases memory when memory usage is high.
Clear the camera's internal and external parameters.
This feature is not yet implemented.
Open this document.
The software interface is divided into sections as shown below. The dividers between sections can be dragged to resize them.
The project management tree is used to manage aerial images, 3D models, and terrain models in the project. Right-click on root nodes to clear or add items; right-click on leaf nodes to delete specific entries. Select multiple leaf nodes and press Delete to delete multiple entries simultaneously. Double-click an aerial image to view it in the image window; double-click a 3D model to view it in the model window.
Use the mouse wheel to zoom and the middle mouse button to drag.
Drag UV points by holding the left mouse button over a UV point; drag UV lines by holding the left mouse button over a UV line; move the entire UV area by holding the left mouse button within the UV box but not on a point or line.
This option is activated when a model is displayed in the model window. Click this button to enter editing mode. In editing mode, the software calculates the projection of the selected face in each image, sorts the images in the image filter window by projection direction, and automatically selects the first image in the image filter window for display in the image window. UV points and lines are also displayed on the image.
In editing mode, click this button to map the selected UV area to the selected face of the model. This generates a .jpg file in the same directory as the model.
Click this button to restore the image from a partial view to a full view.
In editing mode, click this button to switch to the next image in the image filter window.
Click this button to exit editing mode.
Use the mouse wheel to zoom, the left mouse button to rotate, and the middle mouse button to drag.
This option is activated when a model is displayed in the model window. Click this button to enter editing mode. In editing mode, the software calculates the projection of the selected face in each image, sorts the images in the image filter window by projection direction, and automatically selects the first image in the image filter window for display in the image window. UV points and lines are also displayed on the image.
In editing mode after texture mapping, click this button to open the local .jpg file in Photoshop.
In editing mode, click this button to refresh the texture of the selected face, typically after editing in Photoshop.
In editing mode, click this button to clear the texture of the selected face, returning it to an untextured white state. Note that the .jpg file in the model directory is not deleted.
Click this button to reset the model to the center of the model window.
In editing mode, click this button to export the model and update the .mtl material file. This operation overwrites the original .obj file, so ensure you have a backup.
Click this button to exit editing mode.
In editing mode, drag this window left or right to select images for texture mapping. Double-click an image to send it to the image window.