1#!F-adobe-helvetica-medium-r-normal--18* 2#!N 3#!N #!Rdxgrai 4DXGetRegularArrayInfo #!N #!N Function #!N #!N Returns the number of items, 5the origin, and the delta of a Regular Array. #!N #!N 6Syntax #!N #!F-adobe-times-bold-r-normal--18* #include <dx/dx.h> RegularArray DXGetRegularArrayInfo(RegularArray a, int *count, Pointer 7origin, Pointer delta) #!EF #!N #!N Functional Details #!N #!N If 8 #!F-adobe-times-bold-r-normal--18* count #!EF is not #!F-adobe-times-bold-r-normal--18* NULL #!EF , this routine 9returns in #!F-adobe-times-bold-r-normal--18* *count #!EF the number of points. If #!F-adobe-times-bold-r-normal--18* 10origin #!EF is not #!F-adobe-times-bold-r-normal--18* NULL #!EF , it returns in 11 #!F-adobe-times-bold-r-normal--18* *origin #!EF the position of the first point. If #!F-adobe-times-bold-r-normal--18* 12delta #!EF is not #!F-adobe-times-bold-r-normal--18* NULL #!EF , it returns in 13 #!F-adobe-times-bold-r-normal--18* *delta #!EF the spacing between the points. Both #!F-adobe-times-bold-r-normal--18* origin 14#!EF and #!F-adobe-times-bold-r-normal--18* delta #!EF must point to buffers large enough 15to hold one item of the type of #!F-adobe-times-bold-r-normal--18* a #!EF 16. The information about #!F-adobe-times-bold-r-normal--18* a #!EF may be obtained by 17calling #!F-adobe-times-bold-r-normal--18* DXGetArrayInfo #!EF . #!N #!N Regular Arrays provide a 18compact representation for a sequence of #!F-adobe-times-bold-r-normal--18* count #!EF points beginning 19at #!F-adobe-times-bold-r-normal--18* origin #!EF and extending in the direction specified by 20the #!F-adobe-times-bold-r-normal--18* delta #!EF vector and spaced #!F-adobe-times-bold-r-normal--18* delta #!EF apart. 21The dimensionality of #!F-adobe-times-bold-r-normal--18* origin #!EF and #!F-adobe-times-bold-r-normal--18* delta #!EF may 22be found through a call to #!F-adobe-times-bold-r-normal--18* DXGetArrayInfo #!EF . By 23accessing the origin and delta information directly, it may be possible 24to process Regular Arrays without expansion. Array handles provides a mechanism 25for accessing individual elements of a Regular Array without expansion. #!N 26#!N Return Value #!N #!N Returns #!F-adobe-times-bold-r-normal--18* a #!EF or returns 27 #!F-adobe-times-bold-r-normal--18* NULL #!EF and sets an error code. #!N #!N See 28Also #!N #!N #!F-adobe-times-bold-r-normal--18* #!Ldxcah,dxall1189 h DXCreateArrayHandle #!EL , #!Ldxgai,dxall1222 h DXGetArrayInfo #!EL , #!Ldxnra,dxall1324 h DXNewRegularArray #!EL #!EF #!N 29#!N #!Lrras,dxall1075 h Regular Arrays #!EL . #!N #!N #!N #!F-adobe-times-medium-i-normal--18* Next Topic #!EF #!N 30#!N #!Ldxgsi,dxall1265 h DXGetScreenInfo #!EL #!N #!F-adobe-times-medium-i-normal--18* #!N 31