git: 3f6c35289e - main - handbook/multimedia: minor improvements for clarity post fcbb060fe7
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Mon, 10 Apr 2023 10:01:52 UTC
The branch main has been updated by ceri:
URL: https://cgit.FreeBSD.org/doc/commit/?id=3f6c35289ebf2c261e69657de6e1cb73de28bf73
commit 3f6c35289ebf2c261e69657de6e1cb73de28bf73
Author: Ceri Davies <ceri@FreeBSD.org>
AuthorDate: 2023-04-10 10:01:25 +0000
Commit: Ceri Davies <ceri@FreeBSD.org>
CommitDate: 2023-04-10 10:01:25 +0000
handbook/multimedia: minor improvements for clarity post fcbb060fe7
---
.../en/books/handbook/multimedia/_index.adoc | 53 +++++++++-------------
1 file changed, 22 insertions(+), 31 deletions(-)
diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc
index 165e6902a1..66bb211877 100644
--- a/documentation/content/en/books/handbook/multimedia/_index.adoc
+++ b/documentation/content/en/books/handbook/multimedia/_index.adoc
@@ -57,7 +57,7 @@ This chapter covers various multimedia components such as audio, video, and imag
It also discusses various media formats and codecs, as well as tools and applications for multimedia creation and playback.
Additionally, the chapter covers multimedia system configuration, troubleshooting, and optimization.
Whether you are a multimedia enthusiast or a professional content creator, FreeBSD offers a robust platform for multimedia work.
-This chapter aims to help get the most out of FreeBSD's multimedia capabilities, providing useful information and practical examples to help get started
+This chapter aims to help get the most out of FreeBSD's multimedia capabilities, providing useful information and practical examples to help get started.
[[sound-setup]]
== Setting Up the Sound Card
@@ -68,10 +68,10 @@ The list of supported sound cards can be consulted in man:sound[4].
[NOTE]
====
-It is only necessary to load the sound card module in case FreeBSD has not detected it correctly.
+It is only necessary to load the sound card module if FreeBSD has not detected it correctly.
====
-In case of not knowing which sound card the system has or which module to use the `snd_driver` metadriver can be loaded executing the following command:
+Where it is not known knowing which sound card the system has, or which module to use, the `snd_driver` metadriver can be loaded by executing the following command:
[source,shell]
....
@@ -132,7 +132,7 @@ man:beep[1] can be used to produce some noise, confirming that the sound card is
[[sound-mixer]]
=== Mixer
-FreeBSD has different utilities to set/display sound card mixer values built on the FreeBSD Sound System:
+FreeBSD has different utilities to set and display sound card mixer values built on the FreeBSD Sound System:
.Supported mixer packages
[options="header", cols="1,1,1,1"]
@@ -164,10 +164,9 @@ FreeBSD has different utilities to set/display sound card mixer values built on
[[graphics-card-sound]]
=== Graphics Card Sound
-Graphics cards often come with their own integrated sound devices, which may not be used as the default device.
-To confirm, run dmesg and look for the pcm entries:
-
-Identify how the system is enumerating the outputs executing the following command:
+Graphics cards often come with their own integrated sound devices, and it may be unclear which is being used as the default device.
+To confirm, run dmesg and look for the pcm entries to identify how the system is enumerating the outputs.
+Execute the following command:
[source,shell]
....
@@ -189,8 +188,8 @@ pcm6: <HDA Realtek ALC889 PCM #2 Digital> at cad 2 nid 1 on hdac1
pcm7: <HDA Realtek ALC889 PCM #3 Digital> at cad 2 nid 1 on hdac1
....
-The graphics card (NVIDIA(R)) has been enumerated before the sound card (Realtek(R)).
-This can be changed to use the sound card as the default device executing the following command:
+The graphics card (NVIDIA(R)) has been enumerated before the sound card (Realtek(R)), with the sound card appearing as `pcm4`.
+The system can be configured to use the sound card as the default device by executing the following command:
[source,shell]
....
@@ -207,9 +206,9 @@ hw.snd.default_unit=4
[[automatically-switching-headphones]]
=== Automatically Switching to Headphones
-Some systems may struggle with switching between audio outputs, fortunately FreeBSD allows for these to be specified in [.filename]#device.hints#, which can be configured for automatic switchover.
+Some systems may struggle with switching between audio outputs, but fortunately FreeBSD allows automatic switchover to be configured in [.filename]#device.hints#.
-Identify how the system is enumerating the audio outputs executing the following command:
+Identify how the system is enumerating the audio outputs by executing the following command:
[source,shell]
....
@@ -329,7 +328,7 @@ To install Elisa, execute:
[[gnome-music]]
=== GNOME Music
-Music is the new GNOME music playing application.
+GNOME Music is the new GNOME music playing application.
It aims to combine an elegant and immersive browsing experience with simple and straightforward controls.
To install GNOME Music, execute:
@@ -407,7 +406,7 @@ This section introduces some of the software available from the FreeBSD Ports Co
[[mplayer]]
=== MPlayer
-MPlayer is a multimedia player and encoder suite which runs on many platforms.
+MPlayer is a multimedia player and encoder suite which runs on many platforms and works on the command line.
It plays a terrific number of different file formats and codecs including popular DivX, XviD, H.264 streams as well as DVD and SVCDs along with many popular audio codecs.
To install MPlayer, execute:
@@ -417,7 +416,6 @@ To install MPlayer, execute:
# pkg install mplayer
....
-MPlayer is a video player that works on the command line.
For examples of how MPlayer works see man:mplayer[1].
[[smplayer]]
@@ -480,7 +478,7 @@ To install the required utilities, execute:
# pkg install webcamd pwcview
....
-Enable man:webcamd[8] service in `/etc/rc.conf` to start at system boot:
+Enable the man:webcamd[8] service in `/etc/rc.conf` to start it at system boot:
[source,shell]
....
@@ -495,14 +493,14 @@ To add the user to `webcamd` group execute the following command:
# pw groupmod webcamd -m username
....
-Since package:multimedia/webcamd[] needs the man:cuse[3] module this module must be loaded executing the following command:
+Since package:multimedia/webcamd[] needs the man:cuse[3] module this module must be loaded by executing the following command:
[source,shell]
....
# kldload cuse
....
-To load man:cuse[3] at system boot execute the command:
+To load man:cuse[3] at system boot, execute the command:
[source,shell]
....
@@ -534,11 +532,11 @@ Configure the available webcam executing the following command:
[NOTE]
====
-Note here that if this is a plug-and-play USB webcam, changing the USB port to which it is connected, will change the output from `webcamd -l`, hence the entry in rc.conf might need updating.
-For laptops (that use USB integrated webcams) this won't be an issue though.
+Note here that if this is a plug-and-play USB webcam, changing the USB port to which it is connected will change the output from `webcamd -l`, and the entry in rc.conf might need to be updated.
+For laptops that use USB integrated webcams, this should not be an issue.
====
-The man:webcamd[8] service must be started executing the following command:
+The man:webcamd[8] service must be started by executing the following command:
[source,shell]
....
@@ -553,13 +551,6 @@ Starting webcamd.
webcamd 1616 - - Attached to ugen0.2[0]
....
-To start webcamd automatically at system startup, execute the following command:
-
-[source,shell]
-....
-# sysrc webcamd_enable="YES"
-....
-
package:multimedia/pwcview[] can be used to check the proper functioning of the webcam.
The following command can be used to execute package:multimedia/pwcview[]:
@@ -575,7 +566,7 @@ image::pwcview.png[pwcview showing Absolute FreeBSD 3rd edition as an example]
[[meetings-software-status]]
=== Meetings software status
-FreeBSD currently supports the main tools used to carry out videoconferences.
+FreeBSD currently supports the following tools used to carry out videoconferences.
.Meeting software
[options="header", cols="1,1,1,1"]
@@ -617,7 +608,7 @@ In FreeBSD, access to image scanners is provided by link:http://www.sane-project
[[scanners-kernel-usb]]
=== Checking the Scanner
-Before making any configuration it is important to check the scanner is supported by SANE.
+Before attempting any configuration it is important to check the scanner is supported by SANE.
With the scanner connected, run the following command to get all connected USB devices:
@@ -644,7 +635,7 @@ Run the following command to obtain the `idVendor` and the `idProduct`:
[NOTE]
====
-Note here that the scanner is a plug-and-play device, changing the USB port to which it is connected, will change the output from `usbconfig list`.
+Note here that the scanner is a plug-and-play device, and changing the USB port to which it is connected will change the output from `usbconfig list`.
====
The output should be similar to the following: