145 lines
4.8 KiB
Plaintext
145 lines
4.8 KiB
Plaintext
/*
|
|
* Copyright (C) 2011 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_allocation.rsh
|
|
* \brief Allocation routines
|
|
*
|
|
*
|
|
*/
|
|
|
|
#ifndef __RS_ALLOCATION_RSH__
|
|
#define __RS_ALLOCATION_RSH__
|
|
|
|
/**
|
|
* 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 *);
|
|
|
|
/**
|
|
* 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);
|
|
|
|
/**
|
|
* Copy part of an allocation from another allocation.
|
|
*
|
|
* @param dstAlloc Allocation to copy data into.
|
|
* @param dstOff The offset of the first element to be copied in
|
|
* the destination allocation.
|
|
* @param dstMip Mip level in the destination allocation.
|
|
* @param count The number of elements to be copied.
|
|
* @param srcAlloc The source data allocation.
|
|
* @param srcOff The offset of the first element in data to be
|
|
* copied in the source allocation.
|
|
* @param srcMip Mip level in the source allocation.
|
|
*/
|
|
extern void __attribute__((overloadable))
|
|
rsAllocationCopy1DRange(rs_allocation dstAlloc,
|
|
uint32_t dstOff, uint32_t dstMip,
|
|
uint32_t count,
|
|
rs_allocation srcAlloc,
|
|
uint32_t srcOff, uint32_t srcMip);
|
|
|
|
/**
|
|
* Copy a rectangular region into the allocation from another
|
|
* allocation.
|
|
*
|
|
* @param dstAlloc allocation to copy data into.
|
|
* @param dstXoff X offset of the region to update in the
|
|
* destination allocation.
|
|
* @param dstYoff Y offset of the region to update in the
|
|
* destination allocation.
|
|
* @param dstMip Mip level in the destination allocation.
|
|
* @param dstFace Cubemap face of the destination allocation,
|
|
* ignored for allocations that aren't cubemaps.
|
|
* @param width Width of the incoming region to update.
|
|
* @param height Height of the incoming region to update.
|
|
* @param srcAlloc The source data allocation.
|
|
* @param srcXoff X offset in data of the source allocation.
|
|
* @param srcYoff Y offset in data of the source allocation.
|
|
* @param srcMip Mip level in the source allocation.
|
|
* @param srcFace Cubemap face of the source allocation,
|
|
* ignored for allocations that aren't cubemaps.
|
|
*/
|
|
extern void __attribute__((overloadable))
|
|
rsAllocationCopy2DRange(rs_allocation dstAlloc,
|
|
uint32_t dstXoff, uint32_t dstYoff,
|
|
uint32_t dstMip,
|
|
rs_allocation_cubemap_face dstFace,
|
|
uint32_t width, uint32_t height,
|
|
rs_allocation srcAlloc,
|
|
uint32_t srcXoff, uint32_t srcYoff,
|
|
uint32_t srcMip,
|
|
rs_allocation_cubemap_face srcFace);
|
|
|
|
|
|
/**
|
|
* Extract a single element from an allocation.
|
|
*/
|
|
extern const void * __attribute__((overloadable))
|
|
rsGetElementAt(rs_allocation, uint32_t x);
|
|
/**
|
|
* \overload
|
|
*/
|
|
extern const void * __attribute__((overloadable))
|
|
rsGetElementAt(rs_allocation, uint32_t x, uint32_t y);
|
|
/**
|
|
* \overload
|
|
*/
|
|
extern const void * __attribute__((overloadable))
|
|
rsGetElementAt(rs_allocation, uint32_t x, uint32_t y, uint32_t z);
|
|
|
|
#endif
|
|
|