AMD Performance Library User's Manual - AMD Developer Central

AMD64 Architecture
AMD Performance Library
User’s Manual
Version 1.0
Copyright © 2006, 2007 Advanced Micro Devices, Inc.
All rights reserved.
Publication#: 40535

Publication # 40535 February 2007
Trademarks, Copyright, and Disclaimers
AMD, the AMD Arrow logo, and combinations thereof, and the AMD64 logo are trademarks of Advanced Micro Devices, Inc.
Copyright © 2006, 2007 Advanced Micro Devices, Inc. All rights reserved.
The contents of this document are provided in connection with Advanced Micro Devices, Inc. (“AMD”) products. AMD makes no
representations or warranties with respect to the accuracy or completeness of the contents of this publication and reserves the right to
make changes to specifications and product descriptions at any time without notice. The information contained herein may be of a
preliminary or advance nature and is subject to change without notice. No license, whether express, implied, arising by estoppel, or
otherwise, to any intellectual property rights are granted by this publication. Except as set forth in AMD’s Standard Terms and
Conditions of Sale, AMD assumes no liability whatsoever, and disclaims any express or implied warranty, relating to its products
including, but not limited to, the implied warranty of merchantability, fitness for a particular purpose, or infringement of any
intellectual property right.
AMD's products are not designed, intended, authorized or warranted for use as components in systems intended for surgical implant
into the body, or in other applications intended to support or sustain life, or in any other application in which the failure of AMD's
product could create a situation where personal injury, death, or severe property or environmental damage may occur. AMD reserves
the right to discontinue or make changes to its products at any time without notice.
AMD Performance Library User’s Manual 2 Trademarks, Copyright, and Disclaimers

Publication # 40535 February 2007
License Agreement
This software and any related documentation (the "Materials") are the confidential proprietary information of AMD.
Your use of the Materials in any manner indicates your compliance with the following terms and conditions. If you do not agree to
these terms and conditions, do not use the Materials.
Unless otherwise provided in a separate software agreement specifically licensing the Materials, the Materials are provided in
confidence and may only be used for internal evaluation. Notwithstanding the foregoing, the Materials may not be used for production
software, distributed, modified, or reproduced in whole or in part by any means.
LIMITATION OF LIABILITY: THE MATERIALS ARE PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND,
INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT, TITLE, FITNESS FOR ANY PARTICULAR
PURPOSE, OR WARRANTIES ARISING FORM CONDUCT, COURSE OF DEALING, OR USAGE OF TRADE. IN NO EVENT SHALL AMD OR ITS
LICENSORS BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS,
BUSINESS INTERRUPTION, OR LOSS OF INFORMATION) ARISING OUT OF THE USE OF OR INABILITY TO USE THE MATERIALS, EVEN
IF AMD HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME JURISDICTIONS PROHIBIT THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, AND NOTWITHSTANDING THE FAILURE OF
ESSENTIAL PURPOSE OF ANY REMEDY, THE ABOVE LIMITATION MAY NOT APPLY TO YOU.
AMD does not assume any responsibility for any errors which may appear in the Materials nor any responsibility to support or update
the Materials. AMD retains the right to modify the Materials at any time, without notice, and is not obligated to provide such modified
Materials to you.
U.S. GOVERNMENT RESTRICTED RIGHTS: The Materials are provided with "RESTRICTED RIGHTS." Use, duplication, or disclosure by
the Government is subject to the restrictions as set forth in FAR 52.227-14 and DFAR 252.227-7013, et seq., or its successor. Use of
the Materials by the Government constitutes acknowledgement of AMD's proprietary rights in them.
AMD Performance Library User’s Manual 3 License Agreement

Publication # 40535 February 2007
Table Of Contents
Introduction to the APL .................................................................................................................... 14
About This Manual ..........................................................................................................................................................14
Data Types......................................................................................................................................................................15
Return Value Glossary ....................................................................................................................................................15
Processing Operators .....................................................................................................................................................17
References......................................................................................................................................................................17
Base Library...................................................................................................................................... 18
Introduction ...................................................................................................................................................................18
Organization...................................................................................................................................................................18
Basic Concepts................................................................................................................................................................19
Data Structures ............................................................................................................................................................19
Enumerators ................................................................................................................................................................19
Parameter Glossary.......................................................................................................................................................19
Library Version ...............................................................................................................................................................20
GetLibVersion...............................................................................................................................................................20
Core Functions................................................................................................................................................................21
GetStatusString ............................................................................................................................................................21
GetCpuType .................................................................................................................................................................21
GetCpuClocks ...............................................................................................................................................................21
StaticInit .....................................................................................................................................................................22
StaticInitCpu ................................................................................................................................................................22
SetNumThreads ............................................................................................................................................................23
GetNumThreads............................................................................................................................................................23
Malloc .........................................................................................................................................................................23
Free............................................................................................................................................................................24
GetInitType..................................................................................................................................................................24
BaseData.....................................................................................................................................................................24
AMD Performance Library User’s Manual 4 Table of Contents

Publication # 40535 February 2007
Signal Processing Library ................................................................................................................. 25
Introduction ...................................................................................................................................................................25
Organization ................................................................................................................................................................25
Basic Concepts................................................................................................................................................................26
Parameter Glossary.......................................................................................................................................................26
Library Version ...............................................................................................................................................................28
GetLibVersion...............................................................................................................................................................28
Essential Vector Functions..............................................................................................................................................29
Add.............................................................................................................................................................................30
AddC...........................................................................................................................................................................32
Sub.............................................................................................................................................................................34
SubC...........................................................................................................................................................................36
SubCRev .....................................................................................................................................................................38
AddProduct ..................................................................................................................................................................40
And.............................................................................................................................................................................41
Or...............................................................................................................................................................................42
Xor .............................................................................................................................................................................43
AndC...........................................................................................................................................................................44
OrC.............................................................................................................................................................................45
XorC ...........................................................................................................................................................................46
Not .............................................................................................................................................................................47
LShiftC ........................................................................................................................................................................48
RShiftC........................................................................................................................................................................49
Mul .............................................................................................................................................................................50
MulC ...........................................................................................................................................................................52
Abs.............................................................................................................................................................................54
Sqrt ............................................................................................................................................................................55
Sqr .............................................................................................................................................................................57
Div .............................................................................................................................................................................58
DivC ...........................................................................................................................................................................60
DivCRev ......................................................................................................................................................................61
Cubrt ..........................................................................................................................................................................62
Exp.............................................................................................................................................................................63
Ln...............................................................................................................................................................................64
AMD Performance Library User’s Manual 5 Table of Contents

Publication # 40535 February 2007
10Log10 ......................................................................................................................................................................65
Arctan .........................................................................................................................................................................66
Threshold_LTVal ...........................................................................................................................................................67
Threshold_GTVal...........................................................................................................................................................68
Threshold_LTValGTVal ...................................................................................................................................................69
Threshold_LT ...............................................................................................................................................................71
Threshold_GT...............................................................................................................................................................72
Threshold ....................................................................................................................................................................73
Threshold_LTInv ...........................................................................................................................................................74
Magnitude....................................................................................................................................................................75
Convert .......................................................................................................................................................................76
Max ............................................................................................................................................................................78
MaxIndx ......................................................................................................................................................................79
MaxAbs .......................................................................................................................................................................80
MaxAbsIndx .................................................................................................................................................................81
Min .............................................................................................................................................................................82
MinIndx.......................................................................................................................................................................83
MinAbs ........................................................................................................................................................................84
MinAbsIndx..................................................................................................................................................................85
MinMax .......................................................................................................................................................................86
MinMaxIndx .................................................................................................................................................................87
Norm_Inf.....................................................................................................................................................................88
Norm_L1 .....................................................................................................................................................................89
Norm_L2 .....................................................................................................................................................................90
NormDiff_Inf ................................................................................................................................................................91
NormDiff_L1.................................................................................................................................................................92
NormDiff_L2.................................................................................................................................................................93
Mean...........................................................................................................................................................................94
MaxEvery.....................................................................................................................................................................95
MinEvery .....................................................................................................................................................................96
DotProd.......................................................................................................................................................................97
Sum............................................................................................................................................................................99
StdDev...................................................................................................................................................................... 100
AMD Performance Library User’s Manual 6 Table of Contents

Publication # 40535 February 2007
Fixed Accuracy Arithmetic Functions ............................................................................................................................101
Inv ........................................................................................................................................................................... 102
Div ........................................................................................................................................................................... 103
Sqrt .......................................................................................................................................................................... 104
InvSqrt...................................................................................................................................................................... 105
Cbrt .......................................................................................................................................................................... 106
InvCbrt ..................................................................................................................................................................... 107
Pow .......................................................................................................................................................................... 108
Powx......................................................................................................................................................................... 109
Exp........................................................................................................................................................................... 110
Ln............................................................................................................................................................................. 111
Log10 ....................................................................................................................................................................... 112
Vector Initialization Functions......................................................................................................................................113
Copy ......................................................................................................................................................................... 114
Move......................................................................................................................................................................... 115
Set ........................................................................................................................................................................... 116
Zero.......................................................................................................................................................................... 117
Transform Functions.....................................................................................................................................................118
ConjPack ................................................................................................................................................................... 119
ConjPerm................................................................................................................................................................... 120
ConjCcs..................................................................................................................................................................... 121
MulPack..................................................................................................................................................................... 122
MulPerm .................................................................................................................................................................... 123
MulPackConj .............................................................................................................................................................. 124
FFTInitAlloc ................................................................................................................................................................ 125
FFTFree ..................................................................................................................................................................... 126
FFTInit ...................................................................................................................................................................... 127
FFTGetSize................................................................................................................................................................. 129
FFTGetBufSize ............................................................................................................................................................ 130
FFTFwd_CToC............................................................................................................................................................. 131
FFTInv_CToC.............................................................................................................................................................. 133
FFTFwd_RToCCS......................................................................................................................................................... 135
FFTFwd_RToPack ........................................................................................................................................................ 137
FFTFwd_RToPerm ....................................................................................................................................................... 138
AMD Performance Library User’s Manual 7 Table of Contents

Publication # 40535 February 2007
FFTInv_CCSToR.......................................................................................................................................................... 139
FFTInv_PackToR ......................................................................................................................................................... 140
FFTInv_PermToR ........................................................................................................................................................ 141
Image Processing Library ............................................................................................................... 142
Introduction .................................................................................................................................................................142
Organization .............................................................................................................................................................. 142
Basic Concepts..............................................................................................................................................................142
Data Structures .......................................................................................................................................................... 143
Enumerators .............................................................................................................................................................. 143
Color Channel Buffers .................................................................................................................................................. 143
Color Plane Buffers...................................................................................................................................................... 143
Regions of Interest...................................................................................................................................................... 144
Image Masking ........................................................................................................................................................... 144
Borders in Image Functions .......................................................................................................................................... 145
Parameter Glossary..................................................................................................................................................... 148
Library Version .............................................................................................................................................................154
GetLibVersion............................................................................................................................................................. 154
Support Functions ........................................................................................................................................................155
Malloc ....................................................................................................................................................................... 156
Free.......................................................................................................................................................................... 158
Image Data Exchange and Initialization Functions.......................................................................................................159
Convert ..................................................................................................................................................................... 160
Copy ......................................................................................................................................................................... 162
Swap ........................................................................................................................................................................ 165
Set ........................................................................................................................................................................... 167
Scale......................................................................................................................................................................... 169
Arithmetic and Logic Functions.....................................................................................................................................171
Abs........................................................................................................................................................................... 172
AbsDiff ...................................................................................................................................................................... 174
AbsDiffC .................................................................................................................................................................... 175
Add........................................................................................................................................................................... 176
AddC......................................................................................................................................................................... 179
AddProduct ................................................................................................................................................................ 182
AddSquare................................................................................................................................................................. 184
AMD Performance Library User’s Manual 8 Table of Contents

Publication # 40535 February 2007
AddWeighted.............................................................................................................................................................. 185
Div ........................................................................................................................................................................... 187
DivC ......................................................................................................................................................................... 190
Exp........................................................................................................................................................................... 192
Ln............................................................................................................................................................................. 193
Mul ........................................................................................................................................................................... 194
MulC ......................................................................................................................................................................... 197
MulScale.................................................................................................................................................................... 200
MulCScale.................................................................................................................................................................. 202
Sqr ........................................................................................................................................................................... 204
Sqrt .......................................................................................................................................................................... 206
Sub........................................................................................................................................................................... 208
SubC......................................................................................................................................................................... 211
And........................................................................................................................................................................... 214
AndC......................................................................................................................................................................... 216
Comp ........................................................................................................................................................................ 218
Not ........................................................................................................................................................................... 219
Or............................................................................................................................................................................. 220
OrC........................................................................................................................................................................... 222
LShiftC ...................................................................................................................................................................... 224
RShiftC...................................................................................................................................................................... 226
Xor ........................................................................................................................................................................... 228
XorC ......................................................................................................................................................................... 230
Color Model Conversion Functions ................................................................................................................................232
RGBToYUV ................................................................................................................................................................. 233
YUVToRGB ................................................................................................................................................................. 234
RGBToYUV422............................................................................................................................................................ 235
YUV422ToRGB............................................................................................................................................................ 237
RGBToYUV420............................................................................................................................................................ 239
YUV420ToRGB............................................................................................................................................................ 241
YUV420ToBGR............................................................................................................................................................ 243
YUV420ToRGB* .......................................................................................................................................................... 244
YUV420ToBGR* .......................................................................................................................................................... 246
RGBToYCbCr .............................................................................................................................................................. 248
AMD Performance Library User’s Manual 9 Table of Contents

Publication # 40535 February 2007
YCbCrToRGB .............................................................................................................................................................. 249
YCbCrToRGB*............................................................................................................................................................. 250
YCbCrToBGR* ............................................................................................................................................................ 252
RGBToYCbCr422 ......................................................................................................................................................... 254
YCbCr422ToRGB ......................................................................................................................................................... 255
RGBToCbYCr422* ....................................................................................................................................................... 256
CbYCr422ToRGB ......................................................................................................................................................... 257
BGRToCbYCr422 ......................................................................................................................................................... 258
CbYCr422ToBGR ......................................................................................................................................................... 259
YCbCr422ToRGB* ....................................................................................................................................................... 260
YCbCr422ToBGR* ....................................................................................................................................................... 262
RGBToYCbCr420 ......................................................................................................................................................... 264
BGRToYCbCr420 ......................................................................................................................................................... 265
YCbCr420ToRGB ......................................................................................................................................................... 266
YCbCr420ToRGB* ....................................................................................................................................................... 267
YCbCr420ToBGR ......................................................................................................................................................... 269
YCbCr420ToBGR* ....................................................................................................................................................... 270
YCbCr411ToBGR ......................................................................................................................................................... 272
RGBToXYZ ................................................................................................................................................................. 273
XYZToRGB ................................................................................................................................................................. 275
RGBToLUV ................................................................................................................................................................. 277
LUVToRGB ................................................................................................................................................................. 280
BGRToLab.................................................................................................................................................................. 282
LabToBGR.................................................................................................................................................................. 284
RGBToYCC ................................................................................................................................................................. 286
YCCToRGB ................................................................................................................................................................. 288
RGBToHLS ................................................................................................................................................................. 290
HLSToRGB ................................................................................................................................................................. 292
BGRToHLS ................................................................................................................................................................. 295
HLSToBGR ................................................................................................................................................................. 297
RGBToHSV................................................................................................................................................................. 300
HSVToRGB................................................................................................................................................................. 302
AMD Performance Library User’s Manual 10 Table of Contents

Publication # 40535 February 2007
Threshold and Compare Functions................................................................................................................................304
Threshold .................................................................................................................................................................. 305
Threshold_GT............................................................................................................................................................. 307
Threshold_LT ............................................................................................................................................................. 309
Threshold_Val ............................................................................................................................................................ 311
Threshold_GTVal......................................................................................................................................................... 313
Threshold_LTVal ......................................................................................................................................................... 315
Threshold_LTValGTVal ................................................................................................................................................. 317
Compare ................................................................................................................................................................... 319
CompareC.................................................................................................................................................................. 321
CompareEqualEps ....................................................................................................................................................... 323
CompareEqualEpsC ..................................................................................................................................................... 324
Geometric Transform Functions....................................................................................................................................325
Resize ....................................................................................................................................................................... 326
ResizeCenter .............................................................................................................................................................. 328
GetResizeFract ........................................................................................................................................................... 330
ResizeShift................................................................................................................................................................. 331
ResizeSqrPixelGetBufSize ............................................................................................................................................. 333
ResizeSqrPixel ............................................................................................................................................................ 334
ResizeYUV422 ............................................................................................................................................................ 337
Mirror........................................................................................................................................................................ 338
Remap ...................................................................................................................................................................... 340
Rotate....................................................................................................................................................................... 342
GetRotateShift............................................................................................................................................................ 344
AddRotateShift ........................................................................................................................................................... 345
GetRotateQuad........................................................................................................................................................... 346
GetRotateBound ......................................................................................................................................................... 347
RotateCenter.............................................................................................................................................................. 348
Shear........................................................................................................................................................................ 350
GetShearQuad............................................................................................................................................................ 353
GetShearBound .......................................................................................................................................................... 354
WarpAffine................................................................................................................................................................. 355
WarpAffineBack .......................................................................................................................................................... 357
WarpAffineQuad.......................................................................................................................................................... 359
AMD Performance Library User’s Manual 11 Table of Contents

Publication # 40535 February 2007
GetAffineQuad ............................................................................................................................................................ 361
GetAffineBound .......................................................................................................................................................... 362
GetAffineTransform ..................................................................................................................................................... 363
WarpPerspective ......................................................................................................................................................... 364
WarpPerspectiveBack .................................................................................................................................................. 366
WarpPerspectiveQuad.................................................................................................................................................. 368
GetPerspectiveQuad .................................................................................................................................................... 370
GetPerspectiveBound................................................................................................................................................... 371
GetPerspectiveTransform ............................................................................................................................................. 372
WarpBilinear .............................................................................................................................................................. 373
WarpBilinearBack........................................................................................................................................................ 375
WarpBilinearQuad ....................................................................................................................................................... 377
GetBilinearQuad ......................................................................................................................................................... 379
GetBilinearBound ........................................................................................................................................................ 380
GetBilinearTransform................................................................................................................................................... 381
Digital Filter Functions .................................................................................................................................................382
Sharpen .................................................................................................................................................................... 383
FilterBox.................................................................................................................................................................... 384
FilterBoxInplace.......................................................................................................................................................... 386
FilterMin .................................................................................................................................................................... 387
FilterMax ................................................................................................................................................................... 389
SumWindowRow ......................................................................................................................................................... 391
SumWindow............................................................................................................................................................... 392
FilterMedian ............................................................................................................................................................... 393
FilterMedianHoriz ........................................................................................................................................................ 395
FilterMedianVert ......................................................................................................................................................... 397
FilterMedianCross........................................................................................................................................................ 399
FilterMedianColor ........................................................................................................................................................ 401
Filter ......................................................................................................................................................................... 403
Filter32f .................................................................................................................................................................... 405
FilterColumn .............................................................................................................................................................. 407
FilterColumn32f .......................................................................................................................................................... 409
FilterRow ................................................................................................................................................................... 411
FilterRow32f............................................................................................................................................................... 413
AMD Performance Library User’s Manual 12 Table of Contents

Publication # 40535 February 2007
FilterPrewittHoriz ........................................................................................................................................................ 415
FiltePrewittVert........................................................................................................................................................... 416
FilterScharrHoriz ......................................................................................................................................................... 417
FilterScharrVert .......................................................................................................................................................... 418
FilterSobelHoriz .......................................................................................................................................................... 419
FilterSobelVert............................................................................................................................................................ 421
FilterSobelHorizSecond ................................................................................................................................................ 423
FilterSobelVertSecond.................................................................................................................................................. 424
FilterSobelCross.......................................................................................................................................................... 425
FilterRobertsDown....................................................................................................................................................... 426
FilterRobertsUp........................................................................................................................................................... 427
FilterLaplace............................................................................................................................................................... 428
FilterGauss................................................................................................................................................................. 430
FilterHipass ................................................................................................................................................................ 432
FilterLowpass ............................................................................................................................................................. 434
Video Coding Functions ................................................................................................................................................436
GetDiff ...................................................................................................................................................................... 437
SqrDiff ...................................................................................................................................................................... 439
VarMean .................................................................................................................................................................... 440
VarMeanDiff ............................................................................................................................................................... 441
Variance16X16 ........................................................................................................................................................... 442
EdgesDetect............................................................................................................................................................... 443
SAD .......................................................................................................................................................................... 444
SumsDiff ................................................................................................................................................................... 445
MC............................................................................................................................................................................ 446
AMD Performance Library User’s Manual 13 Table of Contents

Publication # 40535 February 2007
Introduction to the APL
The AMD Programming Library (APL) is a collection of highly-optimized functions for use in a variety of programming domains. All
implementations of the libraries provide C and C++ programmers ANSI C style interfaces.
The APL consists of three library modules:
• The Base library consists of functions essential for primary tasks such as memory allocation and functions that manage the
performance of other library functions.
• The Signal Processing library consists of primitives that perform signal processing.
• The Image Processing library consists of image and video processing functions.
APL functions are geared to yield maximum performance on the x86 and the AMD64 hardware architectures. Current implementations
exploit single instruction multiple data (SIMD) instructions. Specifically, the streaming SIMD extensions (SSE1, SSE2) are used to
optimize for speed. Programmers can concentrate on task functionality because the APL handles performance. Many of the functions
are threaded internally; the programmer has the flexibility of controlling the number of threads and of turning off threading. As the
architecture is extended and new instructions are added, new code-paths that take advantage of the extensions will be added to the
APL, without changing the programming interface and existing functionality.
About This Manual
This manual describes each of the APL functions in detail. Each APL release includes a complete version of the manual that is unique to
the release. The version number of the manual is the same as the APL version number.
As new groups of functions are added in subsequent releases of the APL, new chapters are added to the manual.
The manual is written for experienced software developers. To understand the functional descriptions, a developer must have a
working knowledge of application-specific terminology and techniques, and must be reasonably proficient in the C programming
language.
The manual consists of sections that cover each library module. Each section contains introductory material and chapters that describe
groups of functions that perform operations of the same kind. Within the chapters, each functional description, or block, consists of a
Function Name followed by a short description, a Synopsis of the function syntax, a list of function Parameters, a detailed
Description of the function, and a list of Return Values. The Basic Concepts chapters in each section provide information related to
the functions in the section.
AMD Performance Library User’s Manual 14 Introduction to the APL

Publication # 40535 February 2007
Data Types
All APL function definitions use the following data types.
Apl8s 8-bit signed integer
Apl8u 8-bit unsigned integer
Apl16s 16-bit signed integer
Apl16u 16-bit unsigned integer
Apl16sc 16-bit signed complex number
Apl32s 32-bit signed integer
Apl32u 32-bit unsigned integer
Apl32f 32-bit floating-point number
Apl32sc 32-bit signed complex number
Apl32fc 32-bit floating-point complex number
Apl64s 64-bit signed integer
Apl64u 64-bit unsigned integer
Apl64f 64-bit floating-point number
Apl64sc 64-bit signed complex number
Apl64fc 64-bit floating-point complex number
Return Value Glossary
All APL functions return an enumerated integer value (AplStatus) that precisely reports the result of execution. The following table
defines all possible return values. Refer to the individual function listing for detailed information.
aplStsAnchorErr The anchor is located out of the mask.
aplStsChannelOrderErr The given destination order is not valid (contains values other than 0,1,2).
aplStsCoeffErr The coefficient values have errors.
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsCpuMismatch The specified CPU type cannot be assigned.
aplStsDivisorErr The divisor is zero.
aplStsDomain Argument out of function domain warning status code.
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsEpsValErr Eps is a negative value.
aplStsFftFlagErr The flag value is incorrect.
aplStsFftOrderErr The specified order is out of bounds.
AMD Performance Library User’s Manual 15 Introduction to the APL

Publication # 40535 February 2007
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsLnNegArg Negative input buffer element warning status code.
aplStsLnZeroArg Zero-valued input buffer element warning status code.
aplStsMaskErr The mask size is invalid.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsMirrorFlipErr The mirror flip value is invalid.
aplStsNoErr No error detected.
aplStsNotEvenStepErr One of the step values for a floating point images is not divisible by four.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsNumChannelErr The number of channels is incorrect.
aplStsOverflow Overflow in operation warning status code.
aplStsQuadErr
The source or destination quadrangle degenerates into a triangle, line, or points; or the destination quadrangle
has conflicted vertex coordinates.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsResizeNoOperationErr A destination image dimension is less than one pixel.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsThresholdErr The less-than threshold is greater than the greater-than threshold.
aplStsUnderflow Underflow in operation warning status code.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
aplStsZeroMaskValuesErr All mask values are equal to zero.
AMD Performance Library User’s Manual 16 Introduction to the APL

Publication # 40535 February 2007
Processing Operators
APL function definitions use the following notation to indicate specific operations.
I Function operates in-place (source and destination locations are the same)
R Function operates on an ROI (iterative, used only in the Image Processing Library)
M Function performs a masking operation
Sfs Function performs a scaled integer calculation
References
AMD64 Architecture Programmers Manual:
Volume 1, Application Programming, Order Number 24592
Volume 2, System Programming, Order Number 24593
Volume 3, General-Purpose and System Instructions, Order Number 24594
Volume 4, 128-Bit Media Instructions, Order Number 26568
Volume 5, 64-Bit Media and x87 Floating-Point Instructions, Order Number 26569
AMD Performance Library User’s Manual 17 Introduction to the APL

Publication # 40535 February 2007
Base Library
Introduction
AMD Performance Library (APL) base library functions perform essential support and initialization tasks.
This section of the manual describes each of the functions in detail.
Organization
Two introductory chapters are followed by chapters that describe groups of functions related by purpose.
• This Introduction provides a brief summary of the section.
• Basic Concepts provides an overview of the information contained in the functional descriptions.
• Library Version describes the APL function that provides library version information.
• Core Functions describes the status string, CPU type, CPU clocking, CPU initialization, threading control, and memory
allocation functions.
Within the chapters, each functional description consists of a Function Name followed by a short description, a Synopsis of the
function syntax, a list of function Parameters, a detailed Description of the function, and a list of Return Values.
AMD Performance Library User’s Manual 18 Base Library

Publication # 40535 February 2007
Basic Concepts
Base library functional descriptions include the following types of information.
Data Structures
Base library function definitions use the following data structures.
AplLibraryVersion Version information of library.
AplRoundMode Mode of rounding in data type conversion.
AplWinType Type of window for generating FIR filter coefficients.
Enumerators
Base library function definitions use the following enumerators.
AplBool Type of Boolean values.
AplCmpOp Type of comparison operation.
AplCpuType Type of CPU with presence of streaming SIMD extensions.
AplHintAlgorithm Hint to favor speed or accuracy.
Parameter Glossary
Base library function definitions use the following parameters.
StsCode Specifies the status code used by the AplStatus function.
cpu Specifies a CPU type.
length Specifies a number of bytes to be allocated.
numThr Specifies the maximum number of threads that can be used by any APL function.
ptr Pointer to memory buffer
AMD Performance Library User’s Manual 19 Base Library

Publication # 40535 February 2007
Library Version
This chapter describes the APL function that provides library version information.
GetLibVersion
Library version
Synopsis
const AplLibraryVersion* aplGetLibVersion ( );
Description
This function returns a pointer to the AplLibraryVersion structure that contains APL Library version information.
AMD Performance Library User’s Manual 20 Base Library

Publication # 40535 February 2007
Core Functions
This chapter describes the status string, CPU type, CPU clocking, CPU initialization, threading control, and memory allocation functions.
GetStatusString
Get status message string
Synopsis
const char * aplGetStatusString ( AplStatus StsCode );
Parameters
StsCode Specifies the status code used by the AplStatus function.
Description
This functions returns a string that describes the meaning of any AplStatus enumerated integer.
GetCpuType
Get CPU Type
Synopsis
AplCpuType aplGetCpuType ( );
Description
This function returns the level of SSE support that is present. It can be used to identify the CPU type.
GetCpuClocks
Get CPU clock cycles
Synopsis
Apl64u aplGetCpuClocks ( );
Description
This function returns the number of CPU clock cycles elapsed since CPU power on. A code segment can be timed by invoking the
function at two different points, then subtracting the first return value from the second return value.
AMD Performance Library User’s Manual 21 Base Library

Publication # 40535 February 2007
StaticInit
Initialize to an appropriate CPU type
Synopsis
AplStatus aplStaticInit ( );
Description
This function initializes the APL internal dispatcher to use the most appropriate CPU type.
Return Values
aplStsNoErr No error detected.
StaticInitCpu
Initialize to a specified CPU type
Synopsis
AplStatus aplStaticInitCpu ( AplCpuType cpu );
Parameters
cpu Specifies a CPU type.
Description
This function initializes the APL internal dispatcher to use a specified CPU type.
Return Values
aplStsCpuMismatch The specified CPU type cannot be assigned.
aplStsNoErr No error detected.
AMD Performance Library User’s Manual 22 Base Library

Publication # 40535 February 2007
SetNumThreads
Set number of threads
Synopsis
AplStatus aplSetNumThreads ( unsigned int numThr );
Parameters
numThr Specifies the maximum number of threads that can be used by any APL function.
Description
This function defines the maximum number of threads that can be used by any APL function. Set numThr to 1 to turn threading off.
Return Values
aplStsNoErr No error detected.
GetNumThreads
Get number of threads
Synopsis
Apl32u aplGetNumThreads ( );
Description
This function returns the maximum number of threads that can be used by any APL function.
Malloc
Allocate memory
Synopsis
void * aplMalloc ( int length );
Parameters
length Specifies a number of bytes to be allocated.
Description
This function allocates a memory buffer of length bytes and returns a pointer to it.
AMD Performance Library User’s Manual 23 Base Library

Publication # 40535 February 2007
Free
Free memory
Synopsis
void aplFree ( void * ptr );
Parameters
ptr Pointer to a memory buffer.
Description
This function frees the memory buffer pointed to by ptr.
GetInitType
GetInitType
Synopsis
int aplGetInitType ( );
Description
This function is for APL internal use.
BaseData
BaseData
Synopsis
void * aplBaseData ( );
Description
This function is for APL internal use.
AMD Performance Library User’s Manual 24 Base Library

Publication # 40535 February 2007
Signal Processing Library
Introduction
The AMD Performance Library (APL) signal processing functions perform a number of functions related to signal processing. This
section of the manual describes each of the signal processing functions in detail.
Organization
Two introductory chapters are followed by chapters that describe groups of functions related by purpose.
• This Introduction provides a brief summary of the section.
• Basic Concepts provides an overview of the information contained in the functional descriptions.
• Library Version describes the APL function that returns the library version.
• Essential Vector Functions describes functions that perform vector calculations.
• Fixed Accuracy Arithmetic Functions describes functions that perform arithmetic operations at a chosen level of accuracy.
• Vector Initialization Functions describes functions that perform vector initialization tasks.
• Transform Functions describes functions that perform frequency and time domain transformation.
Within the chapters, each functional description consists of a Function Name followed by a short description, a Synopsis of the
function syntax, a list of function Parameters, a detailed Description of the function, and a list of Return Values.
AMD Performance Library User’s Manual 25 Signal Processing Library

Publication # 40535 February 2007
Basic Concepts
APL functional descriptions include the following types of information.
Parameter Glossary
Signal library function definitions use the following parameters.
flag Specifies the FFT division type. It is enumerated in aplBase.h.
hint Hints whether to choose a fast or accurate computation algorithm.
len Specifies the number of elements in a buffer.
lenDst Specifies the number of elements in a destination vector.
length Specifies the number of elements in a vector.
level Specifies a threshold level.
levelGT Specifies a threshold level for greater-than comparison.
levelLT Specifies a threshold level for less-than comparison.
order Order of an FFT signal. The length of the signal is 2^order.
pBufInit Pointer to memory required for FFT initialization.
pBuffer Pointer to the FFT work buffer.
pDp Pointer to the destination buffer that contains the dot product of the source buffers.
pDst Pointer to a destination buffer.
pDst1 Pointer to destination buffer one.
pDst2 Pointer to destination buffer two.
pDstIm Pointer to a destination buffer that contains the imaginary component values of an output signal.
pDstRe Pointer to a destination buffer that contains the real component values of an output signal.
pFFTSpec Pointer to the FFT specification structure.
pIndx Pointer to the destination buffer that contains the index of the maximum or minimum value in the source buffer.
pMax Pointer to the destination buffer that contains the maximum value in the source buffer.
pMaxAbs Pointer to the destination buffer that contains the maximum absolute value in the source buffer.
pMaxIndx Pointer to the destination buffer that contains the index of the maximum value in the source vector.
pMean Pointer to the destination buffer that contains the mean of the values in the source buffer.
pMemSpec Pointer to memory where the FFT specification structure is initialized.
pMin Pointer to a destination buffer that contains the minimum value in the source buffer.
pMinAbs Pointer to a destination buffer that contains the minimum absolute value in the source buffer.
AMD Performance Library User’s Manual 26 Signal Processing Library

Publication # 40535 February 2007
pMinIndx Pointer to a destination buffer that contains the index of the minimum value in the source buffer.
pNorm
Pointer to a destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSize Pointer to the size of the FFT work buffer used by the FFTFwd and FFTInv functions.
pSizeBuf Pointer to the size of the FFT work buffer used by the FFTFwd and FFTInv functions.
pSizeInit Pointer to the size of the BufInit buffer used by the FFTInit function.
pSizeSpec Pointer to the size of the MemSpec buffer used by the FFTInit function.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
pSrcDstIm Pointer to a source/destination buffer that contains the imaginary components of input and output signals.
pSrcDstRe Pointer to a source/destination buffer that contains the real components of input and output signals.
pSrcIm Pointer to a source buffer that contains the imaginary component values of an input signal.
pSrcRe Pointer to a source buffer that contains the real component values of an input signal.
pStdDev Pointer to the destination buffer that contains the standard deviation of the values in the source buffer.
pSum Pointer to the destination buffer that contains the sum of all the elements in the source buffer.
ppFFTSpec Double pointer to the FFT specification structure.
relOp Constant that indicates which relational operation to perform.
rndMode Constant that indicates which rounding mode to use when converting from a scalar to an integer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
value Specified value.
valueGT Specifies a value to set when a greater-than comparison evaluates as true.
valueLT Specifies a value to set a less-than comparison evaluates as true.
AMD Performance Library User’s Manual 27 Signal Processing Library

Publication # 40535 February 2007
Library Version
This chapter describes the APL function that provides library version information.
GetLibVersion
Get library version
Synopsis
const AplLibraryVersion* aplsGetLibVersion ( );
const AplLibraryVersion* aplacGetLibVersion ( );
const AplLibraryVersion* aplchGetLibVersion ( );
const AplLibraryVersion* apldcGetLibVersion ( );
const AplLibraryVersion* aplscGetLibVersion ( );
const AplLibraryVersion* aplsrGetLibVersion ( );
const AplLibraryVersion* aplvmGetLibVersion ( );
Description
This function returns a pointer to the AplLibraryVersion structure that contains APL Library version information.
AMD Performance Library User’s Manual 28 Signal Processing Library

Publication # 40535 February 2007
Essential Vector Functions
This chapter describes functions that perform vector calculations.
AMD Performance Library User’s Manual 29 Signal Processing Library

Publication # 40535 February 2007
Add
Add
Synopsis
AplStatus aplsAdd_32u ( const Apl32u* pSrc1 , const Apl32u* pSrc2 , Apl32u* pDst , int len );
AplStatus aplsAdd_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsAdd_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
AplStatus aplsAdd_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , Apl32fc* pDst , int len );
AplStatus aplsAdd_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , Apl64fc* pDst , int len );
AplStatus aplsAdd_8u16u ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl16u* pDst , int len );
AplStatus aplsAdd_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsAdd_16s_I ( const Apl16s* pSrc , Apl16s* pSrcDst , int len );
AplStatus aplsAdd_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
AplStatus aplsAdd_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int len );
AplStatus aplsAdd_32fc_I ( const Apl32fc* pSrc , Apl32fc* pSrcDst , int len );
AplStatus aplsAdd_64fc_I ( const Apl64fc* pSrc , Apl64fc* pSrcDst , int len );
AplStatus aplsAdd_16s32s_I ( const Apl16s* pSrc , Apl32s* pSrcDst , int len );
AplStatus aplsAdd_8u_Sfs ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsAdd_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsAdd_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsAdd_16sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsAdd_32sc_Sfs ( const Apl32sc* pSrc1 , const Apl32sc* pSrc2 , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsAdd_8u_ISfs ( const Apl8u* pSrc , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsAdd_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAdd_32s_ISfs ( const Apl32s* pSrc , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAdd_16sc_ISfs ( const Apl16sc* pSrc , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsAdd_32sc_ISfs ( const Apl32sc* pSrc , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 30 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in two source buffers and add the data in buffer 2 to the data in buffer 1. The sum can
be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and
32-bit signed complex versions perform an integer scaling operation before writing the results. Other versions add signed and
unsigned integers and write 32-bit floating point results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 31 Signal Processing Library

Publication # 40535 February 2007
AddC
Add constant
Synopsis
AplStatus aplsAddC_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsAddC_64f ( const Apl64f* pSrc , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsAddC_32fc ( const Apl32fc* pSrc , Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsAddC_64fc ( const Apl64fc* pSrc , Apl64fc val , Apl64fc* pDst , int len );
AplStatus aplsAddC_16s_I ( Apl16s val , Apl16s* pSrcDst , int len );
AplStatus aplsAddC_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
AplStatus aplsAddC_64f_I ( Apl64f val , Apl64f* pSrcDst , int len );
AplStatus aplsAddC_32fc_I ( Apl32fc val , Apl32fc* pSrcDst , int len );
AplStatus aplsAddC_64fc_I ( Apl64fc val , Apl64fc* pSrcDst , int len );
AplStatus aplsAddC_8u_Sfs ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsAddC_16s_Sfs ( const Apl16s* pSrc , Apl16s val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsAddC_32s_Sfs ( const Apl32s* pSrc , Apl32s val , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsAddC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc val , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsAddC_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc val , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsAddC_8u_ISfs ( Apl8u val , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddC_16s_ISfs ( Apl16s val , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddC_32s_ISfs ( Apl32s val , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddC_16sc_ISfs ( Apl16sc val , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddC_32sc_ISfs ( Apl32sc val , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
Description
These functions step through vector elements in a source buffer and add a specified constant value to the source data. The sum can be
written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 32 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 33 Signal Processing Library

Publication # 40535 February 2007
Sub
Subtract
Synopsis
AplStatus aplsSub_16s ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int len );
AplStatus aplsSub_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsSub_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
AplStatus aplsSub_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , Apl32fc* pDst , int len );
AplStatus aplsSub_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , Apl64fc* pDst , int len );
AplStatus aplsSub_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsSub_16s_I ( const Apl16s* pSrc , Apl16s* pSrcDst , int len );
AplStatus aplsSub_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
AplStatus aplsSub_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int len );
AplStatus aplsSub_32fc_I ( const Apl32fc* pSrc , Apl32fc* pSrcDst , int len );
AplStatus aplsSub_64fc_I ( const Apl64fc* pSrc , Apl64fc* pSrcDst , int len );
AplStatus aplsSub_8u_Sfs ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsSub_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSub_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsSub_16sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsSub_32sc_Sfs ( const Apl32sc* pSrc1 , const Apl32sc* pSrc2 , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsSub_8u_ISfs ( const Apl8u* pSrc , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSub_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSub_32s_ISfs ( const Apl32s* pSrc , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSub_16sc_ISfs ( const Apl16sc* pSrc , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsSub_32sc_ISfs ( const Apl32sc* pSrc , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 34 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in two source buffers and subtract the data in buffer 1 from the data in buffer 2. The
difference can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 35 Signal Processing Library

Publication # 40535 February 2007
SubC
Subtract a constant
Synopsis
AplStatus aplsSubC_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsSubC_32fc ( const Apl32fc* pSrc , Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsSubC_64f ( const Apl64f* pSrc , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsSubC_64fc ( const Apl64fc* pSrc , Apl64fc val , Apl64fc* pDst , int len );
AplStatus aplsSubC_16s_I ( Apl16s val , Apl16s* pSrcDst , int len );
AplStatus aplsSubC_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
AplStatus aplsSubC_64f_I ( Apl64f val , Apl64f* pSrcDst , int len );
AplStatus aplsSubC_32fc_I ( Apl32fc val , Apl32fc* pSrcDst , int len );
AplStatus aplsSubC_64fc_I ( Apl64fc val , Apl64fc* pSrcDst , int len );
AplStatus aplsSubC_8u_Sfs ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsSubC_16s_Sfs ( const Apl16s* pSrc , Apl16s val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSubC_32s_Sfs ( const Apl32s* pSrc , Apl32s val , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsSubC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc val , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsSubC_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc val , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsSubC_8u_ISfs ( Apl8u val , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubC_16s_ISfs ( Apl16s val , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubC_32s_ISfs ( Apl32s val , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubC_16sc_ISfs ( Apl16sc val , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubC_32sc_ISfs ( Apl32sc val , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
Description
These functions step through vector elements in a source buffer and subtract a specified constant value from the source data. The
difference can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 36 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 37 Signal Processing Library

Publication # 40535 February 2007
SubCRev
Subtract from a constant
Synopsis
AplStatus aplsSubCRev_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsSubCRev_64f ( const Apl64f* pSrc , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsSubCRev_32fc ( const Apl32fc* pSrc , Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsSubCRev_64fc ( const Apl64fc* pSrc , Apl64fc val , Apl64fc* pDst , int len );
AplStatus aplsSubCRev_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
AplStatus aplsSubCRev_64f_I ( Apl64f val , Apl64f* pSrcDst , int len );
AplStatus aplsSubCRev_32fc_I ( Apl32fc val , Apl32fc* pSrcDst , int len );
AplStatus aplsSubCRev_64fc_I ( Apl64fc val , Apl64fc* pSrcDst , int len );
AplStatus aplsSubCRev_8u_Sfs ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsSubCRev_16s_Sfs ( const Apl16s* pSrc , Apl16s val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSubCRev_32s_Sfs ( const Apl32s* pSrc , Apl32s val , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsSubCRev_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc val , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsSubCRev_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc val , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsSubCRev_8u_ISfs ( Apl8u val , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubCRev_16s_ISfs ( Apl16s val , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubCRev_32s_ISfs ( Apl32s val , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubCRev_16sc_ISfs ( Apl16sc val , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsSubCRev_32sc_ISfs ( Apl32sc val , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
Description
These functions step through vector elements in a source buffer and subtract source data from a specified constant value. The
difference can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 38 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 39 Signal Processing Library

Publication # 40535 February 2007
AddProduct
Add product
Synopsis
AplStatus aplsAddProduct_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pSrcDst , int len );
AplStatus aplsAddProduct_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pSrcDst , int len );
AplStatus aplsAddProduct_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , Apl32fc* pSrcDst , int len );
AplStatus aplsAddProduct_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , Apl64fc* pSrcDst , int len );
AplStatus aplsAddProduct_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddProduct_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsAddProduct_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl32s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in two source buffers, add the product of the data in buffer 1 and the data in buffer 2 to
the data in buffer 1, and write the sum back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 40 Signal Processing Library

Publication # 40535 February 2007
And
AND
Synopsis
AplStatus aplsAnd_8u ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len );
AplStatus aplsAnd_16u ( const Apl16u* pSrc1 , const Apl16u* pSrc2 , Apl16u* pDst , int len );
AplStatus aplsAnd_32u ( const Apl32u* pSrc1 , const Apl32u* pSrc2 , Apl32u* pDst , int len );
AplStatus aplsAnd_8u_I ( const Apl8u* pSrc , Apl8u* pSrcDst , int len );
AplStatus aplsAnd_16u_I ( const Apl16u* pSrc , Apl16u* pSrcDst , int len );
AplStatus aplsAnd_32u_I ( const Apl32u* pSrc , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two source buffers and perform a bitwise logical AND of the data in buffer 1 and the
data in buffer 2. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 41 Signal Processing Library

Publication # 40535 February 2007
Or
Or
Synopsis
AplStatus aplsOr_8u ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len );
AplStatus aplsOr_16u ( const Apl16u* pSrc1 , const Apl16u* pSrc2 , Apl16u* pDst , int len );
AplStatus aplsOr_32u ( const Apl32u* pSrc1 , const Apl32u* pSrc2 , Apl32u* pDst , int len );
AplStatus aplsOr_8u_I ( const Apl8u* pSrc , Apl8u* pSrcDst , int len );
AplStatus aplsOr_16u_I ( const Apl16u* pSrc , Apl16u* pSrcDst , int len );
AplStatus aplsOr_32u_I ( const Apl32u* pSrc , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two source buffers and perform a bitwise logical Or( ) of the data in buffer 1 and the
data in buffer 2. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 42 Signal Processing Library

Publication # 40535 February 2007
Xor
Xor
Synopsis
AplStatus aplsXor_8u ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len );
AplStatus aplsXor_16u ( const Apl16u* pSrc1 , const Apl16u* pSrc2 , Apl16u* pDst , int len );
AplStatus aplsXor_32u ( const Apl32u* pSrc1 , const Apl32u* pSrc2 , Apl32u* pDst , int len );
AplStatus aplsXor_8u_I ( const Apl8u* pSrc , Apl8u* pSrcDst , int len );
AplStatus aplsXor_16u_I ( const Apl16u* pSrc , Apl16u* pSrcDst , int len );
AplStatus aplsXor_32u_I ( const Apl32u* pSrc , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two source buffers and perform a bitwise logical Xor( ) of the data in buffer 1 and the
data in buffer 2. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 43 Signal Processing Library

Publication # 40535 February 2007
AndC
AND with constant
Synopsis
AplStatus aplsAndC_8u ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len );
AplStatus aplsAndC_16u ( const Apl16u* pSrc , Apl16u val , Apl16u* pDst , int len );
AplStatus aplsAndC_32u ( const Apl32u* pSrc , Apl32u val , Apl32u* pDst , int len );
AplStatus aplsAndC_8u_I ( Apl8u val , Apl8u* pSrcDst , int len );
AplStatus aplsAndC_16u_I ( Apl16u val , Apl16u* pSrcDst , int len );
AplStatus aplsAndC_32u_I ( Apl32u val , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and perform a bitwise logical AND of the source data and a specified
constant. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 44 Signal Processing Library

Publication # 40535 February 2007
OrC
OR with constant
Synopsis
AplStatus aplsOrC_8u ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len );
AplStatus aplsOrC_16u ( const Apl16u* pSrc , Apl16u val , Apl16u* pDst , int len );
AplStatus aplsOrC_32u ( const Apl32u* pSrc , Apl32u val , Apl32u* pDst , int len );
AplStatus aplsOrC_8u_I ( Apl8u val , Apl8u* pSrcDst , int len );
AplStatus aplsOrC_16u_I ( Apl16u val , Apl16u* pSrcDst , int len );
AplStatus aplsOrC_32u_I ( Apl32u val , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and perform a bitwise logical OR of the source data and a specified
constant. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 45 Signal Processing Library

Publication # 40535 February 2007
XorC
Xor with constant
Synopsis
AplStatus aplsXorC_8u ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len );
AplStatus aplsXorC_16u ( const Apl16u* pSrc , Apl16u val , Apl16u* pDst , int len );
AplStatus aplsXorC_32u ( const Apl32u* pSrc , Apl32u val , Apl32u* pDst , int len );
AplStatus aplsXorC_8u_I ( Apl8u val , Apl8u* pSrcDst , int len );
AplStatus aplsXorC_16u_I ( Apl16u val , Apl16u* pSrcDst , int len );
AplStatus aplsXorC_32u_I ( Apl32u val , Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and perform a bitwise logical Xor( ) of the source data and a specified
constant. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 46 Signal Processing Library

Publication # 40535 February 2007
Not
Not
Synopsis
AplStatus aplsNot_8u ( const Apl8u* pSrc , Apl8u* pDst , int len );
AplStatus aplsNot_16u ( const Apl16u* pSrc , Apl16u* pDst , int len );
AplStatus aplsNot_32u ( const Apl32u* pSrc , Apl32u* pDst , int len );
AplStatus aplsNot_8u_I ( Apl8u* pSrcDst , int len );
AplStatus aplsNot_16u_I ( Apl16u* pSrcDst , int len );
AplStatus aplsNot_32u_I ( Apl32u* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two source buffers and perform a bitwise logical Not( ) of the data in buffer 1 and the
data in buffer 2. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 47 Signal Processing Library

Publication # 40535 February 2007
LShiftC
Left shift by a constant value
Synopsis
AplStatus aplsLShiftC_8u ( const Apl8u* pSrc , int val , Apl8u* pDst , int len );
AplStatus aplsLShiftC_16s ( const Apl16s* pSrc , int val , Apl16s* pDst , int len );
AplStatus aplsLShiftC_16u ( const Apl16u* pSrc , int val , Apl16u* pDst , int len );
AplStatus aplsLShiftC_32s ( const Apl32s* pSrc , int val , Apl32s* pDst , int len );
AplStatus aplsLShiftC_8u_I ( int val , Apl8u* pSrcDst , int len );
AplStatus aplsLShiftC_16u_I ( int val , Apl16u* pSrcDst , int len );
AplStatus aplsLShiftC_16s_I ( int val , Apl16s* pSrcDst , int len );
AplStatus aplsLShiftC_32s_I ( int val , Apl32s* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and shift the bits of the source data a specified number of bit positions
to the left. The results can be written to a destination buffer or written back to the source buffer. Left-shifting is equivalent to
multiplying by 2 to the constant power.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 48 Signal Processing Library

Publication # 40535 February 2007
RShiftC
Right shift by a constant value
Synopsis
AplStatus aplsRShiftC_8u ( const Apl8u* pSrc , int val , Apl8u* pDst , int len );
AplStatus aplsRShiftC_16s ( const Apl16s* pSrc , int val , Apl16s* pDst , int len );
AplStatus aplsRShiftC_16u ( const Apl16u* pSrc , int val , Apl16u* pDst , int len );
AplStatus aplsRShiftC_32s ( const Apl32s* pSrc , int val , Apl32s* pDst , int len );
AplStatus aplsRShiftC_8u_I ( int val , Apl8u* pSrcDst , int len );
AplStatus aplsRShiftC_16u_I ( int val , Apl16u* pSrcDst , int len );
AplStatus aplsRShiftC_16s_I ( int val , Apl16s* pSrcDst , int len );
AplStatus aplsRShiftC_32s_I ( int val , Apl32s* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and shift the bits of the source data a specified number of bit positions
to the right. The results can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 49 Signal Processing Library

Publication # 40535 February 2007
Mul
Multiply
Synopsis
AplStatus aplsMul_16s ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s * pDst , int len );
AplStatus aplsMul_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f * pDst , int len );
AplStatus aplsMul_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f * pDst , int len );
AplStatus aplsMul_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , Apl32fc * pDst , int len );
AplStatus aplsMul_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , Apl64fc * pDst , int len );
AplStatus aplsMul_8u16u ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl16u * pDst , int len );
AplStatus aplsMul_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl32f * pDst , int len );
AplStatus aplsMul_16s_I ( const Apl16s* pSrc , Apl16s* pSrcDst , int len );
AplStatus aplsMul_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
AplStatus aplsMul_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int len );
AplStatus aplsMul_32fc_I ( const Apl32fc* pSrc , Apl32fc* pSrcDst , int len );
AplStatus aplsMul_64fc_I ( const Apl64fc* pSrc , Apl64fc* pSrcDst , int len );
AplStatus aplsMul_8u_Sfs ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsMul_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsMul_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsMul_16sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , Apl16sc * pDst , int len , int scaleFactor );
AplStatus aplsMul_32sc_Sfs ( const Apl32sc* pSrc1 , const Apl32sc* pSrc2 , Apl32sc * pDst , int len , int scaleFactor );
AplStatus aplsMul_16u16s_Sfs ( const Apl16u* pSrc1 , const Apl16s* pSrc2 , Apl16s * pDst , int len , int scaleFactor );
AplStatus aplsMul_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl32s * pDst , int len , int scaleFactor );
AplStatus aplsMul_32s32sc_Sfs ( const Apl32s* pSrc1 , const Apl32sc* pSrc2 , Apl32sc * pDst , int len , int scaleFactor );
AplStatus aplsMul_8u_ISfs ( const Apl8u* pSrc , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsMul_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsMul_32s_ISfs ( const Apl32s* pSrc , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsMul_16sc_ISfs ( const Apl16sc* pSrc , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsMul_32sc_ISfs ( const Apl32sc* pSrc , Apl32sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsMul_32s32sc_ISfs ( const Apl32s* pSrc , Apl32sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 50 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in two source buffers and multiply the data in buffer 1 by the data in buffer 2. The
product can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 51 Signal Processing Library

Publication # 40535 February 2007
MulC
Multiply by a constant
Synopsis
AplStatus aplsMulC_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsMulC_64f ( const Apl64f* pSrc , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsMulC_32fc ( const Apl32fc* pSrc , Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsMulC_64fc ( const Apl64fc* pSrc , Apl64fc val , Apl64fc* pDst , int len );
AplStatus aplsMulC_16s_I ( Apl16s val , Apl16s* pSrcDst , int len );
AplStatus aplsMulC_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
AplStatus aplsMulC_64f_I ( Apl64f val , Apl64f* pSrcDst , int len );
AplStatus aplsMulC_32fc_I ( Apl32fc val , Apl32fc* pSrcDst , int len );
AplStatus aplsMulC_64fc_I ( Apl64fc val , Apl64fc* pSrcDst , int len );
AplStatus aplsMulC_8u_Sfs ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsMulC_16s_Sfs ( const Apl16s* pSrc , Apl16s val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsMulC_32s_Sfs ( const Apl32s* pSrc , Apl32s val , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsMulC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc val , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsMulC_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc val , Apl32sc* pDst , int len , int scaleFactor );
AplStatus aplsMulC_8u_ISfs ( Apl8u val , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsMulC_16s_ISfs ( Apl16s val , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsMulC_32s_ISfs ( Apl32s val , Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsMulC_16sc_ISfs ( Apl16sc val , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsMulC_32sc_ISfs ( Apl32sc val , Apl32sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsMulC_32f16s_Sfs ( const Apl32f* pSrc , Apl32f val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsMulC_Low_32f16s ( const Apl32f* pSrc , Apl32f val , Apl16s* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
Description
These functions step through vector elements in a source buffer and multiply the source data by a specified constant value. The
product can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 52 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 53 Signal Processing Library

Publication # 40535 February 2007
Abs
Get absolute value
Synopsis
AplStatus aplsAbs_16s ( const Apl16s* pSrc , Apl16s* pDst , int len );
AplStatus aplsAbs_32s ( const Apl32s* pSrc , Apl32s* pDst , int len );
AplStatus aplsAbs_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsAbs_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsAbs_16s_I ( Apl16s* pSrcDst , int len );
AplStatus aplsAbs_32s_I ( Apl32s* pSrcDst , int len );
AplStatus aplsAbs_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsAbs_64f_I ( Apl64f* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in a source buffer and calculate the absolute value of the source data. The results can be
written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 54 Signal Processing Library

Publication # 40535 February 2007
Sqrt
Square root
Synopsis
AplStatus aplsSqrt_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsSqrt_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsSqrt_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsSqrt_64f_I ( Apl64f* pSrcDst , int len );
AplStatus aplsSqrt_8u_Sfs ( const Apl8u* pSrc , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_16u_Sfs ( const Apl16u* pSrc , Apl16u* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_8u_ISfs ( Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqrt_16s_ISfs ( Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqrt_16u_ISfs ( Apl16u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqr_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsSqr_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsSqr_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsSqr_64f_I ( Apl64f* pSrcDst , int len );
AplStatus aplsSqrt_32s16s_Sfs ( const Apl32s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_64s16s_Sfs ( const Apl64s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len );
AplStatus aplsSqrt_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len );
AplStatus aplsSqrt_32fc_I ( Apl32fc* pSrcDst , int len );
AplStatus aplsSqrt_64fc_I ( Apl64fc* pSrcDst , int len );
AplStatus aplsSqrt_16sc_ISfs ( Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqrt_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_64s_Sfs ( const Apl64s* pSrc , Apl64s* pDst , int len , int scaleFactor );
AplStatus aplsSqrt_64s_ISfs ( Apl64s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 55 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in a source buffer and calculate the square root of the source data. Results can be
written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit unsigned, and 16-bit signed versions
perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 56 Signal Processing Library

Publication # 40535 February 2007
Sqr
Square
Synopsis
AplStatus aplsSqr_8u_Sfs ( const Apl8u* pSrc , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsSqr_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsSqr_16u_Sfs ( const Apl16u* pSrc , Apl16u* pDst , int len , int scaleFactor );
AplStatus aplsSqr_8u_ISfs ( Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqr_16s_ISfs ( Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqr_16u_ISfs ( Apl16u* pSrcDst , int len , int scaleFactor );
AplStatus aplsSqr_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len );
AplStatus aplsSqr_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len );
AplStatus aplsSqr_32fc_I ( Apl32fc* pSrcDst , int len );
AplStatus aplsSqr_64fc_I ( Apl64fc* pSrcDst , int len );
AplStatus aplsSqr_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsSqr_16sc_ISfs ( Apl16sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer and calculate the square of the source data. Results can be written to
a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit unsigned, and 16-bit signed versions perform an
integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 57 Signal Processing Library

Publication # 40535 February 2007
Div
Divide
Synopsis
AplStatus aplsDiv_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsDiv_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
AplStatus aplsDiv_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , Apl32fc* pDst , int len );
AplStatus aplsDiv_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , Apl64fc* pDst , int len );
AplStatus aplsDiv_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
AplStatus aplsDiv_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int len );
AplStatus aplsDiv_32fc_I ( const Apl32fc* pSrc , Apl32fc* pSrcDst , int len );
AplStatus aplsDiv_64fc_I ( const Apl64fc* pSrc , Apl64fc* pSrcDst , int len );
AplStatus aplsDiv_8u_Sfs ( const Apl8u* pSrc1 , const Apl8u* pSrc2 , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsDiv_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsDiv_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsDiv_16sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsDiv_32s16s_Sfs ( const Apl16s* pSrc1 , const Apl32s* pSrc2 , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsDiv_8u_ISfs ( const Apl8u* pSrc , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsDiv_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsDiv_16sc_ISfs ( const Apl16sc* pSrc , Apl16sc* pSrcDst , int len , int scaleFactor );
AplStatus aplsDiv_32s_ISfs ( const Apl32s* pSrc , Apl32s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in two source buffers and divide the data in buffer 1 by the data in buffer 2. The
quotient can be written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed
complex, and 32-bit signed complex versions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 58 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 59 Signal Processing Library

Publication # 40535 February 2007
DivC
Divide by a constant
Synopsis
AplStatus aplsDivC_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsDivC_64f ( const Apl64f* pSrc , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsDivC_32fc ( const Apl32fc* pSrc , Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsDivC_64fc ( const Apl64fc* pSrc , Apl64fc val , Apl64fc* pDst , int len );
AplStatus aplsDivC_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
AplStatus aplsDivC_64f_I ( Apl64f val , Apl64f* pSrcDst , int len );
AplStatus aplsDivC_32fc_I ( Apl32fc val , Apl32fc* pSrcDst , int len );
AplStatus aplsDivC_64fc_I ( Apl64fc val , Apl64fc* pSrcDst , int len );
AplStatus aplsDivC_8u_Sfs ( const Apl8u* pSrc , Apl8u val , Apl8u* pDst , int len , int scaleFactor );
AplStatus aplsDivC_16s_Sfs ( const Apl16s* pSrc , Apl16s val , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsDivC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc val , Apl16sc* pDst , int len , int scaleFactor );
AplStatus aplsDivC_8u_ISfs ( Apl8u val , Apl8u* pSrcDst , int len , int scaleFactor );
AplStatus aplsDivC_16s_ISfs ( Apl16s val , Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsDivC_16sc_ISfs ( Apl16sc val , Apl16sc* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
val Specified value.
Description
These functions step through vector elements in a source buffer and divide the source data by a constant value. The quotient can be
written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32bit
signed complex versions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 60 Signal Processing Library

Publication # 40535 February 2007
DivCRev
Divide a constant
Synopsis
AplStatus aplsDivCRev_16u ( const Apl16u* pSrc , Apl16u val , Apl16u* pDst , int len );
AplStatus aplsDivCRev_32f ( const Apl32f* pSrc , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsDivCRev_16u_I ( Apl16u val , Apl16u* pSrcDst , int len );
AplStatus aplsDivCRev_32f_I ( Apl32f val , Apl32f* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
val Specified value.
Description
These functions step through vector elements in a source buffer and divide a constant value by the source data. The quotient can be
written to a destination buffer or written back to the source buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32bit
signed complex versions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 61 Signal Processing Library

Publication # 40535 February 2007
Cubrt
Cube root
Synopsis
AplStatus aplsCubrt_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsCubrt_32s16s_Sfs ( const Apl32s* pSrc , Apl16s* pDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the cube root of each element, and write the result to a
destination buffer. The 32-bit signed version of the functions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 62 Signal Processing Library

Publication # 40535 February 2007
Exp
Raise base e to a specified power
Synopsis
AplStatus aplsExp_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsExp_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsExp_32f64f ( const Apl32f* pSrc , Apl64f* pDst , int len );
AplStatus aplsExp_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsExp_64f_I ( Apl64f* pSrcDst , int len );
AplStatus aplsExp_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsExp_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsExp_64s_Sfs ( const Apl64s* pSrc , Apl64s* pDst , int len , int scaleFactor );
AplStatus aplsExp_16s_ISfs ( Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsExp_32s_ISfs ( Apl32s* pSrcDst , int len , int scaleFactor );
AplStatus aplsExp_64s_ISfs ( Apl64s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer and calculate e to the power specified by each element. Results can be
written to a destination buffer or written back to the source buffer. The 16-bit and 32-bit signed versions perform an integer scaling
operation before writing the results. These functions are the inverses of the Ln functions.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 63 Signal Processing Library

Publication # 40535 February 2007
Ln
Natural logarithm
Synopsis
AplStatus aplsLn_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLn_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsLn_64f32f ( const Apl64f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLn_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsLn_64f_I ( Apl64f* pSrcDst , int len );
AplStatus aplsLn_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsLn_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , int len , int scaleFactor );
AplStatus aplsLn_32s16s_Sfs ( const Apl32s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsLn_16s_ISfs ( Apl16s* pSrcDst , int len , int scaleFactor );
AplStatus aplsLn_32s_ISfs ( Apl32s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer and calculate the natural logarithm of each element. Results can be
written to a destination buffer or written back to the source buffer. The 16-bit and 32-bit signed versions perform an integer scaling
operation before writing the results.
Return Values
aplStsLnNegArg Negative input buffer element warning status code.
aplStsLnZeroArg Zero-valued input buffer element warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 64 Signal Processing Library

Publication # 40535 February 2007
10Log10
Ten times log to the base 10
Synopsis
AplStatus apls10Log10_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , int len , int scaleFactor );
AplStatus apls10Log10_32s_ISfs ( Apl32s* pSrcDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer and calculate ten times the common logarithm of each element. The results are integer
scaled, then written to a destination buffer. This function is particularly useful for calculating logarithmic scale values, such as decibels.
Return Values
aplStsLnNegArg Negative input buffer element warning status code.
aplStsLnZeroArg Zero-valued input buffer element warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 65 Signal Processing Library

Publication # 40535 February 2007
Arctan
Arc Tangent
Synopsis
AplStatus aplsArctan_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsArctan_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsArctan_32f_I ( Apl32f* pSrcDst , int len );
AplStatus aplsArctan_64f_I ( Apl64f* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through a source buffer and calculate the inverse tangent of each element. Results can be written to a destination
buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 66 Signal Processing Library

Publication # 40535 February 2007
Threshold_LTVal
Compare to a threshold, replace with specified value (Less Than)
Synopsis
AplStatus aplsThreshold_LTVal_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s level , Apl16s value );
AplStatus aplsThreshold_LTVal_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level , Apl32f value );
AplStatus aplsThreshold_LTVal_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level , Apl64f value );
AplStatus aplsThreshold_LTVal_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len , Apl16s level , Apl16sc value );
AplStatus aplsThreshold_LTVal_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level , Apl32fc value );
AplStatus aplsThreshold_LTVal_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level , Apl64fc value );
AplStatus aplsThreshold_LTVal_16s_I ( Apl16s* pSrcDst , int len , Apl16s level , Apl16s value );
AplStatus aplsThreshold_LTVal_32f_I ( Apl32f* pSrcDst , int len , Apl32f level , Apl32f value );
AplStatus aplsThreshold_LTVal_64f_I ( Apl64f* pSrcDst , int len , Apl64f level , Apl64f value );
AplStatus aplsThreshold_LTVal_16sc_I ( Apl16sc* pSrcDst , int len , Apl16s level , Apl16sc value );
AplStatus aplsThreshold_LTVal_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level , Apl32fc value );
AplStatus aplsThreshold_LTVal_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level , Apl64fc value );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
value Specified value.
Description
These functions step through vector elements in a source buffer and compare source data to a specified threshold value. When the
source data is less than the threshold value, the output data is set to a specified value. When the source data is more than or equal to
the threshold value, the output data is set to the same value as the source data. Output data can be written to a destination buffer or
back to the same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 67 Signal Processing Library

Publication # 40535 February 2007
Threshold_GTVal
Compare to a threshold, replace with specified value (Greater Than)
Synopsis
AplStatus aplsThreshold_GTVal_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s level , Apl16s value );
AplStatus aplsThreshold_GTVal_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level , Apl32f value );
AplStatus aplsThreshold_GTVal_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level , Apl64f value );
AplStatus aplsThreshold_GTVal_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len , Apl16s level , Apl16sc value );
AplStatus aplsThreshold_GTVal_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level , Apl32fc value );
AplStatus aplsThreshold_GTVal_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level , Apl64fc value );
AplStatus aplsThreshold_GTVal_16s_I ( Apl16s* pSrcDst , int len , Apl16s level , Apl16s value );
AplStatus aplsThreshold_GTVal_32f_I ( Apl32f* pSrcDst , int len , Apl32f level , Apl32f value );
AplStatus aplsThreshold_GTVal_64f_I ( Apl64f* pSrcDst , int len , Apl64f level , Apl64f value );
AplStatus aplsThreshold_GTVal_16sc_I ( Apl16sc* pSrcDst , int len , Apl16s level , Apl16sc value );
AplStatus aplsThreshold_GTVal_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level , Apl32fc value );
AplStatus aplsThreshold_GTVal_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level , Apl64fc value );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
value Specified value.
Description
These functions step through vector elements in a source buffer and compare source data to a specified threshold value. When the
source data is greater than the threshold value, the output data is set to a specified value. When the source data is less than or equal
to the threshold value, the output data is set to the same value as the source data. Output data can be written to a destination buffer
or back to the same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 68 Signal Processing Library

Publication # 40535 February 2007
Threshold_LTValGTVal
Compare to double threshold, replace with specified value (Less Than/Greater Than)
Synopsis
AplStatus aplsThreshold_LTValGTVal_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s levelLT , Apl16s valueLT , Apl16s levelGT ,
Apl16s valueGT );
AplStatus aplsThreshold_LTValGTVal_32s ( const Apl32s* pSrc , Apl32s* pDst , int len , Apl32s levelLT , Apl32s valueLT , Apl32s levelGT ,
Apl32s valueGT );
AplStatus aplsThreshold_LTValGTVal_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f levelLT , Apl32f valueLT , Apl32f levelGT ,
Apl32f valueGT );
AplStatus aplsThreshold_LTValGTVal_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f levelLT , Apl64f valueLT , Apl64f levelGT ,
Apl64f valueGT );
AplStatus aplsThreshold_LTValGTVal_16s_I ( Apl16s* pSrcDst , int len , Apl16s levelLT , Apl16s valueLT , Apl16s levelGT , Apl16s valueGT
);
AplStatus aplsThreshold_LTValGTVal_32s_I ( Apl32s* pSrcDst , int len , Apl32s levelLT , Apl32s valueLT , Apl32s levelGT , Apl32s valueGT
);
AplStatus aplsThreshold_LTValGTVal_32f_I ( Apl32f* pSrcDst , int len , Apl32f levelLT , Apl32f valueLT , Apl32f levelGT , Apl32f valueGT );
AplStatus aplsThreshold_LTValGTVal_64f_I ( Apl64f* pSrcDst , int len , Apl64f levelLT , Apl64f valueLT , Apl64f levelGT , Apl64f valueGT );
Parameters
len Specifies the number of elements in a buffer.
levelGT Specifies a threshold level for greater-than comparison.
levelLT Specifies a threshold level for less-than comparison.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
valueGT Specifies a value to set when a greater-than comparison evaluates as true.
valueLT Specifies a value to set a less-than comparison evaluates as true.
Description
These functions step through vector elements in a source buffer and compare source data to two specified threshold values. The value
of thresholdLT must be less than the value of thresholdGT. When the source data is less than the value specified by thresholdLT, the
output data is set to the value specified by valueLT. When the source data is greater than the value specified by thresholdGT, the
output data is set to the value specified by valueLT. When the source data is within the range defined by thresholdLT and thresholdGT,
the output data is set to same value as the source data. Output data can be written to a destination buffer or back to the same buffer
for in-place operation.
AMD Performance Library User’s Manual 69 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsThresholdErr The less-than threshold is greater than the greater-than threshold.
AMD Performance Library User’s Manual 70 Signal Processing Library

Publication # 40535 February 2007
Threshold_LT
Compare to a threshold, replace with threshold value (Less Than)
Synopsis
AplStatus aplsThreshold_LT_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s level );
AplStatus aplsThreshold_LT_32s ( const Apl32s* pSrc , Apl32s* pDst , int len , Apl32s level );
AplStatus aplsThreshold_LT_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level );
AplStatus aplsThreshold_LT_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level );
AplStatus aplsThreshold_LT_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level );
AplStatus aplsThreshold_LT_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level );
AplStatus aplsThreshold_LT_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len , Apl16s level );
AplStatus aplsThreshold_LT_16s_I ( Apl16s* pSrcDst , int len , Apl16s level );
AplStatus aplsThreshold_LT_32s_I ( Apl32s* pSrcDst , int len , Apl32s level );
AplStatus aplsThreshold_LT_32f_I ( Apl32f* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_LT_64f_I ( Apl64f* pSrcDst , int len , Apl64f level );
AplStatus aplsThreshold_LT_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_LT_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level );
AplStatus aplsThreshold_LT_16sc_I ( Apl16sc* pSrcDst , int len , Apl16s level );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in a source buffer and compare source data to a specified threshold value. When the
source data is less than the threshold value, the output data is set to the threshold value. When the source data is more than or equal
to the threshold value, the output data is set to the same value as the source data. Output data can be written to a destination buffer
or back to the same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 71 Signal Processing Library

Publication # 40535 February 2007
Threshold_GT
Compare to a threshold, replace with threshold value (Greater Than)
Synopsis
AplStatus aplsThreshold_GT_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s level );
AplStatus aplsThreshold_GT_32s ( const Apl32s* pSrc , Apl32s* pDst , int len , Apl32s level );
AplStatus aplsThreshold_GT_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level );
AplStatus aplsThreshold_GT_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level );
AplStatus aplsThreshold_GT_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level );
AplStatus aplsThreshold_GT_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level );
AplStatus aplsThreshold_GT_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len , Apl16s level );
AplStatus aplsThreshold_GT_16s_I ( Apl16s* pSrcDst , int len , Apl16s level );
AplStatus aplsThreshold_GT_32s_I ( Apl32s* pSrcDst , int len , Apl32s level );
AplStatus aplsThreshold_GT_32f_I ( Apl32f* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_GT_64f_I ( Apl64f* pSrcDst , int len , Apl64f level );
AplStatus aplsThreshold_GT_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_GT_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level );
AplStatus aplsThreshold_GT_16sc_I ( Apl16sc* pSrcDst , int len , Apl16s level );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in a source buffer and compare source data to a specified threshold value. When the
source data is greater than the threshold value, the output data is set to the threshold value. When the source data is less than or
equal to the threshold value, the output data is set to the same value as the source data. Output data can be written to a destination
buffer or back to the same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 72 Signal Processing Library

Publication # 40535 February 2007
Threshold
Compare to a threshold, replace with threshold value (General)
Synopsis
AplStatus aplsThreshold_16s ( const Apl16s* pSrc , Apl16s* pDst , int len , Apl16s level , AplCmpOp relOp );
AplStatus aplsThreshold_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level , AplCmpOp relOp );
AplStatus aplsThreshold_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level , AplCmpOp relOp );
AplStatus aplsThreshold_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level , AplCmpOp relOp );
AplStatus aplsThreshold_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level , AplCmpOp relOp );
AplStatus aplsThreshold_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len , Apl16s level , AplCmpOp relOp );
AplStatus aplsThreshold_16s_I ( Apl16s* pSrcDst , int len , Apl16s level , AplCmpOp relOp );
AplStatus aplsThreshold_32f_I ( Apl32f* pSrcDst , int len , Apl32f level , AplCmpOp relOp );
AplStatus aplsThreshold_64f_I ( Apl64f* pSrcDst , int len , Apl64f level , AplCmpOp relOp );
AplStatus aplsThreshold_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level , AplCmpOp relOp );
AplStatus aplsThreshold_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level , AplCmpOp relOp );
AplStatus aplsThreshold_16sc_I ( Apl16sc* pSrcDst , int len , Apl16s level , AplCmpOp relOp );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
relOp Constant that indicates which relational operation to perform.
Description
These functions step through vector elements in a source buffer and compare the source data to a specified threshold value using a
specified compare operation. The compare operation can be "less than", "less than or equal", "equal", "greater than or equal" or
"greater than". When the comparison evaluates as true, the output data is set to the threshold value. When the comparison evaluates
as false, the output data is set to the same value as the source data. Output data can be written to a destination buffer or back to the
same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 73 Signal Processing Library

Publication # 40535 February 2007
Threshold_LTInv
Compare to a threshold, replace with threshold value (Less Than), invert vector
Synopsis
AplStatus aplsThreshold_LTInv_32f ( const Apl32f* pSrc , Apl32f* pDst , int len , Apl32f level );
AplStatus aplsThreshold_LTInv_64f ( const Apl64f* pSrc , Apl64f* pDst , int len , Apl64f level );
AplStatus aplsThreshold_LTInv_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len , Apl32f level );
AplStatus aplsThreshold_LTInv_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len , Apl64f level );
AplStatus aplsThreshold_LTInv_32f_I ( Apl32f* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_LTInv_64f_I ( Apl64f* pSrcDst , int len , Apl64f level );
AplStatus aplsThreshold_LTInv_32fc_I ( Apl32fc* pSrcDst , int len , Apl32f level );
AplStatus aplsThreshold_LTInv_64fc_I ( Apl64fc* pSrcDst , int len , Apl64f level );
Parameters
len Specifies the number of elements in a buffer.
level Specifies a threshold level.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in a source buffer and compare source data to a specified threshold value. When the
source data is less than the threshold value, the output data is set to the threshold value and inverted. When the source data is more
than or equal to the threshold value, the output data is set to the same value as the source data and inverted Output data can be
written to a destination buffer or back to the same buffer for in-place operation.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 74 Signal Processing Library

Publication # 40535 February 2007
Magnitude
Complex vector magnitude
Synopsis
AplStatus aplsMagnitude_32f ( const Apl32f* pSrcRe , const Apl32f* pSrcIm , Apl32f* pDst , int len );
AplStatus aplsMagnitude_64f ( const Apl64f* pSrcRe , const Apl64f* pSrcIm , Apl64f* pDst , int len );
AplStatus aplsMagnitude_32fc ( const Apl32fc* pSrc , Apl32f* pDst , int len );
AplStatus aplsMagnitude_64fc ( const Apl64fc* pSrc , Apl64f* pDst , int len );
AplStatus aplsMagnitude_16s32f ( const Apl16s* pSrcRe , const Apl16s* pSrcIm , Apl32f* pDst , int len );
AplStatus aplsMagnitude_16sc32f ( const Apl16sc* pSrc , Apl32f* pDst , int len );
AplStatus aplsMagnitude_16s_Sfs ( const Apl16s* pSrcRe , const Apl16s* pSrcIm , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsMagnitude_16sc_Sfs ( const Apl16sc* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsMagnitude_32sc_Sfs ( const Apl32sc* pSrc , Apl32s* pDst , int len , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcIm Pointer to a source buffer that contains the imaginary component values of an input signal.
pSrcRe Pointer to a source buffer that contains the real component values of an input signal.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through elements of a complex vector, calculate the magnitude of each element, and write the result to a
destination. There are versions of the function that operate on one source buffer containing a complex vector and versions that
operate on two source buffers containing real and imaginary component values. There are single-vector 16-bit signed complex and
single-vector 32-bit signed complex versions that perform integer scaling before writing the results. A length parameter specifies the
number of elements in the vector.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 75 Signal Processing Library

Publication # 40535 February 2007
Convert
Convert vector data from one type to another
Synopsis
AplStatus aplsConvert_8s16s ( const Apl8s* pSrc , Apl16s* pDst , int len );
AplStatus aplsConvert_8s32f ( const Apl8s* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_8u32f ( const Apl8u* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_16s32s ( const Apl16s* pSrc , Apl32s* pDst , int len );
AplStatus aplsConvert_16s32f ( const Apl16s* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_16u32f ( const Apl16u* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_32s16s ( const Apl32s* pSrc , Apl16s* pDst , int len );
AplStatus aplsConvert_32s32f ( const Apl32s* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_32s64f ( const Apl32s* pSrc , Apl64f* pDst , int len );
AplStatus aplsConvert_32f64f ( const Apl32f* pSrc , Apl64f* pDst , int len );
AplStatus aplsConvert_64f32f ( const Apl64f* pSrc , Apl32f* pDst , int len );
AplStatus aplsConvert_16s32f_Sfs ( const Apl16s* pSrc , Apl32f* pDst , int len , int scaleFactor );
AplStatus aplsConvert_16s64f_Sfs ( const Apl16s* pSrc , Apl64f* pDst , int len , int scaleFactor );
AplStatus aplsConvert_32s16s_Sfs ( const Apl32s* pSrc , Apl16s* pDst , int len , int scaleFactor );
AplStatus aplsConvert_32s32f_Sfs ( const Apl32s* pSrc , Apl32f* pDst , int len , int scaleFactor );
AplStatus aplsConvert_32s64f_Sfs ( const Apl32s* pSrc , Apl64f* pDst , int len , int scaleFactor );
AplStatus aplsConvert_32f8s_Sfs ( const Apl32f* pSrc , Apl8s* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_32f8u_Sfs ( const Apl32f* pSrc , Apl8u* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_32f16s_Sfs ( const Apl32f* pSrc , Apl16s* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_32f16u_Sfs ( const Apl32f* pSrc , Apl16u* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_32f32s_Sfs ( const Apl32f* pSrc , Apl32s* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_64s32s_Sfs ( const Apl64s* pSrc , Apl32s* pDst , int len , AplRoundMode rndMode , int scaleFactor );
AplStatus aplsConvert_64f32s_Sfs ( const Apl64f* pSrc , Apl32s* pDst , int len , AplRoundMode rndMode , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
rndMode Constant that indicates which rounding mode to use when converting from a scalar to an integer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 76 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in a source buffer, convert the source data to another data type, and write the
converted data to a destination buffer. There are versions of the 16-bit signed-to-floating-point, 32-bit signed-to-floating-point, and
32-bit signed to 16-bit signed functions that perform an integer scaling operation on the results. There are floating-point versions of
the functions that also take a rounding mode argument. Values can be truncated toward zero or rounded to the nearest integer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 77 Signal Processing Library

Publication # 40535 February 2007
Max
Maximum
Synopsis
AplStatus aplsMax_16s ( const Apl16s* pSrc , int len , Apl16s* pMax );
AplStatus aplsMax_32s ( const Apl32s* pSrc , int len , Apl32s* pMax );
AplStatus aplsMax_32f ( const Apl32f* pSrc , int len , Apl32f* pMax );
AplStatus aplsMax_64f ( const Apl64f* pSrc , int len , Apl64f* pMax );
Parameters
len Specifies the number of elements in a buffer.
pMax Pointer to the destination buffer that contains the maximum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the maximum value, and write the value to a location specified
by a pointer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 78 Signal Processing Library

Publication # 40535 February 2007
MaxIndx
Maximum with index
Synopsis
AplStatus aplsMaxIndx_16s ( const Apl16s* pSrc , int len , Apl16s* pMax , int* pIndx );
AplStatus aplsMaxIndx_32s ( const Apl32s* pSrc , int len , Apl32s* pMax , int* pIndx );
AplStatus aplsMaxIndx_32f ( const Apl32f* pSrc , int len , Apl32f* pMax , int* pIndx );
AplStatus aplsMaxIndx_64f ( const Apl64f* pSrc , int len , Apl64f* pMax , int* pIndx );
Parameters
len Specifies the number of elements in a buffer.
pIndx Pointer to the destination buffer that contains the index of the maximum or minimum value in the source buffer.
pMax Pointer to the destination buffer that contains the maximum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the maximum value and its index. The maximum value is written
to a maximum value buffer and the index is written to a location specified by a pointer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 79 Signal Processing Library

Publication # 40535 February 2007
MaxAbs
Maximum absolute value
Synopsis
AplStatus aplsMaxAbs_16s ( const Apl16s* pSrc , int len , Apl16s* pMaxAbs );
AplStatus aplsMaxAbs_32s ( const Apl32s* pSrc , int len , Apl32s* pMaxAbs );
Parameters
len Specifies the number of elements in a buffer.
pMaxAbs Pointer to the destination buffer that contains the maximum absolute value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the maximum absolute value, and write the value to a location
specified by a pointer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 80 Signal Processing Library

Publication # 40535 February 2007
MaxAbsIndx
Maximum absolute value with index
Synopsis
AplStatus aplsMaxAbsIndx_16s ( const Apl16s* pSrc , int len , Apl16s* pMaxAbs , int* pIndx );
AplStatus aplsMaxAbsIndx_32s ( const Apl32s* pSrc , int len , Apl32s* pMaxAbs , int* pIndx );
Parameters
len Specifies the number of elements in a buffer.
pIndx Pointer to the destination buffer that contains the index of the maximum or minimum value in the source buffer.
pMaxAbs Pointer to the destination buffer that contains the maximum absolute value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the maximum absolute value and its index. The maximum
absolute value and the index are written to locations specified by pointers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 81 Signal Processing Library

Publication # 40535 February 2007
Min
Minimum
Synopsis
AplStatus aplsMin_16s ( const Apl16s* pSrc , int len , Apl16s* pMin );
AplStatus aplsMin_32s ( const Apl32s* pSrc , int len , Apl32s* pMin );
AplStatus aplsMin_32f ( const Apl32f* pSrc , int len , Apl32f* pMin );
AplStatus aplsMin_64f ( const Apl64f* pSrc , int len , Apl64f* pMin );
Parameters
len Specifies the number of elements in a buffer.
pMin Pointer to the destination buffer that contains the minimum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum value, and write the value to a location specified by
a pointer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 82 Signal Processing Library

Publication # 40535 February 2007
MinIndx
Minimum with index
Synopsis
AplStatus aplsMinIndx_16s ( const Apl16s* pSrc , int len , Apl16s* pMin , int* pIndx );
AplStatus aplsMinIndx_32s ( const Apl32s* pSrc , int len , Apl32s* pMin , int* pIndx );
AplStatus aplsMinIndx_32f ( const Apl32f* pSrc , int len , Apl32f* pMin , int* pIndx );
AplStatus aplsMinIndx_64f ( const Apl64f* pSrc , int len , Apl64f* pMin , int* pIndx );
Parameters
len Specifies the number of elements in a buffer.
pIndx Pointer to the destination buffer that contains the index of the maximum or minimum value in the source buffer.
pMin Pointer to the destination buffer that contains the minimum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum value and its index. The minimum value and the
index are written to locations specified by pointers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 83 Signal Processing Library

Publication # 40535 February 2007
MinAbs
Minimum absolute value
Synopsis
AplStatus aplsMinAbs_16s ( const Apl16s* pSrc , int len , Apl16s* pMinAbs );
AplStatus aplsMinAbs_32s ( const Apl32s* pSrc , int len , Apl32s* pMinAbs );
Parameters
len Specifies the number of elements in a buffer.
pMinAbs Pointer to the destination buffer that contains the minimum absolute value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum absolute value, and write the value to a location
specified by a pointer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 84 Signal Processing Library

Publication # 40535 February 2007
MinAbsIndx
Minimum absolute value with index
Synopsis
AplStatus aplsMinAbsIndx_16s ( const Apl16s* pSrc , int len , Apl16s* pMinAbs , int* pIndx );
AplStatus aplsMinAbsIndx_32s ( const Apl32s* pSrc , int len , Apl32s* pMinAbs , int* pIndx );
Parameters
len Specifies the number of elements in a buffer.
pIndx Pointer to the destination buffer that contains the index of the maximum or minimum value in the source buffer.
pMinAbs Pointer to the destination buffer that contains the minimum absolute value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum absolute value and its index. The minimum
absolute value and the index are written to locations specified by pointers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 85 Signal Processing Library

Publication # 40535 February 2007
MinMax
Minimum and maximum
Synopsis
AplStatus aplsMinMax_8u ( const Apl8u* pSrc , int len , Apl8u* pMin , Apl8u* pMax );
AplStatus aplsMinMax_16u ( const Apl16u* pSrc , int len , Apl16u* pMin , Apl16u* pMax );
AplStatus aplsMinMax_16s ( const Apl16s* pSrc , int len , Apl16s* pMin , Apl16s* pMax );
AplStatus aplsMinMax_32u ( const Apl32u* pSrc , int len , Apl32u* pMin , Apl32u* pMax );
AplStatus aplsMinMax_32s ( const Apl32s* pSrc , int len , Apl32s* pMin , Apl32s* pMax );
AplStatus aplsMinMax_32f ( const Apl32f* pSrc , int len , Apl32f* pMin , Apl32f* pMax );
AplStatus aplsMinMax_64f ( const Apl64f* pSrc , int len , Apl64f* pMin , Apl64f* pMax );
Parameters
len Specifies the number of elements in a buffer.
pMax Pointer to the destination buffer that contains the maximum value in the source buffer.
pMin Pointer to the destination buffer that contains the minimum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum and maximum values, and write the values to
locations specified by pointers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 86 Signal Processing Library

Publication # 40535 February 2007
MinMaxIndx
Minimum and maximum with index
Synopsis
AplStatus aplsMinMaxIndx_8u ( const Apl8u* pSrc , int len , Apl8u* pMin , int* pMinIndx , Apl8u* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_16u ( const Apl16u* pSrc , int len , Apl16u* pMin , int* pMinIndx , Apl16u* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_16s ( const Apl16s* pSrc , int len , Apl16s* pMin , int* pMinIndx , Apl16s* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_32u ( const Apl32u* pSrc , int len , Apl32u* pMin , int* pMinIndx , Apl32u* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_32s ( const Apl32s* pSrc , int len , Apl32s* pMin , int* pMinIndx , Apl32s* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_32f ( const Apl32f* pSrc , int len , Apl32f* pMin , int* pMinIndx , Apl32f* pMax , int* pMaxIndx );
AplStatus aplsMinMaxIndx_64f ( const Apl64f* pSrc , int len , Apl64f* pMin , int* pMinIndx , Apl64f* pMax , int* pMaxIndx );
Parameters
len Specifies the number of elements in a buffer.
pMax Pointer to the destination buffer that contains the maximum value in the source buffer.
pMaxIndx Pointer to the destination buffer that contains the index of the maximum value in the source vector.
pMin Pointer to the destination buffer that contains the minimum value in the source buffer.
pMinIndx Pointer to the destination buffer that contains the index of the minimum value in the source buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, find the minimum and maximum values and the corresponding
indices. The minimum value, the maximum value, and the indices are written locations specified by pointers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 87 Signal Processing Library

Publication # 40535 February 2007
Norm_Inf
Norm C
Synopsis
AplStatus aplsNorm_Inf_32f ( const Apl32f* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_Inf_64f ( const Apl64f* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_Inf_16s32f ( const Apl16s* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_Inf_32fc32f ( const Apl32fc* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_Inf_64fc64f ( const Apl64fc* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_Inf_16s32s_Sfs ( const Apl16s* pSrc , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc Pointer to a source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the C Norm, and write the value to a location specified by a
pointer.
The following formula is used:
C Norm =((n = 0) - (len-1)) max (|pSrc[n]|)
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation before the result is written.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 88 Signal Processing Library

Publication # 40535 February 2007
Norm_L1
Norm L1
Synopsis
AplStatus aplsNorm_L1_32f ( const Apl32f* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_L1_64f ( const Apl64f* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L1_16s32f ( const Apl16s* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_L1_32fc64f ( const Apl32fc* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L1_64fc64f ( const Apl64fc* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L1_16s32s_Sfs ( const Apl16s* pSrc , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc Pointer to a source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the L1 Norm, and write the value to a location specified by a
pointer.
The following formula is used:
L1 Norm =((n = 0) - (len-1)) Sum (|pSrc[n]|)
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 89 Signal Processing Library

Publication # 40535 February 2007
Norm_L2
Norm L2
Synopsis
AplStatus aplsNorm_L2_32f ( const Apl32f* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_L2_64f ( const Apl64f* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L2_16s32f ( const Apl16s* pSrc , int len , Apl32f* pNorm );
AplStatus aplsNorm_L2_32fc64f ( const Apl32fc* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L2_64fc64f ( const Apl64fc* pSrc , int len , Apl64f* pNorm );
AplStatus aplsNorm_L2_16s32s_Sfs ( const Apl16s* pSrc , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc Pointer to a source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the L2 Norm, and write the value to a location specified by a
pointer. The following formula is used:
L2 Norm =Sqrt(((n = 0) - (len-1)) Sum(Square(|pSrc[n]|))
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 90 Signal Processing Library

Publication # 40535 February 2007
NormDiff_Inf
Norm of difference C
Synopsis
AplStatus aplsNormDiff_Inf_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_Inf_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_Inf_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_Inf_32fc32f ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_Inf_64fc64f ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_Inf_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in two source buffers, calculate the C Norm of the difference between the elements in
buffer 1 and the elements in buffer 2, and write the value to a location specified by a pointer.
The following formula is used:
C NormDiff = ((n = 0) - (len-1)) max (|pSrc1[n] - pSrc2[n]|)
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 91 Signal Processing Library

Publication # 40535 February 2007
NormDiff_L1
Norm of difference L1
Synopsis
AplStatus aplsNormDiff_L1_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_L1_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L1_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_L1_32fc64f ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L1_64fc64f ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L1_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in two source buffers, calculate the L1 Norm of the difference between the elements in
buffer 1 and the elements in buffer 2, and write the value to a location specified by a pointer.
The following formula is used:
NormDiff = ((n = 0) - (len-1)) Sum (|pSrc1[n] - pSrc2[n]|)
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 92 Signal Processing Library

Publication # 40535 February 2007
NormDiff_L2
Norm of difference L2
Synopsis
AplStatus aplsNormDiff_L2_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_L2_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L2_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32f* pNorm );
AplStatus aplsNormDiff_L2_32fc64f ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L2_64fc64f ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , int len , Apl64f* pNorm );
AplStatus aplsNormDiff_L2_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32s* pNorm , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pNorm
Pointer to the destination buffer that contains the NormC, NormL1, or NormL2 of the values in the source buffer, depending on the
function call.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in two source buffers, calculate the L2 Norm of the difference between the elements in
buffer 1 and the elements in buffer 2, and write the value to a location specified by a pointer.
The following formula is used:
NormDiff = Sqrt(((n = 0) - (len-1)) Sum(Square(|pSrc1[n] - pSrc2[n]|))
The 16-bit signed to 32-bit signed version of the function performs an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 93 Signal Processing Library

Publication # 40535 February 2007
Mean
Mean
Synopsis
AplStatus aplsMean_32f ( const Apl32f* pSrc , int len , Apl32f* pMean , AplHintAlgorithm hint );
AplStatus aplsMean_32fc ( const Apl32fc* pSrc , int len , Apl32fc* pMean , AplHintAlgorithm hint );
AplStatus aplsMean_64f ( const Apl64f* pSrc , int len , Apl64f* pMean );
AplStatus aplsMean_64fc ( const Apl64fc* pSrc , int len , Apl64fc* pMean );
AplStatus aplsMean_16s_Sfs ( const Apl16s* pSrc , int len , Apl16s* pMean , int scaleFactor );
AplStatus aplsMean_16sc_Sfs ( const Apl16sc* pSrc , int len , Apl16sc* pMean , int scaleFactor );
Parameters
hint Hints whether to choose a fast or accurate computation algorithm.
len Specifies the number of elements in a buffer.
pMean Pointer to the destination buffer that contains the mean of the values in the source buffer.
pSrc Pointer to a source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the arithmetic mean, and write the value to a location
specified by a pointer.
The following formula is used:
Mean( ) = 1/len ((n = 0) - (len-1)) Sum(pSrc[n]).
The 16-bit signed and 16-bit signed complex versions perform an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 94 Signal Processing Library

Publication # 40535 February 2007
MaxEvery
Maximum (element pair)
Synopsis
AplStatus aplsMaxEvery_16s_I ( const Apl16s* pSrc , Apl16s* pSrcDst , int len );
AplStatus aplsMaxEvery_32s_I ( const Apl32s* pSrc , Apl32s* pSrcDst , int len );
AplStatus aplsMaxEvery_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two buffers and compare corresponding elements in the source and destination
buffers. The maximum value in the comparison is written to the destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 95 Signal Processing Library

Publication # 40535 February 2007
MinEvery
Minimum (element pair)
Synopsis
AplStatus aplsMinEvery_16s_I ( const Apl16s* pSrc , Apl16s* pSrcDst , int len );
AplStatus aplsMinEvery_32s_I ( const Apl32s* pSrc , Apl32s* pSrcDst , int len );
AplStatus aplsMinEvery_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through vector elements in two buffers and compare corresponding elements in the source and destination
buffers. The minimum value in the comparison is written to the destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 96 Signal Processing Library

Publication # 40535 February 2007
DotProd
Dot Product
Synopsis
AplStatus aplsDotProd_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , int len , Apl32f* pDp );
AplStatus aplsDotProd_32fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , int len , Apl32fc* pDp );
AplStatus aplsDotProd_32f32fc ( const Apl32f* pSrc1 , const Apl32fc* pSrc2 , int len , Apl32fc* pDp );
AplStatus aplsDotProd_32f64f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , int len , Apl64f* pDp );
AplStatus aplsDotProd_32fc64fc ( const Apl32fc* pSrc1 , const Apl32fc* pSrc2 , int len , Apl64fc* pDp );
AplStatus aplsDotProd_32f32fc64fc ( const Apl32f* pSrc1 , const Apl32fc* pSrc2 , int len , Apl64fc* pDp );
AplStatus aplsDotProd_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , int len , Apl64f* pDp );
AplStatus aplsDotProd_64fc ( const Apl64fc* pSrc1 , const Apl64fc* pSrc2 , int len , Apl64fc* pDp );
AplStatus aplsDotProd_64f64fc ( const Apl64f* pSrc1 , const Apl64fc* pSrc2 , int len , Apl64fc* pDp );
AplStatus aplsDotProd_16s64s ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl64s* pDp );
AplStatus aplsDotProd_16sc64sc ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , int len , Apl64sc* pDp );
AplStatus aplsDotProd_16s16sc64sc ( const Apl16s* pSrc1 , const Apl16sc* pSrc2 , int len , Apl64sc* pDp );
AplStatus aplsDotProd_16s32f ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32f* pDp );
AplStatus aplsDotProd_16sc32fc ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , int len , Apl32fc* pDp );
AplStatus aplsDotProd_16s16sc32fc ( const Apl16s* pSrc1 , const Apl16sc* pSrc2 , int len , Apl32fc* pDp );
AplStatus aplsDotProd_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl16s* pDp , int scaleFactor );
AplStatus aplsDotProd_16sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , int len , Apl16sc* pDp , int scaleFactor );
AplStatus aplsDotProd_32s_Sfs ( const Apl32s* pSrc1 , const Apl32s* pSrc2 , int len , Apl32s* pDp , int scaleFactor );
AplStatus aplsDotProd_32sc_Sfs ( const Apl32sc* pSrc1 , const Apl32sc* pSrc2 , int len , Apl32sc* pDp , int scaleFactor );
AplStatus aplsDotProd_16s32s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , int len , Apl32s* pDp , int scaleFactor );
AplStatus aplsDotProd_16s16sc32sc_Sfs ( const Apl16s* pSrc1 , const Apl16sc* pSrc2 , int len , Apl32sc* pDp , int scaleFactor );
AplStatus aplsDotProd_16s32s32s_Sfs ( const Apl16s* pSrc1 , const Apl32s* pSrc2 , int len , Apl32s* pDp , int scaleFactor );
AplStatus aplsDotProd_16s16sc_Sfs ( const Apl16s* pSrc1 , const Apl16sc* pSrc2 , int len , Apl16sc* pDp , int scaleFactor );
AplStatus aplsDotProd_16sc32sc_Sfs ( const Apl16sc* pSrc1 , const Apl16sc* pSrc2 , int len , Apl32sc* pDp , int scaleFactor );
AplStatus aplsDotProd_32s32sc_Sfs ( const Apl32s* pSrc1 , const Apl32sc* pSrc2 , int len , Apl32sc* pDp , int scaleFactor );
Parameters
len Specifies the number of elements in a buffer.
pDp Pointer to the destination buffer that contains the dot product of the source buffers.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
AMD Performance Library User’s Manual 97 Signal Processing Library

Publication # 40535 February 2007
Description
These functions step through vector elements in two buffers, calculate the dot product of the vectors, and write the result to a location
specified by a pointer.
The following formula is used:
DotProduct = ((n = 0) - (len-1)) Sum(pSrc1[n] * pSrc2[n]).
There are 16-bit and 32-bit signed and signed complex versions that perform an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 98 Signal Processing Library

Publication # 40535 February 2007
Sum
Sum
Synopsis
AplStatus aplsSum_32f ( const Apl32f* pSrc , int len , Apl32f* pSum , AplHintAlgorithm hint );
AplStatus aplsSum_32fc ( const Apl32fc* pSrc , int len , Apl32fc* pSum , AplHintAlgorithm hint );
AplStatus aplsSum_64f ( const Apl64f* pSrc , int len , Apl64f* pSum );
AplStatus aplsSum_64fc ( const Apl64fc* pSrc , int len , Apl64fc* pSum );
AplStatus aplsSum_16s_Sfs ( const Apl16s* pSrc , int len , Apl16s* pSum , int scaleFactor );
AplStatus aplsSum_32s_Sfs ( const Apl32s* pSrc , int len , Apl32s* pSum , int scaleFactor );
AplStatus aplsSum_16s32s_Sfs ( const Apl16s* pSrc , int len , Apl32s* pSum , int scaleFactor );
AplStatus aplsSum_16sc_Sfs ( const Apl16sc* pSrc , int len , Apl16sc* pSum , int scaleFactor );
AplStatus aplsSum_16sc32sc_Sfs ( const Apl16sc* pSrc , int len , Apl32sc* pSum , int scaleFactor );
Parameters
hint Hints whether to choose a fast or accurate computation algorithm.
len Specifies the number of elements in a buffer.
pSrc Pointer to a source buffer.
pSum Pointer to the destination buffer that contains the sum of all the elements in the source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the sum of the elements, and write the result to a location
specified by a pointer.
The following formula is used:
Sum( ) = ((n = 0) - (len-1)) Sum(pSrc[n]).
The 16-bit signed and signed complex and 32-bit signed versions perform an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 99 Signal Processing Library

Publication # 40535 February 2007
StdDev
Standard deviation
Synopsis
AplStatus aplsStdDev_32f ( const Apl32f* pSrc , int len , Apl32f* pStdDev , AplHintAlgorithm hint );
AplStatus aplsStdDev_64f ( const Apl64f* pSrc , int len , Apl64f* pStdDev );
AplStatus aplsStdDev_16s32s_Sfs ( const Apl16s* pSrc , int len , Apl32s* pStdDev , int scaleFactor );
AplStatus aplsStdDev_16s_Sfs ( const Apl16s* pSrc , int len , Apl16s* pStdDev , int scaleFactor );
Parameters
hint Hints whether to choose a fast or accurate computation algorithm.
len Specifies the number of elements in a buffer.
pSrc Pointer to a source buffer.
pStdDev Pointer to the destination buffer that contains the standard deviation of the values in the source buffer.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through vector elements in a source buffer, calculate the standard deviation of the elements, and write the result
to a location specified by a pointer.
The following formula is used:
StdDev( ) = Sqrt(((n = 0) - (len-1)) Sum(Square(pSrc[n]-pMean))/len-1)
The 16-bit signed versions perform an integer scaling operation on the result.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 100 Signal Processing Library

Publication # 40535 February 2007
Fixed Accuracy Arithmetic Functions
This chapter describes functions that perform arithmetic operations at a chosen level of accuracy. These functions provide flexible
specification of accuracy and support IEEE-754 standards. Choice of accuracy level is based on practical experience and application
requirements. Options are specified by a function name suffix.
The options for the single-precision data format are A11, A21, and A24.
The options for the double-precision data format are A50 and A53.
For single precision data:
• Suffix_A11 guarantees 11 correctly rounded bits of significand, or at least three exact decimal digits
• Suffix_A21 guarantees 21 correctly rounded bits of significand, or four ulps, or approximately six exact decimal digits
• Suffix_A24 guarantees 24 correctly rounded bits of significand, including the implied bit, with the maximum guaranteed error
within one ulp.
For double precision data:
• Suffix_A50 guarantees 50 correctly rounded bits of significand, or four ulps, or approximately 15 exact decimal digits
• Suffix_A53 guarantees 53 correctly rounded bits of significand, including the implied bit, with the maximum guaranteed error
within one ulp.
AMD Performance Library User’s Manual 101 Signal Processing Library

Publication # 40535 February 2007
Inv
Inverse
Synopsis
AplStatus aplsInv_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInv_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInv_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInv_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsInv_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through a source buffer, calculate the inverse of each element, write the results to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 102 Signal Processing Library

Publication # 40535 February 2007
Div
Divide
Synopsis
AplStatus aplsDiv_32f_A11 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsDiv_32f_A21 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsDiv_32f_A24 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsDiv_64f_A50 ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
AplStatus aplsDiv_64f_A53 ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
Description
These functions step through vector elements in two source buffers, divide the elements in buffer 1 by the elements in buffer 2, and
write the results to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 103 Signal Processing Library

Publication # 40535 February 2007
Sqrt
Square root
Synopsis
AplStatus aplsSqrt_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsSqrt_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsSqrt_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsSqrt_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsSqrt_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the square root of each element, and write the results to a
destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 104 Signal Processing Library

Publication # 40535 February 2007
InvSqrt
Inverse Square root
Synopsis
AplStatus aplsInvSqrt_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvSqrt_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvSqrt_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvSqrt_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsInvSqrt_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the inverse square root of each element, and write the
results to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 105 Signal Processing Library

Publication # 40535 February 2007
Cbrt
Cube root
Synopsis
AplStatus aplsCbrt_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsCbrt_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsCbrt_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsCbrt_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsCbrt_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the cube root of each element, and write the results to a
destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 106 Signal Processing Library

Publication # 40535 February 2007
InvCbrt
Inverse cube root
Synopsis
AplStatus aplsInvCbrt_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvCbrt_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvCbrt_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsInvCbrt_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsInvCbrt_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the inverse cube root of each element, and write the results
to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 107 Signal Processing Library

Publication # 40535 February 2007
Pow
Power
Synopsis
AplStatus aplsPow_32f_A11 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsPow_32f_A21 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsPow_32f_A24 ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int len );
AplStatus aplsPow_64f_A50 ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
AplStatus aplsPow_64f_A53 ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
Description
These functions step through vector elements in two source buffers, raise each element of buffer 1 to the power specified by the
corresponding element of buffer 2, and write the results to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 108 Signal Processing Library

Publication # 40535 February 2007
Powx
Constant power
Synopsis
AplStatus aplsPowx_32f_A11 ( const Apl32f* pSrc1 , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsPowx_32f_A21 ( const Apl32f* pSrc1 , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsPowx_32f_A24 ( const Apl32f* pSrc1 , Apl32f val , Apl32f* pDst , int len );
AplStatus aplsPowx_64f_A50 ( const Apl64f* pSrc1 , Apl64f val , Apl64f* pDst , int len );
AplStatus aplsPowx_64f_A53 ( const Apl64f* pSrc1 , Apl64f val , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc1 Pointer to source buffer one.
val Specified value.
Description
These functions step through vector elements in a source buffer, raise each element to a power specified by a constant, and write the
results to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 109 Signal Processing Library

Publication # 40535 February 2007
Exp
Exponential
Synopsis
AplStatus aplsExp_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsExp_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsExp_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsExp_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsExp_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, raise e to the power specified by each element, and write the results
to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsOverflow Overflow in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsUnderflow Underflow in operation warning status code.
AMD Performance Library User’s Manual 110 Signal Processing Library

Publication # 40535 February 2007
Ln
Natural Logarithm
Synopsis
AplStatus aplsLn_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLn_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLn_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLn_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsLn_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the natural logarithm of each element, and write the results
to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 111 Signal Processing Library

Publication # 40535 February 2007
Log10
Common Logarithm
Synopsis
AplStatus aplsLog10_32f_A11 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLog10_32f_A21 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLog10_32f_A24 ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsLog10_64f_A50 ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsLog10_64f_A53 ( const Apl64f* pSrc , Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions step through vector elements in a source buffer, calculate the common logarithm of each element, and write the
results to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 112 Signal Processing Library

Publication # 40535 February 2007
Vector Initialization Functions
This chapter describes functions that perform vector initialization tasks.
AMD Performance Library User’s Manual 113 Signal Processing Library

Publication # 40535 February 2007
Copy
Copy vector
Synopsis
AplStatus aplsCopy_8u ( const Apl8u* pSrc , Apl8u* pDst , int len );
AplStatus aplsCopy_16s ( const Apl16s* pSrc , Apl16s* pDst , int len );
AplStatus aplsCopy_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len );
AplStatus aplsCopy_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsCopy_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len );
AplStatus aplsCopy_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsCopy_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions copy the vector elements in a source buffer to a destination buffer.
Return Values
aplStsDomain Argument out of function domain warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSingularity Singularity in operation warning status code.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 114 Signal Processing Library

Publication # 40535 February 2007
Move
Move vector
Synopsis
AplStatus aplsMove_8u ( const Apl8u* pSrc , Apl8u* pDst , int len );
AplStatus aplsMove_16s ( const Apl16s* pSrc , Apl16s* pDst , int len );
AplStatus aplsMove_16sc ( const Apl16sc* pSrc , Apl16sc* pDst , int len );
AplStatus aplsMove_32f ( const Apl32f* pSrc , Apl32f* pDst , int len );
AplStatus aplsMove_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , int len );
AplStatus aplsMove_64f ( const Apl64f* pSrc , Apl64f* pDst , int len );
AplStatus aplsMove_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
Description
These functions move the vector elements in a source buffer to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 115 Signal Processing Library

Publication # 40535 February 2007
Set
Set vector
Synopsis
AplStatus aplsSet_8u ( Apl8u val , Apl8u* pDst , int len );
AplStatus aplsSet_16s ( Apl16s val , Apl16s* pDst , int len );
AplStatus aplsSet_16sc ( Apl16sc val , Apl16sc* pDst , int len );
AplStatus aplsSet_32s ( Apl32s val , Apl32s* pDst , int len );
AplStatus aplsSet_32f ( Apl32f val , Apl32f* pDst , int len );
AplStatus aplsSet_32sc ( Apl32sc val , Apl32sc* pDst , int len );
AplStatus aplsSet_32fc ( Apl32fc val , Apl32fc* pDst , int len );
AplStatus aplsSet_64s ( Apl64s val , Apl64s* pDst , int len );
AplStatus aplsSet_64f ( Apl64f val , Apl64f* pDst , int len );
AplStatus aplsSet_64sc ( Apl64sc val , Apl64sc* pDst , int len );
AplStatus aplsSet_64fc ( Apl64fc val , Apl64fc* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
val Specified value.
Description
These functions set elements of a vector in a destination buffer to a specified value. A length parameter specifies the number of
elements that are set.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 116 Signal Processing Library

Publication # 40535 February 2007
Zero
Clear vector
Synopsis
AplStatus aplsZero_8u ( Apl8u* pDst , int len );
AplStatus aplsZero_16s ( Apl16s* pDst , int len );
AplStatus aplsZero_16sc ( Apl16sc* pDst , int len );
AplStatus aplsZero_32f ( Apl32f* pDst , int len );
AplStatus aplsZero_32fc ( Apl32fc* pDst , int len );
AplStatus aplsZero_64f ( Apl64f* pDst , int len );
Parameters
len Specifies the number of elements in a buffer.
pDst Pointer to a destination buffer.
Description
These functions clear elements of a vector in a destination buffer to zero. A length parameter specifies the number of elements that
are cleared.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 117 Signal Processing Library

Publication # 40535 February 2007
Transform Functions
This chapter describes functions that perform frequency and time domain transformation.
AMD Performance Library User’s Manual 118 Signal Processing Library

Publication # 40535 February 2007
ConjPack
Convert Pack to complex
Synopsis
AplStatus aplsConjPack_16sc ( const Apl16s* pSrc , Apl16sc* pDst , int lenDst );
AplStatus aplsConjPack_32fc ( const Apl32f* pSrc , Apl32fc* pDst , int lenDst );
AplStatus aplsConjPack_64fc ( const Apl64f* pSrc , Apl64fc* pDst , int lenDst );
AplStatus aplsConjPack_16sc_I ( Apl16sc* pSrcDst , int lenDst );
AplStatus aplsConjPack_32fc_I ( Apl32fc* pSrcDst , int lenDst );
AplStatus aplsConjPack_64fc_I ( Apl64fc* pSrcDst , int lenDst );
Parameters
lenDst Specifies the number of elements in a destination vector.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through a source buffer of complex vectors stored in the Pack format and convert them to the general complex
format. The result can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 119 Signal Processing Library

Publication # 40535 February 2007
ConjPerm
Convert Perm to complex
Synopsis
AplStatus aplsConjPerm_16sc ( const Apl16s* pSrc , Apl16sc* pDst , int lenDst );
AplStatus aplsConjPerm_32fc ( const Apl32f* pSrc , Apl32fc* pDst , int lenDst );
AplStatus aplsConjPerm_64fc ( const Apl64f* pSrc , Apl64fc* pDst , int lenDst );
AplStatus aplsConjPerm_16sc_I ( Apl16sc* pSrcDst , int lenDst );
AplStatus aplsConjPerm_32fc_I ( Apl32fc* pSrcDst , int lenDst );
AplStatus aplsConjPerm_64fc_I ( Apl64fc* pSrcDst , int lenDst );
Parameters
lenDst Specifies the number of elements in a destination vector.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through a source buffer of complex vectors stored in the Perm format and convert them to the general complex
format. The result can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 120 Signal Processing Library

Publication # 40535 February 2007
ConjCcs
Convert CCS to complex
Synopsis
AplStatus aplsConjCcs_16sc ( const Apl16s* pSrc , Apl16sc* pDst , int lenDst );
AplStatus aplsConjCcs_32fc ( const Apl32f* pSrc , Apl32fc* pDst , int lenDst );
AplStatus aplsConjCcs_64fc ( const Apl64f* pSrc , Apl64fc* pDst , int lenDst );
AplStatus aplsConjCcs_16sc_I ( Apl16sc* pSrcDst , int lenDst );
AplStatus aplsConjCcs_32fc_I ( Apl32fc* pSrcDst , int lenDst );
AplStatus aplsConjCcs_64fc_I ( Apl64fc* pSrcDst , int lenDst );
Parameters
lenDst Specifies the number of elements in a destination vector.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions step through a source buffer of complex vectors stored in the CCS format and convert them to the general complex
format. The result can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 121 Signal Processing Library

Publication # 40535 February 2007
MulPack
Multiply Pack vectors
Synopsis
AplStatus aplsMulPack_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int length , int scaleFactor );
AplStatus aplsMulPack_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int length );
AplStatus aplsMulPack_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int length );
AplStatus aplsMulPack_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int length , int scaleFactor );
AplStatus aplsMulPack_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int length );
AplStatus aplsMulPack_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int length );
Parameters
length Specifies the number of elements in a vector.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through two source buffers, multiply a Pack format complex vector in source buffer 1 by a Pack format complex
vector in source buffer 2, and write the product in Pack format. The product can be written to a destination buffer or written back to
source buffer 2.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 122 Signal Processing Library

Publication # 40535 February 2007
MulPerm
Multiply Perm vectors
Synopsis
AplStatus aplsMulPerm_16s_Sfs ( const Apl16s* pSrc1 , const Apl16s* pSrc2 , Apl16s* pDst , int length , int scaleFactor );
AplStatus aplsMulPerm_32f ( const Apl32f* pSrc1 , const Apl32f* pSrc2 , Apl32f* pDst , int length );
AplStatus aplsMulPerm_64f ( const Apl64f* pSrc1 , const Apl64f* pSrc2 , Apl64f* pDst , int length );
AplStatus aplsMulPerm_16s_ISfs ( const Apl16s* pSrc , Apl16s* pSrcDst , int length , int scaleFactor );
AplStatus aplsMulPerm_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int length );
AplStatus aplsMulPerm_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int length );
Parameters
length Specifies the number of elements in a vector.
pDst Pointer to a destination buffer.
pSrc Pointer to a source buffer.
pSrc1 Pointer to source buffer one.
pSrc2 Pointer to source buffer two.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through two source buffers, multiply a Perm format complex vector in source buffer 1 by a Perm format complex
vector in source buffer 2, and write the product in Perm format. The product can be written to a destination buffer or written back to
source buffer 2.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 123 Signal Processing Library

Publication # 40535 February 2007
MulPackConj
Multiply Pack vector and complex-conjugate
Synopsis
AplStatus aplsMulPackConj_32f_I ( const Apl32f* pSrc , Apl32f* pSrcDst , int length );
AplStatus aplsMulPackConj_64f_I ( const Apl64f* pSrc , Apl64f* pSrcDst , int length );
Parameters
length Specifies the number of elements in a vector.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Description
These functions Step through two source buffers, multiply a Pack format complex vector in source buffer 1 by the complex-conjugate
of Pack format complex vector in source buffer 2, and write the product in Pack format. The product is written back to source buffer 2.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 124 Signal Processing Library

Publication # 40535 February 2007
FFTInitAlloc
Allocate memory and initialize FFT structure
Synopsis
AplStatus aplsFFTInitAlloc_C_16sc ( AplsFFTSpec_C_16sc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_32sc ( AplsFFTSpec_C_32sc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_32fc ( AplsFFTSpec_C_32fc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_64fc ( AplsFFTSpec_C_64fc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_16s ( AplsFFTSpec_C_16s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_32s ( AplsFFTSpec_C_32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_32f ( AplsFFTSpec_C_32f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_C_64f ( AplsFFTSpec_C_64f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_R_16s ( AplsFFTSpec_R_16s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_R_32s ( AplsFFTSpec_R_32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_R_16s32s ( AplsFFTSpec_R_16s32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_R_32f ( AplsFFTSpec_R_32f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
AplStatus aplsFFTInitAlloc_R_64f ( AplsFFTSpec_R_64f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint );
Parameters
flag Specifies the FFT division type. It is enumerated in aplBase.h.
hint Hints whether to choose a fast or accurate computation algorithm.
order Order of an FFT signal. The length of the signal is 2^order.
ppFFTSpec Double pointer to the FFT specification structure.
Description
These functions allocate memory and initialize an FFT specification structure defined by double pointer ppFFTSpec, based on the values
of the order, hint and flag parameters. The order parameter specifies the transform length. The hint argument suggests using either a
faster or more accurate algorithm. The flag parameter specifies the method of normalization to be used. There are separate functions
for complex and real signals. The structure can be used by the FFTFwd and FFTInv functions.
Return Values
aplStsFftFlagErr The flag value is incorrect.
aplStsFftOrderErr The specified order is out of bounds.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 125 Signal Processing Library

Publication # 40535 February 2007
FFTFree
Free FFT structure memory
Synopsis
AplStatus aplsFFTFree_C_16sc ( AplsFFTSpec_C_16sc* pFFTSpec );
AplStatus aplsFFTFree_C_32sc ( AplsFFTSpec_C_32sc* pFFTSpec );
AplStatus aplsFFTFree_C_32fc ( AplsFFTSpec_C_32fc* pFFTSpec );
AplStatus aplsFFTFree_C_64fc ( AplsFFTSpec_C_64fc* pFFTSpec );
AplStatus aplsFFTFree_C_16s ( AplsFFTSpec_C_16s* pFFTSpec );
AplStatus aplsFFTFree_C_32s ( AplsFFTSpec_C_32s* pFFTSpec );
AplStatus aplsFFTFree_C_32f ( AplsFFTSpec_C_32f* pFFTSpec );
AplStatus aplsFFTFree_C_64f ( AplsFFTSpec_C_64f* pFFTSpec );
AplStatus aplsFFTFree_R_16s ( AplsFFTSpec_R_16s* pFFTSpec );
AplStatus aplsFFTFree_R_32s ( AplsFFTSpec_R_32s* pFFTSpec );
AplStatus aplsFFTFree_R_16s32s ( AplsFFTSpec_R_16s32s* pFFTSpec );
AplStatus aplsFFTFree_R_32f ( AplsFFTSpec_R_32f* pFFTSpec );
AplStatus aplsFFTFree_R_64f ( AplsFFTSpec_R_64f* pFFTSpec );
Parameters
pFFTSpec Pointer to the FFT specification structure.
Description
These functions free the memory allocated to a specification structure by the FFTInitAlloc( ) function. The pointer pFFTSpec indicates
the structure to be removed. There are functions for real and complex signals. Make sure to use the FFTFree( ) function only for a
structure created with the FFTInitAlloc( ) function.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 126 Signal Processing Library

Publication # 40535 February 2007
FFTInit
Initialize FFT structure
Synopsis
AplStatus aplsFFTInit_C_16sc ( AplsFFTSpec_C_16sc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec ,
Apl8u* pBufInit );
AplStatus aplsFFTInit_C_32sc ( AplsFFTSpec_C_32sc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec ,
Apl8u* pBufInit );
AplStatus aplsFFTInit_C_32fc ( AplsFFTSpec_C_32fc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec ,
Apl8u* pBufInit );
AplStatus aplsFFTInit_C_64fc ( AplsFFTSpec_C_64fc** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec ,
Apl8u* pBufInit );
AplStatus aplsFFTInit_C_16s ( AplsFFTSpec_C_16s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_C_32s ( AplsFFTSpec_C_32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_C_32f ( AplsFFTSpec_C_32f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_C_64f ( AplsFFTSpec_C_64f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_R_16s ( AplsFFTSpec_R_16s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_R_32s ( AplsFFTSpec_R_32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_R_16s32s ( AplsFFTSpec_R_16s32s** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec ,
Apl8u* pBufInit );
AplStatus aplsFFTInit_R_32f ( AplsFFTSpec_R_32f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
AplStatus aplsFFTInit_R_64f ( AplsFFTSpec_R_64f** ppFFTSpec , int order , int flag , AplHintAlgorithm hint , Apl8u* pMemSpec , Apl8u*
pBufInit );
Parameters
flag Specifies the FFT division type. It is enumerated in aplBase.h.
hint Hints whether to choose a fast or accurate computation algorithm.
order Order of an FFT signal. The length of the signal is 2^order.
pBufInit Pointer to memory required for FFT initialization.
pMemSpec Pointer to memory where the FFT specification structure is initialized.
ppFFTSpec Double pointer to the FFT specification structure.
AMD Performance Library User’s Manual 127 Signal Processing Library

Publication # 40535 February 2007
Description
These functions initialize an FFT specification structure defined by double pointer ppFFTSpec. The structure is initialized based on the
values of the order, hint and flag parameters. The order parameter specifies the transform length. The hint argument suggests using
either a faster or more accurate algorithm. The flag parameter specifies the method of normalization to be used. There are functions
for real and complex signals. Pointer pMemSpec points to the location of the structure (MemSpec) and pointer pBufInit points to the
location of the initialization buffer (BufInit). To allocate memory for the specification structure and initialization buffer, first use the
appropriate FFTGetSize function to obtain the sizes of the structure and the buffer, then use the Malloc function. Use the Free function
to remove buffer and structure.
Return Values
aplStsFftFlagErr The flag value is incorrect.
aplStsFftOrderErr The specified order is out of bounds.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 128 Signal Processing Library

Publication # 40535 February 2007
FFTGetSize
Get FFTInit buffer size
Synopsis
AplStatus aplsFFTGetSize_C_16sc ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_32sc ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_32fc ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_64fc ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_16s ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_32s ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_32f ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_C_64f ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_R_16s ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_R_32s ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_R_16s32s ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_R_32f ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
AplStatus aplsFFTGetSize_R_64f ( int order , int flag , AplHintAlgorithm hint , int* pSizeSpec , int* pSizeInit , int* pSizeBuf );
Parameters
flag Specifies the FFT division type. It is enumerated in aplBase.h.
hint Hints whether to choose a fast or accurate computation algorithm.
order Order of an FFT signal. The length of the signal is 2^order.
pSizeBuf Pointer to the size of the FFT work buffer used by the FFTFwd and FFTInv functions.
pSizeInit Pointer to the size of the BufInit buffer used by the FFTInit function.
pSizeSpec Pointer to the size of the MemSpec buffer used by the FFTInit function.
Description
These functions calculate the sizes of buffers used by the FFTInit, FFTFwd, and FFTInv functions. After the function call, pSizeSpec
points to the size of the FFTInit( ) MemSpec buffer, pSizeInit points to the size of the FFTInit( ) BufInit buffer, and pSizeBuf points
to the size of the work buffer used by the FFTFwd, and FFTInv functions. Buffer memory must be allocated by the Malloc function
before FFTInit( ) is called. There are separate functions for real and complex signals.
Return Values
aplStsFftFlagErr The flag value is incorrect.
aplStsFftOrderErr The specified order is out of bounds.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 129 Signal Processing Library

Publication # 40535 February 2007
FFTGetBufSize
Get FFT buffer size
Synopsis
AplStatus aplsFFTGetBufSize_C_16sc ( const AplsFFTSpec_C_16sc* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_32sc ( const AplsFFTSpec_C_32sc* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_32fc ( const AplsFFTSpec_C_32fc* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_64fc ( const AplsFFTSpec_C_64fc* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_16s ( const AplsFFTSpec_C_16s* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_32s ( const AplsFFTSpec_C_32s* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_32f ( const AplsFFTSpec_C_32f* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_C_64f ( const AplsFFTSpec_C_64f* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_R_16s ( const AplsFFTSpec_R_16s* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_R_32s ( const AplsFFTSpec_R_32s* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_R_16s32s ( const AplsFFTSpec_R_16s32s* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_R_32f ( const AplsFFTSpec_R_32f* pFFTSpec , int* pSize );
AplStatus aplsFFTGetBufSize_R_64f ( const AplsFFTSpec_R_64f* pFFTSpec , int* pSize );
Parameters
pFFTSpec Pointer to the FFT specification structure.
pSize Pointer to the size of the FFT work buffer used by the FFTFwd and FFTInv functions.
Description
These functions calculate the size of the work buffer used by the FFTFwd and FFTInv functions. After the function call, pSize points to
the size of the work buffer. The pBuffer parameter of the FFTFwd and FFTInv functions point to the work buffer. There are separate
functions for real and complex signals.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 130 Signal Processing Library

Publication # 40535 February 2007
FFTFwd_CToC
FFT forward complex
Synopsis
AplStatus aplsFFTFwd_CToC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc* pDst , const AplsFFTSpec_C_16sc* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc* pDst , const AplsFFTSpec_C_32sc* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , const AplsFFTSpec_C_32fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , const AplsFFTSpec_C_64fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_16sc_ISfs ( Apl16sc* pSrcDst , const AplsFFTSpec_C_16sc* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32sc_ISfs ( Apl32sc* pSrcDst , const AplsFFTSpec_C_32sc* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32fc_I ( Apl32fc* pSrcDst , const AplsFFTSpec_C_32fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_64fc_I ( Apl64fc* pSrcDst , const AplsFFTSpec_C_64fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_16s_Sfs ( const Apl16s* pSrcRe , const Apl16s* pSrcIm , Apl16s* pDstRe , Apl16s* pDstIm , const
AplsFFTSpec_C_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32s_Sfs ( const Apl32s* pSrcRe , const Apl32s* pSrcIm , Apl32s* pDstRe , Apl32s* pDstIm , const
AplsFFTSpec_C_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32f ( const Apl32f* pSrcRe , const Apl32f* pSrcIm , Apl32f* pDstRe , Apl32f* pDstIm , const
AplsFFTSpec_C_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_64f ( const Apl64f* pSrcRe , const Apl64f* pSrcIm , Apl64f* pDstRe , Apl64f* pDstIm , const
AplsFFTSpec_C_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_16s_ISfs ( Apl16s* pSrcDstRe , Apl16s* pSrcDstIm , const AplsFFTSpec_C_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32s_ISfs ( Apl32s* pSrcDstRe , Apl32s* pSrcDstIm , const AplsFFTSpec_C_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_32f_I ( Apl32f* pSrcDstRe , Apl32f* pSrcDstIm , const AplsFFTSpec_C_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_CToC_64f_I ( Apl64f* pSrcDstRe , Apl64f* pSrcDstIm , const AplsFFTSpec_C_64f* pFFTSpec , Apl8u* pBuffer );
AMD Performance Library User’s Manual 131 Signal Processing Library

Publication # 40535 February 2007
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pDstIm Pointer to a destination buffer that contains the imaginary component values of an output signal.
pDstRe Pointer to a destination buffer that contains the real component values of an output signal.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
pSrcDstIm Pointer to a source/destination buffer that contains the imaginary components of input and output signals.
pSrcDstRe Pointer to a source/destination buffer that contains the real components of input and output signals.
pSrcIm Pointer to a source buffer that contains the imaginary component values of an input signal.
pSrcRe Pointer to a source buffer that contains the real component values of an input signal.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions calculate the forward FFT of a complex signal. There are versions that step through a single source buffer that contains
complex numbers and versions that step through dual source buffers that contain real and imaginary component values. Each version
writes results of the corresponding type. Results can be written to a separate destination or written back to the source. The pointer
pBuffer specifies the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 132 Signal Processing Library

Publication # 40535 February 2007
FFTInv_CToC
FFT inverse complex
Synopsis
AplStatus aplsFFTInv_CToC_16sc_Sfs ( const Apl16sc* pSrc , Apl16sc* pDst , const AplsFFTSpec_C_16sc* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32sc_Sfs ( const Apl32sc* pSrc , Apl32sc* pDst , const AplsFFTSpec_C_32sc* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32fc ( const Apl32fc* pSrc , Apl32fc* pDst , const AplsFFTSpec_C_32fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_64fc ( const Apl64fc* pSrc , Apl64fc* pDst , const AplsFFTSpec_C_64fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_16sc_ISfs ( Apl16sc* pSrcDst , const AplsFFTSpec_C_16sc* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32sc_ISfs ( Apl32sc* pSrcDst , const AplsFFTSpec_C_32sc* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32fc_I ( Apl32fc* pSrcDst , const AplsFFTSpec_C_32fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_64fc_I ( Apl64fc* pSrcDst , const AplsFFTSpec_C_64fc* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_16s_Sfs ( const Apl16s* pSrcRe , const Apl16s* pSrcIm , Apl16s* pDstRe , Apl16s* pDstIm , const
AplsFFTSpec_C_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32s_Sfs ( const Apl32s* pSrcRe , const Apl32s* pSrcIm , Apl32s* pDstRe , Apl32s* pDstIm , const
AplsFFTSpec_C_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32f ( const Apl32f* pSrcRe , const Apl32f* pSrcIm , Apl32f* pDstRe , Apl32f* pDstIm , const
AplsFFTSpec_C_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_64f ( const Apl64f* pSrcRe , const Apl64f* pSrcIm , Apl64f* pDstRe , Apl64f* pDstIm , const
AplsFFTSpec_C_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_16s_ISfs ( Apl16s* pSrcDstRe , Apl16s* pSrcDstIm , const AplsFFTSpec_C_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32s_ISfs ( Apl32s* pSrcDstRe , Apl32s* pSrcDstIm , const AplsFFTSpec_C_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_32f_I ( Apl32f* pSrcDstRe , Apl32f* pSrcDstIm , const AplsFFTSpec_C_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CToC_64f_I ( Apl64f* pSrcDstRe , Apl64f* pSrcDstIm , const AplsFFTSpec_C_64f* pFFTSpec , Apl8u* pBuffer );
AMD Performance Library User’s Manual 133 Signal Processing Library

Publication # 40535 February 2007
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pDstIm Pointer to a destination buffer that contains the imaginary component values of an output signal.
pDstRe Pointer to a destination buffer that contains the real component values of an output signal.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
pSrcDstIm Pointer to a source/destination buffer that contains the imaginary components of input and output signals.
pSrcDstRe Pointer to a source/destination buffer that contains the real components of input and output signals.
pSrcIm Pointer to a source buffer that contains the imaginary component values of an input signal.
pSrcRe Pointer to a source buffer that contains the real component values of an input signal.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions calculate the inverse FFT of a complex signal. There are versions that step through a single source buffer that contains
complex numbers and versions that step through dual source buffers that contain real and imaginary component values. Each version
writes results of the corresponding type. Results can be written to a separate destination or written back to the source. The pointer
pBuffer specifies the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 134 Signal Processing Library

Publication # 40535 February 2007
FFTFwd_RToCCS
FFT forward real CCS
Synopsis
AplStatus aplsFFTFwd_RToCCS_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_16s32s_Sfs ( const Apl16s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_16s32s* pFFTSpec , int
scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToCCS_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the forward FFT of a real signal, and write the result in CCS format. The Fourier
transform of a real signal is in the Hermitian complex form. The forward FFT of an N-element real signal is a N-element complex signal
(2N real elements). Because it is an Hermitian sequence, almost half of the signal can be reproduced from the rest due to complexconjugate
redundancy. This redundancy is used to save space in storing the FFT output. CCS is a format for storing FFT output of real
signals. Results can be written to a destination buffer or written back to the source buffer. The pointer pBuffer specifies the work buffer
required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
AMD Performance Library User’s Manual 135 Signal Processing Library

Publication # 40535 February 2007
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 136 Signal Processing Library

Publication # 40535 February 2007
FFTFwd_RToPack
FFT forward real Pack
Synopsis
AplStatus aplsFFTFwd_RToPack_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPack_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the forward FFT of a real signal, and write the result in Pack format. The
Fourier transform of a real signal is in the Hermitian complex form. The forward FFT of an N-element real signal is a N-element
complex signal (2N real elements). Because it is an Hermitian sequence, almost half of the signal can be reproduced from the rest due
to complex-conjugate redundancy. This redundancy is used to save space in storing the FFT output. Pack is a format for storing FFT
output of real signals. Results can be written to a destination buffer or written back to the source buffer. The pointer pBuffer specifies
the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 137 Signal Processing Library

Publication # 40535 February 2007
FFTFwd_RToPerm
FFT forward real Perm
Synopsis
AplStatus aplsFFTFwd_RToPerm_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTFwd_RToPerm_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the forward FFT of a real signal, and write the result in Perm format. The
Fourier transform of a real signal is in the Hermitian complex form. The forward FFT of an N-element real signal is a N-element
complex signal (2N real elements). Because it is an Hermitian sequence, almost half of the signal can be reproduced from the rest due
to complex-conjugate redundancy. This redundancy is used to save space in storing the FFT output. Perm is a format for storing FFT
output of real signals. Results can be written to a destination buffer or written back to the source buffer. The pointer pBuffer specifies
the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 138 Signal Processing Library

Publication # 40535 February 2007
FFTInv_CCSToR
FFT inverse complex CCS to real
Synopsis
AplStatus aplsFFTInv_CCSToR_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_32s16s_Sfs ( const Apl32s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s32s* pFFTSpec , int
scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_CCSToR_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the inverse FFT of a complex signal in CCS format, and write a real number
result. The forward Fourier transform of a real signal is in the Hermitian complex form. Inverse Fourier transformation of an Hermitian
complex signal results in a real signal. Results can be written to a destination buffer or written back to the source buffer. The pointer
pBuffer specifies the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 139 Signal Processing Library

Publication # 40535 February 2007
FFTInv_PackToR
FFT inverse complex Pack to real
Synopsis
AplStatus aplsFFTInv_PackToR_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PackToR_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the inverse FFT of a complex signal in Pack format, and write a real number
result. The forward Fourier transform of a real signal is in the Hermitian complex form. Inverse Fourier transformation of an Hermitian
complex signal results in a real signal. Results can be written to a destination buffer or written back to the source buffer. The pointer
pBuffer specifies the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 140 Signal Processing Library

Publication # 40535 February 2007
FFTInv_PermToR
FFT inverse complex Perm to real
Synopsis
AplStatus aplsFFTInv_PermToR_16s_Sfs ( const Apl16s* pSrc , Apl16s* pDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_32s_Sfs ( const Apl32s* pSrc , Apl32s* pDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor ,
Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_32f ( const Apl32f* pSrc , Apl32f* pDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_64f ( const Apl64f* pSrc , Apl64f* pDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_16s_ISfs ( Apl16s* pSrcDst , const AplsFFTSpec_R_16s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_32s_ISfs ( Apl32s* pSrcDst , const AplsFFTSpec_R_32s* pFFTSpec , int scaleFactor , Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_32f_I ( Apl32f* pSrcDst , const AplsFFTSpec_R_32f* pFFTSpec , Apl8u* pBuffer );
AplStatus aplsFFTInv_PermToR_64f_I ( Apl64f* pSrcDst , const AplsFFTSpec_R_64f* pFFTSpec , Apl8u* pBuffer );
Parameters
pBuffer Pointer to the FFT work buffer.
pDst Pointer to a destination buffer.
pFFTSpec Pointer to the FFT specification structure.
pSrc Pointer to a source buffer.
pSrcDst Pointer to a buffer that is both the source and destination.
Specifies the integer scaling factor for the Sfs operation. The returned result is
scaleFactor
multiplied by 2^(-scaleFactor).
Description
These functions step through a source buffer, calculate the inverse FFT of a complex signal in Perm format, and write a real number
result. The forward Fourier transform of a real signal is in the Hermitian complex form. Inverse Fourier transformation of an Hermitian
complex signal results in a real signal. Results can be written to a destination buffer or written back to the source buffer. The pointer
pBuffer specifies the work buffer required for the FFT operation. When the value of pBuffer is NULL, memory is internally allocated.
Return Values
aplStsContextMatchErr The specification structure does not match the function or is invalid.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 141 Signal Processing Library

Publication # 40535 February 2007
Image Processing Library
Introduction
AMD Performance Library (APL) image library functions perform image processing and video related tasks.
This section of the manual describes each of the image processing functions in detail.
Organization
Two introductory chapters are followed by chapters that describe groups of functions related by purpose.
• This Introduction provides a brief summary of the section.
• Basic Concepts provides an overview of the information contained in the functional descriptions.
• Library Version describes the function that returns information about the current version of the APL.
• Support Functions describes functions that are used to set up or maintain other APL functions.
• Data Exchange and Initialization Functions describes functions that set the initial value of an image data buffer, copy data
from one buffer to another, convert data type, and scale image data.
• Arithmetic and Logic Functions describes general-purpose mathematic functions and functions that perform specific
mathematic operations related to image processing.
• Color Model Conversion Functions describes functions that convert image data from one color model or space to another.
• Threshold and Compare Functions describes functions that compare image data and manipulate image data based on
compare operations.
• Geometric Transform Functions describes functions that warp, shear, resize, mirror, and rotate images.
• Digital Filter Functions describes functions that alter frequency-related visual properties of images.
• Video Coding Functions describes functions that are used to encode and decode moving images.
Within the chapters, each functional description consists ofa Function Name followed by a short description, a Synopsis of the
function syntax , a list of function Parameters, a detailed Description of the function, and a list of Return Values.
Basic Concepts
AMD Performance Library User’s Manual 142 Image Processing Library

Publication # 40535 February 2007
Image library functional descriptions include the following types of information.
Data Structures
Image library function definitions use the following data structures.
ApliPoint The point represented by (x, y).
ApliRect The position and size of a rectangle represented by (x, y, width, height).
ApliSize The size of a rectangle represented by (width, height).
Enumerators
Image library function definitions use the following enumerators.
ApliAlphaType Type of compositing operation for alpha composition functions.
ApliAxis Image intensity ramp for apliImageRamp functions or flip axes for apliMirror functions.
ApliBorderType Border type for filter functions.
ApliMaskSize Neighborhood area for filter functions.
Color Channel Buffers
Image library function definitions use the following color channel buffer types.
C1 Single-channel color
C2 Two-channel color
C3 Three-channel color
C4 Four-channel color
AC4 Three-channel color with an additional alpha (transparency) channel
A channel is a pixel-ordered grayscale representation of a single color. The RGB color model uses three channels, one each for red,
green, and blue color data. RGBA adds a fourth channel for transparency.
Image processing functions generally show source and destination buffers in a combined pair, such as C4P4. Use of a single buffer
type indicates that the source and destination buffers are of the same type or that a function writes data back to the source location.
Color Plane Buffers
Image library functions use the following color plane buffer types.
P1 Single-plane color
P3 Three-plane color
P4 Four-plane color
AMD Performance Library User’s Manual 143 Image Processing Library

Publication # 40535 February 2007
Planes map color spaces. A color space is defined by a color model and a gamut, or range of colors. Many color spaces can be
represented by three planes (XYZ coordinated), but there are spaces of greater and lesser dimensions. A single-plane color can be
viewed as a slice through a larger color space.
Functions generally show source and destination buffers in a combined pair, such as P4C4. Use of a single buffer type indicates either
that the source and destination buffers are of the same type, or that the function writes data back to the source buffer.
Regions of Interest
Many image library functions use the concept of a Region of Interest (ROI). A programmer can choose to manipulate specific regions of
an image buffer rather than an entire image. The following figure shows an ROI for a typical in-place (same source and destination)
operation.
The outer rectangle represents an image buffer. The inner grey rectangle represents the ROI inside the buffer.
Four pieces of information define the ROI:
1. A pointer to the starting pixel of the ROI (pSrcDstStep)
2. The number of bytes from starting pixel of ROI to the end of that image row (srcDstStep)
3. Then number of pixels in one row of the ROI (roiSize.width)
4. The number of pixels in one column of the ROI (roiSize.height)
ROIs for operations that use separate source and destination buffers are defined in the same way.
Image Masking
Some image library functions work with image masks. In an iterative operation that involves image buffers, it may be necessary to
skip operating on certain portions of the ROI. This is accomplished by using a mask of the same size as the ROI. When a mask is used,
the function writes a result to a destination pixel only when the corresponding pixel value in the mask is non-zero. The function does
not write a result to a destination pixel when the corresponding pixel value in the mask is zero.
AMD Performance Library User’s Manual 144 Image Processing Library

Publication # 40535 February 2007
Borders in Image Functions
Many of the APL image functions require a source image to have a defined border area. This is because the functions use neighboring
values to calculate a destination value.
For example, the FilterSharpen function always uses a 3X3 kernel mask with the anchor in the center, location (1,1) in zero-based
coordinates, relative to the top left corner of the mask. This means that the source image must have a complete one-pixel border on
both sides, top and bottom.
Consider a Filter32f function with variable-size mask and anchor:
Let the source image be 19 X 17 pixels.
Let the mask size be 4 X 5 pixels.
Let the anchor coordinates be (2,1) relative to the top left corner.
The maximum ROI size that can be safely used with the source image is 16 X 13 pixels, and the minimum destination image
size is 16 X 13.
The following diagram illustrates these concepts. It shows a source image with borders, a destination image, and a kernel mask with
an anchor point.
AMD Performance Library User’s Manual 145 Image Processing Library

Publication # 40535 February 2007
Anchor
Mask
Source Data
Border
Destination Data
Most functions that operate on borders assume the image buffer pointer initially points to the first pixel of the non-border area. In
other words, the functions assume that locations in memory before the initial pointer location contain border data.
Assume that:
Wsrc and Hsrc are the width and height of the source image in pixels.
Wmask and Hmask are the width and height of the mask in pixels.
Xanchor and Yanchor are the zero-based coordinates of the anchor point, relative to the top left corner of the mask.
Channels is the number of channels in the image (in non-planar format).
ElementSize is the size of a single value in the source image, for example, four (bytes) for single precision floating point.
AMD Performance Library User’s Manual 146 Image Processing Library

Publication # 40535 February 2007
The following formulas calculate the offset from the top left corner of the image to the top left corner of the non-border area of the
image
Where:
Offset = StepSizesrcX Yanchor + Xanchor X Channels X ElementSize
StepSizesrc = Wsrc X Channels X ElementSize
Maximum ROI size is:
WROI = Wsrc - Wmask + 1
HROI = Hsrc - Hmask + 1
The destination image size is at least the size of the ROI.
Some APL functions assume that the anchor coordinates are relative to the bottom right corner of the mask.In this case, the formulas
must be modified accordingly.
It is possible to have a source image with a much larger StepSizesrc value than specified in the formula.This typically occurs when
using an APL function to process a small part of a source image. In this case, the Offset value can also be much larger, pointing
somewhere in the middle of the source image data buffer. The developer must make sure there is a safe border area around the image
that the function can safely read and, in some cases, modify.
AMD Performance Library User’s Manual 147 Image Processing Library

Publication # 40535 February 2007
Parameter Glossary
Image library function definitions use the following parameters.
Al Progressive JPEG successive approximation parameter for actual point transform.
EdgePelCount Specifies the minimum number of pairs of elements that differ by more than EdgePelDifference.
EdgePelDifference Specifies the edge difference threshold between neighboring elements.
Se Progressive JPEG spectral selection end index.
Ss Progressive JPEG spectral selection start index.
alpha Alpha (RGBA transparency) constant value.
anchor A pixel locating the kernel (mask) according to source image.
angle Specifies the rotation angle in degrees, counterclockwise.
aplCmpOp
Specifies a comparison operation to be performed (aplCmpLess, aplCmpGreater, aplCmpLessEq, aplCmpEq, or
aplCmpGreaterEq).
axis An enumeration describing the type of gradiation in ImageRamp functions.
bFlushState Indicator for last 8X8 block in a scan.
border The set of source image boundary pixels.
borderType Specifies a boundary type.
borderValue A constant value assigned to the pixels in a constant border (not used by any other border type).
borderValue[3] A three-channel constant value assigned to the pixels in a constant border (not used by any other border type).
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
coeffs[2][3] Coefficients for Warp Affine transform.
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
const Constant value.
divisor An integer value by which the result is divided.
dst1Step Destination buffer one step size (width of the buffer in bytes).
dst2Step Destination buffer two step size (width of the buffer in bytes).
dstDiffStep Destination block step size (width of the block in bytes).
dstLenBytes Destination buffer length in bytes.
dstOrder[3]
Specifies destination buffer channel order. For example, dstOrder[1]= 0 indicates that source channel 0 is destination
channel 1.
dstPredictorStep Destination predictor block step size (width of the block in bytes).
dstQuad[4][2] Destination quadrangle vertex coordinates.
dstRoi Destination image ROI.
AMD Performance Library User’s Manual 148 Image Processing Library

Publication # 40535 February 2007
dstRoiSize Destination image ROI size.
dstSize Destination image size.
dstStep Destination buffer step size (width of the buffer in bytes).
dstStep[3] Destination three-channel planar buffer step size (array values define width of each plane in bytes).
eps Tolerance value.
flip Image mirror flip mode.
heightPixels Height of image (number of pixels in one column of image).
hint Suggests a level of precision using one of the following values (aplAlgHintNone, aplAlgHintFast, aplAlgHintAccurate).
imgSize Specifies the dimensions of an entire image.
interpolation Specifies the method of interpolation.
kernelSize Size of the kernel used in the calculations.
mask An analysis window (only non-zero mask array values are processed).
maskSize Size of the mask used in the calculations.
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
mcType Specifies the type of prediction used for motion compensation.
mcTypeB Specifies the type of prediction used for backward frame motion compensation.
mcTypeF Specifies the type of prediction used for forward frame motion compensation.
nChannel Number of channels in the image.
offset A floating-point value describing the starting value for ImageRamp functions.
pAcStatistics[256] Pointer to Huffman symbol statistics for AC coefficient.
pAcTable Pointer to the Huffman AC coefficient table.
pBuffer Pointer to the location of a temporary buffer.
pBufferSize Pointer to the size of a temporary buffer.
pDcStatistics[256] Pointer to Huffman symbol statistics for DC coefficient.
pDcTable Pointer to the Huffman DC coefficient table.
pDecHuffSpec Pointer to the ApliDecodeHuffmanSpec structure.
pDecHuffState Pointer to the ApliDecodeHuffmanState structure.
pDiff Pointer to an array of size 16 that contains the sums of 4X4 difference block coefficients.
pDst Pointer to a location in a destination buffer.
pDst1 Pointer to a location in destination buffer one.
pDst2 Pointer to a location in destination buffer two.
pDstBGR Pointer to destination image ROI for BGR image format.
pDstBitsLen Pointer to destination buffer length in bits.
pDstCMYK Pointer to destination image ROI for CMYK image format.
AMD Performance Library User’s Manual 149 Image Processing Library

Publication # 40535 February 2007
pDstCMYK[4] Pointer to destination image ROI for CMYK image format (four-channel planar).
pDstCurrPos Pointer to the shift value at the current destination buffer in bytes.
pDstDiff Pointer to a block of size 16X16 in the destination plane which contains difference between the current and reference blocks.
pDstMCU[3] Array of pointers to destination MCU image blocks.
pDstMCU[4] Array of pointers to destination MCU image blocks.
pDstPredictor Pointer to a destination predictor block.
pDstRGB Pointer to destination image ROI for RGB image format.
pDstRGB[3] Pointer to destination image ROI for RGB image format (three-channel planar).
pDstSAD Pointer to a destination array of size 4 that stores SAD values.
pDstY Pointer to destination image ROI for grayscale image format.
pDstYCCK[4] Pointer to destination image ROI for YCCK image format (four-channel planar).
pDstYCbCr[3] Pointer to destination image ROI for YCbCr image format (three-channel planar).
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pEncHuffSpec Pointer to the ApliEncodeHuffmanSpec structure.
pEncHuffState Pointer to the ApliEncodeHuffmanState structure.
pKernel Pointer to the kernel array.
pLastDC Pointer to the last DC coefficient, which is in the previous 8X8 block.
pListBits Pointer to the Bits list.
pListVals Pointer to the Vals list.
pMarker Pointer to the JPEG marker position.
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pMean Pointer to a computed mean of pixel values.
pNumValidPrefetchedBits Pointer to the value of valid bits in the prefetch buffer.
pPred Pointer to a 16x16 predictor block in the reference plane.
pPrefetchedBits Pointer to the prefetch buffer, which contains decoded data from the previous block.
pQuantFwdTable Pointer to the forward quantization table (encoder).
pQuantInvTable Pointer to the inverse quantization table (decoder).
pQuantRawTable Pointer to the raw quantization table.
pRef Pointer to a prefetch buffer which contains previously decoded bits.
pRefB Pointer to a backward reference block of specified size.
pRefF Pointer to a forward reference block of specified size.
pRes Pointer to a result value.
pSAD Pointer to an SAD result.
AMD Performance Library User’s Manual 150 Image Processing Library

Publication # 40535 February 2007
pSize Pointer to the size of an internal structure.
pSqrDiff Pointer to a sum of square differences of all the elements in the current and reference blocks.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcBGR Pointer to source image ROI for BGR image format.
pSrcBitsLen Pointer to the source buffer length in bits.
pSrcCMYK Pointer to source image ROI for CMYK image format.
pSrcCMYK[4] Pointer to source image ROI for CMYK image format (four-channel planar).
pSrcCur Pointer to a block in the current plane.
pSrcCurrPos Pointer to the shift value at the current source buffer in bytes.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
pSrcMCU[3] Array of pointers to source MCU image blocks.
pSrcMCU[4] Array of pointers to source MCU image blocks.
pSrcRGB Pointer to source image ROI for RGB image format.
pSrcRGB[3] Pointer to source image ROI for RGB image format (three-channel planar).
pSrcRef Pointer to a block in the reference plane.
pSrcRefB Pointer to a backward block in the reference plane.
pSrcRefF Pointer to a forward block in the reference plane.
pSrcSum Pointer to a sum of pixel values for the current block.
pSrcYCCK[4] Pointer to source image ROI for YCCK image format (four-channel planar).
pSrcYCbCr[3] Pointer to source image ROI for YCbCr image format (three-channel planar).
pSrcYData Pointer to a block of inverse DCT output data.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
pState Pointer to the morphology state structure.
pStatistics[256] Pointer to Huffman symbol statistics.
pStepBytes Pointer to the step size specified in bytes.
pSums Pointer to an array of size 256 that contains a sequence of 4X4 residual blocks.
pVar Pointer to a variance value.
ppDst Double pointer to the destination image ROI.
ppState Double pointer to the morphology state structure.
predStep Reference plane step size (in bytes).
ptr Pointer to buffer.
AMD Performance Library User’s Manual 151 Image Processing Library

Publication # 40535 February 2007
pxMap Pointer to X axis mapping table array.
pyMap Pointer to Y axis mapping table array.
quad[4][2] Quadrangle vertex coordinates.
qualityFactor JPEG image quality factor between 1 and 100.
refStep Reference block step size (width of the block in bytes).
refStepB Backward reference frame reference block step size (width of the block in bytes).
refStepF Forward reference frame reference block step size (width of the block in bytes).
roiSize Specifies the height and width of an ROI.
roiWidth Width of ROI image in pixels.
roundControl Specifies the type of rounding used for half-pixel approximation.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
slope A floating-point value describing the amount of gradiation in ImageRamp functions.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcCurStep Source current block step size (width of the block in bytes)
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcLenBytes Source buffer length in bytes.
srcQuad[4][2] Source quadrangle vertex coordinates.
srcRefStep Source reference block step size (width of the block in bytes)
srcRefStepB Source backward reference block step size (width of the block in bytes)
srcRefStepF Source forward reference block step size (width of the block in bytes)
srcRoi Source image ROI.
srcSize Source image size.
srcSize1 Specifies the size of source image one.
srcSize2 Specifies the size of source image two.
srcStep Source buffer step size (width of the buffer in bytes).
srcStep1 Source image one step size (width of the buffer in bytes).
srcStep2 Source image two step size (width of the buffer in bytes).
srcStepB Source aligned backward reference frame step size (width in bytes).
srcStepF Source aligned forward reference frame step size (width in bytes).
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
srcWidth Width of the source row in pixels.
srcYDataStep Source aligned DCT output data block step size (width of the block in bytes).
threshold Threshold for each pixel.
AMD Performance Library User’s Manual 152 Image Processing Library

Publication # 40535 February 2007
thresholdGT Three-channel threshold for each pixel in greater-than operation.
thresholdGT[3] Three-channel threshold for each pixel in greater-than operation.
thresholdLT Threshold for each pixel in less-than operation.
thresholdLT[3] Three-channel threshold for each pixel in less-than operation.
threshold[3] Three-channel threshold for each pixel.
threshold[4] Four-channel threshold for each pixel.
vMax Maximum value.
vMin Minimum value.
value Specified value.
valueGT Threshold for each pixel in greater-than operation.
valueGT[3] Three-channel threshold for each pixel in greater-than operation.
valueLT Threshold for each pixel in less-than operation.
valueLT[3] Three-channel threshold for each pixel in less-than operation.
value[3] An array of three specified values.
value[4] An array of four specified values.
widthPixels Width of image (number of pixels in one row of image).
xAnchor Anchor cell that specifies the horizontal alignment of the kernel with respect to the input pixel.
xCenter X coordinate of center.
xFactor Factor value for X axis direction.
xFr Inverse factor value for X axis direction.
xMapStep X axis mapping table step size (width of the buffer in bytes).
xShear Shear value for X axis in Shear transformation.
xShift Shift value for X axis direction.
yAnchor Anchor cell that specifies the vertical alignment of the kernel with respect to the input pixel.
yCenter Y coordinate of center.
yFactor Factor value for Y axis direction .
yFr Inverse factor value for Y axis direction .
yMapStep Y axis mapping table step size (width of the buffer in bytes).
yShear Shear value for Y axis in Shear transformation.
yShift Shift value for Y axis direction.
AMD Performance Library User’s Manual 153 Image Processing Library

Publication # 40535 February 2007
Library Version
This chapter describes the APL function that provides library version information.
GetLibVersion
Get library version
Synopsis
const AplLibraryVersion* apliGetLibVersion ( );
const AplLibraryVersion* apljGetLibVersion ( );
const AplLibraryVersion* aplcvGetLibVersion ( );
const AplLibraryVersion* aplvcGetLibVersion ( );
const AplLibraryVersion* aplccGetLibVersion ( );
Description
This function returns a pointer to the AplLibraryVersion structure that contains APL Library version information.
AMD Performance Library User’s Manual 154 Image Processing Library

Publication # 40535 February 2007
Support Functions
This chapters describes APL functions that support other APL functions.
AMD Performance Library User’s Manual 155 Image Processing Library

Publication # 40535 February 2007
Malloc
Memory allocation
Synopsis
Apl8u* apliMalloc_8u_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl8u* apliMalloc_8u_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl8u* apliMalloc_8u_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl8u* apliMalloc_8u_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl8u* apliMalloc_8u_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16u* apliMalloc_16u_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16u* apliMalloc_16u_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16u* apliMalloc_16u_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16u* apliMalloc_16u_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16u* apliMalloc_16u_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16s* apliMalloc_16s_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16s* apliMalloc_16s_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16s* apliMalloc_16s_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16s* apliMalloc_16s_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl16s* apliMalloc_16s_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32s* apliMalloc_32s_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32s* apliMalloc_32s_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32s* apliMalloc_32s_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32s* apliMalloc_32s_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32s* apliMalloc_32s_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32f* apliMalloc_32f_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32f* apliMalloc_32f_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32f* apliMalloc_32f_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32f* apliMalloc_32f_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32f* apliMalloc_32f_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32sc* apliMalloc_32sc_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32sc* apliMalloc_32sc_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32sc* apliMalloc_32sc_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32sc* apliMalloc_32sc_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32sc* apliMalloc_32sc_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32fc* apliMalloc_32fc_C1 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32fc* apliMalloc_32fc_C2 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32fc* apliMalloc_32fc_C3 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32fc* apliMalloc_32fc_C4 ( int widthPixels , int heightPixels , int* pStepBytes );
Apl32fc* apliMalloc_32fc_AC4 ( int widthPixels , int heightPixels , int* pStepBytes );
AMD Performance Library User’s Manual 156 Image Processing Library

Publication # 40535 February 2007
Parameters
heightPixels Height of image (number of pixels in one column of image).
pStepBytes Pointer to the step size specified in bytes.
widthPixels Width of image (number of pixels in one row of image).
Description
These functions allocate memory for image processing. Every row is aligned to 32-bit boundaries. Zero-padding is used to force
alignment.
AMD Performance Library User’s Manual 157 Image Processing Library

Publication # 40535 February 2007
Free
Free allocated memory
Synopsis
void STDCALL apliFree ( void* ptr );
Parameters
ptr Pointer to buffer.
Description
These functions free memory allocated by the Malloc( ) functions.
AMD Performance Library User’s Manual 158 Image Processing Library

Publication # 40535 February 2007
Image Data Exchange and Initialization Functions
This chapter describes functions that set the initial value of an image data buffer, copy data from one buffer to another, convert data
type, and scale image data.
AMD Performance Library User’s Manual 159 Image Processing Library

Publication # 40535 February 2007
Convert
Convert data from one type to another
Synopsis
AplStatus apliConvert_8u16u_C1R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16u_C3R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16u_C4R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16u_AC4R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16s_C3R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16s_C4R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u16s_AC4R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32s_C1R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32s_C3R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32s_C4R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32s_AC4R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32s_C1R ( const Apl8s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32s_C3R ( const Apl8s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32s_C4R ( const Apl8s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32s_AC4R ( const Apl8s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32s_C1R ( const Apl16u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32s_C3R ( const Apl16u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32s_C4R ( const Apl16u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32s_AC4R ( const Apl16u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32f_C1R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32f_C3R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32f_C4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8u32f_AC4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32f_C1R ( const Apl8s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32f_C3R ( const Apl8s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32f_C4R ( const Apl8s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_8s32f_AC4R ( const Apl8s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32f_C1R ( const Apl16u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32f_C3R ( const Apl16u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32f_C4R ( const Apl16u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u32f_AC4R ( const Apl16u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s32f_C1R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s32f_C3R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s32f_C4R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s32f_AC4R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u8u_C1R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u8u_C3R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16u8u_C4R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 160 Image Processing Library

Publication # 40535 February 2007
AplStatus apliConvert_16u8u_AC4R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s8u_C1R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s8u_C3R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s8u_C4R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_16s8u_AC4R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8u_C1R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8u_C3R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8u_C4R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8u_AC4R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8s_C1R ( const Apl32s * pSrc , int srcStep , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8s_C3R ( const Apl32s * pSrc , int srcStep , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8s_C4R ( const Apl32s * pSrc , int srcStep , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliConvert_32s8s_AC4R ( const Apl32s * pSrc , int srcStep , Apl8s * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data to another data type, and write the converted data to
a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 161 Image Processing Library

Publication # 40535 February 2007
Copy
Copy values from one buffer to another
Synopsis
AplStatus apliCopy_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C3AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_AC4C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C1MR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_8u_C3MR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_8u_C4MR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_8u_AC4MR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_8u_C3CR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C4CR ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C3C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C4C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C1C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C1C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C3P3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_C4P4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_P3C3R ( const Apl8u * const pSrc[3] , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_8u_P4C4R ( const Apl8u * const pSrc[4] , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C3AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_AC4C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C1MR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_16s_C3MR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_16s_C4MR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_16s_AC4MR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask ,
int maskStep );
AMD Performance Library User’s Manual 162 Image Processing Library

Publication # 40535 February 2007
AplStatus apliCopy_16s_C3CR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C4CR ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C3C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C4C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C1C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C1C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C3P3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_C4P4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_P3C3R ( const Apl16s * const pSrc[3] , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_16s_P4C4R ( const Apl16s * const pSrc[4] , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_AC4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C3AC4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_AC4C3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C1MR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32s_C3MR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32s_C4MR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32s_AC4MR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask ,
int maskStep );
AplStatus apliCopy_32s_C3CR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C4CR ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C3C1R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C4C1R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C1C3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C1C4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C3P3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_C4P4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_P3C3R ( const Apl32s * const pSrc[3] , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32s_P4C4R ( const Apl32s * const pSrc[4] , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C3AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_AC4C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C1MR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32f_C3MR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AMD Performance Library User’s Manual 163 Image Processing Library

Publication # 40535 February 2007
AplStatus apliCopy_32f_C4MR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32f_AC4MR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int
maskStep );
AplStatus apliCopy_32f_C3CR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C4CR ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C3C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C4C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C1C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C1C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C3P3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_C4P4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_P3C3R ( const Apl32f * const pSrc[3] , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliCopy_32f_P4C4R ( const Apl32f * const pSrc[4] , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and copy the source data to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 164 Image Processing Library

Publication # 40535 February 2007
Swap
Change channel order
Synopsis
AplStatus apliSwapChannels_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const int dstOrder[3]
);
AplStatus apliSwapChannels_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_16u_C3R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_16u_AC4R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_32s_C3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_32s_AC4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const int
dstOrder[3] );
AplStatus apliSwapChannels_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const int dstOrder[3] );
Parameters
dstOrder[3] Specifies destination buffer channel order. For example, dstOrder[1]= 0 indicates that source channel 0 is destination channel 1.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, swap the source buffer channels as specified by the destination order, and
write the channel data to the destination buffer. For example,dstOrder[1]= 0 => channel 0 in source buffer should be put into channel
1 of destination buffer.
AMD Performance Library User’s Manual 165 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsChannelOrderErr The given destination order is not valid (contains values other than 0,1,2).
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 166 Image Processing Library

Publication # 40535 February 2007
Set
Set buffer to a value
Synopsis
AplStatus apliSet_8u_C1R ( Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_8u_C3R ( const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_8u_AC4R ( const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_8u_C4R ( const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_8u_C1MR ( Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_8u_C3MR ( const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_8u_AC4MR ( const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_8u_C4MR ( const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_8u_C3CR ( Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_8u_C4CR ( Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_C1R ( Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_C3R ( const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_AC4R ( const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_C4R ( const Apl16s value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_C1MR ( Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_16s_C3MR ( const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_16s_AC4MR ( const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep
);
AplStatus apliSet_16s_C4MR ( const Apl16s value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_16s_C3CR ( Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_16s_C4CR ( Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_C1R ( Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_C3R ( const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_AC4R ( const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_C4R ( const Apl32s value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_C1MR ( Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32s_C3MR ( const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32s_AC4MR ( const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep
);
AplStatus apliSet_32s_C4MR ( const Apl32s value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32s_C3CR ( Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32s_C4CR ( Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_C1R ( Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_C3R ( const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_AC4R ( const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_C4R ( const Apl32f value[4] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_C1MR ( Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32f_C3MR ( const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AMD Performance Library User’s Manual 167 Image Processing Library

Publication # 40535 February 2007
AplStatus apliSet_32f_AC4MR ( const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32f_C4MR ( const Apl32f value[4] , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl8u * pMask , int maskStep );
AplStatus apliSet_32f_C3CR ( Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSet_32f_C4CR ( Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
roiSize Specifies the height and width of an ROI.
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions write a specified value to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 168 Image Processing Library

Publication # 40535 February 2007
Scale
Scale buffer data
Synopsis
AplStatus apliScale_8u16u_C1R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16u_C3R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16u_C4R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16u_AC4R ( const Apl8u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16s_C3R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16s_C4R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u16s_AC4R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u32s_C1R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u32s_C3R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u32s_C4R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u32s_AC4R ( const Apl8u * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliScale_8u32f_C1R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
);
AplStatus apliScale_8u32f_C3R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
);
AplStatus apliScale_8u32f_C4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
);
AplStatus apliScale_8u32f_AC4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f
vMax );
AplStatus apliScale_16u8u_C1R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16u8u_C3R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16u8u_C4R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16u8u_AC4R ( const Apl16u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint
);
AplStatus apliScale_16s8u_C1R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16s8u_C3R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16s8u_C4R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_16s8u_AC4R ( const Apl16s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_32s8u_C1R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_32s8u_C3R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_32s8u_C4R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_32s8u_AC4R ( const Apl32s * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , AplHintAlgorithm hint );
AplStatus apliScale_32f8u_C1R ( const Apl32f * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
);
AplStatus apliScale_32f8u_C3R ( const Apl32f * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
);
AplStatus apliScale_32f8u_C4R ( const Apl32f * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f vMax
AMD Performance Library User’s Manual 169 Image Processing Library

Publication # 40535 February 2007
);
AplStatus apliScale_32f8u_AC4R ( const Apl32f * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl32f vMin , Apl32f
vMax );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
hint Suggests a level of precision using one of the following values (aplAlgHintNone, aplAlgHintFast, aplAlgHintAccurate).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
vMax Maximum value.
vMin Minimum value.
Description
These functions step through an ROI in a source buffer, scale the source data, and write the scaled data to a destination buffer. The
output is scaled so that the median value in the source range is the median value in the destination range.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 170 Image Processing Library

Publication # 40535 February 2007
Arithmetic and Logic Functions
This chapter describes general-purpose mathematic functions and functions that perform specific mathematic operations related to
image processing.
AMD Performance Library User’s Manual 171 Image Processing Library

Publication # 40535 February 2007
Abs
Get absolute value
Synopsis
AplStatus apliAbs_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAbs_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_16s_C4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAbs_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and calculate the absolute value of the source data. The results can be written
to a destination buffer, or back to the source buffer.
AMD Performance Library User’s Manual 172 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 173 Image Processing Library

Publication # 40535 February 2007
AbsDiff
Absolute difference of two source values
Synopsis
AplStatus apliAbsDiff_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAbsDiff_16u_C1R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAbsDiff_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep ,
ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers, calculate the absolute value of the difference between the data in source
buffer 1 and the data in source buffer 2, and write the results to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 174 Image Processing Library

Publication # 40535 February 2007
AbsDiffC
Absolute difference of a source value and a constant
Synopsis
AplStatus apliAbsDiffC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int value );
AplStatus apliAbsDiffC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int value );
AplStatus apliAbsDiffC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f value );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
Description
These functions step through an ROI in a source buffer, calculate the absolute value of the difference between the source data and a
specified constant, and write the result to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 175 Image Processing Library

Publication # 40535 February 2007
Add
Add
Synopsis
AplStatus apliAdd_8u_C1IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_8u_C3IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_8u_C4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_8u_AC4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_8u_C1RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAdd_8u_C3RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAdd_8u_C4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAdd_8u_AC4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C1IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C3IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_AC4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C1RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C3RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_C4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16s_AC4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16sc_C1IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAdd_16sc_C3IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAdd_16sc_AC4IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAdd_16sc_C1RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16sc_C3RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_16sc_AC4RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_32sc_C1IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AMD Performance Library User’s Manual 176 Image Processing Library

Publication # 40535 February 2007
AplStatus apliAdd_32sc_C3IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAdd_32sc_AC4IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAdd_32sc_C1RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_32sc_C3RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_32sc_AC4RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliAdd_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32f_C3IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32f_C4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32f_AC4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAdd_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAdd_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAdd_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAdd_32fc_C1IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32fc_C3IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32fc_AC4IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32fc_C1R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAdd_32fc_C3R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAdd_32fc_AC4R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAdd_8u32f_C1IR ( const Apl8u * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_8s32f_C1IR ( const Apl8s * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_16u32f_C1IR ( const Apl16u * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAdd_8u32f_C1IMR ( const Apl8u * pSrc , int srcStep , const Apl8u * pMask , int maskStep , Apl32f * pSrcDst , int srcDstStep ,
ApliSize roiSize );
AplStatus apliAdd_8s32f_C1IMR ( const Apl8s * pSrc , int srcStep , const Apl8u * pMask , int maskStep , Apl32f * pSrcDst , int srcDstStep ,
ApliSize roiSize );
AplStatus apliAdd_16u32f_C1IMR ( const Apl16u * pSrc , int srcStep , const Apl8u * pMask , int maskStep , Apl32f * pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAdd_32f_C1IMR ( const Apl32f * pSrc , int srcStep , const Apl8u * pMask , int maskStep , Apl32f * pSrcDst , int srcDstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 177 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and add the data in buffer 2 to the data in buffer 1. The sum can be written
back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit signed
complex versions of the functions perform an integer scaling operation before writing the results. Other versions add signed and
unsigned integers and write 32-bit floating point results; variations of these functions can also perform a masking operation before
writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 178 Image Processing Library

Publication # 40535 February 2007
AddC
Add constant
Synopsis
AplStatus apliAddC_8u_C1IRSfs ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_8u_C3IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_8u_AC4IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_8u_C4IRSfs ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliAddC_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliAddC_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliAddC_8u_C4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliAddC_16s_C1IRSfs ( Apl16s value , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16s_C3IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16s_AC4IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16s_C4IRSfs ( const Apl16s value[4] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliAddC_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliAddC_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliAddC_16s_C4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliAddC_16sc_C1IRSfs ( Apl16sc value , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16sc_C3IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16sc_AC4IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_16sc_C1RSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc value , Apl16sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliAddC_16sc_C3RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAddC_16sc_AC4RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAddC_32sc_C1IRSfs ( Apl32sc value , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_32sc_C3IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_32sc_AC4IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliAddC_32sc_C1RSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc value , Apl32sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AMD Performance Library User’s Manual 179 Image Processing Library

Publication # 40535 February 2007
AplStatus apliAddC_32sc_C3RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAddC_32sc_AC4RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliAddC_32f_C1IR ( Apl32f value , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32f_C3IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32f_AC4IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32f_C4IR ( const Apl32f value[4] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32f_C4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[4] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_C1IR ( Apl32fc value , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_C3IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_AC4IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_C1R ( const Apl32fc * pSrc , int srcStep , Apl32fc value , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_C3R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAddC_32fc_AC4R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and add a specified constant value to the source data. The sum can be written
back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit signed
complex versions of the functions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 180 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 181 Image Processing Library

Publication # 40535 February 2007
AddProduct
Add product
Synopsis
AplStatus apliAddProduct_8u32f_C1IR ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl32f * pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_8s32f_C1IR ( const Apl8s * pSrc1 , int src1Step , const Apl8s * pSrc2 , int src2Step , Apl32f * pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_16u32f_C1IR ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl32f * pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_32f_C1IR ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_8u32f_C1IMR ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , const Apl8u* pMask ,
int maskStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_8s32f_C1IMR ( const Apl8s * pSrc1 , int src1Step , const Apl8s * pSrc2 , int src2Step , const Apl8u* pMask , int
maskStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_16u32f_C1IMR ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , const Apl8u* pMask
, int maskStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddProduct_32f_C1IMR ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , const Apl8u* pMask , int
maskStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
Parameters
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
Description
These functions step through ROIs in two source buffers, add the product of the data in buffer 1 and the data in buffer 2 to the data in
buffer 1, and write the sum back to the source location. There are versions of the functions that perform a masking operation before
writing the results.
AMD Performance Library User’s Manual 182 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 183 Image Processing Library

Publication # 40535 February 2007
AddSquare
Add square
Synopsis
AplStatus apliAddSquare_8u32f_C1IR ( const Apl8u * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_8s32f_C1IR ( const Apl8s * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_16u32f_C1IR ( const Apl16u * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_8u32f_C1IMR ( const Apl8u * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_8s32f_C1IMR ( const Apl8s * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_16u32f_C1IMR ( const Apl16u * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize );
AplStatus apliAddSquare_32f_C1IMR ( const Apl32f * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize );
Parameters
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers, add the square of the data in buffer 1 to the data in buffer 2, and write the
sum back to the source location. There are versions of the functions that perform a masking operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 184 Image Processing Library

Publication # 40535 February 2007
AddWeighted
Add weighted
Synopsis
AplStatus apliAddWeighted_8u32f_C1IR ( const Apl8u * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f
alpha );
AplStatus apliAddWeighted_8s32f_C1IR ( const Apl8s * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f alpha
);
AplStatus apliAddWeighted_16u32f_C1IR ( const Apl16u * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f
alpha );
AplStatus apliAddWeighted_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f* pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f alpha
);
AplStatus apliAddWeighted_8u32f_C1IMR ( const Apl8u * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize , Apl32f alpha );
AplStatus apliAddWeighted_8s32f_C1IMR ( const Apl8s * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize , Apl32f alpha );
AplStatus apliAddWeighted_16u32f_C1IMR ( const Apl16u * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize , Apl32f alpha );
AplStatus apliAddWeighted_32f_C1IMR ( const Apl32f * pSrc , int srcStep , const Apl8u* pMask , int maskStep , Apl32f* pSrcDst , int
srcDstStep , ApliSize roiSize , Apl32f alpha );
Parameters
alpha Alpha (RGBA transparency) constant value.
maskStep Mask buffer step size in bytes (width of the buffer in bytes).
pMask Pointer to a location in a buffer that contains a mask to be used in the operation.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers, multiply the data in buffer 1 by an alpha scaling factor, multiply the data in
buffer 2 by a scaling factor of 1 minus alpha, add the two products, and write the sum back to the source location. There are versions
of the functions that perform a masking operation before writing the results.
Return Values
aplStsNoErr No error detected.
AMD Performance Library User’s Manual 185 Image Processing Library

Publication # 40535 February 2007
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 186 Image Processing Library

Publication # 40535 February 2007
Div
Divide
Synopsis
AplStatus apliDiv_8u_C1IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_8u_C3IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_8u_C1RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDiv_8u_C3RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDiv_16s_C1IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16s_C3IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16s_C1RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16s_C3RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16sc_C1IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16sc_C3IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16sc_AC4IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliDiv_16sc_C1RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16sc_C3RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_16sc_AC4RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32sc_C1IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32sc_C3IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32sc_AC4IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliDiv_32sc_C1RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32sc_C3RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32sc_AC4RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliDiv_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32f_C3IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32f_C4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32f_AC4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AMD Performance Library User’s Manual 187 Image Processing Library

Publication # 40535 February 2007
AplStatus apliDiv_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliDiv_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliDiv_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliDiv_32fc_C1IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32fc_C3IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32fc_AC4IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDiv_32fc_C1R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliDiv_32fc_C3R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliDiv_32fc_AC4R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and divide the data in buffer 1 by the data in buffer 2. The quotient can be
written back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 188 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 189 Image Processing Library

Publication # 40535 February 2007
DivC
Divide by a constant
Synopsis
AplStatus apliDivC_8u_C1IRSfs ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_8u_C3IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_8u_AC4IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliDivC_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliDivC_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliDivC_16s_C1IRSfs ( Apl16s value , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16s_C3IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16s_AC4IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliDivC_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliDivC_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliDivC_16sc_C1IRSfs ( Apl16sc value , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16sc_C3IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16sc_AC4IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_16sc_C1RSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc value , Apl16sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliDivC_16sc_C3RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDivC_16sc_AC4RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDivC_32sc_C1IRSfs ( Apl32sc value , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_32sc_C3IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_32sc_AC4IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliDivC_32sc_C1RSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc value , Apl32sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliDivC_32sc_C3RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDivC_32sc_AC4RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliDivC_32f_C1IR ( Apl32f value , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDivC_32f_C3IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 190 Image Processing Library

Publication # 40535 February 2007
AplStatus apliDivC_32f_AC4IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDivC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliDivC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliDivC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_C1IR ( Apl32fc value , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_C3IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_AC4IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_C1R ( const Apl32fc * pSrc , int srcStep , Apl32fc value , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_C3R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliDivC_32fc_AC4R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
Description
These functions step through an ROI in a source buffer and divide the source data by a constant value. The quotient can be written
back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit signed
complex versions of the functions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 191 Image Processing Library

Publication # 40535 February 2007
Exp
Raise base e to a power
Synopsis
AplStatus apliExp_8u_C1IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_8u_C3IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_16s_C1IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_16s_C3IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliExp_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliExp_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliExp_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliExp_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and raise the base e to the power specified by the source data. Results can be
written back to the source location or to a destination buffer. The 8-bit unsigned and 16-bit signed versions of the functions perform
an integer scaling operation before writing the results. These functions are the inverses of the Ln functions.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 192 Image Processing Library

Publication # 40535 February 2007
Ln
Natural logarithm
Synopsis
AplStatus apliLn_8u_C1IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_8u_C3IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_16s_C1IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_16s_C3IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliLn_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLn_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLn_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLn_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and calculate the natural logarithms of the source data. Results can be written
back to the source location or to a destination buffer. The 8-bit unsigned and 16-bit signed versions of the functions perform an
integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 193 Image Processing Library

Publication # 40535 February 2007
Mul
Multiply
Synopsis
AplStatus apliMul_8u_C1IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_8u_C3IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_8u_C4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_8u_AC4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_8u_C1RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMul_8u_C3RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMul_8u_C4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMul_8u_AC4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C1IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C3IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_AC4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C1RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C3RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_C4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16s_AC4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16sc_C1IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMul_16sc_C3IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMul_16sc_AC4IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMul_16sc_C1RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16sc_C3RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_16sc_AC4RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliMul_32sc_C1IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AMD Performance Library User’s Manual 194 Image Processing Library

Publication # 40535 February 2007
AplStatus apliMul_32sc_C3IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMul_32sc_AC4IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMul_32sc_C1RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_32sc_C3RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliMul_32sc_AC4RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliMul_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32f_C3IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32f_C4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32f_AC4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliMul_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliMul_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliMul_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMul_32fc_C1IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32fc_C3IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32fc_AC4IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMul_32fc_C1R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMul_32fc_C3R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMul_32fc_AC4R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 195 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and multiply the data in buffer 1 by the data in buffer 2. The product can be
written back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 196 Image Processing Library

Publication # 40535 February 2007
MulC
Multiply by a constant
Synopsis
AplStatus apliMulC_8u_C1IRSfs ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_8u_C3IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_8u_AC4IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_8u_C4IRSfs ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliMulC_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliMulC_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliMulC_8u_C4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliMulC_16s_C1IRSfs ( Apl16s value , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16s_C3IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16s_AC4IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16s_C4IRSfs ( const Apl16s value[4] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliMulC_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliMulC_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliMulC_16s_C4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliMulC_16sc_C1IRSfs ( Apl16sc value , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16sc_C3IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16sc_AC4IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_16sc_C1RSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc value , Apl16sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliMulC_16sc_C3RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMulC_16sc_AC4RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMulC_32sc_C1IRSfs ( Apl32sc value , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_32sc_C3IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_32sc_AC4IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliMulC_32sc_C1RSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc value , Apl32sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AMD Performance Library User’s Manual 197 Image Processing Library

Publication # 40535 February 2007
AplStatus apliMulC_32sc_C3RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMulC_32sc_AC4RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliMulC_32f_C1IR ( Apl32f value , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32f_C3IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32f_AC4IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32f_C4IR ( const Apl32f value[4] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32f_C4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[4] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_C1IR ( Apl32fc value , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_C3IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_AC4IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_C1R ( const Apl32fc * pSrc , int srcStep , Apl32fc value , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_C3R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulC_32fc_AC4R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and multiply the source data by a specified constant value. The product can be
written back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 198 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 199 Image Processing Library

Publication # 40535 February 2007
MulScale
Multiply with scaling
Synopsis
AplStatus apliMulScale_8u_C1IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_8u_C3IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_8u_C4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_8u_AC4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_8u_C3R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_8u_C4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_8u_AC4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_16u_C1IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_16u_C3IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_16u_C4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_16u_AC4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulScale_16u_C1R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_16u_C3R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_16u_C4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliMulScale_16u_AC4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 200 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers, multiply the data in buffer 1 by the data in buffer 2, then divide the product
by a scaling factor equal to the upper bound of the range of values that can be represented by the source data type. Results can be
written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 201 Image Processing Library

Publication # 40535 February 2007
MulCScale
Multiply by constant with scaling
Synopsis
AplStatus apliMulCScale_8u_C1IR ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_C3IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_AC4IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_C4IR ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulCScale_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_C1IR ( Apl16u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_C3IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_AC4IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_C4IR ( const Apl16u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliMulCScale_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize
);
AplStatus apliMulCScale_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[4] , Apl16u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliMulCScale_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
AMD Performance Library User’s Manual 202 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, multiply the source data by a specified constant value, then divide the product
by a scaling factor equal to the upper bound of the range of values that can be represented by the source data type. Results can be
written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 203 Image Processing Library

Publication # 40535 February 2007
Sqr
Square
Synopsis
AplStatus apliSqr_8u_C1IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_C3IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_C4IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_AC4IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_C4RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C1IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C3IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C4IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_AC4IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C1RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C3RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_C4RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16u_AC4RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C1IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C3IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C4IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_AC4IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_C4RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqr_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqr_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqr_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqr_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqr_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSqr_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSqr_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 204 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and calculate the square of the source data. Results can be written back to the
source location or to a destination buffer. The 8-bit unsigned, 16-bit unsigned, and 16-bit signed versions of the functions perform an
integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 205 Image Processing Library

Publication # 40535 February 2007
Sqrt
Square root
Synopsis
AplStatus apliSqrt_8u_C1IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_8u_C3IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_8u_AC4IRSfs ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_C1IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_C3IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_AC4IRSfs ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_C1IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_C3IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_AC4IRSfs ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_C1RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_C3RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_16u_AC4RSfs ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSqrt_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSqrt_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 206 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer and calculate the square root of the source data. Results can be written back to
the source location or to a destination buffer. The 8-bit unsigned, 16-bit unsigned, and 16-bit signed versions of the functions perform
an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 207 Image Processing Library

Publication # 40535 February 2007
Sub
Subtract
Synopsis
AplStatus apliSub_8u_C1IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_8u_C3IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_8u_C4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_8u_AC4IRSfs ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_8u_C1RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSub_8u_C3RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSub_8u_C4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSub_8u_AC4RSfs ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C1IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C3IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_AC4IRSfs ( const Apl16s * pSrc , int srcStep , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C1RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C3RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_C4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16s_AC4RSfs ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl16s * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16sc_C1IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSub_16sc_C3IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSub_16sc_AC4IRSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSub_16sc_C1RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16sc_C3RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_16sc_AC4RSfs ( const Apl16sc * pSrc1 , int src1Step , const Apl16sc * pSrc2 , int src2Step , Apl16sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliSub_32sc_C1IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AMD Performance Library User’s Manual 208 Image Processing Library

Publication # 40535 February 2007
AplStatus apliSub_32sc_C3IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSub_32sc_AC4IRSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSub_32sc_C1RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_32sc_C3RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep ,
ApliSize roiSize , int scaleFactor );
AplStatus apliSub_32sc_AC4RSfs ( const Apl32sc * pSrc1 , int src1Step , const Apl32sc * pSrc2 , int src2Step , Apl32sc * pDst , int dstStep
, ApliSize roiSize , int scaleFactor );
AplStatus apliSub_32f_C1IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32f_C3IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32f_C4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32f_AC4IR ( const Apl32f * pSrc , int srcStep , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliSub_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliSub_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliSub_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl32f * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliSub_32fc_C1IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32fc_C3IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32fc_AC4IR ( const Apl32fc * pSrc , int srcStep , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSub_32fc_C1R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliSub_32fc_C3R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliSub_32fc_AC4R ( const Apl32fc * pSrc1 , int src1Step , const Apl32fc * pSrc2 , int src2Step , Apl32fc * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 209 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and subtract the data in buffer 1 from the data in buffer 2. The difference can
be written back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32-bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 210 Image Processing Library

Publication # 40535 February 2007
SubC
Subtract a constant value
Synopsis
AplStatus apliSubC_8u_C1IRSfs ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_8u_C3IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_8u_AC4IRSfs ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_8u_C4IRSfs ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_8u_C1RSfs ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , int scaleFactor
);
AplStatus apliSubC_8u_C3RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliSubC_8u_AC4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliSubC_8u_C4RSfs ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliSubC_16s_C1IRSfs ( Apl16s value , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16s_C3IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16s_AC4IRSfs ( const Apl16s value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16s_C4IRSfs ( const Apl16s value[4] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16s_C1RSfs ( const Apl16s * pSrc , int srcStep , Apl16s value , Apl16s * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliSubC_16s_C3RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliSubC_16s_AC4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliSubC_16s_C4RSfs ( const Apl16s * pSrc , int srcStep , const Apl16s value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize ,
int scaleFactor );
AplStatus apliSubC_16sc_C1IRSfs ( Apl16sc value , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16sc_C3IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16sc_AC4IRSfs ( const Apl16sc value[3] , Apl16sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_16sc_C1RSfs ( const Apl16sc * pSrc , int srcStep , Apl16sc value , Apl16sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AplStatus apliSubC_16sc_C3RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSubC_16sc_AC4RSfs ( const Apl16sc * pSrc , int srcStep , const Apl16sc value[3] , Apl16sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSubC_32sc_C1IRSfs ( Apl32sc value , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_32sc_C3IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_32sc_AC4IRSfs ( const Apl32sc value[3] , Apl32sc * pSrcDst , int srcDstStep , ApliSize roiSize , int scaleFactor );
AplStatus apliSubC_32sc_C1RSfs ( const Apl32sc * pSrc , int srcStep , Apl32sc value , Apl32sc * pDst , int dstStep , ApliSize roiSize , int
scaleFactor );
AMD Performance Library User’s Manual 211 Image Processing Library

Publication # 40535 February 2007
AplStatus apliSubC_32sc_C3RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSubC_32sc_AC4RSfs ( const Apl32sc * pSrc , int srcStep , const Apl32sc value[3] , Apl32sc * pDst , int dstStep , ApliSize
roiSize , int scaleFactor );
AplStatus apliSubC_32f_C1IR ( Apl32f value , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32f_C3IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32f_AC4IR ( const Apl32f value[3] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32f_C4IR ( const Apl32f value[4] , Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32f_C4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[4] , Apl32f * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_C1IR ( Apl32fc value , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_C3IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_AC4IR ( const Apl32fc value[3] , Apl32fc * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_C1R ( const Apl32fc * pSrc , int srcStep , Apl32fc value , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_C3R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize );
AplStatus apliSubC_32fc_AC4R ( const Apl32fc * pSrc , int srcStep , const Apl32fc value[3] , Apl32fc * pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
scaleFactor Specifies the integer scaling factor for the Sfs operation. The returned result is multiplied by 2^(-scaleFactor).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and subtract a specified constant value from the source data. The difference
can be written back to the source location or to a destination buffer. The 8-bit unsigned, 16-bit signed, 16-bit signed complex, and 32bit
signed complex versions of the functions perform an integer scaling operation before writing the results.
AMD Performance Library User’s Manual 212 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 213 Image Processing Library

Publication # 40535 February 2007
And
AND
Synopsis
AplStatus apliAnd_8u_C1IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_8u_C3IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_8u_C4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_8u_AC4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAnd_8u_C3R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAnd_8u_C4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAnd_8u_AC4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliAnd_16u_C1IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_16u_C3IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_16u_C4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_16u_AC4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_16u_C1R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_16u_C3R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_16u_C4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_16u_AC4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_32s_C1IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_32s_C3IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_32s_C4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_32s_AC4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAnd_32s_C1R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_32s_C3R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_32s_C4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliAnd_32s_AC4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 214 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and perform a bitwise logical AND of the data in buffer 1 and the data in
buffer 2. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 215 Image Processing Library

Publication # 40535 February 2007
AndC
AND with constant
Synopsis
AplStatus apliAndC_8u_C1IR ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_8u_C3IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_8u_AC4IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_8u_C4IR ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C1IR ( Apl16u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C3IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_16u_AC4IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C4IR ( const Apl16u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C1IR ( Apl32s value , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C3IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_32s_AC4IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C4IR ( const Apl32s value[4] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C3R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_32s_AC4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliAndC_32s_C4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 216 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and perform a bitwise logical AND of the source data and a specified constant.
The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 217 Image Processing Library

Publication # 40535 February 2007
Comp
Complement
Synopsis
AplStatus apliComplement_32s_C1IR ( Apl32s* pSrcDst , int srcDstStep , ApliSize roiSize );
Parameters
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
Description
This function steps through an ROI in a source buffer, performs a logical complementation of the source data, and writes the results
back to the source location.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 218 Image Processing Library

Publication # 40535 February 2007
Not
NOT
Synopsis
AplStatus apliNot_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliNot_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliNot_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliNot_8u_C4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliNot_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliNot_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliNot_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliNot_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and perform a bitwise negation of the source data. The results can be written
back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 219 Image Processing Library

Publication # 40535 February 2007
Or
OR
Synopsis
AplStatus apliOr_8u_C1IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_8u_C3IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_8u_C4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_8u_AC4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_8u_C3R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_8u_C4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_8u_AC4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_16u_C1IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_16u_C3IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_16u_C4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_16u_AC4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_16u_C1R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliOr_16u_C3R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliOr_16u_C4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliOr_16u_AC4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliOr_32s_C1IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_32s_C3IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_32s_C4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_32s_AC4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOr_32s_C1R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_32s_C3R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_32s_C4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliOr_32s_AC4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 220 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and perform a bitwise inclusive logical OR of the data in buffer 1 and the data
in buffer 2. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 221 Image Processing Library

Publication # 40535 February 2007
OrC
OR with constant
Synopsis
AplStatus apliOrC_8u_C1IR ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_8u_C3IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_8u_AC4IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_8u_C4IR ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C1IR ( Apl16u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C3IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_16u_AC4IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C4IR ( const Apl16u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C1IR ( Apl32s value , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C3IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_32s_AC4IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C4IR ( const Apl32s value[4] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C3R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_32s_AC4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliOrC_32s_C4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 222 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and perform a bitwise inclusive logical OR of the source data and a specified
constant. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 223 Image Processing Library

Publication # 40535 February 2007
LShiftC
Left shift by a constant value
Synopsis
AplStatus apliLShiftC_8u_C1IR ( Apl32u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_C3IR ( const Apl32u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_AC4IR ( const Apl32u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_C4IR ( const Apl32u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl32u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl32u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl32u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl32u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_C1IR ( Apl32u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_C3IR ( const Apl32u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_AC4IR ( const Apl32u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_C4IR ( const Apl32u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl32u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl32u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl32u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize
);
AplStatus apliLShiftC_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl32u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C1IR ( Apl32u value , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C3IR ( const Apl32u value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_AC4IR ( const Apl32u value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C4IR ( const Apl32u value[4] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32u value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C3R ( const Apl32s * pSrc , int srcStep , const Apl32u value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_AC4R ( const Apl32s * pSrc , int srcStep , const Apl32u value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliLShiftC_32s_C4R ( const Apl32s * pSrc , int srcStep , const Apl32u value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 224 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and shift the bits of the source data a specified number of bit positions to the
left. The results can be written back to the source location or to a destination buffer. Left-shifting is equivalent to multiplying by 2 to
the constant power.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 225 Image Processing Library

Publication # 40535 February 2007
RShiftC
Right shift by a constant value
Synopsis
AplStatus apliRShiftC_8u_C1IR ( Apl32u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_C3IR ( const Apl32u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_AC4IR ( const Apl32u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_C4IR ( const Apl32u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl32u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl32u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl32u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl32u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C1IR ( Apl32u value , Apl8s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C3IR ( const Apl32u value[3] , Apl8s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_AC4IR ( const Apl32u value[3] , Apl8s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C4IR ( const Apl32u value[4] , Apl8s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C1R ( const Apl8s * pSrc , int srcStep , Apl32u value , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C3R ( const Apl8s * pSrc , int srcStep , const Apl32u value[3] , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_AC4R ( const Apl8s * pSrc , int srcStep , const Apl32u value[3] , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_8s_C4R ( const Apl8s * pSrc , int srcStep , const Apl32u value[4] , Apl8s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_C1IR ( Apl32u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_C3IR ( const Apl32u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_AC4IR ( const Apl32u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_C4IR ( const Apl32u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl32u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl32u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl32u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize
);
AplStatus apliRShiftC_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl32u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_C1IR ( Apl32u value , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_C3IR ( const Apl32u value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_AC4IR ( const Apl32u value[3] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_C4IR ( const Apl32u value[4] , Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl32u value , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_C3R ( const Apl16s * pSrc , int srcStep , const Apl32u value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_16s_AC4R ( const Apl16s * pSrc , int srcStep , const Apl32u value[3] , Apl16s * pDst , int dstStep , ApliSize roiSize
);
AplStatus apliRShiftC_16s_C4R ( const Apl16s * pSrc , int srcStep , const Apl32u value[4] , Apl16s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_C1IR ( Apl32u value , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_C3IR ( const Apl32u value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_AC4IR ( const Apl32u value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_C4IR ( const Apl32u value[4] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 226 Image Processing Library

Publication # 40535 February 2007
AplStatus apliRShiftC_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32u value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_C3R ( const Apl32s * pSrc , int srcStep , const Apl32u value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRShiftC_32s_AC4R ( const Apl32s * pSrc , int srcStep , const Apl32u value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize
);
AplStatus apliRShiftC_32s_C4R ( const Apl32s * pSrc , int srcStep , const Apl32u value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and shift the bits of the source data a specified number of bit positions to the
right. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 227 Image Processing Library

Publication # 40535 February 2007
Xor
XOR
Synopsis
AplStatus apliXor_8u_C1IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_8u_C3IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_8u_C4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_8u_AC4IR ( const Apl8u * pSrc , int srcStep , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliXor_8u_C3R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliXor_8u_C4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliXor_8u_AC4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep , ApliSize
roiSize );
AplStatus apliXor_16u_C1IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_16u_C3IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_16u_C4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_16u_AC4IR ( const Apl16u * pSrc , int srcStep , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_16u_C1R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_16u_C3R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_16u_C4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_16u_AC4R ( const Apl16u * pSrc1 , int src1Step , const Apl16u * pSrc2 , int src2Step , Apl16u * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_32s_C1IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_32s_C3IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_32s_C4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_32s_AC4IR ( const Apl32s * pSrc , int srcStep , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXor_32s_C1R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_32s_C3R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_32s_C4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AplStatus apliXor_32s_AC4R ( const Apl32s * pSrc1 , int src1Step , const Apl32s * pSrc2 , int src2Step , Apl32s * pDst , int dstStep ,
ApliSize roiSize );
AMD Performance Library User’s Manual 228 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through ROIs in two source buffers and perform a bitwise exclusive logical OR (XOR) of the data in buffer 1 and
the data in buffer 2. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 229 Image Processing Library

Publication # 40535 February 2007
XorC
XOR with constant
Synopsis
AplStatus apliXorC_8u_C1IR ( Apl8u value , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_8u_C3IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_8u_AC4IR ( const Apl8u value[3] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_8u_C4IR ( const Apl8u value[4] , Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C1IR ( Apl16u value , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C3IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_16u_AC4IR ( const Apl16u value[3] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C4IR ( const Apl16u value[4] , Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u value , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C3R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_16u_AC4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[3] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_16u_C4R ( const Apl16u * pSrc , int srcStep , const Apl16u value[4] , Apl16u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C1IR ( Apl32s value , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C3IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_32s_AC4IR ( const Apl32s value[3] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C4IR ( const Apl32s value[4] , Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32s value , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C3R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_32s_AC4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[3] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AplStatus apliXorC_32s_C4R ( const Apl32s * pSrc , int srcStep , const Apl32s value[4] , Apl32s * pDst , int dstStep , ApliSize roiSize );
AMD Performance Library User’s Manual 230 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and perform a bitwise exclusive logical OR (XOR) of the source data and a
specified constant. The results can be written back to the source location or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 231 Image Processing Library

Publication # 40535 February 2007
Color Model Conversion Functions
This chapter describes functions that convert image data from one color model or space to another.
AMD Performance Library User’s Manual 232 Image Processing Library

Publication # 40535 February 2007
RGBToYUV
Convert from RGB to YUV
Synopsis
AplStatus apliRGBToYUV_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYUV_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYUV_8u_P3R ( const Apl8u * const pSrc[3] , int srcStep , Apl8u * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYUV_8u_C3P3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst[3] , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the YUV color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to a YUV image (pDst).
The following conversion formulas are used:
Y = 0.299*R + 0.587*G + 0.114*B
U = -0.147*R + 0.289*G + 0.436*B
V = 0.615*R - 0.515*G - 0.100*B
The input RGB contains the range [0 to 255]. The output Y contains the range [0 to 255]. The output U contains the range [16 to
240], with 128 corresponding to zero. The output V ranges from [-157 to 157]. In order to fit the range [0 to 255], a constant value of
128 is added and the values are saturated to the range [0 to 255].
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 233 Image Processing Library

Publication # 40535 February 2007
YUVToRGB
Convert from YUV to RGB
Synopsis
AplStatus apliYUVToRGB_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUVToRGB_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUVToRGB_8u_P3R ( const Apl8u * const pSrc[3] , int srcStep , Apl8u * pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliYUVToRGB_8u_P3C3R ( const Apl8u * const pSrc[3] , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YUV color space to the RGB color model, and
write the converted data to a destination buffer.
A YUV image (pSrc) declared in the ROI (roiSize) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 234 Image Processing Library

Publication # 40535 February 2007
RGBToYUV422
Convert from RGB to YUV with 4:2:2 sampling
Synopsis
AplStatus apliRGBToYUV422_8u_C3C2R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYUV422_8u_P3R ( const Apl8u * const pSrc[3] , int srcStep , Apl8u * pDst[3] , int dstStep[3] , ApliSize roiSize );
AplStatus apliRGBToYUV422_8u_P3 ( const Apl8u * const pSrc[3] , Apl8u * pDst[3] , ApliSize imgSize );
AplStatus apliRGBToYUV422_8u_C3P3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst[3] , int dstStep[3] , ApliSize roiSize );
AplStatus apliRGBToYUV422_8u_C3P3 ( const Apl8u * pSrc , Apl8u * pDst[3] , ApliSize imgSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
dstStep[3] Destination three-channel planar buffer step size (array values define width of each plane in bytes).
imgSize Specifies the dimensions of an entire image.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions convert data in a source buffer from the RGB color model to the YUV color space with 4:2:2 chroma subsampling, and
write the converted data to a destination buffer. The repeating versions of the functions step through an ROI in a source buffer and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) is converted to a YUV image with 4:2:2 chroma subsampling.
The following conversion formulas are used:
Y = 0.299*R + 0.587*G + 0.114*B
U = -0.147*R + 0.289*G + 0.436*B
V = 0.615*R - 0.515*G - 0.100*B
The input RGB contains the range [0 to 255]. The output Y contains the range [0 to 255]. The output U contains the range [16 to
240], with 128 corresponding to zero. The output V ranges from [-157 to 157]. In order to fit the range [0 to 255], a constant value of
128 is added and the values are saturated to the range [0 to 255].
Versions of the functions that don't specify an ROI apply the conversion to the whole image buffer.
AMD Performance Library User’s Manual 235 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 236 Image Processing Library

Publication # 40535 February 2007
YUV422ToRGB
Convert from YUV with 4:2:2 sampling to RGB
Synopsis
AplStatus apliYUV422ToRGB_8u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUV422ToRGB_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliYUV422ToRGB_8u_P3 ( const Apl8u* const pSrc[3] , Apl8u* pDst[3] , ApliSize imgSize );
AplStatus apliYUV422ToRGB_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUV422ToRGB_8u_P3AC4R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUV422ToRGB_8u_P3C3 ( const Apl8u* const pSrc[3] , Apl8u* pDst , ApliSize imgSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
imgSize Specifies the dimensions of an entire image.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions convert data in a source buffer from the YUV color space with 4:2:2 chroma subsampling to the RGB model, and write
the converted data to a destination buffer. The repeating versions of the functions step through an ROI in a source buffer and write the
converted data to a destination buffer.
A YUV image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
Versions of the functions that don't specify an ROI apply the conversion to the whole image buffer.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
AMD Performance Library User’s Manual 237 Image Processing Library

Publication # 40535 February 2007
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 238 Image Processing Library

Publication # 40535 February 2007
RGBToYUV420
Convert from RGB to YUV with 4:2:0 sampling
Synopsis
AplStatus apliRGBToYUV420_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst[3] , int dstStep[3] , ApliSize roiSize );
AplStatus apliRGBToYUV420_8u_P3 ( const Apl8u* const pSrc[3] , Apl8u* pDst[3] , ApliSize imgSize );
AplStatus apliRGBToYUV420_8u_C3P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep[3] , ApliSize roiSize );
AplStatus apliRGBToYUV420_8u_C3P3 ( const Apl8u* pSrc , Apl8u* pDst[3] , ApliSize imgSize );
Parameters
dstStep[3] Destination three-channel planar buffer step size (array values define width of each plane in bytes).
imgSize Specifies the dimensions of an entire image.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions convert the data in a source buffer from the RGB color model to the YUV color space with 4:2:0 chroma subsampling,
and write the converted data to a destination buffer. The repeating versions of the functions step through an ROI in a source buffer
and write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) is converted to a YUV image with 4:2:0 chroma subsampling.
The following conversion formulas are used:
Y = 0.299*R + 0.587*G + 0.114*B
U = -0.147*R + 0.289*G + 0.436*B
V = 0.615*R - 0.515*G - 0.100*B
The input RGB contains the range [0 to 255]. The output Y contains the range [0 to 255]. The output U contains the range [16 to
240], with 128 corresponding to zero. The output V ranges from [-157 to 157]. In order to fit the range [0 to 255], a constant value of
128 is added and the values are saturated to the range [0 to 255].
Versions of the functions that don't specify an ROI apply the conversion to the whole image buffer.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
AMD Performance Library User’s Manual 239 Image Processing Library

Publication # 40535 February 2007
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 240 Image Processing Library

Publication # 40535 February 2007
YUV420ToRGB
Convert from YUV with 4:2:0 sampling to RGB
Synopsis
AplStatus apliYUV420ToRGB_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliYUV420ToRGB_8u_P3 ( const Apl8u* const pSrc[3] , Apl8u* pDst[3] , ApliSize imgSize );
AplStatus apliYUV420ToRGB_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUV420ToRGB_8u_P3AC4R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYUV420ToRGB_8u_P3C3 ( const Apl8u* const pSrc[3] , Apl8u* pDst , ApliSize imgSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
imgSize Specifies the dimensions of an entire image.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions convert data in an ROI in a source buffer from the YUV color space with 4:2:0 chroma subsampling to the RGB model,
and write the converted data to a destination buffer. The repeating versions of the functions step through an ROI in a source buffer
and write the converted data to a destination buffer.
A YUV image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
Versions of the functions that don't specify an ROI apply the conversion to the whole image buffer.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 241 Image Processing Library

Publication # 40535 February 2007
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 242 Image Processing Library

Publication # 40535 February 2007
YUV420ToBGR
Convert from YUV with 4:2:0 sampling to BGR
Synopsis
AplStatus apliYUV420ToBGR_8u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the YUV color space with 4:2:0 chroma
subsampling to the BGR model, and writes the converted data to a destination buffer.
A YUV image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 243 Image Processing Library

Publication # 40535 February 2007
YUV420ToRGB*
Convert from YUV with 4:2:0 sampling to 16-bit RGB
Synopsis
AplStatus apliYUV420ToRGB565_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
AplStatus apliYUV420ToRGB555_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
AplStatus apliYUV420ToRGB444_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YUV color space with 4:2:0 chroma
subsampling to the 16-bit RGB model, and write the converted data to a destination buffer.
A YUV image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
*The destination image is a packed RGB 16-bit per pixel image with reduced bit depth. The three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
AMD Performance Library User’s Manual 244 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 245 Image Processing Library

Publication # 40535 February 2007
YUV420ToBGR*
Convert from YUV with 4:2:0 sampling to 16-bit BGR
Synopsis
AplStatus apliYUV420ToBGR565_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
AplStatus apliYUV420ToBGR555_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
AplStatus apliYUV420ToBGR444_8u16u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize
);
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YUV color space with 4:2:0 chroma
subsampling to the 16-bit BGR model, and write the converted data to a destination buffer.
A YUV image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = Y + 1.140*V
G = Y - 0.394*U - 0.581*V
B = Y + 2.032*U
*The destination image is a packed BGR 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
AMD Performance Library User’s Manual 246 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 247 Image Processing Library

Publication # 40535 February 2007
RGBToYCbCr
Convert from RGB to YCbCr
Synopsis
AplStatus apliRGBToYCbCr_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCbCr_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCbCr_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the YCbCr color space,
and write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI (roiSize) is converted to a YCbCr image (pDst).
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 248 Image Processing Library

Publication # 40535 February 2007
YCbCrToRGB
Convert from YCbCr to RGB
Synopsis
AplStatus apliYCbCrToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space to the RGB model, and
write the converted data to a destination buffer.
A YUV image (pSrc) declared in the ROI (roiSize) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 249 Image Processing Library

Publication # 40535 February 2007
YCbCrToRGB*
Convert from YCbCr to 16-bit RGB
Synopsis
AplStatus apliYCbCrToRGB565_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB555_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB444_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToRGB444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space to the 16-bit RGB model,
and write the converted data to a destination buffer.
A YCbCr image (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed RGB 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
AMD Performance Library User’s Manual 250 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 251 Image Processing Library

Publication # 40535 February 2007
YCbCrToBGR*
Convert from YCbCr to 16-bit BGR
Synopsis
AplStatus apliYCbCrToBGR565_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToBGR555_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToBGR444_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToBGR565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToBGR555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCrToBGR444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space to the 16-bit BGR model,
and write the converted data to a destination buffer.
A YCbCr image (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed RGB 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
AMD Performance Library User’s Manual 252 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 253 Image Processing Library

Publication # 40535 February 2007
RGBToYCbCr422
Convert from RGB to YCbCr with 4:2:2 sampling
Synopsis
AplStatus apliRGBToYCbCr422_8u_C3C2R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCbCr422_8u_P3C2R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the YCbCr color space
with 4:2:2 chroma subsampling, and write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) is converted to a 16-bit per pixel YCbCr image with 4:2:2 chroma subsampling.
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 254 Image Processing Library

Publication # 40535 February 2007
YCbCr422ToRGB
Convert from YCbCr with 4:2:2 sampling to RGB
Synopsis
AplStatus apliYCbCr422ToRGB_8u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB_8u_C2P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:2:2 chroma
subsampling to the RGB model, and write the converted data to a destination buffer.
A 16-bit per pixel YCbCr image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 255 Image Processing Library

Publication # 40535 February 2007
RGBToCbYCr422*
Convert from RGB to CbYCr with 4:2:2 sampling
Synopsis
AplStatus apliRGBToCbYCr422_8u_C3C2R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToCbYCr422Gamma_8u_C3C2R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the CbYCr color space
with 4:2:2 chroma subsampling, and write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) is converted to a 16-bit per pixel CbYCr image with 4:2:2 chroma subsampling.
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
*A version of this function supports CbYCr gamma correction.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 256 Image Processing Library

Publication # 40535 February 2007
CbYCr422ToRGB
Convert from CbYCr with 4:2:2 sampling to RGB
Synopsis
AplStatus apliCbYCr422ToRGB_8u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the CbYCr color space with 4:2:2 chroma
subsampling to the RGB model, and writes the converted data to a destination buffer.
A 16-bit per pixel CbYCr image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 257 Image Processing Library

Publication # 40535 February 2007
BGRToCbYCr422
Convert from BGR to CbYCr with 4:2:2 sampling
Synopsis
AplStatus apliBGRToCbYCr422_8u_AC4C2R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the BGR color model to the CbYCr color space
with 4:2:2 chroma subsampling, and writes the converted data to a destination buffer.
A gamma-corrected BGR image (pSrc) is converted to a 16-bit per pixel CbYCr image with 4:2:2 chroma subsampling.
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 258 Image Processing Library

Publication # 40535 February 2007
CbYCr422ToBGR
Convert from CbYCr with 4:2:2 sampling to BGR
Synopsis
AplStatus apliCbYCr422ToBGR_8u_C2C4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize , Apl8u alpha );
Parameters
alpha Alpha (RGBA transparency) constant value.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the CbYCr color space with 4:2:2 chroma
subsampling to the BGR model, and writes the converted data to a destination buffer.
A 16-bit per pixel CbYCr image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 259 Image Processing Library

Publication # 40535 February 2007
YCbCr422ToRGB*
Convert from YCbCr with 4:2:2 sampling to 16-bit RGB
Synopsis
AplStatus apliYCbCr422ToRGB565_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB555_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB444_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToRGB444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:2:2 chroma
subsampling to the 16-bit RGB model, and write the converted data to a destination buffer.
A CbYCr image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed RGB 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
AMD Performance Library User’s Manual 260 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 261 Image Processing Library

Publication # 40535 February 2007
YCbCr422ToBGR*
Convert from YCbCr with 4:2:2 sampling to 16-bit BGR
Synopsis
AplStatus apliYCbCr422ToBGR565_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToBGR555_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToBGR444_8u16u_C2C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToBGR565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToBGR555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr422ToBGR444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:2:2 chroma
subsampling to the 16-bit BGR model, and write the converted data to a destination buffer.
A CbYCr image with 4:2:2 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed BGR 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
BGR565 - 5 bits for Blue, 6 bits for Green, 5 bits for Red
BGR555 - 5 bits for Blue, 5 bits for Green, 5 bits for Red
BGR444 - 4 bits for Blue, 4 bits for Green, 4 bits for Red
AMD Performance Library User’s Manual 262 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 263 Image Processing Library

Publication # 40535 February 2007
RGBToYCbCr420
Convert from RGB to YCbCr with 4:2:0 sampling
Synopsis
AplStatus apliRGBToYCbCr420_8u_C3P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep[3] , ApliSize roiSize );
Parameters
dstStep[3] Destination three-channel planar buffer step size (array values define width of each plane in bytes).
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the RGB color model to the YCbCr color space
with 4:2:0 chroma subsampling, and writes the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) is converted to a YCbCr image with 4:2:0 chroma subsampling.
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 264 Image Processing Library

Publication # 40535 February 2007
BGRToYCbCr420
Convert from BGR to YCbCr with 4:2:0 sampling
Synopsis
AplStatus apliBGRToYCbCr420_8u_C3P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep[3] , ApliSize roiSize );
AplStatus apliBGRToYCbCr420_8u_AC4P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep[3] , ApliSize roiSize );
Parameters
dstStep[3] Destination three-channel planar buffer step size (array values define width of each plane in bytes).
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the BGR color model to the YCbCr color space
with 4:2:0 chroma subsampling, and writes the converted data to a destination buffer.
A gamma-corrected BGR image (pSrc) is converted to a YCbCr image with 4:2:0 chroma subsampling.
The following conversion formulas are used:
Y = 0.257*R + 0.504*G + 0.098*B + 16
Cb = -0.148*R - 0.291*G + 0.439*B + 128
Cr = 0.439*R - 0.368*G - 0.071*B + 128
The input RGB contains the range [0 to 255]. The output Y nominally contains the range [16 to 235]. The output Cb and Cr contains
the range [16 to 240], with 128 corresponding to zero.
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 265 Image Processing Library

Publication # 40535 February 2007
YCbCr420ToRGB
Convert from YCbCr with 4:2:0 sampling to RGB
Synopsis
AplStatus apliYCbCr420ToRGB_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the YCbCr color space with 4:2:0 chroma
subsampling to the RGB color model, and writes the converted data to a destination buffer.
A YCbCr image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 266 Image Processing Library

Publication # 40535 February 2007
YCbCr420ToRGB*
Convert from YCbCr with 4:2:0 sampling to 16-bit RGB
Synopsis
AplStatus apliYCbCr420ToRGB565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr420ToRGB555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr420ToRGB444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:2:0 chroma
subsampling to the 16-bit RGB color model, and write the converted data to a destination buffer.
A YCbCr image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected RGB image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed RGB 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
RGB565 - 5 bits for Red, 6 bits for Green, 5 bits for Blue
RGB555 - 5 bits for Red, 5 bits for Green, 5 bits for Blue
RGB444 - 4 bits for Red, 4 bits for Green, 4 bits for Blue
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 267 Image Processing Library

Publication # 40535 February 2007
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 268 Image Processing Library

Publication # 40535 February 2007
YCbCr420ToBGR
Convert from YCbCr with 4:2:0 sampling to BGR
Synopsis
AplStatus apliYCbCr420ToBGR_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
This function steps through an ROI in a source buffer, converts the source data from the YCbCr color space with 4:2:0 chroma
subsampling to the BGR color model with dithering, and writes the converted data to a destination buffer.
A YCbCr image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 269 Image Processing Library

Publication # 40535 February 2007
YCbCr420ToBGR*
Convert from YCbCr with 4:2:0 sampling to 16-bit BGR
Synopsis
AplStatus apliYCbCr420ToBGR565_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr420ToBGR555_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr420ToBGR444_8u16u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:2:0 chroma
subsampling to the 16-bit BGR color model, and write the converted data to a destination buffer.
A YCbCr image with 4:2:0 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
*The destination image is a packed BGR 16-bit per pixel image, with reduced bit depth; the three channel intensities are packed into
two consecutive bytes. After the conversion is performed, the bit reduction discards the least significant bits in the image.
There are 3 possible packed formats:
BGR565 - 5 bits for Blue, 6 bits for Green, 5 bits for Red
BGR555 - 5 bits for Blue, 5 bits for Green, 5 bits for Red
BGR444 - 4 bits for Blue, 4 bits for Green, 4 bits for Red
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 270 Image Processing Library

Publication # 40535 February 2007
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 271 Image Processing Library

Publication # 40535 February 2007
YCbCr411ToBGR
Convert from YCbCr with 4:1:1 sampling to BGR
Synopsis
AplStatus apliYCbCr411ToBGR_8u_P3C3R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCbCr411ToBGR_8u_P3C4R ( const Apl8u* pSrc[3] , int srcStep[3] , Apl8u* pDst , int dstStep , ApliSize roiSize , Apl8u alpha
);
Parameters
alpha Alpha (RGBA transparency) constant value.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep[3] Source three-channel planar buffer step size (array values define width of each plane in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCbCr color space with 4:1:1 chroma
subsampling to the BGR color model, and write the converted data to a destination buffer.
A YCbCr image with 4:1:1 chroma subsampling (pSrc) is converted to a gamma-corrected BGR image (pDst).
The following conversion formulas are used:
R = 1.164*(Y-16) + 1.596*(Cr-128)
G = 1.164*(Y-16) - 0.392*(Cb-128) - 0.813*(Cr-128)
B = 1.164*(Y-16) + 2.017*(Cb-128)
Return Values
aplStsDoubleSize Image size (height and/or width) is not a multiple of two warning status code.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 272 Image Processing Library

Publication # 40535 February 2007
RGBToXYZ
Convert from RGB to XYZ
Synopsis
AplStatus apliRGBToXYZ_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToXYZ_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the XYZ color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to a CIE XYZ image (pDst).
The following formulas are used:
X = 0.412453*R + 0.35758 *G + 0.180423*B
Y = 0.212671*R + 0.71516 *G + 0.072169*B
Z = 0.019334*R + 0.119193*G + 0.950227*B
The formulas assume that R, G, and B values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is saturated to [0 to 1].
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 273 Image Processing Library

Publication # 40535 February 2007
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 274 Image Processing Library

Publication # 40535 February 2007
XYZToRGB
Convert from XYZ to RGB
Synopsis
AplStatus apliXYZToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliXYZToRGB_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the XYZ color space to the RGB color model, and
write the converted data to a destination buffer.
A CIE XYZ image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst)
The following conversion formulas are used:
X = 3.240479*X - 1.53715 *Y - 0.498535*Z
Y = -0.969256*X + 1.875991*Y + 0.041556*Z
Z = 0.055648*X - 0.204043*Y + 1.057311*Z
The formulas assume that X, Y, and Z values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is simply saturated to [0 to 1].
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 275 Image Processing Library

Publication # 40535 February 2007
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 276 Image Processing Library

Publication # 40535 February 2007
RGBToLUV
Convert from RGB to LUV
Synopsis
AplStatus apliRGBToLUV_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToLUV_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the LUV color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to a CIE LUV image (pDst) in two steps.
1. Convert( ) RGBToXYZ( ) using the following formulas.
X = 0.412453*R + 0.35758 *G + 0.180423*B
Y = 0.212671*R + 0.71516 *G + 0.072169*B
Z = 0.019334*R + 0.119193*G + 0.950227*B
The formulas assume that R, G, and B values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is saturated to [0 to 1].
2. Convert( ) XYZ to LUV as follows.
D65 white point:
CIE chromaticity coordinates:
AMD Performance Library User’s Manual 277 Image Processing Library

Publication # 40535 February 2007
xn = 0.312713
yn = 0.329016
CIE luminance:
Yn = 1.0
un = 4*xn / (-2*xn + 12*yn + 3)
vn = 9*yn / (-2*xn + 12*yn + 3)
u = 4*X / (X + 15*Y + 3*Z)
v = 9*Y / (X + 15*Y + 3*Z)
L = 116 * (Y/Yn)^(1/3) - 16
U = 13*L*(u-un)
V = 13*L*(v-vn)
Computed L component values are in the range [0 to 100].
Computed U component values are in the range [-124 to 220].
Computed V component values are in the range [-140 to 116].
The formulas assume that R, G, and B values are normalized to [0 to1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range.
Scaling is performed as follows.
8U data type:
L = L * APL_MAX_8U / 100
U = (U + 134) * APL_MAX_8U / 354
V = (V + 140) * APL_MAX_8U / 256
16U data type:
L = L * APL_MAX_16U / 100
U = (U + 134) * APL_MAX_16U / 354
V = (V + 140) * APL_MAX_16U / 256
16S data type:
L = L * APL_MAX_16U / 100 + APL_MIN_16S
U = (U + 134) * APL_MAX_16U / 354 + APL_MIN_16S
V = (V + 140) * APL_MAX_16U / 256 + APL_MIN_16S
32F data type:
No conversion is applied, so the components remain in their ranges.
AMD Performance Library User’s Manual 278 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 279 Image Processing Library

Publication # 40535 February 2007
LUVToRGB
Convert from LUV to RGB
Synopsis
AplStatus apliLUVToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLUVToRGB_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
A CIE LUV image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) in two steps.
1. Convert( ) CIE LUV to XYZ as follows.
Scale( ) data to the range [0 to 1]
8U data type:
L = L * 100 / APL_MAX_8U
U = (U * 354 / APL_MAX_8U) - 134
V = (V * 256 / APL_MAX_8U) - 140
16U data type:
L = L * 100 / APL_MAX_16U
U = (U * 354 / APL_MAX_16U) - 134
V = (V * 256 / APL_MAX_16U) - 140
16S data type:
AMD Performance Library User’s Manual 280 Image Processing Library

Publication # 40535 February 2007
U = ((U - APL_MIN_16S) * 354 / APL_MAX_16U) - 134
V = ((V - APL_MIN_16S) * 256 / APL_MAX_16U) - 140
32F data type:
L, U, and V must already be in the range [0...1]
D65 white point:
CIE chromaticity coordinates:
xn = 0.312713
yn = 0.329016
CIE luminance:
Yn = 1.0
un = 4*xn / (-2*xn + 12*yn + 3)
vn = 9*yn / (-2*xn + 12*yn + 3)
u = U / (14 * L) + un
v = V / (13 * L) + vn
Y = Yn * ((L + 16) / 116) ^ 3
X = -9 * Y * u / ((u - 4) * v - u * v) = (9 / 4) * Y * u / v
Z = (9 * Y - 15 * v * Y - v * X) / (3 * v)
2.Convert( ) XYZ to RGB using the following formulas:
X = 3.240479*X - 1.53715 *Y - 0.498535*Z
Y = -0.969256*X + 1.875991*Y + 0.041556*Z
Z = 0.055648*X - 0.204043*Y + 1.057311*Z
The formulas assume that X, Y, and Z values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is simply saturated to [0 to 1].
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 281 Image Processing Library

Publication # 40535 February 2007
BGRToLab
Convert from BGR to Lab
Synopsis
AplStatus apliBGRToLab_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliBGRToLab_8u16u_C3R ( const Apl8u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the BGR color model to the Lab color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to a CIE Lab image (pDst) in two steps.
1. Normalize the data to [0 to 1] and convert RGB to XYZ using the following formulas.
X = 0.412453*R + 0.35758 *G + 0.180423*B
Y = 0.212671*R + 0.71516 *G + 0.072169*B
Z = 0.019334*R + 0.119193*G + 0.950227*B
The formulas assume that R, G, and B values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is saturated to [0 to 1].
2) Convert( ) XYZ To Lab as follows.
D65 white point:
Xn = 0.950455
Yn = 1.0
Zn = 1.088753
CIE chromaticity coordinates:
xn = 0.312713
yn = 0.329016
AMD Performance Library User’s Manual 282 Image Processing Library

Publication # 40535 February 2007
if ((Y / Yn) > 0.008856)
L = 116 * (Y/Yn)^(1/3) - 16 else L = 903.3 * (Y/Yn)^(1/3)
a = 500 * [f(X/Xn) - f(Y/Yn)]
b = 200 * [f(Y/Yn) - f(Z/Zn)]
where if (t > 0.008856) f(t) = t^(1/3) - 16 else f(t) = 7.787*t + 16/116
The computed L, a, and b are in the range [0 to 100], [-128 to 127], and [-128b to 127], respectively.
The computed image data is quantized and scaled to fit the 8-bit or 16-bit range.
8U data type:
L = L * 255/100
a = a + 128
b = b + 128
16u data type:
L = L * 65535 / 100
a = (a+128) * 255
b = (b+128) * 255
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 283 Image Processing Library

Publication # 40535 February 2007
LabToBGR
Convert from Lab to BGR
Synopsis
AplStatus apliLabToBGR_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliLabToBGR_16u8u_C3R ( const Apl16u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the Lab color space to the BGR color model, and
write the converted data to a destination buffer.
A CIE Lab image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) in two steps.
1. Transform the data to the correct range as follows.
8U data type:
L = L * 100 / 255
a = a - 128
b = b - 128
16u data type:
L = L * 100 / 65535
a = a / 255 - 128
b = b / 255 - 128
Convert to XYZ:
Y = Yn * P^3
X = Xn * (P + a/500)^3
Z = Zn * (P - b/200)^2
where P = (L+16)/116
AMD Performance Library User’s Manual 284 Image Processing Library

Publication # 40535 February 2007
D65 white point:
Xn = 0.950455
Yn = 1.0 Zn = 1.088753
2.Convert( ) XYZ to BGR using the following formulas:
X = 3.240479*X - 1.53715 *Y - 0.498535*Z
Y = -0.969256*X + 1.875991*Y + 0.041556*Z
Z = 0.055648*X - 0.204043*Y + 1.057311*Z
The formulas assume that X, Y, and Z values are normalized to [0 to 1] for integer data types. For floating point data types, the data
must already be in the range [0 to 1]. For integer data types, the converted image data is saturated to [0 to 1] and scaled to the data
type range. For floating point data type, data is simply saturated to [0 to 1].
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 285 Image Processing Library

Publication # 40535 February 2007
RGBToYCC
Convert from RGB to YCC
Synopsis
AplStatus apliRGBToYCC_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToYCC_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the YCC color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to a Photo YCC image (pDst) in four steps.
1.Normalize the input to the range [0 to 1] for all integer data types. Floating-point data must already be in the range [0...1].
2.Apply the following formulas:
Y = 0.299*R + 0.587*G + 0.114*B
C1 = -0.299*R - 0.587*G + 0.886*B
C2 = 0.701*R - 0.587*G - 0.114*B
3. Quantize the color model and convert to the Photo YCC model. Data is in the range [0 to 1].
Y = (1/1.402) * Y
C1 = (111.4/255) * C1 + 156/255
C2 = (135.64/255) * C2 + 137/255
4. For integer destination data types, the Photo YCC color model is scaled to the full range.
AMD Performance Library User’s Manual 286 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 287 Image Processing Library

Publication # 40535 February 2007
YCCToRGB
Convert from YCC to RGB
Synopsis
AplStatus apliYCCToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliYCCToRGB_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the YCC color space to the RGB color model, and
write the converted data to a destination buffer.
A Photo YCC image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) as follows.
Restore normal YCC data:
Y = 1.3584 * Y
C1 = 2.2179 * (C1 - 156/255)
C2 = 1.8215 * (C2 - 137/255)
The formulas assume that Y, C1, and C2 are normalized to [0 to 1]. For floating point data type, the input must already be in the
range [0 to 1].
For integer data types, an internal conversion is performed. Then the restored YCC data values are transformed to RGB.
The following conversion formulas are used:
AMD Performance Library User’s Manual 288 Image Processing Library

Publication # 40535 February 2007
R = Y + C2
G = Y - 0.194*C1 - 0.509*C2
B = Y + C1
For integer destination data types, the result image data is scaled to the full range of the destination data type.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 289 Image Processing Library

Publication # 40535 February 2007
RGBToHLS
Convert from RGB to HLS
Synopsis
AplStatus apliRGBToHLS_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHLS_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the HLS color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to an HLS image (pDst) as follows.
// Lightness:
M1 = max(R, G, B)
M2 = min(R, G, B)
L = (M1+M2)/2
// Saturation:
If (M1 == M2)
S = H = 0
else // chromatics case
{
if (L

Publication # 40535 February 2007
}
else
S = (M1-M2) / (M1+M2)
S = (M1-M2) / (2-M1-M2)
//Hue:
Cr = (M1-R) / (M1-M2)
Cg = (M1-G) / (M1-M2)
Cb = (M1-B) / (M1-M2)
if (M1 == R)
H = Cb - Cg
if (M1 == G)
H = 2 + Cr - Cb
if (M1 == B)
H = 4 + Cg - Cr
H = H*60
if (H < 0)
H += 360
Theformulas assume that R, G, and B values are in the range [0 to 1]. For integer destination data type, the values are scaled to the
full range of the data type.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 291 Image Processing Library

Publication # 40535 February 2007
HLSToRGB
Convert from HLS to RGB
Synopsis
AplStatus apliHLSToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_16s_C3R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_16s_AC4R ( const Apl16s* pSrc , int srcStep , Apl16s* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_32f_C3R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToRGB_32f_AC4R ( const Apl32f* pSrc , int srcStep , Apl32f* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the HLS color space to the RGB color model, and
write the converted data to a destination buffer.
An HLS image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) as follows.
if ( L

Publication # 40535 February 2007
}
if (h > 360)
if (h < 60)
h = h - 360
R = (M1 + (M2 - M1)*h/60)
else if (h < 180)
R = M2
else if (h < 240)
else
R = M1 + (M2 - M1)*(240 - h)/60
R = M1
h = H
if (h < 60)
G = (M1 + (M2 - M1)*h/60)
else if (h < 180)
G = M2
else if (h < 240)
G = M1 + (M2 - M1)*(240 - h)/60
else
G = M1
h = H - 120
if (h < 60)
B = (M1 + (M2 - M1)*h/60)
else if (h < 180)
B = M2
else if (h < 240)
B = M1 + (M2 - M1)*(240 - h)/60
else
B = M1
The formulas assume that H, L, and S values are in the range [0 to 1]. For integer destination data type, the values are scaled to the
full range of the data type.
AMD Performance Library User’s Manual 293 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 294 Image Processing Library

Publication # 40535 February 2007
BGRToHLS
Convert from BGR to HLS
Synopsis
AplStatus apliBGRToHLS_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_C3P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_AC4P4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_AP4R ( const Apl8u* const pSrc[4] , int srcStep , Apl8u* pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_AP4C4R ( const Apl8u* const pSrc[4] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliBGRToHLS_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the BGR color model to the HLS color space, and
write the converted data to a destination buffer.
A gamma-corrected BGR image (pSrc) declared in the ROI is converted to an HLS image (pDst) as follows.
// Lightness:
M1 = max(R, G, B)
M2 = min(R, G, B)
L = (M1+M2)/2
// Saturation:
If (M1 == M2)
S = H = 0
AMD Performance Library User’s Manual 295 Image Processing Library

Publication # 40535 February 2007
else // chromatics case
{
if (L

Publication # 40535 February 2007
HLSToBGR
Convert from HLS to BGR
Synopsis
AplStatus apliHLSToBGR_8u_C3P3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliHLSToBGR_8u_AC4P4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliHLSToBGR_8u_AP4R ( const Apl8u* const pSrc[4] , int srcStep , Apl8u* pDst[4] , int dstStep , ApliSize roiSize );
AplStatus apliHLSToBGR_8u_P3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst[3] , int dstStep , ApliSize roiSize );
AplStatus apliHLSToBGR_8u_AP4C4R ( const Apl8u* const pSrc[4] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHLSToBGR_8u_P3C3R ( const Apl8u* const pSrc[3] , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the HLS color space to the BGR color model, and
write the converted data to a destination buffer.
An HLS image (pSrc) declared in the ROI is converted to a gamma-corrected BGR image (pDst) as follows.
An HLS image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) as follows.
if ( L

Publication # 40535 February 2007
else
{
h = H + 120
if (h > 360)
h = h - 360
if (h < 60)
R = (M1 + (M2 - M1)*h/60)
else if (h < 180)
R = M2
else if (h < 240)
R = M1 + (M2 - M1)*(240 - h)/60
else
R = M1
h = H
if (h < 60)
G = (M1 + (M2 - M1)*h/60)
else if (h < 180)
G = M2
else if (h < 240)
G = M1 + (M2 - M1)*(240 - h)/60
else
G = M1
h = H - 120
if (h < 60)
B = (M1 + (M2 - M1)*h/60)
else if (h < 180)
B = M2
else if (h < 240)
B = M1 + (M2 - M1)*(240 - h)/60
else
B = M1
AMD Performance Library User’s Manual 298 Image Processing Library

Publication # 40535 February 2007
}
The formulas assume that H, L, and S values are in the range [0 to 1]. For integer destination data type, the values are scaled to the
full range of the data type.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 299 Image Processing Library

Publication # 40535 February 2007
RGBToHSV
Convert from RGB to HSV
Synopsis
AplStatus apliRGBToHSV_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHSV_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHSV_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliRGBToHSV_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the RGB color model to the HSV color space, and
write the converted data to a destination buffer.
A gamma-corrected RGB image (pSrc) declared in the ROI is converted to an HSV image (pDst) as follows.
Value:
V = max(R, G, B)
Saturation:
temp = min = (R, G, B)
if (V == 0)
achromatics case
S = 0
else
chromatics case
S = (V-temp)/V
Hue:
Cr = (V - R) / (V - temp)
Cg = (V - G) / (V - temp)
AMD Performance Library User’s Manual 300 Image Processing Library

Publication # 40535 February 2007
Cb = (V - B) / (V - temp)
if (R==V)
H = Cb - Cg
if (G==V)
H = 2 + Cr - Cb
if (B==V)
H = 4 + Cg - Cr
H = H * 60
if (H < 0)
H = H + 360
The formulas assume R, G, and B values are in the range [0 to 1].. For integer data types, the computed image data are scaled to the
full range of the destination data type.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 301 Image Processing Library

Publication # 40535 February 2007
HSVToRGB
Convert from HSV to RGB
Synopsis
AplStatus apliHSVToRGB_8u_C3R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHSVToRGB_8u_AC4R ( const Apl8u* pSrc , int srcStep , Apl8u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHSVToRGB_16u_C3R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
AplStatus apliHSVToRGB_16u_AC4R ( const Apl16u* pSrc , int srcStep , Apl16u* pDst , int dstStep , ApliSize roiSize );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, convert the source data from the HSV color space to the RGB color model, and
write the converted data to a destination buffer.
An HSV image (pSrc) declared in the ROI is converted to a gamma-corrected RGB image (pDst) as follows.
if (S==0)
R = G = B = V
else
{
if (H == 360)
H = 0
else
H = H/60
I = floor(H)
F = H - I
M = V * (1 - S)
N = V * (1 - S * F)
K = V * (1 - s * (1 - F))
AMD Performance Library User’s Manual 302 Image Processing Library

Publication # 40535 February 2007
}
if (I == 0)
R = V
G = K
B = M
if (I == 1)
R = N
G = V
B = M
if (I == 2)
R = M
G = V
B = K
if (I == 3)
R = M
G = N
B = V
if (I == 4)
R = K
G = M
B = V
if (I == 5)
R = V
G = M
B = V
The computed image data is then scaled to the full range of the destination data type.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 303 Image Processing Library

Publication # 40535 February 2007
Threshold and Compare Functions
This chapter describes functions that compare image data and manipulate image data based on compare operations.
AMD Performance Library User’s Manual 304 Image Processing Library

Publication # 40535 February 2007
Threshold
Compare to a threshold, replace with threshold value (General)
Synopsis
AplStatus apliThreshold_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold ,
AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s threshold ,
AplCmpOp aplCmpOp );
AplStatus apliThreshold_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold ,
AplCmpOp aplCmpOp );
AplStatus apliThreshold_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u threshold[3] ,
AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u threshold[3]
, AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold , AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold , AplCmpOp aplCmpOp );
AplStatus apliThreshold_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold , AplCmpOp aplCmpOp );
AplStatus apliThreshold_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , AplCmpOp aplCmpOp
);
AplStatus apliThreshold_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , AplCmpOp aplCmpOp
);
AplStatus apliThreshold_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , AplCmpOp aplCmpOp
);
AMD Performance Library User’s Manual 305 Image Processing Library

Publication # 40535 February 2007
Parameters
aplCmpOp Specifies a comparison operation to be performed (aplCmpLess, aplCmpGreater, aplCmpLessEq, aplCmpEq, or aplCmpGreaterEq).
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
Description
These functions step through an ROI in a source buffer and compare the source data to a specified threshold value using a specified
compare operation. The compare operation can be "less than", "less than or equal", "equal", "greater than or equal" or "greater than".
When the comparison evaluates as true, the output data is set to the threshold value. When the comparison evaluates as false, the
output data is set to the same value as the source data. Output data is written back to the same buffer for in-place operation or to a
destination buffer. .
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 306 Image Processing Library

Publication # 40535 February 2007
Threshold_GT
Compare to a threshold, replace with threshold value (Greater Than)
Synopsis
AplStatus apliThreshold_GT_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold );
AplStatus apliThreshold_GT_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s threshold );
AplStatus apliThreshold_GT_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold );
AplStatus apliThreshold_GT_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] );
AplStatus apliThreshold_GT_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] );
AplStatus apliThreshold_GT_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] );
AplStatus apliThreshold_GT_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] );
AplStatus apliThreshold_GT_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] );
AplStatus apliThreshold_GT_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] );
AplStatus apliThreshold_GT_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold );
AplStatus apliThreshold_GT_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold );
AplStatus apliThreshold_GT_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold );
AplStatus apliThreshold_GT_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] );
AplStatus apliThreshold_GT_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] );
AplStatus apliThreshold_GT_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] );
AplStatus apliThreshold_GT_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] );
AplStatus apliThreshold_GT_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] );
AplStatus apliThreshold_GT_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
AMD Performance Library User’s Manual 307 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer and compare source data to a specified threshold value. When the source data
is greater than the threshold value, the output data is set to the threshold value. When the source data is less than or equal to the
threshold value, the output data is set to the same value as the source data. Output data is written back to the same buffer for inplace
operation or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 308 Image Processing Library

Publication # 40535 February 2007
Threshold_LT
Compare to a threshold, replace with threshold value (Less Than)
Synopsis
AplStatus apliThreshold_LT_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold );
AplStatus apliThreshold_LT_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s threshold );
AplStatus apliThreshold_LT_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold );
AplStatus apliThreshold_LT_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] );
AplStatus apliThreshold_LT_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] );
AplStatus apliThreshold_LT_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] );
AplStatus apliThreshold_LT_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] );
AplStatus apliThreshold_LT_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] );
AplStatus apliThreshold_LT_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] );
AplStatus apliThreshold_LT_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold );
AplStatus apliThreshold_LT_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold );
AplStatus apliThreshold_LT_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold );
AplStatus apliThreshold_LT_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] );
AplStatus apliThreshold_LT_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] );
AplStatus apliThreshold_LT_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] );
AplStatus apliThreshold_LT_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] );
AplStatus apliThreshold_LT_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] );
AplStatus apliThreshold_LT_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
AMD Performance Library User’s Manual 309 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer and compare source data to a specified threshold value. When the source data
is less than the threshold value, the output data is set to the threshold value. When the source data is more than or equal to the
threshold value, the output data is set to the same value as the source data. Output data is written back to the same buffer for inplace
operation or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 310 Image Processing Library

Publication # 40535 February 2007
Threshold_Val
Compare to a threshold, replace with specified value (General)
Synopsis
AplStatus apliThreshold_Val_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold ,
Apl8u value , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s threshold ,
Apl16s value , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold ,
Apl32f value , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold , Apl8u value , AplCmpOp
aplCmpOp );
AplStatus apliThreshold_Val_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold , Apl16s value , AplCmpOp
aplCmpOp );
AplStatus apliThreshold_Val_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold , Apl32f value , AplCmpOp
aplCmpOp );
AplStatus apliThreshold_Val_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u value[3]
, AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u
value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] , AplCmpOp aplCmpOp );
AplStatus apliThreshold_Val_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
value[3] , AplCmpOp aplCmpOp );
AMD Performance Library User’s Manual 311 Image Processing Library

Publication # 40535 February 2007
Parameters
aplCmpOp Specifies a comparison operation to be performed (aplCmpLess, aplCmpGreater, aplCmpLessEq, aplCmpEq, or aplCmpGreaterEq).
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
value Specified value.
value[3] An array of three specified values.
Description
These functions step through an ROI in a source buffer and compare source data to a specified threshold value using a specified
compare operation. The compare operation can be "less than", "less than or equal", "equal", "greater than or equal" or "greater than".
When the comparison evaluates as true, the output data is set to a specified value. When the comparison evaluates as false, the
output data is set to the same value as the source data. Output data is written back to the same buffer for in-place operation or to a
destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 312 Image Processing Library

Publication # 40535 February 2007
Threshold_GTVal
Compare to a threshold, replace with specified value (Greater Than)
Synopsis
AplStatus apliThreshold_GTVal_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold ,
Apl8u value );
AplStatus apliThreshold_GTVal_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s
threshold , Apl16s value );
AplStatus apliThreshold_GTVal_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold
, Apl32f value );
AplStatus apliThreshold_GTVal_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] );
AplStatus apliThreshold_GTVal_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] );
AplStatus apliThreshold_GTVal_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] );
AplStatus apliThreshold_GTVal_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] );
AplStatus apliThreshold_GTVal_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] );
AplStatus apliThreshold_GTVal_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] );
AplStatus apliThreshold_GTVal_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[4] , const Apl8u value[4] );
AplStatus apliThreshold_GTVal_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[4] , const Apl16s value[4] );
AplStatus apliThreshold_GTVal_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[4] , const Apl32f value[4] );
AplStatus apliThreshold_GTVal_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold , Apl8u value );
AplStatus apliThreshold_GTVal_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold , Apl16s value );
AplStatus apliThreshold_GTVal_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold , Apl32f value );
AplStatus apliThreshold_GTVal_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u
value[3] );
AplStatus apliThreshold_GTVal_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] );
AplStatus apliThreshold_GTVal_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
value[3] );
AplStatus apliThreshold_GTVal_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u
value[3] );
AplStatus apliThreshold_GTVal_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] );
AplStatus apliThreshold_GTVal_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
AMD Performance Library User’s Manual 313 Image Processing Library

Publication # 40535 February 2007
value[3] );
AplStatus apliThreshold_GTVal_8u_C4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[4] , const Apl8u
value[4] );
AplStatus apliThreshold_GTVal_16s_C4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[4] , const Apl16s
value[4] );
AplStatus apliThreshold_GTVal_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[4] , const Apl32f
value[4] );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
threshold[4] Four-channel threshold for each pixel.
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and compare source data to a specified threshold value. When the source data
is greater than the threshold value, the output data is set to a specified value. When the source data is less than or equal to the
threshold value, the output data is set to the same value as the source data. Output data is written back to the same buffer for inplace
operation or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 314 Image Processing Library

Publication # 40535 February 2007
Threshold_LTVal
Compare to a threshold, replace with specified value (Less Than)
Synopsis
AplStatus apliThreshold_LTVal_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u threshold ,
Apl8u value );
AplStatus apliThreshold_LTVal_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s
threshold , Apl16s value );
AplStatus apliThreshold_LTVal_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f threshold
, Apl32f value );
AplStatus apliThreshold_LTVal_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] );
AplStatus apliThreshold_LTVal_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] );
AplStatus apliThreshold_LTVal_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] );
AplStatus apliThreshold_LTVal_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[3] , const Apl8u value[3] );
AplStatus apliThreshold_LTVal_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[3] , const Apl16s value[3] );
AplStatus apliThreshold_LTVal_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[3] , const Apl32f value[3] );
AplStatus apliThreshold_LTVal_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
threshold[4] , const Apl8u value[4] );
AplStatus apliThreshold_LTVal_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const Apl16s
threshold[4] , const Apl16s value[4] );
AplStatus apliThreshold_LTVal_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const Apl32f
threshold[4] , const Apl32f value[4] );
AplStatus apliThreshold_LTVal_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u threshold , Apl8u value );
AplStatus apliThreshold_LTVal_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s threshold , Apl16s value );
AplStatus apliThreshold_LTVal_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f threshold , Apl32f value );
AplStatus apliThreshold_LTVal_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u
value[3] );
AplStatus apliThreshold_LTVal_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] );
AplStatus apliThreshold_LTVal_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
value[3] );
AplStatus apliThreshold_LTVal_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[3] , const Apl8u
value[3] );
AplStatus apliThreshold_LTVal_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[3] , const Apl16s
value[3] );
AplStatus apliThreshold_LTVal_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[3] , const Apl32f
AMD Performance Library User’s Manual 315 Image Processing Library

Publication # 40535 February 2007
value[3] );
AplStatus apliThreshold_LTVal_8u_C4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u threshold[4] , const Apl8u
value[4] );
AplStatus apliThreshold_LTVal_16s_C4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s threshold[4] , const Apl16s
value[4] );
AplStatus apliThreshold_LTVal_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f threshold[4] , const Apl32f
value[4] );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
threshold Threshold for each pixel.
threshold[3] Three-channel threshold for each pixel.
threshold[4] Four-channel threshold for each pixel.
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and compare source data to a specified threshold value. When the source data
is less than the threshold value, the output data is set to a specified value. When the source data is more than or equal to the
threshold value, the output data is set to the same value as the source data. Output data is written back to the same buffer for inplace
operation or to a destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 316 Image Processing Library

Publication # 40535 February 2007
Threshold_LTValGTVal
Compare to double threshold, replace with specified value (Less Than/Greater Than)
Synopsis
AplStatus apliThreshold_LTValGTVal_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , Apl8u
thresholdLT , Apl8u valueLT , Apl8u thresholdGT , Apl8u valueGT );
AplStatus apliThreshold_LTValGTVal_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , Apl16s
thresholdLT , Apl16s valueLT , Apl16s thresholdGT , Apl16s valueGT );
AplStatus apliThreshold_LTValGTVal_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , Apl32f
thresholdLT , Apl32f valueLT , Apl32f thresholdGT , Apl32f valueGT );
AplStatus apliThreshold_LTValGTVal_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const Apl8u
thresholdLT[3] , const Apl8u valueLT[3] , const Apl8u thresholdGT[3] , const Apl8u valueGT[3] );
AplStatus apliThreshold_LTValGTVal_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const
Apl16s thresholdLT[3] , const Apl16s valueLT[3] , const Apl16s thresholdGT[3] , const Apl16s valueGT[3] );
AplStatus apliThreshold_LTValGTVal_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const
Apl32f thresholdLT[3] , const Apl32f valueLT[3] , const Apl32f thresholdGT[3] , const Apl32f valueGT[3] );
AplStatus apliThreshold_LTValGTVal_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , const
Apl8u thresholdLT[3] , const Apl8u valueLT[3] , const Apl8u thresholdGT[3] , const Apl8u valueGT[3] );
AplStatus apliThreshold_LTValGTVal_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize roiSize , const
Apl16s thresholdLT[3] , const Apl16s valueLT[3] , const Apl16s thresholdGT[3] , const Apl16s valueGT[3] );
AplStatus apliThreshold_LTValGTVal_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , const
Apl32f thresholdLT[3] , const Apl32f valueLT[3] , const Apl32f thresholdGT[3] , const Apl32f valueGT[3] );
AplStatus apliThreshold_LTValGTVal_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , Apl8u thresholdLT , Apl8u valueLT ,
Apl8u thresholdGT , Apl8u valueGT );
AplStatus apliThreshold_LTValGTVal_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , Apl16s thresholdLT , Apl16s valueLT ,
Apl16s thresholdGT , Apl16s valueGT );
AplStatus apliThreshold_LTValGTVal_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , Apl32f thresholdLT , Apl32f valueLT ,
Apl32f thresholdGT , Apl32f valueGT );
AplStatus apliThreshold_LTValGTVal_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u thresholdLT[3] , const
Apl8u valueLT[3] , const Apl8u thresholdGT[3] , const Apl8u valueGT[3] );
AplStatus apliThreshold_LTValGTVal_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s thresholdLT[3] , const
Apl16s valueLT[3] , const Apl16s thresholdGT[3] , const Apl16s valueGT[3] );
AplStatus apliThreshold_LTValGTVal_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f thresholdLT[3] , const
Apl32f valueLT[3] , const Apl32f thresholdGT[3] , const Apl32f valueGT[3] );
AplStatus apliThreshold_LTValGTVal_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl8u thresholdLT[3] , const
Apl8u valueLT[3] , const Apl8u thresholdGT[3] , const Apl8u valueGT[3] );
AplStatus apliThreshold_LTValGTVal_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl16s thresholdLT[3] , const
Apl16s valueLT[3] , const Apl16s thresholdGT[3] , const Apl16s valueGT[3] );
AplStatus apliThreshold_LTValGTVal_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , const Apl32f thresholdLT[3] , const
Apl32f valueLT[3] , const Apl32f thresholdGT[3] , const Apl32f valueGT[3] );
AMD Performance Library User’s Manual 317 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
thresholdGT Three-channel threshold for each pixel in greater-than operation.
thresholdGT[3] Three-channel threshold for each pixel in greater-than operation.
thresholdLT Threshold for each pixel in less-than operation.
thresholdLT[3] Three-channel threshold for each pixel in less-than operation.
valueGT Threshold for each pixel in greater-than operation.
valueGT[3] Three-channel threshold for each pixel in greater-than operation.
valueLT Threshold for each pixel in less-than operation.
valueLT[3] Three-channel threshold for each pixel in less-than operation.
Description
These functions step through an ROI in a source buffer and compare source data to two specified threshold values. The value of
thresholdLT must be less than the value of thresholdGT. When the source data is less than the value specified by thresholdLT, the
output data is set to the value specified by valueLT. When the source data is greater than the value specified by thresholdGT, the
output data is set to the value specified by valueLT. When the source data is within the range defined by thresholdLT and thresholdGT,
the output data is set to same value as the source data. Output data is written back to the same buffer for in-place operation or to a
destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsThresholdErr The less-than threshold is greater than the greater-than threshold.
AMD Performance Library User’s Manual 318 Image Processing Library

Publication # 40535 February 2007
Compare
Compare source data
Synopsis
AplStatus apliCompare_8u_C1R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_16s_C1R ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_8u_C3R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_16s_C3R ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_8u_C4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_16s_C4R ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_8u_AC4R ( const Apl8u * pSrc1 , int src1Step , const Apl8u * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_16s_AC4R ( const Apl16s * pSrc1 , int src1Step , const Apl16s * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
AplStatus apliCompare_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int dstStep ,
ApliSize roiSize , AplCmpOp aplCmpOp );
Parameters
aplCmpOp Specifies a comparison operation to be performed (aplCmpLess, aplCmpGreater, aplCmpLessEq, aplCmpEq, or aplCmpGreaterEq).
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 319 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through ROIs in two source buffers and compare the data in buffer 1 to the data in buffer 2 using a specified
compare operation. The compare operation can be "less than", "less than or equal, "equal", "greater than or equal" or "greater than".
When the comparison evaluates as true, the output data is set to all ones. When the comparison evaluates as false, the output data is
set to all zeroes. Output data is written to a 1-channel Apl8u destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 320 Image Processing Library

Publication # 40535 February 2007
CompareC
Compare to a constant
Synopsis
AplStatus apliCompareC_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u value , Apl8u * pDst , int dstStep , ApliSize roiSize , AplCmpOp
aplCmpOp );
AplStatus apliCompareC_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s value , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_8u_C3R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_16s_C3R ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_8u_AC4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_16s_AC4R ( const Apl16s * pSrc , int srcStep , const Apl16s value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize
, AplCmpOp aplCmpOp );
AplStatus apliCompareC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_8u_C4R ( const Apl8u * pSrc , int srcStep , const Apl8u value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_16s_C4R ( const Apl16s * pSrc , int srcStep , const Apl16s value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
AplStatus apliCompareC_32f_C4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[4] , Apl8u * pDst , int dstStep , ApliSize roiSize ,
AplCmpOp aplCmpOp );
Parameters
aplCmpOp Specifies a comparison operation to be performed (aplCmpLess, aplCmpGreater, aplCmpLessEq, aplCmpEq, or aplCmpGreaterEq).
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
AMD Performance Library User’s Manual 321 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer and compare the source data to a specified constant value using a specified
compare operation. The compare operation can be "less than", "less than or equal, "equal", "greater than or equal" or "greater than".
When the comparison evaluates as true, the output data is set to all ones. When the comparison evaluates as false, the output data is
set to all zeroes. Output data is written to a 1-channel Apl8u destination buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 322 Image Processing Library

Publication # 40535 February 2007
CompareEqualEps
Compare floating-point data for equality
Synopsis
AplStatus apliCompareEqualEps_32f_C1R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int
dstStep , ApliSize roiSize , Apl32f eps );
AplStatus apliCompareEqualEps_32f_C3R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int
dstStep , ApliSize roiSize , Apl32f eps );
AplStatus apliCompareEqualEps_32f_C4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int
dstStep , ApliSize roiSize , Apl32f eps );
AplStatus apliCompareEqualEps_32f_AC4R ( const Apl32f * pSrc1 , int src1Step , const Apl32f * pSrc2 , int src2Step , Apl8u * pDst , int
dstStep , ApliSize roiSize , Apl32f eps );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
eps Tolerance value.
pDst Pointer to a location in a destination buffer.
pSrc1 Pointer to a location in source buffer one.
pSrc2 Pointer to a location in source buffer two.
roiSize Specifies the height and width of an ROI.
src1Step Source buffer one step size (width of the buffer in bytes).
src2Step Source buffer two step size (width of the buffer in bytes).
Description
These functions step through ROIs in two floating-point source buffers and compare the data in buffer 1 to the data in buffer 2 for
equality within a specified tolerance. When the difference between the values is less than or equal to the specified tolerance, the
output data is set to all ones. When the difference between the floating-point value and the constant is greater than the specified
tolerance, the output data is set to all zeroes. Output data is written to a 1-channel Apl8u destination buffer.
Return Values
aplStsEpsValErr Eps is a negative value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 323 Image Processing Library

Publication # 40535 February 2007
CompareEqualEpsC
Compare floating-point data to a constant
Synopsis
AplStatus apliCompareEqualEpsC_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f value , Apl8u * pDst , int dstStep , ApliSize roiSize ,
Apl32f eps );
AplStatus apliCompareEqualEpsC_32f_C3R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl8u * pDst , int dstStep , ApliSize
roiSize , Apl32f eps );
AplStatus apliCompareEqualEpsC_32f_AC4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[3] , Apl8u * pDst , int dstStep ,
ApliSize roiSize , Apl32f eps );
AplStatus apliCompareEqualEpsC_32f_C4R ( const Apl32f * pSrc , int srcStep , const Apl32f value[4] , Apl8u * pDst , int dstStep , ApliSize
roiSize , Apl32f eps );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
eps Tolerance value.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
roiSize Specifies the height and width of an ROI.
srcStep Source buffer step size (width of the buffer in bytes).
value Specified value.
value[3] An array of three specified values.
value[4] An array of four specified values.
Description
These functions step through an ROI in a source buffer and compare the source floating-point data for equality within a specified
tolerance. When the difference between the floating-point value and the constant is less than or equal to the specified tolerance, the
output data is set to all ones. When the difference between the floating-point value and the constant is greater than the specified
tolerance, the output data is set to all zeroes. Output data is written to a 1-channel Apl8u destination buffer.
Return Values
aplStsEpsValErr Eps is a negative value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 324 Image Processing Library

Publication # 40535 February 2007
Geometric Transform Functions
This chapter describes functions that warp, shear, resize, mirror, and rotate images.
AMD Performance Library User’s Manual 325 Image Processing Library

Publication # 40535 February 2007
Resize
Resize an image
Synopsis
AplStatus apliResize_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep , ApliSize
dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , int interpolation );
AplStatus apliResize_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , int interpolation );
AMD Performance Library User’s Manual 326 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xFactor Factor value for X axis direction.
yFactor Factor value for Y axis direction .
Description
These functions step through an ROI in a source buffer and map the source data into a destination ROI, using x-y scaling factors and a
specified method of interpolation. A super-sampling interpolation option can be used when both the x and y scaling factors are less
than 1.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 327 Image Processing Library

Publication # 40535 February 2007
ResizeCenter
Resize image relative to center pixel
Synopsis
AplStatus apliResizeCenter_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int
dstStep , ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep
, ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int
dstStep , ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AplStatus apliResizeCenter_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep
, ApliSize dstRoiSize , double xFactor , double yFactor , double xCenter , double yCenter , int interpolation );
AMD Performance Library User’s Manual 328 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xCenter X coordinate of center.
xFactor Factor value for X axis direction.
yCenter Y coordinate of center.
yFactor Factor value for Y axis direction .
Description
These functions step through an ROI in a source buffer and map the source data into a destination ROI using x-y scaling factors and a
specified method of interpolation. The coordinates of the center pixel in the destination image are the same as the center coordinates
of the center pixel in the source image. A super-sampling interpolation option can be used when both the x and y scaling factors are
less than 1. The Resize( ) function is actually a special case of the ResizeCenter( ) function with the image center set at (0,0).
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 329 Image Processing Library

Publication # 40535 February 2007
GetResizeFract
Get resizing fraction
Synopsis
AplStatus apliGetResizeFract ( ApliSize srcSize , ApliRect srcRoi , double xFactor , double yFactor , double* xFr , double* yFr , int
interpolation );
Parameters
interpolation Specifies the method of interpolation.
srcRoi Source image ROI.
srcSize Source image size.
xFactor Factor value for X axis direction.
xFr Inverse factor value for X axis direction.
yFactor Factor value for Y axis direction .
yFr Inverse factor value for Y axis direction .
Description
This function calculates the inverses of x and y scaling factors and checks whether parameters are correctly defined. It is typically used
with the ResizeShift functions.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 330 Image Processing Library

Publication # 40535 February 2007
ResizeShift
Resize and shift an image
Synopsis
AplStatus apliResizeShift_8u_C1R ( const Apl8u * pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u * pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_C1IRSfs ( const Apl16u * pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u * pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliSize
dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AplStatus apliResizeShift_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep ,
ApliSize dstRoiSize , double xFr , double yFr , double xShift , double yShift , int interpolation );
AMD Performance Library User’s Manual 331 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xFr Inverse factor value for X axis direction.
xShift Shift value for X axis direction.
yFr Inverse factor value for Y axis direction .
yShift Shift value for Y axis direction.
Description
These functions step through an ROI in a source buffer, scale the source data using inverse x-y scaling factors and a specified method
of interpolation, then shift the data to a destination ROI.
The functions use the following equivalent mapping formulas.
x=(x?-xShift)*xFr or x’=x*xFactor+xShift
y=(y’-yShift)*yFr y’=y*yFactor+yShift
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 332 Image Processing Library

Publication # 40535 February 2007
ResizeSqrPixelGetBufSize
Calculate external buffer size for ResizeSqrPixel function
Synopsis
AplStatus apliResizeSqrPixelGetBufSize ( ApliSize dstSize , int nChannel , int interpolation , int* pBufferSize );
Parameters
dstSize Destination image size.
interpolation Specifies the method of interpolation.
nChannel Number of channels in the image.
pBufferSize Pointer to the size of a temporary buffer.
Description
This function is used before a ResizeSqrPixel function. It calculates external buffer size, acts as a buffer space placeholder, and checks
whether parameters used by the ResizeSqrPixel function are defined correctly.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsNumChannelErr The number of channels is incorrect.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 333 Image Processing Library

Publication # 40535 February 2007
ResizeSqrPixel
Resize and shift an image
Synopsis
AplStatus apliResizeSqrPixel_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int
dstStep , ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int
dstStep , ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int
dstStep , ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AplStatus apliResizeSqrPixel_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int
dstStep , ApliRect dstRoi , double xFactor , double yFactor , double xShift , double yShift , int interpolation , Apl8u* pBuffer );
AMD Performance Library User’s Manual 334 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pBuffer Pointer to the location of a temporary buffer.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xFactor Factor value for X axis direction.
xShift Shift value for X axis direction.
yFactor Factor value for Y axis direction .
yShift Shift value for Y axis direction.
Description
These functions step through an ROI in a source buffer, scale the source data using x-y scaling factors and a specified method of
interpolation, then shift the data to a destination ROI. Unlike the ResizeShift( ) function, the ResizeSqrPixel( ) functions map the
source ROI to a specified destination ROI and use noninverted x-y scaling factors.
The functions use the following mapping formulas.
x’=x*xFactor+xShift
y’=y*yFactor+yShift
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 335 Image Processing Library

Publication # 40535 February 2007
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectROI The ROI does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 336 Image Processing Library

Publication # 40535 February 2007
ResizeYUV422
Resize a YUV422 image
Synopsis
AplStatus apliResizeYUV422_8u_C2R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliSize dstRoiSize , double xFactor , double yFactor , int interpolation );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xFactor Factor value for X axis direction.
yFactor Factor value for Y axis direction .
Description
This function steps through an ROI in a source buffer, scales the source data using x-y scaling factors and a specified method of
interpolation, then shifts the data to a destination ROI. The function is specialized for YUV color space data with 4:2:2 chroma subsampling.
The source data has two channels in 4:2:2 sampled format with decoupled luminance and chrominance components. For
example, the format could be in the form of alternating YUYVYUYV...
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsResizeFactorErr The resize factor is less than or equal to zero.
aplStsResizeNoOperationErr A destination image dimension is less than one pixel.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 337 Image Processing Library

Publication # 40535 February 2007
Mirror
Mirror an image
Synopsis
AplStatus apliMirror_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C1R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C3R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C4R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_AC4R ( const Apl16u * pSrc , int srcStep , Apl16u * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C1R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C3R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_AC4R ( const Apl32s * pSrc , int srcStep , Apl32s * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_C4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C1IR ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C3IR ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_C4IR ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_16u_AC4IR ( Apl16u * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C1IR ( Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C3IR ( Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_C4IR ( Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32s_AC4IR ( Apl32s * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AplStatus apliMirror_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize roiSize , ApliAxis flip );
AMD Performance Library User’s Manual 338 Image Processing Library

Publication # 40535 February 2007
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
flip Image mirror flip mode.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
roiSize Specifies the height and width of an ROI.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer and mirror the source data about the vertical axis, the horizontal axis, or both
axes. The mirrored data can be written to a destination buffer or written back to the source buffer.
Return Values
aplStsMirrorFlipErr The mirror flip value is invalid.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 339 Image Processing Library

Publication # 40535 February 2007
Remap
Remap an image using table look-up
Synopsis
AplStatus apliRemap_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl32f* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl32f* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl32f* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl32f* pDst , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst[3] , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep ,
const Apl32f* pyMap , int yMapStep , Apl8u* pDst[4] , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep
, const Apl32f* pyMap , int yMapStep , Apl32f* pDst[3] , int dstStep , ApliSize dstRoiSize , int interpolation );
AplStatus apliRemap_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const Apl32f* pxMap , int xMapStep
, const Apl32f* pyMap , int yMapStep , Apl32f* pDst[4] , int dstStep , ApliSize dstRoiSize , int interpolation );
AMD Performance Library User’s Manual 340 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
pxMap Pointer to X axis mapping table array.
pyMap Pointer to Y axis mapping table array.
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xMapStep X axis mapping table step size (width of the buffer in bytes).
yMapStep Y axis mapping table step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, remap the source data using look-up tables for the x and y coordinates of each
pixel and a specified method of interpolation, then write the data into a destination ROI.
The mapping formula is
dst_pixel[x,y] = src_pixel[pxMap[x,y], pyMap[x,y]],
where pxMap[x,y] is the x-coordinate look up table and pyMap[x,y] is the y-coordinate look-up table.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 341 Image Processing Library

Publication # 40535 February 2007
Rotate
Rotate an image
Synopsis
AplStatus apliRotate_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AplStatus apliRotate_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep ,
ApliRect dstRoi , double angle , double xShift , double yShift , int interpolation );
AMD Performance Library User’s Manual 342 Image Processing Library

Publication # 40535 February 2007
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xShift Shift value for X axis direction.
yShift Shift value for Y axis direction.
Description
These functions step through an ROI in a source buffer, rotate the source data around (0,0) by a specified angle, shift the x-y
coordinates according to the x and y shift values, and map the data into a destination ROI using a specified method of interpolation.
The APLI_SMOOTH_EDGE option is available when the destination ROI contains the transformed image. Depending on the x-y
coordinate values and the amount of rotation, the rotated image may be clipped by the destination ROI boundary. Note: A positive
angle value indicates counterclockwise rotation when source data is ordered downward for height.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 343 Image Processing Library

Publication # 40535 February 2007
GetRotateShift
Get rotation shift values
Synopsis
AplStatus apliGetRotateShift ( double xCenter , double yCenter , double angle , double* xShift , double* yShift );
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
xCenter X coordinate of center.
xShift Shift value for X axis direction.
yCenter Y coordinate of center.
yShift Shift value for Y axis direction.
Description
This function computes shift values for the RotateCenter functions.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 344 Image Processing Library

Publication # 40535 February 2007
AddRotateShift
Add new rotation shift values to existing shift values
Synopsis
AplStatus apliAddRotateShift ( double xCenter , double yCenter , double angle , double* xShift , double* yShift );
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
xCenter X coordinate of center.
xShift Shift value for X axis direction.
yCenter Y coordinate of center.
yShift Shift value for Y axis direction.
Description
This function adds specified shift values to existing shift values for the RotateCenter functions.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 345 Image Processing Library

Publication # 40535 February 2007
GetRotateQuad
Get rotation quadrangle vertices
Synopsis
AplStatus apliGetRotateQuad ( ApliRect srcRoi , double quad[4][2] , double angle , double xShift , double yShift );
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
xShift Shift value for X axis direction.
yShift Shift value for Y axis direction.
Description
This function is used with the GetRotateBound function. It computes the vertex coordinates of the quadrangular destination ROI for the
Rotate( ) functions. Quad[0] contains the top right x and y coordinates, Quad[1] contains the top left x and y coordinates, Quad[2]
contains the bottom right x and y coordinates, and Quad[3] contains the bottom left x and y coordinates.
Return Values
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 346 Image Processing Library

Publication # 40535 February 2007
GetRotateBound
Get rotation boundary
Synopsis
AplStatus apliGetRotateBound ( ApliRect srcRoi , double bound[2][2] , double angle , double xShift , double yShift );
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
srcRoi Source image ROI.
xShift Shift value for X axis direction.
yShift Shift value for Y axis direction.
Description
This function is used with the GetRotateQuad( ) function. It computes the boundaries of the source ROI for the Rotate( ) functions.
Bound[0] contains the top right x and y coordinates; Bound[1] contains the bottom left x and y coordinates.
Return Values
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 347 Image Processing Library

Publication # 40535 February 2007
RotateCenter
Rotate around a specific center
Synopsis
AplStatus apliRotateCenter_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int
dstStep , ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int
dstStep , ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep
, ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AplStatus apliRotateCenter_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep
, ApliRect dstRoi , double angle , double xCenter , double yCenter , int interpolation );
AMD Performance Library User’s Manual 348 Image Processing Library

Publication # 40535 February 2007
Parameters
angle Specifies the rotation angle in degrees, counterclockwise.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xCenter X coordinate of center.
yCenter Y coordinate of center.
Description
These functions step through a source ROI, rotate the source data around a specified center by a specified angle, apply a specified
method of interpolation, then write the rotated data to a destination ROI. Positive angle parameter values specify counterclockwise
rotation.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 349 Image Processing Library

Publication # 40535 February 2007
Shear
Perform shear transform
Synopsis
AplStatus apliShear_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep , ApliRect
dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep ,
ApliRect dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AplStatus apliShear_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep ,
ApliRect dstRoi , double xShear , double yShear , double xShift , double yShift , int interpolation );
AMD Performance Library User’s Manual 350 Image Processing Library

Publication # 40535 February 2007
Parameters
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
xShear Shear value for X axis in Shear transformation.
xShift Shift value for X axis direction.
yShear Shear value for Y axis in Shear transformation.
yShift Shift value for Y axis direction.
Description
These functions step through a source ROI, perform the shear transform on the source data, apply a specified method of interpolation,
and write the data to a destination ROI.
The shear transform formula is as follows.
x’ = xShear * y + x + xShift
y’ = yShear * x + y + yShift
Where x’ and y’ are the destination coordinates.
The shear transform is a special case of the warp affine transform.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 351 Image Processing Library

Publication # 40535 February 2007
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 352 Image Processing Library

Publication # 40535 February 2007
GetShearQuad
Get shear quadrangle vertices
Synopsis
AplStatus apliGetShearQuad ( ApliRect srcRoi , double quad[4][2] , double xShear , double yShear , double xShift , double yShift );
Parameters
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
xShear Shear value for X axis in Shear transformation.
xShift Shift value for X axis direction.
yShear Shear value for Y axis in Shear transformation.
yShift Shift value for Y axis direction.
Description
This function is used with the GetShearBound function. It computes the vertex coordinates of the quadrangular destination ROI for the
Shear( ) functions. Quad[0] contains the top right x and y coordinates, Quad[1] contains the top left x and y coordinates, Quad[2]
contains the bottom right x and y coordinates, and Quad[3] contains the bottom left x and y coordinates.
Return Values
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 353 Image Processing Library

Publication # 40535 February 2007
GetShearBound
Get shear boundary
Synopsis
AplStatus apliGetShearBound ( ApliRect srcRoi , double bound[2][2] , double xShear , double yShear , double xShift , double yShift );
Parameters
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
srcRoi Source image ROI.
xShear Shear value for X axis in Shear transformation.
xShift Shift value for X axis direction.
yShear Shear value for Y axis in Shear transformation.
yShift Shift value for Y axis direction.
Description
This function is used with the GetShearQuad( ) function. It computes the boundaries of the source ROI for the Shear( ) functions.
Bound[0] contains the top right x and y coordinates; Bound[1] contains the bottom left x and y coordinates.
Return Values
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 354 Image Processing Library

Publication # 40535 February 2007
WarpAffine
Perform warp affine transform
Synopsis
AplStatus apliWarpAffine_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep , ApliRect
dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffine_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AMD Performance Library User’s Manual 355 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[2][3] Coefficients for Warp Affine transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform the warp affine transform on the source data, apply a specified method of
interpolation, and write the data to a destination ROI.
The transformation formula is as follows.
x’ = c00*x + c01*y + c02
y’ = c10*x + c11*y + c12
Where x’ and y’ are the destination coordinates and Cij are the warp affine transform coefficients that are passed into the array. The
warp affine transform is a general linear transformation that maps parallel lines to parallel lines.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 356 Image Processing Library

Publication # 40535 February 2007
WarpAffineBack
Perform inverse warp affine transform
Synopsis
AplStatus apliWarpAffineBack_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_C1R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_C3R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_C4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_AC4R ( const Apl16u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep
, ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep
, ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_P3R ( const Apl16u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_16u_P4R ( const Apl16u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl16u* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AplStatus apliWarpAffineBack_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[2][3] , int interpolation );
AMD Performance Library User’s Manual 357 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[2][3] Coefficients for Warp Affine transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform an inverse warp affine transform on the source data, apply a specified method of
interpolation, and write the data to a destination ROI.
The transformation formula is as follows.
c00*x’ + c01*y’ + c02 = x
c10*x’ + c11*y’ + c12 = y
Where cij represents the transform coefficients.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 358 Image Processing Library

Publication # 40535 February 2007
WarpAffineQuad
Perform quadrangular warp affine transform
Synopsis
AplStatus apliWarpAffineQuad_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2] ,
Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl8u* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl8u* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpAffineQuad_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AMD Performance Library User’s Manual 359 Image Processing Library

Publication # 40535 February 2007
Parameters
dstQuad[4][2] Destination quadrangle vertex coordinates.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcQuad[4][2] Source quadrangle vertex coordinates.
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a quadrangular source ROI, perform the warp affine transform on the source data, and map the
transformed data into a quadrangular destination ROI using a specified method of interpolation. The warp affine coefficients are
calculated using the quadrangle vertices. If the coefficients cannot be resolved consistently, the function returns errors.
Return Values
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsQuadErr
The source or destination quadrangle degenerates into a triangle, line, or points; or the destination quadrangle has
conflicted vertex coordinates.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 360 Image Processing Library

Publication # 40535 February 2007
GetAffineQuad
Get affine quadrangle vertices
Synopsis
AplStatus apliGetAffineQuad ( ApliRect srcRoi , double quad[4][2] , const double coeffs[2][3] );
Parameters
coeffs[2][3] Coefficients for Warp Affine transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function is used with the GetAffineBound function. It computes the vertex coordinates of the quadrangular destination ROI for the
WarpAffineQuad( ) functions. Quad[0] contains the top right x and y coordinates, Quad[1] contains the top left x and y coordinates,
Quad[2] contains the bottom right x and y coordinates, and Quad[3] contains the bottom left x and y coordinates.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 361 Image Processing Library

Publication # 40535 February 2007
GetAffineBound
Get affine boundary
Synopsis
AplStatus apliGetAffineBound ( ApliRect srcRoi , double bound[2][2] , const double coeffs[2][3] );
Parameters
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
coeffs[2][3] Coefficients for Warp Affine transform.
srcRoi Source image ROI.
Description
This function is used with the GetAffineQuad( ) function. It computes the boundaries of the source ROI for the WarpAffineQuad( )
functions. Bound[0] contains the top right x and y coordinates; Bound[1] contains the bottom left x and y coordinates.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 362 Image Processing Library

Publication # 40535 February 2007
GetAffineTransform
Get affine transform coefficients
Synopsis
AplStatus apliGetAffineTransform ( ApliRect srcRoi , const double quad[4][2] , double coeffs[2][3] );
Parameters
coeffs[2][3] Coefficients for Warp Affine transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function computes affine transform coefficients for the WarpAffineQuad( ) functions. Quad[0] corresponds to the top right
coordinates of the source ROI, Quad[1] corresponds to the top left coordinates of the source ROI, Quad[2] corresponds to the bottom
right coordinates of the source ROI, and Quad[3] corresponds to the bottom left coordinates of the source ROI. The function returns
aplstsCoeffErr if the mapping is incorrect.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 363 Image Processing Library

Publication # 40535 February 2007
WarpPerspective
Perform warp perspective transform
Synopsis
AplStatus apliWarpPerspective_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspective_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AMD Performance Library User’s Manual 364 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform the warp perspective transform on the source data, apply a specified method of
interpolation, and write the data to a destination ROI.
The transformation formula is as follows.
x’ = (c00*x + c01*y + c02)/(c20*x + c21*y + c22)
y’ = (c10*x + c11*y + c12)/(c20*x + c21*y + c22)
Where x’ and y’ are the destination coordinates and Cij are transform coefficients that are passed into the array.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 365 Image Processing Library

Publication # 40535 February 2007
WarpPerspectiveBack
Perform inverse warp perspective transform
Synopsis
AplStatus apliWarpPerspectiveBack_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] ,
int dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AplStatus apliWarpPerspectiveBack_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] ,
int dstStep , ApliRect dstRoi , const double coeffs[3][3] , int interpolation );
AMD Performance Library User’s Manual 366 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform an inverse warp perspective transform on the source data, apply a specified
method of interpolation, and write the data to a destination ROI. Edge smoothing interpolation is applicable only when the destination
quadrangle is completely within the destination image ROI.
The transformation formula is as follows.
(c00*x’ + c01*y’ + c02)/(c20*x’ + c21*y’ + c22) = x
(c10*x’ + c11*y’ + c12)/(c20*x’ + c21*y’ + c22) = y
Where cij represents the transform coefficients.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 367 Image Processing Library

Publication # 40535 February 2007
WarpPerspectiveQuad
Perform quadrangular warp perspective transform
Synopsis
AplStatus apliWarpPerspectiveQuad_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpPerspectiveQuad_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AMD Performance Library User’s Manual 368 Image Processing Library

Publication # 40535 February 2007
Parameters
dstQuad[4][2] Destination quadrangle vertex coordinates.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcQuad[4][2] Source quadrangle vertex coordinates.
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a quadrangular source ROI, perform the warp perspective transform on the source data, and map the
transformed data into a quadrangular destination ROI using a specified method of interpolation. Edge smoothing interpolation is
applicable only when the destination quadrangle is completely within the destination ROI. The warp perspective coefficients are
calculated using the quadrangle vertices. If the coefficients cannot be resolved consistently, the function returns errors.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 369 Image Processing Library

Publication # 40535 February 2007
GetPerspectiveQuad
Get perspective quadrangle vertices
Synopsis
AplStatus apliGetPerspectiveQuad ( ApliRect srcRoi , double quad[4][2] , const double coeffs[3][3] );
Parameters
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function is used with the GetPerspectiveBound function. It computes the vertex coordinates of the quadrangular destination ROI
for the WarpPerspectiveQuad( ) functions. Quad[0] contains the top right x and y coordinates, Quad[1] contains the top left x and y
coordinates, Quad[2] contains the bottom right x and y coordinates, and Quad[3] contains the bottom left x and y coordinates.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 370 Image Processing Library

Publication # 40535 February 2007
GetPerspectiveBound
Get perspective boundary
Synopsis
AplStatus apliGetPerspectiveBound ( ApliRect srcRoi , double bound[2][2] , const double coeffs[3][3] );
Parameters
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
srcRoi Source image ROI.
Description
This function is used with the GetPerspectiveQuad( ) function. It computes the boundaries of the source ROI for the
WarpPerspectiveQuad( ) functions. Bound[0] contains the top right x and y coordinates; Bound[1] contains the bottom left x and y
coordinates.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 371 Image Processing Library

Publication # 40535 February 2007
GetPerspectiveTransform
Get the perspective transform coefficients
Synopsis
AplStatus apliGetPerspectiveTransform ( ApliRect srcRoi , const double quad[4][2] , double coeffs[3][3] );
Parameters
coeffs[3][3] Coefficients for Warp Affine Perspective transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function computes perspective transform coefficients for the WarpPerspectiveQuad( ) functions. Quad[0] corresponds to the
top right coordinates of the source ROI, Quad[1] corresponds to the top left coordinates of the source ROI, Quad[2] corresponds to the
bottom right coordinates of the source ROI, and Quad[3] corresponds to the bottom left coordinates of the source ROI. The function
returns aplstsCoeffErr if the mapping is incorrect.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 372 Image Processing Library

Publication # 40535 February 2007
WarpBilinear
Perform warp bilinear transform
Synopsis
AplStatus apliWarpBilinear_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int dstStep
, ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinear_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int dstStep
, ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AMD Performance Library User’s Manual 373 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform the warp bilinear transform on the source data, apply a specified method of
interpolation, and write the data to a destination ROI.
The transformation formula is as follows.
x’ = c00*xy + c01*x + c02*y + c03
y’ = c10*xy + c11*x + c12*y + c13
Where x’ and y’ are the destination coordinates and Cij are transform coefficients that are passed into the array.
Note: The warp bilinear transform is not a true linear transform. It does not preserve distance relationships.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 374 Image Processing Library

Publication # 40535 February 2007
WarpBilinearBack
Perform inverse warp bilinear transform
Synopsis
AplStatus apliWarpBilinearBack_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep ,
ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst , int dstStep
, ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl8u* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[3] , int
dstStep , ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AplStatus apliWarpBilinearBack_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , Apl32f* pDst[4] , int
dstStep , ApliRect dstRoi , const double coeffs[2][4] , int interpolation );
AMD Performance Library User’s Manual 375 Image Processing Library

Publication # 40535 February 2007
Parameters
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a source ROI, perform an inverse warp bilinear transform on the source data, apply a specified method of
interpolation, and write the data to a destination ROI. Edge smoothing interpolation is applicable only when the destination quadrangle
is completely within the destination image ROI.
The transformation formula is as follows.
c00*x’y’ + c01*x’ + c02*y’ + c03 = x
c10*x’y’ + c11*x’ + c12*y’ + c13 = y
Where cij represents the transform coefficients.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 376 Image Processing Library

Publication # 40535 February 2007
WarpBilinearQuad
Perform quadrangular warp bilinear transform
Synopsis
AplStatus apliWarpBilinearQuad_8u_C1R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_8u_C3R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_8u_C4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double srcQuad[4][2]
, Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_8u_AC4R ( const Apl8u* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_C1R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_C3R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_C4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_AC4R ( const Apl32f* pSrc , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_8u_P3R ( const Apl8u* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_8u_P4R ( const Apl8u* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl8u* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_P3R ( const Apl32f* pSrc[3] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[3] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AplStatus apliWarpBilinearQuad_32f_P4R ( const Apl32f* pSrc[4] , ApliSize srcSize , int srcStep , ApliRect srcRoi , const double
srcQuad[4][2] , Apl32f* pDst[4] , int dstStep , ApliRect dstRoi , const double dstQuad[4][2] , int interpolation );
AMD Performance Library User’s Manual 377 Image Processing Library

Publication # 40535 February 2007
Parameters
dstQuad[4][2] Destination quadrangle vertex coordinates.
dstRoi Destination image ROI.
dstStep Destination buffer step size (width of the buffer in bytes).
interpolation Specifies the method of interpolation.
pDst Pointer to a location in a destination buffer.
pDst[3] Pointer to a location in a three-channel planar destination buffer (array values point to a location in each plane).
pDst[4] Pointer to a location in a four-channel planar destination buffer (array values point to a location in each plane).
pSrc Pointer to a location in a source buffer.
pSrc[3] Pointer to a location in a three-channel planar source buffer (array values point to a location in each plane).
pSrc[4] Pointer to a location in a four-channel planar source buffer (array values point to a location in each plane).
srcQuad[4][2] Source quadrangle vertex coordinates.
srcRoi Source image ROI.
srcSize Source image size.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a quadrangular source ROI, perform the warp bilinear transform on the source data, and map the
transformed data into a quadrangular destination ROI using a specified method of interpolation. Edge smoothing interpolation is
applicable only when the destination quadrangle is completely within the destination ROI. The warp perspective coefficients are
calculated using the quadrangle vertices. If the coefficients cannot be resolved consistently, the function returns errors.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsInterpolationErr The interpolation value is incorrect or unsupported for the specified function.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
aplStsWrongIntersectQuad The quadrangle does not intersect the source or destination image (no operation is performed).
AMD Performance Library User’s Manual 378 Image Processing Library

Publication # 40535 February 2007
GetBilinearQuad
Get bilinear quadrangle vertices
Synopsis
AplStatus apliGetBilinearQuad ( ApliRect srcRoi , double quad[4][2] , const double coeffs[2][4] );
Parameters
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function is used with the GetBilinearBound function. It computes the vertex coordinates of the quadrangular destination ROI for
the WarpBilinearQuad( ) functions. Quad[0] contains the top right x and y coordinates, Quad[1] contains the top left x and y
coordinates, Quad[2] contains the bottom right x and y coordinates, and Quad[3] contains the bottom left x and y coordinates.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 379 Image Processing Library

Publication # 40535 February 2007
GetBilinearBound
Get bilinear boundary
Synopsis
AplStatus apliGetBilinearBound ( ApliRect srcRoi , double bound[2][2] , const double coeffs[2][4] );
Parameters
bound[2][2] Boundary rectangle vertex coordinates for a transformed source ROI.
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
srcRoi Source image ROI.
Description
This function is used with the GetBilinearQuad( ) function. It computes the boundaries of the source ROI for the
WarpBilinearQuad( ) functions. Bound[0] contains the top right x and y coordinates; Bound[1] contains the bottom left x and y
coordinates.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 380 Image Processing Library

Publication # 40535 February 2007
GetBilinearTransform
Get the bilinear transform coefficients
Synopsis
AplStatus apliGetBilinearTransform ( ApliRect srcRoi , const double quad[4][2] , double coeffs[2][4] );
Parameters
coeffs[2][4] Coefficients for Warp Affine Bilinear transform.
quad[4][2] Quadrangle vertex coordinates.
srcRoi Source image ROI.
Description
This function computes bilinear transform coefficients for the WarpBilinearQuad( ) functions. Quad[0] corresponds to the top right
coordinates of the source ROI, Quad[1] corresponds to the top left coordinates of the source ROI, Quad[2] corresponds to the bottom
right coordinates of the source ROI, and Quad[3] corresponds to the bottom left coordinates of the source ROI. The function returns
aplstsCoeffErr if the mapping is incorrect.
Return Values
aplStsCoeffErr The coefficient values have errors.
aplStsNoErr No error detected.
aplStsRectErr The width or height of the source ROI has a value less than or equal to one.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
AMD Performance Library User’s Manual 381 Image Processing Library

Publication # 40535 February 2007
Digital Filter Functions
This chapter describes functions that alter frequency-related visual properties of images such as sharpness and contrast.
AMD Performance Library User’s Manual 382 Image Processing Library

Publication # 40535 February 2007
Sharpen
Sharpen
Synopsis
AplStatus apliFilterSharpen_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSharpen_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a sharpening filter to the source data, and write the result to a
destination buffer. The functions use a fixed 3X3 mask.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 383 Image Processing Library

Publication # 40535 February 2007
FilterBox
Blur
Synopsis
AplStatus apliFilterBox_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterBox_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 384 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, apply a box blur filter to the source data, and write the filtered data to a
destination buffer. The functions can use arbitrary mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 385 Image Processing Library

Publication # 40535 February 2007
FilterBoxInplace
Blur in place
Synopsis
AplStatus apliFilterBox_8u_C1IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_8u_C3IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_8u_C4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_8u_AC4IR ( Apl8u * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_16s_C1IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_16s_C3IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_16s_C4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_16s_AC4IR ( Apl16s * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_32f_C1IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_32f_C3IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_32f_C4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
AplStatus apliFilterBox_32f_AC4IR ( Apl32f * pSrcDst , int srcDstStep , ApliSize dstRoiSize , ApliSize maskSize , ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
maskSize Size of the mask used in the calculations.
pSrcDst Pointer to a location in a buffer that contains both the source and destination.
srcDstStep Source and destination buffer step size in bytes (width of both buffers in bytes).
Description
These functions step through an ROI in a source buffer, apply a box blur filter to the source data, and write the filtered data back to
the same location. The functions can use arbitrary mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 386 Image Processing Library

Publication # 40535 February 2007
FilterMin
Filter with minimum value in mask
Synopsis
AplStatus apliFilterMin_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMin_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 387 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the smallest pixel value in the area
defined by the mask size, and write the filtered data to a destination buffer. The functions decrease image contrast. The functions can
use arbitrary mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 388 Image Processing Library

Publication # 40535 February 2007
FilterMax
Filter with maximum value in mask
Synopsis
AplStatus apliFilterMax_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize
, ApliPoint anchor );
AplStatus apliFilterMax_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMax_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 389 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the largest pixel value in the area defined
by the mask size, and write the filtered data to a destination buffer. The functions increase image contrast. The functions can use
arbitrary mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 390 Image Processing Library

Publication # 40535 February 2007
SumWindowRow
Sum pixel values in row mask
Synopsis
AplStatus apliSumWindowRow_8u32f_C1R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowRow_8u32f_C3R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowRow_8u32f_C4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowRow_16s32f_C1R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowRow_16s32f_C3R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowRow_16s32f_C4R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the sum of the values of all pixels in the
area defined by the mask, and write the filtered data to a destination buffer. The functions can use arbitrary horizontal row mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 391 Image Processing Library

Publication # 40535 February 2007
SumWindow
Sum pixel values in column mask
Synopsis
AplStatus apliSumWindowColumn_8u32f_C1R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowColumn_8u32f_C3R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowColumn_8u32f_C4R ( const Apl8u * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowColumn_16s32f_C1R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowColumn_16s32f_C3R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
AplStatus apliSumWindowColumn_16s32f_C4R ( const Apl16s * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , int
maskSize , int anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the sum of the values of all pixels in the
area defined by the mask, and write the filtered data to a destination buffer. The functions can use arbitrary horizontal row mask sizes.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 392 Image Processing Library

Publication # 40535 February 2007
FilterMedian
Filter with median value in mask
Synopsis
AplStatus apliFilterMedian_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMedian_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMedian_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize ,
ApliPoint anchor );
AplStatus apliFilterMedian_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliSize maskSize
, ApliPoint anchor );
AplStatus apliFilterMedian_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize
maskSize , ApliPoint anchor );
AplStatus apliFilterMedian_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize
maskSize , ApliPoint anchor );
AplStatus apliFilterMedian_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize
maskSize , ApliPoint anchor );
AplStatus apliFilterMedian_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliSize
maskSize , ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the median value of all pixels in the area
defined by the mask, and write the filtered data to a destination buffer. The functions remove noise without decreasing image
brightness, as averaging filters do.
AMD Performance Library User’s Manual 393 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 394 Image Processing Library

Publication # 40535 February 2007
FilterMedianHoriz
Filter with median value in horizontal mask
Synopsis
AplStatus apliFilterMedianHoriz_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianHoriz_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianHoriz_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianHoriz_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianHoriz_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianHoriz_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianHoriz_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianHoriz_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the median value of all pixels in the area
defined by the horizontal mask, and write the filtered data to a destination buffer. The functions remove noise without decreasing
image brightness, as averaging filters do. The functions can use arbitrary horizontal mask sizes.
AMD Performance Library User’s Manual 395 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 396 Image Processing Library

Publication # 40535 February 2007
FilterMedianVert
Filter with median value in vertical mask
Synopsis
AplStatus apliFilterMedianVert_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianVert_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianVert_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianVert_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianVert_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianVert_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianVert_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianVert_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the median value of all pixels in the area
defined by the vertical mask, and write the filtered data to a destination buffer. The functions remove noise without decreasing image
brightness, as averaging filters do. The functions can use arbitrary vertical mask sizes.
AMD Performance Library User’s Manual 397 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 398 Image Processing Library

Publication # 40535 February 2007
FilterMedianCross
Filter with median value in cross mask
Synopsis
AplStatus apliFilterMedianCross_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianCross_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianCross_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianCross_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianCross_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianCross_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the median value of all pixels in the area
defined by the cross mask, and write the filtered data to a destination buffer. The functions remove noise without decreasing image
brightness, as averaging filters do. The functions can use arbitrary cross mask sizes.
AMD Performance Library User’s Manual 399 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsMemAllocErr The function failed to allocate memory.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 400 Image Processing Library

Publication # 40535 February 2007
FilterMedianColor
Filter color with median value in mask
Synopsis
AplStatus apliFilterMedianColor_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterMedianColor_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianColor_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianColor_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianColor_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
AplStatus apliFilterMedianColor_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, replace each source pixel value with the value of the pixel nearest to the
source pixel in the area defined by the mask, and write the filtered data to a destination buffer. The functions remove noise without
decreasing image brightness, as averaging filters do, while preserving the correlation between color components.
The distance between the source and mask pixels is calculated as a sum of absolute values using the following formula.
bs(R(i)-R(j)) + abs(G(i)-G(j)) + abs(B(i)-B(j)).
AMD Performance Library User’s Manual 401 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 402 Image Processing Library

Publication # 40535 February 2007
Filter
Filter with an integer rectangular kernel
Synopsis
AplStatus apliFilter_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel ,
ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel
, ApliSize kernelSize , ApliPoint anchor , int divisor );
AplStatus apliFilter_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
divisor An integer value by which the result is divided.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 403 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, calculate the sum of products of the kernel values and the corresponding pixel
values in an area defined by the kernel size and anchor coordinate, then divide by the divisor. The filtered data is written to a
destination buffer. The kernel is an array of signed 32-bit integer values; the anchor coordinate location is relative to the bottom right
corner of the kernel.
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 404 Image Processing Library

Publication # 40535 February 2007
Filter32f
Filter integer values with a floating-point rectangular kernel
Synopsis
AplStatus apliFilter32f_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel ,
ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f * pKernel
, ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , ApliSize kernelSize , ApliPoint anchor );
AplStatus apliFilter32f_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , ApliSize kernelSize , ApliPoint anchor );
Parameters
anchor A pixel locating the kernel (mask) according to source image.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, and calculate the sum of products of the kernel values and the corresponding
pixel values in an area defined by the kernel size and anchor coordinate. The filtered data is written to a destination buffer. The kernel
is an array of 32-bit single-precision floating point values; the anchor coordinate location is relative to the bottom right corner of the
kernel.
AMD Performance Library User’s Manual 405 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 406 Image Processing Library

Publication # 40535 February 2007
FilterColumn
Filter with an integer vertical column kernel
Synopsis
AplStatus apliFilterColumn_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s
* pKernel , int kernelSize , int yAnchor , int divisor );
AplStatus apliFilterColumn_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
Parameters
divisor An integer value by which the result is divided.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
yAnchor Anchor cell that specifies the vertical alignment of the kernel with respect to the input pixel.
AMD Performance Library User’s Manual 407 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, calculate the sum of products of the kernel values and the corresponding pixel
values in an area defined by the kernel size and anchor coordinate, then divide by the divisor. The filtered data is written to a
destination buffer. The vertical column kernel is an array of signed 32-bit integer values; the anchor coordinate location is relative to
the bottom of the kernel. Functions that operate on 8-bit unsigned data assume that the kernel values are small (in the -4096 to 4096
range). The results of the intermediate calculations exceed 24 bits, calculation errors may occur. Also, for very small kernel values, the
functions use very fast code, at the expense of accuracy (+/- 1.5).
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 408 Image Processing Library

Publication # 40535 February 2007
FilterColumn32f
Filter integer values with a floating-point vertical column kernel
Synopsis
AplStatus apliFilterColumn32f_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f
* pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f
* pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f
* pKernel , int kernelSize , int yAnchor );
AplStatus apliFilterColumn32f_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const
Apl32f * pKernel , int kernelSize , int yAnchor );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
yAnchor Anchor cell that specifies the vertical alignment of the kernel with respect to the input pixel.
Description
These functions step through an ROI in a source buffer, and calculate the sum of products of the kernel values and the corresponding
pixel values in an area defined by the kernel size and anchor coordinate. The filtered data is written to a destination buffer. The
vertical column kernel is an array of 32-bit single-precision floating point values; the anchor coordinate location is relative to the
bottom of the kernel.
AMD Performance Library User’s Manual 409 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 410 Image Processing Library

Publication # 40535 February 2007
FilterRow
Filter with an integer horizontal row kernel
Synopsis
AplStatus apliFilterRow_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel
, int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel
, int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s * pKernel
, int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32s *
pKernel , int kernelSize , int xAnchor , int divisor );
AplStatus apliFilterRow_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
Parameters
divisor An integer value by which the result is divided.
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
xAnchor Anchor cell that specifies the horizontal alignment of the kernel with respect to the input pixel.
AMD Performance Library User’s Manual 411 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, calculate the sum of products of the kernel values and the corresponding pixel
values in an area defined by the kernel size and anchor coordinate, then divide by the divisor. The filtered data is written to a
destination buffer. The horizontal row kernel is an array of signed 32-bit integer values; the anchor coordinate location is relative to
the right side of the kernel. Functions that operate on 8-bit unsigned data assume that the kernel values are small. If the results of
intermediate calculations exceed 24 bits, calculation errors may occur. Also, for very small kernel values, the functions use very fast
code, at the expense of accuracy (+/- 1.5).
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 412 Image Processing Library

Publication # 40535 February 2007
FilterRow32f
Filter integer values with a floating-point horizontal row kernel
Synopsis
AplStatus apliFilterRow32f_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
AplStatus apliFilterRow32f_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , const Apl32f *
pKernel , int kernelSize , int xAnchor );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
kernelSize Size of the kernel used in the calculations.
pDst Pointer to a location in a destination buffer.
pKernel Pointer to the kernel array.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
xAnchor Anchor cell that specifies the horizontal alignment of the kernel with respect to the input pixel.
Description
These functions step through an ROI in a source buffer, and calculate the sum of products of the kernel values and the corresponding
pixel values in an area defined by the kernel size and anchor coordinate. The filtered data is written to a destination buffer. The
horizontal row kernel is an array of 32-bit single-precision floating point values; the anchor coordinate location is relative to the right
side of the kernel.
AMD Performance Library User’s Manual 413 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsAnchorErr The anchor is located out of the mask.
aplStsMaskSizeErr The mask has an invalid value.
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 414 Image Processing Library

Publication # 40535 February 2007
FilterPrewittHoriz
Filter with a horizontal Prewitt kernel
Synopsis
AplStatus apliFilterPrewittHoriz_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittHoriz_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a horizontal Prewitt operator to the source data, and write the filtered
data to a destination buffer. The functions enhance the horizontal edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 415 Image Processing Library

Publication # 40535 February 2007
FiltePrewittVert
Filter with a vertical Prewitt kernel
Synopsis
AplStatus apliFilterPrewittVert_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterPrewittVert_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a vertical Prewitt operator to the source data, and write the filtered data
to a destination buffer. The functions enhance the vertical edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 416 Image Processing Library

Publication # 40535 February 2007
FilterScharrHoriz
Filter with a horizontal Scharr kernel
Synopsis
AplStatus apliFilterScharrHoriz_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterScharrHoriz_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterScharrHoriz_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a horizontal Scharr operator to the source data, and write the filtered
data to a destination buffer. These functions enhance and smooth the horizontal edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 417 Image Processing Library

Publication # 40535 February 2007
FilterScharrVert
Filter with a vertical Scharr kernel
Synopsis
AplStatus apliFilterScharrVert_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterScharrVert_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterScharrVert_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a vertical Scharr operator to the source data, and write the filtered data
to a destination buffer. These functions enhance and smooth the vertical edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 418 Image Processing Library

Publication # 40535 February 2007
FilterSobelHoriz
Filter with a horizontal Sobel kernel
Synopsis
AplStatus apliFilterSobelHoriz_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelHoriz_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelHoriz_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelHorizMask_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
mask An analysis window (only non-zero mask array values are processed).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a horizontal Sobel operator to the source data, and write the filtered
data to a destination buffer. These functions enhance and smooth the horizontal edges of an image.
AMD Performance Library User’s Manual 419 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 420 Image Processing Library

Publication # 40535 February 2007
FilterSobelVert
Filter with a vertical Sobel kernel
Synopsis
AplStatus apliFilterSobelVert_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterSobelVert_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelVert_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelVertMask_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
mask An analysis window (only non-zero mask array values are processed).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a vertical Sobel operator to the source data, and write the filtered data
to a destination buffer. These functions enhance and smooth the horizontal edges of an image.
AMD Performance Library User’s Manual 421 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 422 Image Processing Library

Publication # 40535 February 2007
FilterSobelHorizSecond
Filter with a second derivative horizontal Sobel kernel
Synopsis
AplStatus apliFilterSobelHorizSecond_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelHorizSecond_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelHorizSecond_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
mask An analysis window (only non-zero mask array values are processed).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a second derivative horizontal Sobel operator to the source data, and
write the filtered data to a destination buffer. These functions enhance and smooth the horizontal edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 423 Image Processing Library

Publication # 40535 February 2007
FilterSobelVertSecond
Filter with a second derivative vertical Sobel kernel
Synopsis
AplStatus apliFilterSobelVertSecond_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelVertSecond_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelVertSecond_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
mask An analysis window (only non-zero mask array values are processed).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a second derivative vertical Sobel operator to the source data, and write
the filtered data to a destination buffer. These functions enhance and smooth the horizontal edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 424 Image Processing Library

Publication # 40535 February 2007
FilterSobelCross
Filter with a second cross derivative Sobel kernel
Synopsis
AplStatus apliFilterSobelCross_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelCross_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize ,
ApliMaskSize mask );
AplStatus apliFilterSobelCross_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
mask );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
mask An analysis window (only non-zero mask array values are processed).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a second cross derivative Sobel operator to the source data, and write
the filtered data to a destination buffer. The functions operate on either a 3X3 or 5X5 mask. These functions enhance and smooth the
horizontal edges of an image.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 425 Image Processing Library

Publication # 40535 February 2007
FilterRobertsDown
Filter with a horizontal Roberts kernel
Synopsis
AplStatus apliFilterRobertsDown_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsDown_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a horizontal Roberts operator to the source data, and write the filtered
data to a destination buffer. These functions provide a gross approximation of the horizontal pixel gradient.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 426 Image Processing Library

Publication # 40535 February 2007
FilterRobertsUp
Filter with a vertical Roberts kernel
Synopsis
AplStatus apliFilterRobertsUp_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
AplStatus apliFilterRobertsUp_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a vertical Roberts operator to the source data, and write the filtered data
to a destination buffer. These functions provide a gross approximation of the vertical pixel gradient.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 427 Image Processing Library

Publication # 40535 February 2007
FilterLaplace
Filter with a Laplace kernel
Synopsis
AplStatus apliFilterLaplace_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_8u16s_C1R ( const Apl8u * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLaplace_8s16s_C1R ( const Apl8s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 428 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, apply a high-pass Laplacian operator to the source data, and write the filtered
data to a destination buffer. The functions use either a 3X3 or a 5X5 kernel.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 429 Image Processing Library

Publication # 40535 February 2007
FilterGauss
Filter with a Gauss kernel
Synopsis
AplStatus apliFilterGauss_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterGauss_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 430 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, apply a low-pass Gaussian operator to the source data, and write the filtered
data to a destination buffer. The functions use either a 3X3 or a 5X5 kernel.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 431 Image Processing Library

Publication # 40535 February 2007
FilterHipass
Filter with a high-pass kernel
Synopsis
AplStatus apliFilterHipass_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_8u_C4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_16s_C4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_32f_C4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterHipass_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
AMD Performance Library User’s Manual 432 Image Processing Library

Publication # 40535 February 2007
Description
These functions step through an ROI in a source buffer, apply a high-pass operator to the source data, and write the filtered data to a
destination buffer. The functions use either a 3X3 or a 5X5 kernel.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 433 Image Processing Library

Publication # 40535 February 2007
FilterLowpass
Filter with a low-pass kernel
Synopsis
AplStatus apliFilterLowpass_8u_C1R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_8u_C3R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_8u_AC4R ( const Apl8u * pSrc , int srcStep , Apl8u * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_16s_C1R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_16s_C3R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_16s_AC4R ( const Apl16s * pSrc , int srcStep , Apl16s * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_32f_C1R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_32f_C3R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
AplStatus apliFilterLowpass_32f_AC4R ( const Apl32f * pSrc , int srcStep , Apl32f * pDst , int dstStep , ApliSize dstRoiSize , ApliMaskSize
maskSize );
Parameters
dstRoiSize Destination image ROI size.
dstStep Destination buffer step size (width of the buffer in bytes).
maskSize Size of the mask used in the calculations.
pDst Pointer to a location in a destination buffer.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an ROI in a source buffer, apply a low-pass operator to the source data, and write the filtered data to a
destination buffer. The functions use either a 3X3 or a 5X5 kernel.
AMD Performance Library User’s Manual 434 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
aplStsSizeErr The size is invalid (usually indicates negative or zero size).
aplStsStepErr The step value for the buffer is invalid.
AMD Performance Library User’s Manual 435 Image Processing Library

Publication # 40535 February 2007
Video Coding Functions
This chapter describes functions that are used to encode and decode moving images.
AMD Performance Library User’s Manual 436 Image Processing Library

Publication # 40535 February 2007
GetDiff
Block difference for motion estimation
Synopsis
AplStatus apliGetDiff16x16_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff16x8_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff8x8_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff8x16_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff8x4_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff4x4_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl16s*
pDstDiff , Apl32s dstDiffStep , Apl16s* pDstPredictor , Apl32s dstPredictorStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliGetDiff16x16B_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRefF , Apl32s srcRefStepF , Apl32s
mcTypeF , const Apl8u* pSrcRefB , Apl32s srcRefStepB , Apl32s mcTypeB , Apl16s* pDstDiff , Apl32s dstDiffStep , Apl32s roundControl );
AplStatus apliGetDiff16x8B_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRefF , Apl32s srcRefStepF , Apl32s
mcTypeF , const Apl8u* pSrcRefB , Apl32s srcRefStepB , Apl32s mcTypeB , Apl16s* pDstDiff , Apl32s dstDiffStep , Apl32s roundControl );
AplStatus apliGetDiff8x8B_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRefF , Apl32s srcRefStepF , Apl32s
mcTypeF , const Apl8u* pSrcRefB , Apl32s srcRefStepB , Apl32s mcTypeB , Apl16s* pDstDiff , Apl32s dstDiffStep , Apl32s roundControl );
AplStatus apliGetDiff8x16B_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRefF , Apl32s srcRefStepF , Apl32s
mcTypeF , const Apl8u* pSrcRefB , Apl32s srcRefStepB , Apl32s mcTypeB , Apl16s* pDstDiff , Apl32s dstDiffStep , Apl32s roundControl );
AplStatus apliGetDiff8x4B_8u16s_C1 ( const Apl8u* pSrcCur , Apl32s srcCurStep , const Apl8u* pSrcRefF , Apl32s srcRefStepF , Apl32s
mcTypeF , const Apl8u* pSrcRefB , Apl32s srcRefStepB , Apl32s mcTypeB , Apl16s* pDstDiff , Apl32s dstDiffStep , Apl32s roundControl );
AMD Performance Library User’s Manual 437 Image Processing Library

Publication # 40535 February 2007
Parameters
dstDiffStep Destination block step baize (width of the block in bytes).
dstPredictorStep Destination predictor block step size (width of the block in bytes).
mcType Specifies the type of prediction used for motion compensation.
mcTypeB Specifies the type of prediction used for backward frame motion compensation.
mcTypeF Specifies the type of prediction used for forward frame motion compensation.
pDstDiff Pointer to a block of size 16X16 in the destination plane which contains difference between the current and reference blocks.
pDstPredictor Pointer to a destination predictor block.
pSrcCur Pointer to a block in the current plane.
pSrcRef Pointer to a block in the reference plane.
pSrcRefB Pointer to a backward block in the reference plane.
pSrcRefF Pointer to a forward block in the reference plane.
roundControl Specifies the type of rounding used for half-pixel approximation.
srcCurStep Source current block step baize (width of the block in bytes)
srcRefStep Source reference block step size (width of the block in bytes)
srcRefStepB Source backward reference block step size (width of the block in bytes)
srcRefStepF Source forward reference block step size (width of the block in bytes)
Description
These functions step through the current block of predicted image data and either single or dual reference blocks of the same size,
evaluate the differences between the values in the blocks, and store the results in a destination difference buffer. The result is encoded
to half-pixel accuracy and a rounding value must be specified. There are functions for a number of different block sizes. For singlereference
versions of the functions, the reference block is part of a previous frame, as defined by the type of motion compensation
being used, and a second destination predictor buffer stores additional information that is used to encode subsequent blocks. Dualreference
(bi-predicted) versions of the functions evaluate the difference between the current block and the mean of the values in the
two reference blocks. The forward reference block is part of a previous frame, as defined by the type of motion compensation being
used; the backward reference block is part of a following frame.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 438 Image Processing Library

Publication # 40535 February 2007
SqrDiff
Block difference sum of squares
Synopsis
AplStatus apliSqrDiff16x16_8u32s ( const Apl8u* pSrc , Apl32s srcStep , const Apl8u* pRef , Apl32s refStep , Apl32s mcType , Apl32s*
pSqrDiff );
AplStatus apliSqrDiff16x16B_8u32s ( const Apl8u* pSrc , Apl32s srcStep , const Apl8u* pRefF , Apl32s refStepF , Apl32s mcTypeF , const
Apl8u* pRefB , Apl32s refStepB , Apl32s mcTypeB , Apl32s* pSqrDiff );
Parameters
mcType Specifies the type of prediction used for motion compensation.
mcTypeB Specifies the type of prediction used for backward frame motion compensation.
mcTypeF Specifies the type of prediction used for forward frame motion compensation.
pRef Pointer to a prefetch buffer which contains previously decoded bits.
pRefB Pointer to a backward reference block of specified size.
pRefF Pointer to a forward reference block of specified size.
pSqrDiff Pointer to a sum of square differences of all the elements in the current and reference blocks.
pSrc Pointer to a location in a source buffer.
refStep Reference block step size (width of the block in bytes).
refStepB Backward reference frame reference block step size (width of the block in bytes).
refStepF Forward reference frame reference block step size (width of the block in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through the current block of predicted image data and either single or dual reference blocks of the same size,
evaluate the sum of the squares differences between the values in the blocks, and store the results in a destination difference buffer.
For single-reference versions of the functions, the reference block is part of a previous frame, as defined by the type of motion
compensation being used, and a second destination predictor buffer stores additional information that is used to encode subsequent
blocks. Dual-reference (bi-predicted) versions of the functions evaluate the difference between the current block and the mean of the
values in the two reference blocks. The forward reference block is part of a previous frame, as defined by the type of motion
compensation being used; the backward reference block is part of a following frame.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 439 Image Processing Library

Publication # 40535 February 2007
VarMean
Block variance and mean
Synopsis
AplStatus apliVarMean8x8_8u32s_C1R ( const Apl8u* pSrc , Apl32s srcStep , Apl32s* pVar , Apl32s* pMean );
AplStatus apliVarMean8x8_16s32s_C1R ( const Apl16s* pSrc , Apl32s srcStep , Apl32s* pVar , Apl32s* pMean );
Parameters
pMean Pointer to a computed mean of pixel values.
pSrc Pointer to a location in a source buffer.
pVar Pointer to a variance value.
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through an 8X8 block of data in a source buffer, calculate the variance and mean, and write the results to two
destination buffers.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 440 Image Processing Library

Publication # 40535 February 2007
VarMeanDiff
Block difference variance and mean
Synopsis
AplStatus apliVarMeanDiff16x16_8u32s_C1R ( const Apl8u* pSrc , Apl32s srcStep , const Apl8u* pRef , Apl32s refStep , Apl32s* pSrcSum
, Apl32s* pVar , Apl32s* pMean , Apl32s mcType );
AplStatus apliVarMeanDiff16x8_8u32s_C1R ( const Apl8u* pSrc , Apl32s srcStep , const Apl8u* pRef , Apl32s refStep , Apl32s* pSrcSum ,
Apl32s* pVar , Apl32s* pMean , Apl32s mcType );
Parameters
mcType Specifies the type of prediction used for motion compensation.
pMean Pointer to a computed mean of pixel values.
pRef Pointer to a prefetch buffer which contains previously decoded bits.
pSrc Pointer to a location in a source buffer.
pSrcSum Pointer to a sum of pixel values for the current block.
pVar Pointer to a variance value.
refStep Reference block step size (width of the block in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a block of data in a source buffer and a reference block of the same size, evaluate the differences and
store them in an array of 8X8 difference blocks, then calculate the variances and means of the difference blocks, and write the results
to two destination buffers. The pointer pSrcSum points to the array of difference blocks. There are variations for 16X8 and 16X16
source data blocks.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 441 Image Processing Library

Publication # 40535 February 2007
Variance16X16
Block variance
Synopsis
AplStatus apliVariance16x16_8u32s ( const Apl8u* pSrc , Apl32s srcStep , Apl32s* pVar );
Parameters
pSrc Pointer to a location in a source buffer.
pVar Pointer to a variance value.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through a 16X16 block of data in a source buffer, calculates the variance, and writes the result to a destination
buffer.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 442 Image Processing Library

Publication # 40535 February 2007
EdgesDetect
Detect block edges
Synopsis
AplStatus apliEdgesDetect16x16_8u_C1R ( const Apl8u * pSrc , Apl32u srcStep , Apl8u EdgePelDifference , Apl8u EdgePelCount , Apl8u *
pRes );
Parameters
EdgePelCount Specifies the minimum number of pairs of elements that differ by more than EdgePelDifference.
EdgePelDifference Specifies the edge difference threshold between neighboring elements.
pRes Pointer to a result value.
pSrc Pointer to a location in a source buffer.
srcStep Source buffer step size (width of the buffer in bytes).
Description
This function steps through a 16x16 block of data in a source buffer, calculates the difference between adjacent pixels, and compares
the difference to a threshold value to detect edge pixels. If the number of edge pixels is greater than a specified value, a results flag is
set. The EdgePelDifference parameter specifies the threshold value, and the EdgePelCount parameter specifies the minimum number
of edge pixels to detect. When the number of edge pixels detected is greater than the value of EdgePelCount, the location pointed to
by pRes is set to 1.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 443 Image Processing Library

Publication # 40535 February 2007
SAD
Block difference sum of absolute difference
Synopsis
AplStatus apliSAD16x16_8u32s ( const Apl8u* pSrc , Apl32s srcStep , const Apl8u* pRef , Apl32s refStep , Apl32s* pSAD , Apl32s mcType
);
AplStatus apliSAD8x8_8u32s_C1R ( const Apl8u* pSrcCur , int srcCurStep , const Apl8u* pSrcRef , Apl32s srcRefStep , Apl32s * pDst ,
Apl32s mcType );
AplStatus apliSAD4x4_8u32s ( const Apl8u * pSrc , Apl32s srcStep , Apl8u * pRef , Apl32s refStep , Apl32s * pSAD , Apl32s mcType );
AplStatus apliSAD16x16Blocks8x8_8u16u ( const Apl8u * pSrc , Apl32s srcStep , Apl8u * pRef , Apl32s refStep , Apl16u * pDstSAD ,
Apl32s mcType );
AplStatus apliSAD16x16Blocks4x4_8u16u ( const Apl8u * pSrc , Apl32s srcStep , Apl8u * pRef , Apl32s refStep , Apl16u * pDstSAD ,
Apl32s mcType );
Parameters
mcType Specifies the type of prediction used for motion compensation.
pDst Pointer to a location in a destination buffer.
pDstSAD Pointer to a destination array of size 4 that stores SAD values.
pRef Pointer to a prefetch buffer which contains previously decoded bits.
pSAD Pointer to an SAD result.
pSrc Pointer to a location in a source buffer.
pSrcCur Pointer to a block in the current plane.
pSrcRef Pointer to a block in the reference plane.
refStep Reference block step size (width of the block in bytes).
srcCurStep Source current block step baize (width of the block in bytes)
srcRefStep Source reference block step size (width of the block in bytes)
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a block of image data and a reference block of the same size, evaluate the sum of the differences
between the absolute values in the blocks, and store the result in a destination buffer. The reference block is part of a previous frame,
as defined by the type of motion compensation being used.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 444 Image Processing Library

Publication # 40535 February 2007
SumsDiff
Block difference sum of difference
Synopsis
AplStatus apliSumsDiff16x16Blocks4x4_8u16s_C1 ( Apl8u* pSrc , Apl32s srcStep , Apl8u* pPred , Apl32s predStep , Apl16s* pSums ,
Apl16s* pDiff );
AplStatus apliSumsDiff8x8Blocks4x4_8u16s_C1 ( Apl8u* pSrc , Apl32s srcStep , Apl8u* pPred , Apl32s predStep , Apl16s* pSums ,
Apl16s* pDiff );
Parameters
pDiff Pointer to an array of size 16 that contains the sums of 4X4 difference block coefficients.
pPred Pointer to a 16x16 predictor block in the reference plane.
pSrc Pointer to a location in a source buffer.
pSums Pointer to an array of size 256 that contains a sequence of 4X4 residual blocks.
predStep Reference plane step size (in bytes).
srcStep Source buffer step size (width of the buffer in bytes).
Description
These functions step through a block of image data and a reference block of the same size, evaluate the sum of the differences
between the values in the blocks, and store the result in a destination buffer. The reference block is part of a previous frame, as
defined by the type of motion compensation being used.
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 445 Image Processing Library

Publication # 40535 February 2007
MC
Motion compensation
Synopsis
AplStatus apliMC16x16_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC16x8_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC8x16_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC8x8_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC8x4_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC4x8_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC4x4_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC2x4_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC4x2_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC2x2_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC16x4_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC16x8UV_8u_C1 ( const Apl8u * pSrcRef , Apl32s srcStep , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst ,
Apl32s dstStep , Apl32s mcType , Apl32s roundControl );
AplStatus apliMC16x16B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC16x8B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC8x16B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC8x8B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC8x4B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC4x8B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC4x4B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AMD Performance Library User’s Manual 446 Image Processing Library

Publication # 40535 February 2007
AplStatus apliMC2x4B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC4x2B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC2x2B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC16x4B_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB ,
Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
AplStatus apliMC16x8BUV_8u_C1 ( const Apl8u * pSrcRefF , Apl32s srcStepF , Apl32s mcTypeF , const Apl8u * pSrcRefB , Apl32s srcStepB
, Apl32s mcTypeB , const Apl16s * pSrcYData , Apl32s srcYDataStep , Apl8u * pDst , Apl32s dstStep , Apl32s roundControl );
Parameters
dstStep Destination buffer step size (width of the buffer in bytes).
mcType Specifies the type of prediction used for motion compensation.
mcTypeB Specifies the type of prediction used for backward frame motion compensation.
mcTypeF Specifies the type of prediction used for forward frame motion compensation.
pDst Pointer to a location in a destination buffer.
pSrcRef Pointer to a block in the reference plane.
pSrcRefB Pointer to a backward block in the reference plane.
pSrcRefF Pointer to a forward block in the reference plane.
pSrcYData Pointer to a block of inverse DCT output data.
roundControl Specifies the type of rounding used for half-pixel approximation.
srcStep Source buffer step size (width of the buffer in bytes).
srcStepB Source aligned backward reference frame step size (width in bytes).
srcStepF Source aligned forward reference frame step size (width in bytes).
srcYDataStep Source aligned DCT output data block step size (width of the block in bytes).
Description
These functions step through a block of image data obtained by reverse DCT and either single or dual reference blocks of the same
size, add the values in the blocks, and store the results in a destination buffer. The result is encoded to half-pixel accuracy and a
rounding value must be specified. There are functions for a number of different block sizes. For single-reference versions of the
functions, the reference block is part of a previous frame, as defined by the type of motion compensation being used. Dual-reference
(bi-predicted) versions of the functions add the values in the two reference blocks to the source data. The forward reference block is
part of a previous frame, as defined by the type of motion compensation being used; the backward reference block is part of a
following frame. The apliMC16x8UVB function uses a special UV block, which is an interleaved combination of an 8X8 block of U
components and an 8X8 block of V components.
AMD Performance Library User’s Manual 447 Image Processing Library

Publication # 40535 February 2007
Return Values
aplStsNoErr No error detected.
aplStsNullPtrErr A pointer passed to the function is null.
AMD Performance Library User’s Manual 448 Image Processing Library