y4munsharp(1)


NAME

   y4munsharp - Unsharp filter for YUV4MPEG2 streams

SYNOPSIS

   y4munsharp [options]

DESCRIPTION

   y4munsharp  is  an  implementation  of  the   GIMP  unsharp  filter for
   YUV4MPEG2 streams.  The usual 3 parameters for unshap  mask  processing
   (radius,  amount  and threshold) are specified on the command line.  By
   default only the Y' (luma) component is processed  although  processing
   of  the CbCr (chroma) may be requested by a commandline option.  Output
   must be either to a pipe or a file, leaving stdout as a  terminal  will
   elicit an error and the program will exit.

OPTIONS

   y4munsharp accepts the following options:

   -v num
        Set  verbosity  level (0 = quiet, 1 = normal, 2 = debug) (default:
        1)

   -h   Print a suage summary and exit

   -L radius,amount,threshold
        Y' (luma) unsharp parameters.  The radius  and  amount"  arguments
        are floating point numbers.  The threshold argument is an integer.
        (default:  3.0,0.3,4)  -C  radius,amount,threshold  CbCr  (chroma)
        unsharp  parameters.   The  chroma  is  not  processed unless this
        option is given.  Arguments are the same type as for the -L option
        above.  (default: none)

   -N   Filtering  can  produce  output outside the 16 to 240 range for Y'
        and 16 to 235 for CbCr.  By default values outside the legal range
        are  clipped/cored  (values  over  240  for  Y' are set to 240 for
        example).  Using -N the limits 0 and 255 are used instead.

EXAMPLES

   A mild setting:
   y4munsharp -L 2.0,0.3,0

   An aggressive setting:
   y4munsharp -L 5.0,0.5,0

NOTES

   The radius, amount, threshold parameters have the same meaning  as  the
   GIMP's  unsharp  plugin.   This  means you can use the GIMP on selected
   frame still images to determine suitable settings for y4munsharp.   The
   key  thing to remember is to be subtle - you just barely want to notice
   the sharpening effect.  If the effect is obvious ("jumps out  at  you")
   then the parameters are set too aggressively.

   The  chroma is not processed for a several reasons:  1) The eye is much
   more sensitive to changes in brightness,   2)  the  chroma  is  usually
   subsampled and doesn't contribute much to the perceived sharpness of an
   image - so not processing the chroma  provides  a  boost  in  speed  of
   processing  the image, and 3) possible artifacting - changes in Y' just
   make an image brighter/darker but  changes  in  Cb  or  Cr  can  change
   colors and possibly lead to shifts in hue.  Use the -C option to enable
   processing of the chroma planes.

BUGS

   Only the 3 plane YUV4MPEG2 formats are supported.

   Only progressive, top field first  or  bottom  field  first  interlaced
   streams  are  handled.   The  mixed  interlaced  stream  format  is not
   supported.





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.