Skunkware 5

home *** CD-ROM | disk | FTP | other *** search

/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / xmcd.1 < prev next >

Wrap

Text File | 1995-07-26 | 21.5 KB | 463 lines

XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) NNNNAAAAMMMMEEEE xmcd - CD digital audio player utility for X11/Motif SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS xxxxmmmmccccdddd [_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [-_d_e_v _d_e_v_i_c_e] [-_d_b_d_i_r _p_a_t_h] [- _d_e_b_u_g] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _X_m_c_d is a program that allows the use of the CD-ROM drive as a full-featured stereo compact-disc player for the X window system. Most of the features found on real CD players are available in _x_m_c_d, such as shuffle and repeat, track programming functions, and a numeric keypad for direct track access. Additional functions include sample play, A to B segment play, volume control, etc. A built-in CD database feature allows the CD artist/title and track titles, and other associated general purpose text to be maintained and loaded as the program is started or when a CD is inserted. Full feature-specific pop-up help is available for all controls, indicators, text input fields, and lists. On systems with more than one CD-ROM drive, multiple invocations of _x_m_c_d can be used to operate each drive independently. _X_m_c_d is designed to be easy to use, as the main window is purposely made to resemble a real CD player front panel. All other pop-up windows are also designed to be as intuitive as possible. Moreover, while the use of a mouse is natural with _x_m_c_d, all functionality can also be operated via the keyboard. This is in conformance to the guidelines published in the _O_S_F/_M_o_t_i_f _S_t_y_l_e _G_u_i_d_e from the Open Software Foundation. The internal architecture of _x_m_c_d is designed from the start to be easily portable to many operating system platforms, and adaptable to the myriad of CD-ROM drives available. OOOOPPPPTTTTIIIIOOOONNNNSSSS All standard _X_t _I_n_t_r_i_n_s_i_c_s toolkit options are supported. In addition, _x_m_c_d supports the following options: -_d_e_v _d_e_v_i_c_e Specifies the path name to the raw CD-ROM device. If Page 1 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) this option is not used, the default device to be used is the first drive set up with the _x_m_c_d configuration program (See below). -_d_b_d_i_r _l_i_s_t Specifies a colon-separated list of category directories where the CD database files are to be kept. See the description for XXXXMMMMCCCCDDDD____DDDDBBBBPPPPAAAATTTTHHHH in the ENVIRONMENT section below. -_d_e_b_u_g Causes verbose debugging diagnostics to be printed on _s_t_d_e_r_r. XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS _X_m_c_d has many adjustable X resources to customize its look and feel, as well as its behavior. Notably, the colors of virtually every feature on _x_m_c_d's windows can be changed, as well as the text fonts. All text labels can also be changed (for example, to another language). There are too many resources to list here, but the resource names and their defaults (plus descriptive comments) can be found in the LLLLIIIIBBBBDDDDIIIIRRRR/_a_p_p-_d_e_f_a_u_l_t_s/_X_M_c_d file (where LIBDIR is typically /_u_s_r/_l_i_b/_X_1_1). It is not recommended that you change values in the LLLLIIIIBBBBDDDDIIIIRRRR/_a_p_p-_d_e_f_a_u_l_t_s/_X_M_c_d file, unless you want the changes to be forced upon all users of _x_m_c_d on the system. Instead, make a copy of this file, change the copy as you see fit, then place it in your home directory. Your custom resource settings will then override the defaults when _x_m_c_d is subsequently started. Alternatively, you may also place specific resources you wish to override in the ._X_d_e_f_a_u_l_t_s file in your home directory. DDDDEEEEVVVVIIIICCCCEEEE CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN The X resources described in the previous section affect the general appearance and behavior of _x_m_c_d. There are additional configurable parameters that must vary on a per- drive basis. For example, in some cases _x_m_c_d must operate the drive differently depending upon the brand and model of the drive. Thus, there must be a separate configuration file for these parameters _p_e_r-_d_e_v_i_c_e. The default file is XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/DDDDEEEEVVVVIIIICCCCEEEE (where XMCDLIB is typically /_u_s_r/_l_i_b/_X_1_1/_x_m_c_d and DEVICE is the base name of the raw device special file for the CD-ROM drive ; e.g., /_u_s_r/_l_i_b/_X_1_1/_x_m_c_d/_c_o_n_f_i_g/_r_c_d_0). A configuration program XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/_c_o_n_f_i_g_u_r_e._s_h is provided to make maintaining the device-specific configuration file easy (Note: on SCO systems the configuration program can also be invoked as "_m_k_d_e_v _x_m_c_d"). Page 2 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) You should always use the configuration program to set the device-specific parameters when installing _x_m_c_d for the first time, or when the CD-ROM hardware configuration has changed. If this is not done then _x_m_c_d will probably not operate correctly with your CD-ROM drive. WWWWAAAARRRRNNNNIIIINNNNGGGG:::: If _x_m_c_d is not correctly configured, you may cause _x_m_c_d to deliver commands that are not supported by your CD- ROM drive. Under some environments this may lead to system hang or crash. You can override some of the device-specific configuration parameters by adding your own configuration files. _X_m_c_d will also look in HHHHOOOOMMMMEEEE/._x_m_c_d_c_f_g/DDDDEEEEVVVVIIIICCCCEEEE file for device- specific parameters (where HOME is your home directory and DEVICE is as specified above). Parameters found in this file will override the system defaults (except those parameters that cannot be overridden; see the comments in the XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_o_n_f_i_g/_d_e_v._c_o_n_f_i_g for details). UUUUSSSSIIIINNNNGGGG XXXXMMMMCCCCDDDD The basic functions of _x_m_c_d are designed to operate the same way as on a real stereo CD player. The pictorial symbols used on the main window buttons are intended to illustrate the function in a non-language-specific manner. You can also change all main window buttons to display a text label instead of the pictorial symbols, by clicking the ddddiiiissssppppllllaaaayyyy check-box button (the "A" symbol enclosed in a box) located at the upper left hand corner of the main window. The CD database and track programming functions are operated via the CD Database/Track Program Editor pop-up subwindow. You activate the subwindow by pressing the ccccddddddddbbbb////pppprrrroooogggg button (file cabinet symbol) on the main window (See "CD DATABASE" below). There will not be a per-item description of all the features, because full on-line help is available (See "ONLINE HELP" below). OOOONNNNLLLLIIIINNNNEEEE HHHHEEEELLLLPPPP For general information about _x_m_c_d, click the hhhheeeellllpppp (question mark symbol) button on the _x_m_c_d main window. You can also get specific help information about each button, control, indicator, text entry area, selection list by positioning the mouse cursor over the desired item, then clicking the third mouse button. A pop-up window will appear, containing the relevant help text. Page 3 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) TTTTRRRRAAAACCCCKKKK PPPPRRRROOOOGGGGRRRRAAAAMMMMMMMMIIIINNNNGGGG You can program _x_m_c_d to play only certain tracks, in a custom sequence. To do so, invoke the CD Database window (by pressing the ccccddddddddbbbb////pppprrrroooogggg button on the main window). Select the desired track by clicking on the entry in the TTTTrrrraaaacccckkkk lllliiiisssstttt,,,, and click the AAAAdddddddd button to add to the play sequence. Notice that the track number appears in the PPPPllllaaaayyyy sssseeeeqqqquuuueeeennnncccceeee text field. You can also type the track numbers, separated with commas, directly in the PPPPllllaaaayyyy sssseeeeqqqquuuueeeennnncccceeee field. Repeat until all desired tracks have been entered, then press the Track Program PPPPllllaaaayyyy button in the CD Database window (not the PPPPllllaaaayyyy////PPPPaaaauuuusssseeee button on the main window) to start the program play. During program play, the pppprrrroooogggg indicator in the main window display area "illuminates". CCCCDDDD DDDDAAAATTTTAAAABBBBAAAASSSSEEEE The CD Database feature of _x_m_c_d allows you to enter the CD artist/title, track titles, other free-form text (such as band information, lyrics, etc.) associated with the disc and tracks, and a track play program. After this information is typed in and saved to a database file, it will automatically appear on the _x_m_c_d CD Database window when the same CD is inserted again. You must perform a "save" operation (press the SSSSaaaavvvveeee button) after typing in the database information before ejecting the CD or exiting, or the information will be lost. If this is the first time this CD database entry is being stored, you will be asked to select a category (rock, classical, jazz, etc.) under which to classify the CD. The category is used by _x_m_c_d to determine the actual directory in the filesystem to write the database file. Once the database information has been saved, the ccccddddddddbbbb indicator on the _x_m_c_d main window display area "illuminates". You must type the CD information into the database because the CD's table of contents (TOC) contains only the number of tracks and the starting address of each track, but not the actual disc and track titles. The CD database window should prove to be intuitive to use. You may use the on-line help system to obtain specific help information about the various buttons and items. The CD database information is stored in text files, one per CD, in a designated directory (category). The path of this directory is XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/CCCCAAAATTTTEEEEGGGGOOOORRRRYYYY, where XMCDLIB is the Page 4 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) directory specified by the XMcd.libdir resource, and CATEGORY is the category name selected when SSSSaaaavvvveeee is performed. The list of categories used is specified by the XMcd.dbdir resource. In addition, if the XMcd.dbdir resource contains full directory path names, then these will be used without prefixing the XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b. You may view the list of directories that _x_m_c_d will search for CD database files by pressing the AAAAbbbboooouuuutttt............ button and viewing the pop-up information window. The file name of each CD database entry is a hexadecimal representation of a special "magic" number computed by _x_m_c_d based on the number of tracks, track timings, and other available information about this CD. This method is used because there is no reliable unique CD identifier to be found on the CD itself (the CD standard allows for a readable IPC/barcode but very few CDs actually contain such information). Since different pressings of the same CD may sometimes contain slightly different track timings, the resultant magic number computed by _x_m_c_d on these CDs will be different. Thus, if you load a CD that is not the same one that a CD database entry was created with (but is actually the same CD title), _x_m_c_d may not recognize it and display the database information automatically when you insert the CD. In this event, you can search the CD database and find the appropriate entry, and establish a "link" to it. To do so, press the LLLLiiiinnnnkkkk button, and select the appropriate category on the popup window. _X_m_c_d will then present another pop-up window containing a list of all CD database entries in the specified category (that has the same number of tracks as the currently inserted disc). Select the appropriate entry and a link will be made in the CD database. The LLLLiiiinnnnkkkk feature alleviates the need to type in CD database information again and avoids duplicate CD database entries. In very rare occasions it is possible that the magic number of a CD conflicts with that of another. This is a problem that will be addressed in a future release of _x_m_c_d. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT Several environment variables are currently recognized by _x_m_c_d, and are described as follows: XXXXMMMMCCCCDDDD____LLLLIIIIBBBBDDDDIIIIRRRR This is used to override the XMcd.libdir resource. This parameter is the directory path under which _x_m_c_d'_s Page 5 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) configuration files, help files, and CD database files are located. The default value of XMCD_LIBDIR on most systems is /_u_s_r/_l_i_b/_X_1_1/_x_m_c_d. XXXXMMMMCCCCDDDD____DDDDBBBBPPPPAAAATTTTHHHH This is used to override the XMcd.dbdir resource, which is a list of CD database category directories to be used under XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b (where XMCDLIB is the directory root specified by the XMcd.libdir resource or the XMCD_LIBDIR environment variable). You may also use the ----ddddbbbbddddiiiirrrr command line option, which has the highest precedence. An example of a XMCD_DBPATH string is as follows (note the colon separators): rrrroooocccckkkk::::ccccllllaaaassssssssiiiiccccaaaallll::::jjjjaaaazzzzzzzz::::nnnneeeewwwwaaaaggggeeee::::ssssoooouuuunnnnddddttttrrrraaaacccckkkk::::mmmmiiiisssscccc This string will cause _x_m_c_d to search the following directories for CD database files: XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_r_o_c_k XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_c_l_a_s_s_i_c_a_l XXXXMMMMCCCCDDDDLLLLIIIIBBBB/_c_d_d_b/_j_a_z_z etc. You may also specify absolute path names in the XMCD_DBPATH entries. Example: rrrroooocccckkkk::::ccccllllaaaassssssssiiiiccccaaaallll::::////uuuussssrrrr////jjjjoooohhhhnnnn////iiiinnnndddduuuussssttttrrrriiiiaaaallll::::////uuuussssrrrr////jjjjoooohhhhnnnn////tttteeeecccchhhhnnnnoooo HHHHOOOOMMMMEEEE This is used to determine your home directory. If HOME is not defined, then _x_m_c_d tries to obtain it from the /_e_t_c/_p_a_s_s_w_d file. The home directory path is used by _x_m_c_d to locate the ._x_m_c_d_c_f_g directory. NNNNOOOOTTTTEEEESSSS Not all CD-ROM drives support all features that appear on _x_m_c_d. For example, most SCSI-1 drives do not support a software-driven volume control. On these drives the _x_m_c_d volume control slider may have no effect, or in some cases it is made to function as a mute control (i.e., it will snap to the full-off or full-on positions only). Similarly, the ccccaaaaddddddddyyyy lllloooocccckkkk, eeeejjjjeeeecccctttt and iiiinnnnddddeeeexxxx sssseeeeaaaarrrrcccchhhh buttons found on _x_m_c_d may not have any effect on drives that do not support the appropriate functionality. FFFFIIIILLLLEEEESSSS $HOME/.xmcdcfg/* XMCDLIB/cddb/* XMCDLIB/config/configure.sh XMCDLIB/config/dev.config Page 6 (printed 7/3/94) XXXXMMMMCCCCDDDD((((1111)))) vvvv1111....1111 ((((11114444 JJJJaaaannnn 1111999999994444)))) XXXXMMMMCCCCDDDD((((1111)))) XMCDLIB/config/.tbl/* XMCDLIB/config/* XMCDLIB/help/* LIBDIR/app-defaults/XMcd BINDIR/xmcd MANDIR/xmcd.1 SSSSEEEEEEEE AAAALLLLSSSSOOOO wm2xmcd(1), X(1). AAAAUUUUTTTTHHHHOOOORRRR Ti Kan (_t_i@_a_m_b._o_r_g) AMB Research Laboratories, Sunnyvale, CA, U.S.A. _X_m_c_d also contains code contributed by several dedicated individuals. See the README file in the _x_m_c_d distribution for information. Comments, suggestions, and bug reports are always welcome. Page 7 (printed 7/3/94)