Skip to content

Commit

Permalink
updated USB streaming specifications
Browse files Browse the repository at this point in the history
  • Loading branch information
vagrant committed Jan 18, 2017
1 parent 010ccbd commit 171cd46
Show file tree
Hide file tree
Showing 5 changed files with 92 additions and 13 deletions.
Binary file modified img/livestreaming/register-button.png
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified img/livestreaming/registration-complete.png
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added img/livestreaming/webcam-options.png
View file
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
33 changes: 28 additions & 5 deletions live-streaming.adoc
View file
Expand Up @@ -88,6 +88,10 @@ With the THETA turned off, the software will prompt you to reconnect the THETA t

image::img/livestreaming/register.png[role="thumb" title="Register THETA with computer"]

NOTE: RICOH updated UVCBlender to 2.0.0 on November 24, 2016. https://theta360.com/en/info/news/2016-11-24-1/[Official announcement].
This was a significant upgrade that enabled full HD at 30 fps with USB. It also moved to USB Video Class (UVC) 1.5.
See http://www.usb.org/developers/docs/devclass_docs/[USB device class specifications].

After you connect your THETA, a _Register_ button will appear.

image::img/livestreaming/register-button.png[role="thumb" title="Register buttons appears after connection"]
Expand All @@ -96,16 +100,35 @@ Complete the registration.

image::img/livestreaming/registration-complete.png[role="thumb" title="Camera and computer registration complete"]

Test the THETA UVC Blender driver with any software that works with a webcam. In the example
Test the THETA UVC FullHD Blender driver with any software that works with a webcam. In the example
below, I am using Skype.

image::img/livestreaming/theta-uvc-skype-select.png[role="thumb" title="Testing THETA UVC Blender with Skype"]
image::img/livestreaming/webcam-options.png[role="thumb" title="Testing THETA UVC FullHD Blender with Skype"]

CAUTION: Make sure you select _THETA UVC Blender_ and not _RICOH THETA S_.
CAUTION: Make sure you select _THETA UVC FullHD Blender_ and not _RICOH THETA S_.

NOTE: In Skype, the video does not have 360° navigation (as of Oct 2016) and it will
NOTE: In Skype, the video does not have 360° navigation (as of Jan 2017) and it will
look like a distorted rectangle. Skype is for testing only, not for use.

=== Video Devices
You have three options: RICOH THETA S, THETA UVC HD Blender, THETA UV FullHD Blender. As ofr
Jan 2017, this is my understanding of the differences. This is based on the
https://developers.theta360.com/en/docs/introduction/[official RICOH specifications]. If this
table is in error, please join the discussion http://lists.theta360.guide/t/360-live-streaming-guide-for-ricoh-theta/621[here].

.Table Live Streaming Drivers
|===
|Driver |Display Format |Image Size

|THETA S |dual-fisheye | 1920x1080 with firmware 01.82

|THETA UVC FullHD Blender | Equirectangular |1920x1080

|THETA UVC HD Blender | Equirectangular | 1280x720

|===


== Configure Computer To Stream to Internet

Download and install OBS.
Expand All @@ -115,7 +138,7 @@ image::img/livestreaming/obs-icon.png[role="thumb" title="OBS Studio"]
https://obsproject.com/[Download OBS]

Create a new _Scene_. Any name is fine. Click on the plus sign. Under
_Sources_, add THETA UVC Blender (any name is fine) and add
_Sources_, add THETA Full HD UVC Blender (any name is fine) and add
a video capture device. Right click to open the pop-up menu.

image::img/livestreaming/obs-video-capture.png[role="thumb" title="Add Video Capture Device to OBS _Sources_"]
Expand Down
72 changes: 64 additions & 8 deletions live-streaming.html
View file
Expand Up @@ -756,6 +756,7 @@ <h1>RICOH THETA Live Streaming</h1>
<ul class="sectlevel2">
<li><a href="#_connect_camera_to_computer">2.1. Connect Camera to Computer</a></li>
<li><a href="#_install_live_streaming_software">2.2. Install Live Streaming Software</a></li>
<li><a href="#_video_devices">2.3. Video Devices</a></li>
</ul>
</li>
<li><a href="#_configure_computer_to_stream_to_internet">3. Configure Computer To Stream to Internet</a></li>
Expand Down Expand Up @@ -961,6 +962,20 @@ <h4 id="_download_and_install_ricoh_live_streaming_app">2.2.1. Download and Inst
</div>
<div class="title">Figure 6. Register THETA with computer</div>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
RICOH updated UVCBlender to 2.0.0 on November 24, 2016. <a href="https://theta360.com/en/info/news/2016-11-24-1/">Official announcement</a>.
This was a significant upgrade that enabled full HD at 30 fps with USB. It also moved to USB Video Class (UVC) 1.5.
See <a href="http://www.usb.org/developers/docs/devclass_docs/">USB device class specifications</a>.
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>After you connect your THETA, a <em>Register</em> button will appear.</p>
</div>
Expand All @@ -980,14 +995,14 @@ <h4 id="_download_and_install_ricoh_live_streaming_app">2.2.1. Download and Inst
<div class="title">Figure 8. Camera and computer registration complete</div>
</div>
<div class="paragraph">
<p>Test the THETA UVC Blender driver with any software that works with a webcam. In the example
<p>Test the THETA UVC FullHD Blender driver with any software that works with a webcam. In the example
below, I am using Skype.</p>
</div>
<div class="imageblock thumb">
<div class="content">
<img src="img/livestreaming/theta-uvc-skype-select.png" alt="theta uvc skype select">
<img src="img/livestreaming/webcam-options.png" alt="webcam options">
</div>
<div class="title">Figure 9. Testing THETA UVC Blender with Skype</div>
<div class="title">Figure 9. Testing THETA UVC FullHD Blender with Skype</div>
</div>
<div class="admonitionblock caution">
<table>
Expand All @@ -996,7 +1011,7 @@ <h4 id="_download_and_install_ricoh_live_streaming_app">2.2.1. Download and Inst
<i class="fa icon-caution" title="Caution"></i>
</td>
<td class="content">
Make sure you select <em>THETA UVC Blender</em> and not <em>RICOH THETA S</em>.
Make sure you select <em>THETA UVC FullHD Blender</em> and not <em>RICOH THETA S</em>.
</td>
</tr>
</table>
Expand All @@ -1008,14 +1023,55 @@ <h4 id="_download_and_install_ricoh_live_streaming_app">2.2.1. Download and Inst
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
In Skype, the video does not have 360&#176; navigation (as of Oct 2016) and it will
In Skype, the video does not have 360&#176; navigation (as of Jan 2017) and it will
look like a distorted rectangle. Skype is for testing only, not for use.
</td>
</tr>
</table>
</div>
</div>
</div>
<div class="sect2">
<h3 id="_video_devices">2.3. Video Devices</h3>
<div class="paragraph">
<p>You have three options: RICOH THETA S, THETA UVC HD Blender, THETA UV FullHD Blender. As ofr
Jan 2017, this is my understanding of the differences. This is based on the
<a href="https://developers.theta360.com/en/docs/introduction/">official RICOH specifications</a>. If this
table is in error, please join the discussion <a href="http://lists.theta360.guide/t/360-live-streaming-guide-for-ricoh-theta/621">here</a>.</p>
</div>
<table class="tableblock frame-all grid-all spread">
<caption class="title">Table 2. Table Live Streaming Drivers</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Driver</th>
<th class="tableblock halign-left valign-top">Display Format</th>
<th class="tableblock halign-left valign-top">Image Size</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">THETA S</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">dual-fisheye</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1920x1080 with firmware 01.82</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">THETA UVC FullHD Blender</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Equirectangular</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1920x1080</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">THETA UVC HD Blender</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Equirectangular</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1280x720</p></td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="sect1">
Expand All @@ -1035,7 +1091,7 @@ <h2 id="_configure_computer_to_stream_to_internet">3. Configure Computer To Stre
</div>
<div class="paragraph">
<p>Create a new <em>Scene</em>. Any name is fine. Click on the plus sign. Under
<em>Sources</em>, add THETA UVC Blender (any name is fine) and add
<em>Sources</em>, add THETA Full HD UVC Blender (any name is fine) and add
a video capture device. Right click to open the pop-up menu.</p>
</div>
<div class="imageblock thumb">
Expand Down Expand Up @@ -1752,7 +1808,7 @@ <h2 id="_faq">8. FAQ</h2>
<p><strong>A:</strong> Updated Oct 2016.</p>
</div>
<table class="tableblock frame-all grid-all spread">
<caption class="title">Table 2. Table THETA S Live Streaming</caption>
<caption class="title">Table 3. Table THETA S Live Streaming</caption>
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 16.6666%;">
Expand Down Expand Up @@ -2004,7 +2060,7 @@ <h2 id="__a_href_http_theta360_guide_return_to_theta360_guide_a">11. <a href="ht
</div>
<div id="footer">
<div id="footer-text">
Last updated 2017-01-18 16:43:54 UTC
Last updated 2017-01-18 17:26:44 UTC
</div>
</div>
</body>
Expand Down

0 comments on commit 171cd46

Please sign in to comment.