multimedia.diff

victor, 08/10/2006 05:22 PM

Download (17.1 KB)

View differences:

chapter.sgml 10 Aug 2006 17:01:31 -0000
24 24
      to enjoy high fidelity output from your computer.  This includes
25 25
      the ability to record and playback audio in the MPEG Audio Layer
26 26
      3 (MP3), WAV, and Ogg Vorbis formats as well as many other
27
      formats.  The &pkgsrc; collection also contain applications
27
      formats.  The &pkgsrctree; also contain applications
28 28
      allowing you to edit your recorded audio, add sound effects, and
29 29
      control attached MIDI devices.</para>
30 30

  
......
33 33
      to encode, convert, and playback various video media is more
34 34
      limited than the number of sound applications.  For example as
35 35
      of this writing, there is no good re-encoding application in the
36
      FreeBSD Ports Collection, which could be use to convert
36
      &pkgsrctree;, which could be use to convert
37 37
      between formats, as there is with <filename
38 38
      role="package">audio/sox</filename>.  However, the software
39 39
      landscape in this area is changing rapidly.</para>
40 40
      <!-- todo: reed: is the above "no good re-encoding" true? -->
41
      <!-- I don't think so, you can reeconde with mencoder, but it -->
42
      <!-- may not be 'user friendly' -->
41 43

  
42 44
    <para>This chapter will describe the necessary steps to configure
43 45
      your sound card.  The configuration and installation of X11
......
393 395
      <screen>&prompt.user; <userinput>cdcontrol -f /dev/acd0c play 1</userinput></screen>
394 396

  
395 397
    <para>Various applications, such as <filename
396
      role="package">audio/workman</filename> offer a better
397
      <!-- todo: reed: not in pkgsrc -->
398
      role="package">audio/xmms</filename> offer a better
398 399
      interface.  You may want to install an application such as
399 400
      <filename role="package">audio/mpg123</filename> to listen to
400 401
      MP3 audio files.</para>
......
494 495
      virtual channels any devices which are attached later will be
495 496
      given.</para>
496 497

  
497
    <para>If you are not using &man.devfs.5;, you will have to point
498
      your applications at <devicename>/dev/dsp0</devicename>.<replaceable>x</replaceable>, where
498
    <para>As &os; doesn't support devfs you will have to point
499
      your applications at
500
      <devicename>/dev/dsp0</devicename>.<replaceable>x</replaceable>, where
499 501
      <replaceable>x</replaceable> is 0 to 3 if <varname>hw.snd.pcm.0.vchans</varname> is set
500
      to 4 as in the above example.  On a system using &man.devfs.5;, the above will automatically be
501
      allocated transparently to the user.</para>
502
      to 4 as in the above example.</para>
502 503
   </sect2>
503 504
  </sect1>
504 505

  
......
533 534
	support.</para>
534 535

  
535 536
      <para><application>XMMS</application> can be installed from the
536
	<filename role="package">multimedia/xmms</filename> port or package.</para>
537
	<!-- todo: reed: under audio category for pkgsrc -->
537
	<filename role="package">audio/xmms</filename> port or package.</para>
538 538

  
539 539
      <para><application>XMMS'</application> interface is intuitive,
540 540
	with a playlist, graphic equalizer, and more.  Those familiar
......
579 579
	the <filename role="package">sysutils/cdrtools</filename>
580 580
	suite, is used for ripping audio information from CDs and the
581 581
	information associated with them.</para>
582
	<!-- todo: reed: pkgsrc is still called sysutils/cdrecord -->
583 582

  
584 583
      <para>With the audio CD in the drive, the following command can
585 584
	be issued (as <username>root</username>) to rip an entire CD
......
622 621
      <para>Nowadays, the mp3 encoder of choice is
623 622
	<application>lame</application>.
624 623
	<application>Lame</application> can be found at
625
	<filename role="package">audio/lame</filename> in the pkgsrc and ports trees.</para>
624
	<filename role="package">audio/lame</filename> in the &pkgsrctree;.</para>
626 625

  
627 626
      <para>Using the ripped WAV files, the following command will
628 627
	convert <filename>audio01.wav</filename> to
......
972 971
      low-level abstraction to the hardware which can sometimes be
973 972
      more efficient than the X11 interface.</para>
974 973

  
975
    <para>The SDL can be found at <filename role="package">devel/sdl12</filename> (or <filename role="package">pkgsrc/devel/SDL2</filename>).</para>
974
    <para>The SDL can be found at
975
      <filename role="package">devel/SDL</filename>.</para>
976 976

  
977 977
    </sect3>
978 978

  
......
1001 1001
    <indexterm><primary>video packages</primary></indexterm>
1002 1002

  
1003 1003
    <para>This section discusses the software available from the
1004
      &pkgsrc; collection which can be used for video playback.
1004
      &pkgsrctree; which can be used for video playback.
1005 1005
      Video playback is a very active area of software development,
1006 1006
      and the capabilities of various applications are bound to
1007 1007
      diverge somewhat from the descriptions given here.</para>
......
1070 1070
      </listitem>
1071 1071

  
1072 1072
      <listitem>
1073
        <para>Software not yet in the &pkgsrc; collection
1073
        <para>Software not yet in the &pkgsrctree; 
1074 1074
	  which is commonly used in conjunction with the application.</para>
1075 1075
      </listitem>
1076 1076

  
......
1105 1105
	  binary which will not be portable from one system to
1106 1106
	  another.  Therefore, it is important to build it from
1107 1107
	  ports and not to use a binary package.  Additionally, a
1108
	  number of options can be specified in the <command>make</command>
1109
	  command line, as described at the start of the build.</para>
1110
	  <!-- todo: reed: mention pkgsrc here too -->
1111

  
1112
	<screen>&prompt.root; <userinput>cd /usr/ports/multimedia/mplayer</userinput>
1113
&prompt.root; <userinput>make</userinput>
1114
You can enable additional compilation optimizations
1115
by defining WITH_OPTIMIZED_CFLAGS
1116
You can enable GTK GUI by defining WITH_GUI.
1117
You can enable DVD support by defining WITH_DVD.
1118
You can enable SVGALIB support by defining WITH_SVGALIB.
1119
You can enable VORBIS sound support by defining WITH_VORBIS.
1120
You can enable XAnim DLL support by defining WITH_XANIM.
1108
	  number of options can be specified in the <command>bmake</command>
1109
	  command line, as described in the
1110
	  <command>bmake show-options</command>.</para>
1111

  
1112
	<screen>&prompt.root; <userinput>cd /usr/pkgsrc/multimedia/mplayer</userinput>
1113
&prompt.root; <userinput>bmake show-options</userinput>
1114
Any of the following general options may be selected:
1115
        aalib    Enable aalib support.
1116
        arts     Use the aRts audio daemon.
1117
        dts      Enable DTS Coherent Acoustics support.
1118
        dv       Enable usage of the libdv library.
1119
        dvdread  Enable reproduction of DVDs.
1120
        esound   Enable support for the Enlightment Sound Daemon.
1121
        ggi      Enable GGI support.
1122
        gif      Enable GIF support.
1123
        jpeg     Enable JPEG support.
1124
        mad      Enable usage of the mad library to play MP3 files.
1125
        mplayer-menu     Enable support for user-defined menus.
1126
        mplayer-real     Enable usage of Real codecs.
1127
        mplayer-runtime-cpudetection    Enable CPU detection at run time.
1128
        mplayer-win32    Enable usage of Win32 DLLs (codecs).
1129
        nas      Enable usage of the Network Audio System.
1130
        oss      Enable support for the Open Sound System audio library.
1131
        png      Enable PNG support.
1132
        sdl      Use SDL as display library.
1133
        theora   Use the theora codecs.
1134
        vorbis   Enable Ogg Vorbis support.
1135
        xvid     Enable usage of XVid codecs.
1136
At most one of the following faadgroup options may be selected:
1137
        faad     Enable AAC decoding support using faad2.
1138
        mplayer-internal-faad
1139

  
1140
These options are enabled by default:
1141
        aalib arts dv dvdread esound faad gif jpeg
1142
        mad mplayer-menu mplayer-real mplayer-runtime-cpudetection
1143
        mplayer-win32 nas oss png sdl theora vorbis
1144
        xvid
1145

  
1146
These options are currently enabled:
1147
        aalib arts dv dvdread esound faad gif jpeg
1148
        mad mplayer-menu mplayer-real mplayer-runtime-cpudetection
1149
        mplayer-win32 nas oss png sdl theora vorbis
1150
        xvid
1151

  
1152
You can select which build options to use by setting PKG_DEFAULT_OPTIONS
1153
or PKG_OPTIONS.mplayer.
1121 1154
</screen>
1122 1155

  
1123
	<!-- todo: reed: this is ports specific, could add pkgsrc notes -->
1124 1156
        <para>If you have <filename
1125
          role="package">x11-toolkits/gtk12</filename> installed, then
1157
          role="package">x11/gtk</filename> installed, then
1126 1158
          you might as well enable the GUI.  Otherwise, it is not
1127
          worth the effort.  If you intend to play (possibly CSS
1128
          encoded) DVD's with <application>MPlayer</application> you must enable the DVD support
1129
          option here <footnote><para>Unauthorized DVD playback is a
1159
          worth the effort.  If it is illegal to play (possibly CSS
1160
          encoded) DVD's with <application>MPlayer</application> on your
1161
	  country you must disable the DVD support
1162
          option<footnote><para>Unauthorized DVD playback is a
1130 1163
          serious criminal act in some countries.  Check local laws
1131
          before enabling this option.</para> </footnote>.  Some
1132
          reasonable options are:</para>
1164
          before enabling this option.</para> </footnote>.  Otherwise
1165
	  the defaults are ok:</para>
1133 1166

  
1134
        <screen>&prompt.root; <userinput>make WITH_DVD=yes WITH_SVGALIB=yes</userinput></screen>
1167
        <screen>&prompt.root; <userinput>bmake</userinput></screen>
1135 1168

  
1136 1169
        <para>As of this writing, the <application>MPlayer</application> port will build its HTML
1137 1170
          documentation and one executable,
1138
          <command>mplayer</command>.  It can also be made to build an
1171
          <command>mplayer</command>.  By default it builds an
1139 1172
          encoder, <command>mencoder</command>, which is a tool for
1140 1173
          re-encoding video.  A modification to the
1141
          <filename>Makefile</filename> can enable it.  It may be
1142
          enabled by default in subsequent versions of the port.</para>
1174
          <filename>Makefile</filename> can disable it.</para>
1143 1175

  
1144 1176
        <para>The HTML documentation for <application>MPlayer</application> is very informative.
1145 1177
          If the reader finds the information on video hardware and
......
1156 1188
        <indexterm><primary>MPlayer</primary>
1157 1189
	           <secondary>use</secondary></indexterm>
1158 1190

  
1159
        <para>Any user of <application>MPlayer</application> must set up a
1160
          <filename>.mplayer</filename> subdirectory of her
1161
          home directory.  To create this necessary subdirectory,
1162
	  you can type the following:</para>
1191
<!--      I'm sure that this must be wrong, but i don't know how to install -->
1192
<!--      the user dir on DragonFly. Maybe copying from some examples dir? -->
1193

  
1194
<!--         <para>Any user of <application>MPlayer</application> must set up a -->
1195
<!--           <filename>.mplayer</filename> subdirectory of her -->
1196
<!--           home directory.  To create this necessary subdirectory, -->
1197
<!-- 	  you can type the following:</para> -->
1163 1198

  
1164
<screen>&prompt.user; <userinput>cd /usr/ports/multimedia/mplayer</userinput>
1165
&prompt.user; <userinput>make install-user</userinput></screen>
1199
<!-- <screen>&prompt.user; <userinput>cd /usr/ports/multimedia/mplayer</userinput> -->
1200
<!-- &prompt.user; <userinput>make install-user</userinput></screen> -->
1166 1201

  
1167 1202
	<para>The command options for <command>mplayer</command> are
1168 1203
	  listed in the manual page.  For even more detail there is HTML
......
1227 1262
	  <primary>mencoder</primary>
1228 1263
	</indexterm>
1229 1264

  
1230
	<para>If you opt to install <command>mencoder</command> when
1265
	<para>If you installed <command>mencoder</command> when
1231 1266
	 you build <application>MPlayer</application>, be forewarned
1232 1267
	 that it is still an experimental component.  Before using 
1233 1268
         <command>mencoder</command> it is a good idea to
......
1273 1308
     all in one video solution, but also in producing a reusable base
1274 1309
     library and a modular executable which can be extended with
1275 1310
     plugins.  It comes both as a package and as a port, <filename
1276
     role="package">multimedia/xine</filename>.</para>
1311
     role="package">multimedia/xine-ui</filename>.</para>
1277 1312

  
1278 1313
    <para>The <application>xine</application> player
1279 1314
     is still very rough around the edges, but it is clearly off to a
......
1284 1319
    <para>As of this writing, there is no input module shipped with
1285 1320
     <application>xine</application> which will play CSS encoded DVD's.  There are third party
1286 1321
     builds which do have modules for this built in them, but none
1287
     of these are in the FreeBSD Ports Collection.</para>
1288
     <!-- todo: reed: what about pkgsrc? -->
1322
     of these are in the &pkgsrctree;.</para>
1323
     <!-- i don't think that this still applies... -->
1289 1324

  
1290 1325
    <para>Compared to <application>MPlayer</application>, <application>xine</application> does more for the user, but at the
1291 1326
      same time, takes some of the more fine-grained control away from
......
1315 1350
      interfaces.</para>
1316 1351

  
1317 1352
    <para>Like <application>MPlayer</application>, <application>transcode</application> is very experimental software which
1318
      must be build from ports or &pkgsrc; at <filename
1319
      role="package">multimedia/transcode</filename>.  Using a great
1320
      many options to the <command>make</command> command.  I
1321
      recommend:</para>
1322

  
1323
      <screen>&prompt.root; <userinput>make WITH_LIBMPEG2=yes</userinput></screen>
1324

  
1325
    <!-- todo: reed: ports specific, add pkgsrc notes? -->
1326
    <para>If you plan to install <filename
1327
      role="package">multimedia/avifile</filename>, then add the
1328
      <literal>WITH_AVIFILE</literal> option to your
1329
      <command>make</command> command line, as shown here:</para>
1353
      must be build from &pkgsrc; at <filename
1354
      role="package">multimedia/transcode</filename>.  You can
1355
      see all the available options with the
1356
      <command>bmake show-options</command> command.  I
1357
      recommend the default ones.</para>
1358

  
1359
      <screen>&prompt.root; <userinput>bmake</userinput></screen>
1360

  
1361
<!-- seems that pkgsrc doesn't have a flavor/option for this -->
1362
<!--     <para>If you plan to install <filename -->
1363
<!--       role="package">multimedia/avifile</filename>, then add the -->
1364
<!--       <literal>WITH_AVIFILE</literal> option to your -->
1365
<!--       <command>make</command> command line, as shown here:</para> -->
1330 1366

  
1331
      <screen>&prompt.root; <userinput>make WITH_AVIFILE=yes WITH_LIBMPEG2=yes</userinput></screen>
1367
<!--       <screen>&prompt.root; <userinput>make WITH_AVIFILE=yes WITH_LIBMPEG2=yes</userinput></screen> -->
1332 1368

  
1333 1369
    <para>Here are two examples of using <command>transcode</command>
1334 1370
      for video conversion which produce rescaled output.  The first
......
1394 1430
       <listitem>
1395 1431
         <para><ulink
1396 1432
	   url="http://avifile.sourceforge.net/">Avifile</ulink> which
1397
	   is also a port <filename
1398
	   role='package'>multimedia/avifile</filename>.</para>
1433
	   is not yet in the official &pkgsrctree;, but you can
1434
	   find it on <ulink
1435
	   url="http://pkgsrc-wip.sourceforge.net/">pkgsrc-wip</ulink>.</para>
1399 1436
       </listitem>
1400 1437
       <!-- todo: reed: in pkgsrc-wip currently -->
1401 1438

  
......
1531 1568
	    <application>fxtv</application>.</para>
1532 1569
	</listitem>
1533 1570
	<listitem>
1534
	  <para><filename role="package">misc/alevt</filename>
1535
	    (or <filename role="package">pkgsrc/multimedia/alevt</filename>) decodes
1536
	    and displays Videotext/Teletext.</para>
1571
	  <para><filename role="package">multimedia/alevt</filename>
1572
	    decodes and displays Videotext/Teletext.</para>
1537 1573
	</listitem>
1538 1574
	<listitem>
1539 1575
	  <para><filename role="package">audio/xmradio</filename>, an
1540 1576
	    application to use the FM radio tuner coming with some
1541 1577
	    TV cards.</para>
1542 1578
	</listitem>
1543
	<listitem>
1544
	  <para><filename role="package">audio/wmtune</filename>, a handy
1545
	    desktop application for radio tuners.</para>
1579
<!-- 	<listitem> -->
1580
<!-- 	  <para><filename role="package">audio/wmtune</filename>, a handy -->
1581
<!-- 	    desktop application for radio tuners.</para> -->
1546 1582
	    <!-- todo: reed: not in pkgsrc? -->
1547
	</listitem>
1583
<!-- 	</listitem> -->
1548 1584
      </itemizedlist>
1549 1585

  
1550
      <para>More applications are available in the &pkgsrc; and FreeBSD Ports
1551
	collections.</para>
1586
      <para>More applications are available in the &pkgsrctree;.</para>
1552 1587
    </sect2>
1553 1588

  
1554 1589
    <sect2>
......
1559 1594
	really supported by the &man.bktr.4; driver and if you used the right
1560 1595
	configuration options.  For more support and various questions
1561 1596
	about your TV card you may want to contact and use the
1562
	archives of the &a.freebsd.multimedia.name; mailing list.</para>
1597
	archives of the &a.users;.</para>
1563 1598
    </sect2>
1564 1599
  </sect1>
1565 1600
</chapter>
dragonfly.ent 10 Aug 2006 17:03:48 -0000
47 47
<!ENTITY gui.cancel "<guibutton>[&nbsp;Cancel&nbsp;]</guibutton>">
48 48

  
49 49
<!-- Pkgsrc Section -->
50
<!-- name for pkgsrc: pkgsrc collection? pkgsrc tree? pkgsrc framework? -->
51
<!ENTITY pkgsrctree "&pkgsrc; tree">
50 52

  
51 53
<!-- Number of packages in the NetBSD ports tree -->
52 54
<!ENTITY os.numpackages "6,000">