Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
oggz-chop(1)		    General Commands Manual		  oggz-chop(1)

NAME
       oggz-chop -- Extract the	part of	an Ogg file between given start	and/or
       end times.

SYNOPSIS
       oggz-chop  [-o  filename	  |  --output  filename	 ]   [-s start_time  |
       --start start_time ]  [-e end_time  | --end end_time ]	[-k   |	 --no-
       skeleton	] filename

       oggz-chop [-h  |	--help ]  [-v  | --version ]

Description
       oggz-chop  chops	a section of an	Ogg file.  It correctly	interprets the
       granulepos timestamps of	Ogg CELT, CMML,	Dirac, FLAC, Kate, Opus,  PCM,
       Speex, Theora, Vorbis and VP8 bitstreams.  Run oggz-known-codecs(1) for
       a full list of codecs known by the installed version of oggz.

       The  output  file contains copies of the	headers	of the input file, and
       all the codec data required to correctly	decode the content between the
       start and end times specified on	the commandline. For codecs with  data
       dependencies  like  video keyframes, the	keyframe prior to the starting
       time will be included in	the output.

       Note that oggz-chop operates by copying pages of	Ogg data; it does  not
       strip  partial packets from the first or	last data page included	in the
       output. It does however ensure to set the end of	 stream	 flag  on  the
       last page of each logical bitstream.

       Skeleton	handling: By default, the output will contain a	Skeleton track
       specifying the start of the chop	as presentation	time.

Options
       oggz-chop accepts the following options:

   Output options
       -o filename, --output filename
		 Write output to the specified filename	instead	of printing it
		 to standard output.

       -s start_time, --start start_time
		 Specify the start time	of the chopped section to output.

       -e end_time, --end end_time
		 Specify the end time of the chopped section to	output.

       -k , --no-skeleton
		 Do NOT	include	a Skeleton bitstream in	the output.

       -h, --help
		 Display usage information and exit.

       -v, --version
		 Output	version	information and	exit.

EXAMPLES
       Extract the first minute	of file.ogx:

	      oggz chop	-e 1:00	file.ogx

       Extract from the	second to the fifth minute of file.ogx:

	      oggz chop	-s 2:00	-e 5:00	-o output.ogx file.ogx

       Extract,	specifying SMPTE-25 frame offsets:

	      oggz  chop  -s smpte-25:00:02:03::12 -e smpte-25:00:05:02::04 -o
	      output.ogv file.ogv

Server configuration
       The following configuration for Apache httpd will enable	oggz-chop.  As
       with  most  Apache directives, this may of course be restricted to par-
       ticular Directories or Locations:

       ScriptAlias /oggz-chop /usr/bin/oggz-chop

       Action application/ogg /oggz-chop

   HTTP/1.1 Cacheability
       oggz-chop generates Last-Modified HTTP headers, and responds  correctly
       to If-Modified-Since conditional	GET requests.

AUTHOR
       Conrad Parker	    February 25, 2008;

COPYRIGHT
       Copyright (C) 2008 Annodex Association

SEE ALSO
       oggz-validate(1), oggz-merge(1),	oggz-dump(1), hogg(1)

								  oggz-chop(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=oggz-chop&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help