''A place to share tweaks for Viewer 2''

== XML modifications ==

Note: you may need to replace ''en'' with the appropriate code of the language you're using: ''fr'', ''it''...<BR>
Example: in 1.1, Italian users should edit this file: skins/default/xui/'''it'''/panel_nearby_chat_bar.xml

==== Extend the Nearby Chat bar ====

* In '''skins/default/xui/en/panel_nearby_chat_bar.xml'''
Change the max_width (pixels) to a more suitable value.
<pre>
<string name="max_width">
320
</string>
</pre>
Try a value of 1000 or greater.

-- [[User:Psi_Merlin | Psi Merlin]]

==== Hiding IM popups ====

* Replace '''panel_instant_message.xml''' located in '''skins\default\xui\en'''
With the xml from

http://pastebin.com/7eZhHR82

:this is not a perfect solution but best i can do
''--Alexandrea Fride 22:08, 26 February 2010 (UTC)''

==== Add BUILD option to the rightclick on object menu ====
-->SEE NEXT FOR BUILD+INSPECT<--

*Replace the contents of '''menu_object.xml''' located in '''skins\default\xui\en'''
With the xml from
http://pastebin.com/RNneHXft
Screenshot
[[File:Build-option-menu.png]]

Patch File (informatieve)
<pre>
Index: indra/newview/skins/default/xui/en/menu_object.xml
===================================================================
--- indra/newview/skins/default/xui/en/menu_object.xml (revision 2)
+++ indra/newview/skins/default/xui/en/menu_object.xml (working copy)
@@ -21,14 +21,15 @@
<menu_item_call.on_visible
function="EnableEdit"/>
</menu_item_call>
- <menu_item_call
- label="Build"
- name="Build">
- <menu_item_call.on_click
- function="Object.Edit" />
- <menu_item_call.on_visible
- function="VisibleBuild"/>
- </menu_item_call>
+ <menu_item_call
+ enabled="false"
+ label="Build"
+ name="Create">
+ <menu_item_call.on_click
+ function="Land.Build" />
+ <menu_item_call.on_enable
+ function="EnableEdit" />
+ </menu_item_call>
<menu_item_call
enabled="false"
label="Open"
</pre>
''--Alexandrea Fride 22:08, 26 February 2010 (UTC)''

==== Add Inspect back on objects and avatar objects ====
{{Note|Vote for {{jira|VWR-16978}} if you want this back in the official Viewer or {{jira|SNOW-545}} for Snowglobe 2}}

*note if you have the build patch alredy done this will replace it, use path file below to manualy add it
*Replace the contents of '''menu_object.xml''' located in '''skins\default\xui\en'''
With the xml from
http://pastebin.com/K1MmbfZm

*Replace the contents of '''menu_attachment_other.xml''' located in '''skins\default\xui\en'''
With the xml from
http://pastebin.com/EKfBp3ge

Screenshot
[[File:Inspect-v2.0.png]]

Patch File (informatieve)
<pre>
Index: indra/newview/skins/default/xui/en/menu_attachment_other.xml
===================================================================
--- indra/newview/skins/default/xui/en/menu_attachment_other.xml (revision 2)
+++ indra/newview/skins/default/xui/en/menu_attachment_other.xml (working copy)
@@ -104,4 +104,11 @@
<menu_item_call.on_enable
function="Object.EnableInspect" />
</menu_item_call>
+ <menu_item_call
+ label="Inspect"
+ name="Object Inspect">
+ <menu_item_call.on_click
+ function="Floater.Show"
+ parameter="inspect" />
+ </menu_item_call>
</context_menu>
Index: indra/newview/skins/default/xui/en/menu_object.xml
===================================================================
--- indra/newview/skins/default/xui/en/menu_object.xml (revision 2)
+++ indra/newview/skins/default/xui/en/menu_object.xml (working copy)
@@ -57,6 +57,13 @@
<menu_item_call.on_enable
function="Object.EnableInspect" />
</menu_item_call>
+ <menu_item_call
+ label="Inspect"
+ name="Object Inspect">
+ <menu_item_call.on_click
+ function="Floater.Show"
+ parameter="inspect" />
+ </menu_item_call>
<menu_item_call
label="Zoom In"
name="Zoom In">
</pre>

--Alexandrea Fride 14:31, 1 March 2010 (UTC)

==== Make Chat and IM Windows Transparent ====

* Navigate to: '''\skins\default\xui\en\widgets\'''
* Locate and open "floater.xml" in a text editor.
* Locate the line: <code>background_visible="true"</code>
* Change the value to: <code>background_visible="false"</code>

''--Submitted by Sean McPherson - Posted by Dirk Talamasca 10:41 am (UTC) on Saturday, Feb 27, 2010''

==== Make chat and on/offline popups semi-transparent ====

* Navigate to '''\skins\default\textures\windows'''
* Make a backup copy of Toast_Over.png
* Copy Toast_Background.png to Toast_Over.png

''-- Jonathan Yap 14:29, 28 February 2010 (UTC)''

==== Make Named Windows (Nearby Chat, Conversations, etc.) semi-transparent ====

* Navigate to '''\skins\default\textures\windows'''
* Make a backup copy of Window_Background.png
* Copy Toast_Background.png to Window_Background.png

This will change:
* About Land
* Conversations
* Debug Settings
* Environment Editor
* Find border
* Map
* My Land
* Nearby Chat
* Preferences
* Region/Estate
* Script editor border
* Snapshot Preview
* Statistics
Add more to this list if you discover them.

'''Note:''' You may have to tear off, click, or mess with Nearby Chat once for the change to take effect.

''-- Jonathan Yap 01:46, 1 March 2010 (UTC)''

==== Adding About land Button on top navigation bar ====

*Replace the contents of '''panel_navigation_bar.xml''' located in '''skins\default\xui\en'''
With the xml from
http://pastebin.com/bh7N1dC5

Screenshot
[[File:About-land.png]]

Patch File (informatieve)
<pre>
Index: indra/newview/skins/default/xui/en/panel_navigation_bar.xml
===================================================================
--- indra/newview/skins/default/xui/en/panel_navigation_bar.xml (revision 2)
+++ indra/newview/skins/default/xui/en/panel_navigation_bar.xml (working copy)
@@ -73,6 +73,20 @@
tool_tip="Teleport to my home location"
top_delta="0"
width="32" />
+ <button
+ follows="left|top"
+ height="23"
+ layout="topleft"
+ left_pad="7"
+ name="About_Land"
+ label="About Land"
+ tool_tip="About Land"
+ top_delta="0"
+ width="70">
+ <button.init_callback
+ function="Button.SetFloaterToggle"
+ parameter="about_land" />
+ </button>
<location_input
follows="left|right|top"
halign="right"
@@ -84,7 +98,7 @@
mouse_opaque="false"
name="location_combo"
top_delta="0"
- width="266">
+ width="195">



- <search_combo_box
- bevel_style="none"
- border_style="line"
- border.border_thickness="0"
- commit_on_focus_lost="false"
- follows="right|top"
- halign="right"
- height="22"
- label="Search"
- layout="topleft"
- right="-10"
- mouse_opaque="false"
- name="search_combo_box"
- tool_tip="Search"
- top_delta="0"
- width="200" >
- <combo_editor
- label="Search [SECOND_LIFE]"
- name="search_combo_editor"/>
- <combo_list
- draw_border="true"
- border.highlight_light_color="FocusColor"
- border.highlight_dark_color="FocusColor"
- border.shadow_light_color="FocusColor"
- border.shadow_dark_color="FocusColor"/>
- </search_combo_box>
- </panel>
+ <search_combo_box
+ bevel_style="none"
+ border_style="line"
+ border.border_thickness="0"
+ commit_on_focus_lost="false"
+ follows="right|top"
+ halign="right"
+ height="22"
+ label="Search"
+ layout="topleft"
+ right="-10"
+ mouse_opaque="false"
+ name="search_combo_box"
+ tool_tip="Search"
+ top_delta="0"
+ width="200" >
+ <combo_editor
+ label="Search [SECOND_LIFE]"
+ name="search_combo_editor"/>
+ <combo_list
+ draw_border="true"
+ border.highlight_light_color="FocusColor"
+ border.highlight_dark_color="FocusColor"
+ border.shadow_light_color="FocusColor"
+ border.shadow_dark_color="FocusColor"/>
+ </search_combo_box>
+ </panel>
<favorites_bar
follows="left|right|top"
font="SansSerifSmall"
</pre>
[[User:Dimentox Travanti|Dimentox Travanti]] 05:52, 28 February 2010 (UTC)

==== Close IM windows instead of just minimize ====

* A workaround for this is to change can_close="true" in the floater_im_container.xml file.

''--Garn Conover 14:05:36, 28 February 2010 (UTC)''

==== Vertical Tabs in the Tabbed Chats Window ====

If you have used Emerald or a few other third party viewers, and used the vertical tabs setting, you know why this is useful. The new viewer can be hacked to have vertical tabs. Go to the folder where you installed it and look in the skins folder for your locale (mine is '''C:\Program Files\SecondLifeBetaViewer\skins\default\xui\en''') for a file called '''floater_im_container.xml'''. Open that in your favorite text editor and look for a line that says '''tab_position="bottom"''' and change it to say '''tab_position="left"'''. then look for a line that says '''tab_width="64"''' and change that to '''tab_width="134"''' (or any width that looks good to you and within the minimum and maximum definitions defined in adjacent lines). That will give you vertical tabs on friend and group IMs.

'''NOTE!''' i do not know how this will affect if you don't use a single tabbed window for IM's, but i suspect that ungrouped IM are not affected at all because i dont think they use this container layout defined in this file.

''-- Eternus Soulstar 16:42, 28 February 2010 (UTC)''

Thanks, Eternus, love those vertical tabs! I encountered a horizontal line through my text entry box when using this in conjunction with Jonathan's transparent floater tweak below, and fixed it by setting the icon height="24" (was height="17") toward the bottom of floater_im_container.xml .

''-- Latha Serevi 1 March 2010''

==== Add Grid Status and Xstreet option under Me ====

Handy two option modification to open Grid status or Xstreet webpages from within your viewer!

Will appear under "Me" once you have logged into secondlife via the Viewer.

'''NOTE''' Change "en" to whatever language folder you use if not English and make the modification by hand (This is for english only).

* Replace the xml inside '''menu_viewer.xml''' located in '''skins\default\xui\en'''
With the xml from

http://pastebin.com/xyiczDy0

Additional XML Code used
<pre>

<menu_item_call
label="Grid status"
layout="topleft"
name="Grid Status">
<menu_item_call.on_click
function="PromptShowURL"
name="GridStatus_url"
parameter="WebLaunchJoinNow,http://status.secondlifegrid.net/" />
</menu_item_call>


<menu_item_call
label="Xstreet Marketplace"
layout="topleft"
name="Xstreet Marketplace">
<menu_item_call.on_click
function="PromptShowURL"
name="Xstreet_url"
parameter="WebLaunchJoinNow,http://www.xstreetsl.com/" />
</menu_item_call>

</pre>

[[File:XstreetGridStat.png]]

Result will appear as above.

--[[User:DigitaL Scribe|DigitaL Scribe]] 04:01, 1 March 2010 (UTC)

==== Changed the way how sidebar works ====

'''NOTE''' sidebar will no longer "crop" your sl view of world, and now is also on top all floaters INCLUDING notification popups... see screenshot.

'''NOTE''' if you have anny sugestions to improve more leave message at forums [https://blogs.secondlife.com/message/115075 How to improve v2.0 (xml/Graphics mods)]

'''NOTE''' As alwayse backup your files!

* Replace the xml inside '''main_view.xml ''' located in '''skins\default\xui\en'''
With the xml from

http://pastebin.com/sKYmDAPi

screenshot:
[http://i49.tinypic.com/ehk6ms.png]

Patch File (informatieve)
<pre>
Index: indra/newview/skins/default/xui/en/main_view.xml
===================================================================
--- indra/newview/skins/default/xui/en/main_view.xml (revision 2)
+++ indra/newview/skins/default/xui/en/main_view.xml (working copy)
@@ -100,17 +100,6 @@
visible="false"/>
</layout_stack>
</layout_panel>
- 
- <layout_panel auto_resize="false"
- follows="all"
- height="500"
- min_width="333"
- mouse_opaque="false"
- tab_stop="false"
- name="side_tray_container"
- user_resize="false"
- visible="false"
- width="333"/>
</layout_stack>
<panel follows="all"
height="500"
@@ -131,6 +120,35 @@
top="0"
width="1024"/>
</panel>
+ <layout_stack border_size="0"
+ follows="all"
+ height="470"
+ left="0"
+ mouse_opaque="false"
+ name="sidebar"
+ orientation="horizontal"
+ top="0"
+ width="1024">
+ <panel follows="right|top|bottom"
+ height="500"
+ mouse_opaque="false"
+ name="side_bar_tabs"
+ right="500"
+ tab_stop="false"
+ top="0"
+ width="32"/>
+ <layout_panel auto_resize="false"
+ follows="all"
+ height="470"
+ min_width="333"
+ mouse_opaque="false"
+ tab_stop="false"
+ name="side_tray_container"
+ user_resize="false"
+ visible="false"
+ width="333"/>
+
+ </layout_stack>
<debug_view follows="all"
left="0"
top="0"
</pre>

== Debug Settings ==

Go to the Advanced menu and click on Show Debug Settings.

Things you might want to change:

* '''ChannelBottomPanelMargin''' -- set to 30 to have your popup chats start a little lower
* '''NearbyToastLifeTime''' -- How long popup chats are on the screen
* '''PluginInstancesTotal''' -- set to 0 if you never want media on a prim to play, even if you click on a MoaP, or increase it if you want to see more than the default of 8. (Note that MoaP is '''not''' the only place where SLPlugin is used. It will also affect the "Home" panel of the sidebar, the Help Browser and the search. Setting this to 0 will not allow you to use the search anymore!)
* '''ToastGap''' -- set to 0 to close up the gap between popup chats

Viewer 2 Tweaks/Beta 3

2010-03-01T14:31:11Z

File:Build-option-menu.png

2010-02-27T13:05:54Z

Alexandrea Fride:

File:About-land.png

2010-02-27T13:03:51Z

Alexandrea Fride:

Viewer 2 Tweaks/Beta 3

2010-02-26T22:08:32Z

Alexandrea Fride: adding my mods

''A place to Share tweaks for Viewer 2''

== '''Some Secondlife viewer 2.0 XML mods By Alexandrea Fride''' ==
'''Hiding IM popups'''

----

http://pastebin.com/7eZhHR82 and xml '''panel_instand_message.xml''' located in '''skins\default\xui\en'''

*this is not a perfect solution but best i can do

'''Adding BUILD menu in richtclick on object'''

----

http://pastebin.com/RNneHXft and xml '''menu_object.xml''' located in '''skins\default\xui\en'''

----

in both cases replace the whole file

--Alexandrea Fride 22:08, 26 February 2010 (UTC)

User talk:Alexandrea Fride

2010-02-26T21:26:31Z

Alexandrea Fride: /* Some Secondlife viewer 2.0 XML mods */

== '''Some Secondlife viewer 2.0 XML mods''' ==
'''Hiding IM popups'''

----

http://pastebin.com/7eZhHR82 and xml '''panel_instand_message.xml''' located in '''skins\default\xui\en'''

*this is not a perfect solution but best i can do

'''Adding BUILD menu in richtclick on object'''

----

http://pastebin.com/RNneHXft and xml '''menu_object.xml''' located in '''skins\default\xui\en'''

----

in both cases replace the whole file

--Alexandrea Fride 21:25, 26 February 2010 (UTC)

User talk:Alexandrea Fride

2010-02-26T21:25:30Z

Alexandrea Fride:

== '''Some Secondlife viewer 2.0 XML mods''' ==
'''Hiding IM popups'''

----

http://pastebin.com/7eZhHR82 and xml '''panel_instand_message.xml''' located in '''skins\default\xui\en'''

'''Adding BUILD menu in richtclick on object'''

----

http://pastebin.com/RNneHXft and xml '''menu_object.xml''' located in '''skins\default\xui\en'''

----

in both cases replace the whole file

--Alexandrea Fride 21:25, 26 February 2010 (UTC)

Template:Snowglobe-installers-trunk

2009-12-22T23:16:59Z

Alexandrea Fride: update rev 3064

<noinclude>
<div class="navbox">
Very brief (but frequently updated) blurb included on at least a couple of pages.

Template for including in the [[Open Source Portal]] (actually [[Template:Open Source Portal/Featured]]) to make it so that there's download links for Windows, Mac, and Linux given a build number.

See [[Version numbering]] for explanation of numbering.

This template is for builds off of /projects/2009/snowglobe/trunk. Use [[Template:Snowglobe-installers|<nowiki>{{Snowglobe-installers}}</nowiki>]] when you want to insert a set of links for a released version of Snowglobe.

</div>
</noinclude>{{#if:
{{#vardefine:w |1 }}
{{#vardefine:x |3 }}
{{#vardefine:y |0 }}
{{#vardefine:z |3064 }}
{{#vardefine:branch |trunk }}
{{#vardefine:date |December 18, 2009 }}
{{#vardefine:year |2009 }}
{{#vardefine:macsuffix|_SNOWGLOBETESTBUILD}}
}}{{Snowglobe-installers-trunk/{{{1|en}}}}} [http://secondlife.com/developers/opensource/downloads/{{#var:year}}/{{#var:branch}}/{{#var:z}}/Snowglobe_{{#var:w}}-{{#var:x}}-{{#var:y}}-{{#var:z}}_Setup.exe Windows] [http://secondlife.com/developers/opensource/downloads/{{#var:year}}/{{#var:branch}}/{{#var:z}}/Snowglobe_{{#var:w}}_{{#var:x}}_{{#var:y}}_{{#var:z}}{{#var:macsuffix}}.dmg Mac] [http://secondlife.com/developers/opensource/downloads/{{#var:year}}/{{#var:branch}}/{{#var:z}}/Snowglobe-i686-{{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}.tar.bz2 Linux] ''({{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}, {{#var:date}})'' ([[Release Notes/Snowglobe Release/{{#var:w}}.{{#var:x}}|release notes]])

User talk:Alexandrea Fride

2009-07-31T21:20:51Z

Alexandrea Fride: Blanked the page

Template:Snowglobe-installers-trunk

2009-07-26T19:39:18Z

Alexandrea Fride: forgot date :p

<noinclude>Very brief (but frequenly updated) blurb included on at least a couple of pages. Template for including in the [[Open Source Portal]] (actually [[Template:Open Source Portal/Featured]]) to make it so that there's download links for Windows, Mac, and Linux given a build number.

See [[Version numbering]] for explanation of numbering.

This template is for builds off of /projects/2009/snowglobe/trunk. Use [[Template:Snowglobe-installers|<nowiki>{{Snowglobe-installers}}</nowiki>]] when you want to insert a set of links for a released version of Snowglobe.

</noinclude>{{#vardefine:w|1}}{{#vardefine:x|1}}{{#vardefine:y|0}}{{#vardefine:z|2565}}{{Snowglobe-installers-trunk/{{{1|en}}}}} [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}-{{#var:x}}-{{#var:y}}-{{#var:z}}_Setup.exe Windows] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}_{{#var:x}}_{{#var:y}}_{{#var:z}}_SNOWGLOBETESTBUILD.dmg Mac] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe-i686-{{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}.tar.bz2 Linux] ''({{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}, July 26, 2009)''

Template:Snowglobe-installers-trunk

2009-07-26T19:38:52Z

Alexandrea Fride: updating to build 2565

Attach

2009-07-24T19:02:11Z

Alexandrea Fride: Undo revision 437862 by Alexandrea Fride (Talk)

{{LSL_Event
|event_id=23
|event_delay
|event=attach
|p1_type=key|p1_name=id
|p1_desc=the avatar if attached, if not attached {{LSL_Constant/NULL_KEY}}.
|p1_hover=the avatar if attached, if not attached NULL_KEY.
|event_desc=Triggered in an object when the object [[attachment|attaches]] or detaches from agent.
|constants
|spec=
===Triggered===
# When the object is attached to an avatar
#* From the ground
#* From inventory
#* When the avatar wearing the object logs in
# When object is detached ('''id''' == {{LSL_Constant/NULL_KEY}})
#* Dropped to the ground
#* Derezzed to inventory
#* When the avatar wearing the object logs out

===Not Triggered===
# When the avatar wearing the object teleports
#* Use [[CHANGED_TELEPORT]] to detect when the avatar teleports
# When the avatar wearing the object moves from one region to another
#* Use [[CHANGED_REGION]] to detect when the avatar changes region
|caveats
|examples=
The following is a simplified example of the attach event. The variable id will be the key of the avatar the scripted object is attached to otherwise it will take on the value of {{LSL_Constant/NULL_KEY}}. The conditional [[if]] statement is used to determine the value of the variable id.
<lsl>default
{
attach(key id)
{
if(id)//tests if it is a valid key and not NULL_KEY
{
llSay(PUBLIC_CHANNEL,"I have been attached!");
}
else
{
llSay(PUBLIC_CHANNEL,"I have been detached!");
}
}
}</lsl>
|helpers
|also_header
|also_events=
{{LSL DefineRow|[[on_rez]]}}
|also_functions=
{{LSL DefineRow|[[llAttachToAvatar]]}}
{{LSL DefineRow|[[llDetachFromAvatar]]}}
{{LSL DefineRow|[[llGetAttached]]}}
|also_articles=
{{LSL DefineRow|{{LSLGC|Attachment}}}}
|also_footer
|notes=
===[[on_rez]] & [[attach]]===
[[on_rez]] will be triggered prior to [[attach]] when attaching from inventory or during login.

===Derez Timing===
Durring derez, an object is only given so much time to execute it's attach events. If these events are active when the script derezzes but have not completed, execution will finish when the object is next rezzed (this may not be desirable). It is advisable to keep your detach code simple.
Also [[attach]] will '''not''' be triggered if the script was looping when last rezzed. (same with [[on_rez]])
|mode
|deprecated
|cat1=Attachment
|cat2
|cat3
|cat4}}

Attach

2009-07-24T18:38:09Z

Alexandrea Fride:

{{LSL_Event
|event_id=23
|event_delay
|event=attach
|p1_type=key|p1_name=id
|p1_desc=the avatar if attached, if not attached {{LSL_Constant/NULL_KEY}}.
|p1_hover=the avatar if attached, if not attached NULL_KEY.
|event_desc=Triggered in an object when the object [[attachment|attaches]] or detaches from agent.
|constants
|spec=
===Triggered===
# When the object is attached to an avatar
#* From the ground
#* From inventory
#* When the avatar wearing the object logs in
# When object is detached ('''id''' == {{LSL_Constant/NULL_KEY}})
#* Dropped to the ground
#* Derezzed to inventory
#* When the avatar wearing the object logs out

===Not Triggered===
# When the avatar wearing the object teleports
#* Use [[CHANGED_TELEPORT]] to detect when the avatar teleports
# When the avatar wearing the object moves from one region to another
#* Use [[CHANGED_REGION]] to detect when the avatar changes region
|caveats
|examples=
The following is a simplified example of the attach event. The variable id will be the key of the avatar the scripted object is attached to otherwise it will take on the value of {{LSL_Constant/NULL_KEY}}. The conditional [[if]] statement is used to determine the value of the variable id.
<lsl>default
{
attach(key id)
{
if(id)//tests if it is a valid key and not NULL_KEY
{
llSay(PUBLIC_CHANNEL,"I have been attached!");
}
else
{
llSay(PUBLIC_CHANNEL,"I have been detached!");
}
}
}</lsl>
|helpers
|also_header
|also_events=
{{LSL DefineRow|[[on_rez]]}}
|also_functions=
{{LSL DefineRow|[[llAttachToAvatar]]}}
{{LSL DefineRow|[[llDetachFromAvatar]]}}
{{LSL DefineRow|[[llGetAttached]]}}
|also_articles=
{{LSL DefineRow|{{LSLGC|Attachment}}}}
|also_footer
|notes=
===[[on_rez]] & [[attach]]===
[[on_rez]] will be triggered prior to [[attach]] when attaching from inventory or during login.

when using [[llResetScript]]() in event [[on_rez]] attach event is not triggerd annymore
===Derez Timing===
Durring derez, an object is only given so much time to execute it's attach events. If these events are active when the script derezzes but have not completed, execution will finish when the object is next rezzed (this may not be desirable). It is advisable to keep your detach code simple.
Also [[attach]] will '''not''' be triggered if the script was looping when last rezzed. (same with [[on_rez]])
|mode
|deprecated
|cat1=Attachment
|cat2
|cat3
|cat4}}

Template:Snowglobe-installers-trunk

2009-07-22T12:34:32Z

Alexandrea Fride: revert to 2547 as 2548 is broken wrong build see SNOW-131

<noinclude>Very brief (but frequenly updated) blurb included on at least a couple of pages. Template for including in the [[Open Source Portal]] (actually [[Template:Open Source Portal/Featured]]) to make it so that there's download links for Windows, Mac, and Linux given a build number.

See [[Version numbering]] for explanation of numbering.

This template is for builds off of /projects/2009/snowglobe/trunk. Use [[Template:Snowglobe-installers|<nowiki>{{Snowglobe-installers}}</nowiki>]] when you want to insert a set of links for a released version of Snowglobe.

</noinclude>{{#vardefine:w|1}}{{#vardefine:x|1}}{{#vardefine:y|0}}{{#vardefine:z|2547}}{{Snowglobe-installers-trunk/{{{1|en}}}}} [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}-{{#var:x}}-{{#var:y}}-{{#var:z}}_Setup.exe Windows] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}_{{#var:x}}_{{#var:y}}_{{#var:z}}_SNOWGLOBETESTBUILD.dmg Mac] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe-i686-{{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}.tar.bz2 Linux] ''({{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}, July 21, 2009)''

Release Notes/Second Life Server/1.27

2009-07-10T09:35:39Z

Alexandrea Fride: small fix {{jira>SVC-3120}}: to {{jira|SVC-3120}}:

[[Category:Release Notes]]
{{TOCright}}

== 1.27.0 (2009-07-08) ==

'''Features and changes''':

* LSL HTTP-In
** Allows prims to become mini web-servers. Objects acquire a url, and then process http requests for that url.
** For details, see: http://wiki.secondlife.com/wiki/LSL_http_server
* Texture attribution including upload date, name of Resident uploading, and width and height if available
* Improved login handling for SL blogs, SL wiki and PJIRA
* Remove "Save Object Back to My Inventory" features
* Throttle teleports to stop abusive bot and weapons activity
* Changes to inventory APIs and back end to improve reliability and performance
** Note: these changes will be enabled in stages after the full 1.27 deploy is complete
* Server-side support for baked texture upload capability

'''Fixes''':

* Reverted group chat code back to a more stable version
* Fixed server error spam that caused client crash
* Fixed crash caused by invalid request data
* As an Estate Manager, having the debug option 'view admin options' checked no longer prevents you from being able to manage the estate
* {{jira|SVC-3760}}: Unicode behaviour of llToUpper() and llToLower() is inconsistent between the old LSL VM and Mono (and llToUpper() is broken on both)
* {{jira|SVC-3140}}: Crashed mono scripts consuming much time according to Top Scripts
* "Can't rez object" error displays original name of a renamed object
* {{jira|SVC-4153}}: Objects on group land are returned to creator instead of the owner
* {{jira|SVC-4436}}: Topscripts showing many duplicates
* {{jira|SVC-3146}}: Server is not sending enough data for texture discard levels
* Other misc improvements to server texture downloads
* {{JIRA|SVC-369}}: 'Sell objects with the Land' option only transfers ownership of the root prims.
* {{JIRA|SVC-1390}}: llGetAgentInfo doesn't set AGENT_CROUCHING flag if AGENT_WALKING set
* {{JIRA|SVC-3837}}: Shift copying any copyable object you're NOT the creator of resets creation date.
* {{JIRA|VWR-6226}}: Moving the root prim, then undoing the move to that single prim, will return the prim to its previous location but also move the entire linked set the same distance X, Y or Z
* {{JIRA|VWR-9943}}: Camera rotation is jaggy (not smooth anymore)
* Avatar disappears in others' viewers due to animation bug while holding down Page Down (or C) and pressing forward
* Script errors and warning are still appearing in local chat even
* Animation Request errors spam user causing client crash
* Reduced the amount of time it takes the back end system to calculate parcel dwell
* Many back end scalability fixes
* Abandoned land description updated with message indicating the previous owner
* Refined simulator frame profiling logging
* Fix to sim crash in LLInterestList fixed
* Several internal fixes
* '''Maintenance fixes to script engine: '''
** {{jira|SVC-3120}}: Collision Events Do Not Trigger (Blocked) with Avatar sitting on physical prim
** Fix to sim crashing script
** {{jira|SVC-3328}}: mono script : bad calculated 100*0.9 ==> 89 !
** {{jira|SVC-3400}}: Conditional key testing performs differently under Mono
** Fix to NullReference exception caused by stop starting scripts near reset and state change

Template:Snowglobe-installers-trunk

2009-07-03T17:51:25Z

Alexandrea Fride: updating build 2486

<noinclude>Very brief (but frequenly updated) blurb included on at least a couple of pages. Template for including in the [[Open Source Portal]] (actually [[Template:Open Source Portal/Featured]]) to make it so that there's download links for Windows, Mac, and Linux given a build number.

See [[Version numbering]] for explanation of numbering.

This template is for builds off of /projects/2009/snowglobe/trunk. Use [[Template:Snowglobe-installers|<nowiki>{{Snowglobe-installers}}</nowiki>]] when you want to insert a set of links for a released version of Snowglobe.

</noinclude>{{#vardefine:w|1}}{{#vardefine:x|1}}{{#vardefine:y|0}}{{#vardefine:z|2486}}Recent version straight from trunk '''(USE AT YOUR OWN RISK!)''': [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}-{{#var:x}}-{{#var:y}}-{{#var:z}}_Setup.exe Windows] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe_{{#var:w}}_{{#var:x}}_{{#var:y}}_{{#var:z}}_SNOWGLOBETESTBUILD.dmg Mac] [http://secondlife.com/developers/opensource/downloads/2009/trunk/{{#var:z}}/Snowglobe-i686-{{#var:w}}.{{#var:x}}.{{#var:y}}.{{#var:z}}.tar.bz2 Linux] ''(Build {{#var:z}}, July 3, 2009)''

Snowglobe

2009-06-30T23:43:03Z

Alexandrea Fride: update svn adress

[[Image:Snowglobe with snow dropshadow.svg|right|128px|]]
'''Snowglobe''' is the name of a new viewer (in development) for Second Life. Older documentation will refer to it as the "SLDev Viewer" (and some will refer to "HTTP Texture", the first project we're working on). Watch this space for more information/links/etc.

For more info about the Snowglobe viewer, see [https://blogs.secondlife.com/community/technology/blog/2009/03/30/intensifying-open-source-efforts Philip's blog post: "Intensifying Open Source Effort"] which describes our new approach to open source. See [https://lists.secondlife.com/pipermail/sldev/2009-May/013879.html Philip's mail to sldev] for a little bit more about the name.

* '''Browse source''': [http://svn.secondlife.com/trac/linden/browser/projects/2009/snowglobe snowglobe branch in Trac] - browse the source code we're working on
* '''Downloads'''
** {{snowglobe-installers}}
** {{snowglobe-installers-trunk}}
** Very latest installer downloads: look for most recent build on the [https://lists.secondlife.com/cgi-bin/mailman/listinfo/sldev-commits sldev-commits mailing list].
** Look at the page [[Version control repository]] for information about how to checkout the source code with SVN.
* The page [[Get source and compile]] gives general information about how to compile the source.
* '''[[Snowglobe Current Cycle|Current Release Cycle]]''' - information on features and patches pending for the current release cycle
** [[HTTP Texture]] - Project to transition from custom UDP-based protocol to HTTP for texture delivery
** [[S3 based viewer map]] - Utilizing HTTP Texture for the in-viewer map
* Commit mails and build system notifications: [https://lists.secondlife.com/cgi-bin/mailman/listinfo/sldev-commits sldev-commits mailing list].
* Developers discussion: [https://lists.secondlife.com/cgi-bin/mailman/listinfo/sldev sldev mailing list].
* [[Snowglobe Committer List]] - List of people with direct commit access who are working to build this viewer
* [[Snowglobe Development Process]] - Development practices for everyone working on the Snowglobe viewer
* [[Snowglobe Test Plans]]

==News==

* 2009-06-24 - '''[http://blogs.secondlife.com/community/technology/blog/2009/06/24/snowglobe-10-now-available Snowglobe 1.0 now available]''' - Rob Linden's announcement post.

[[Category:Open Source Portal]]
[[Category:Snowglobe|*]]

User:Alexandrea Fride

2009-06-04T18:27:02Z

Alexandrea Fride: New page: in SecondLife since 8/13/2007(second char, main was from 7/1/2007 but dident liked name :p), facinated by almost evry coding language there is, know coding languages PHP/c++/LSL

in SecondLife since 8/13/2007(second char, main was from 7/1/2007 but dident liked name :p),
facinated by almost evry coding language there is,
know coding languages PHP/c++/LSL

Build the Viewer on Linux

2008-11-11T21:23:18Z

Alexandrea Fride: libstdc++6-dev is libstdc++6 instead, also "(not sure, please check)" removed as it is correct for ubuntu install

{{multi-lang}}
{{Warning|The viewer source is under a big transition. The ways to get and compile the viewer source is different in 1.19, 1.20, and 1.21 series. Some information about compiling are based on viewer source 1.19 series and before, while some others are based on 1.20 series or even on the coming 1.21 series. The pages will be consistent when 1.21 series are out and stable. Thank you for your patience.}}
{{OSWikiContribBox}}

{{CompileNav}}

The following are instructions for building the Second Life viewer on linux. This process has been used on [http://www.debian.org/ debian] and debian based systems like [http://www.ubuntu.com/ ubuntu], and also on [http://www.fedoraproject.org/ Fedora]. For other platforms, see [[Get source and compile]].

= Building the client =
To build the Second Life Viewer you will first need to install the required tools and libraries.
The following sections outline steps to build the client from source. To simplify building,
Linden Lab has been nice enough to prepackage some of the libraries and bundled them up in an
additional tar file.

And while The Second Life Viewer is not a trivial build, and experience with building large
software packages will help you greatly - but don't be daunted, it should be simple once the
dependencies are in the right place.

The tasks are:
# Install required tools.
# Unpack source and art trees from Linden Lab.
# Install libraries not shipped by Linden Lab.
# Unpack or install the other required libraries and headers.
# Compile.
<br />
<br />
== Required tools ==
There are a number of tools that need to be installed first.

* <b>python 2.5</b> [package: python]
* <b>SCons</b> build tool [package: scons]
* <b>GCC 3.4</b> C/C++ compiler [debian/ubuntu: g++-3.4] [fedora: compat-gcc-34-c++]
** Other GCC versions are not well-tested; GCC 4.x will NOT currently build the viewer. (Although some say a few simple code adjustments does the job.)
** 2008-05-29 (Ochi Wolfe): Compilation of 1.20.7 r88152 with gcc/g++ version 4.2.4 runs just fine on my Gentoo system without tweaks to the code but the following tweaks to the SConstruct file:
*** Replace "g++-3.4" with "g++" at line 352 to use your standard g++ (4.2.4 in my case)
*** If compilation fails with errors from ld complaining about missing "-lboost_signals-gcc34-mt" or similar: Try using your system's '''boost library''' (make sure it's installed) by searching for "boost_" in the SConstruct and removing all occurences of "gcc34-" or "gcc33-" in those strings. For example: 'boost_signals-gcc34-mt' becomes 'boost_signals-mt'.
*** '''libboost-program-options-dev''' is needed on Ubuntu 8.04 to use cmake
** On Fedora, you may need to edit line 342 of indra/SConstruct (Branch_1-18-2-Viewer) as
**: change gcc_bin = 'g++-3.4' to gcc_bin = 'g++34'
* <b>yacc</b> or compatible tool [suggest packages: bison]
* <b>lex</b> or compatible tool [suggest packages: flex]

The build process may use the following optional tool:

* <b>distcc</b> distributed compiler (useful if you have multiple PCs.)

== Unpack the source tree ==

You can get the source either from the source archives available at [[Source downloads]], or you can get it from [[Subversion]].

Using a source archive is the easier option, but if you plan to do active development and want to make your own modifications, while merging LL's changes, subversion will probably be much more convenient on the long term.

=== Getting the source from the source archives ===
Get the source from [[Source downloads]]. You will need all 3 archives: source, artwork and libraries.

Choose a location and unpack the source tree and the art work. They will be extracted into a
directory call <b>linden</b>.

<code>
% tar -xzf slviewer-src-<version>.tar.gz
% tar -xzf slviewer-<os>-libs-<version>.tar.gz
% unzip slviewer-artwork-<version>.zip
</code>
<br />

=== Getting the source from Subversion ===
Select a source [[Source branches|branch]] to check out.

Check it out with:
<code>
% svn co http://svn.secondlife.com/svn/linden/<branch> [directory]
</code>
If you don't specify the directory, it'll use the name of the branch as the default.

Now you will have a directory with the source code. This only includes the source code itself, without the libraries or artwork. You will have to get them from the [[Source downloads]] and unpack them into the tree.

If the directory SVN created is called 'linden' then you can directly unzip and untar the archives on top of it. If it's called something else, create a symlink:
<code>
% ln -sf <branch> linden
</code>

Now unpack the libraries and artwork:
<code>
% tar -xzf slviewer-<os>-libs-<version>.tar.gz
% unzip slviewer-artwork-<version>.zip
</code>

<br />

== Installing the required libraries (that Linden Lab can not or does not provide)==

=== Libraries and header files that usually come with a Linux distribution ===
Make sure the libraries and header files for the following packages are installed on your system:
; GL : [ubuntu: mesa-common-dev, fedora: mesa-libGL-devel]
; GLU : [ubuntu: libglu1-mesa-dev, fedora: mesa-libGLU-devel]
; glibc : [ubuntu: libc6-dev, fedora: glibc-devel]
; stdc++ library : [ubuntu: libstdc++6, fedora: libstdc++-devel]
; X11 : [ubuntu: libx11-dev, fedora: libX11-devel]
; zlib : [ubuntu: zlib1g-dev, fedora: zlib-devel]
; openssl : [ubuntu: libssl-dev, redhat: openssl-devel]

=== FMOD (audio) ===
* FMOD provides audio output, but (although 'free' in some senses) is not itself open-source. <b>If</b> you wish to avoid FMOD, thus disabling audio, you may make these changes:
** Comment-out the libfmod line in indra/newview/viewer_manifest.py
** Add FMOD=no to your Scons build command when compiling the source.
* If you want to use FMOD, fetch and unpack <b>FMOD 3.75</b> <http://www.fmod.org/>

wget http://www.fmod.org/index.php/release/version/fmodapi375linux.tar.gz
tar -xzvf fmodapi375linux.tar.gz
cd fmodapi375linux/
cp api/inc/* ../linden/libraries/i686-linux/include/
cp api/libfmod-3.75.so ../linden/libraries/i686-linux/lib_release_client/

<br />
<br />

== Installing the required dependencies (prepackaged by Linden Lab)==

The Second Life Viewer has a number of compile/link dependencies on external libraries which
are needed - to help you, the source download page contains a link to a <i>slviewer-linux-libs</i> package which you unpack over the source tree to fill most of the dependencies (and thus avoid most of the fiddly work described on this page).

If you download the libs to the top folder, where the <i>linden</i> folder is after getting and extracting the viewer source code tarball, the following command should unpack everything to the right spot.
<code>
tar xvfz slviewer-linux-libs-<version>.tar.gz
</code>

If you choose to use the provided libraries you can skip to
[[Compiling_the_viewer_%28Linux%29#Compiling|Compiling the client]].
<br />
=== Doing yourself ===
If you are porting to a new architecture or wish to make a package tailored to your Linux distribution's own libraries. You will have to install the following additional dependencies
listed below. Paths and package names given here are based on Ubuntu 7.04 and may vary
according to your Linux distribution.

==== List of libraries ====
* <b>apr-1</b> [ubuntu: libapr1-dev, fedora: apr-devel]

* <b>aprutil-1</b> [ubuntu: libaprutil1-dev, fedora: apr-util-devel]

* <b>boost</b> [ubuntu: libboost-dev, fedora: boost-devel]

* <b>boost-regex</b> [ubuntu: libboost-regex-dev]

* <b>curl</b> library at least version 7.15.4 is recommended, 7.16.x is ideal.
** [ubuntu: libcurl3-dev, fedora: libcurl-devel]
** If you are compiling your own version of <b>Curl</b>, then you should consider configuring it to use the <b>c-ares</b> library so that DNS lookups will be asynchronous.

* <b>c-ares</b> library (mandatory for v1.18.4.0, and missing from the pre-compiled libraries package):
**<http://daniel.haxx.se/projects/c-ares/>
**[fedora: c-ares-devel]
**[ubuntu (gutsy): download Hardy packages and install:
***<http://packages.ubuntu.com/hardy/libs/libc-ares1>
***<http://packages.ubuntu.com/hardy/libdevel/libc-ares-dev>
<code>
% sudo dpkg -i libc-ares1 && dpkg -i libc-ares-dev
</code>
* <b>ELFIO</b> <http://sourceforge.net/projects/elfio/>
** This wants to build a static library by default. Afterwards, to create a dynamic libelfio.so
<code>
% cd ELFIO && g++-3.4 -shared *.o -o libELFIO.so
</code>

* <b>expat</b> [ubuntu: libexpat1-dev, ubuntu (gutsy): libcurl4-openssl-dev, fedora: expat-devel]

* <b>google-perftools</b> library for the tcmalloc and stacktrace libraries. (memory checking)
**[ubuntu: libgoogle-perftools-dev, fedora: google-perftools-devel.i386

* <b>GTK 2.x</b> development headers [ubuntu: libgtk2.0-dev, fedora: gtk2-devel]

* <b>jpeglib</b> [ubuntu: libjpeg62-dev, fedora: libjpeg-devel]

* <b>OpenJPEG</b> <http://www.openjpeg.org/>
** note: OpenJPEG 1.1.1 or greater is required which has the macro OPJ_PATH_LEN, if the header has MAX_PATH, then upgrade or it will crash with a divide by zero error as the structures would be two different sizes.
*** ''what does this mean?''

* <b>OpenSSL</b> <http://www.openssl.org/> [ubuntu: libssl-dev, fedora: openssl-devel]

* <b>SDL</b> [ubuntu libsdl1.2-dev, fedora: SDL-devel]

* <b>Vorbis</b> [ubuntu: libvorbis-dev, fedora: libvorbis-devel]

* <b>xmlrpc-epi 0.51</b> <http://xmlrpc-epi.sourceforge.net/>
** note: not xmlrpc-c (xmlrpc-c has a library and headers with the same name but is not compatible)
** Apply patches from the instructions in [[patch xmlrpc-epi]]
*** ''does this still work?''
**** The patches applied OK for me, but didn't result in a usable library. The patches below appear to work better, except that xmlrpc-epi-0.51-rename.patch didn't apply cleanly (but the manual changes were easy). I'll update once I get the other dependencies worked out. [[User:Jackson Sadovnycha|Jackson Sadovnycha]] 21:39, 30 August 2007 (PDT)
** See also:
*** http://www.haxxed.com/rpms/secondlife/xmlrpc-epi-0.51-gcc4.1.patch
*** http://www.haxxed.com/rpms/secondlife/xmlrpc-epi-0.51-use-system-expat.patch
*** http://www.haxxed.com/rpms/secondlife/xmlrpc-epi-0.51-rename.patch
*** You have to regenerate autotools after applying the patches:
****libtoolize -c -f
****aclocal
****automake -c -a --foreign
****autoconf
*** The first patch fixes compiling on gcc 4. The second patch causes it to compile against the system expat, the version xmlrpc-epi comes with is broken and will not work. The last patch renames the library from xmlrpc to xmlrpc-epi, otherwise it conflicts with xmlrpc-c - which means the viewer then needs to be patched to link against xmlrpc-epi and not xmlrpc. These patches are from my Fedora package. On linux, I recommend these patches in favor of the Linden ones, as theirs seem to be for windows. (And mine actually work)
<br />
<br />

==== Copy headers and libraries into the source tree ====

Here is a guide to the sequence of shell commands needed to copy the required headers and libraries into the Second Life Viewer source tree for building. Actual paths to system headers may vary according to Linux distribution.

If you are using the easy <i>slviewer-linux-libs</i> bundle then you can skip the rest of this section, <b>otherwise</b> you will also need to perform the following:

* ${SLSRC} refers to the top-level directory of the Second Life Viewer source tree.
* ${OPENJPEG} refers to the top-level directory of your completed OpenJPEG build.
* ${ELFIO} refers to the top-level directory of your completed ELFIO build.

<code>
cp -a /usr/include/atk-1.0 ${SLSRC}/libraries/i686-linux/include/
cp -a /usr/include/gtk-2.0 ${SLSRC}/libraries/i686-linux/include/
cp -a /usr/lib/gtk-2.0/include/* ${SLSRC}/libraries/i686-linux/include/gtk-2.0/
cp -a /usr/include/glib-2.0 ${SLSRC}/libraries/i686-linux/include/
cp -a /usr/lib/glib-2.0/include/* ${SLSRC}/libraries/i686-linux/include/glib-2.0/
cp -a /usr/include/pango-1.0 ${SLSRC}/libraries/i686-linux/include/

if your GTK is fairly recent and thus needs Cairo:
cp -a /usr/include/cairo/* ${SLSRC}/libraries/i686-linux/include

cp -a /usr/include/apr-1.0/ ${SLSRC}/libraries/i686-linux/include/apr-1

mkdir ${SLSRC}/libraries/i686-linux/include/expat
cp -a /usr/include/expat*.h ${SLSRC}/libraries/i686-linux/include/expat/

mkdir ${SLSRC}/libraries/i686-linux/include/zlib
cp -a /usr/include/zlib*.h ${SLSRC}/libraries/i686-linux/include/zlib/

mkdir ${SLSRC}/libraries/i686-linux/include/openjpeg
cp ${OPENJPEG}/libopenjpeg/openjpeg.h ${SLSRC}/libraries/i686-linux/include/openjpeg/
cp ${OPENJPEG}/libopenjpeg.a ${SLSRC}/libraries/i686-linux/lib_release_client/

mkdir ${SLSRC}/libraries/i686-linux/include/ELFIO
cp ${ELFIO}/ELFIO/*.h ${SLSRC}/libraries/i686-linux/include/ELFIO/
cp ${ELFIO}/ELFIO/libelfio.so ${SLSRC}/libraries/i686-linux/lib_release_client/

mkdir ${SLSRC}/libraries/i686-linux/include/jpeglib
cp -a /usr/include/j*.h ${SLSRC}/libraries/i686-linux/include/jpeglib/
touch ${SLSRC}/libraries/i686-linux/include/jpeglib/jinclude.h

mkdir ${SLSRC}/libraries/i686-linux/include/llfreetype2
cp -a /usr/include/freetype2/freetype/ ${SLSRC}/libraries/i686-linux/include/llfreetype2/
cp -a /usr/include/ft2build.h ${SLSRC}/libraries/i686-linux/include/llfreetype2/freetype/

mkdir ${SLSRC}/libraries/i686-linux/include/xmlrpc-epi
cp -a /usr/include/xmlrpc*.h ${SLSRC}/libraries/i686-linux/include/xmlrpc-epi/

# For SL v1.18.4.0:
mkdir ${SLSRC}/libraries/i686-linux/include/ares
cp -a /usr/include/ares* ${SLSRC}/libraries/i686-linux/include/ares/
cp -a /usr/lib/libcares.* ${SLSRC}/libraries/i686-linux/lib_release_client/
</code>
<br />
<br />

== Compiling ==
=== Build Types ===
The ''BUILD'' parameter specifies the build type. For normal usage, use '''release'''. If you plan to work on the source, choose '''releasenoopt''' or '''debug''', as these versions are unoptimized and much easier to debug.

You can also edit the scons file to cause releasefordownload to skip the "stripping" step, for a version that is relatively easy to debug, yet still performs well.

* '''release''': Optimized build for release.
* '''releasenoopt''': Unoptimized build.
* '''debug''': Debug build with assertions.
* '''releasefordownload''': Optimized build for release, will create a .tar.gz with the files for distribution.
<br />
=== Building ===
=== Enabling llMozLib ===
Add MOZLIB=yes to your Scons build command when compiling the source. Failure to do this will cause errors on some versions, due to badly structured ifdefs in the code. If you really don't want mozlib you must apply the patches attached to VWR-3748.
<br />
<code>
$ cd indra
$ scons DISTCC=no BTARGET=client BUILD=release MOZLIB=yes
</code>
Expect a build time of a couple of hours. The resulting unstripped Second Life Viewer binary is <b>newview/secondlife-i686-bin</b>. Note that temporary object code is compiled into <b>/tmp/$USER</b> by default (where $USER is your username) - this can be changed by prefixing the <b>scons</b> command above with <b>TEMP_BUILD_DIR="<i>[full directory path]</i>"</b>. For example:

<code>
$ TEMP_BUILD_DIR="/home/fred/secondlife/temp-build" scons DISTCC=no BTARGET=client BUILD=release
</code>

To build a release that has all of the shaders and optimizations enabled and resembles the official shipped Linux client, use BUILD=releasefordownload

Be sure to read the [[Common compilation problems]] page if you have problems - we'll try to keep the page up to date with known problems and solutions.
<br />
<br />

== Testing and packaging the client ==

=== Testing the result from inside the tree ===

You may find it simpler and less error-prone to follow the instructions in the [[Compiling_the_viewer_%28Linux%29#Packaging_the_client|Packaging the client]] section below to run the client under the same conditions as an end-user would.

* 2008-05-29 (Ochi Wolfe): Compiling the 1.20.7 r88152 viewer, it seems like even when compiling as "release" the viewer is built ready-to-go inside the newview/packaged/ directory including the message_template.msg and message.xml in the right place. Try to cd to the newview/packaged/ directory and run SL from there with the ./secondlife command as you would normally do.

Otherwise:

* Preparing to run 'in-tree'
** <i>ensure that you have indra/newview/app_settings/static_*.db2</i> - if not, you'll find it in the 'slviewer-artwork' download (a zip file).
** now, from the indra directory:
<code>
$ cp ../scripts/messages/message_template.msg newview/app_settings/
$ cp ../etc/message.xml newview/app_settings/
</code>

'''Important:''' Starting from version 1.18.0, copying message.xml is also required. Missing it will cause group IMs to fail to work, although the viewer will run fine otherwise.

* Running it: The LD_LIBRARY_PATH stuff ensures that the binary looks for its libraries in the right places. From the indra directory:
<code>
$ ( cd newview && LD_LIBRARY_PATH="`pwd`"/../../libraries/i686-linux/lib_release_client:"`pwd`"/app_settings/mozilla-runtime-linux-i686:${LD_LIBRARY_PATH}:/usr/local/lib ./secondlife-i686-bin )
</code>

<br />
==== The client seems kinda slow. ====

By default, the open-source Second Life Viewer uses the open-source OpenJPEG library to decode the (many) JPEG-2000 texture images it receives from the servers. This isn't quite of comparable speed to the proprietary third-party library which the Linden Lab viewer builds have traditionally used, for which we are not permitted to redistribute the source.

However, the <i>slviewer-linux-libs</i> package includes two pre-built libraries which facilitate the use of this slightly faster image decoding method: <b>libkdu_v42R.so</b> and <b>libllkdu.so</b>. These are provided for your testing; again, we are not permitted to grant you the right to re-distribute these libraries to downstream users, but the viewer will still work (albeit slightly slower) without them.

To <b>use these faster image-decoding libraries</b>, they simply need to be put into the right places relative to the viewer runtime directory - nothing needs to be reconfigured or recompiled. If you're running the client from the source tree, the following will make the KDU libraries available:
<code>
cp "$SLSRC/libraries/i686-linux/lib_release_client/libllkdu.so" "$SLSRC/indra/newview/libllkdu.so"
mkdir "$SLSRC/indra/lib"
cp "$SLSRC/libraries/i686-linux/lib_release_client/libkdu_v42R.so" "$SLSRC/indra/lib/libkdu_v42R.so"
</code>

The file <b>indra/newview/viewer_manifest.py</b> contains some commented-out entries describing where these libraries belong; if you uncomment the two lines corresponding to libllkdu and libkdu then they will be automatically copied into the right place in the runtime directory when you follow the 'Packaging the client' instructions below.

==== File Dialogs Don't Work on 64 bit system ====

If you run a 64 bit system, and your file dialogs don't work, or they worked before and stopped after you installed an update, it may be due to a mismatch between the headers used to compile the viewer and the library it's using. The log will contain something like this:
<code>
2007-06-21T01:28:35Z INFO: ll_try_gtk_init: Starting GTK Initialization.
2007-06-21T01:28:36Z INFO: ll_try_gtk_init: GTK Initialized.
2007-06-21T01:28:36Z INFO: ll_try_gtk_init: - Compiled against GTK version 2.10.11
2007-06-21T01:28:36Z INFO: ll_try_gtk_init: - Running against GTK version 2.10.6
2007-06-21T01:28:36Z WARNING: ll_try_gtk_init: - GTK COMPATIBILITY WARNING: Gtk+ version too old (micro mismatch)
</code>

What happens here is that your distribution includes 32 bit GTK libraries, but the package only includes the libraries themselves and not the headers. When building, the SL client will build against the headers included with the main 64 bit GTK package. This will work if the 64 bit version of the library is the same or older than the 32 bit one. However, if your 32 bit library is older, then the viewer will detect the mismatch (built with headers for a newer version of GTK than it's using) and turn GTK off.

Possible solutions:
* Download the source for the version of the 32 bit GTK libraries your distribution comes with, and build your viewer against those headers.
* Upgrade your 32 bit GTK package so that it's the same or newer as the 64 bit one.
* Downgrade your 64 bit package (may not be a good idea).

=== Packaging the client ===

If you substitute 'BUILD=release' with '<b>BUILD=releasefordownload</b>' in the 'Compiling' section above, then packaging the resulting code, libraries, data and documentation into a tarball for the end-user will be done automatically as the final stage of the build process; the pristine end-user client distribution has been assembled into the directory <b>indra/newview/SecondLife_i686_1_X_Y_Z/</b> and has also been tarred into <b>indra/newview/SecondLife_i686_1_X_Y_Z.tar.bz2</b>

The file which controls what (and where) files go into the end-user runtime viewer directory is <b>indra/newview/viewer_manifest.py</b>

==== Automated libraries and headers adjustments, compilation and packaging ====

<br>
Here are two bash scripts (one for v1.20 and earlier viewers, and one for v1.21 and later) that could save you a lot of time... They basically do all what is described above, and more, and entitle you to compile a SL client very easily:

<b>IMPORTANT NOTE:</b>

These script includes instructions which have the potential to remove MANY files on your system should you modify them without understanding exactly what it does (i.e. rm -rf $VARIABLE/ where entire portions of your filesystem *will* be deleted without warning). This is not a theoretical problem, this script has caused damage to unwary users already.

Although some basic checks are done to avoid removing an entire home directory, or even the root tree, this script is not meant to be tweaked without a very good knowledge of bash scripting. It is therefore highly recommended that you use it without modifying the PATH_TO_SOURCES and TEMP_BUILD_DIR variables (modifying the USE_* and TUNE_FLAGS variables is safe).

<code>
<pre>
<nowiki>
#!/bin/bash

# make-SL v1.84 (c)2007-2008 Henri Beauchamp. Released under GPL license v2:
# http://www.gnu.org/licenses/gpl.txt

###############################################################################
######## THIS IS QUICK'N DIRTY ALPHA SOFTWARE. USE AT YOUR OWN RISKS ! ########
###############################################################################

###############################################################################
# BEWARE: this script is meant to compile a -personal- SL client. It is -NOT- #
# suitable to build client versions meant for public release, because #
# non-open source code is packaged by this script (e.g. libkdu). #
###############################################################################

# This bash script is aimed at easying up the build process of a SL client.
# It does not cover building it with custom/system openjpeg, elfio or fmodapi
# (we use the provided libraries).
# You may enable or disable the use of your system's library by editing
# the USE_SYSTEM_* variable ("yes" --> use the system library, "no" --> use
# LL's provided ones).
# The script also takes care of updating properly the viewer_manifest.py script
# accordingly, so that you (should) end up with a properly packaged client.

# To use this script, simply make it executable (chmod +x make-SL) and
# put it into /usr/local/bin (or any other directory in your PATH).
# Then, download the slviewer-src-*.tar.gz, slviewer-linux-libs-*.tar.gz,
# slviewer-artwork-*.zip and fmodapi*.tar.gz archives, and finally, invoke
# make-SL as follow:
# make-SL path_to_archives (example: make-SL ~/downloads)
# or simply:
# make-SL
# when invoking from the directory where the archives are.
# The sources will be installed into the PATH_TO_SOURCES directory,
# and the client will be built into the TEMP_BUILD_DIR directory.
# The packaged build will be moved to your home directory.
# If you want to retry a compilation after fixing something manually and
# don't want make-SL to start all over again, overwriting everything,
# you may invoke it with the --retry option, like this:
# make-SL --retry
# This script has been tested by the author, on a (very customized)
# Mandrake 10.2 distro, and a (no less customized but yet more standard)
# Mandriva 2007.1 distro.
# Tested with SL v1.17, v1.18, v1.19 & v1.20 sources.

# Where the sources of the client will be held (defaults to "./linden"):
PATH_TO_SOURCES="/usr/src/SL"
# Where to build the client:
export TEMP_BUILD_DIR="$PATH_TO_SOURCES/build"

USE_SYSTEM_GTK="no"
USE_SYSTEM_SDL="no"
USE_SYSTEM_SSL="no"
# Beware: libdb4 makes use of libapr, and libapr makes use of libexpat... so
# you should keep USE_SYSTEM_APR, USE_SYSTEM_DB4 and USE_SYSTEM_EXPAT in sync.
USE_SYSTEM_APR="no"
USE_SYSTEM_DB4="no"
USE_SYSTEM_EXPAT="no"
USE_SYSTEM_OGG="no"
USE_SYSTEM_ZLIB="no"
USE_SYSTEM_UUID="no"
# If your system libcurl does not use c-ares (non-blocking DNS calls), better
# using LL's provided library...
USE_SYSTEM_CURL="no"
USE_SYSTEM_VORBIS="no"
USE_SYSTEM_XMLRPC="no"
USE_SYSTEM_JPEGLIB="no"
# Enabling the system freetype2 prevents the client from using the SL fonts,
# or at least, this is what happens on my system (Mandrake 10.2 and Mandriva
# 2007.1 with PLF's freetype2).
USE_SYSTEM_FREETYPE2="no"
USE_SYSTEM_PERFTOOLS="no"

# You may add tune flags here, to optimize the code for your processor.
# Example, for an Athlon XP:
# TUNE_FLAGS="-march=athlon-xp"
# BEWARE: because of a bug in the v1.17.2.0 SConstruct file, you MUST keep at
# least an -O2 flag in the TUNE_FLAGS, to avoid getting a very slooooow client...
# This problem was apparently fixed in v1.17.3.0.
TUNE_FLAGS="-fomit-frame-pointer -frename-registers -fweb -fexpensive-optimizations -march=i686 -msse -mfpmath=sse"
# Set this to "yes" to force vectorization use in the viewer code (only for
# processors with SSE or Altivec units, and only if you did enable them via
# the TUNE_FLAGS.
FORCE_VECTORIZE="yes"

# Whether to build with the browser login screen or not:
WITH_MOZILLA="yes"

########### functions definitions ###########

function check() {
if [ "$1" == "yes" ] ; then
if [ -f $2 ] ; then
echo "Using the system $3..."
return 0
else
echo "WARNING: system $3 requested but not available..."
fi
fi
return 1
}

function update_manifest() {
grep -v $1 $PATH_TO_SOURCES/indra/newview/viewer_manifest.py >$TEMP_BUILD_DIR/viewer_manifest.py
mv -f $TEMP_BUILD_DIR/viewer_manifest.py $PATH_TO_SOURCES/indra/newview/viewer_manifest.py
chmod +x $PATH_TO_SOURCES/indra/newview/viewer_manifest.py
}

function compile() {
cd $PATH_TO_SOURCES/indra
echo "Compiling the client into $TEMP_BUILD_DIR..."
scons DISTCC=no BTARGET=client OPENSOURCE=no BUILD=releasefordownload CHANNEL=Release MOZLIB=$WITH_MOZILLA MOZLIB2=$WITH_MOZILLA
if (($? == 0)) ; then
mv $PATH_TO_SOURCES/indra/newview/SecondLife*.tar.bz2 $HOME/
fi
}

########### end of functions ###########

if [ "$TEMP_BUILD_DIR" == "" ] ; then
export TEMP_BUILD_DIR=/tmp/$USER/SL
fi

# Check to see if we simply want to retry a compilation:
if [ "$1" == "--retry" ] ; then
compile
exit $?
fi

# Make sure we don't unpack over an old source tree:
if [ -d linden ] ; then
rm -rf linden/
fi

if [ -d $PATH_TO_SOURCES ] && [ "$PATH_TO_SOURCES" != "" ] && [ "$PATH_TO_SOURCES" != "/" ] && [ "$PATH_TO_SOURCES" != "." ] && [ "$PATH_TO_SOURCES" != ".." ] && [ "$PATH_TO_SOURCES" != "$HOME" ] ; then
rm -rf $PATH_TO_SOURCES/
fi

# Use the parameter (if any) as the path to the archives:

PATH_TO_ARCHIVES="."
if [ "$1" != "" ]; then
if [ -d $1 ] ; then
PATH_TO_ARCHIVES=$1
fi
fi

# Let's first unpack everything:
if ! [ -f $PATH_TO_ARCHIVES/slviewer-src-*.tar.gz ] ; then
echo "You need slviewer-src !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/slviewer-linux-libs-*.tar.gz ] ; then
echo "You need slviewer-linux-libs !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/slviewer-artwork-*.zip ] ; then
echo "You need slviewer-artwork !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/fmodapi*.tar.gz ] ; then
echo "You need fmodapi !"
exit 1
fi
echo "Extracting the files from the archives..."
tar xzf $PATH_TO_ARCHIVES/slviewer-src-*.tar.gz
tar xzf $PATH_TO_ARCHIVES/slviewer-linux-libs-*.tar.gz
unzip -o $PATH_TO_ARCHIVES/slviewer-artwork-*.zip >/dev/null
# You may add artwork patches named in the form:
# slviewer-whatever-artwork-patch.zip
# Example: slviewer-v11900-statusbar-artwork-patch.zip
ARTWORK_PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*-artwork-patch.zip`
if [ "$ARTWORK_PATCHES" != "" ] ; then
for f in $ARTWORK_PATCHES; do
echo "Extracting artwork patch $f..."
unzip -o $f >/dev/null
done
fi

# fmodapi:
echo "Copying fmodapi files..."
tar xzf $PATH_TO_ARCHIVES/fmodapi*.tar.gz
cp -a fmodapi*/api/inc/* linden/libraries/i686-linux/include/
cp fmodapi*/api/libfmod-*.so linden/libraries/i686-linux/lib_release_client/
rm -rf fmodapi*/

# Move the sources to where we want to hold them:
if [ "$PATH_TO_SOURCES" != "linden" ] && [ "$PATH_TO_SOURCES" != "" ] ; then
echo "Moving the sources to $PATH_TO_SOURCES..."
mv -f linden $PATH_TO_SOURCES
fi

# Let's own the files:
chown -R $USER: $PATH_TO_SOURCES/

# Check for patches to apply. The names of the patches must be in the form
# slviewer-*.patch* (Example: slviewer-v117-EmbbededNotecard.patch.bz2).
# They must be applicable from inside the source directory with the -p1
# option, i.e. they have been built from outside the source directory
# with a diff command such as:
# diff -urN linden/ linden-patched/ >slviewer-whatever.patch
# And they may be gzipped or bzipped.
PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*.patch* 2>/dev/null`
if [ "$PATCHES" != "" ] ; then
echo "Applying patches..."
cd $PATH_TO_SOURCES
PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*.patch*`
for i in $PATCHES; do
echo "Patch: $i"
if echo $i | grep ".gz" &>/dev/null ; then
gunzip -c $i | patch -p1 -s
elif echo $i | grep ".bz2" &>/dev/null ; then
bzcat $i | patch -p1 -s
else
patch -p1 -s <$i
fi
done
fi

# Make a clean build:
if [ -d $TEMP_BUILD_DIR ] && [ "$TEMP_BUILD_DIR" != "" ] && [ "$TEMP_BUILD_DIR" != "/" ] && [ "$TEMP_BUILD_DIR" != "." ] && [ "$TEMP_BUILD_DIR" != ".." ] && [ "$TEMP_BUILD_DIR" != "$HOME" ] ; then
rm -rf $TEMP_BUILD_DIR/
fi
mkdir -p $TEMP_BUILD_DIR

# In v1.18.4.0, they use c-ares but fail to provide it in the library package...
if [ -f $PATH_TO_SOURCES/indra/llcommon/llares.cpp ] ; then
if ! [ -f $PATH_TO_SOURCES/libraries/i686-linux/include/ares/ares_dns.h ] && ! [ -f $PATH_TO_SOURCES/libraries/include/ares/ares_dns.h ] ; then
if [ -f /usr/include/ares_dns.h ] && [ -f /usr/lib/libcares.a ] ; then
echo "Copying missing c-ares files from the system..."
cd $PATH_TO_SOURCES/libraries/i686-linux
mkdir include/ares
cp -a /usr/include/ares* include/ares/
cp -a /usr/lib/libcares* lib_release_client/
else
echo "Sorry... You need c-ares installed in your system to compile this version of the client."
echo "Try: http://daniel.haxx.se/projects/c-ares/"
exit 1
fi
fi
fi

# Let's use the system GTK+ if available:
if check $USE_SYSTEM_GTK /usr/include/atk-1.0/atk/atk.h "GTK+" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client
rm -f libgtk* libgdk* libglib* libgmodule* libgobject* libgthread* libpango* libatk*
cd ../include
rm -rf atk-1.0/ gtk-2.0/ glib-2.0/ pango-1.0/
cp -a /usr/include/atk-1.0 .
cp -a /usr/include/gtk-2.0 .
cp -a /usr/lib/gtk-2.0/include/* gtk-2.0/
cp -a /usr/include/glib-2.0 .
cp -a /usr/lib/glib-2.0/include/* glib-2.0/
cp -a /usr/include/pango-1.0 .
if [ -d /usr/include/cairo ] ; then
cp -a /usr/include/cairo/* .
fi
fi

# Let's use the system freetype2 if available:
if check $USE_SYSTEM_FREETYPE2 /usr/include/ft2build.h "freetype2" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/freetype/ i686-linux/include/llfreetype2/*
rm -f include/ft2build.h i686-linux/lib_release_client/libfreetype.a
cp -a /usr/include/freetype2/freetype/ i686-linux/include/llfreetype2/
cp -a /usr/include/ft2build.h i686-linux/include/llfreetype2/freetype/
fi

# Let's use the system zlib if available:
if check $USE_SYSTEM_ZLIB /usr/include/zlib.h "zlib" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/zlib/
mkdir -p i686-linux/include/zlib
cp -a /usr/include/zlib*.h i686-linux/include/zlib/
fi

# Let's use the system jpeglib if available:
if check $USE_SYSTEM_JPEGLIB /usr/include/jpeglib.h "jpeglib" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/jpeglib/ i686-linux/lib_release_client/libjpeg.a
mkdir -p i686-linux/include/jpeglib
cp -a /usr/include/j*.h i686-linux/include/jpeglib/
touch i686-linux/include/jpeglib/jinclude.h
fi

# Let's use the system xmlrpc-epi if available:
if check $USE_SYSTEM_XMLRPC /usr/include/xmlrpc.h "xmlrpc-epi" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/xmlrpc-epi/ i686-linux/lib_release_client/libxmlrpc.a
mkdir -p i686-linux/include/xmlrpc-epi
cp -a /usr/include/xmlrpc*.h i686-linux/include/xmlrpc-epi/
fi

# Let's use the system ogg if available:
if check $USE_SYSTEM_OGG /usr/include/ogg/ogg.h "ogg" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/ogg/ i686-linux/lib_release_client/libogg*
update_manifest libogg
fi

# Let's use the system vorbis if available:
if check $USE_SYSTEM_VORBIS /usr/include/vorbis/vorbisenc.h "vorbis" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/vorbis/ i686-linux/lib_release_client/libvorbis*
update_manifest libvorbis
fi

# Let's use the system SDL if available:
if check $USE_SYSTEM_SDL /usr/include/SDL/SDL.h "SDL" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -rf include/SDL/ lib_release_client/libSDL*
update_manifest libSDL
fi

# Let's use the system openssl if available:
if check $USE_SYSTEM_SSL /usr/include/openssl/opensslconf.h "openssl" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client
rm -f libssl.* libcrypto.*
update_manifest libssl
update_manifest libcrypto
fi

# Let's use the system apr if available:
if check $USE_SYSTEM_APR /usr/include/apr*/apr_base64.h "apr" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -rf include/apr-1/*
rm -f lib_release_client/libapr*
cp -a /usr/include/apr*/* include/apr-1/
update_manifest libapr
fi

# Let's use the system db4 if available:
if check $USE_SYSTEM_DB4 /usr/include/db4/db.h "db4" ; then
rm -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libdb*.so
update_manifest libdb
fi

# Let's use the system expat if available:
if check $USE_SYSTEM_EXPAT /usr/include/expat.h "expat" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/expat/
rm -f i686-linux/lib_release_client/libexpat*
mkdir -p i686-linux/include/expat
cp -a /usr/include/expat*.h i686-linux/include/expat/
update_manifest libexpat
fi

# Let's use the system curl if available:
if check $USE_SYSTEM_CURL /usr/include/curl/curl.h "curl" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/curl/
rm -f i686-linux/lib_release_client/libcurl.*
update_manifest libcurl
fi

# Let's use the system uuid if available:
if check $USE_SYSTEM_UUID /lib/libuuid.so.1 "libuuid" ; then
rm -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libuuid.*
update_manifest libuuid
fi

if grep tcmalloc $PATH_TO_SOURCES/indra/SConstruct &>/dev/null ; then
if check $USE_SYSTEM_PERFTOOLS /usr/include/google/malloc_hook.h "google-perftools" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -f lib_release_client/libtcmalloc.* lib_release_client/libstacktrace.*
rm -rf include/google/
cp -a /usr/lib/libstacktrace.* /usr/lib/libtcmalloc.so* lib_release_client/
cp -a /usr/include/google include/
update_manifest tcmalloc
update_manifest stacktrace
else
# Remove the google-perftools stuff if not present in the libraries package
# (problem seen in SL v1.17):
if ! [ -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libtcmalloc.so ] ; then
update_manifest tcmalloc
update_manifest stacktrace
# The following lines remove the
# "external_libs += ['tcmalloc', 'stacktrace']"
# line from SConstruct... and many other lines which renders SConstruct
# unusable to build anything else than the client... this is a quick'n
# dirty patch. :-P
grep -v tcmalloc $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
mv -f $TEMP_BUILD_DIR/SConstruct $PATH_TO_SOURCES/indra/SConstruct
fi
fi
fi

# Fix a bug in v1.17.1 and later SConstruct file, where some libraries are
# compiled as shared instead of static, and are yet not packaged, and where
# fmod can't be enabled for OPENSOURCE:
sed -e "s/create_dynamic_module(module=module, module_libs=module_libs)/create_static_module(module)/" $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
sed -e "s/enable_fmod = not opensource and/enable_fmod =/" $TEMP_BUILD_DIR/SConstruct >$PATH_TO_SOURCES/indra/SConstruct
rm -f $TEMP_BUILD_DIR/SConstruct

# Add tune flags, if any:
if [ "$TUNE_FLAGS" != "" ] ; then
sed -e "s/-pipe/$TUNE_FLAGS -pipe/" $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
mv -f $TEMP_BUILD_DIR/SConstruct $PATH_TO_SOURCES/indra/SConstruct
fi

# Force the vectorization use if we chose so.
if [ "$FORCE_VECTORIZE" == "yes" ] ; then
sed -e "s/cflags += '-m32 '/cflags += '-m32 -DLL_VECTORIZE=1 '/" $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
mv -f $TEMP_BUILD_DIR/SConstruct $PATH_TO_SOURCES/indra/SConstruct
fi

# Use whatever gcc version we got.
sed -e "s/g++-3.4/g++/" $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
sed -e "s/g++-4.1/g++/" $TEMP_BUILD_DIR/SConstruct >$PATH_TO_SOURCES/indra/SConstruct
rm -f $TEMP_BUILD_DIR/SConstruct

# Fix boost library linking problems in v1.20
sed -e "s/-gcc34-mt//g" $PATH_TO_SOURCES/indra/SConstruct >$TEMP_BUILD_DIR/SConstruct
mv -f $TEMP_BUILD_DIR/SConstruct $PATH_TO_SOURCES/indra/SConstruct

# Update the manifest file and enable libkdu packaging. I'm too lazy to use
# awk or perl, here, but that's indeed what should be done...
# The following (very dirty) code may break at some point, depending on what
# LL will put in comments in the manifest file...
# First, remove the lines with libstdc++.so.6 and the crash logger:
update_manifest libstdc
update_manifest crash_logger
# Now, any line with a '#' followed with several spaces _should_ be dealing
# with the libkdu stuff... So, we simply remove the '#"...
sed -e "s/# them/# them/" $PATH_TO_SOURCES/indra/newview/viewer_manifest.py >$TEMP_BUILD_DIR/viewer_manifest.py
sed -e "s/# / /" $TEMP_BUILD_DIR/viewer_manifest.py >$PATH_TO_SOURCES/indra/newview/viewer_manifest.py
rm -f $TEMP_BUILD_DIR/viewer_manifest.py
chmod +x $PATH_TO_SOURCES/indra/newview/viewer_manifest.py

# Comment out "export LL_GL_BASICEXT=x" in the wrapper script:
sed -e "s/export LL_GL_BASICEXT=x/#export LL_GL_BASICEXT=x/" $PATH_TO_SOURCES/indra/newview/linux_tools/wrapper.sh >$TEMP_BUILD_DIR/wrapper.sh
mv -f $TEMP_BUILD_DIR/wrapper.sh $PATH_TO_SOURCES/indra/newview/linux_tools/wrapper.sh
chmod +x $PATH_TO_SOURCES/indra/newview/linux_tools/wrapper.sh

# Missing file... at least in v1.17.0.0
if grep "secondlife-i686.supp" $PATH_TO_SOURCES/indra/newview/viewer_manifest.py &>/dev/null ; then
if ! [ -f $PATH_TO_SOURCES/indra/newview/secondlife-i686.supp ] ; then
touch $PATH_TO_SOURCES/indra/newview/secondlife-i686.supp
fi
fi

# LL makes the assumption that a certain unicode true type font is installed
# on all Linux systems... which is of course wrong ! Let's check, and when
# this font is absent, replace the broken soft link with an empty file: this
# at least will prevent the viewer to issue many warnings about not being able
# to load the unicode.ttf font.
if ! [ -r $PATH_TO_SOURCES/indra/newview/linux_tools/unicode.ttf ] ; then
rm -f $PATH_TO_SOURCES/indra/newview/linux_tools/unicode.ttf
touch $PATH_TO_SOURCES/indra/newview/linux_tools/unicode.ttf
fi

compile
</nowiki>
</pre>
</code>
<br />
And now for compiling with cmake (v1.21 and later viewers):

<code>
<pre>
<nowiki>
#!/bin/bash

# cmake-SL v1.10 (c)2008 Henri Beauchamp. Released under GPL license v2:
# http://www.gnu.org/licenses/gpl.txt

###############################################################################
######## THIS IS QUICK'N DIRTY ALPHA SOFTWARE. USE AT YOUR OWN RISKS ! ########
###############################################################################

###############################################################################
# BEWARE: this script is meant to compile a -personal- SL client. It is -NOT- #
# suitable to build client versions meant for public release, because #
# non-open source code is packaged by this script. #
###############################################################################

# This bash script is aimed at easying up the build process of a SL client
# with cmake.
# You may enable or disable the use of your system's library by editing
# the USE_SYSTEM_* variable ("yes" --> use the system library, "no" --> use
# LL's provided ones).
# The script also takes care of updating properly the viewer_manifest.py script
# accordingly, so that you (should) end up with a properly packaged client.

# To use this script, simply make it executable (chmod +x cmake-SL) and
# put it into /usr/local/bin (or any other directory in your PATH).
# Then, download the slviewer-src-*.tar.gz, slviewer-linux-libs-*.tar.gz,
# slviewer-artwork-*.zip and fmodapi*.tar.gz archives, and finally, invoke
# make-SL as follow:
# cmake-SL path_to_archives (example: make-SL ~/downloads)
# or simply:
# cmake-SL
# when invoking from the directory where the archives are.
# The sources will be installed into the PATH_TO_SOURCES directory,
# and the client will be built into the TEMP_DIR directory.
# The packaged build will be moved to your home directory.
#
# If you want to retry a compilation after fixing something manually and
# don't want cmake-SL to start all over again, overwriting everything,
# you may invoke it with the --retry option, like this:
# cmake-SL --retry
#
# Finally, if you just want to prepare the sources without starting the
# compilation, use:
# cmake-SL --prep
#
# This script has been tested by the author, on a (very customized)
# Mandriva 2007.1 distro.
# Tested with SL v1.21 sources.

# Where the sources of the client will be held (defaults to "./linden"):
PATH_TO_SOURCES="/usr/src/SL"
# Where to store temporary files:
TEMP_DIR="/usr/tmp/$USER"

USE_SYSTEM_GTK="no"
USE_SYSTEM_SDL="no"
USE_SYSTEM_SSL="no"
# Beware: libdb4 makes use of libapr, and libapr makes use of libexpat... so
# you should keep USE_SYSTEM_APR, USE_SYSTEM_DB4 and USE_SYSTEM_EXPAT in sync.
USE_SYSTEM_APR="no"
USE_SYSTEM_DB4="no"
USE_SYSTEM_EXPAT="no"
USE_SYSTEM_OGG="no"
USE_SYSTEM_ZLIB="no"
USE_SYSTEM_UUID="no"
# If your system libcurl does not use c-ares (non-blocking DNS calls), better
# using LL's provided library...
USE_SYSTEM_CURL="no"
USE_SYSTEM_VORBIS="no"
USE_SYSTEM_XMLRPC="no"
USE_SYSTEM_JPEGLIB="no"
USE_SYSTEM_PERFTOOLS="no"
USE_SYSTEM_LIBSTDC="no"

# You may add tune flags here, to optimize the code for your processor.
# Example, for an Athlon XP:
# TUNE_FLAGS="-march=athlon-xp"
TUNE_FLAGS="-fomit-frame-pointer -frename-registers -fweb -fexpensive-optimizations -march=i686 -msse -mfpmath=sse"
# Set this to "yes" to force vectorization use in the viewer code (only for
# processors with SSE or Altivec units, and only if you did enable them via
# the TUNE_FLAGS.
FORCE_VECTORIZE="yes"

########### functions definitions ###########

function check() {
if [ "$1" == "yes" ] ; then
if [ -f $2 ] ; then
echo "Using the system $3..."
return 0
else
echo "WARNING: system $3 requested but not available..."
fi
fi
return 1
}

function update_manifest() {
grep -v $1 $PATH_TO_SOURCES/indra/newview/viewer_manifest.py >$TEMP_DIR/viewer_manifest.py
mv -f $TEMP_DIR/viewer_manifest.py $PATH_TO_SOURCES/indra/newview/viewer_manifest.py
chmod +x $PATH_TO_SOURCES/indra/newview/viewer_manifest.py
}

function compile() {
cd $PATH_TO_SOURCES/indra
echo "Compiling the client into $TEMP_DIR..."
./develop.py --type=Release build
if (($? == 0)) ; then
mv -f $PATH_TO_SOURCES/indra/viewer-linux-i686/newview/SecondLife*.tar.bz2 $HOME/
fi
}

########### end of functions ###########

if [ "$TEMP_DIR" == "" ] ; then
export TEMP_DIR="/usr/tmp/$USER"
fi

# Check to see if we simply want to retry a compilation:
if [ "$1" == "--retry" ] ; then
compile
exit $?
fi

# Make sure we don't unpack over an old source tree:
if [ -d linden ] ; then
rm -rf linden/
fi

if [ -d $PATH_TO_SOURCES ] && [ "$PATH_TO_SOURCES" != "" ] && [ "$PATH_TO_SOURCES" != "/" ] && [ "$PATH_TO_SOURCES" != "." ] && [ "$PATH_TO_SOURCES" != ".." ] && [ "$PATH_TO_SOURCES" != "$HOME" ] ; then
rm -rf $PATH_TO_SOURCES/
fi

# Use the parameter (if any) as the path to the archives:

PATH_TO_ARCHIVES=`pwd`
if [ "$1" != "" ]; then
if [ -d $1 ] ; then
PATH_TO_ARCHIVES=$1
fi
fi

# Let's first unpack everything:
if ! [ -f $PATH_TO_ARCHIVES/slviewer-src-*.tar.gz ] ; then
echo "You need slviewer-src !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/slviewer-linux-libs-*.tar.gz ] ; then
echo "You need slviewer-linux-libs !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/slviewer-artwork-*.zip ] ; then
echo "You need slviewer-artwork !"
exit 1
fi
if ! [ -f $PATH_TO_ARCHIVES/fmodapi*.tar.gz ] ; then
echo "You need fmodapi !"
exit 1
fi
echo "Extracting the files from the archives..."
tar xzf $PATH_TO_ARCHIVES/slviewer-src-*.tar.gz
tar xzf $PATH_TO_ARCHIVES/slviewer-linux-libs-*.tar.gz
unzip -o $PATH_TO_ARCHIVES/slviewer-artwork-*.zip >/dev/null
# You may add artwork patches named in the form:
# slviewer-whatever-artwork-patch.zip
# Example: slviewer-v11900-statusbar-artwork-patch.zip
ARTWORK_PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*-artwork-patch.zip`
if [ "$ARTWORK_PATCHES" != "" ] ; then
for f in $ARTWORK_PATCHES; do
echo "Extracting artwork patch $f..."
unzip -o $f >/dev/null
done
fi

# fmodapi:
echo "Copying fmodapi files..."
tar xzf $PATH_TO_ARCHIVES/fmodapi*.tar.gz
mkdir -p linden/libraries/include/
mkdir -p linden/libraries/i686-linux/lib_debug/
mkdir -p linden/libraries/i686-linux/lib_release/
mkdir -p linden/libraries/i686-linux/lib_release_client/
cp -a fmodapi*/api/inc/* linden/libraries/include/
cp -a fmodapi*/api/libfmod-*.so linden/libraries/i686-linux/lib_release_client/
rm -rf fmodapi*/

# Move the sources to where we want to hold them:
if [ "$PATH_TO_SOURCES" != "linden" ] && [ "$PATH_TO_SOURCES" != "" ] ; then
echo "Moving the sources to $PATH_TO_SOURCES..."
mv -f linden $PATH_TO_SOURCES
fi

# Let's own the files:
chown -R $USER: $PATH_TO_SOURCES/

# Check for patches to apply. The names of the patches must be in the form
# slviewer-*.patch* (Example: slviewer-v117-EmbbededNotecard.patch.bz2).
# They must be applicable from inside the source directory with the -p1
# option, i.e. they have been built from outside the source directory
# with a diff command such as:
# diff -urN linden/ linden-patched/ >slviewer-whatever.patch
# And they may be gzipped or bzipped.
PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*.patch* 2>/dev/null`
if [ "$PATCHES" != "" ] ; then
echo "Applying patches..."
cd $PATH_TO_SOURCES
PATCHES=`/bin/ls $PATH_TO_ARCHIVES/slviewer-*.patch*`
for i in $PATCHES; do
echo "Patch: $i"
if echo $i | grep ".gz" &>/dev/null ; then
gunzip -c $i | patch -p1 -s
elif echo $i | grep ".bz2" &>/dev/null ; then
bzcat $i | patch -p1 -s
else
patch -p1 -s <$i
fi
done
fi

cd $PATH_TO_SOURCES/indra

# Do a clean build
./develop.py clean

# Force the vectorization use if we chose so.
if [ "$FORCE_VECTORIZE" == "yes" ] ; then
TUNE_FLAGS="$TUNE_FLAGS -DLL_VECTORIZE=1"
fi
# Configure the sources and download the LL provided libraries:
./develop.py --type=Release configure \
-DCMAKE_C_FLAGS:STRING="-O2 $TUNE_FLAGS" -DCMAKE_CXX_FLAGS:STRING="-O2 $TUNE_FLAGS" \
-DCMAKE_C_FLAGS_RELEASE:STRING="-O2 $TUNE_FLAGS" -DCMAKE_CXX_FLAGS_RELEASE:STRING="-O2 $TUNE_FLAGS" \
-DCMAKE_C_FLAGS_RELWITHDEBINFO:STRING="-g -O2 $TUNE_FLAGS" -DCMAKE_CXX_FLAGS_RELWITHDEBINFO:STRING="-g -O2 $TUNE_FLAGS"

# Let's use the system GTK+ if available:
if check $USE_SYSTEM_GTK /usr/include/atk-1.0/atk/atk.h "GTK+" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client
rm -f libgtk* libgdk* libglib* libgmodule* libgobject* libgthread* libpango* libatk*
cd ../include
rm -rf atk-1.0/ gtk-2.0/ glib-2.0/ pango-1.0/
cp -a /usr/include/atk-1.0 .
cp -a /usr/include/gtk-2.0 .
cp -a /usr/lib/gtk-2.0/include/* gtk-2.0/
cp -a /usr/include/glib-2.0 .
cp -a /usr/lib/glib-2.0/include/* glib-2.0/
cp -a /usr/include/pango-1.0 .
if [ -d /usr/include/cairo ] ; then
cp -a /usr/include/cairo/* .
fi
fi

# Let's use the system zlib if available:
if check $USE_SYSTEM_ZLIB /usr/include/zlib.h "zlib" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/zlib/
rm -f i686-linux/lib_release_client/libz.so.1
mkdir -p include/zlib
cp -a /usr/include/zlib*.h include/zlib/
fi

# Let's use the system jpeglib if available:
if check $USE_SYSTEM_JPEGLIB /usr/include/jpeglib.h "jpeglib" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/jpeglib/ i686-linux/lib_release_client/libjpeg.a
mkdir -p include/jpeglib
cp -a /usr/include/j*.h include/jpeglib/
touch include/jpeglib/jinclude.h
fi

# Let's use the system xmlrpc-epi if available:
if check $USE_SYSTEM_XMLRPC /usr/include/xmlrpc.h "xmlrpc-epi" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/xmlrpc-epi/ i686-linux/lib_release_client/libxmlrpc.a
mkdir -p include/xmlrpc-epi
cp -a /usr/include/xmlrpc*.h include/xmlrpc-epi/
fi

# Let's use the system ogg if available:
if check $USE_SYSTEM_OGG /usr/include/ogg/ogg.h "ogg" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/ogg/ i686-linux/lib_release_client/libogg*
fi

# Let's use the system vorbis if available:
if check $USE_SYSTEM_VORBIS /usr/include/vorbis/vorbisenc.h "vorbis" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/vorbis/ i686-linux/lib_release_client/libvorbis*
fi

# Let's use the system SDL if available:
if check $USE_SYSTEM_SDL /usr/include/SDL/SDL.h "SDL" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -rf include/SDL/ lib_release_client/libSDL*
update_manifest libSDL
fi

# Let's use the system openssl if available:
if check $USE_SYSTEM_SSL /usr/include/openssl/opensslconf.h "openssl" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client
rm -f libssl.* libcrypto.*
update_manifest libssl
update_manifest libcrypto
fi

# Let's use the system apr if available:
if check $USE_SYSTEM_APR /usr/include/apr*/apr_base64.h "apr" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -rf include/apr-1/*
rm -f lib_release_client/libapr*
cp -a /usr/include/apr*/* include/apr-1/
update_manifest libapr
fi

# Let's use the system db4 if available:
if check $USE_SYSTEM_DB4 /usr/include/db4/db.h "db4" ; then
rm -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libdb*.so
update_manifest libdb
fi

# Let's use the system expat if available:
if check $USE_SYSTEM_EXPAT /usr/include/expat.h "expat" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/expat/
rm -f i686-linux/lib_release_client/libexpat*
mkdir -p include/expat
cp -a /usr/include/expat*.h include/expat/
fi

# Let's use the system curl if available:
if check $USE_SYSTEM_CURL /usr/include/curl/curl.h "curl" ; then
cd $PATH_TO_SOURCES/libraries
rm -rf include/curl/
rm -f i686-linux/lib_release_client/libcurl.*
fi

# Let's use the system uuid if available:
if check $USE_SYSTEM_UUID /lib/libuuid.so.1 "libuuid" ; then
rm -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libuuid.*
update_manifest libuuid
fi

# Let's use the system google-perftools if available:
if check $USE_SYSTEM_PERFTOOLS /usr/include/google/malloc_hook.h "google-perftools" ; then
cd $PATH_TO_SOURCES/libraries/i686-linux
rm -f lib_release_client/libtcmalloc.* lib_release_client/libstacktrace.*
rm -rf include/google/
cp -a /usr/lib/libstacktrace.* /usr/lib/libtcmalloc.so* lib_release_client/
cp -a /usr/include/google include/
update_manifest tcmalloc
update_manifest stacktrace
fi

# Let's use the system libstdc++ if available:
if check $USE_SYSTEM_UUID /usr/lib/libstdc++.so.6 "libstdc++" ; then
rm -f $PATH_TO_SOURCES/libraries/i686-linux/lib_release_client/libstdc++.*
update_manifest libstdc
fi

# Force libkdu inclusion
# (disabled for now (v1.21.0 viewer) as the cmake scripts fail to get libkdu from Internet).
if false; then
# Remove everything dealing with libstdc++ and the crash logger:
update_manifest libstdc
update_manifest logger
# Now, any line with a '#' followed with several spaces _should_ be dealing
# with the libkdu stuff... So, we simply remove the '#"...
sed -e "s/# them/# them/" $PATH_TO_SOURCES/indra/newview/viewer_manifest.py >$TEMP_DIR/viewer_manifest.py
sed -e "s/^# / /" $TEMP_DIR/viewer_manifest.py >$PATH_TO_SOURCES/indra/newview/viewer_manifest.py
rm -f $TEMP_DIR/viewer_manifest.py
chmod +x $PATH_TO_SOURCES/indra/newview/viewer_manifest.py
fi

# Check to see if we simply want to unpack the sources:
if [ "$1" == "--prep" ] ; then
echo "Prepared sources available in: $PATH_TO_SOURCES"
exit 0
fi

compile
</nowiki>
</pre>
</code>
<br />
<br />

== FreeBSD ==

A list of patches is given for [[Compiling the viewer (FreeBSD)]].

= Submitting Patches =
This is probably far down the road, but if you make changes to the source and want to submit them, see the page about [[Submitting patches|submitting patches]].

[[Category:Compiling viewer]]

Developer communication tools

2008-08-31T16:51:01Z

Alexandrea Fride: /* IRC */ removed # from link as it wil join ##opensl else when clicking on it and joining

{{Languages}}
{{OSWikiContribBox}}

Let us know what you think on email, on the forum, or in-world. If it's not working for you, try to get help there. If it is working for you, try helping someone who isn't having as much luck as you are.

== Mailing List ==

[[SLDev|SLDev Mailing List]] ([https://lists.secondlife.com/cgi-bin/mailman/listinfo/sldev subscribe]) - mailing list for discussing the development of the Second Life viewer. This is a high-traffic mailing list (as many as 30-40 messages/day on a busy day). For a weekly summary of this mailing list, see [[SLDev Traffic]]. You may also want to search the [https://lists.secondlife.com/pipermail/sldev/ SLDev archives].

== Forum ==

If you are having issues getting things built, and you just want to ask a quick question, please ask it in one of the "[http://forums.secondlife.com/forumdisplay.php?f=296 Technical Talk]" forums.

== JIRA ==

If you run into issues, look through the bug database and see if a bug has been filed. If so, vote for the issue to be fixed. If not, file the bug.

[http://jira.secondlife.com Second Life JIRA] is the place to submit bug reports, reproductions and patches for issues relating to the open source viewer.

== Wiki ==
You're soaking in it...

This is the place to post documentation, more indepth discussions, and various projects

== IRC ==
Internet Relay Chat - your instant way to communicate
irc://irc.efnet.org/opensl

== In-World Groups ==
=== Resident-Run Groups ===
: AW Groupies : In-world discussion of [[Architecture_Working_Group]] plus [[AW_Groupies|wiki webpages]]
; Aware of the SL Issue Tracker : To promote awareness of the Second Life [[issue tracker]].
; Hack SL : "Whether you're a good hacker or a bad hacker, or simply a chaotic-neutral hacker, the undenyable fact is that the source is now open, and whether or not you have good intentions, you have full access to the code and the client. Come join us and figure out new and exciting ways to either fix or break SL so we can strengthen the community through fire and aloe!"
; JIRA and SLDev Fanclub : "For all thoses techno-nerdo-geeky of SLDev enjoying the public secondlife JIRA, meta-issueing, bug-triage and much more... Trying to organize unofficial bug-triage and bogus-bug hunting party!"
; OpenSL : "Open Second Life viewer #opensl on efnet https://wiki.secondlife.com/wiki/Open_Source_Portal"
; Second Life Source Developers : A group who use their real life programing skills to make SL a better place with open source releases from Linden Lab.

== In-World Locations ==
The [[Hippotropolis]] region is a gathering place for developers and residents interested in improving the Second Life Viewer. [http://slurl.com/secondlife/Hippotropolis/190/65/38/ Teleport] to the Linden Open Source Project headquarters.

== Weekly In-world Meeting ==

Each week, there's an [[Open Source Meeting]] to discuss open source issues.