From nobody Mon Apr 10 10:01:52 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Pw4JK2GYwz453Y1 for ; Mon, 10 Apr 2023 10:01:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Pw4JK1Wzrz3pnK; Mon, 10 Apr 2023 10:01:53 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1681120913; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=vAecNVi1ZJ6q378CoqUALnEbIVzextnhVhn+0/QMrxM=; b=sI17f9j0XUpEOhTST1Rm9oU81a09ppqmunMuWq1/faOqqxJW/PgaskYR37MBge/CXpk/pp bm2FsbAzzrgMZekZdV9I6j8A2yOvTVmp6rF8IetCjFljToInOy498N8eYYFUYIRDxma6F0 bD+9nJAG/6Es+NXK77n+uw3wxjBqPjJS81YRu1ggGr455VCp0MkToVdabacGFD6J9JqFXF HpLoZhoQyahsuEV/va6sN1HkTJsvWCqAJaXDfp2Me60KG9X+zGnk8g/WpAhjsxCdsA8rCT nOroigIB6pj4sXeumOGsevVmg16c7st46ZGitGC8bc30Na5XFNU3mpFweWY+Ig== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1681120913; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=vAecNVi1ZJ6q378CoqUALnEbIVzextnhVhn+0/QMrxM=; b=UpLbKXXDwdDEP2CYcTZHk6yJI93D7+j36XJ+TKbT5cMLK7kOcdP9iyJ2TOSrw8mQL+yQ7k Ss9ulf5fGo/yNn10MmlCGhAN0EZE+gwlVO5/qjRN9acZ1vcsrqneKO+lRHaVxQKKSEls0q K2cf6hPyqDuUK0E5/8yi4SXp5mK8tv962bhzf0NjW5VUmialNLipvGv4jXSQoL6Zh/C6k+ pSKtqoA7oH5GVpBXKl1xXbvwoz81G/Mn+C0E37NFOmBdI8RkHV6jXDojACTIf5jfGh8DtS s4Lteme1SXwU8MHbPZpXIYtoc/stngxVpC85oWnP85NJaz63/ATcwdJWL5lNsQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1681120913; a=rsa-sha256; cv=none; b=hPWd7Ysu7XOL54pAud71vX1VKVk1Bb5ecnoC4mmIT06OP4RzwRYAARqx2WP5zdUUDVWz2d hjHyOY+9hPfKMJ4w+Dk/6TZr2sg/ec0vutxAad4ovbtNjcEB9gPaFSOgurbbWkfv//pPMx KewGoNSn+3I/20lx3TG2PtTmGRRUqcqLej787FV3hOhfVuumvvnk/RMatQJzTWHOv3yUhe oEYcAJuyHb9wYxZxD+L9sB4XGjTL4UHMuy9X8lBLoI4W5zFUVsTaA3iycQ/iUsWsMWMCBO +LyO50wPxgB7CoHfJevuroDZy/5+bLTNPvVDdIiIdOxo0RARBLGwRXs42j58Fg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Pw4JK0Zc4zlyb; Mon, 10 Apr 2023 10:01:53 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 33AA1qIq015825; Mon, 10 Apr 2023 10:01:52 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 33AA1qt0015816; Mon, 10 Apr 2023 10:01:52 GMT (envelope-from git) Date: Mon, 10 Apr 2023 10:01:52 GMT Message-Id: <202304101001.33AA1qt0015816@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Ceri Davies Subject: git: 3f6c35289e - main - handbook/multimedia: minor improvements for clarity post fcbb060fe7 List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ceri X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 3f6c35289ebf2c261e69657de6e1cb73de28bf73 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by ceri: URL: https://cgit.FreeBSD.org/doc/commit/?id=3f6c35289ebf2c261e69657de6e1cb73de28bf73 commit 3f6c35289ebf2c261e69657de6e1cb73de28bf73 Author: Ceri Davies AuthorDate: 2023-04-10 10:01:25 +0000 Commit: Ceri Davies 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: at cad 2 nid 1 on hdac1 pcm7: 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: