mpictures(6) [plan9 man page]

MPICTURES(6)							   Games Manual 						      MPICTURES(6)

NAME

       mpictures - picture inclusion macros

SYNOPSIS

       troff -mpictures [ options ] file ...

DESCRIPTION

       Mpictures macros insert PostScript pictures into troff(1) documents.  The macros are:

       .BP source height width position offset flags label
	      Define a frame and place a picture in it.  Null arguments, represented by "", are interpreted as defaults.  The arguments are:

	      source Name  of  a  PostScript  picture  file,  optionally  suffixed  with  (n) to select page number n from the file (first page by
		     default).

	      height Vertical size of the frame, default 3.0i.

	      width  Horizontal size of the frame, current line length by default.

	      position
		     (default), or to left-justify, center, or right-justify the frame.

	      offset Move the frame horizontally from the original position by this amount, default 0i.

	      flags  One or more of:
		     ad     Rotate the picture clockwise d degrees, default d=90.
		     o	    Outline the picture with a box.
		     s	    Freely scale both picture dimensions.
		     w	    White out the area to be occupied by the picture.
		     l,r,t,b
			    Attach the picture to the left right, top, or bottom of the frame.
	      label  Place label at distance 1.5v below the frame.

	      If there's room, .BP fills text around the frame.  Everything destined for either side of the frame goes	into  a  diversion  to	be
	      retrieved when the accumulated text sweeps past the trap set by .BP or when the diversion is explicitly closed by .EP.

       .PI source height,width,yoffset,xoffset flags.
	      This low-level macro, used by .BP, can help do more complex things.  The two arguments not already described are:

	      xoffset
		     Offset the frame from the left margin by this amount, default 0i.

	      yoffset
		     Offset the frame from the current baseline, measuring positive downward, default 0i.

       .EP    End a picture started by .BP; .EP is usually called implicitly by a trap at frame bottom.

       If  a  PostScript file lacks page-delimiting comments, the entire file is included.  If no %%BoundingBox comment is present, the picture is
       assumed to fill an 8.5x11-inch page.  Nothing prevents the picture from being placed off the page.

SEE ALSO

       troff(1)

DIAGNOSTICS

       A picture file that can't be read by the PostScript postprocessor is replaced by white space.

BUGS

       A picture and associated text silently disappear if a diversion trap set by .BP isn't reached.  Call .EP at the	end  of  the  document	to
       retrieve it.
       Macros in other packages may break the adjustments made to the line length and indent when text is being placed around a picture.
       A missing or improper %%BoundingBox comment may cause the frame to be filled incorrectly.

																      MPICTURES(6)

Check Out this Related Man Page

OGGTHUMB(1)							   User Manuals 						       OGGTHUMB(1)

NAME

       oggThumb - creates thumbnails from an ogg video file

SYNOPSIS

       oggThumb [options] file1.ogv [ file2.ogv [ file3.ogv [...] ] ]

DESCRIPTION

       oggThumb creates Thumbnails from one or more ogg video files, at a given time position or a given frame number. It is also possible to cre-
       ate a series of thumbnails at different time or frame positions. The pictures can be created in JPG or PNG format and can be resized to any
       given size.

       The default naming of each thumbnail series follows the following rule:

       <filename_without_extension>_x.<picture_extension>

       Where  x starts with 0 and is incremented with every created thumbnail. So the thumbnails are successivly numbered by the appearence order.
       This is even valid, if time positions and frame numbers are mixed.

OPTIONS

       -t     Time at which a thumbnail should be created. More than one thumbnail time can be concatenated by commas. The times  can  be  set	by
	      integer or floating point values in seconds. If the time is not exactly matching, the next frame is used. The times don't have to be
	      sorted incrementally.

	      Example: -t 12.4,14.157,13.23

       -f     Number of a frame that should be created as a thumbnail. More than one thumbnail frame can be concatenated by commas. The frame num-
	      bers must be an integers. The frame numbers don't have to be sorted incrementally.

	      Example: -f 12000,13000,11000

       -s     Picture  output  size.  The  thumbnail is created in the size given as <width>x<height>.	If you want to include the thumbnails into
	      your webpage and you need to have a fixed width but dynamic height, you can set the dynamic axis to 0. So the aspect  ratio  of  the
	      video frame is kept. This is the same for setting width or height to 0.

	      Example: -s 0x100

       -o     Output format. This can be png or jpg. The default is jpg.

	      Example: -o png

       -n     Alternative thumbnail picture name. The % can be used within the name to indicate the counter placeholder.

	      In  case of more than one video file, the counter continuous throughout the different videos, so that the pictures are not overwrit-
	      ten.

	      If the name has an extension. This extension is used to identify the output picture format.

	      Example: -n myNo_%_thumb

EXAMPLE

       oggThumb -t 10.3,22.4,31.9,43.4,59.4 -f 1200 -s 0x100 myFile.ogv

       oggThumb -f 200,400,300,100 -t 3.54 -n %_thumb.png myfile.ogv mysecondfile.ogv

AUTHOR

       Joern Seger <yorn at gmx dot net>

SEE ALSO

       oggCut(1), oggCat(1), oggJoin(1), oggSplit(1), oggTranscode(1), oggSlideshow(1), oggSilence(1)

Linux								     JAN 2010							       OGGTHUMB(1)

Linux and UNIX Man Pages

mpictures(6) [plan9 man page]

Check Out this Related Man Page