Difference between revisions of "Viewer Architecture"

From Second Life Wiki
Jump to navigation Jump to search
 
(45 intermediate revisions by 23 users not shown)
Line 1: Line 1:
{{OSWikiLearnBox}}
{{OSWikiLearnBox}}
[[Category:Viewer Architecture]]
[[Category: AW Groupies]]


The Second Life client (also known as the "viewer") is a complex piece of software. It can be visualized as a streaming media client like RealPlayer, a game engine like Quake 3, or a web browser.
The Second Life client (also known as the "viewer") is a complex piece of software. It can be visualized as a streaming media client like RealPlayer, a game engine like Quake 3, or a web browser.


First you'll need to learn some [[Second Life Terminology]], like "agent", "sim", and "region".
First you'll need to learn some terminology like "agent", "sim", and "region" in the [[glossary]].


== Learn by Example ==
== Learn by Example ==
* [[Adding a menu item]]
* [[Adding a menu item]]
* [[Adding a dialog]]
* [[Adding a dialog]]
* [[Adding a cursor]]
* [[How movement works]]
* [[How movement works]]
* [[How the camera works]]
* [[How the camera works]]
* [[How login works]]
* [[Login_Protocol|How login works]]
* [[Hegemons Login Analysis]]
* [[How keyboard processing works]]
* [[How keyboard processing works]]
* [[How scripts work]]
* [[How scripts work]]
* [[The lifetime of a session]]
* [[How preferences work]]


== Major Systems ==
== Major Systems ==
* [[Animation]] - avatar motions
* [[Asset System]] - transport for animations, sounds, notecards, scripts, etc.
* [[Avatar Appearance]] - appearance is constructed from a mesh, parameters to deform the mesh, and textures to describe clothing
* [[Avatar Profiles]]
* [[Culling]] - octree and occlusion based culling to speed rendering
* [[Error Logging System]] - command and control of debugging output
* [[Groups]]
* [[Image System]] - prioritizes and decodes JPEG2000 images into OpenGL textures
** [[Texture cache]] - used for reading and writing texture data to the local disk cache
** [[Image Pipeline]] - fetches textures from the servers and decodes them
* [[Inventory OS|Inventory]] - server-side storage of assets for each user
* [[L$ System]]
* [[LLMedia API]] - arbitrary media on object surfaces
* [[Message System]] - reliable and unreliable transport over UDP
* [[Message System]] - reliable and unreliable transport over UDP
* [[Image System]] - prioritizes and decodes JPEG2000 images into OpenGL textures
* [[Muting Objects and Agents]] - How the viewer manages the muted object list
* [[Viewer Object System]] - objects in scene for rendering and editing
* [[Rendering System]] - from viewer object to drawable to face to vertices to graphics card
* [[Rendering System]] - from viewer object to drawable to face to vertices to graphics card
* [[Culling]] - octree and occlusion based culling to speed rendering
* [[Selection Manager]] - holds extended information for selected objects and allows editing
* [[Sound System]] - cross platform audio based on FMOD
* [[Tools]] - anything that takes effect when you click your mouse on the world view.
* [[UI Widgets]] - cross platform buttons, scroll bars, etc.
* [[UI Widgets]] - cross platform buttons, scroll bars, etc.
* [[UI Floaters]] - dialogs and windows built from XML files
* [[UI Floaters]] - dialogs and windows built from XML files
* [[Asset System]] - transport for animations, sounds, notecards, scripts, etc.
* [[Inventory]] - server-side storage of assets for each user
* [[Sound System]] - cross platform audio based on FMOD
* [[Movie System]] - QuickTime-based video on object surfaces
* [[VFS]] - cached data is held in two "virtual file systems" in large files on the client
* [[VFS]] - cached data is held in two "virtual file systems" in large files on the client
* [[Selection Manager]] - holds extended information for selected objects and allows editing
* [[Viewer Object System]] - objects in scene for rendering and editing
* [[Avatar Appearance]] - appearance is constructed from a mesh, parameters to deform the mesh, and textures to describe clothing
* [[Web Browser]] - the integration of the viewer with the web.
* [[Avatar Profiles]]
* [[Groups]]
* [[Money]]


== Threads ==
== Threads ==
The viewer is a single process with a few threads:
The viewer is a single process with a few threads:
* Main thread -- The input/output main program function.
* Main thread -- The input/output main program function (including rendering).
* VFS thread -- Thread responsible for reading/writing to the virtual file system.
* VFS thread -- Thread responsible for reading/writing to the local virtual file system.
* LFS thread -- Thread responsible for some reading/writing to the local file system. Not sure if this is actually used anywhere.
* LFS thread -- Thread responsible for some reading/writing to the local native file system.
* Image thread -- Currently unused.
** Used by the {{OSWiki|Threaded_Image_Pipeline}} project
* Image thread -- Thread responsible for requesting and decoding image data
** Used by the {{OSWiki|Threaded_Image_Pipeline}} project
* Error Thread -- Thread responsible for catching exceptions, calling the (currently unused?) error handler, and retiring
* Worker Threads -- Threads designed to do cpu intensive background tasks
** These threads may be paused during rendering so as not to reduce performance (design in-progress)


== Program Flow ==
== Program Flow ==
Line 45: Line 63:
#* Gathers  keyboard and mouse input
#* Gathers  keyboard and mouse input
#* Pumps the TCP i/o
#* Pumps the TCP i/o
#* idle()
#* Render the frame
#* Render the frame
#* idle()
#* let filesystem and worker threads process
#** everything
# Shutdown
# Shutdown
One way to see what goes on in the main loop is to bring up the debug menus (Ctrl-Alt-D) then Client->Consoles->Fast Timers (or Ctrl-Shift-9) and expand the entries in the caption.
:see also: [[AW_Groupies#Communications| AW Groupies protocol and login documentation links]]
=== Startup and initalisation ===
(updated for 1.20.14 code)
The main() function for the viewer exists in either llappviewerlinux.cpp, llappviewerwin32.cpp or llappviewermac.cpp depending on your platform. This creates the instance of LLAppViewerLinux, LLAppViewerWin32 or LLAppViewerMac which all are derrived from LlAppViewer. The initial platform dependent code sets up the various error handlers to handle a viewer exception (crash condition). The reset of the platform dependent appviewer classes are related to crash handlers.
The initialization then occurs in LLAppViewer::init() this is the real low level setup and class creation and does things including :-
* Sets up application directory locations
* Sets up logging
* loads configuration
* sets up Curl
* Creates worker threads
* Creates the LLUI system
* loads saved/default settings
* initalises the cache system
* sets up the viewer window
* Checks the CPU type and features
* checks memory and graphics card
* Initalises joystick
Then the LLAppViewer::mainloop() is started


== Sources of Input ==
== Sources of Input ==
Line 55: Line 97:
** Files through [[Xfer Manager]].
** Files through [[Xfer Manager]].
* Files copied out of a [[VFS]] into local file store and read through c/c++/ll file API.
* Files copied out of a [[VFS]] into local file store and read through c/c++/ll file API.
* XMLRPC calls such as [[Authentication Flow|login]] and [[Bying Land and Currency]].
* XMLRPC calls such as [[Authentication Flow|login]] and [[Buying Land and Currency]].
* HTTP GET/POST to the [[Backbone]]. This is not yet in use.
* HTTP GET/POST to the [[Backbone]]. This is not yet in use.
* Streaming music and videos.
* Streaming music and videos.
Line 61: Line 103:
** FMOD.
** FMOD.
* The web browser.
* The web browser.
== User Guides ==
* [[Viewer coordinate frames]].
* Known [[Client_parameters]]
* Known Client Parameters on [http://lslwiki.net/lslwiki/wakka.php?wakka=newview&show_comments=1 LSLwiki.net]
* Known [[defines]]
* [[Godmode]] - what Lindens can do
== See also ==
*  [[Viewer Roadmap]] - how everything you read here could be changing or might have already changed.
*  [[Viewer Software Overview]] - where to find things in the source code
*  [http://developer.dimentox.com/ Viewer 2 Doxygen]

Latest revision as of 20:03, 26 March 2011

The Second Life client (also known as the "viewer") is a complex piece of software. It can be visualized as a streaming media client like RealPlayer, a game engine like Quake 3, or a web browser.

First you'll need to learn some terminology like "agent", "sim", and "region" in the glossary.

Learn by Example

Major Systems

Threads

The viewer is a single process with a few threads:

  • Main thread -- The input/output main program function (including rendering).
  • VFS thread -- Thread responsible for reading/writing to the local virtual file system.
  • LFS thread -- Thread responsible for some reading/writing to the local native file system.
  • Image thread -- Thread responsible for requesting and decoding image data
  • Error Thread -- Thread responsible for catching exceptions, calling the (currently unused?) error handler, and retiring
  • Worker Threads -- Threads designed to do cpu intensive background tasks
    • These threads may be paused during rendering so as not to reduce performance (design in-progress)

Program Flow

  1. Initialize - newview/viewer.cpp :: main()
  2. Loop - newview/viewer.cpp :: main_loop()
    • Gathers keyboard and mouse input
    • Pumps the TCP i/o
    • idle()
    • Render the frame
    • let filesystem and worker threads process
  3. Shutdown

One way to see what goes on in the main loop is to bring up the debug menus (Ctrl-Alt-D) then Client->Consoles->Fast Timers (or Ctrl-Shift-9) and expand the entries in the caption.

see also: AW Groupies protocol and login documentation links

Startup and initalisation

(updated for 1.20.14 code)

The main() function for the viewer exists in either llappviewerlinux.cpp, llappviewerwin32.cpp or llappviewermac.cpp depending on your platform. This creates the instance of LLAppViewerLinux, LLAppViewerWin32 or LLAppViewerMac which all are derrived from LlAppViewer. The initial platform dependent code sets up the various error handlers to handle a viewer exception (crash condition). The reset of the platform dependent appviewer classes are related to crash handlers.

The initialization then occurs in LLAppViewer::init() this is the real low level setup and class creation and does things including :-

  • Sets up application directory locations
  • Sets up logging
  • loads configuration
  • sets up Curl
  • Creates worker threads
  • Creates the LLUI system
  • loads saved/default settings
  • initalises the cache system
  • sets up the viewer window
  • Checks the CPU type and features
  • checks memory and graphics card
  • Initalises joystick

Then the LLAppViewer::mainloop() is started

Sources of Input

User Guides

See also