The show editor

The show editor

When you start FWsim, the show editor appears. In this window, you can plan shows and access the other parts of the software (e.g. the firework effect editor, preferences, settings).

The 3D view shows the firing place, your firework, and the firing positions. In the timeline, you can change the ordering and timing of fireworks. From the toolbox, you can add new firing cues as well as music and camera key frames. The sidebar shows the settings for the currently selected cue. It also gives you access to the firing positions, camera settings, and functions for modules and data export (in FWsim Pro). Via the menu bar on top, many other features can be reached.

Fullscreen Mode

FWsim Pro by default starts in windowed mode. FWsim Basic & Creative Edition start in Fullscreen mode. You can switch between Fullscreen and windowed mode by using the “View” menu in the Show Editor. If you’re in fullscreen mode and want to switch to other applications, use the ALT+TAB Windows shortcut.

Adding cues and arranging them in time

  1. In the toolbox, click on “Single Shot”.
  2. A window appears, where you can select an effect.
  3. Click into the timeline. A new cue will be added to the timeline. The cue contains the name of the selected effect and its calibre.

In the timeline, time runs from left to right. The horizontal tracks have no particular meaning: you can move your cues freely up and down these tracks, to organize your show better.

Adding more vertical tracks

If you need more vertical tracks, just click a cues with the left mouse button, hold it, and drag downwards. New tracks will appear.

Arranging effects in space

Select a single shot or stepper in the timeline. In the 3D view, a mortar appears, which shows you the location. In the case of a stepper, multiple mortars appear with arrows designating the start and end of the stepper.

To move a mortar or arrows, click them and leave the mouse button pressed. Then you can move them with your mouse. To rotate them left or right, hold the right mouse button and move your cursor sideways. To get a better result, you can click on the cue and set the rotation (and other properties) via the sidebar settings, especially if you wanna use an exact and specific value.

Cues in detail

Select a cue in the timeline. Then, you can edit its properties in the sidebar. More functions are also available in the “Edit” menu on top, and via right-click on the cue.

Single Shots

To change the effect, click on the top left button or just press F2. The box to its right allows selection of firing position (see Positions). Under “Rotation”, you can change the mortar angle. Please note: in FWsim, you can rotate mortars left/right. In FWsim Pro, you can rotate along all axis (left/right, front/back, and also rotating the shell inside the mortar).

Stepper

With a stepper, you have the same options as with single shots. Furthermore, you can adjust:

Multi Selection Rectangle

It is now possible to select multiple cues. A white rectangle appears. It allows you to change the duration of the entire selected block (so the cues will move closer together or further apart in time). This feature is available in FWsim Pro only.

Smart Clone

Select one or multiple single fireworks (but not steppers), right-click on them in the timeline, and select “smart clone”. This feature is available in FWsim Pro only.

Music

To add music, click the “Music” button. You will then be asked for a filename. Select your file and click “OK”. Then, you can click into the timeline to add the music.

FWsim 3.0 supports most common audio formats: WAV, MP3, FLAC, OGG, AIFF. Unfortunately, the AAC format (used for Apple iTunes) is not supported. If you need to use AAC files, please use this converter to convert it to the FLAC format - without losing quality. Note that the music player software on your computer might not be able to open FLAC files - but FWsim can.

However, please note that you cannot use Music CDs with FWsim. This is because music CDs contain their data in a special file format. To convert CD music to audio files, you can use free software like Exact Audio Copy.

Note for users of FWsim Pro: When working with firing systems, please be aware that many firing systems require your music to start exactly at 0:00. To ensure that this is the case, grab the music cue with your mouse and move it towards the left as far as possible.

How to use music from YouTube in FWsim

To get music from YouTube into FWsim, without losing quality, please use this YouTube to FLAC converter. Note that the music player software on your computer might not be able to open FLAC files - but FWsim can.

How to use multiple pieces of music

It is possible to add multiple pieces of music into the timeline. However, you cannot edit the music files within FWsim.

If you want to add multiple pieces of music, and you have one continuous show that plays in one go, we recommend you edit the music using the free Audacity software. When you are finished editing, export your file as WAV for optimum quality.

Cameras

In FWsim, shows are displayed in a virtual 3D world. Since each show will have different arrangements and sizes, it is important to adjust the camera settings.

In the sidebar, click the “Camera” tab:

Click static to define a camera position right in the sidebar.

Click moving if you want to use a moving camera in your show.

You need to select Edit Moving Camera first and add keyframes (more on that below).

You can always switch between both options without losing your settings.

Types of Camera

With the normal camera, you can just adjust distance to the firing site and height.

The helicopter camera allows you 360° flight around the firing site. This is the best option if yo are looking for a realistic “drone effect” in your simulation.

The Free Camera can be moved freely using mouse and keyboard. Please refer to the instructions on the screen.

The View from Above is useful for precise positioning, and for getting a good impression of the site layout.

Saving and Loading Static Camera Positions

When using the Static Camera, use the “Save” icon in he sidebar to remember your camera position. The position is the stored in the show, and you can always go back to it later.

To quickly switch between these stored positions, use the shortcuts CTRL + 1, CTRL + 2 etc.

Setting up Camera Moves

If you want the camera to move during the show, select Edit Moving Camera in the sidebar. This will open a new area on top of the timeline, in which you can configure camera moves.

To add a new animated camera position, move the playback cursor to the desired position and press “Add Camera Keyframe” in the toolbox. To make the camera actually move, you need at least two different positions at different times.

Click a camera keyframe to adjust its properties. You can press DELETE to remove a keyframe. You can select multiple keyframes by holding the SHIFT key, and you can copy / paste keyframes.

Importing Camera Move Data from other 3D applications (FWsim Pro)

You might want to composit FWsim videos together with animation designed in other 3D software. For that, you need to match up the cameras between FWsim and other 3D applications.

FWsim allows you to design a camera move in other applications, then import that camera data. It is also possible to import a static camera, it doesn’t need to be animated.

The instructions below are written for the open-source Blender 3D animation software. If you need help getting camera moves from other software into FWsim, please let us know.

  1. Before continuing, make sure you have FWsim Pro v3.5.0.14 or later version.
  2. In Blender, please check that the camera positions are baked into the camera itself. The camera must not be a child object of some other animated object. To do that, please click the camera and press “N”. Then, move through the timeline. You should see the correct position and rotation values of the camera as they change over time.
  3. Select the camera only.
  4. Click File → Export → “Collada (.dae)”
  5. Activate “Selection Only” on the right
  6. Now we need to adjust the coordinate system. The FWsim coordinate system is different from the Blender coordinate system. The FWsim coordinate system is laid out like this: X to the right, Y upwards, Z into the screen. Under “Global Orientation”, select “Forward Axis: -Z” and “Up Axis: Y”. Leave the “Apply” checkbox unchecked.
  7. Unter “Anim” on the right, activate “Include Animations”. The “Key Type” must be set to “Samples” and the sampling rate must be set to 1.
  8. Save that .dae file
  9. In FWsim Pro, open your show or create a new one
  10. Set the camera type to “Edit Moving Camera”
  11. If there is already a moving camera configured, click Show → “Delete All Camera Moves”.
  12. Click Show → “Import Camera Move from other 3D Software” and select your .dae file
  13. If everything goes well, you will see the upper part of the timeline filled with orange icons. There will be one keyframe icon for each frame of imported camera animation.
  14. Set the camera type to “Moving” in order to see your camera move, or set it to “Static” in order to view your show from other positions.

Edit multiple cues at once

Hold SHIFT and then click several cues. You can now adjust all cues at once (e.g., change the effect, delete, copy, paste or move).

Alternatively, you can also drag a rectangle with the mouse in the timeline: Click on an empty area in the timeline, hold down the left mouse button, and then move your mouse in the timeline area.

Video Export

Click File → “Export Video” to produce a high-quality video of your show.

Choosing a file format (AVI or MP4)

You have the option to select the AVI or the MP4 file format. If you want to process FWsim files in other software (for example, in your video editor), then you should select the MP4 file format. Otherwise, it doesn’t matter.

The two file formats (AVI and MP4) will contain the exact same video data, so there is no difference in video quality. And there is no practical difference in audio quality: The AVI file contains WAV audio, which is 100% lossless. The MP4 file contains MP3 audio with a bitrate of 320kbit, which offers the same high quality for all practical purposes.

The “Edit” menu

This menu provides the following functions:

The “Show” menu

Working with two monitors (only in FWsim Pro)

In the “View” menu, you can change to two-monitor mode. On one monitor, you can place the timeline, and on the second one view the show.

Positions

The term “positions” refers to lines or points on which firework effects are placed in the simulation and in the reality.

It is not necessary to use positions at all - you can also place your mortars anywhere in space. However, in practice it will be very helpful to work with the “Positions” feature even if you are not a professional user: you will be able to move fireworks around the scenery by just one click instead of dragging effects with the mouse. Also, positions are essential if you are creating a show that involves 3D models.

Creating positions and aligning effects

In the sidebar, select “Positions”. There, you can add, remove or modify positions.

At the same time, your positions (points or lines) will be shown in the 3D world:

You can now move these positions in the 3D view, or enter the exact positions in the sidebar fields.

If you move effects in the 3D world, they will automatically snap onto positions. If you do not want your effects to snap, hold the CTRL key while you move them.

Change Height (only FWsim Pro)

In FWsim Pro, it is possible to change the height of positions. For that, activate the box “Set Height”, and adjust the height using the slider. When your position is a line, you can also setup a slope, so that start- and endpoint are on different heights.

Working with steppers and positions

When you place steppers on positions, please be aware:

If you span a stepper from one position to a different position, internally only the start- and endpoint will be on a position, the other shots will have no position assigned to them. Therefore, if you export a firing plan, no position information will show up for the shots in the middle. To circumvent this problem, we suggest to place steppers always on “Line” positions. For future versions of FWsim Pro, we plan to make it possible to place steppers through multiple positions.

If you place steppers on “line” positions, then FWsim remembers the position, the angle and the number of shots of the previously seleted stepper and uses it when placing the next stepper.

The position of a stepper is always stored relative to its position. For example, if you create a stepper that covers 50% of a line, and then put this stepper on a different line, then it will also cover 50% of the space there.