From cc323e1079cde4aec22a6fc742df333a55fadbef Mon Sep 17 00:00:00 2001 From: "Justin C. Sherrill" Date: Fri, 11 Aug 2006 02:36:05 +0000 Subject: [PATCH] Update to match our use of pkgsrc instead of ports. From: "Victor Balada Diaz" --- en/books/handbook/multimedia/chapter.sgml | 181 +++++++++++++--------- share/sgml/dragonfly.ent | 4 +- 2 files changed, 111 insertions(+), 74 deletions(-) diff --git a/en/books/handbook/multimedia/chapter.sgml b/en/books/handbook/multimedia/chapter.sgml index 0b71395045..96c517f05d 100644 --- a/en/books/handbook/multimedia/chapter.sgml +++ b/en/books/handbook/multimedia/chapter.sgml @@ -2,7 +2,7 @@ The FreeBSD Documentation Project $FreeBSD: doc/en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml,v 1.81 2004/03/27 23:01:29 mheinen Exp $ - $DragonFly: doc/en/books/handbook/multimedia/chapter.sgml,v 1.7 2006/07/12 04:01:00 justin Exp $ + $DragonFly: doc/en/books/handbook/multimedia/chapter.sgml,v 1.8 2006/08/11 02:36:05 justin Exp $ --> @@ -24,7 +24,7 @@ to enjoy high fidelity output from your computer. This includes the ability to record and playback audio in the MPEG Audio Layer 3 (MP3), WAV, and Ogg Vorbis formats as well as many other - formats. The &pkgsrc; collection also contain applications + formats. The &pkgsrctree; also contain applications allowing you to edit your recorded audio, add sound effects, and control attached MIDI devices. @@ -33,11 +33,13 @@ to encode, convert, and playback various video media is more limited than the number of sound applications. For example as of this writing, there is no good re-encoding application in the - FreeBSD Ports Collection, which could be use to convert + &pkgsrctree;, which could be use to convert between formats, as there is with audio/sox. However, the software landscape in this area is changing rapidly. + + This chapter will describe the necessary steps to configure your sound card. The configuration and installation of X11 @@ -393,8 +395,7 @@ pcm0: <SB16 DSP 4.11> on sbc0 &prompt.user; cdcontrol -f /dev/acd0c play 1 Various applications, such as audio/workman offer a better - + role="package">audio/xmms offer a better interface. You may want to install an application such as audio/mpg123 to listen to MP3 audio files. @@ -494,11 +495,11 @@ pcm0: <SB16 DSP 4.11> on sbc0 virtual channels any devices which are attached later will be given. - If you are not using &man.devfs.5;, you will have to point - your applications at /dev/dsp0.x, where + As &os; doesn't support devfs you will have to point + your applications at + /dev/dsp0.x, where x is 0 to 3 if hw.snd.pcm.0.vchans is set - to 4 as in the above example. On a system using &man.devfs.5;, the above will automatically be - allocated transparently to the user. + to 4 as in the above example. @@ -533,8 +534,7 @@ pcm0: <SB16 DSP 4.11> on sbc0 support. XMMS can be installed from the - multimedia/xmms port or package. - + audio/xmms port or package. XMMS' interface is intuitive, with a playlist, graphic equalizer, and more. Those familiar @@ -579,7 +579,6 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo the sysutils/cdrtools suite, is used for ripping audio information from CDs and the information associated with them. - With the audio CD in the drive, the following command can be issued (as root) to rip an entire CD @@ -622,7 +621,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo Nowadays, the mp3 encoder of choice is lame. Lame can be found at - audio/lame in the pkgsrc and ports trees. + audio/lame in the &pkgsrctree;. Using the ripped WAV files, the following command will convert audio01.wav to @@ -972,7 +971,8 @@ no adaptors present low-level abstraction to the hardware which can sometimes be more efficient than the X11 interface. - The SDL can be found at devel/sdl12 (or pkgsrc/devel/SDL2). + The SDL can be found at + devel/SDL. @@ -1001,7 +1001,7 @@ no adaptors present video packages This section discusses the software available from the - &pkgsrc; collection which can be used for video playback. + &pkgsrctree; which can be used for video playback. Video playback is a very active area of software development, and the capabilities of various applications are bound to diverge somewhat from the descriptions given here. @@ -1070,7 +1070,7 @@ no adaptors present - Software not yet in the &pkgsrc; collection + Software not yet in the &pkgsrctree; which is commonly used in conjunction with the application. @@ -1105,41 +1105,73 @@ no adaptors present binary which will not be portable from one system to another. Therefore, it is important to build it from ports and not to use a binary package. Additionally, a - number of options can be specified in the make - command line, as described at the start of the build. - - - &prompt.root; cd /usr/ports/multimedia/mplayer -&prompt.root; make -You can enable additional compilation optimizations -by defining WITH_OPTIMIZED_CFLAGS -You can enable GTK GUI by defining WITH_GUI. -You can enable DVD support by defining WITH_DVD. -You can enable SVGALIB support by defining WITH_SVGALIB. -You can enable VORBIS sound support by defining WITH_VORBIS. -You can enable XAnim DLL support by defining WITH_XANIM. + number of options can be specified in the bmake + command line, as described in the + bmake show-options. + + &prompt.root; cd /usr/pkgsrc/multimedia/mplayer +&prompt.root; bmake show-options +Any of the following general options may be selected: + aalib Enable aalib support. + arts Use the aRts audio daemon. + dts Enable DTS Coherent Acoustics support. + dv Enable usage of the libdv library. + dvdread Enable reproduction of DVDs. + esound Enable support for the Enlightment Sound Daemon. + ggi Enable GGI support. + gif Enable GIF support. + jpeg Enable JPEG support. + mad Enable usage of the mad library to play MP3 files. + mplayer-menu Enable support for user-defined menus. + mplayer-real Enable usage of Real codecs. + mplayer-runtime-cpudetection Enable CPU detection at run time. + mplayer-win32 Enable usage of Win32 DLLs (codecs). + nas Enable usage of the Network Audio System. + oss Enable support for the Open Sound System audio library. + png Enable PNG support. + sdl Use SDL as display library. + theora Use the theora codecs. + vorbis Enable Ogg Vorbis support. + xvid Enable usage of XVid codecs. +At most one of the following faadgroup options may be selected: + faad Enable AAC decoding support using faad2. + mplayer-internal-faad + +These options are enabled by default: + aalib arts dv dvdread esound faad gif jpeg + mad mplayer-menu mplayer-real mplayer-runtime-cpudetection + mplayer-win32 nas oss png sdl theora vorbis + xvid + +These options are currently enabled: + aalib arts dv dvdread esound faad gif jpeg + mad mplayer-menu mplayer-real mplayer-runtime-cpudetection + mplayer-win32 nas oss png sdl theora vorbis + xvid + +You can select which build options to use by setting PKG_DEFAULT_OPTIONS +or PKG_OPTIONS.mplayer. - If you have x11-toolkits/gtk12 installed, then + role="package">x11/gtk installed, then you might as well enable the GUI. Otherwise, it is not - worth the effort. If you intend to play (possibly CSS - encoded) DVD's with MPlayer you must enable the DVD support - option here Unauthorized DVD playback is a + worth the effort. If it is illegal to play (possibly CSS + encoded) DVD's with MPlayer on your + country you must disable the DVD support + optionUnauthorized DVD playback is a serious criminal act in some countries. Check local laws - before enabling this option. . Some - reasonable options are: + before enabling this option. . Otherwise + the defaults are ok: - &prompt.root; make WITH_DVD=yes WITH_SVGALIB=yes + &prompt.root; bmake As of this writing, the MPlayer port will build its HTML documentation and one executable, - mplayer. It can also be made to build an + mplayer. By default it builds an encoder, mencoder, which is a tool for re-encoding video. A modification to the - Makefile can enable it. It may be - enabled by default in subsequent versions of the port. + Makefile can disable it. The HTML documentation for MPlayer is very informative. If the reader finds the information on video hardware and @@ -1156,13 +1188,16 @@ You can enable XAnim DLL support by defining WITH_XANIM. MPlayer use - Any user of MPlayer must set up a - .mplayer subdirectory of her - home directory. To create this necessary subdirectory, - you can type the following: + + -&prompt.user; cd /usr/ports/multimedia/mplayer -&prompt.user; make install-user + + + + + + + The command options for mplayer are listed in the manual page. For even more detail there is HTML @@ -1227,7 +1262,7 @@ zoom=yes mencoder - If you opt to install mencoder when + If you installed mencoder when you build MPlayer, be forewarned that it is still an experimental component. Before using mencoder it is a good idea to @@ -1273,7 +1308,7 @@ zoom=yes all in one video solution, but also in producing a reusable base library and a modular executable which can be extended with plugins. It comes both as a package and as a port, multimedia/xine. + role="package">multimedia/xine-ui. The xine player is still very rough around the edges, but it is clearly off to a @@ -1284,8 +1319,8 @@ zoom=yes As of this writing, there is no input module shipped with xine which will play CSS encoded DVD's. There are third party builds which do have modules for this built in them, but none - of these are in the FreeBSD Ports Collection. - + of these are in the &pkgsrctree;. + Compared to MPlayer, xine does more for the user, but at the same time, takes some of the more fine-grained control away from @@ -1315,20 +1350,21 @@ zoom=yes interfaces. Like MPlayer, transcode is very experimental software which - must be build from ports or &pkgsrc; at multimedia/transcode. Using a great - many options to the make command. I - recommend: + must be build from &pkgsrc; at multimedia/transcode. You can + see all the available options with the + bmake show-options command. I + recommend the default ones. - &prompt.root; make WITH_LIBMPEG2=yes + &prompt.root; bmake - - If you plan to install multimedia/avifile, then add the - WITH_AVIFILE option to your - make command line, as shown here: + + + + + - &prompt.root; make WITH_AVIFILE=yes WITH_LIBMPEG2=yes + Here are two examples of using transcode for video conversion which produce rescaled output. The first @@ -1394,8 +1430,9 @@ zoom=yes Avifile which - is also a port multimedia/avifile. + is not yet in the official &pkgsrctree;, but you can + find it on pkgsrc-wip. @@ -1531,24 +1568,22 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner. fxtv. - misc/alevt - (or pkgsrc/multimedia/alevt) decodes - and displays Videotext/Teletext. + multimedia/alevt + decodes and displays Videotext/Teletext. audio/xmradio, an application to use the FM radio tuner coming with some TV cards. - - audio/wmtune, a handy - desktop application for radio tuners. + + + - + - More applications are available in the &pkgsrc; and FreeBSD Ports - collections. + More applications are available in the &pkgsrctree;. @@ -1559,7 +1594,7 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner. really supported by the &man.bktr.4; driver and if you used the right configuration options. For more support and various questions about your TV card you may want to contact and use the - archives of the &a.freebsd.multimedia.name; mailing list. + archives of the &a.users;. diff --git a/share/sgml/dragonfly.ent b/share/sgml/dragonfly.ent index 2cb225091c..f20def2bd8 100644 --- a/share/sgml/dragonfly.ent +++ b/share/sgml/dragonfly.ent @@ -2,7 +2,7 @@ DragonFlyBSD specific DocBook Entities $FreeBSD: doc/share/sgml/freebsd.ent,v 1.50 2004/02/26 05:36:30 bmah Exp $ -$DragonFly: doc/share/sgml/dragonfly.ent,v 1.6 2006/07/12 12:36:10 justin Exp $ +$DragonFly: doc/share/sgml/dragonfly.ent,v 1.7 2006/08/11 02:36:05 justin Exp $ --> + + -- 2.41.0