av/codec/h264/decode
Saxon 0d9861c49e codec/h264/decode: added SVCExtension struct with NewSVCExtension function 2019-07-19 17:37:54 +09:30
..
bits codec/h264/h264dec/bits/bitreader.go: added ReadBool and ReadBitsInt methods 2019-07-19 17:25:57 +09:30
CODEOWNERS codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
LICENSE codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
README.md codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
cabac.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
cabac_test.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
frame.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
go.mod codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
go.sum codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
mbtype.go codec/h264/decode: did not copy over most up to date version from old repo, so fixing that 2019-07-19 13:29:10 +09:30
mbtype_test.go codec/h264/decode: did not copy over most up to date version from old repo, so fixing that 2019-07-19 13:29:10 +09:30
mnvars.go h264: renamed files to make more go like 2019-07-19 12:09:30 +09:30
nalunit.go codec/h264/decode: added SVCExtension struct with NewSVCExtension function 2019-07-19 17:37:54 +09:30
parse.go codec/h264/decode: did not copy over most up to date version from old repo, so fixing that 2019-07-19 13:29:10 +09:30
parse_test.go codec/h264/decode: did not copy over most up to date version from old repo, so fixing that 2019-07-19 13:29:10 +09:30
pps.go codec/h264/decode: giving parsing function calls BitReaders instead of nil 2019-07-19 14:36:50 +09:30
rangetablps.go h264: renamed files to make more go like 2019-07-19 12:09:30 +09:30
rbsp.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
read.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
server.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
slice.go codec/h264/decode: giving parsing function calls BitReaders instead of nil 2019-07-19 14:36:50 +09:30
slice_test.go codec/h264: added mrmod h264decode pkg to our av/codec/h264 dir 2019-07-18 14:02:42 +09:30
sps.go codec/h264/decode: giving parsing function calls BitReaders instead of nil 2019-07-19 14:36:50 +09:30
statetransxtab.go h264: renamed files to make more go like 2019-07-19 12:09:30 +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.