"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

"{ Package: 'stx:libbasic' }"

AbstractNumberVector variableDoubleSubclass:#DoubleArray

	instanceVariableNames:''

	classVariableNames:''

	poolDictionaries:''

	category:'Collections-Arrayed'

!

!DoubleArray class methodsFor:'documentation'!

copyright

"

 COPYRIGHT (c) 1993 by Claus Gittinger

	      All Rights Reserved

 This software is furnished under a license and may be used

 only in accordance with the terms of that license and with the

 inclusion of the above copyright notice.   This software may not

 be provided or otherwise made available to, or used by, any

 other person.  No title to or ownership of the software is

 hereby transferred.

"

!

documentation

"

    DoubleArrays store doubleFloat values (and nothing else).

    They have been added to support heavy duty number crunching and

    data exchange with openGL frameworks and other mass data libraries

    somewhat better than other smalltalks do. 

    Storing Floats & Doubles in these objects (instead of Arrays)

    has some benefits:

    1) since the values are stored directly (instead of pointers to them)

       both access overhead and garbage collect overhead is minimized.

    2) they can be much faster passed to c functions (such as graphics 

       libraries or heavy duty math packages), since the double values

       come packed and can be used in C by using a (double *) or double[].

       There is no need to loop over the array extracting doubles.      

    3) they could (in theory) be much more easily be processed by things like

       vector and array processors

    Be aware however, that Float- and DoubleArrays are not supported in other

    smalltalks - your program will thus become somewhat less portable.

    (since their protocol is the same as normal arrays filled with floats,

     they can of course be easily simulated - a bit slower though)

    However, they could be simulated by a ByteArray, using doubleAt: and 

    doubleAtPut: messages to access the elements, but that seems a bit

    clumsy and unelegant. Also, the stc-compiler may learn how to deal

    with Float- and DoubleArrays, making accesses very fast in the future.

    Hint: if you use doubleArrays in your application and must port it

    to some other smalltalk, define a DoubleArray class there, which is derived

    from ByteArray, and add access methods.

    Of course, DoubleArray can be subclassed,

    and named instance variables can be added there.

    See example uses in the GLX interface and GLDemos.

    [memory requirements:]

        OBJ-HEADER + (size * double-size)

    [See also:]

        FloatArray Array

    [author:]

        Claus Gittinger

"

! !

!DoubleArray class methodsFor:'queries'!

elementByteSize

    "for bit-like containers, return the number of bytes stored per element.

     Here, 8 is returned"

    ^ 8

    "Created: / 15-09-2011 / 14:12:46 / cg"

! !

!DoubleArray methodsFor:'queries'!

defaultElement

    ^ Float zero

! !

!DoubleArray class methodsFor:'documentation'!

version

    ^ '$Header: /cvs/stx/stx/libbasic/DoubleArray.st,v 1.24 2014-09-23 20:24:21 cg Exp $'

!

version_CVS

    ^ '$Header: /cvs/stx/stx/libbasic/DoubleArray.st,v 1.24 2014-09-23 20:24:21 cg Exp $'

! !