Skip to content

Views and conversions

2 components

as_vec2 

as_vec2(other, dtype = None)

View other as a vec2 with given dtype.

Parameters:

Name Type Description Default
other np.ndarray

Array to consider

 required
dtype n.dtype

Dtype of results (force)

 None

Returns:

Type Description
vec2

view or copy of other.
Source code in glm/vec234.py 
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
def as_vec2(other, dtype = None):
    """ View other as a vec2 with given dtype.

    Args:

        other (np.ndarray):
            Array to consider

        dtype (n.dtype):
            Dtype of results (force)

    Returns:

        (vec2):  view or copy of other.
    """

    V = np.asanyarray(other).reshape(-1,2)
    if dtype is None:
        return V.view(ndarray.vec2)
    else:
        return V.astype(dtype).view(ndarray.vec2)

to_vec2 

to_vec2(other, dtype = None)

Convert other to a vec2 with following convention:

  • v -> vec2 : v[::2] -> v[i],v[i+1]
  • vec2 -> vec2 : x,y -> x,y
  • vec3 -> vec2 : x,y,z -> x,y
  • vec4 -> vec2 : x,y,z,w -> x/w,y/w

Parameters:

Name Type Description Default
other np.ndarray

Array to consider

 required
dtype n.dtype

Dtype of results (force)

 None

Returns:

Type Description
vec2

copy of other.
Source code in glm/vec234.py 
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
def to_vec2(other, dtype  = None):
    """ Convert other to a vec2 with following convention:

    - v    -> vec2 : v[::2] -> v[i],v[i+1]
    - vec2 -> vec2 : x,y     -> x,y
    - vec3 -> vec2 : x,y,z   -> x,y
    - vec4 -> vec2 : x,y,z,w -> x/w,y/w

    Args:

        other (np.ndarray):
            Array to consider

        dtype (n.dtype):
            Dtype of results (force)

    Returns:

        (vec2): copy of other.
    """

    V = np.array(other)
    dtype = dtype if dtype is not None else V.dtype

    if len(V.shape) == 1 and V.size % 2 == 0:
        _V = ndarray.vec2(V.size//2, dtype)
        _V.ravel()[...] = V
        return _V        
    elif len(V.shape) == 2:
        _V = ndarray.vec2(len(V), dtype)
        _V[...] = V[:,:2]
        if V.shape[1] == 2:
            return _V
        elif V.shape[1] == 3:
            return _V
        elif V.shape[1] == 4:
            _V /= V[:,3, np.newaxis]
            return _V

    raise TypeError("Cannot convert %s to vec2" % other)

3 components

as_vec3 

as_vec3(other, dtype = None)

View other as a vec3 with given dtype

Parameters:

Name Type Description Default
other np.array)

Array to consider

 required
dtype np.dtype

Dtype of the results

 None

Returns:

Type Description
vec3

view or copy of other.
Source code in glm/vec234.py 
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
def as_vec3(other, dtype = None):
    """ View other as a vec3 with given dtype

    Args:

        other (np.array) :
            Array to consider

        dtype (np.dtype):
            Dtype of the results

    Returns:

        (vec3): view or copy of other.
    """    

    V = np.asanyarray(other).reshape(-1,3)
    if dtype is None:
        return V.view(ndarray.vec3)
    else:
        return V.astype(dtype).view(ndarray.vec3)

to_vec3 

to_vec3(other, dtype = None)

Convert other to a vec3 with followign convention:

  • v -> vec3 : v[::3] -> v[i],v[i+1],v[i+2]
  • vec2 -> vec3 : x,y -> x,y,0
  • vec3 -> vec3 : x,y,z -> x,y,z
  • vec4 -> vec3 : x,y,z,w -> x/w,y/w,z/w

Parameters:

Name Type Description Default
other np.ndarray

Array to consider

 required
dtype np.dtype

Dtype of the results

 None

Returns:

Type Description
vec3

copy of other.
Source code in glm/vec234.py 
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
def to_vec3(other, dtype = None):
    """ Convert other to a vec3 with followign convention:

    - v    -> vec3 : v[::3]  -> v[i],v[i+1],v[i+2]
    - vec2 -> vec3 : x,y     -> x,y,0
    - vec3 -> vec3 : x,y,z   -> x,y,z
    - vec4 -> vec3 : x,y,z,w -> x/w,y/w,z/w

    Args:

        other (np.ndarray):
            Array to consider

        dtype (np.dtype):
            Dtype of the results

    Returns:

        (vec3): copy of other.
    """

    V = np.array(other)
    dtype = dtype if dtype is not None else V.dtype

    if len(V.shape) == 1 and V.size % 3 == 0:
        _V = ndarray.vec3(V.size//3, dtype)
        _V.ravel()[...] = V
        return _V        
    elif len(V.shape) == 2:
        _V = ndarray.vec3(len(V), dtype)
        if V.shape[1] == 2:
            _V[:,:2] = V
            _V[:, 2] = 0
            return _V
        elif V.shape[1] == 3:
            _V[...] = V
            return _V        
        elif V.shape[1] == 4:
            _V[...] = V[:,:3] / V[:,3, np.newaxis]
            return _V

    raise TypeError("Cannot convert %s to vec3" % other)

4 components

as_vec4 

as_vec4(other, dtype = None)

View other as a vec4 with given dtype

Parameters:

Name Type Description Default
other np.ndarray

Array to consider

 required
dtype np.dtype

Dtype of the results (force)

 None

Returns:

Type Description
vec4

view or copy of other.
Source code in glm/vec234.py 
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
def as_vec4(other, dtype = None):
    """ View other as a vec4 with given dtype

    Args:

        other (np.ndarray):
            Array to consider

        dtype (np.dtype):
            Dtype of the results (force)

    Returns:

        (vec4): view or copy of other.
    """    

    V = np.asanyarray(other).reshape(-1,4)
    if dtype is None:
        return V.view(ndarray.vec4)
    else:
        return V.astype(dtype).view(ndarray.vec4)

to_vec4 

to_vec4(other, dtype = None)

Convert other to a vec4 with following convention

  • v -> vec4 : v[::4] -> v[i],v[i+1],v[i+2],v[i+3]
  • vec2 -> vec4 : x,y -> x,y,0,1
  • vec3 -> vec4 : x,y,z -> x,y,z,1
  • vec4 -> vec4 : x,y,z,w -> x,y,z,w

Parameters:

Name Type Description Default
other np.ndarray

Array to consider

 required
dtype np.dtype

Dtype of the results (force)

 None

Returns:

Type Description
vec4

copy of other
Source code in glm/vec234.py 
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
def to_vec4(other, dtype = None):
    """ Convert other to a vec4 with following convention

    - v    -> vec4 : v[::4] -> v[i],v[i+1],v[i+2],v[i+3]
    - vec2 -> vec4 : x,y     -> x,y,0,1
    - vec3 -> vec4 : x,y,z   -> x,y,z,1
    - vec4 -> vec4 : x,y,z,w -> x,y,z,w

    Args:

        other (np.ndarray):
            Array to consider

        dtype (np.dtype):
            Dtype of the results (force)

    Returns:

        (vec4): copy of other
    """

    V = np.array(other)
    dtype = dtype if dtype is not None else V.dtype

    if len(V.shape) == 1 and V.size % 4 == 0:
        _V = ndarray.vec4(V.size//4, dtype)
        _V.ravel()[...] = V
        return _V        
    elif len(V.shape) == 2:
        _V = ndarray.vec4(len(V), dtype)
        if V.shape[1] == 2:
            _V[:,:2] = V
            _V[:, 2] = 0
            _V[:, 3] = 1
            return _V
        elif V.shape[1] == 3:
            _V[:,:3] = V
            _V[:, 3] = 1
            return _V        
        elif V.shape[1] == 4:
            _V[...] = V
            return _V

    raise TypeError("Cannot convert %s to vec3" % other)