Jason Sams 62f258f1e4 Clean up RS samples for SDK, bug 2943369
Fix bug 3403965 rsgSyncAll would not mark constants as changed
found by inspection.

Only rsAllocation.cpp affects on device bits.

Change-Id: I6b7ec0df87e42687b24384aaf54dc04976cb84f7

doc update

Change-Id: Id5841f08868557e086f185024470924ef202d19f
2011-01-28 16:18:01 -08:00

217 lines
6.9 KiB
Plaintext

#ifndef __RS_MATH_RSH__
#define __RS_MATH_RSH__
/**
* Copy reference to the specified object.
*
* @param dst
* @param src
*/
extern void __attribute__((overloadable))
rsSetObject(rs_element *dst, rs_element src);
extern void __attribute__((overloadable))
rsSetObject(rs_type *dst, rs_type src);
extern void __attribute__((overloadable))
rsSetObject(rs_allocation *dst, rs_allocation src);
extern void __attribute__((overloadable))
rsSetObject(rs_sampler *dst, rs_sampler src);
extern void __attribute__((overloadable))
rsSetObject(rs_script *dst, rs_script src);
extern void __attribute__((overloadable))
rsSetObject(rs_mesh *dst, rs_mesh src);
extern void __attribute__((overloadable))
rsSetObject(rs_program_fragment *dst, rs_program_fragment src);
extern void __attribute__((overloadable))
rsSetObject(rs_program_vertex *dst, rs_program_vertex src);
extern void __attribute__((overloadable))
rsSetObject(rs_program_raster *dst, rs_program_raster src);
extern void __attribute__((overloadable))
rsSetObject(rs_program_store *dst, rs_program_store src);
extern void __attribute__((overloadable))
rsSetObject(rs_font *dst, rs_font src);
/**
* Sets the object to NULL.
*
* @return bool
*/
extern void __attribute__((overloadable))
rsClearObject(rs_element *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_type *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_allocation *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_sampler *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_script *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_mesh *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_program_fragment *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_program_vertex *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_program_raster *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_program_store *dst);
extern void __attribute__((overloadable))
rsClearObject(rs_font *dst);
/**
* Tests if the object is valid. Returns true if the object is valid, false if
* it is NULL.
*
* @return bool
*/
extern bool __attribute__((overloadable))
rsIsObject(rs_element);
extern bool __attribute__((overloadable))
rsIsObject(rs_type);
extern bool __attribute__((overloadable))
rsIsObject(rs_allocation);
extern bool __attribute__((overloadable))
rsIsObject(rs_sampler);
extern bool __attribute__((overloadable))
rsIsObject(rs_script);
extern bool __attribute__((overloadable))
rsIsObject(rs_mesh);
extern bool __attribute__((overloadable))
rsIsObject(rs_program_fragment);
extern bool __attribute__((overloadable))
rsIsObject(rs_program_vertex);
extern bool __attribute__((overloadable))
rsIsObject(rs_program_raster);
extern bool __attribute__((overloadable))
rsIsObject(rs_program_store);
extern bool __attribute__((overloadable))
rsIsObject(rs_font);
/**
* Returns the Allocation for a given pointer. The pointer should point within
* a valid allocation. The results are undefined if the pointer is not from a
* valid allocation.
*/
extern rs_allocation __attribute__((overloadable))
rsGetAllocation(const void *);
/**
* Mark the contents of an allocation as dirty. This forces any other scripts
* using the allocation to receive the updated
*/
extern void __attribute__((overloadable))
rsAllocationMarkDirty(rs_allocation);
/**
* Query the dimension of an allocation.
*
* @return uint32_t The X dimension of the allocation.
*/
extern uint32_t __attribute__((overloadable))
rsAllocationGetDimX(rs_allocation);
/**
* Query the dimension of an allocation.
*
* @return uint32_t The Y dimension of the allocation.
*/
extern uint32_t __attribute__((overloadable))
rsAllocationGetDimY(rs_allocation);
/**
* Query the dimension of an allocation.
*
* @return uint32_t The Z dimension of the allocation.
*/
extern uint32_t __attribute__((overloadable))
rsAllocationGetDimZ(rs_allocation);
/**
* Query an allocation for the presence of more than one LOD.
*
* @return uint32_t Returns 1 if more than one LOD is present, 0 otherwise.
*/
extern uint32_t __attribute__((overloadable))
rsAllocationGetDimLOD(rs_allocation);
/**
* Query an allocation for the presence of more than one face.
*
* @return uint32_t Returns 1 if more than one face is present, 0 otherwise.
*/
extern uint32_t __attribute__((overloadable))
rsAllocationGetDimFaces(rs_allocation);
// Extract a single element from an allocation.
extern const void * __attribute__((overloadable))
rsGetElementAt(rs_allocation, uint32_t x);
extern const void * __attribute__((overloadable))
rsGetElementAt(rs_allocation, uint32_t x, uint32_t y);
extern const void * __attribute__((overloadable))
rsGetElementAt(rs_allocation, uint32_t x, uint32_t y, uint32_t z);
// Return a random value between 0 (or min_value) and max_malue.
extern int __attribute__((overloadable))
rsRand(int max_value);
extern int __attribute__((overloadable))
rsRand(int min_value, int max_value);
extern float __attribute__((overloadable))
rsRand(float max_value);
extern float __attribute__((overloadable))
rsRand(float min_value, float max_value);
// return the fractional part of a float
// min(v - ((int)floor(v)), 0x1.fffffep-1f);
extern float __attribute__((overloadable))
rsFrac(float);
// Send a message back to the client. Will not block and returns true
// if the message was sendable and false if the fifo was full.
// A message ID is required. Data payload is optional.
extern bool __attribute__((overloadable))
rsSendToClient(int cmdID);
extern bool __attribute__((overloadable))
rsSendToClient(int cmdID, const void *data, uint len);
// Send a message back to the client, blocking until the message is queued.
// A message ID is required. Data payload is optional.
extern void __attribute__((overloadable))
rsSendToClientBlocking(int cmdID);
extern void __attribute__((overloadable))
rsSendToClientBlocking(int cmdID, const void *data, uint len);
// Script to Script
enum rs_for_each_strategy {
RS_FOR_EACH_STRATEGY_SERIAL,
RS_FOR_EACH_STRATEGY_DONT_CARE,
RS_FOR_EACH_STRATEGY_DST_LINEAR,
RS_FOR_EACH_STRATEGY_TILE_SMALL,
RS_FOR_EACH_STRATEGY_TILE_MEDIUM,
RS_FOR_EACH_STRATEGY_TILE_LARGE
};
typedef struct rs_script_call {
enum rs_for_each_strategy strategy;
uint32_t xStart;
uint32_t xEnd;
uint32_t yStart;
uint32_t yEnd;
uint32_t zStart;
uint32_t zEnd;
uint32_t arrayStart;
uint32_t arrayEnd;
} rs_script_call_t;
extern void __attribute__((overloadable))
rsForEach(rs_script script, rs_allocation input,
rs_allocation output, const void * usrData);
extern void __attribute__((overloadable))
rsForEach(rs_script script, rs_allocation input,
rs_allocation output, const void * usrData,
const rs_script_call_t *);
#endif