Update to user guide. A few new pages and many translations by Google Code-In students. ShowImage, MediaPlayer and WebPositive are not yet ready for translation. Thanks everyone.
@@ -310,7 +310,7 @@ Of course you can move these indicators to change the gradient to your liking. Y
<aid="i-o-m-tips"name="i-o-m-tips">Tips & Tricks</a></h3>
<p>A few things you should keep in mind when working with Icon-O-Matic and some general tips for its usage:</p>
<ul>
<li><p>Read the <ahref="http://factory.haiku-os.org/documentation/icon_guidelines/">Icon Guidelines</a> to learn about important characteristics of Haiku icons, e.g. perspective, colors and shadows.</p></li>
<li><p>Read the <ahref="http://svn.haiku-os.org/haiku/haiku/trunk/docs/icon_guidelines/index.html">Icon Guidelines</a> to learn about important characteristics of Haiku icons, e.g. perspective, colors and shadows.</p></li>
<li><p>You should always try to minimize your use of paths, those are the most expensive, file size wise. Re-use paths wherever possible and work with manipulated shapes and their transformers instead. Smart use of gradients can also save space.</p></li>
<li><p>Wherever possible, you should activate Snap-to-Grid from the <spanclass="menu">Options</span> menu when editing paths. Path points that align with the 64x64 pixel grid use less storage space. You'll also get the crispest look if points are set on exact pixel borders. For example, it is important to align the most prominent outlines with the 16x16 grid.</p></li>
<li><p>Check the preview to see if your icon still looks good in 16x16. You may want to use the <ahref="#i-o-m-shape-lod">Level Of Detail</a> settings described in the Shapes section.</p></li>
<tr><td><tt>addattr</tt></td><td></td><td>Writes an attribute to a node, taking the type into account and converting the values accordingly. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>alert</tt></td><td></td><td>Show a message box. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>arp</tt></td><td></td><td>Manipulate the system ARP cache. </td></tr>
<tr><td><tt>addattr</tt></td><td></td><td>Writes an attribute to a file, taking the type into account and converting the values accordingly. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>alert</tt></td><td></td><td>Shows a message box. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>arp</tt></td><td></td><td>Manipulates the system ARP cache. </td></tr>
<tr><td><tt>checkitout</tt></td><td></td><td>Wraps URL mime types around command line applications or other apps that don't handle them directly. </td></tr>
<tr><td><tt>chgrp</tt></td><td></td><td>Change group of files. </td></tr>
<tr><td><tt>copyattr</tt></td><td></td><td>Copies attributes from one or more files or directories, with all or a specified subset of their attributes, to another location. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>cp</tt></td><td></td><td>Copy files and directories. </td></tr>
<tr><td><tt>csplit</tt></td><td></td><td>Output pieces of files separated by patterns to files and output byte counts of each piece to standard output.</td></tr>
<tr><td><tt>ctags</tt></td><td></td><td>Generate an index file for a variety of language objects found in files</td></tr>
<tr><td><tt>cut</tt></td><td></td><td>Remove sections from each line of files. </td></tr>
<tr><td><tt>date</tt></td><td></td><td>Display the current time in the given format or set the system date.</td></tr>
<tr><td><tt>dstcheck</tt></td><td></td><td>Daylight Saving Time check. </td></tr>
<tr><td><tt>du</tt></td><td></td><td>Summarize disk usage of each file, recursively for directories. </td></tr>
<tr><td><tt>copyattr</tt></td><td></td><td>Copies all or a subset of attributes from one or more files to another or new file. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>cp</tt></td><td></td><td>Copies files and directories. </td></tr>
<tr><td><tt>csplit</tt></td><td></td><td>Split a file into pieces separated by a specified pattern.</td></tr>
<tr><td><tt>ctags</tt></td><td></td><td>Generates an index file for a variety of language objects found in files</td></tr>
<tr><td><tt>cut</tt></td><td></td><td>Prints out sections from each line of a file.</td></tr>
<tr><td><tt>date</tt></td><td></td><td>Displays or sets the current time and date.</td></tr>
<tr><td><tt>lsindex</tt></td><td></td><td>Display the indexed attributes on the current volume/partition. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>mail2mbox</tt></td><td></td><td>Convert BeOS e-mail files into Unix mailbox files. </td></tr>
<tr><td><tt>make</tt></td><td></td><td>GNU make utility to maintain groups of programs.</td></tr>
<tr><td><tt>listres</tt></td><td></td><td>Lists resources of files. </td></tr>
<tr><td><tt>listsem</tt></td><td></td><td>Lists the semaphores allocated by the specified team. </td></tr>
<tr><td><tt>listusb</tt></td><td></td><td>Lists USB devices. </td></tr>
<tr><td><tt>ln</tt></td><td></td><td>Creates a link to a file.</td></tr>
<tr><td><tt>locate</tt></td><td></td><td>Locates a file. </td></tr>
<tr><td><tt>logger</tt></td><td></td><td>Sends a message to the system log. </td></tr>
<tr><td><tt>login</tt></td><td></td><td>Starts a session on the system. </td></tr>
<tr><td><tt>logname</tt></td><td></td><td>Prints the name of the current user. </td></tr>
<tr><td><tt>lsindex</tt></td><td></td><td>Displays the indexed attributes on the current volume/partition. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>mail2mbox</tt></td><td></td><td>Converts BeOS e-mail files to Unix mailbox files. </td></tr>
<tr><td><tt>make</tt></td><td></td><td>GNU make utility</td></tr>
<tr><td><tt>makebootable</tt></td><td></td><td>Makes the specified BFS partitions/devices bootable by writing boot code into the first two sectors. </td></tr>
<tr><td><tt>mbox2mail</tt></td><td></td><td>Convert Unix mailbox files into e-mail files for use with BeOS.. </td></tr>
<tr><td><tt>md5sum</tt></td><td></td><td>Print or check MD5 checksums.</td></tr>
<tr><td><tt>mbox2mail</tt></td><td></td><td>Converts Unix mailbox files to BeOS e-mail files.</td></tr>
<tr><td><tt>md5sum</tt></td><td></td><td>Prints or checks MD5 checksums.</td></tr>
<tr><td><tt>mountvolume</tt></td><td></td><td>Mounts a volume if given. Lists info about mounted and mountable volumes and mounts/unnmounts volumes. </td></tr>
<tr><td><tt>nproc</tt></td><td></td><td>Print the number of processing units available to the current process which may be less than the number of online processors.</td></tr>
<tr><td><tt>od</tt></td><td></td><td>Write an unambiguous representation, octal bytes per default of files to standard output. </td></tr>
<tr><td><tt>message</tt></td><td></td><td>Prints a flattened BMessage file. </td></tr>
<tr><td><tt>mimeset</tt></td><td></td><td>Sets MIME type of a file. </td></tr>
<tr><td><tt>passwd</tt></td><td></td><td>Change user password. </td></tr>
<tr><td><tt>paste</tt></td><td></td><td>Write lines consisting of the sequentially corresponding lines from each file, separated by tabs to standard output.</td></tr>
<tr><td><tt>patch</tt></td><td></td><td>Apply a diff file to an original. </td></tr>
<tr><td><tt>pathchk</tt></td><td></td><td>Diagnose invalid or unportable file names. </td></tr>
<tr><td><tt>ptx</tt></td><td></td><td>Output a permuted index, including context, of the words in the input files.</td></tr>
<tr><td><tt>pwd</tt></td><td></td><td>Print current directory. </td></tr>
<tr><td><tt>query</tt></td><td></td><td>A shell utility for somewhat emulating the Tracker's "Find by formula" functionality. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>readlink</tt></td><td></td><td>Print value of a symbolic link or canonical file name. </td></tr>
<tr><td><tt>reindex</tt></td><td></td><td>Put the attributes of existing files into newly created index of a volume/partition. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>release</tt></td><td></td><td>Release a semaphore. </td></tr>
<tr><td><tt>renice</tt></td><td></td><td>Alter priority of running process. </td></tr>
<tr><td><tt>rlog</tt></td><td></td><td>Print log messages and other information about RCS files.</td></tr>
<tr><td><tt>rm</tt></td><td></td><td>Remove files and directories. </td></tr>
<tr><td><tt>rmattr</tt></td><td></td><td>Remove an attribute from a file. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>rmindex</tt></td><td></td><td>Remove an attribute from the index of a volume/partition. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>roster</tt></td><td></td><td>Print information about teams. </td></tr>
<tr><td><tt>route</tt></td><td></td><td>List and manipulate network routes. </td></tr>
<tr><td><tt>safemode</tt></td><td></td><td>Print if running in safemode. </td></tr>
<tr><td><tt>readlink</tt></td><td></td><td>Prints the path to the destination of a symbolic link.</td></tr>
<tr><td><tt>reindex</tt></td><td></td><td>Puts attributes of existing files into newly created indexes. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<tr><td><tt>release</tt></td><td></td><td>Releases a semaphore. </td></tr>
<tr><td><tt>renice</tt></td><td></td><td>Alters the priority of a running process. </td></tr>
<tr><td><tt>rlog</tt></td><td></td><td>Prints log messages and other information about RCS files.</td></tr>
<tr><td><tt>rm</tt></td><td></td><td>Removes files and directories. </td></tr>
<tr><td><tt>rmattr</tt></td><td></td><td>Removes an attribute from a file. <ahref="cli-apps.html">(Haikuspecific)</a></td></tr>
<p>You can control playing media using a set of buttons - previous, play/pause, stop, next. Also, there is a progress bar, a volume controler and even an oscilloscope.</p>
<divclass="box-info">Once you play a video file, you can double right-click on the display to hide interface. Double left-click instead causes displaying video in full-screen mode.</div>
<p><b>Playing media</b></p>
<p>There are options especially useful while watching DVD video or other files which include different audio/video tracks or have subtitles included. You can change audio tracks from <spanclass="menu">Audio | Track</span> just as <spanclass="menu">Video | Track</span> for various video tracks. You can also make use of subtitles, MediaPlayer supports .srt format. All available subtitles are showed as options in <spanclass="menu">Video | Subtitles</span> menu. The player gets names for this positions from the filename, eg. videoclip.english.srt shows as "english" in the menu.</p>
<p>You can change the scale by resizing the window or simply from the <spanclass="menu">Video</span> menu. There are 50%, 100%, 200%, 300% and 400% options. There is an option to change the player to full-screen mode or to change ratio of the display.</p>
<p><b>Playlists</b></p>
<p>MediaPlayer supports playlists. You can either select a few files in Tracker using <spanclass="key">ALT</span> and launched the application or add other files after launching the one using the drag and drop method. You can get to the playlist from menu - choose <spanclass="menu">MediaPlayer | Playlist</span> and the playlist window will pop-up.</p>
<p>You can save the current playlist or open one from the playlist window, of course. There is also a function that lets you to randomize your playlist. Use either <spanclass="menu">Edit | Randomize</span> menu position or <spanclass="key">ALT</span><spanclass="key">R</span> shortcut. You can also both remove any file from playlist and remove it from playlist and put into Trash. This functions are available from <spanclass="menu">Edit</span> menu, too.</p>
<p><b>Other options</b></p>
<p>If you would like to rate a file, you can do this directly from MediaPlayer, too! Choose a rate from 1 to 10 from <spanclass="menu">Attributes | Rating</span> menu.</p>
<p>MediaPlayer is also able to show you some information about the file you play. It is available from <spanclass="menu">MediaPlayer | File info... </span> menu.</p>
<p>You can configure the application from <spanclass="menu">MediaPlayer | Settings</span>. There are some interesting options concerning looping playback, closing window when playback finishes, size and placement of subtitles or volume level while playing in the background.</p>
<p><b>Shortcuts</b></p>
<p>There are plenty of shortcuts for this application. <spanclass="key">SPACEBAR</span> is used to play/pause the playback. You can control the whole playback with one hand, because alternate keys are used - <spanclass="key">Z</span> to go to the previous track, <spanclass="key">X</span> to play, <spanclass="key">C</span> to pause and <spanclass="key">V</span> to go to the next track. Left/Right cursors are used to seek, they cause 10 seconds seeking while <spanclass="key">ALT</span> is pressed at the same time. Up and down cursors controls the volume and cause going to the previous/next track while <spanclass="key">ALT</span> is pressed.</p>
<p><spanclass="key">ALT</span><spanclass="key">F</span> activates full-screen mode, <spanclass="key">ALT</span><spanclass="key">P</span> pops-up playlist window, <spanclass="key">ALT</span><spanclass="key">I</span> shows file information, <spanclass="key">ALT</span><spanclass="key">H</span> hides interface, <spanclass="key">ALT</span><spanclass="key">A</span> causes MediaPlayer is always on top, <spanclass="key">ALT</span><spanclass="key">S</span> moves you to the settings window and <spanclass="key">ALT</span><spanclass="key">Q</span> quits the application.</p>
<p>ShowImage is an application used for viewing images in various formats. Its funcionality is not limited only to viewing photos, it can also crop images, show slideshows, rotate and flip images.</p>
<p>If you want to launch this application, simply double-click on some image on your computer.</p>
<p><b>Browse photos</b></p>
<p>You are not limited to viewing only the image you used to launch application. You can go both to previous or to next image from the folder using arrows on keybord. You can also zoom using either mouse scroll or shortcuts - <spanclass="key">ALT</span><spanclass="key">+</span> for zooming in and <spanclass="key">ALT</span><spanclass="key">-</span> for zooming out. High-quality zooming is set by default, but you can disable this function unchecking <spanclass="menu">View | High-quality zooming</span>. This function does very fast bilinear filtering.</p>
<p>There is a possibility to simply zoom picture to the original size or to fit to the window size. Use <spanclass="menu">View</span> menu or shortcuts - <spanclass="key">ALT</span><spanclass="key">1</span> to get back to the original size or <spanclass="key">ALT</span><spanclass="key">0</span> to fit to the window size. From the same menu you can also enable stretching an image to the window.</p>
<p>ShowImage does support multiple-page files, such as TIFF. It means you can turn pages while browsing any multiple-page image. Make use of <spanclass="menu">Browse</span> menu or use shortcuts (see screenshot above) for this function.</p>
<p>To change mode to full-screen, simply choose <spanclass="key">ALT</span><spanclass="key">ENTER</span> shortcut.</p>
<p><b>Slide show</b></p>
<p>You can run slideshow using menu, simply choose <spanclass="menu">View | Slide show</span>. There is an option for changing slide delay from 3 to 20 seconds. Default value is a 3 second delay, but you can change it from <spanclass="menu">View | Slide delay</span> menu.</p>
<p><b>Flip and rotate images</b></p>
<p>This function is also built-in. If you would like to rotate some image, choose proper position from <spanclass="menu">Image</span> menu or use shortcuts - <spanclass="key">ALT</span><spanclass="key">R</span> will rorate your image clockwise and <spanclass="key">SHIFT</span><spanclass="key">ALT</span><spanclass="key">R</span> counterclockwise.</p>
<p>You can also flip images. <spanclass="menu">Image | Flip left to right</span> will flip your image horizontally and <spanclass="menu">Image | Flip top to bottom</span> vertically.</p>
<p><b>Set background</b></p>
<p>You can set your desktop background directly from ShowImage. Just choose <spanclass="menu">Image | Use as background...</span> and Backgrounds preflet will pop-up.</p>
<p><b>Drag and drop</b></p>
<p>There is an option to select a piece of an image and create new image file from the selection. Simply press <spanclass="key">CTRL</span> or <spanclass="key">ALT</span> and select a fragment you would like to use as a new file and drag the selection to desktop. Also, you can change mode to selection mode, so you will be able to select parts of images using just a left mouse button. This option is available from <spanclass="menu">Edit | Selection Mode</span></p>
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Joachim Seemer