/* * Copyright (C) 2013 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** @file rs_types.rsh * * Define the standard RenderScript types * * Integers * 8 bit: char, int8_t * 16 bit: short, int16_t * 32 bit: int, in32_t * 64 bit: long, long long, int64_t * * Unsigned Integers * 8 bit: uchar, uint8_t * 16 bit: ushort, uint16_t * 32 bit: uint, uint32_t * 64 bit: ulong, uint64_t * * Floating point * 32 bit: float * 64 bit: double * * Vectors of length 2, 3, and 4 are supported for all the types above. * */ #ifndef __RS_TYPES_RSH__ #define __RS_TYPES_RSH__ /* Constants */ #define M_E 2.718281828459045235360287471352662498f /* e */ #define M_LOG2E 1.442695040888963407359924681001892137f /* log_2 e */ #define M_LOG10E 0.434294481903251827651128918916605082f /* log_10 e */ #define M_LN2 0.693147180559945309417232121458176568f /* log_e 2 */ #define M_LN10 2.302585092994045684017991454684364208f /* log_e 10 */ #define M_PI 3.141592653589793238462643383279502884f /* pi */ #define M_PI_2 1.570796326794896619231321691639751442f /* pi/2 */ #define M_PI_4 0.785398163397448309615660845819875721f /* pi/4 */ #define M_1_PI 0.318309886183790671537767526745028724f /* 1/pi */ #define M_2_PIl 0.636619772367581343075535053490057448f /* 2/pi */ #define M_2_SQRTPI 1.128379167095512573896158903121545172f /* 2/sqrt(pi) */ #define M_SQRT2 1.414213562373095048801688724209698079f /* sqrt(2) */ #define M_SQRT1_2 0.707106781186547524400844362104849039f /* 1/sqrt(2) */ #include "stdbool.h" /** * 8 bit integer type */ typedef char int8_t; /** * 16 bit integer type */ typedef short int16_t; /** * 32 bit integer type */ typedef int int32_t; /** * 64 bit integer type */ #if (defined(RS_VERSION) && (RS_VERSION >= 21)) typedef long int64_t; #else typedef long long int64_t; #endif /** * 8 bit unsigned integer type */ typedef unsigned char uint8_t; /** * 16 bit unsigned integer type */ typedef unsigned short uint16_t; /** * 32 bit unsigned integer type */ typedef unsigned int uint32_t; /** * 64 bit unsigned integer type */ #if (defined(RS_VERSION) && (RS_VERSION >= 21)) typedef unsigned long uint64_t; #else typedef unsigned long long uint64_t; #endif /** * 8 bit unsigned integer type */ typedef uint8_t uchar; /** * 16 bit unsigned integer type */ typedef uint16_t ushort; /** * 32 bit unsigned integer type */ typedef uint32_t uint; /** * Typedef for unsigned long (use for 64-bit unsigned integers) */ typedef uint64_t ulong; /** * Typedef for size_t */ #ifndef __LP64__ typedef uint32_t size_t; typedef int32_t ssize_t; #else typedef uint64_t size_t; typedef int64_t ssize_t; #endif #ifndef __LP64__ #define RS_BASE_OBJ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) #else #define RS_BASE_OBJ typedef struct { const long* const p; const long* const r; const long* const v1; const long* const v2; } #endif /** * \brief Opaque handle to a RenderScript element. * * See: android.renderscript.Element */ RS_BASE_OBJ rs_element; /** * \brief Opaque handle to a RenderScript type. * * See: android.renderscript.Type */ RS_BASE_OBJ rs_type; /** * \brief Opaque handle to a RenderScript allocation. * * See: android.renderscript.Allocation */ RS_BASE_OBJ rs_allocation; /** * \brief Opaque handle to a RenderScript sampler object. * * See: android.renderscript.Sampler */ RS_BASE_OBJ rs_sampler; /** * \brief Opaque handle to a RenderScript script object. * * See: android.renderscript.ScriptC */ RS_BASE_OBJ rs_script; #ifndef __LP64__ /** * \brief Opaque handle to a RenderScript mesh object. * * See: android.renderscript.Mesh */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_mesh; /** * \brief Opaque handle to a RenderScript Path object. * * See: android.renderscript.Path */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_path; /** * \brief Opaque handle to a RenderScript ProgramFragment object. * * See: android.renderscript.ProgramFragment */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_program_fragment; /** * \brief Opaque handle to a RenderScript ProgramVertex object. * * See: android.renderscript.ProgramVertex */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_program_vertex; /** * \brief Opaque handle to a RenderScript ProgramRaster object. * * See: android.renderscript.ProgramRaster */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_program_raster; /** * \brief Opaque handle to a RenderScript ProgramStore object. * * See: android.renderscript.ProgramStore */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_program_store; /** * \brief Opaque handle to a RenderScript font object. * * See: android.renderscript.Font */ typedef struct { const int* const p; } __attribute__((packed, aligned(4))) rs_font; #endif // __LP64__ /** * Vector version of the basic float type. * Provides two float fields packed into a single 64 bit field with 64 bit * alignment. */ typedef float float2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic float type. Provides three float fields packed * into a single 128 bit field with 128 bit alignment. */ typedef float float3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic float type. * Provides four float fields packed into a single 128 bit field with 128 bit * alignment. */ typedef float float4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic double type. Provides two double fields packed * into a single 128 bit field with 128 bit alignment. */ typedef double double2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic double type. Provides three double fields packed * into a single 256 bit field with 256 bit alignment. */ typedef double double3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic double type. Provides four double fields packed * into a single 256 bit field with 256 bit alignment. */ typedef double double4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic uchar type. Provides two uchar fields packed * into a single 16 bit field with 16 bit alignment. */ typedef uchar uchar2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic uchar type. Provides three uchar fields packed * into a single 32 bit field with 32 bit alignment. */ typedef uchar uchar3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic uchar type. Provides four uchar fields packed * into a single 32 bit field with 32 bit alignment. */ typedef uchar uchar4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic ushort type. Provides two ushort fields packed * into a single 32 bit field with 32 bit alignment. */ typedef ushort ushort2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic ushort type. Provides three ushort fields packed * into a single 64 bit field with 64 bit alignment. */ typedef ushort ushort3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic ushort type. Provides four ushort fields packed * into a single 64 bit field with 64 bit alignment. */ typedef ushort ushort4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic uint type. Provides two uint fields packed into a * single 64 bit field with 64 bit alignment. */ typedef uint uint2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic uint type. Provides three uint fields packed into * a single 128 bit field with 128 bit alignment. */ typedef uint uint3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic uint type. Provides four uint fields packed into * a single 128 bit field with 128 bit alignment. */ typedef uint uint4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic ulong type. Provides two ulong fields packed into * a single 128 bit field with 128 bit alignment. */ typedef ulong ulong2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic ulong type. Provides three ulong fields packed * into a single 256 bit field with 256 bit alignment. */ typedef ulong ulong3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic ulong type. Provides four ulong fields packed * into a single 256 bit field with 256 bit alignment. */ typedef ulong ulong4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic char type. Provides two char fields packed into a * single 16 bit field with 16 bit alignment. */ typedef char char2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic char type. Provides three char fields packed into * a single 32 bit field with 32 bit alignment. */ typedef char char3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic char type. Provides four char fields packed into * a single 32 bit field with 32 bit alignment. */ typedef char char4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic short type. Provides two short fields packed into * a single 32 bit field with 32 bit alignment. */ typedef short short2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic short type. Provides three short fields packed * into a single 64 bit field with 64 bit alignment. */ typedef short short3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic short type. Provides four short fields packed * into a single 64 bit field with 64 bit alignment. */ typedef short short4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic int type. Provides two int fields packed into a * single 64 bit field with 64 bit alignment. */ typedef int int2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic int type. Provides three int fields packed into a * single 128 bit field with 128 bit alignment. */ typedef int int3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic int type. Provides two four fields packed into a * single 128 bit field with 128 bit alignment. */ typedef int int4 __attribute__((ext_vector_type(4))); /** * Vector version of the basic long type. Provides two long fields packed into a * single 128 bit field with 128 bit alignment. */ typedef long long2 __attribute__((ext_vector_type(2))); /** * Vector version of the basic long type. Provides three long fields packed into * a single 256 bit field with 256 bit alignment. */ typedef long long3 __attribute__((ext_vector_type(3))); /** * Vector version of the basic long type. Provides four long fields packed into * a single 256 bit field with 256 bit alignment. */ typedef long long4 __attribute__((ext_vector_type(4))); /** * \brief 4x4 float matrix * * Native holder for RS matrix. Elements are stored in the array at the * location [row*4 + col] */ typedef struct { float m[16]; } rs_matrix4x4; /** * \brief 3x3 float matrix * * Native holder for RS matrix. Elements are stored in the array at the * location [row*3 + col] */ typedef struct { float m[9]; } rs_matrix3x3; /** * \brief 2x2 float matrix * * Native holder for RS matrix. Elements are stored in the array at the * location [row*2 + col] */ typedef struct { float m[4]; } rs_matrix2x2; /** * quaternion type for use with the quaternion functions */ typedef float4 rs_quaternion; #define RS_PACKED __attribute__((packed, aligned(4))) #define NULL ((void *)0) #if (defined(RS_VERSION) && (RS_VERSION >= 14)) /** * \brief Enum for selecting cube map faces */ typedef enum { RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X = 0, RS_ALLOCATION_CUBEMAP_FACE_NEGATIVE_X = 1, RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_Y = 2, RS_ALLOCATION_CUBEMAP_FACE_NEGATIVE_Y = 3, RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_Z = 4, RS_ALLOCATION_CUBEMAP_FACE_NEGATIVE_Z = 5 } rs_allocation_cubemap_face; /** * \brief Bitfield to specify the usage types for an allocation. * * These values are ORed together to specify which usages or memory spaces are * relevant to an allocation or an operation on an allocation. */ typedef enum { RS_ALLOCATION_USAGE_SCRIPT = 0x0001, RS_ALLOCATION_USAGE_GRAPHICS_TEXTURE = 0x0002, RS_ALLOCATION_USAGE_GRAPHICS_VERTEX = 0x0004, RS_ALLOCATION_USAGE_GRAPHICS_CONSTANTS = 0x0008, RS_ALLOCATION_USAGE_GRAPHICS_RENDER_TARGET = 0x0010 } rs_allocation_usage_type; #endif //defined(RS_VERSION) && (RS_VERSION >= 14) // New API's #if (defined(RS_VERSION) && (RS_VERSION >= 16)) #ifndef __LP64__ /** * Describes the way mesh vertex data is interpreted when rendering * **/ typedef enum { /** * Vertex data will be rendered as a series of points */ RS_PRIMITIVE_POINT = 0, /** * Vertex pairs will be rendered as lines */ RS_PRIMITIVE_LINE = 1, /** * Vertex data will be rendered as a connected line strip */ RS_PRIMITIVE_LINE_STRIP = 2, /** * Vertices will be rendered as individual triangles */ RS_PRIMITIVE_TRIANGLE = 3, /** * Vertices will be rendered as a connected triangle strip * defined by the first three vertices with each additional * triangle defined by a new vertex */ RS_PRIMITIVE_TRIANGLE_STRIP = 4, /** * Vertices will be rendered as a sequence of triangles that all * share first vertex as the origin */ RS_PRIMITIVE_TRIANGLE_FAN = 5, /** * Invalid primitive */ RS_PRIMITIVE_INVALID = 100, } rs_primitive; #endif // __LP64__ /** * \brief Enumeration for possible element data types * * DataType represents the basic type information for a basic element. The * naming convention follows. For numeric types it is FLOAT, * SIGNED, or UNSIGNED followed by the _BITS where BITS is the * size of the data. BOOLEAN is a true / false (1,0) * represented in an 8 bit container. The UNSIGNED variants * with multiple bit definitions are for packed graphical data * formats and represent vectors with per vector member sizes * which are treated as a single unit for packing and alignment * purposes. * * MATRIX the three matrix types contain FLOAT_32 elements and are treated * as 32 bits for alignment purposes. * * RS_* objects. 32 bit opaque handles. */ typedef enum { RS_TYPE_NONE = 0, RS_TYPE_FLOAT_32 = 2, RS_TYPE_FLOAT_64 = 3, RS_TYPE_SIGNED_8 = 4, RS_TYPE_SIGNED_16 = 5, RS_TYPE_SIGNED_32 = 6, RS_TYPE_SIGNED_64 = 7, RS_TYPE_UNSIGNED_8 = 8, RS_TYPE_UNSIGNED_16 = 9, RS_TYPE_UNSIGNED_32 = 10, RS_TYPE_UNSIGNED_64 = 11, RS_TYPE_BOOLEAN = 12, RS_TYPE_UNSIGNED_5_6_5 = 13, RS_TYPE_UNSIGNED_5_5_5_1 = 14, RS_TYPE_UNSIGNED_4_4_4_4 = 15, RS_TYPE_MATRIX_4X4 = 16, RS_TYPE_MATRIX_3X3 = 17, RS_TYPE_MATRIX_2X2 = 18, RS_TYPE_ELEMENT = 1000, RS_TYPE_TYPE = 1001, RS_TYPE_ALLOCATION = 1002, RS_TYPE_SAMPLER = 1003, RS_TYPE_SCRIPT = 1004, RS_TYPE_MESH = 1005, RS_TYPE_PROGRAM_FRAGMENT = 1006, RS_TYPE_PROGRAM_VERTEX = 1007, RS_TYPE_PROGRAM_RASTER = 1008, RS_TYPE_PROGRAM_STORE = 1009, RS_TYPE_FONT = 1010, RS_TYPE_INVALID = 10000, } rs_data_type; /** * \brief Enumeration for possible element data kind * * The special interpretation of the data if required. This is primarly * useful for graphical data. USER indicates no special interpretation is * expected. PIXEL is used in conjunction with the standard data types for * representing texture formats. */ typedef enum { RS_KIND_USER = 0, RS_KIND_PIXEL_L = 7, RS_KIND_PIXEL_A = 8, RS_KIND_PIXEL_LA = 9, RS_KIND_PIXEL_RGB = 10, RS_KIND_PIXEL_RGBA = 11, RS_KIND_PIXEL_DEPTH = 12, RS_KIND_PIXEL_YUV = 13, RS_KIND_INVALID = 100, } rs_data_kind; #ifndef __LP64__ typedef enum { /** * Always drawn */ RS_DEPTH_FUNC_ALWAYS = 0, /** * Drawn if the incoming depth value is less than that in the * depth buffer */ RS_DEPTH_FUNC_LESS = 1, /** * Drawn if the incoming depth value is less or equal to that in * the depth buffer */ RS_DEPTH_FUNC_LEQUAL = 2, /** * Drawn if the incoming depth value is greater than that in the * depth buffer */ RS_DEPTH_FUNC_GREATER = 3, /** * Drawn if the incoming depth value is greater or equal to that * in the depth buffer */ RS_DEPTH_FUNC_GEQUAL = 4, /** * Drawn if the incoming depth value is equal to that in the * depth buffer */ RS_DEPTH_FUNC_EQUAL = 5, /** * Drawn if the incoming depth value is not equal to that in the * depth buffer */ RS_DEPTH_FUNC_NOTEQUAL = 6, /** * Invalid depth function */ RS_DEPTH_FUNC_INVALID = 100, } rs_depth_func; typedef enum { RS_BLEND_SRC_ZERO = 0, RS_BLEND_SRC_ONE = 1, RS_BLEND_SRC_DST_COLOR = 2, RS_BLEND_SRC_ONE_MINUS_DST_COLOR = 3, RS_BLEND_SRC_SRC_ALPHA = 4, RS_BLEND_SRC_ONE_MINUS_SRC_ALPHA = 5, RS_BLEND_SRC_DST_ALPHA = 6, RS_BLEND_SRC_ONE_MINUS_DST_ALPHA = 7, RS_BLEND_SRC_SRC_ALPHA_SATURATE = 8, RS_BLEND_SRC_INVALID = 100, } rs_blend_src_func; typedef enum { RS_BLEND_DST_ZERO = 0, RS_BLEND_DST_ONE = 1, RS_BLEND_DST_SRC_COLOR = 2, RS_BLEND_DST_ONE_MINUS_SRC_COLOR = 3, RS_BLEND_DST_SRC_ALPHA = 4, RS_BLEND_DST_ONE_MINUS_SRC_ALPHA = 5, RS_BLEND_DST_DST_ALPHA = 6, RS_BLEND_DST_ONE_MINUS_DST_ALPHA = 7, RS_BLEND_DST_INVALID = 100, } rs_blend_dst_func; typedef enum { RS_CULL_BACK = 0, RS_CULL_FRONT = 1, RS_CULL_NONE = 2, RS_CULL_INVALID = 100, } rs_cull_mode; #endif //__LP64__ typedef enum { RS_SAMPLER_NEAREST = 0, RS_SAMPLER_LINEAR = 1, RS_SAMPLER_LINEAR_MIP_LINEAR = 2, RS_SAMPLER_WRAP = 3, RS_SAMPLER_CLAMP = 4, RS_SAMPLER_LINEAR_MIP_NEAREST = 5, RS_SAMPLER_MIRRORED_REPEAT = 6, RS_SAMPLER_INVALID = 100, } rs_sampler_value; #endif // (defined(RS_VERSION) && (RS_VERSION >= 16)) #endif // __RS_TYPES_RSH__