CLNDRANGE_INIT(3)     Standard Compute Layer (CL) Manual     CLNDRANGE_INIT(3)



NAME
       clndrange_init1d,  clndrange_init2d,  clndrange_init3d - Initialize the
       index-space (NDRange) for the execution of a CL kernel

SYNOPSIS
       #include <stdcl.h>

       clndrange_t clndrange_init1d( gtoff0,gt0,lt0);

       clndrange_t clndrange_init2d( gtoff0,gt0,lt0, gtoff1,gt1,lt1);

       clndrange_t    clndrange_init3d(    gtoff0,gt0,lt0,     gtoff1,gt1,lt1,
       gtoff2,gt2,lt2);

DESCRIPTION
       clndrange_init()  family  of macros are used to initialize an object of
       type clndrange_t that defines the index-space for the execution of a CL
       kernel.  The values of gtoffn, gtn, ltn define the global index offset,
       global index range and local index range, respectively,  for  dimension
       n.   The  index-space defines the work-group and work-item partitioning
       for the kernel execution.

EXAMPLES
       The initialization of a 1-D index-space of  16  work-items  with  work-
       group size of 2 and no global offset:

               clndrange_t ndr = clndrange_init1d( 0,16,2 );

       The  initialization  of  a 2-D index-space of 64 by 128 work-items with
       work-group size of 2 by 4 with a global work-item offset of 32,64:

               clndrange_t ndr = clndrange_init1d( 32,64,2, 64,128,4 );

AUTHOR
       Written by David Richie.

REPORTING BUGS
       Report bugs to <support@browndeertechnology.com>

COPYRIGHT
       Copyright (C) 2009 Brown Deer Technology, LLC.  Licensed under the  GNU
       Lesser General Public License version 3 (LGPLv3).  There is NO WARRANTY
       to the extent permitted by law.

SEE ALSO
       clndrange_set(3), clfork(3), stdcl(3)



libstdcl-1.0                       2010-8-12                 CLNDRANGE_INIT(3)