/usr/share/doc/libghc-gloss-doc/html/src/Graphics-Gloss-Data-Vector.html is in libghc-gloss-doc 1.7.8.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ -->
<title>Graphics/Gloss/Data/Vector.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{-# OPTIONS -fno-warn-missing-methods #-}</span>
<a name="line-2"></a><span class='hs-comment'>{-# LANGUAGE TypeSynonymInstances #-}</span>
<a name="line-3"></a>
<a name="line-4"></a><span class='hs-comment'>-- | Geometric functions concerning vectors.</span>
<a name="line-5"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>Gloss</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Vector</span>
<a name="line-6"></a> <span class='hs-layout'>(</span> <span class='hs-conid'>Vector</span>
<a name="line-7"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>magV</span>
<a name="line-8"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>argV</span>
<a name="line-9"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>dotV</span>
<a name="line-10"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>detV</span>
<a name="line-11"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>mulSV</span>
<a name="line-12"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>rotateV</span>
<a name="line-13"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>angleVV</span>
<a name="line-14"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>normaliseV</span>
<a name="line-15"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>unitVectorAtAngle</span> <span class='hs-layout'>)</span>
<a name="line-16"></a><span class='hs-keyword'>where</span>
<a name="line-17"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>Gloss</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Point</span>
<a name="line-18"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Graphics</span><span class='hs-varop'>.</span><span class='hs-conid'>Gloss</span><span class='hs-varop'>.</span><span class='hs-conid'>Geometry</span><span class='hs-varop'>.</span><span class='hs-conid'>Angle</span>
<a name="line-19"></a>
<a name="line-20"></a><a name="Vector"></a><span class='hs-comment'>-- | A vector can be treated as a point, and vis-versa.</span>
<a name="line-21"></a><a name="Vector"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Point</span>
<a name="line-22"></a>
<a name="line-23"></a>
<a name="line-24"></a><a name="magV"></a><span class='hs-comment'>-- | The magnitude of a vector.</span>
<a name="line-25"></a><span class='hs-definition'>magV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Float</span>
<a name="line-26"></a><span class='hs-comment'>{-# INLINE magV #-}</span>
<a name="line-27"></a><span class='hs-definition'>magV</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-28"></a> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>sqrt</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span> <span class='hs-varop'>*</span> <span class='hs-varid'>x</span> <span class='hs-varop'>+</span> <span class='hs-varid'>y</span> <span class='hs-varop'>*</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-29"></a>
<a name="line-30"></a><a name="argV"></a><span class='hs-comment'>-- | The angle of this vector, relative to the +ve x-axis.</span>
<a name="line-31"></a><span class='hs-definition'>argV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Float</span>
<a name="line-32"></a><span class='hs-comment'>{-# INLINE argV #-}</span>
<a name="line-33"></a><span class='hs-definition'>argV</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-34"></a> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>normaliseAngle</span> <span class='hs-varop'>$</span> <span class='hs-varid'>atan2</span> <span class='hs-varid'>y</span> <span class='hs-varid'>x</span>
<a name="line-35"></a>
<a name="line-36"></a><a name="dotV"></a><span class='hs-comment'>-- | The dot product of two vectors.</span>
<a name="line-37"></a><span class='hs-definition'>dotV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Float</span>
<a name="line-38"></a><span class='hs-comment'>{-# INLINE dotV #-}</span>
<a name="line-39"></a><span class='hs-definition'>dotV</span> <span class='hs-layout'>(</span><span class='hs-varid'>x1</span><span class='hs-layout'>,</span> <span class='hs-varid'>x2</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>y1</span><span class='hs-layout'>,</span> <span class='hs-varid'>y2</span><span class='hs-layout'>)</span>
<a name="line-40"></a> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x1</span> <span class='hs-varop'>*</span> <span class='hs-varid'>y1</span> <span class='hs-varop'>+</span> <span class='hs-varid'>x2</span> <span class='hs-varop'>*</span> <span class='hs-varid'>y2</span>
<a name="line-41"></a>
<a name="line-42"></a><a name="detV"></a><span class='hs-comment'>-- | The determinant of two vectors.</span>
<a name="line-43"></a><span class='hs-definition'>detV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Float</span>
<a name="line-44"></a><span class='hs-comment'>{-# INLINE detV #-}</span>
<a name="line-45"></a><span class='hs-definition'>detV</span> <span class='hs-layout'>(</span><span class='hs-varid'>x1</span><span class='hs-layout'>,</span> <span class='hs-varid'>y1</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>x2</span><span class='hs-layout'>,</span> <span class='hs-varid'>y2</span><span class='hs-layout'>)</span>
<a name="line-46"></a> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x1</span> <span class='hs-varop'>*</span> <span class='hs-varid'>y2</span> <span class='hs-comment'>-</span> <span class='hs-varid'>y1</span> <span class='hs-varop'>*</span> <span class='hs-varid'>x2</span>
<a name="line-47"></a>
<a name="line-48"></a><a name="mulSV"></a><span class='hs-comment'>-- | Multiply a vector by a scalar.</span>
<a name="line-49"></a><span class='hs-definition'>mulSV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Float</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span>
<a name="line-50"></a><span class='hs-comment'>{-# INLINE mulSV #-}</span>
<a name="line-51"></a><span class='hs-definition'>mulSV</span> <span class='hs-varid'>s</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-52"></a> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>s</span> <span class='hs-varop'>*</span> <span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span> <span class='hs-varop'>*</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-53"></a>
<a name="line-54"></a><a name="rotateV"></a><span class='hs-comment'>-- | Rotate a vector by an angle (in radians). +ve angle is counter-clockwise.</span>
<a name="line-55"></a><span class='hs-definition'>rotateV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Float</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span>
<a name="line-56"></a><span class='hs-comment'>{-# INLINE rotateV #-}</span>
<a name="line-57"></a><span class='hs-definition'>rotateV</span> <span class='hs-varid'>r</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-layout'>,</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-58"></a> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span> <span class='hs-varid'>x</span> <span class='hs-varop'>*</span> <span class='hs-varid'>cos</span> <span class='hs-varid'>r</span> <span class='hs-comment'>-</span> <span class='hs-varid'>y</span> <span class='hs-varop'>*</span> <span class='hs-varid'>sin</span> <span class='hs-varid'>r</span>
<a name="line-59"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>x</span> <span class='hs-varop'>*</span> <span class='hs-varid'>sin</span> <span class='hs-varid'>r</span> <span class='hs-varop'>+</span> <span class='hs-varid'>y</span> <span class='hs-varop'>*</span> <span class='hs-varid'>cos</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span>
<a name="line-60"></a>
<a name="line-61"></a>
<a name="line-62"></a><a name="angleVV"></a><span class='hs-comment'>-- | Compute the inner angle (in radians) between two vectors.</span>
<a name="line-63"></a><span class='hs-definition'>angleVV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Float</span>
<a name="line-64"></a><span class='hs-comment'>{-# INLINE angleVV #-}</span>
<a name="line-65"></a><span class='hs-definition'>angleVV</span> <span class='hs-varid'>p1</span> <span class='hs-varid'>p2</span>
<a name="line-66"></a> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>m1</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>magV</span> <span class='hs-varid'>p1</span>
<a name="line-67"></a> <span class='hs-varid'>m2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>magV</span> <span class='hs-varid'>p2</span>
<a name="line-68"></a> <span class='hs-varid'>d</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p1</span> <span class='hs-varop'>`dotV`</span> <span class='hs-varid'>p2</span>
<a name="line-69"></a> <span class='hs-varid'>aDiff</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>acos</span> <span class='hs-varop'>$</span> <span class='hs-varid'>d</span> <span class='hs-varop'>/</span> <span class='hs-layout'>(</span><span class='hs-varid'>m1</span> <span class='hs-varop'>*</span> <span class='hs-varid'>m2</span><span class='hs-layout'>)</span>
<a name="line-70"></a>
<a name="line-71"></a> <span class='hs-keyword'>in</span> <span class='hs-varid'>aDiff</span>
<a name="line-72"></a>
<a name="line-73"></a>
<a name="line-74"></a><a name="normaliseV"></a><span class='hs-comment'>-- | Normalise a vector, so it has a magnitude of 1.</span>
<a name="line-75"></a><span class='hs-definition'>normaliseV</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Vector</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span>
<a name="line-76"></a><span class='hs-comment'>{-# INLINE normaliseV #-}</span>
<a name="line-77"></a><span class='hs-definition'>normaliseV</span> <span class='hs-varid'>v</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>mulSV</span> <span class='hs-layout'>(</span><span class='hs-num'>1</span> <span class='hs-varop'>/</span> <span class='hs-varid'>magV</span> <span class='hs-varid'>v</span><span class='hs-layout'>)</span> <span class='hs-varid'>v</span>
<a name="line-78"></a>
<a name="line-79"></a>
<a name="line-80"></a><a name="unitVectorAtAngle"></a><span class='hs-comment'>-- | Produce a unit vector at a given angle relative to the +ve x-axis.</span>
<a name="line-81"></a><span class='hs-comment'>-- The provided angle is in radians.</span>
<a name="line-82"></a><span class='hs-definition'>unitVectorAtAngle</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Float</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Vector</span>
<a name="line-83"></a><span class='hs-comment'>{-# INLINE unitVectorAtAngle #-}</span>
<a name="line-84"></a><span class='hs-definition'>unitVectorAtAngle</span> <span class='hs-varid'>r</span>
<a name="line-85"></a> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>cos</span> <span class='hs-varid'>r</span><span class='hs-layout'>,</span> <span class='hs-varid'>sin</span> <span class='hs-varid'>r</span><span class='hs-layout'>)</span>
<a name="line-86"></a>
</pre></body>
</html>
|