av/codec/h264/h264dec
Saxon 8e8dbbaec6 Merge branch 'master' into vui-hrd-parameters-types 2019-07-29 14:20:11 +09:30
..
bits codec/h264/h264dec/bits: removed ReadBitsInt and ReadBool as not required anymore 2019-07-29 13:43:03 +09:30
CODEOWNERS codec/h264: decode pakage renamed to h264dec 2019-07-19 15:19:15 +09:30
LICENSE codec/h264: decode pakage renamed to h264dec 2019-07-19 15:19:15 +09:30
README.md codec/h264: decode pakage renamed to h264dec 2019-07-19 15:19:15 +09:30
cabac.go codec/h264/h264dec: separated VUI and HRD from SPS struct 2019-07-21 22:11:27 +09:30
cabac_test.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30
frame.go codec/h264/h264dec/nalunit.go: using consts for NAL unit types check in newNALUnit 2019-07-29 14:08:59 +09:30
mbtype.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30
mbtype_test.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30
mnvars.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30
nalunit.go codec/h264/h264dec/nalunit.go: using consts for NAL unit types check in newNALUnit 2019-07-29 14:08:59 +09:30
parse.go codec/h264/h264dec: fixed readBits return type 2019-07-29 12:35:01 +09:30
parse_test.go codec/h264/h264dec: fixed import paths 2019-07-19 15:44:45 +09:30
pps.go codec/h264/h264dec: separated VUI and HRD from SPS struct 2019-07-21 22:11:27 +09:30
rangetablps.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30
rbsp.go codec/h264/h264dec: fixed import paths 2019-07-19 15:44:45 +09:30
read.go codec/h264/h264dec: moved fieldReader to parse.go and wrote methods for reading other descriptor types like ue and te. 2019-07-27 13:59:12 +09:30
server.go codec/h264/h264dec: fixed import paths 2019-07-19 15:44:45 +09:30
slice.go Merge branch 'master' into vui-hrd-parameters-types 2019-07-29 14:20:11 +09:30
slice_test.go codec/h264/h264dec: separated VUI and HRD from SPS struct 2019-07-21 22:11:27 +09:30
sps.go codec/h264/h264dec: separated VUI and HRD from SPS struct 2019-07-21 22:11:27 +09:30
statetransxtab.go codec/h264/h264dec: changed packages from h264 to h264dec 2019-07-19 15:20:39 +09:30

README.md

Build Status Go Report Card

Listens for a stream of H264 bytes on port 8000.

A stream is read sequentially dropping each NAL into a struct with access to the RBSP and seekable features. No interface contracts are implemented right now. This is heavily a work in progress.

TODO

  • CABAC initialization
  • Context-adaptive arithmetic entropy-coded syntax element support
  • Macroblock to YCbCr image decoding

Done

  • DecodeBypass, 9.3.3.2.3
  • DecodeTerminate, 9.3.3.2.4
  • RenormD - 9.3.3.2.2
  • rangeTableLPS ( Table 9-44 )
  • Derive ctxIDX per 9.3.3.1
  • Select M, N values

ArithmeticDecoding S 9.3.3.2

  • cabac.go : ArithmeticDecoding 9.3.3.3.2
  • cabac.go : DecodeBypass, DecodeTerminate, DecodeDecision

In Progress

  • Make use of DecodeBypass and DecodeTerminate information
  • 9.3.3.2.1 - BinaryDecision
  • 9.3.3.2.1.1, 9.3.3.2.2

Next

  • Make use of initCabac (initialized CABACs)

Background

The last point was and is the entire driving force behind this project: To decode a single frame to an image and begin doing computer vision tasks on it. A while back, this project was started to keep an eye on rodents moving their way around various parts of our house and property. What was supposed to happen was motion detected from one-frame to another of an MJPEG stream would trigger capturing the stream. Analyzing the stream, even down at 24 fps, caused captures to be triggered too late. When it was triggered, there was so much blur in the resulting captured stream, it wasn't very watchable.

Doing a little prototyping it was apparent reading an h.264 stream into VLC provided a watchable, unblurry, video. With a little searching on the internet, (https://github.com/gqf2008/codec) provided an example of using ffMPEG to decode an h.264 frame/NAL unit's macroblocks into a YCbCr image. Were this some shippable product with deadlines and things, GGF2008 would've been wired up and progress would've happened. But this is a tinkering project. Improving development skills, learning a bit about streaming deata, and filling dead-air were the criteria for this project.

Because of that, a pure Go h.264 stream decoder was the only option. Duh.