Quantcast
Channel: Phoenix Firestorm Project - Wiki
Viewing all 5258 articles
Browse latest View live

fs_voice - Updated

$
0
0

Voice Issues

Please note: Viewers play a minor part in voice functionality. The bulk of voice support is given by the external application called SLVoice, which is made by the SL voice provider, Vivox. Voice failures are almost always due to one of the following reasons:

  • Your ISP is throttling or blocking the voice service;
  • failure of the Vivox service;
  • voice issues on the region you are on;
  • voice being throttled by bandwidth set incorrectly - please check it by following the instructions here;
  • voice hardware (mic, headset) not configured correctly in your operating system settings;
  • voice hardware not configured correctly in the viewer;
  • another application has your voice hardware in use (example, Skype);
  • your anti virus software has “mangled” the voice application; see steps on this page: here.

  • your firewall is blocking slvoice. Add slvoice to your firewall's exclusion/allow list.
Please go to Voice Echo Canyon when trying to get voice to work. If voice is working correctly for you, anything you say there will be echoed back to you. Once there, relog to last location.

If you get this error message: Unable to connect to voice server 'www.bhr.vivox.com'

The IP address of the server 'www.bhr.vivox.com' recently changed to 74.201.103.238 so anyone having a problem can check to see what address their system sees for that name - if it's not that address, it's probably wrong. A simple reboot may resolve this issue. If not, see DNS Fail - General steps for help fixing this.

nslookup command how-to: WindowsMacLinux

Since 4.7.9, voice has not always connected to the voice servers. This is due to some coding issues that we inherited from the official SL viewer and that code's interaction with the latest voice files. The issue is documented on LL's Jira. A workaround is to disable and then re-enable voice. But if you're presented with the voice connection failure message that tells you “Voice communications will not be available”, you may need to disable voice and then relog before voice will try to reconnect.

Steps:

  • Go to Preferences → Sound & Media → Voice, and untick “Enable Voice.”
  • Relog.
  • Wait 10-20 seconds, or until the viewer has finished rezzing the scene.
  • Re-enable voice.

Version 5.1.7., voice crashes when turning on microphone. See BUG-225293 and FIRE-22940
Fixed Firestorm-Beta 6.0.1.
Note that the SLVoice executable in this viewer is not compatible with most older viewers; do not copy it into other viewers.http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.8.518593

Disable When Not in Use

Most voice connection issues happen when the viewer tries to connect to voice during the login process. The workaround is to disable voice before you log out, and then only enable it after logging in when you need it. You can toggle Voice from the Media Controls at the top of the viewer (not enabled by default for Vintage or Latency skins) by hovering over the speaker icon and then checking or unchecking the last checkbox, or by going to Preferences ⇒ Sound & Media ⇒ Voice and checking or unchecking the top option.

Ensure Headset Properly Connected

If you have issues hearing but not being heard, or vice versa, then make sure that your headset is properly connected to your computer. Unplug it, then plug it back in, making sure it is fully inserted.

And on a related note, if you plug your headset in while logged into SL, you will very likely have to relog to get it to be recognised.

Check Voice Settings in your Operating System

Due to the many different versions of each operating system (Windows, Linux distros, Mac OSx's), it is very difficult to give specifics for each one. Nonetheless, make sure that your operating system is correctly configured for voice: that voice is going to your headset (or speakers, as you prefer), and that your mic is enabled and configured.

If you can hear people but cannot be heard, or vice versa, it is most likely a problem in this area.

A bit more specifically, for Windows and Linux, check in Mixer that SLvoice is listed, and not muted. Check that input and output devices are correct. For Mac, look in the Sound Preference pane.

Voice doesn't work when Skype is on, or sounds don't work while using voice:

  1. In Windows Control Panel > Hardware & Sound > Manage Audio Devices
  2. Select the Recording tab, select the microphone, select Properties
  3. Select the Advanced tab - untick 'Allow applications to take exclusive control of this device' - click OK
  4. Select the Communications tab
  5. Select 'Do Nothing' - click OK

Some details provided below.

Check Voice Settings in the Viewer

  • Go to PreferencesSound & Media -> Sounds. Find the Voice Chat slider and make sure it is not all to the left. Try increasing the volume.
  • Make sure that Voice chat is enabled on that preferences tab.
  • go to PreferencesSound & Media -> Voice. Click on Audio Device Settings. For Input and Output, use the dropdowns to select your voice devices (headset, microphone, whatever you use). It is best not to leave these at Default.
  • Close Preferences and locate the Mic button on the button bar. Click the Lock checkbox then the actual button, and try speaking (hopefully, you went to Voice Echo Canyon so you can test).

Try Reinstalling Drivers

Try reinstalling the drivers for your sound card, if you have one. Sometimes, these drivers conflict with the sound component of graphics card drivers. Similarly, you may have success by reinstalling your graphics card driver.

If voice still does not work, then continue working through this page.

Voice Is Intermittent

If you find that voice cuts in and out, particularly right after a TP, and at the same time, you notice that things are not rezzing in for you very well (avatars, objects, etc), then the likely cause is that your router is being “overwhelmed” with texture transfers. So reboot your router/modem, and then your computer, and see if the problem is solved.

You can also try adjusting your bandwidth as explained here.

If that does not help, then proceed with the section below.

Voice Worked Fine but Suddenly Doesn't Work

Chances are good that the problem lies with the SL servers or the voice provider, Vivox. Still, there are things you can try:

  • Open Preferences, and go to Sound & Media → Voice, and click Reset (circular arrow).
  • Shut down all applications that use, or can use, voice - like Skype, etc. Then relog.
  • What sometimes helps to get voice working is disabling voice in PreferencesSound & Media -> Voice, hitting Ok, waiting a minute and then enabling voice and click Ok. When these methods fail (assuming voice usually works for you) it is usually the Vivox voice servers that are the problem.
  • If this does not work at your current location, go to a region where other people are able to use voice at this time. One possibility is Firestorm Social, but any region where voice is known to be functioning is fine. Disable voice in PreferencesSound & Media -> Voice. Relog, using the last location selection on your login screen. Wait a couple of minutes. Reenable voice. Wait another couple of minutes (in other words, give the connection time to be established). If voice comes on, then the problem may have been the region you were in before. Was voice disabled there? If not, a region restart might solve the problem.
  • Go to Preferences → Network & Files -> Connection and reduce your bandwidth setting to 500 (if it is not already set there). Repeat the above step to toggle voice off and back on. See here for more information on setting your bandwidth properly, but bear in mind that lower levels than those calculated there may be necessary for troubleshooting purposes.
  • Log out of the viewer, then check Task Manager (or equivalent) and see if SLVoice is still running. If so, kill the process, restart the viewer and see if voice connects.
  • Try a relog, or even reboot your router/modem, and then your computer. 1)
  • Sometimes device settings can reset, so check in PreferencesSound & Media -> Voice→ Audio Device Settings, to be sure that the input and output are set correctly.
  • HTTP fetching may be overloading your router; please try the suggestions given here; if they do not help, revert the changes made then return to this page and continue.

Never Been Able to Get Voice to Work

  • Does your headset/microphone work outside of SL? ie when using Skype, Yahoo or MSN
  • Is your voice chat volume turned up and not muted?
  • Is the SLVoice.exe (simply SLVoice on Mac) that is in the Firestorm folder in the exceptions/allowed list for your firewall? If your firewall is turned off, turn it on and add the SLVoice.exe (or SLVoice) anyway.
    If your Firewall has SLVoice listed twice, then remove both instances, and allow it again. For Win10, make sure that SLVoice has Private unchecked, and Public checked. If you had these set differently, change them, then close the window, log out of SL, reboot.
  • Check the bandwidth you are actually getting and what you have set in Preferences → Network & Files → Connection. Please refer to this page for specifics.
  • Go to top menu, Advanced → Debug Settings, and in the window that opens, type: Cmdlinedisablevoice - then ensure this is set to FALSE. (Use Crtl-Alt-D to enable the Advanced menu, if it isn't.)

By Operating System

Windows Vista and Windows 7

Try disabling compatibility mode, if enabled:

  • Locate your desktop shortcut for Firestorm (if you use the pinned application on the task bar, make sure you pin the Firestorm shortcut, not the running viewer)
  • Right click on the icon and select Properties
  • Select the Compatibility tab
  • Find “Run this program in compatibility mode for:” if it is set then disable this
  • Make sure “Run as Administrator” is enabled (if this is greyed out, then you're probably already running as administrator, so you can ignore this step).
  • Click Apply.
  • Now log back into the viewer, and see if voice works (do you have the white dot over your head?). If not, go to PreferencesSound & Media -> Voice and disable voice; wait a few moments, then re-enable. 2)

On Windows 7, if you find yourself being able to talk but not hear what others say, then a possible solution is to use the sound drivers from Vista. (This needs further confirmation.)

Windows 10

1) Make sure to check all voice-related settings in Windows carefully.

  • If you don't know how, Google how to operate the voice settings in your version of Windows.
  • One tip: Check which application has control of your mic by hovering over the mic in your Task Bar:
    It should show SLVoice. Click it to find out what apps are allowed to use the mic:

2) Refer to the "Audio Issues" section of the Win 10 issues page for a possible problem/solution.

3) If voice works but sounds very distorted, see the "Voice Is Distorted" section of the Win 10 issues page.

4) If voice doesn't work when Skype is on, or sounds don't work while using voice:

  1. In Windows Control Panel > Hardware & Sound > Manage Audio Devices
  2. Select the Recording tab, select the microphone, select Properties
  3. Select the Advanced tab - untick 'Allow applications to take exclusive control of this device' - click OK
  4. Select the Communications tab
  5. Select 'Do Nothing' - click OK

Mac

All Mac Operating Systems

Basic test for Mac connection to the voice process

  • On your Mac, open your Activity Monitor
  • In Activity Monitor, enter “slvoice” in the search window so that you see only SLVoice in the list
  • While watching it, reset voice in the viewer. If it doesn't vanish for several seconds, then reappear, then the SLVoice process is no longer connected to the viewer.
  • To fix this, log off Firestorm, force quit SLVoice if it doesn't quit itself, then log in again.

Voice issues plus other connection problems
If you are unable to connect to voice and you are also having problems with teleporting and/or loading your friends list, perhaps along with other things, then see the “Mac-specific” section of this page for instructions and more explanation.

Mojave (10.14.x) (but possibly could happen on others)

1) Check Mac System Prefs → Security & Privacy → Privacy → Microphone.

  • Your current Firestorm version should be listed there. If it isn't, try relogging. If that doesn't help, try deleting just the Firestorm application from your Applications folder, then reinstalling it (there is no need to do anything with cache or settings folders).
  • If there are multiple versions of Firestorm in System Prefs → Security & Privacy → Privacy → Microphone, find those versions on your computer and delete them. They should disappear from the list. Then relaunch your current Firestorm, and if that doesn't work, reinstall it.

2) If you seem to have voice working (voice dots and green speech indicators show) but can't speak/hear, and your device doesn't show in PreferencesSound & Media -> Voice→ Audio Device Settings, you may be able to use your Mac Audio MIDI Setup to fix this.

  1. Go to your Mac Utilities folder and open Audio MIDI Setup.
  2. Look for your headset/mic in the list.
  3. If your device shows there, proceed:
  4. Click the + sign and choose “Create Multi-Output Device.”
  5. In the new Multi-Output Device that appears, select your headset/mic.
  6. If you have Firestorm open, relog so it can find the new Device.
  7. Go to PreferencesSound & Media -> Voice→ Audio Device Settings, and select your new “Multi-Output Device.”
  • This fix has not been extensively tested. Feedback and suggestions are welcome.
  • Thanks to user Zuzu Zong for the suggestion.

See also this JIRA issue for other possible suggestions.

Linux

Every Linux distro is different; and each may have more than one window manager to further complicate things. So tips can't be “absolute”; you will need to experiment and see what works for you. The following have been suggested by some as effective. But first….

In the Firestorm install directory, there's a text file (originally from LL) with tips on getting voice to work in Linux. If you haven't read that, then you can try to see if it helps.

  • Make sure you have ALSA and/or FMOD Studio available. FMOD Studio is supplied with Firestorm, normally. If you look at Help → About Firestorm while logged in, you should see a line that resembles this:
    Audio Driver Version: OpenAL, version 1.1 ALSOFT 1.11.753 / OpenAL Community / OpenAL Soft: PulseAudio Software
    If that says “none” then you have no audio driver available to Firestorm and need to install one.
  • Edit the firestorm shell script and remove the #. That will force LL to use FMOD Studio rather than ALSA. Some say this is how to get voice working.
#export LL_BAD_OPENAL_DRIVER=x
  • Some swear that the problem is PulseAudio, so you can try to remove that from your system. Be warned, however, that this could cause more problems than it solves. Make sure you remove only Pulse and not half the OS.
  • Be sure to have the correct devices select in Firestorm for voice:
    Preferences → Sound & Media → Voice → Audio Device Settings (button)
    Input and output may not work if left at default; they may need to go to a specific device like “ALSA Capture on [device name]”.
  • Run ldd across all the vivox libraries and ensure no missing libraries are present (set LD_LIBRARY_PATH to point to your local firestorm lib dir before running this command so you don't get erroneous results). any missing libs need to have their 32 bit (i386) version installed.

Below are results for selected Linux distros, based on input from Phoenix and Firestorm users. This will be updated as more information becomes available.

  • Ubuntu 18.04+ / Linux Mint 19 64-bit + FS64. You may need to install a few extra libs:3)
sudo apt-get install libidn11:i386 libuuid1:i386 libstdc++6:i386 gstreamer1.0-pulseaudio:i386

Note: If you experience the issue where voice connects and you are not able to hear audio from people speaking, you might need to install the libasound2-plugins:i386 package (for Debian based systems). The reason for this is that libasound_module_pcm_pulse.so is required on some systems. For non debian systems, install the relevant package that will add the 32 bit version of the library to your system (this might be alsa-plugins-pulseaudio.i686 on RHEL based systems (CentOS, Fedora))

  • Ubuntu 16.04 64 bit + FS64: The following command installs a few 32-bit libs and voice works after. Maybe you need fewer 32-bit libs but that needs further investigation.
    Apparently, arch requires these as well - or some of them - though the exact lib name may be different.
sudo apt-get install gstreamer0.10-pulseaudio:i386 libidn11:i386 libuuid1:i386 libstdc++6:i386
  • In the end you should have these libraries installed, in their 32 bit variant. The version numbers here are subject to change in later releases, but it should give you a good starting point on what to look for: ld-2.27.so libc-2.27.so libdl-2.27.so libgcc_s.so.1 libm-2.27.so libpthread-2.27.so libresolv-2.27.so librt-2.27.so libz.so.1.2.11 libXau.so.6.0.0 libasound.so.2.0.0 libcap.so.2.25 libdbus-1.so.3.19.6 libgcrypt.so.20.2.2 libgpg-error.so.0.24.2 libidn.so.12.6.0 liblz4.so.1.8.1 liblzma.so.5.2.3 libpulse.so.0.20.3 libstdc++.so.6.0.25 libsystemd.so.0.21.0 libuuid.so.1.3.0 libxcb.so.1.1.0 libpulsecommon-12.2.so
  • Linux Mint 19.3 Tricia / Ubuntu 18.04 bionic: You will probably need to install libpulse-mainloop-glib0:i3864).
  • Fedora: The following has been suggested5):
#from root or with sudo:
dnf install libidn libidn.i686 libzip.i686 libzip alsa-plugins-pulseaudio.i686

cd /usr/lib
ln -s libidn.so.12 libidn.so.11
  • Win32 Voice Another option is a debug setting, FSLinuxEnableWin32VoiceProxy, which when enabled will cause Firestorm to launch the win32 version of SLVoice via WINE. To use this, you need to ensure that WINE is installed; install wine-stable, then run winecfg and set the Windows Version to Windows 10, click Apply, then OK. Launch Firestorm, set the debug if needed, then enable voice. Depending on your system, it may take several seconds before voice comes up.

NOTES:
* If you disable voice and then re-enable too quickly, WINE may not successfully restart and voice may fail to re-enable. If you get the warning that there was a problem connecting, you will need to relog before voice will re-enable. Thirty seconds between disable and enable should be enough.
* There is a known related issue here
* One user has suggested that Linux Mint 19.1 has an older version of Wine in its repos. You need to add the Wine stable repo for your version; then it works.

1)
Suggested by Ann Enoch.
2)
Incorporates suggestions from user Maverick Buccaneer.
3)
Thanks to Virtual Pawpad.
4)
Suggested by user spyrothedragon2
5)
Thanks to user moondeveloper

firestorm_in_64-bit_ubuntu_2004 - [Install Needed Libraries] Tweaked Linux Wine section

$
0
0

Using Firestorm in 64-bit Ubuntu

NOTE: The steps here have not been rigorously tested, and therefore might not work for you.
Do not proceed with any package installation listed on this page if it will remove any packages, without a clear understanding of the potential impact to your system.
The steps here apply to a Normal (as opposed to Minimal) installation of Ubuntu 20.04 amd64, and may also apply to its variants (e.g. Xubuntu) and derivatives, unless otherwise indicated.

Install Needed Libraries

Note that many libraries cannot be installed using the Software Center; use apt in a terminal instead.

The Firestorm core binary has no unmet dependencies. However, SLVoice, SLPlugin and dullahan_host require additional libraries to do their work.

Install the additional libraries

libidn11:i386 libstcdc++6:i386
sudo apt install libidn11:i386 libstdc++6:i386

Voice and Media Support

These two packages provide support for voice and media services.

gstreamer1.0-pulseaudio:i386 pepperflashplugin-nonfree
sudo apt install gstreamer1.0-pulseaudio:i386 pepperflashplugin-nonfree

If you run across the media_plugin_cef failure message, installing these packages may help:

libnss3:i386 libnspr4:i386 libxtst6:i386 libgconf-2-4:i386 libxss1:i386
sudo apt install libnss3:i386 libnspr4:i386 libxtst6:i386 libgconf-2-4:i386 libxss1:i386

If you plan to use the win32 voice files, also install and configure wine-stable

sudo apt install wine-stable
winecfg #Set the Windows version to Windows 10, then test the audio output.

In the viewer, set the debug setting FSLinuxEnableWin32VoiceProxy to true, then try enabling voice.
It may take a few seconds for voice to connect. If it does not, check your viewer log to see if anything obvious appears. If you had an existing .wine folder, you may want to try logging out, delete that folder, then run winecfg and create a new one, then test voice again.

Install Firestorm

Regardless of the method you choose, rebooting at this point can ensure that the OS is properly updated, though it should inform you if a reboot is required.

Grab the Release

Extract the program

In a terminal, type:

cd # Your home directory by default
mkdir Firestorm
tar xf Phoenix_Fire{tab to expand} -C Firestorm --strip-components=1

Try It Out

At this point, you can launch Firestorm from a terminal:

cd ~/Firestorm
./firestorm

And watch the output, optionally copy it for analysis since not all of it made its way to the viewer log.

You can also create a desktop shortcut, either manually or by running this script in a terminal:

~/Firestorm/etc/refresh_desktop_app_entry.sh

Troubleshooting

Crashing

If you crash continually, it will be helpful to get a backtrace, like so:

cd ~/Firestorm
sed -i "/^#export .*gdb/ s/^#//" ./firestorm # This enables gnu debug
./firestorm

At the (gdb) prompt, type r to launch Firestorm. When Firestorm crashes, you should be back at a (gdb) prompt.
Type bt to get a backtrace (there may be several pages, press Enter until you get the gdb prompt again). Copy everything from the terminal screen to a text file.
Type q to exit gdb.
Create a Support Request on our Jira and attach the backtrace as well as crash logs. JIRA can guide you through the process.

NOTE: You can turn off debugging with:

sed -i "/^export .*gdb/ s/^export/#export/" ./firestorm

Voice

Default Linux voice files function, but may not on your particular system. As a workaround, install wine and use the Windows 32-bit voice files:

sudo apt install wine-stable
winecfg

Once WINE is configured to your satisfaction, launch Firestorm and log in, disable voice if necessary, then press Ctrl+Alt+Shift+S to open Debug Settings. Search for FSLinuxEnableWin32VoiceProxy, set that to TRUE, then close Debug Settings. For good measure, relog, then enable and test voice.

Note that using WINE means there is a slight delay connecting to voice as the WINE system starts up. As well, WINE needs a little time to shut down when you disconnect voice. This may cause a race condition if you toggle voice, where a new connection tries to start before the previous one shuts down. This can affect both instances of WINE, and a relog may be required to restore voice functions.

new_residents:free_stuff

$
0
0

Where Can I Get Good Free Stuff?

There are many ways of getting great free stuff in SL to make your avatar look fantastic! There are many landmarks on this page; a G, or M indicates if the region is rated General or Moderate. To go to these shops, click on the landmark, a new web page will open, then click on teleport.

Free Dove has lots of quality stuff- look around carefully when you are there, because they usually have “hunts” with gifts from very good designers - these will be in small boxes or objects hidden everywhere in the shop.

The Bazaar Linden-support free stuff place, which anyone can contribute to. Mostly older things, but still much that may be helpful in getting started in SL.

The Stay at Home Club: Started during the COVID-19 crisis, this sites lists places offering free items in a number of categories. Click here to visit the site, then on Gifts at the top.

You can find a lot of free stuff on the marketplace. A good idea is to include the word “gift” in your search. Some items you might find useful:

  • Female AO (to make your avi move naturally)
  • Skins: type “skin gift” in the search slot and you'll get quite a lot - mostly female but some for the boys too!

Most designers have a group for their shop, which they use to send people news about new releases and events - if you join their group you will get gifts, generally on a monthly basis, but sometimes more often. Sooo… when you visit a shop, look out for group gifts - there is usually a group joiner next to them, and clicking on it you get instructions in local chat how to join the group. Some groups have a join fee, sometimes quite expensive, but many are free. Also, you'll find lucky chairs and lucky boards - if your name starts with the letter displayed on them, you win the prize.

Some stores offer free items for the Residents new to Second Life, some with an age limit to be eligible to collect these gifts - eg:- Under 30 days of age.

  • Free hair pack to New Residents (2 weeks and younger) Just send a notecard with your name and hairstyle choice & color to * No Match Owner
    No Match Store location :- * No Match Hair Store
  • Free clothing for men - Kauna (no age limit)
  • SEmotions free AO Bento - SEmotions (90 Days and younger)
  • TuTy's free AO Bento - TuTy's (no age limit)
  • Firelight free male & female hair - !! Firelight !! (some 30 days and younger, many free group gifts)
  • Amazing Creations free male & female clothing - AmAzInG CrEaTiOns (group gifts, free to join, no age limit)
  • JStyle free male & female clothing - jStyle (group gifts, free to join, no age limit)
  • WarBug HQ bizarre and questionable gadgets and accessories - WarBug HQ (no group required, no age limit)

Many others available please use your search.

Another good idea is to Join an Inworld freebie shopping group! Not only will you be kept updated with all the latest freebies, but you can also get help and support to find the shops you are looking for.

There are quite a few around, but this one is probably the most popular: (to join, right-click the “group joiner” below, select “Copy to Clipboard”, then paste it in local - then click on the link that will appear)
Group joiner

Some good blogs featuring a lot of freebies:

And last but not least, there are treasure hunts! These are a really fun way to find new places and shops and get awesome free stuff!

You'll find the info to get you started here:

fixed_environment

fs_eep_skies - [Creating and Editing Skies]

$
0
0

Creating and Editing Skies

This page refers to Skies in the new Environmental Enhancement system, and does not apply to viewers 6.3.9 or older.

See http://wiki.secondlife.com/wiki/Environmental_Enhancement_Project for info.

  • Load: Click this to load an existing sky into the editor.
  • Import: Import an existing sky into your current sky.

Atmosphere & Lighting Tab

Ambient Color

This controls the color and intensity of ambient light in the atmosphere. This is used for simulating how the light from the sun is scattered by the atmosphere and other objects once it hits the Earth. You can create a very bright sun, and a relatively dark world (think of a sunset) with an Ambient setting of zero, but if you want to simulate mid-day illumination while the the sun was low in the sky, you need to increase the Ambient setting. This setting also controls how dark shadows are: darker ambient makes darker shadows.

Blue Horizon

Adjusts the color of the sky. In meteorological terms, this setting affects “atmospheric scattering”, which is the scientific answer to the age-old question, "Why is the sky blue?"

Blue Density

Blue Density affects the overall color saturation of your sky. Brighter colors make everything brighter and more vibrant. Darker colors make things become duller, eventually fading to black and white.

Haze Horizon

This setting affects the height of haze on the horizon. At higher settings, the haze will reach up into the sky and obscure the actual horizon. Haze on the horizon can help to accentuate the sun, and create a dusty, smoggy, or humid effect. This setting will not work if Haze Density is set to zero.

Haze Density

Haze density affects the amount of haze you can see in the atmosphere. At lower settings, this can make for some great outdoor views in dusty or tropical environments, and at higher levels it can create a thick, vision-obscuring fog. If you set Haze Density to zero, the Haze Horizon setting will have no effect.

Moisture Level

Controls the level of moisture (think rain) in the atmosphere. Higher values will create a rainbow opposite the sun.

Droplet Radius

This is a physical parameter affecting the shape and distribution of the colors in the rainbow.

Ice Level

Higher value create a halo round the sun.

Scene Gamma

This control adjusts your screen's distribution of light and dark output. Lower settings will cause everything to appear dim, while higher settings may make the scene look gray and “washed out”. Scene Gamma is more precise than the older Gamma in that it only affects your rendered view of the SL world, not the menus and rest of your computer's screen.

Density Multiplier

The Density Multiplier can be used to affect the overall atmospheric density. At lower settings, it creates a feeling of “thin air”, and at higher settings, it creates a very heavy, smoggy effect.

Distance Multiplier

This setting affects your perceived distance within the atmosphere. To make everything look hazy and distant, move the slider to the right. If you want to completely remove the Sky Settings' effects from terrain and objects, set the slider to zero.

Max Altitude

Adjusts the altitude calculations Second Life makes when it is computing atmospheric lighting. At later times of day, it can be useful for calculating how “deep” a sunset appears, while at noon it can be used to achieve proper brightness values.

Clouds Tab

Cloud Color

This affects the color of your clouds, if you have any. Use the individual Red/Green/Blue sliders to change the color, or the Intensity (I) slider to drag all three at once.

Cloud Coverage

As the name implies, this control sets the amount of cloud coverage. At zero, there isn't a cloud in the sky, but at higher settings, you can get a completely overcast effect.

Cloud Scale

This setting affects the perceived altitude of the clouds… if you slide the control to the right, it will make the clouds appear to be higher in the sky.

Cloud Variance

Cloud Scroll X and Cloud Scroll Y

These sliders affect the direction and speed at which the clouds float in the sky. You may also check the Lock checkbox to prevent clouds from moving on the selected axis.

Cloud Image

You can replace the default cloud image. A few textures are provided in the Library, under Environments, Textures. Or you can make your own.

  • Starfields: Step by step gimp tutorial here.
    Starfields can be used as cloud textures, but in that case, they need to be grey-scale.

Cloud Density

Use the X and Y sliders to change the horizontal position of all clouds in the sky. The D slider affects the overall density of the individual clouds; at low settings you will see thin, wispy clouds, and at higher settings you will see thicker, more solid clouds.

Cloud Detail

These settings affect the detail imagery of your clouds. The X and Y sliders shift its horizontal position, and the D slider controls how puffy and/or fractured your clouds look.

Sun & Moon Tab

Use the orbs to drag the sun and moon around the sky. To get the sun or moon over the horizon, press and hold the Ctrl key while dragging.

Image

You can replace the default textures for both the sun and moon. As always, the larger the image, the longer it will take to render. 512 is a good size. Scale allows you to control how large the sun or moon are. You an also change the brightness of the moon.

Several textures are provided in the Library, under Environments, Textures. Or you can make your own.

Sun/Moon Color

This setting affects the color of the light your sun and moon produce. Keep in mind that the color of your sunlight/moonlight will affect the color of your sky.

Sun Glow

There are two settings under Sun Glow: Size defines the size of the sun, and Focus adjusts how much the sun blurs over the sky. At very high settings, Focus can cause the sun to completely wash out a portion of the sky with brilliant light, and at zero, it will cause the sun (but not the light it casts) to disappear from the sky.

Star Brightness

Star Brightness defines how visible the stars are in the sky. If you play with this slider while the sun is up, you can see stars in the middle of the day.

Show Beacon

This draws a direction line from your avatar toward the sun or moon.


Many explanations taken from this SL wiki page.

fs_eep_water

$
0
0

Creating and Editing Water

This page refers to Water in the new Environmental Enhancement system, and does not apply to viewers 6.3.9 or older.

See http://wiki.secondlife.com/wiki/Environmental_Enhancement_Project for info.

Water Fog Color

This changes the color of the particulate matter in your water, essentially defining the color of the water itself. If your water has no fog, it will appear crystal clear and colorless.

Density Exponent

Controls the density of your water fog; this setting defines how far you are able to see into the water.

Underwater Modifier

Controls how the fog density changes when you are underwater. Useful for creating far-seeing views when underwater while keeping the surface fairly opaque. For example, at a setting of 0.25, the water fog is 1/4 as dense while underwater as it appears from above the surface.

Fresnel Scale

Determines how much light is reflected at different angles; increasing this slider reduces visual reflection effects on the water's surface.

Fresnel Offset

Determines how much total light is reflected; increasing this slider increases the amount of light reflected by the water's surface.

Normal Map

Controls the normal map used for determining reflections and refractions. Any texture may be used for this setting- but true normal maps work best.

Reflection Wavelet Scale

Controls the scale of the three wavelets that make up the surface of the water.

Large Wave Speed

Controls the X and Y direction and speed of the large wave image.

Small Wave Speed

Controls the X and Y direction and speed of the small wave image.

Refraction Scale Above

Controls the amount of visual refraction you can see from above the water's surface; this is the “wobbly” effect you can see when you look at an object that is underwater.

Refraction Scale Below

Controls the amount of visual refraction you can see from below the water's surface. This is the “wobbly” effect you can see when you look at an object that is above the water.

Blur Multiplier

Controls how waves and reflections are mixed. Increasing this setting increases the amount of distortion you see in reflections as a result of wave activity.


Many explanations taken from this SL wiki page.

fs_eep - [EEP Links]

$
0
0

General EEP Information

Firestorm Help Pages

SL Pages

Inara Pey's EEP Info

Importing Old Settings

Note: Approximately 200 Windlight settings have already been imported and can be found in Library → Environments folder. They are also visible in Quick Preferences and can be selected there.

If you wish to adapt or modify one of the built-in EEP settings, copy it from the Library to your Settings folder:

  1. Expand the folders in Library → Environments → Days, Skies, or Water.
  2. Right-click and copy as desired to your Inventory → Settings folder.

To import your other old Windlight settings into EEP:

  1. Create a new Settings item in inventory (right click Settings folder or a subfolder → New Settings → New Sky, Water, or Day Cycle).
  2. Open that new settings item.
  3. Select the Import button; this will open a file picker dialog.
  4. Navigate to where you have stored your Windlight XML files and select the file you would like to import:
    • Windows:
      • C:\Program Files\Firestorm_64\app_settings\windlight (old built-in Windlights)
      • C:\Users\User\AppData\Roaming\Firestorm_x64\user_settings\windlight (personalized custom files)
    • Mac
      • ~/Applications/Firestorm_64; right click > show package contents > Contents/Resources/windlight (old built-in Windlights)
      • ~/Library/Application Support/Firestorm/User Settings/Windlight (personalized custom files)

You should import Windlights of the same type as the editor you have open (Day Cycle, Sky, or Water). For example, to import a Sky, create and open a Sky setting from inventory. On your hard drive, you should find the files laid out as follows: ./windlight/days ./windlight/skies ./windlight/water.

New Group Ability If a group member other than the owner needs to apply an environment to a parcel, assign the ability under Parcel Settings - Modify environment settings and day cycle.

EEP Tips

Creating Space Effects

Clouds

new_residents:start

$
0
0

For New Residents

The purpose of this section is to provide help for those new to Second Life, irrespective of the viewer used or their entry point into SL. Given that different viewers are available, where possible, the information given assumes that the official Second Life viewer is the being used.

If you are looking for information on Firestorm features and functions, click here. If you need help with Firestorm viewer, click here. We also offer classes on how to use the Firestorm viewer. See this page for the schedule and in-world locations.

Joining Second Life

You can join Second Life via the web page given here:

If you want to invite friends to join, then please do share the link above with them.

Help For New Residents

Video Tutorials

Activities in Second Life


sl_resources

$
0
0

fs_menus - [RLVa]

$
0
0

Firestorm Top (Menu) Bar

Tip: clicking on the double lines will detach that menu, or sub menu, so it does not close automatically.

Avatar

  • Account: will prompt you to open your SL dashboard in a web browser
  • Marketplace Listings: Manage your SL marketplace listings.
  • Buy L$: opens the floater to let you buy L$
  • Inventory (Ctrl-I): opens your inventory
  • Protected Folders: opens your Protected Folders window.
  • Favorite Wearables: opens your Favorite Wearables
  • Picks: opens the Picks and Classifieds window for creation and editing of picks and classified ads.
  • Experiences: opens the Experiences window.
  • Profile: opens your profile
  • Appearance: opens the appearance floater at My Outfits (will be greyed out if you are a cloud; see here if that has happened to you)
  • Choose an avatar: opens the Choose an Avatar window.
  • Movement: opens the movement sub menu where you can set
    • Sit down (Alt-Shift-S): will sit your avatar down (not available if already sitting)
    • Fly (Home): this toggles will turn on fly mode (not available if sitting)
    • Stop Flying (Home): this toggle will turn off fly mode.
    • Always Run (Ctrl-R): toggles run
    • Force Ground Sit (Ctrl Alt S): This forces your avatar into a ground sit regardless of where your avatar is.
    • Move Lock (Ctrl-Alt-P): When enabled, will lock your avatar in place so it cannot be pushed.
      You will not be able to move yourself either, unless you enable PreferencesMove & View -> Movement→ Lock and unlock position after stopping or starting movement.
    • Quickjump: If enabled, the viewer suppresses any pre-jump animation.
  • Move Controls: toggles the movement controls floater
  • Camera Controls: toggles the camera controls floater
  • Avatar Health: opens the Avatar Health sub menu
    • Stop avatar animations: used to stop animations acting on your avatar
    • Stop avatar animations & revoke permissions:
    • Undeform Avatar: Attempts to undeform your avatar, to recover its normal shape after deformation after the use of oversized avatars or griefer objects.
    • Force appearance update (Rebake)(Ctrl-Alt-R): rebakes your avatar's textures
    • Refresh Attachments (Alt+Shift+R): In cases where attachments are “ghosted”, it will attempt to reattach them. Ghosted attachments are those that shows attached to you but others don't see them.
    • Reset Default Male Avatar (Character Test): forces your avatar to the default male
    • Reset Default Female Avatar (Character Test): forces your avatar to the default female
    • Show Avatar Complexity Information: This shows complexity plus:
    • * Rank (how close the avatar is to your camera; the closest is 1, next closest is 2…);
    • * VisTris: recursively counts the number of triangles in every attachment at the current rendered LOD;
    • * EstMaxTris: represents the sum of the estimated triangle count for each attachment to the avatar; and
    • * attachment surface area in square meters.
    • Scripts: Opens a window displaying script information for your avatar and includes details such as script size, the name of the object that the script resides in, the attachment point of that object and overall Script Memory used. Scripts
    • Lag Meter: Opens the Lag Meter window.
    • Recreate LSL Bridge: creates a fresh copy of the LSL bridge
  • Snapshot (Ctrl-Shift-S): opens the snapshot floater
  • Money Tracker: Shows a list of who last paid you; see this page for more information.
  • Pose Stand…: Open the Pose Stand window; replicates the functionality of a pose stand.
  • Preferences (Ctrl-P): opens your preferences window
  • Toolbar Buttons: Opens the toolbar buttons window, allowing the button layout to be customized.
  • Show HUD Attachments (Alt-Shift+H): Shows all HUDs that you have attached
  • Show User Inferface (Alt+Shift+U): Shows the User Interface
  • Exit Firestorm (Ctrl-Q): Closes Firestorm

Comm

  • Online Status: opens the Online Status sub menu where you can set yourself to:
    • Away
    • Unavailable (Busy):
      • New incoming group chats are disabled; missed messages will not be shown afterwards.
      • Existing group chats (the ones already open in the Conversations window) will continue normally.
      • Group notices are hidden until unavailable mode is disabled; they will all be shown afterwards.
      • Notifications are not shown
      • Voice calls are rejected
      • Inventory offers from objects are rejected, so use with caution.
      • Inventory offers from avatars are automatically accepted.
      • TP offers are rejected and will not be shown to you later.
      • Toasts for both group and individual IMs are not shown.
      • Chiclets are shown.
      • Individual IMs are still shown in the Conversations window. Other users will received your “​Unavailable”​ autoresponse as set in your preferences.
    • Auto-respond: (the auto-response messages are set in PreferencesPrivacy -> Autoresponse)
    • Autorespond to non-friends
    • Reject teleport offers and requests
    • Reject all group invites
    • Reject all friendship requests
  • Friends (Ctrl-Shift-F): opens the Friends tab in the contacts list.
  • Contacts (Ctrl-Alt-Shift-F): Opens or closes the contacts list.
  • Contact Sets (Ctrl-Alt-Shift-C): opens the Contact Sets window, to manage your own groups of contacts
  • Groups (Ctrl-Shift-G): opens the Groups tab in the contacts list.
  • Chat (Ctrl-H): opens the nearby chat tab in the Conversations window
  • People: Opens the people window.
  • Conversations (Ctrl-T): opens the Conversations window
  • Gestures (Ctrl-G): opens the Gestures window
  • Flickr…: opens the Upload to Flickr window.
  • Discord…: opens the Discord window.
  • Voice Morphing:
  • Conversation Log: Opens the Conversation Log window.
  • Nearby Voice: opens nearby voice, aka active speakers
  • Block List: opens the people window → Block List

World

  • Resync Animations (Ctrl-S): Restarts animations within your view; this allows couples dances to be resynchronized.
  • Nearby Avatars (Ctrl-Shift-A): Opens the Nearby tab in the People window.
  • Radar: Opens the Radar window.
  • Teleport History (Alt-H): Opens the Places window, teleport history tab.
  • Places: Opens the Places window.
  • Destinations: Opens up Destination window.
  • Events: Opens the SL Events web page.
  • Mini-Map (Ctrl-Shift-M): Opens the Minimap
  • World Map (Ctrl-M): Opens the World Map
  • Region Tracker: Opens the Region Tracker window.
  • Landmark This Place: Creates a landmark of your current location
  • Location Profile: Opens the Places Profile window
  • Parcel Details: Opens the About Land window
  • Region Details: Opens the Region/Estate window
  • Set Home to Here: sets your home location to the point you are at; also saves a snapshot, which will be displayed when you log in to your home location.
  • Buy This Land: oOpens the Buy Land window (If you are on land that is not for sale, this will be greyed out)
  • Show Owned Land: Opens the Owned Land window
  • Show More: opens the Show More sub menu where you can chose to show
    • Ban Lines Enables or disables the ability to see ban lines around parcels to which you are not allowed access.
    • Beacons (Ctrl-Alt-shift-N) Hide/show beacons for some types of objects, like sound sources, particle sources, and so on.
    • Property Lines (Ctrl-Alt-Shift-P) Enables or disables showing lines at property boundaries.
    • Land Owners Colors land: Green is land owned by you, red is land owned by others, yellow is land for sale.
    • Coordinates: Shows your current coordinates in the menu bar.
    • Parcel Permissions: Shows icons of your parcel rights.
    • Advanced Menu (Ctrl-Alt-Shift-D): Hides/shows the Advanced Menu. This can also be done in PreferencesAdvanced.
  • Teleport Home (Ctrl-Shift-H): teleports you home.
  • Environment: opens the Environment sub menu.
    • Set the sun position to
      • Sunrise (Ctrl-Shift-U)
      • Midday (Ctrl-Shift-Y)
      • Sunset (Ctrl-Shift-N)
      • Midnight (Ctrl-Shift-X)
    • Use Shared Environment: This removes any Personal Lighting you have set and allows you to see the current Parcel or Region settings.
    • My Environments: Opens your “My Environments” window, which gives you access to all Sky, Water, and Day Cycle settings in your inventory.
    • Personal Lighting: Opens your Personal Lighting window, which allows you to change environmental settings for yourself, on the fly.
    • Pause Clouds: Freezes the clouds in their current position. Useful for photography.
  • Photo and Video: opens the submenu for
    • Phototools (Ctrl-Alt-P): opens the Phototools floater.
    • Cameratools (Ctrl-Alt-C): opens the Cameratools floater.
  • Area Search: Opens the Area Search window
  • Sound Explorer: Opens the Sound Explorer window.
  • Animation Explorer: Opens the Animation Explorer window.
  • Asset Blacklist: Opens the Asset Blacklist Window.
  • Avatar Render Settings: Opens the Avatar Render Settings window.
  • Always show Friends normally: This will show all friends as normally rendered avatar instead of a “jelly doll” image.
  • Show Friends only: This will temporarily derender all avatars except those on your friends list. If you leave PreferencesMove & View -> Teleports→ Keep 'Show Friends Only' enable after teleporting disabled, then this option will disable itself after teleport.

Build

  • Build (Ctrl-B): opens the Build/Edit window
  • Select Build Tool: opens the Build Tool sub menu where you can select
    • Focus Tool (Ctrl-1)
    • Move Tool (Ctrl-2)
    • Edit Tool (Ctrl-3)
    • Create Tool (Ctrl-4)
    • Land Tool (Ctrl-5)
  • Link (Ctrl-L): will link multiple prims
  • Unlink (Ctrl-Shift-L): will unlink prims in a linkset
  • Edit Linked Parts: allows you to edit individual prims in a linkset
  • Select Elements: opens the Select Elements sub menu where you can choose:
    • Select Next Part or Face (Ctrl-.)
    • Select Previous Part or Face (Ctrl-,)
    • Include Next Part or Face (Ctrl-Shift-.)
    • Include Previous Part or Face (Ctrl-Shift-,)
  • Focus on Selection (H): will focus your camera on an object you have selected
  • Zoom to Selection (Shift-H): will zoom your camera on an object you have selected
  • Object: opens the Object sub menu that allows you to:
    • Take: Takes the object back to inventory
    • Take Copy: Creates a copy of the object in inventory.
    • Duplicate (Ctrl-D): Creates a duplicate of the object next to the original object.
    • Edit Particles: Opens the Particle Editor.
    • Save Back to Object Contents If you drag the contents of an object directly onto the ground (rather than into your inventory first, then out onto the ground), and make changes to it, this function allows those changes to be saved back to the original object.
    • Return Object: Returns the object to the owner.
    • Save as:
      • Backup: Opens the Backup window, allowing you to save the object to your hard drive.
      • Collada: Opens the Collada Export window, which you can use to export the object as mesh.
  • Scripts: opens the Scripts sub menu where you can:
    • Show Script Warnings/Errors
    • Script Info (Counter): If the object is moddable, this will show script information for it.
    • Recompile Scripts (Mono)
    • Recompile Scripts (LSL)
    • Reset Scripts: this will only work if the object is moddable.
    • Set Scripts to Running
    • Set Scripts to Not Running
    • Remove Scripts from Selection: If the selected object is moddable, removes all scripts from it.
  • Pathfinding: Options concerning Pathfinding.
    • Region Objects: Opens the Region Objects window.
    • Characters: Opens the Pathfinding characters window.
    • View / Test: Opens the Pathfinding console.
    • Rebake Region: Rebakes the region NavMesh, if there are pending changes - assuming you have rights to do so and Pathfinding is enabled for the region; will by greyed out otherwise. This can also be done by clicking the Pathfinding icon in the top menu bar.
  • Options: opens the Options sub menu where you can:
    • Show Advanced Permissions: Refer to this SL Wiki page for more on Advanced (Debug) permissions.
    • Select Only My Objects
    • Select Only Movable Objects
    • Select Only Locked Objects
    • Select Only Copyable Objects
    • Select By Surrounding
    • Include Group-Owned Objects
    • Show Physics Shape When Editing
    • Show Selection Outlines (Ctrl-Alt-H)
    • Show Hidden Selection
    • Show Light Radius for Selection
    • Show Selection Beam
    • Snap to Grid (G)
    • Snap Object XY to Grid (Shift-X)
    • Use Selection for Grid (Shift-G)
    • Grid Options (Ctrl-Shift-B)
    • Set Default Permissions: Opens the Default Creation Permissions window.
  • Upload: opens the Upload sub menu which allows you to choose what to upload (Same as the Upload item in the Avatar Menu):
    • Image (L$10): Opens a file selector, then the image upload window.
    • Sound (L$10): Opens a file selector, the the sound upload window.
    • Animation (L$10): Opens a file selector, then the animation upload window
    • Mesh Model: Opens a file selector to upload a mesh model; see the SL wiki for more info.
    • Bulk (L$10 per file): Opens a file selector where you can select multiple image files for upload.
    • Import Linkset: Opens the Import window, to upload a previous exported object.
  • Undo (Ctrl Z): will undo the last changes made in the edit /build window
  • Redo (Ctrl Y): will redo the last changes made with the undo command

Content

  • Search (Ctrl-F): opens the Search window
  • SL Marketplace: prompts you to open the Marketplace web page
  • L$ Market Data: prompts you to open the L$ market Data web page
  • Script Library: prompts you to open the Script Library web page
  • Firestorm Blog: prompts you to open the Firestorm Viewer Home web page
  • Firestorm Flickr: prompts you to open the Firestorm Viewer Flickr web page
  • Firestorm YouTube: prompts you to open the Firestorm Viewer YouTube channel
  • Firestorm Twitter: prompts you to open the Firestorm Viewer Twitter web page
  • Firestorm Plurk: prompts you to open the Firestorm Viewer Plurk web page
  • Message of the day: this will show the message of the day in local chat. This also is shown during the login phase.

Help

RLVa

This menu is toggled from Advanced Menu (Ctrl-Alt-D) → RestrainedLove API (RLVa) or from Preferences → Firestorm → Extras → Allow Remote Scripted Viewer Controls (RLVa). This will require a restart of the viewer to show this menu.

  • Debug: Opens the Debug sub menu where you can enable:
    • Show Top-level RLVa Menu: Enables showing the RLVa menu in to menu bar. If disabled, RLVa menu will show in Advanced Menu.
    • Show Debug Messages: Used when debugging RLV scripts and also to know when something RLV is being done to you by either a person or object.
    • Hide Unset or Duplicate Messages
    • Show Assertion Failures
    • Hide Locked Layers
    • Hide Locked Attachments
    • Enable Legacy Naming
    • Enabled Shared Wear
    • Rename Shared Items on Wear
    • Locks: Opens the Active RLV Locks window
  • Allow OOC Chat: Allows Out Of Character (OOC) chat.
  • Show Filtered Chat
  • Split Long Redirected Chat: Splits long nearby chat lines across multiple messages when @redir* restricted.
  • Allow Temporary Attachments
  • Forbid Give to #RLV
  • Wear Replaces Unlocked
  • Console: Opens the RLVa console window
  • Restrictions: Opens the Active RLV Restrictions window
  • Strings: Opens the RLVa Strings window

Advanced

Please use with caution

This menu is toggled via the Ctrl-Alt-D key sequence, or from PreferencesAdvanced

  • Rebake Textures (Ctrl+Alt+R): (same as Avatar→ Avatar health → Force Appearance Update).
  • Refresh Attachments (Alt+Shift+R):
  • Set UI Size to Default (Ctrl-Alt-Shift-R): Reverts any changes made in PreferencesUser Interface -> General→ UI scaling.
  • Set Window Size: Allows you to set the window size.
  • Limit Select Distance: Limits your select distance to about 50m.
  • Disable Camera Constraints: Allows camera to pass through solid objects.
  • High-res Snapshot: Enables high resolution snapshots.
  • Quiet Snapshots: Disables the snapshot sound and animation.
  • Performance Tools: Opens the Performance Tools sub menu where you can enable:
    • Lag Meter: Opens the Lag Meter window.
    • Statistics Bar (Ctrl-Shift-1): Displays the Statistics window (often called the “stats bar”).
    • Scene Load Statistics (Ctrl-Shift-2): Displays the Scene Load Statistics window with focus on object load and cache performance.
    • Show Avatar Complexity Information: Displays an indicator of client draw “cost” above each avatar (replaces Avatar Rendering Cost).
  • Highlighting and Visibility: Opens the Highlighting and Visibility sub menu where you can choose:
    • Cheesy Beacon: Animates the red world map beacon to make it look “cheesy” (enable it to see the effect).
    • Hide Particles (Ctrl Alt Shift =) : Disables rendering of particles. Another way of achieving this is to go to PreferencesGraphics -> General and setting Max particle count to zero - or doing the same in the Quick Preferences panel.
    • Hide Selected: Makes the currently selected (edited) object invisible, until they are no longer selected.
    • Highlight Transparent (Ctrl Alt T): Makes transparent objects visible by highlighting them:
      • Red: alpha blended textures,
      • Blue: alpha masked textures,
      • Green: invisiprims.
    • Show Mouselook Crosshairs
    • Hover Tips: Opens Hover Tips submenu
      • Show Tips (Ctrl-Shift-T): This allows you to set what hovertips, if any, you see (please check this first to enable hover tips)
      • Show Land Tooltips:
      • Show Tips On All Objects:
  • Rendering Types: Opens the Rendering Types sub menu, which allows types of things to be shown or hidden. By default, these are all enabled. Disabling some can be useful if you are trying to find a lost object.
    • Simple (Ctrl-Alt-Shift-1): Textures without alpha channels.
    • Alpha (Ctrl-Alt-Shift-2): Textures with alpha channels
    • Tree (Ctrl-Alt-Shift-3): Linden plants.
    • Avatars (Ctrl-Alt-Shift-4): Bodies and attachments but not name tags.
    • Surface Patch (Ctrl-Alt-Shift-5): Terrain/ground texture.
    • Sky (Ctrl-Alt-Shift-6): Entire sky including clouds and sun/moon.
    • Water (Ctrl-Alt-Shift-7): Water surface only, view when under water is still tinted.
    • Ground (Ctrl-Alt-Shift-8)
    • Volume (Ctrl-Alt-Shift-9): All objects except Linden plants.
    • Grass (Ctrl-Alt-Shift-0): Linden plants.
    • Clouds (Ctrl-Alt-Shift- -)
    • Particles (Ctrl-Alt-Shift-= )
    • Bump (Ctrl-Alt-Shift-\): Legacy bump map and shiny effects.
  • Rendering Features: Opens the Rendering Features sub menu:
    • UI (Ctrl-Alt-F1): Be VERY careful when using this, as the menu bar is hidden as well; make mental note of the key sequence so you can re-enable the UI when you need it.
    • Selected (Ctrl-Alt-F2): Display texture alignment crosshair boxes with “Select Face”.
    • Highlighted (Ctrl-Alt-F3)
    • Dynamic Textures (Ctrl-Alt-F4): Enable clothing and sculpt previews in texture upload floater.
    • Foot Shadows (Ctrl-Alt-F5)
    • Fog (Ctrl-Alt-F6)
    • Test FRInfo (Ctrl-Alt-F8)
    • Flexible Objects (Ctrl-Alt-F9): Enable/disable flexible prim effect.
  • RLVa: This menu option will show if you choose not to show RLVa menu in top menu bar. This will show RLVa submenus.
  • Media Streams Backup
    • Import Stream List XML: This will import the stream_list.xml file.
    • Export Stream List XML: This will export the media stream list from top menu → World Menu → Parcel DetailsSound tab to a file called stream_list.xml to a folder of your choosing
  • Use Plugin Read Thread: Uses a separate thread to read incoming messages from plugins. So in theory, this should give you a slight performance increase if you have a multicore processor and using the internal web browser or playing quicktime videos and so on.
  • Clear Group Cache: Clears group cache
  • Mouse Smoothing: Should help smooth mouse movement
  • Release Keys: Releases permissions taken by worn attachments.
  • Shortcuts: Opens the Shortcuts sub menu, showing some of the common keyboard shortcuts:
    • Search (Ctrl-F)
    • Show Advanced Menu-legacy shortcut (Ctrl-Alt-D)
    • DoubleClick Teleport (Ctrl-Shift-D)
    • Always Run (Ctrl-R)
    • Fly (Home)
    • Close Window (Ctrl-W)
    • Close All Windows (Ctrl-Shift-W)
    • Snapshot to Disk (Ctrl-`)
    • Mouselook (M)
    • Joystick Flycam (Alt-Shift-F)
    • Reset View (Esc)
    • Reset Camera Angles (Shift-Esc)
    • Look at Last Chatter (Ctrl-\)
    • Zoom In (Ctrl-0)
    • Zoom Default (Ctrl-9)
    • Zoom Out (Ctrl-8)
  • Fly Override (Ctrl-Alt-V): Allows flight in no fly areas - NOT recommended
  • RestrainedLove API: Enables/disables RLV (also in PreferencesFirestorm -> Extras→ Allow scripted viewer controls)
  • Show Debug Settings: Opens the debug menu window; use with caution.
  • Show Develop Menu (Ctrl-Alt-Q): Shows or hides the develop menu on the menu bar.

Developer

Please use with caution

This menu is toggled via the Ctrl-Alt-Q key sequence, or from PreferencesAdvanced

  • Consoles: Opens the Consoles sub menu. These should all be disabled in normal use. If you find your screen filling with “strange” graphs and data, check here to make sure all are off.
    • Texture Console (Ctrl-Shift-3):
    • Debug Console (Ctrl-Shift-4): Scroll activity log on the main viewer window.
    • Notifications Console (Ctrl-Shift-5): Trace dialogs, alerts, notifications.
    • Fast Timers (Ctrl-Shift-9): Shows tasks performed per frame.
    • Scene Statistics: Plot complexity of objects in view.
    • Scene Loading Monitor:
    • Region Debug Console Opens the Region Debug Console.
    • Region Info to Debug Console: Dumps region flags and stats to log
    • Group Info to Debug Console: Dumps summary of active group info to log.
    • Capabilities Info to Debug Console: Dumps capability names and URLs to log.
    • Camera: Camera and agent position/rotation overlaid on screen.
    • Wind: Region wind speed and heading is overlaid on screen.
    • FOV: Camera field of view angle overlaid on screen.
    • Badge (Ctrl-Alt-Shift-H) (This won't toggle off……)
  • Show Info: Opens the Show Info sub menu:
    • Show Time: Shows the time spent logged on in the lower right.
    • Show Upload Transaction: Gives a notification on upload, showing how much you were charged.
    • Show Texture Info: Shows texture information for the object under the cursor.
    • VRAM usage per object:
    • Show Avatar Render Info: Show load state and attachment weights for visible avatars.
    • Show Render Info: Displays information about the scene currently being rendered.
    • Show Matrices: OpenGL matrix info overlaid on screen.
    • Show Color Under Cursor: Shows the RGBA values for the color under the cursor, in the lower right.
    • Show Memory: Shows total viewer memory use overlaid on screen.
    • Show Updates to Objects (Ctrl-Alt-Shift-U): Displays “clouds” of different colors when objects update.
  • Force an Error: opens the Force an Error sub menu. Using any of these will probably crash you. Aimed at viewer developers.
    • Force Breakpoint (Ctrl-Alt-Shift-B)
    • Force LLError And Crash
    • Force Bad Memory Access
    • Force Infinite Loop
    • Force Driver Crash
    • Force Software Exception
    • Force Disconnect Viewer
    • Simulate a Memory Leak
  • Render Tests: opens the Render Tests sub menu:
    • Camera Offset
    • Randomize Framerate: Add a random duration sleep with each rendered frame.
    • Periodic Slow Frame: Sleep half a second every 10 frames.
    • Frame Test: Capture buffer and pause.
    • Frame Profile: Dump GL stats to log.
    • Benchmark: Measure GPU performance and sends results to log.
  • Render Metadata: Opens the Render Metadata sub menu; these are normally all disabled:
    • Bounding Boxes: Renders boxes colored by type.
    • Avatar Hitboxes:
    • Normals:
    • Octree: Renders bounding boxes color coded by octree buffer usage and activity.
    • Shadow Frusta: Renders each frustrum as a shaded box.
    • Physics Shapes: Renders terrain and objects as they appear to the simulator's physics engine.
    • Occlusion: Highlights objects that are hidden behind others.
    • Render Batches: Highlights rendering groups with different colored tints.
    • Update Type: Highlights each object by last update performed.
    • Texture Anim: Highlights animated texture faces in yellow.
    • Texture Priority:
    • Texture Area: Shows the min:max rendered texture area for each face.
    • Face Area: Shows the min:max rendered area for each face.
    • LOD Info:
    • Triangle Count:
    • Build Queue:
    • Lights: Highlights local light sources and bounding box of the light they cast.
    • Particles: Shows hover text with particle parameters at each emitter.
    • Collision Skeleton:
    • Joints: Shows lines in the avatar of joint locations and connections to other joints.
    • Raycast:
    • Wind Vectors: Renders red lines overhead to show wind direction.
    • Sculpt: Shows hover text with sculpt map sizes.
    • Texture Size: Shows hover text of texture sizes.
    • Texture Density
      • None
      • Current
      • Desired
      • Full
  • Rendering: Opens the Rendering sub menu
    • Axes: Draw XYZ axis display centered on avatar plus region origin marker.
    • Tangent Basis
    • Selected Texture Info Basis (Ctrl-Alt-Shift-T): Show size and alpha channel presence for faces selected in editor.
    • Selected Material Info (Ctrl-Alt-Shift-M):
    • Wireframe (Ctrl-Shift-R): Show object geometry.
    • Object-Object Occlusion (Ctrl-Shift-O): Optimization, skip rendering objects that are hidden behind others.
    • Advanced Lighting Model: Enable deferred rendering.
    • Debug GL: Enable extra OpenGL error checking.
    • Debug Pipeline: Subset of Debug GL.
    • Automatic Alpha Masks (deferred): Force alpha test instead of blend if texture has little transparency (when advanced lighting on).
    • Automatic Alpha Masks (non-deferred): Force alpha test instead of blend if texture has little transparency (when advanced lighting off).
    • Animation Textures: Allows texture to be animated per llSetTextureAnim.
    • Disable Textures: Stop fetching new textures from the network.
    • Derender all animesh: Removes all animesh from your scene.
    • Full Res Textures (dangerous): Disregard LOD and display all textures at full resolution. Increases network and memory use.
    • Render Attached Lights: Render local light sources on avatar attachments.
    • Render Attached Particles: Render particle systems emitted by avatar attachments.
    • Hover Glow Objects:
  • Network: Opens the Network sub menu:
    • Pause Agent: Stop avatar movement updates. Local turns and interpolated motion will still appear.
    • Enable Message Log: Dump every protocol message to log.
    • Disable Message Log: Stop protocol message dump.
    • Velocity Interpolate Objects: When enabled it allows smoothed object motion between updates and for llTargetOmega motion to work. When it's disabled, stops “rubber band” effect at cost of these features.
    • Ping Interpolate Object Positions: Factor ping time into interpolation.
    • Drop a Packet (Ctrl-Alt-L): Simulate loss of a data packet.
  • Dump Scripted Camera
  • Recorder: opens the Recorder sub menu. This is used to record, and then playback, a sequence of your actions. For example, you can record yourself walking round, then when you play it back, your avatar will repeat that exactly. Useful for machinima.
    • Start Playback
    • Stop Playback
    • Loop Playback
    • Start Record
    • Stop Record
  • World: Opens the World sub menu:
    • Sim Sun Override
    • Fixed Weather
    • Dump Region Object Cache: Send object cache statistics to log.
    • Dump Simulator Features to Nearby Chat
  • UI: Opens the UI sub menu:
    • Media Browser Test: Opens embedded browser with Viewer URI Name Space test page.
    • Region Restart Test:
    • Web Content Browser (Ctrl-Shift-Z): Opens the internal browser.
    • FB Connect Test: For checking Second Life ShareAPI.
    • Dump SelectMgr: Info about selected objects to log.
    • Dump Inventory: Inventory UUIDs and names to log.
    • Dump Timers: Function call stats to log.
    • Dump Focus Holder: What UI element has keyboard focus to log.
    • Print Selected Object Info (Ctrl-Shift-P): Object details to log.
    • Print Agent Info (Shift-P): Avatar name and camera to log.
    • Double-Click Auto-Pilot
    • Double-Click Teleport
    • Debug SelectMgr: If this and Limit Select Distance are active, dump auto deselects to log.
    • Debug Clicks: Mouse button changes with coordinates to log.
    • Debug Views: Identify UI elements on screen.
    • Debug Name Tooltips: Identify XUI source for UI element under cursor. (alias of Show XUI Names)
    • Debug Mouse Events: Info about what has mouse focus to log.
    • Debug Keys: Text entry field activity to log.
    • Debug Window Process: Low level info for main viewer window to log.
  • XUI: opens the XUI sub menu:
    • Reload Color Settings: Refresh from skin's colors.xml
    • Show Font Test: Open floater with type specimen.
    • Load from XML
    • Save to XML
    • Save XUI Names: Identify XUI source for UI element under cursor.
    • Show debugging info for views
    • XUI Preview Tool
    • Send Test IMs: Send dummy messages to test accounts.
    • Flush Names Caches: Clean avatar name cache.
  • Avatar: Opens the Avatar sub menu:
    • Grab Baked Textures
      • Iris
      • Head
      • Upper Body
      • Lower Body
      • Skirt
    • Character Tests
      • Appearance To XML: Saves your avatar shape to a file; opens a file picker to allow you to select the destination folder, and file name. Shapes exported this way can be re-imported in the Appearance window.
      • Toggle Character Geometry
      • Test Male: Shortcut to wear “Male Shape & Outfit” from inventory Library/Clothing.
      • Test Female: Shortcut to wear “Female Shape & Outfit” from inventory Library/Clothing.
      • Allow Select Avatar: Avatars can be selected and “moved” with object editor, local effect only, movements do not appear to others.
    • Animation Speed
      • All Animations 10% Faster
      • All Animations 10% Slower
      • Reset All Animations Speed
      • Slow Motions Animations
    • Force Params to Default: Clear and refresh tweakable appearance settings.
    • Animation Info: Text over avatars with running animations and priorities.
    • Show Look At: Shows look at crosshairs.
    • Show Point At: Show destination for selection beam as a red crosshair.
    • Debug Joint Updates: Rapid summary of updates to log.
    • Disable LOD: For avatar bodies.
    • Debug Character Vis: Dump avatar and attachment visibility to log.
    • Show Collision Skeleton: Show avatar's “collision volume” joints. Used with fitted mesh and touch/select. Not used with simulator physics.
    • Show Bones:
    • Display Agent Target: Crosshairs with avatar's actual and rendered positions.
    • Dump Attachments: Attachment points, UUIDs, positions, visibility to log.
    • Debug Avatar Textures (Ctrl-Alt-Shift-A): Shows component textures for own avatar.
    • Dump Local Textures (Alt-Shift-M): Avatar texture info to log.
    • Reload Avatar Cloud Particle:
  • Compress Images: Select a file and convert to .j2c, results to log.
  • Enable Visual Leak Detector:
  • Output Debug Minidump
  • Console Window on next Run: Opens a window on the next run of the viewer, which shows internal information as the viewer runs. Useful for developers' to debug the viewer. Otherwise, keep this disabled.
  • Set Logging level: This allows the level of detail of logging to be changed from the default (Info). The support team might request that you change this if attempting to diagnose a problem; otherwise, it should always be left at default.
    • Debug
    • Info
    • Warning
    • Error
    • None
  • Request Admin Status (Ctrl-Alt-G): Request privileges. Only works if you are a Linden.
  • Leave Admin Status (Ctrl-Alt-Shift-G)
  • Show Admin Menu

Searching

It is possible to search the menus for specific words or phrases, by typing into the search bar at the top. For example, typing in the word upload will result in matches on up to four top menu items: Avatar, Build, Advanced and Develop. In short, using search will filter out what is shown in the top menu bar, removing all items except those that contain what you searched for.

Matched items are highlighed in color (you can change the highlight color in Preferences → Colors -> Miscellaneous→ Preferences Search Highlight Color).

To clear the search, and have the Preferences window revert to its normal state, just click the 'x' at the far right end of the search field.

Menu search is enabled (or disabled) in Preferences -> Advanced→ Show Menu Search.

Graphics Presets

: Hovering your mouse over this symbol, or clicking it (depending on your preferences setting), it will open the Graphics Presets window. Please note that this symbol will only show if you have created a graphic preset in PreferencesGraphics -> General.


See this page for documentation on Firestorm 6.3.9 and earlier.

downloads

$
0
0

Firestorm Viewer Downloads For Second Life

Firestorm Viewer is certified to be free of viruses and malware.

Current Release for Second Life

Firestorm 6.3.9 (58205) Release

Firestorm 6.3.9 (58205) Release Notes

“n/a” in the table below means “not available”; see the boxed note above.

Windows

Version32/64-bitGridsHavokLevel of SupportDownload
Windows
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.9.58205 64 bit Windows Setup.exe
MD5 Checksum: 158DB232BEBFB0D12F1CB1D91613E596
Windows
32-bit
32 and 64 SL only Full Release Firestorm Release 6.3.9.58205 32 bit Windows setup.exe
MD5 Checksum: 43132552ECB5277F5BA58676C467563C

Mac

Version32/64-bitGridsHavokLevel of SupportDownload
Mac
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.9.58205 64 bit Intel Mac.dmg
MD5 Checksum: 7CAA12CB90D64C26195FB6F8517AA707
Mac
32-bit
32 and 64 SL only n/a n/a

Linux

Version32/64-bitGridsHavokLevel of SupportDownload
Linux
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.9.58205 64 bit Linux.tar.bz2
MD5 Checksum: 335E758C5088C6F2038D035C37DAE3A9
Linux
32-bit
32 and 64 SL only n/a n/a

More information about the 64-bit builds can be found here.

Current Release for OpenSim

OpenSim versions of Firestorm do not have Havok. That only matters if you're uploading mesh objects and need to specify the mesh physics properties, or if you need to manipulate the region navmesh for pathfinding. The terms of the Havok license prohibit its use anywhere but Second Life, so it's not present in OpenSim versions.
In order to be able to login to grids other than Second Life, you need to enable a setting. From the login screen, go to
Viewer Menu → Preferences → Advanced → Allow login to other grids. Also see Grid Selector

Firestorm 6.3.9 (58205) Release

Firestorm 6.3.9 (58205) Release Notes

“n/a” in the table below means “not available”; see the boxed note above.

Windows

Version32/64-bitGridsHavokLevel of SupportDownload
Windows
64-bit OpenSim
64-bit only OpenSim only Full Release Firestorm Release 6.3.9.58205OS 64 bit Windows Setup.exe
MD5 Checksum: 068D09D240665203EACA21CC68FFF52C
Windows
32-bit OpenSim
32 and 64 OpenSim only Full Release Firestorm Release 6.3.9.58205OS 32 bit Windows setup.exe
MD5 Checksum: E4B2895C3445FB97A51C68C70484910D

Mac

Version32/64-bitGridsHavokLevel of SupportDownload
Mac
64-bit OpenSim
64-bit only OpenSim only Full Release Firestorm Release 6.3.9.58205OS 64 bit Intel Mac.dmg
MD5 Checksum: 51F7CC302846F94971C36F86BA95CEBB
Mac
32-bit OpenSim
32 and 64 OpenSim only n/a n/a

Linux

Version32/64-bitGridsHavokLevel of SupportDownload
Linux
64-bit OpenSim
64-bit only OpenSim Only Full Release Firestorm Release 6.3.9.58205OS 64 bit Linux.tar.bz2
MD5 Checksum: 93861134A1173758110A57C4EDCF9D36
Linux
32-bit OpenSim
32 and 64 OpenSim Only n/a n/a

Supported Operating Systems

Windows

  • Windows 8.1 and 10 32bit and 64bit are supported.
    Earlier versions of Windows are not supported.
  • Windows 10 - Firestorm 6.0.2 and later are compatible with Windows 10.
    However, if you are running Windows 10 on a system with an older Intel graphics card which does not support Windows 10 - Intel HD 2000, Intel HD 3000 or anything marked as “No” for Windows 10 on this list,
    you will only be able to run the 32bit versions of Firestorm 6.0.2 and later. even if you have a 64bit version of Windows 10.
    Please see this page for detailed instructions if you are running Windows 10 on an older unsupported Intel card and have problems running Firestorm 6.0.2 or later.

Mac

  • FS is built and tested on Catalina (10.15)
  • Some additional beta testing is done on OSes back to El Capitan (10.11)
  • Performance may vary on OSes prior to High Sierra (10.13) (Note: High Sierra will reach End of Life in November 2020)
  • FS probably will not run on anything prior to El Capitan (10.11)

Linux

  • Ubuntu LTS (16.04, 18.04, 20.04) 64-bit is supported, as is any derivative or variant. We are unable to offer support for 32-bit Linux, or any other distribution.
  • For all other Linux distributions, feel free to submit details of your success and/or failure to any Firestorm team member or to the Firestorm Jira. Contributions may be included on our wiki to benefit others.
  • Some additional libraries and/or packages may be needed; they are listed on this page.
  • Older hardware may not be able to support Firestorm, even when a supported OS is installed.

Additional Downloads to Fix Problems

Windows

  • SLURLs not working in your browser, or choose to open with a different viewer (Windows)

Additional Downloads to Enhance User Experience

Flash

Please read https://support.microsoft.com/en-au/help/4520411/adobe-flash-end-of-support before considering installing flash. Flash has a LONG history of very serious security issues. If someone is providing content that only works with flash, please contact them and let them know that flash will be end of life in the near future, this means there will be NO security updates from the vendor beyond that point. Nobody should be forcing flash on anyone in this day and age, it is 2020, not 2001 anymore.

  • Windows - Download in Firefox or Chrome to play Flash media inside Second Life.
    Choose the correct operating system under Step 1.
    Choose FP 32 for Opera & Chromium - PPAPI under Step 2.
    Install Flash.
  • Mac - Ensure that you have the most recent version of Flash for Safari installed. You can get this via the normal update process, or from Adobe.
    Choose the correct operating system under Step 1.
    Choose FP 32 for Safari and Firefox – NPAPI under Step 2.
    Install Flash.
  • Linux - You need to have the pepperflash plugin installed, which can be satisfied by installing Google Chrome.

Quicktime

  • Windows - Quicktime does not need to be installed to play media on Firestorm 5.0.1 or later.
  • Mac - Quicktime to play streaming videos. (iTunes is not needed)

GStreamer

for Linux only

  • Info for download to play streaming videos. (Please read page for info on installing GStreamer for your particular distribution.)

Growl

  • Growl for Windows– As of November 2018 this site is dead. Users who already have Growl installed can continue to use it for the time being. Windows users may be able to download a copy from its github release page.
  • Mac– This site will lead you to the Mac App Store for downloading. Please note the reviews and the update status of Growl before purchasing; Firestorm cannot guarantee its functionality.
  • Linux: Growl is implicit in libnotify, which should come already installed in most distros. However, if you are on a 64-bit Linux, you may need to install the 32-bit version of libnotify. For ubuntu and similar (like mint), run the following command:
    sudo apt-get install libnotify4:i386

DirectX Runtime

Windows only

  • DX runtime April 2011 to help increase performance and stability. For all versions of Windows. Please refer to this page.

Video Drivers

Mac drivers are included with OS upgrades. However, to determine what card you have, select “About this Mac” from the Apple menu, then click “More Info”. Under Hardware select Graphics/Displays.

If you are not sure what type of video card you have, use GPU-Z found (Windows only) here. For Linux, in a console use:
lspci | grep VGA

Nvidia Video Driver

  • Latest driverLast checked 24/05/2020 - Windows: 445.87 (2020.4.15) - Linux: 440.82 (2020.4.7)

ATI Video Driver

  • Latest driverLast checked 24/05/2020 - Windows: Adrenalin 2020 Edition 20.2.2 (3/5/2020) - Linux: 20.10 (4/16/2020)

Intel Video Driver

Source code

fs_older_downloads

$
0
0

Firestorm - Older Releases

Firestorm 6.3.2 (58052) Bakes On Mesh Release

Firestorm 6.3.2 (58052) Release Notes

“n/a” in the table below means “not available”; see the boxed note above.

Windows

Version32/64-bitGridsHavokLevel of SupportDownload
Windows
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.2.58052 64 bit Windows Setup.exe
MD5 Checksum: 22D4173CD14803AE99F0592D1813171A
Windows
32-bit
32 and 64 SL only Full Release Firestorm Release 6.3.2.58052 32 bit Windows setup.exe
MD5 Checksum: AD980B6F8297E182F82740B3DAAC28EA

Mac

Version32/64-bitGridsHavokLevel of SupportDownload
Mac
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.2.58052 64 bit Intel Mac.dmg
MD5 Checksum: DC8CA6ADBE9862ECD2BD5A1A18DC4BB7
Mac
32-bit
32 and 64 SL only n/a n/a

Linux

Version32/64-bitGridsHavokLevel of SupportDownload
Linux
64-bit
64-bit only SL only Full Release Firestorm Release 6.3.2.58052 64 bit Linux.tar.bz2
MD5 Checksum: CF3B34B07C50AD43D9952117F1FB60CF
Linux
32-bit
32 and 64 SL only n/a n/a

Firestorm 6.2.4 (57588) Release

Firestorm 6.2.4 (57588) Release Notes

“n/a” in the table below means “not available”; see the boxed note above.

Windows

Version32/64-bitGridsHavokLevel of SupportDownload
Windows
64-bit
64-bit only SL only Full Release Firestorm Release 6.2.4.57588 64 bit Windows Setup.exe
MD5 Checksum: 232191D3F5AD16FDFD8953BE21A0E1B3
Windows
32-bit
32 and 64 SL only Full Release Firestorm Release 6.2.4.57588 32 bit Windows setup.exe
MD5 Checksum: 4209BB41E0F80D6E081B3B616D1DEA85

Mac

Version32/64-bitGridsHavokLevel of SupportDownload
Mac
64-bit
64-bit only SL only Full Release Firestorm Release 6.2.4.57588 64 bit Intel Mac.dmg
MD5 Checksum: FAE7F7B66B3428622003B950AF2BAFD2
Mac
32-bit
32 and 64 SL only n/a n/a

Linux

Version32/64-bitGridsHavokLevel of SupportDownload
Linux
64-bit
64-bit only SL only Full Release Firestorm Release 6.2.4.57588 64 bit Linux.tar.bz2
MD5 Checksum: BB35FA152A5E1646B2A522DEC619C70B
Linux
32-bit
32 and 64 SL only n/a n/a

Firestorm 6.0.2 (56680) Animesh Release

OpenSim only; blocked for Second Life.

Firestorm 6.0.2 (56680) Animesh Release Notes

“n/a” in the table below means “not available”; see the boxed note above.

Windows

Version32/64-bitGridsHavokLevel of SupportDownload
Windows
64-bit OpenSim
64-bit only SL and other grids Full Release Firestorm Release 6.0.2.56680OS 64 bit Windows Setup.exe
MD5 Checksum: 08a67070083a1399997db2aaa102d8df
Windows
32-bit OpenSim
32 and 64 SL and other grids Full Release Firestorm Release 6.0.2.56680OS 32 bit Windows setup.exe
MD5 Checksum: 9ddaac654820a5168c1f4bed4603fc6b

Mac

Version32/64-bitGridsHavokLevel of SupportDownload
Mac
64-bit OpenSim
64-bit only SL and other grids Full Release Firestorm Release 6.0.2.56680OS 64 bit Intel Mac.dmg
MD5 Checksum: 5c152ac11982c01b25edcadef26e9366
Mac
32-bit OpenSim
32 and 64 SL and other grids n/a n/a

Linux

Version32/64-bitGridsHavokLevel of SupportDownload
Linux
64-bit Havok
64-bit only SL only n/a n/a
Linux
64-bit OpenSim
64-bit only SL and other grids Full Release Firestorm Release 6.0.2.56680OS 64 bit Linux.tar.bz2
MD5 Checksum: c11857b11dbb4a4accfc785529d63451
Linux
32-bit OpenSim
32 and 64 SL and other grids Full Release Firestorm Release 6.0.2.56680OS 32 bit Linux.tar.bz2
MD5 Checksum: 9e20172f32789f68671c0be8bcdd8315

fs_compiling_firestorm_linux - ↷ Page moved and renamed from support:mister_acacia:build_fs ...

$
0
0
Under Perpetual Construction!

Building Firestorm for Linux

There is no official support for compiling or operating self-compiled viewers. There may be unofficial support as listed at the bottom of this page.
These instructions only apply to Firestorm versions with AlexIvy code.

This procedure is used for building Firestorm for Linux. It is the only recommended procedure for building Firestorm for Linux.

This procedure is based on discussions with the Firestorm Linux Development team and is the only one recommended for Firestorm for Linux. System requirements are:

  1. Ubuntu 16.04.6_x64
  2. 8GB or more RAM Low Memory Caution
  3. 64GB hard drive space
  4. 4 or more core CPU (you could get by with 2 cores, but the process will take much longer)

Due to the age of the build OS, it is recommended that you use a Virtual machine, ensuring the guest can meet the hardware requirements.

This procedure may or may not work on other Linux distributions.

Establish your programming environment

This only needs to be done once.

Create your source tree

Typically, Linux source code is stored in a src directory in your home directory. So:

mkdir ~/src

Install Required Libraries

A large number of development libraries must be installed on the build system. Some may already be installed:

libatk1.0-dev libatk-bridge2.0-dev libatspi2.0-dev/xenial libcups2-dev libcurl4-openssl-dev libfreetype6-dev
libglu1-mesa-dev libgtk2.0-dev libgtkglext1-dev libnss3-dev libssl-dev libpango1.0-dev
libpangox-1.0-dev libpangomm-1.4-dev libx11-xcb1 libxcb1-dev libxcb-composite0-dev libxcb-cursor-dev
libxcb-dri3-dev libxcb-screensaver0-dev libxcb-util-dev libxcb-util0-dev libxcb-xkb-dev libxcomposite-dev
libxcursor-dev libxdamage-dev libxi-dev libxinerama-dev libxkbcommon-x11-dev libxrandr-dev
libxss-dev
sudo apt install libatk1.0-dev libatk-bridge2.0-dev libatspi2.0-dev/xenial libcups2-dev libcurl4-openssl-dev libfreetype6-dev \
libglu1-mesa-dev libgtk2.0-dev libgtkglext1-dev libnss3-dev libssl-dev libpango1.0-dev \
libpangox-1.0-dev libpangomm-1.4-dev libx11-xcb1 libxcb1-dev libxcb-composite0-dev libxcb-cursor-dev \
libxcb-dri3-dev libxcb-screensaver0-dev libxcb-util-dev libxcb-util0-dev libxcb-xkb-dev libxcomposite-dev \
libxcursor-dev libxdamage-dev libxi-dev libxinerama-dev libxkbcommon-x11-dev libxrandr-dev \
libxss-dev 

Install Required Tools

The following packages are the tools necessary for building the viewer. Some may already be installed.

build-essential gdb mesa-common-dev python-pip unzip
x11proto-dri2-dev x11proto-dri3-dev x11proto-randr-dev x11proto-xf86dri-dev
x11proto-xinerama-dev x11proto-scrnsaver-dev xcb xcb-proto
sudo apt install build-essential gdb mesa-common-dev python-pip unzip \
x11proto-dri2-dev x11proto-dri3-dev x11proto-randr-dev x11proto-xf86dri-dev \
x11proto-xinerama-dev x11proto-scrnsaver-dev xcb xcb-proto 
Cmake

Cmake version 3.18 is required but not available in Ubuntu's repositories, we have to build it from source

wget https://github.com/Kitware/CMake/releases/download/v3.18.0/cmake-3.18.0.tar.gz
tar xvf cmake-3.18.0.tar.gz
cd cmake-3.18.0
./bootstrap --parallel=$(nproc) --prefix=/usr && make -j $(nproc) && sudo make install
Git

To ensure the best compatibility, we'll also build git from source

cd ~/src
sudo apt install dh-autoreconf libcurl4-gnutls-dev libexpat1-dev \
  gettext libz-dev libssl-dev asciidoc xmlto docbook2x install-info
wget -O git-2.28.0.tar.gz https://github.com/git/git/archive/v2.28.0.tar.gz 
tar -zxf git-2.28.0.tar.gz
cd git-2.28.0
make configure
./configure --prefix=/usr
make -j $(nproc) all doc info
sudo make install install-doc install-html install-info

When you need to update git, use

git clone git://git.kernel.org/pub/scm/git/git.git
Git Alternative

Or, you can install git from the Ubuntu repository:

sudo apt install git
Install Autobuild

Autobuild is a Linden Lab resource that does all the hard work. Firestorm 5.1 uses a stock, unmodified version of autobuild from Linden Lab, version 1.1 or above.

sudo pip install --upgrade pip
sudo pip install autobuild

Download the Source Code

There are two required repositories, the viewer itself and the build variables. An optional third repository is used to configure and package FmodStudio.

Clone The Viewer

cd ~/src
git clone https://vcs.firestormviewer.org/phoenix-firestorm

This will create a folder called phoenix-firestorm and add all the source files. If you desire, you can choose a different folder name by adding the name to the end of the command:

git clone https://vcs.firestormviewer.org/phoenix-firestorm NewDestinationDirectory

The rest of this document will assume the default directory, phoenix-firestorm

Clone the Autobuild build variables

Autobuild 1.1 uses a separate file to control compiler options, switches, and the like for different configurations.

cd ~/src
git clone https://vcs.firestormviewer.org/fs-build-variables

Clone 3p-FmodStudio(optional)

Although not required, including FmodStudio in your build will improve your audio-based experience in SL.

cd ~/src
git clone https://vcs.firestormviewer.org/3p-libraries/3p-fmodstudio
cd ~/src/3p-fmodstudio

Open the file called build-cmd.sh and look at the fifth line down, it begins with FMOD_VERSION. This is the version of the API you need to download.

The FMOD Studio API can be downloaded here (requires creating a free account to access the download section). Log in as needed, then go to https://www.fmod.com/download. Click FMOD Studio Suite to expand that, then scroll down to FMOD Engine.

Click the button representing the version you're after, then click the Download link for the Linux file.

Copy that file to the ~/src/3p-fmodstudio directory.

export AUTOBUILD_VARIABLES_FILE=$HOME/src/fs-build-variables/variables
autobuild build -A 64 --all
autobuild package -A 64

Near the end of the output you will see the package name written and the md5 hash below it, similar to:

wrote !/home/username/src/3p-fmodstudio/fmodstudio-2.01.02-linux64-202161533.tar.bz2
md5 c3f696412ef74f1559c6d023efe3a087

cd ~/src/phoenix-firestorm

Copy the FMOD Studio path and md5 value from the package process into this command:

autobuild installables edit fmodstudio platform=linux64 hash=<md5 value> url=file:///<fmodstudio path>

For example:

autobuild installables edit fmodstudio platform=linux64 hash=c3f696412ef74f1559c6d023efe3a087 url=file:///!/src/3p-fmodstudio/fmodstudio-2.00.07-linux64-200912220.tar.bz2
Note: Having modified autobuild.xml would require it be restored before trying to fetch any new commits or more especially if you push a commit. This can be done with *git reset –hard && git remote update*

Configure and build

Configuring the Viewer

Start by initializing the variables

export AUTOBUILD_VARIABLES_FILE=$HOME/src/fs-build-variables/variables

You can add that to ~/.bashrc or ~/.profile so they execute automatically, or execute them before you run autobuild.

cd ~/src/phoenix-firestorm
autobuild configure -A 64 -c ReleaseFS_open

This will set up to compile with all defaults and without non-default libraries. It will fetch any additional necessary libraries.

Configuration Switches

There are a number of switches you can use to modify the configuration process. The name of each switch is followed by its type and then by the value you want to set.

  • LL_TESTS (bool) controls if the tests are compiled and run. There are quite a lot of them so excluding them is recommended unless you have some reason to need one or
    more of them.
  • clean will cause autobuild to remove any previously compiled objects and fetched packages. It can be useful if you need to force a reload of all packages
  • package will result in a bzip2 archive of the completed viewer. Enabled by default, you would have to use -DPACKAGE:BOOL=Off to disable it
  • chan will set a unique channel (and the name) for the viewer, appending whatever is defined to “Firestorm-”. By default, the channel is “private” followed by your computer's name.
  • fmodstudio will tell autobuiild to use the FmodStudio package when compiling.

Most switches start with a double-dash (--). And if you use any switches you must enclose them with a double-dash at the start and an optional double-dash at the end.

TIP: OFF and NO are the same as FALSE; anything else is considered to be TRUE

Examples:

autobuild configure -A 64 -c ReleaseFS_open -- -DLL_TESTS:BOOL=FALSE
autobuild configure -A 64 -c ReleaseFS_open -- --clean
autobuild configure -A 64 -c ReleaseFS_open -- --chan="MyBuild"

In the last example, the channel and resulting viewer name would be “Firestorm-MyBuild”.

The first time you configure, several additional files will be downloaded from Firestorm and Second Life sources. These are mostly binary packages maintained outside the viewer development itself. And if you use the –clean switch, you will re-download them all.

Compiling the Viewer

autobuild build -A 64 -c ReleaseFS_open

Be sure to use the fmodstudio and chan switches again.

Now, sit back, read War and Peace, calculate PI to 50 places, tour the country, whatever you desire. Compiling can take quite a bit of time depending on your computer's processing power.

NOTE: It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command (autobuild build -A 64 -c ReleaseFS_open – –clean [more switches]). For clarity, they are mentioned separately.

Copy Out Of The Guest

If you build the viewer using a virtual machine (guest), you will need to copy the viewer files over to your host or to a different machine in order to use the viewer. Your guest may not have sufficient resources to run the viewer. The rsync program can make copying easy and accurate. And if you build the viewer again, the options included in the command example will cause rsync to only copy the new files, cutting down on the time needed to copy.

The build process created an ready-to-use viewer as well as a compressed archive. The archive can be copied or moved to any shared filesystem, such as a flash or cloud drive, and using it would be no different than using the official release.

cp ~/src/phoenix-firestorm/build-linux-x86_64/newview/Phoenix*.tar.* /path/to/shared/drive

or

mv ~/src/phoenix-firestorm/build-linux-x86_64/newview/Phoenix*.tar.* /path/to/shared/drive

When copying the ready-to-run folders and files, use

rsync -rptgoDLK --update --progress ~/src/phoenix-firestorm/build-linux-x86_64/newview/packaged/* /path/to/destination

Using rsync has the advantage of updating the destination, replacing only those files that changed or are missing, which takes much less time than copying and replacing every file.

Running your newly built viewer

Running from a menu item

Create the desktop launcher after copying to the destination machine

cd /path/to/firestorm
etc/refresh_desktop_app_entry.sh

Then open your applications menu and look in the Internet or Network branch for the Firestorm launcher.

Running from command line or file browser

cd /path/to/firestorm
./firestorm

Troubleshooting

Handling problems

If you encounter errors or run into problems, please first double check that you followed the steps correctly. One typo can break it. Then, check whether someone else already had the same issue. A solution might be known already.

  • Firestorm Self-Compilers group:Firestorm Self Compilers is free to join, fellow self-compilers may be able to offer assistance.
  • IRC: The #phoenixviewer-dev channel is the best place to look for solutions.
    A lot of self-compilers and project developers hang out there and are ready to help you.
  • Jira:JIRA may contain resolved issues related to the error you're seeing.
    Search using the error you encountered. Or create a new issue to report an error in this document, or if a code change causes a build process to fail.
  • Included documentation: In the Firestorm program directory are several “README” documents. You should make yourself familiar with their content, even if they appear to be out of date. Also, in the firestorm script file are comments and options you can adjust.

Common Issues/Bugs/Glitches And Solutions

  • Virtual Memory Exhausted, or similar out-of-memory issues

    may occur if you are building the viewer for the first time, or re-building after a very large set of changes were added. Sometimes restarting the build command will let you recover, sometimes you have to restart the build system. To avoid that from happening, add a lot of swap space, something on the order of 2GB or more. This page shows you how.
  • Missing libraries/applications/packages This may occur if you did not or could not install the packages shown above, or are attempting to use this procedure with a different Linux OS, or are attempting to build a 32-bit viewer. Start over, making sure you are using the right OS, reinstall all packages as listed, and do not attempt to make a 32-bit viewer.
  • Delayed sounds Some users have noted that OpenAL plays sounds from the viewer up to 20 seconds after they are triggered. There is no solution to this via the viewer, but there may be some solutions on the Internet. Compiling with FModStudio may resolve this issue.
  • No Sounds The viewer will try to use whatever sound service you have running, but might need a little coaxing. Read through the firestorm script inside the program directlry, you will find various commented options. Uncommenting one or more may help restore sound, as can compiling with FModStudio. Refer also to the README.Linux.txt and README-linux-voice.txt files in the program directory.
  • Voice Won't Connect Refer to this link or the relevant link on this page to ensure your computer is correctly configured.

archive:fs_compiling_firestorm_alexivy_debian_10 - ↷ Page moved from ...

$
0
0

Building Firestorm in 64-bit Debian Buster

This page describes all necessary steps to build the Firestorm viewer for Linux, on Debian 10, using the updated build infrastructure introduced with Linden Lab's project Alex Ivy. It assumes you are using Debian 10, that your normal user has sudo privileges and that all standard updates have been applied using apt *upgrade*

Minimum hardware required: At least 4GB RAM with 4GB+ swap, a modern dual-core CPU and 32GB available HDD space. Minimum recommended: 8GB or more RAM, CPU with 4 or more real cores and 32GB available HDD space.

NOTE: This procedure is NOT valid for building versions of the viewer prior to the Alex Ivy merge (revision 54609)!
Please note that we do not offer support for compiling the viewer on your own. However, there are some resources available, listed below.

Install required development tools

This is needed for compiling any viewer based on the Linden Lab open source code and only needs to be done once.

All installations are done with default settings (unless told explicitly) - if you change that, you're on your own!

The required tools, some of which may already be installed, are:

make | cmake | g++ | gdb | git | python-pip

sudo apt install --install-recommends make cmake g++ gdb git python-pip

(the –install-recommends flag tells apt to install all packages recommended by each named package.)

Install Required Libraries

These libraries may be included with your distribution, and some may already be installed:

libGL.so (libgl1-mesa-dev) LibGLU.so (libglu1-mesa-dev) libstdc++.so.6 (libstdc++6)
libX11.so (libx11-dev) libxinerama-dev libxml2.so (libxml2-dev) libXrender.so (libxrender-dev)
sudo apt install --install-recommends libgl1-mesa-dev libglu1-mesa-dev libstdc++6 libx11-dev libxinerama-dev libxml2-dev libxrender-dev

Install Autobuild

Autobuild is a Linden Lab resource that automates the configure and build processes.

sudo pip install --upgrade pip
sudo pip install autobuild

This will install autobuild and add a link in the exec path.

Set up your source code tree

Typically, source code is stored in your home directory, in a subdirectory called src. Your home directory shound have at least 32GB available before downloading the source code.

mkdir ~/src #This may throw an error if the directory already exists
cd ~/src

This document will assume that all downloaded code will go into this src directory.

Setup viewer build variables

In order to make it easier to build collections of related packages (such as the viewer and all the library packages that it imports) with the same compilation options, Autobuild expects a file of variable definitions. This can be set using the environmenat variable AUTOBUILD_VARIABLES_FILE.

cd ~/src
git clone https://vcs.firestormviewer.org/fs-build-variables
source fs-build-variables/convenience Release
export AUTOBUILD_VARIABLES_FILE=$HOME/src/fs-build-variables/variables

Clone the viewer

There are several repositories available, in but the one wea re after is the development repository. You can grab all the sources if you wish, but but keep in mind that each FS source requires around 110MB initially and around 4.3GB after the binaries have been built, plus possible compiling overhead.

git clone https://vcs.firestormviewer.org/phoenix-firestorm

This can take a bit, it's a rather large download.

Prepare third party libraries

Most third party libraries needed to build the viewer will be automatically downloaded for you and installed into the build directory within your source tree during compilation. Some need to be manually prepared and are not normally required when using an open source configuration (ReleaseFS_open).

If you are manually building the third party libraries, you will have to build the correct version (32bit libraries for a 32bit viewer, 64bit versions for a 64bit viewer)!

FMOD Studio using Autobuild

If you want to use FMOD Studio to play sounds within the viewer, you will have to download your own copy. FMOD Studio can be downloaded here (requires creating a free account to access the download section).

Make sure to download the FMOD Studio API and not the FMOD Studio Tool!
cd ~/src
git clone https://vcs.firestormviewer.org/3p-libraries/3p-fmodstudio
  • After you have cloned the repository, copy the downloaded FMOD Studio installer file to ~/src/3p-fmodstudio
  • If you downloaded a different version of FMOD Studio that is currently used in the viewer, you will have to modify the file build-cmd.sh in the root of the repository. Right at the top, you find the version number of FMOD Studio you want to package (one short version without separator and one long version). Change these values to the version you downloaded:
FMOD_VERSION="20007"
FMOD_VERSION_PRETTY="2.00.07"
cd ~/src/3p-fmodstudio
autobuild build -A 64 --all
autobuild package -A 64

Near the end of the output you will see the package name written and the md5 hash below it:

wrote !/src/3p-fmodstudio/fmodstudio-2.00.07-linux64-200912220.tar.bz2
md5 c3f696412ef74f1559c6d023efe3a087

where {version#} is the version of FMOD Studio (like 2.00.03) and {build_id} is an internal build id of the package.

cd ~/src/phoenix-firestorm

Copy the FMOD Studio path and md5 value from the package process into this command:

autobuild installables edit fmodstudio platform=linux64 hash=<md5 value> url=file:///<fmodstudio path>

For example:

autobuild installables edit fmodstudio platform=linux64 hash=c3f696412ef74f1559c6d023efe3a087 url=file:///!/src/3p-fmodstudio/fmodstudio-2.00.07-linux64-200912220.tar.bz2
Note: Having modified autobuild.xml would require it be restored before trying to fetch any new commits or more especially if you push a commit. This can be done with *git reset –hard && git remote update*

Configuring the Viewer

 cd ~/src/phoenix-firestorm
 autobuild configure -A 64 -c ReleaseFS_open

This will configure Firestorm to be built with all defaults and without third party libraries.

Note: Configuring the viewer for the first time will take some time to download all the required third-party libraries. As of Autobuild 1.1, the download progress is hidden by default. If you want to watch the download progress, you can use the verbose option to display a more detailed output:
autobuild configure -v -c ReleaseFS_open

Configuration switches

There are a number of switches you can use to modify the configuration process. The name of each switch is followed by its type and then by the value you want to set.

  • -A <architecture> sets the target architecture, that is if you want to build a 32bit or 64bit viewer (32bit is default if omitted).
  • –fmodstudio controls if the FMOD Studio package is incorporated into the viewer. You must have performed the FMOD Studio installation steps above for this to work.
  • –package makes sure all files are added to a compressed tar file for easy distribution and storage.
  • –chan <channel name> lets you define a custom channel name for the viewer
  • -LL_TESTS:BOOL=<bool> controls if the tests are compiled and run. There are quite a lot of them so excluding them is recommended unless you have some reason to need one or
    more of them.
TIP: OFF and NO are the same as FALSE; anything else is considered to be TRUE

Examples:

  • To build a 64bit viewer with FMOD Studio and to create an installer package, run this command in the Windows command window:
    autobuild configure -A 64 -c ReleaseFS_open -- --fmodstudio --package --chan MyViewer -DLL_TESTS:BOOL=FALSE
  • To build a 64bit viewer without FMOD Studio and without installer package, run this command:
    autobuild configure -A 64 -c ReleaseFS_open -- --chan MyViewer -DLL_TESTS:BOOL=FALSE

Building the viewer

Make sure you include the same architecture parameter and switches (except clean) you used while configuring the viewer:

autobuild build -A 64 -c ReleaseFS_open

Now, sit back, read War and Peace, calculate PI to 50 places, tour the country, whatever you desire. Compiling can take quite a bit of time depending on your computer's processing power.

NOTE: It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command (autobuild build -A 64 -c ReleaseFS_open [– switches] . For clarity, they are mentioned separately.

Running your newly built viewer

Running from a menu item

Create the desktop launcher

cd ~/src/phoenix-firestorm-lgpl/build-linux-x86_64/newview/packaged/etc
./refresh_desktop_app_entry.sh

Then open your applications menu and look in the Internet or Network branch for the Firestorm launcher.

Running from command line or file browser

cd ~/src/phoenix-firestorm-lgpl/build-linux-x86_64/newview/packaged
./firestorm

Your file browser/file manager many not know how to execute a script. Check the settings for your file browser. In Nautilus, for example, open Preferences > Behavior tab, change the action for executable text files to either Run or Ask.

"Installing" the viewer

Copy or move the contents of ~/src/phoenix-firestorm/build-linux-x86_64/newview/packaged to a place that can be access by the PC you want to install Firestorm on. Cloud-based storage, NAS or removable media would do.

Troubleshooting

Handling problems

If you encounter errors or run into problems, please first double check that you followed the steps correctly. One typo can break it. Then, check whether someone else already had the same issue. A solution might be known already.

  • Self-Compilers peer supportFirestorm Self Compilers is free to join, fellow self-compilers may be able to offer assistance.
  • IRC: The #phoenixviewer-dev channel is the best place to look for solutions.
    A lot of self-compilers and project developers hang out there and are ready to help you.
  • Jira:JIRA may contain resolved tickets.
    Search using the error you encountered.
  • Included documentation: In the Firestorm root folder are several “README” documents. You should make yourself familiar with their content, even if they appear to be out of date.

If you found a procedural error in this document, please let us know in as much detail as you can, either contact the author (preferred) or discuss on IRC.

Common Issues/Bugs/Glitches And Solutions

  • Missing libraries/applications/packages This may occur if you did not or could not install the listed packages. The packages do exist in the default Debian repositories, so make sure you did not disable those. If you find that a library or application is in a different package for your system, contact the team with the name of the library or application, the name of its package and your Linux OS so that information can be checked and added here.
  • Delayed sounds Some users have noted that OpenAL plays sounds from the viewer up to 20 seconds after they are triggered. There is no solution to this via the viewer, but there may be some solutions on the Internet
  • No Sounds The viewer will try to use whatever sound service you have running, but might need a little coaxing. Read through the firestorm script inside the program folder, you will find various commended options. Uncommenting one or more may help restore sound.
  • Voice Won't Connect It was observed in testing that voice would not connect unless “No Device” was chosen for the Input device (Preferences ⇒ Sound & Media ⇒ Voice ⇒ Audio Device Settings). This was resolved by replacing Firestorm/lib/libvivoxal.so.1 with a copy from release.

archive:fs_compiling_firestorm_alexivy_ubuntu_20 - ↷ Page moved from ...

$
0
0

Building Firestorm in 64-bit Ubuntu 20.04

Please note that this procedure has not yet been extensively tested on more than one system, or by more than one person. If you run into any problems after performing the steps exactly as written, please create a ticket on JIRA, that includes this page link, the step that failed and any error message you were shown.

This page describes all necessary steps1) to build the Firestorm viewer for Linux on Ubuntu 20.04, using Linden Lab's project Alex Ivy infrastructure. It assumes you are using Ubuntu 20.04 Focal Fossa, that your normal user has sudo privileges and that all standard updates have been applied using apt *upgrade*.

To successfuly compile Firestorm your computer must have at least 4GB RAM with 4GB+ swap, a modern dual-core CPU and 32GB available HDD space. However we strongly recommended you have 8GB or more RAM, a modern CPU with 4 or more real cores and 32GB available HDD space. You may require more HDD space if you compile different viewers, or different variations of Firestorm.

NOTE: This procedure is NOT valid for building versions of the viewer prior to the Alex Ivy merge (revision 54609)!
Please note that we do not offer support for compiling the viewer on your own. However, there are some resources available, listed below.

Prepare Your System

We're going to follow some conventional ideas on compiling software. Primarily, we will create a directory to contain all the source files. Open a terminal (in which we will work from here on).

cd #to jump to the home directory
mkdir -p src/sl/vorbis src/python-pip
cd src

Install Required Development Tools

Now to install the various programs used to build the viewer.

All installations are done with default settings (unless told explicitly) - if you change that, you're on your own!

The required tools, some of which may already be installed, are:

make cmake curl doxygen gdb git python2 python2-dev python-all
sudo apt install --install-recommends make cmake curl doxygen gdb git python2 python2-dev python-all

(the –install-recommends flag tells apt to install all packages recommended by each named package.)

Install PIP

Pip for Python 2.7 is not available to Ubuntu 20.04, so it takes a couple extra steps to install it

cd ~/src/python-pip
curl https://bootstrap.pypa.io/get-pip.py --output get-pip.py
sudo python2 get-pip.py
cd ~/src

In at least one case, a required symlink (/usr/bin/python) was missing. Ensure that it exists, and is pointing to Python 2.7.

sudo ln -f -s /usr/bin/python2 /usr/lib/python

Install Required Libraries

These libraries may be included with your distribution, and some may already be installed:

libGL.so (libgl1-mesa-dev) LibGLU.so (libglu1-mesa-dev) libpython-all-dev libstdc++.so.6 (libstdc++6)
libX11.so (libx11-dev) libxinerama-dev libxml2.so (libxml2-dev) libXrender.so (libxrender-dev)
sudo apt install --install-recommends libgl1-mesa-dev libglu1-mesa-dev libpython-all-dev libstdc++6 libx11-dev libxinerama-dev libxml2-dev libxrender-dev

Install Autobuild

Autobuild is a Linden Lab resource that automates the configure and build processes.

sudo pip2 install autobuild

This will install autobuild and add a link in the exec path.

Setup Viewer Build Variables

In order to make it easier to build collections of related packages (such as the viewer and all the library packages that it imports) with the same compilation options, Autobuild expects a file of variable definitions. This can be set using the environmenat variable AUTOBUILD_VARIABLES_FILE.

cd ~/src/sl
git clone https://vcs.firestormviewer.org/fs-build-variables
source fs-build-variables/convenience Release
export AUTOBUILD_VARIABLES_FILE=$HOME/src/sl/fs-build-variables/variables

Clone the viewer

There are several repositories available, in but the one wea re after is the development repository. You can grab all the sources if you wish, but but keep in mind that each FS source requires around 110MB initially and around 4.3GB after the binaries have been built, plus possible compiling overhead.

git clone https://vcs.firestormviewer.org/phoenix-firestorm

This can take a bit, it's a rather large download.

Prepare third party libraries

Most third party libraries needed to build the viewer will be automatically downloaded for you and installed into the build directory within your source tree during compilation. Some need to be manually prepared and are not normally required when using an open source configuration (ReleaseFS_open).

If you are manually building the third party libraries, you will have to build the correct version (32bit libraries for a 32bit viewer, 64bit versions for a 64bit viewer)!

Install Vorbis

Credit for the vorbis file goes to Marissa Orloff. She states that when recompiling this the following changes were made: in ogg_vorbis build.sh in line 91 needs to be edited to remove LL_release. aclocal and automake need symlinks 1.15 > 1.16

cd ~/src/sl/vorbis
wget https://fireandicegrid.net/downloads/ogg_vorbis-1.3.3-1.3.6.200930615-linux64-200930615.tar.bz2
cd ../phoenix-firestorm
autobuild installables edit ogg_vorbis platform=linux64 hash=d888b4916006c28471b4f103854526c3 url=file://$HOME/src/sl/vorbis/ogg_vorbis-1.3.3-1.3.6.200930615-linux64-200930615.tar.bz2

FMOD Studio using Autobuild

If you want to use FMOD Studio to play sounds within the viewer, you will have to download your own copy. FMOD Studio can be downloaded here (requires creating a free account to access the download section).

Make sure to download the FMOD Studio API and not the FMOD Studio Tool!
cd ~/src/sl
git clone https://vcs.firestormviewer.org/3p-libraries/3p-fmodstudio
  • After you have cloned the repository, copy the downloaded FMOD Studio installer file to ~/src/sl/3p-fmodstudio
  • Currently, FMOD Studio is at version 2.01.01, and that's what 3p-fmodstudio is expecting to use. If you plan to use a different version, you will have to modify the file build-cmd.sh in the root of the repository. Right at the top, you find the version number of FMOD Studio you want to package (one short version without separator and one long version). Change these values to the version you downloaded:
FMOD_VERSION="20101"
FMOD_VERSION_PRETTY="2.01.01"
cd ~/src/sl/3p-fmodstudio
autobuild build -A 64 --all
autobuild package -A 64

Near the end of the output you will see the package name written, including the path, and the md5 hash below it. For example:

wrote /home/user/src/sl/3p-fmodstudio/fmodstudio-2.01.01-linux64-201831958.tar.bz2
md5 a648d0a332768cab58b377566e415c88

cd ~/src/sl/phoenix-firestorm

Copy the FMOD Studio path and md5 value from the package process into this command:

autobuild installables edit fmodstudio platform=linux64 hash={md5 value} url=file://{wrote value}

For example:

autobuild installables edit fmodstudio platform=linux64 hash=a648d0a332768cab58b377566e415c88 url=file:///home/user/src/sl/3p-fmodstudio/fmodstudio-2.01.01-linux64-201831958.tar.bz2
Note: Having modified autobuild.xml would require it be restored before trying to fetch any new commits or more especially if you push a commit. This can be done with *git reset –hard && git remote update*

Configuring the Viewer

 cd ~/src/sl/phoenix-firestorm
 autobuild configure -A 64 -c ReleaseFS_open

This will configure Firestorm to be built with all defaults and without third party libraries.

Note: Configuring the viewer for the first time will take some time to download all the required third-party libraries. As of Autobuild 1.1, the download progress is hidden by default. If you want to watch the download progress, you can use the verbose option to display a more detailed output:
autobuild configure -v -c ReleaseFS_open

Configuration Options

There are a number of switches you can use to modify the configuration process. The name of each switch is followed by its type and then by the value you want to set.

  • -A <architecture> sets the target architecture, that is if you want to build a 32bit or 64bit viewer (32bit is default if omitted).

When passing one or more of the following options, they must be separated first with a double dash, which denotes the start of an options list.

  • –fmodstudio controls if the FMOD Studio package is incorporated into the viewer. You must have performed the FMOD Studio installation steps above for this to work.
  • –package makes sure all files are added to a compressed tar file for easy distribution and storage.
  • –chan <channel name> lets you define a custom channel name for the viewer
  • –no-opensim removes opemsim support, limiting the accessible grids to SL's Agni and Aditi.
  • –avx causes the viewer to build with the AVX CPU instruction support. Similarly, –avx2 enabled AVX2 support.
  • -LL_TESTS:BOOL=<bool> controls if the tests are compiled and run. There are quite a lot of them so excluding them is recommended unless you have some reason to need one or
    more of them.
TIP: OFF and NO are the same as FALSE; anything else is considered to be TRUE

Examples:

  • To build a 64bit viewer with a custom channel name, FMOD Studio and to create an installer package, run this command:
    autobuild configure -A 64 -c ReleaseFS_open -- --fmodstudio --package --chan MyViewer -DLL_TESTS:BOOL=FALSE
  • To build a 64bit viewer without FMOD Studio and without an installer package, run this command:
    autobuild configure -A 64 -c ReleaseFS_open -- --chan MyViewer -DLL_TESTS:BOOL=FALSE

Building the viewer

Make sure you include the same architecture parameter and switches (except clean) you used while configuring the viewer:

autobuild build -A 64 -c ReleaseFS_open

Now, sit back, read War and Peace, calculate PI to 50 places, tour the country, whatever you desire. Compiling can take quite a bit of time depending on your computer's processing power.

NOTE: It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command (autobuild build -A 64 -c ReleaseFS_open [– switches] . For clarity, they are mentioned separately.

Running your newly built viewer

Running from a menu item

Create the desktop launcher

cd ~/src/sl/phoenix-firestorm-lgpl/build-linux-x86_64/newview/packaged/etc
./refresh_desktop_app_entry.sh

Then open your applications menu and look in the Internet or Network branch for the Firestorm launcher.

Running from command line or file browser

cd ~/src/sl/phoenix-firestorm-lgpl/build-linux-x86_64/newview/packaged
./firestorm

Your file browser/file manager many not know how to execute a script. Check the settings for your file browser. In Nautilus, for example, open Preferences > Behavior tab, change the action for executable text files to either Run or Ask.

"Installing" the viewer

Copy or move the contents of ~/src/sl/phoenix-firestorm/build-linux-x86_64/newview/packaged to a place that can be access by the PC you want to install Firestorm on. Cloud-based storage, NAS or removable media would do.

Troubleshooting

Handling problems

If you encounter errors or run into problems, please first double check that you followed the steps correctly. One typo can break it. Then, check whether someone else already had the same issue. A solution might be known already.

  • Self-Compilers peer supportFirestorm Self Compilers is free to join, fellow self-compilers may be able to offer assistance.
  • IRC: The #phoenixviewer-dev channel is the best place to look for solutions.
    A lot of self-compilers and project developers hang out there and are ready to help you.
  • Jira:JIRA may contain resolved tickets.
    Search using the error you encountered.
  • Included documentation: In the Firestorm root folder are several “README” documents. You should make yourself familiar with their content, even if they appear to be out of date.

If you found a procedural error in this document, please let us know in as much detail as you can, either contact the author (preferred) or discuss on IRC.

Common Issues/Bugs/Glitches And Solutions

  • Missing libraries/applications/packages This may occur if you did not or could not install the listed packages. The packages do exist in the default Debian repositories, so make sure you did not disable those. If you find that a library or application is in a different package for your system, contact the team with the name of the library or application, the name of its package and your Linux OS so that information can be checked and added here.
  • Delayed sounds Some users have noted that OpenAL plays sounds from the viewer up to 20 seconds after they are triggered. There is no solution to this via the viewer, but there may be some solutions on the Internet
  • No Sounds The viewer will try to use whatever sound service you have running, but might need a little coaxing. Read through the firestorm script inside the program folder, you will find various commended options. Uncommenting one or more may help restore sound.
  • Voice Won't Connect It was observed in testing that voice would not connect unless “No Device” was chosen for the Input device (Preferences ⇒ Sound & Media ⇒ Voice ⇒ Audio Device Settings). This was resolved by replacing Firestorm/lib/libvivoxal.so.1 with a copy from release.
1)
Thanks to Manwa Pastorelli and Marissa Orloff for their contributions

fs_ao_crash_639 - [Method Two]

$
0
0

FS AO Crash with Firestorm 6.3.9

NOTE: This affects only Firestorm 6.3.9.58205

This version of Firestorm has a bug in the AO code which will result in a crash in either of these situations:

  • logging out with the AO floater (window) open.
  • creating an AO set for the first time with this version of the viewer - if you already have one or more sets defined before updating, then you're fine.

There are two workarounds:

Method One

If you still have Firestorm 6.3.2 (or earlier) available:

  1. Log in with Firestorm 6.3.2 (or earlier) which is available here
  2. Open the Firestorm AO interface
  3. If you don't normally use the Firestorm AO, delete all AO sets that are defined
  4. Otherwise, make sure that exactly one of your AO sets is marked as “Default”

Method Two

  1. Log in with the Linden Lab Second Life viewer (other viewers may also work for this)
  2. Open your Inventory
  3. Navigate to your #Firestorm folder
  4. Open the #AO folder inside there
  5. If there are any empty folders under #AO, delete them
  6. If there are no folders left under #AO, you can stop here
  7. Otherwise, check if there is exactly one folder under #AO that ends in :** (for example, Female AO:**)
  8. If not, add the :** to the AO set that you normally use

After this, you should be able to log in with 6.3.9 once again.

archive:fs_compiling_firestorm_mac - ↷ Page moved from fs_compiling_firestorm_mac to ...

$
0
0

Compiling on Mac OSX

This process has changed significantly as of revision 46075. If you're building from source after this level, see Compiling on Mac OS X with the Toolchain Update.

Getting development tools

Make sure Xcode is installed, it's a free download from Apple. Make sure cmake is installed, use at least a 2.8.x version.

  • If you are using OSX 10.6, Xcode 3 will be used.
  • If you are using OSX 10.7 “Lion” or OSX 10.8 “Mountain Lion”, the build will use Xcode 4.
  • If you are using OSX 10.9, the build will use Xcode 5 and the Clang compiler.

Additional third party libraries

If you want to use licensed FMOD Ex or KDU build libraries (they are optional) you have to provision these yourself. If you're licensing these with Phoenix-Firestorm, ask for the libraries for fmodex and kdu. Put them into:

      /opt/firestorm

If you're a community builder, you'll need to build these libraries yourself, then change your autobuild.xml file to point to your own versions, or create a different autobuild.xml with your customizations, and use this with autobuild instead of our default autobuild.xml There are some examples of how to build FMOD Ex on the LL Wiki and opensource-dev mailing list. We've created a non-KDU build target to make this easier. Everywhere you see “ReleaseFS” below, use “ReleaseFS_open” instead. This will perform the same build, using openjpeg instead of KDU.

Available premade firestorm-specific build targets:

ReleaseFS		(includes KDU, FMOD)
ReleaseFS_open		(no KDU, no FMOD)
RelWithDebInfo_open	(no KDU, no FMOD)

To build firestorm:

      autobuild build -c ReleaseFS                        

Other examples:

      autobuild configure -c ReleaseFS                    # basic configuration step, don't build, just configure
      autobuild configure -c ReleaseFS -- --clean         # clean the output area first, then configure
      autobuild configure -c ReleaseFS -- --chan Private-Yourname   # configure with a custom channel
      autobuild build -c ReleaseFS --no-configure              # default quick rebuild
      autobuild build -c ReleaseFS --no-configure -- --clean   # Clean rebuild

Any of the configure options can also be used (and do the same thing) with the build options. Typical LL autobuild configure options should also work, as long as they don't duplicate configuration we are already doing.

Logs:

      Look for logs in build-darwin-i386/logs

Output:

      Look for output in build-darwin-i386/newview/Release

Firestorm Mac Builds with Xcode 4.4.2+

This step is unnecessary if you are building Rev 38021+

Prerequisites

This is needed for compiling any viewer based on the LL open source code and only needs to be done once.

All installations are done with default settings (unless told specific) if you change that you’re on your own.

Acquire MacOSX.10.6.sdk

You will need a copy of the OSX 10.6 SDK, which can be found in Xcode 4.3.3 for Lion. You can obtain this using a free DeveloperID at https://developer.apple.com/

Once you have the Xcode 4.3.3 disc image, mount it on your system. Now, download and run this shell script:

xcode_fix.sh
#!/bin/sh

echo 'Linden fix for Xcode 4.6 to have 10.6SDK so it can build older branches.'

echo 'Be sure to have the xcode_4.3_for_lion.dmg mounted! This script pulls from that volume!'

echo 'Creating temporary directory. . .'

mkdir temp

pushd temp

echo 'Copying 10.6SDK. . .'

cp -R /Volumes/Xcode/Xcode.app/Contents//Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk .

echo 'Linking darwin10 folders as darwin11. . .'

pushd MacOSX10.6.sdk/Developer/usr/llvm-gcc-4.2/lib/gcc/

ln -s i686-apple-darwin10 i686-apple-darwin11

popd

pushd MacOSX10.6.sdk/usr/lib/gcc/

ln -s i686-apple-darwin10 i686-apple-darwin11

popd

pushd MacOSX10.6.sdk/usr/lib/

ln -s i686-apple-darwin10 i686-apple-darwin11

popd

echo 'Changing ownership and moving SDK to machine. . . Password required for sudo commands.'

sudo chown -R root:wheel MacOSX10.6.sdk

sudo mv MacOSX10.6.sdk/ /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs

popd

rm -rf temp

echo 'Xcode fix complete.'

If that finishes successfully, you're ready for the next step.

Install required development tools

  • First, install Mac Ports from http://www.macports.org/
  • Next, using Mac Ports, install Mercurial and CMake. Open a terminal window and type:
sudo port install mercurial cmake

* You may prefer using Homebrew to Mac Ports which can be found here http://brew.sh/
* Install the required tools with this command:
brew install mercurial cmake

Python 2.7 is also required, but will be installed as a dependency to Mercurial.

Install Autobuild

Autobuild is a Linden Lab resource that does all the hard work.

In a Terminal window type:

mkdir ~/tmp
cd ~/tmp
hg clone http://hg.secondlife.com/autobuild/
cd autobuild
./setup.py
sudo ./setup.py install

Set up your source code tree

Plan your directory structure ahead of time. If you are going to be producing changes or patches you will be cloning a copy of an unaltered source code tree for every change or patch you make, so you might want to have all this work stored in its own directory. If you are a casual compiler and won't be producing any changes, you can use one directory. For this document, I will assume $HOME/firestorm.

mkdir ~/firestorm
cd ~/firestorm
hg clone http://hg.phoenixviewer.com/phoenix-firestorm-lgpl/

This can take a while, it's a rather large download.

Prepare third party libraries

Most third party libraries needed to build the viewer will be automatically downloaded for you and installed into the build directory within your source tree during compilation. Some need to be manually prepared and are not normally required when using an open source configuration (ReleaseFS_open).

FMOD Ex using autobuild

Note: This typically needs to only be done once since fmodex rarely changes.

  • Enter these commands into the command prompt:
hg clone https://bitbucket.org/NickyD/3p-fmodex
cd 3p-fmodex
autobuild build
autobuild package

Near the top of the output you will see the package name written and the md5 hash below it:

wrote /Users/kittin/tmp/3p-fmod/fmod-3.75-darwin-20130105.tar.bz2'
md5 3b0d38f2a17ff1b73c8ab6dffbd661eb''

Next, update Firestorms autobuild.xml file to use your FMOD Ex.

cd /firestorm/phoenix-firestorm-lgpl
cp autobuild.xml my_autobuild.xml
export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Copy the fmodex path and md5 value from the package process into this command:

autobuild installables edit fmodex platform=darwin hash=<md5 value> url=file:///<fmod path>

For example:

autobuild installables edit fmodex platform=darwin hash=c3f696412ef74f1559c6d023efe3a087 url=file://$HOME/firestorm/3p-fmodex/fmodex-3.75-darwin-20130105.tar.bz2

Note: Having to copy autobuild.xml and modify the copy from within a cloned repository is a lot of work for every repository you make, but this is the only way to guarantee you pick up upstream changes to autobuild.xml and do not send up a modified autobuild.xml when you do an hg push.

Configuring the Viewer

If you are building with Fmod and have followed the previous Fmod setup instructions AND you are now using a new terminal you will need to reset the environment variable with

export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Then:

cd ~/firestorm/phoenix-firestorm-lgpl

 autobuild configure -c ReleaseFS_open

This will compile with all defaults and without third party libraries.

Configuration Switches

There are a number of switches you can use to modify the configuration process. The name of each switch is followed by its type and then by the value you want to set.

  • FMOD (bool) controls if the Fmod package is incorporated into the viewer. You must have performed the Fmod installation steps in Fmod_using_autobuild for this to work.
  • LL_TESTS (bool) controls if the tests are compiled and run. There are quite a lot of them so excluding them is recommended unless you have some reason to need one or
    more of them.

TIP: OFF and NO are the same as FALSE; anything else is considered to be TRUE

Example:

autobuild configure -c ReleaseFS_open -- -DLL_TESTS:BOOL=FALSE -DFMOD:BOOL=TRUE

Compiling the Viewer

If you are building with Fmod and have followed the previous Fmod setup instructions AND you are now using a new terminal you will need to reset the environment variable with

export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Then:

cd ~/firestorm/phoenix-firestorm-lgpl
autobuild build -c ReleaseFS_open --no-configure

Now, sit back, read War and Peace, calculate PI to 50 places, tour the country, whatever you desire. Compiling will take quite a bit of time.

NOTE: It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command (autobuild build -c ReleaseFS [– config options] . I find it is clearer if these steps are done separately, but can save a bit of time if done together.

Article Credits

  • Kittin Ninetails
  • Cinder Biscuits

archive:fs_compiling_firestorm_mac_toolchain_update - ↷ Page moved from ...

$
0
0

Compiling on Mac OSX with the Toolchain Update

As of revision 46075 of the main Firestorm development repository, the Linden Lab toolchain-update codebase has been merged into Firestorm. This represents a major change in the tools required to build the viewer.

With this change, the viewer and its libraries must be built with Xcode 6, CMake 3, and a metadata-capable version of Linden Lab's autobuild tool. Xcode 6 will only run on OS X 10.9 (Mavericks) or later; the last version to run on Mavericks is 6.2. As of this writing, Xcode 6.3.2 is current; that version only runs on OS X 10.10 (Yosemite).

If you want to build a 64-bit version, you must be at least at revision 46220.

Getting development tools

You will need to install the following tools:

  • Xcode. It's a free download from Apple. If you're using Mavericks, you will need to download Xcode 6.2 from the Apple Developers Connection site. You'll need an Apple ID to sign up for that if you haven't. If you're on Yosemite, you can get Xcode without an ADC login.
    • You will need to install the command line tools. To do this, after you've copied the Xcode application to your Applications folder, open a command line (Terminal, or equivalent) window, and issue the command
      xcode-select --install
  • CMake version 3.
    • Again, you will need to install the command line links. The menu option to do this from within CMake is broken, and has been for several versions. From your command line prompt, issue the following command:
      sudo /Applications/CMake.app/Contents/MacOS/CMake
    • This will launch the CMake application with root permissions. Once you've done that, select Tools→Install for Command Line Use from the CMake menu. When that completes, exit CMake.
  • The latest version of the Mercurial source code management system.
    • Use
      hg clone https://bitbucket.org/NickyD/autobuild-1.0

      to put it somewhere convenient.

    • Add it to your PATH environment variable. The OS X-approved way to do this is to issue the following two commands:
      sudo ln -s <path/to/the/directory> /usr/local/bin/autobuild
      echo '/usr/local/bin/autobuild/bin' | sudo tee /etc/paths.d/99-autobuild

This will not take effect until the next time you open a Terminal window.

  • The pip Python package installation tool, which is required for the next step. Follow the installation instructions on the pip installation page. You will need to run get-pip.py with sudo.
  • The llbase Python package used by autobuild. Issue this command:
    sudo pip install llbase

Additional third party libraries

If you want to use licensed FMOD Ex or KDU build libraries (they are optional) you have to provide these yourself. If you're building Firestorm as part of the project team, ask for the libraries for fmodex and kdu. Put them into /opt/firestorm .

If you're a community builder, you'll need to build these libraries yourself, then change your autobuild.xml file to point to your own versions, or create a different autobuild.xml with your customizations, and use this with autobuild instead of our default autobuild.xml There are some examples of how to build FMOD Ex on the LL Wiki and opensource-dev mailing list.

We've created a non-KDU build target to make this easier. Everywhere you see “ReleaseFS” below, use “ReleaseFS_open” instead. This will perform the same build, using openjpeg instead of KDU and omitting FMOD Ex.

Available premade firestorm-specific build targets:

ReleaseFS		(includes KDU, FMOD)
ReleaseFS_open		(no KDU, no FMOD)
RelWithDebInfo_open	(no KDU, no FMOD)

To build firestorm:

      autobuild build -c ReleaseFS                        

Other examples:

      autobuild configure -c ReleaseFS                    # basic configuration step, don't build, just configure
      autobuild configure -c ReleaseFS -- --clean         # clean the output area first, then configure
      autobuild configure -c ReleaseFS -- --chan Private-Yourname   # configure with a custom channel
      autobuild build -c ReleaseFS --no-configure               # default quick rebuild
      autobuild build -c ReleaseFS --no-configure -- --clean    # Clean rebuild
      autobuild configure -c ReleaseFS_open --            # configure with no third-party libraries
      autobuild configure -c ReleaseFS_open -- --fmodex   # configure with FMOD Ex but no KDU

Any of the configure options can also be used (and do the same thing) with the build options. Typical LL autobuild configure options should also work, as long as they don't duplicate configuration we are already doing.

Logs: Look for logs in build-darwin-i386/logs.

Output: Look for output in build-darwin-i386/newview/Release

Set up your source code tree

Plan your directory structure ahead of time. If you are going to be producing changes or patches you will be cloning a copy of an unaltered source code tree for every change or patch you make, so you might want to have all this work stored in its own directory. If you are a casual compiler and won't be producing any changes, you can use one directory. For this document, I will assume $HOME/firestorm.

mkdir ~/firestorm
cd ~/firestorm
hg clone http://hg.phoenixviewer.com/phoenix-firestorm-lgpl/

This can take a while. It's a rather large download.

Prepare third party libraries

Most third party libraries needed to build the viewer will be automatically downloaded for you and installed into the build directory within your source tree during compilation. Some need to be manually prepared and are not normally required when using an open source configuration (ReleaseFS_open).

FMOD Ex using autobuild

Note: This typically needs to only be done once since fmodex rarely changes.

  • Enter these commands into the command prompt:
hg clone https://bitbucket.org/NickyD/3p-fmodex
cd 3p-fmodex
autobuild build
autobuild package

Near the top of the output you will see the package name written and the md5 hash below it:

wrote /Users/tonya/3p-fmodex/fmodex-44453-darwin-201505171651-r21.tar.bz2
md5 3b0d38f2a17ff1b73c8ab6dffbd661eb

Next, update Firestorms autobuild.xml file to use your FMOD Ex.

cd ~/firestorm/phoenix-firestorm-lgpl
cp autobuild.xml my_autobuild.xml
export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Copy the fmodex path and md5 value from the package process into this command:

autobuild installables edit fmodex platform=darwin hash=<md5 value> url=file:///<fmod path>

For example:

autobuild installables edit fmodex platform=darwin hash=3b0d38f2a17ff1b73c8ab6dffbd661eb url=file:///Users/tonya/3p-fmodex/fmodex-44453-darwin-201505171651-r21.tar.bz2

Note: Having to copy autobuild.xml and modify the copy from within a cloned repository is a lot of work for every repository you make, but this is the only way to guarantee you pick up upstream changes to autobuild.xml and do not send up a modified autobuild.xml when you do an hg push.

Configuring the Viewer

If you are building with FMOD Ex and have followed the previous FMOD Ex setup instructions AND you are now using a new terminal you will need to reset the environment variable with

export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Then:

cd ~/firestorm/phoenix-firestorm-lgpl

 autobuild configure -c ReleaseFS_open

This will compile with all defaults and without third party libraries.

Configuration Switches

There are a number of switches you can use to modify the configuration process. The name of each switch is followed by its type and then by the value you want to set.

  • FMODEX (bool) controls if the FMOD Ex package is incorporated into the viewer. You must have performed the FMOD Ex installation steps in Fmod_using_autobuild for this to work. This is the switch the –fmodex build argument sets.
  • LL_TESTS (bool) controls if the tests are compiled and run. There are quite a lot of them so excluding them is recommended unless you have some reason to need one or more of them.

TIP: OFF and NO are the same as FALSE; anything else is considered to be TRUE

Example:

autobuild configure -c ReleaseFS_open -- -DLL_TESTS:BOOL=FALSE -DFMOD:BOOL=TRUE

There is one other switch you can set. The -m64 switch tells autobuild to build a 64-bit version of the viewer. Unlike the others, this one goes before the build or configure argument, as in

autobuild -m64 configure -c ReleaseFS_open

It must be specified on both the configure and build commands. If you want to build a 64-bit viewer after building for 32 bits, or vice versa, you must do the first build when you change the architecture with –clean; otherwise, the viewer may build, but will almost certainly refuse to run.

Compiling the Viewer

If you are building with FMOD Ex and have followed the previous FMOD Ex setup instructions AND you are now using a new terminal you will need to reset the environment variable with

export AUTOBUILD_CONFIG_FILE=my_autobuild.xml

Then:

cd ~/firestorm/phoenix-firestorm-lgpl
autobuild build -c ReleaseFS_open --no-configure

Now, sit back, read War and Peace, calculate π to 50 places, tour the country, whatever you desire. Compiling may take quite a bit of time, depending on how fast your machine is and how much else you're doing.

NOTE: It is possible to use autobuild to do both the configure step (only needed once) and the build step with one command (autobuild build -c ReleaseFS [– config options] .) Some find it is clearer if these steps are done separately, but can save a bit of time if done together.

Article Credits

  • Kittin Ninetails
  • Cinder Biscuits
  • Reworked for the toolchain update by Tonya Souther

fsg_gateway_team

$
0
0

fs_my_environments_6.4.5.png - created

Viewing all 5258 articles
Browse latest View live


<script src="https://jsc.adskeeper.com/r/s/rssing.com.1596347.js" async> </script>