Sweet Home 3D Forum - Print Post -

Sweet Home 3D Forum
» List all forums
» » Forum: Developers
» » » Thread: Camera Data Generator v1.1
» » » » Post: Camera Data Generator v1.1

Print at Dec 18, 2025, 3:46:40 AM

Posted by Xlance at Mar 22, 2025, 4:39:46 AM

Camera Data Generator v1.1
Camera Data Generator is a Java-based auxiliary tool designed to create camera settings files for use in the SweetHome 3D software. This tool allows users to generate detailed camera configurations, including location
(X, Y, Z), angles (Pitch, Yaw), Field of View (FOV), time zones, and more. The generated data can be exported
as a CSV file and imported into SweetHome 3D to automate camera setups for rendering or visualization purposes.

This tool provides several modes of operation to cater to different camera configuration needs:

1. Cycle Time: Automates the generation of camera data over a range of days.
2. Cycle FOV: Iterates through a range of Field of View (FOV) values.
3. Cycle YAW: Iterates through a range of Yaw (horizontal angle) values.
4. Create Circular PATH: Generates camera positions along a circular path.

Below is a detailed description of the program's functionality, commands, and operational modes.
User Guide and Command Help

Main Features

Input Fields: Start Day / End Day: Define the range of days for which camera data will be generated.
Location (X, Y, Z): Set the camera's position in 3D space.
Angles (Pitch, Yaw, FOV): Configure the camera's orientation and field of view.
Date / Time: Specify the timestamp for the camera data.
Time Zone: Select the time zone for accurate time stamping.
Circular Path Parameters (Radius, Height): Define the radius and height of a circular camera path.
Output: The generated camera data is saved as a CSV file on the user's desktop (Cameras-List.csv).

Operational Modes
1. Cycle Time

Description: Automates the generation of camera data over a specified range of days.
How It Works:
The user specifies a start day and an end day.
The program generates camera data for each day within the range.
If the interval spinner is enabled, the program divides each day into intervals (e.g., every 60 minutes).
Use Case:
Useful for creating time-lapse animations or rendering sequences over multiple days.
Settings:
Enable the "Cycle TIME (Start Day > End Day)" checkbox.
Adjust the Start Day, End Day, and Interval spinners.

2. Cycle FOV

Description: Iterates through a range of Field of View (FOV) values, generating camera data for each step.
How It Works:
The program cycles the FOV from 0.25Â° to 180Â° and back to 0.25Â° in increments of 0.25Â°.
Each FOV value corresponds to a unique camera configuration.
Use Case:
Ideal for testing how different FOV settings affect the rendered scene.
Settings:
Enable the "Cycle FOV angle (0.25Â° > 180Â° > 0.25Â°)" checkbox.
Set the desired Pitch, Yaw, and other parameters.

3. Cycle YAW

Description: Iterates through a range of Yaw (horizontal angle) values, generating camera data for each step.
How It Works:
The program cycles the Yaw angle from 0Â° to 360Â° in increments of 0.25Â°.
Each Yaw value corresponds to a unique camera orientation.
Use Case:
Useful for creating panoramic views or testing horizontal camera rotations.
Settings:
Enable the "Cycle YAW angle (0Â° > 360Â°)" checkbox.
Set the desired Pitch, FOV, and other parameters.

4. Create Circular PATH

Description: Generates camera positions along a circular path.
How It Works:
The user specifies the radius and height of the circular path.
The program calculates camera positions at evenly spaced points around the circle.
Yaw angles are automatically adjusted to align with the circular path.
Use Case:
Perfect for creating smooth camera movements along a curved trajectory.
Settings:
Enable the "Create a Circular PATH" checkbox.
Adjust the Radius and Height spinners.
Set the center coordinates (X, Y) for the circular path.

General Workflow

Launch the Program:
Open the application, and the main window will appear with input fields, checkboxes, and buttons.

Configure Settings:
Fill in the required fields (e.g., X, Y, Z, Pitch, Yaw, FOV).

Select the desired operational mode (Cycle Time, Cycle FOV, Cycle YAW, or Create Circular PATH).

Generate Data:
Click the OK button to validate inputs and generate the camera data.

A progress bar will indicate the status of the generation process.

Save Output:
Once the process is complete, the program will save the data as a CSV file on the desktop.

A confirmation message will appear.

Import into SweetHome3D:
Use the generated CSV file to import camera settings into SweetHome 3D for rendering or visualization.

Additional Notes

Time Zone Handling: The program includes a comprehensive list of time zones and their offsets.
The selected time zone affects the timestamp in the generated data.
Image Display: A world time zones map is displayed for reference when selecting time zones.
Validation: The program validates user inputs to ensure consistency (e.g., Start Day cannot exceed End Day).
Hardcoded Output Path: The program saves the generated CSV file to the user's Desktop

Conclusion

The SweetHome3D Camera Data Generator is a powerful tool for automating camera configurations in SweetHome3D. By leveraging its various operational modes, users can efficiently create complex camera setups
for rendering, animation, or visualization projects. Whether you need to cycle through time, FOV, Yaw, or create circular paths, this tool provides the flexibility and precision required for professional-quality results.

JAR file
https://www.mediafire.com/file/n0j281i51z7b9uy/CamDataGenerator-1.1.jar/file
MAP file
https://www.mediafire.com/view/d9x1drv80mmfxp0/World-Time-Zones-Map.png/file
GUI file
https://www.mediafire.com/view/l3ozldksjd9grui/CamDataGenerator-1.1.jpg/file
----------------------------------------

Windows 64bit | Intel i7 | 8GB Ram | SH3D 7.5 + Plugins

Current timezone is GMT
Dec 18, 2025, 3:46:40 AM