av/codec/h264/h264dec
Saxon Milton 13490e0145 Merged in slice-testing (pull request #225)
codec/h264/h264dec: added some testing for parsing found in slice.go

Approved-by: Alan Noble <anoble@gmail.com>
2019-08-20 02:53:00 +00:00
..
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/cabac.go: fixed indentation of Shawn's name in file header 2019-08-19 23:41:56 +00:00
cabac_test.go codec/h264/h264dec/cabac_test.go: fixed indentation of Shawn's name in file header 2019-08-19 23:43:28 +00:00
cabactab.go codec/h264/h264dec: added tables from reference implementation which are adapted tables from tables 9-12 to 9-33 of specifications for use in CABC initialisation 2019-08-06 14:21:52 +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
helpers.go Merged in slice-testing (pull request #225) 2019-08-20 02:53:00 +00:00
mbtype.go codec/h264/h264dec: added subMbTypeBinarization and TestSubMbTypeBinarization 2019-08-15 00:31:48 +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 field types in sps.go and corrected code after merge of master into branch 2019-07-30 10:16:08 +09:30
parse_test.go codec/h264/h264dec: added tests for pps parsing found in pps.go and made necessary changes 2019-07-23 16:38:35 +09:30
pps.go codec/h264/h264dec: fixed some bugs found by testing 2019-08-05 13:59:08 +09:30
pps_test.go codec/h264/h264dec: merged in master and removed additional binToSlice func 2019-07-31 22:39:20 +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: merged in master, fixed conflicts and problems that that resulted 2019-08-05 13:46:02 +09:30
read_test.go codec/h264/h264dec/read_test.go: added file header 2019-07-31 22:40:10 +09:30
server.go codec/h264/h264dec: fixed import paths 2019-07-19 15:44:45 +09:30
slice.go Merged in slice-testing (pull request #225) 2019-08-20 02:53:00 +00:00
slice_test.go codec/h264/h264dec/slice_test.go: added license information to file header 2019-08-20 12:06:11 +09:30
sps.go codec/h264/h264dec/sps.go: commented fields of syntax structures 2019-07-31 20:25:38 +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.