Skip to content

Commit 7f8994a

Browse files
committed
Adds module documentation for Turbojpeg
1 parent 31bc6b7 commit 7f8994a

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

lib/turbojpeg.ex

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,19 @@ defmodule Turbojpeg do
2020
height: height()
2121
}
2222

23+
@doc """
24+
Converts yuv to jpeg images
25+
26+
27+
iex> {:ok, jpeg} = Turbojpeg.yuv_to_jpeg(Shmex.new(frame), 1920, 1080, 90, :I420)
28+
{:ok,
29+
%Shmex{
30+
capacity: 203783,
31+
guard: #Reference<0.938325095.2990669827.232440>,
32+
name: "/shmex-00000005607042890133#000",
33+
size: 203783
34+
}}
35+
"""
2336
@spec yuv_to_jpeg(Shmex.t(), width, height, quality, format) ::
2437
{:ok, Shmex.t()} | error()
2538
def yuv_to_jpeg(yuv, width, height, quality, format) do
@@ -29,6 +42,19 @@ defmodule Turbojpeg do
2942
{:error, error}
3043
end
3144

45+
@doc """
46+
Converts jpeg to yuv
47+
48+
49+
iex> {:ok, yuv} = Turbojpeg.jpeg_to_yuv(Shmex.new(jpeg))
50+
{:ok,
51+
%Shmex{
52+
capacity: 203783,
53+
guard: #Reference<0.938325095.2990669827.232440>,
54+
name: "/shmex-00000005607042890133#000",
55+
size: 203783
56+
}}
57+
"""
3258
@spec jpeg_to_yuv(Shmex.t()) ::
3359
{:ok, Shmex.t()} | error()
3460
def jpeg_to_yuv(jpeg) do
@@ -38,6 +64,18 @@ defmodule Turbojpeg do
3864
{:error, error}
3965
end
4066

67+
@doc """
68+
Gets the header from a jpegv
69+
70+
iex> {:ok, header} = Turbojpeg.get_jpeg_header(Shmex.new(jpeg))
71+
{:ok,
72+
%{
73+
format: :I422,
74+
width: 192,
75+
height: 192
76+
}
77+
}
78+
"""
4179
@spec get_jpeg_header(Shmex.t()) :: {:ok, jpeg_header} | error()
4280
def get_jpeg_header(jpeg) do
4381
Native.get_jpeg_header(jpeg)

0 commit comments

Comments
 (0)