Current section
Files
Jump to
Current section
Files
src/vec@vec3.erl
-module(vec@vec3).
-compile([no_auto_import, nowarn_unused_vars, nowarn_unused_function, nowarn_nomatch]).
-define(FILEPATH, "src/vec/vec3.gleam").
-export([splat/1, to_list/1, x/1, y/1, z/1, replace_x/2, replace_y/2, replace_z/2, map_x/2, map_y/2, map_z/2, swap_xy/1, swap_xz/1, swap_yz/1, map/2, map2/3, result/1, vec3_decoder/1]).
-export_type([vec3/1]).
-if(?OTP_RELEASE >= 27).
-define(MODULEDOC(Str), -moduledoc(Str)).
-define(DOC(Str), -doc(Str)).
-else.
-define(MODULEDOC(Str), -compile([])).
-define(DOC(Str), -compile([])).
-endif.
-type vec3(HGA) :: {vec3, HGA, HGA, HGA}.
-file("src/vec/vec3.gleam", 18).
?DOC(
" Creates a vector with all elements set to a value.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" splat(12)\n"
" // -> Vec3(12, 12, 12)\n"
" ```\n"
).
-spec splat(HGC) -> vec3(HGC).
splat(Value) ->
{vec3, Value, Value, Value}.
-file("src/vec/vec3.gleam", 31).
?DOC(
" Converts the set into a list of the contained elements.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> to_list()\n"
" // -> [12, -34, 420]\n"
" ```\n"
).
-spec to_list(vec3(HGE)) -> list(HGE).
to_list(Vector) ->
[erlang:element(2, Vector),
erlang:element(3, Vector),
erlang:element(4, Vector)].
-file("src/vec/vec3.gleam", 44).
?DOC(
" Returns the x element in a vector.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> x()\n"
" // -> 12\n"
" ```\n"
).
-spec x(vec3(HGH)) -> HGH.
x(Vector) ->
erlang:element(2, Vector).
-file("src/vec/vec3.gleam", 57).
?DOC(
" Returns the y element in a vector.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> y()\n"
" // -> -34\n"
" ```\n"
).
-spec y(vec3(HGJ)) -> HGJ.
y(Vector) ->
erlang:element(3, Vector).
-file("src/vec/vec3.gleam", 70).
?DOC(
" Returns the z element in a vector.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> z()\n"
" // -> 420\n"
" ```\n"
).
-spec z(vec3(HGL)) -> HGL.
z(Vector) ->
erlang:element(4, Vector).
-file("src/vec/vec3.gleam", 83).
?DOC(
" Returns a new vector with the x element replace with `value`.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> replace_x(777)\n"
" // -> Vec3(777, -34, 420)\n"
" ```\n"
).
-spec replace_x(vec3(HGN), HGN) -> vec3(HGN).
replace_x(Vector, Value) ->
_record = Vector,
{vec3, Value, erlang:element(3, _record), erlang:element(4, _record)}.
-file("src/vec/vec3.gleam", 96).
?DOC(
" Returns a new vector with the y element replace with `value`.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> replace_y(777)\n"
" // -> Vec3(12, 777, 420)\n"
" ```\n"
).
-spec replace_y(vec3(HGQ), HGQ) -> vec3(HGQ).
replace_y(Vector, Value) ->
_record = Vector,
{vec3, erlang:element(2, _record), Value, erlang:element(4, _record)}.
-file("src/vec/vec3.gleam", 109).
?DOC(
" Returns a new vector with the z element replace with `value`.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> replace_z(777)\n"
" // -> Vec3(12, -34, 777)\n"
" ```\n"
).
-spec replace_z(vec3(HGT), HGT) -> vec3(HGT).
replace_z(Vector, Value) ->
_record = Vector,
{vec3, erlang:element(2, _record), erlang:element(3, _record), Value}.
-file("src/vec/vec3.gleam", 122).
?DOC(
" Returns a new vector with the x element having had `with` applied to it.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> map_x(fn(n) { n * 2 })\n"
" // -> Vec3(24, -34, 420)\n"
" ```\n"
).
-spec map_x(vec3(HGW), fun((HGW) -> HGW)) -> vec3(HGW).
map_x(Vector, Fun) ->
_record = Vector,
{vec3,
Fun(erlang:element(2, Vector)),
erlang:element(3, _record),
erlang:element(4, _record)}.
-file("src/vec/vec3.gleam", 135).
?DOC(
" Returns a new vector with the y element having had `with` applied to it.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> map_y(fn(n) { n * 2 })\n"
" // -> Vec3(12, -68, 420)\n"
" ```\n"
).
-spec map_y(vec3(HGZ), fun((HGZ) -> HGZ)) -> vec3(HGZ).
map_y(Vector, Fun) ->
_record = Vector,
{vec3,
erlang:element(2, _record),
Fun(erlang:element(3, Vector)),
erlang:element(4, _record)}.
-file("src/vec/vec3.gleam", 148).
?DOC(
" Returns a new vector with the z element having had `with` applied to it.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> map_z(fn(n) { n * 2 })\n"
" // -> Vec3(12, -34, 840)\n"
" ```\n"
).
-spec map_z(vec3(HHC), fun((HHC) -> HHC)) -> vec3(HHC).
map_z(Vector, Fun) ->
_record = Vector,
{vec3,
erlang:element(2, _record),
erlang:element(3, _record),
Fun(erlang:element(4, Vector))}.
-file("src/vec/vec3.gleam", 161).
?DOC(
" Returns a new vector with the x and y elements swaped.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> swap_xy()\n"
" // -> Vec3(-34, 12, 420)\n"
" ```\n"
).
-spec swap_xy(vec3(HHF)) -> vec3(HHF).
swap_xy(Vector) ->
_record = Vector,
{vec3,
erlang:element(3, Vector),
erlang:element(2, Vector),
erlang:element(4, _record)}.
-file("src/vec/vec3.gleam", 174).
?DOC(
" Returns a new vector with the x and z elements swaped.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> swap_xz()\n"
" // -> Vec3(420, -34, 12)\n"
" ```\n"
).
-spec swap_xz(vec3(HHI)) -> vec3(HHI).
swap_xz(Vector) ->
_record = Vector,
{vec3,
erlang:element(4, Vector),
erlang:element(3, _record),
erlang:element(2, Vector)}.
-file("src/vec/vec3.gleam", 187).
?DOC(
" Returns a new vector with the y and z elements swaped.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> swap_yz()\n"
" // -> Vec3(12, 420, -34)\n"
" ```\n"
).
-spec swap_yz(vec3(HHL)) -> vec3(HHL).
swap_yz(Vector) ->
_record = Vector,
{vec3,
erlang:element(2, _record),
erlang:element(4, Vector),
erlang:element(3, Vector)}.
-file("src/vec/vec3.gleam", 201).
?DOC(
" Returns a new vector containing only the elements of the first vector after\n"
" the function has been applied to each one.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> map(fn(x) { x * 2 })\n"
" // -> Vec3(24, -68, 840)\n"
" ```\n"
).
-spec map(vec3(HHO), fun((HHO) -> HHQ)) -> vec3(HHQ).
map(Vector, Fun) ->
{vec3,
Fun(erlang:element(2, Vector)),
Fun(erlang:element(3, Vector)),
Fun(erlang:element(4, Vector))}.
-file("src/vec/vec3.gleam", 214).
?DOC(
" Combines two vectors into a single vector using the given function.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(12, -34, 420) |> map2(Vec3(1, 2, 3), fn(x, y) { x * y })\n"
" // -> Vec3(12, -68, 1260)\n"
" ```\n"
).
-spec map2(vec3(HHS), vec3(HHU), fun((HHS, HHU) -> HHW)) -> vec3(HHW).
map2(A, B, Fun) ->
{vec3,
Fun(erlang:element(2, A), erlang:element(2, B)),
Fun(erlang:element(3, A), erlang:element(3, B)),
Fun(erlang:element(4, A), erlang:element(4, B))}.
-file("src/vec/vec3.gleam", 234).
?DOC(
" Combines a vector of results into a single result. If all elements in the\n"
" vector are `Ok` then returns an `Ok` holding the vector of values. If any\n"
" element is `Error` then returns the first error.\n"
"\n"
" ## Examples\n"
"\n"
" ```gleam\n"
" Vec3(Ok(12), Ok(-34), Ok(420)) |> result()\n"
" // -> Ok(Vec3(12, -34, 420))\n"
" ```\n"
"\n"
" ```gleam\n"
" Vec3(Ok(12), Error(\"foo\"), Error(\"bar\")) |> result()\n"
" // -> Error(\"foo\")\n"
" ```\n"
).
-spec result(vec3({ok, HHY} | {error, HHZ})) -> {ok, vec3(HHY)} | {error, HHZ}.
result(Vector) ->
case Vector of
{vec3, {ok, X}, {ok, Y}, {ok, Z}} ->
{ok, {vec3, X, Y, Z}};
{vec3, {error, Error}, _, _} ->
{error, Error};
{vec3, _, {error, Error@1}, _} ->
{error, Error@1};
{vec3, _, _, {error, Error@2}} ->
{error, Error@2}
end.
-file("src/vec/vec3.gleam", 244).
?DOC(" A decoder that decodes 3D vectors where all elements are decoded with a given decoder.\n").
-spec vec3_decoder(gleam@dynamic@decode:decoder(HIG)) -> gleam@dynamic@decode:decoder(vec3(HIG)).
vec3_decoder(Inner) ->
gleam@dynamic@decode:field(
<<"x"/utf8>>,
Inner,
fun(X) ->
gleam@dynamic@decode:field(
<<"y"/utf8>>,
Inner,
fun(Y) ->
gleam@dynamic@decode:field(
<<"z"/utf8>>,
Inner,
fun(Z) ->
gleam@dynamic@decode:success({vec3, X, Y, Z})
end
)
end
)
end
).