Files
FastDeploy/fastdeploy/vision/common/processors/normalize_and_permute.h
guxukai 4d57b62f83 [Doc] add vision processors cpp api doc (#1624)
* add vision processors cpp api doc

* add base class Processor in api doc

* Update base.h

---------

Co-authored-by: Wang Xinyu <shaywxy@gmail.com>
2023-03-17 13:20:38 +08:00

112 lines
3.7 KiB
C++

// Copyright (c) 2022 PaddlePaddle Authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#pragma once
#include "fastdeploy/vision/common/processors/base.h"
namespace fastdeploy {
namespace vision {
/*! @brief Processor for Normalize and Permute images from HWC to CHW.
*/
class FASTDEPLOY_DECL NormalizeAndPermute : public Processor {
public:
NormalizeAndPermute(const std::vector<float>& mean,
const std::vector<float>& std, bool is_scale = true,
const std::vector<float>& min = std::vector<float>(),
const std::vector<float>& max = std::vector<float>(),
bool swap_rb = false);
bool ImplByOpenCV(FDMat* mat);
#ifdef ENABLE_FLYCV
bool ImplByFlyCV(FDMat* mat);
#endif
#ifdef WITH_GPU
bool ImplByCuda(FDMat* mat);
bool ImplByCuda(FDMatBatch* mat_batch);
#endif
#ifdef ENABLE_CVCUDA
bool ImplByCvCuda(FDMat* mat);
bool ImplByCvCuda(FDMatBatch* mat_batch);
#endif
std::string Name() { return "NormalizeAndPermute"; }
// While use normalize, it is more recommend not use this function
// this function will need to compute result = ((mat / 255) - mean) / std
// if we use the following method
// ```
// auto norm = Normalize(...)
// norm(mat)
// ```
// There will be some precomputation in contruct function
// and the `norm(mat)` only need to compute result = mat * alpha + beta
// which will reduce lots of time
/** \brief Process the input images
*
* \param[in] mat The input image data, `result = mat * alpha + beta`
* \param[in] mean target mean vector of output images
* \param[in] std target std vector of output images
* \param[in] max max value vector to be in target image
* \param[in] min min value vector to be in target image
* \param[in] lib to define OpenCV or FlyCV or CVCUDA will be used.
* \param[in] swap_rb to define whether to swap r and b channel order
* \return true if the process successed, otherwise false
*/
static bool Run(FDMat* mat, const std::vector<float>& mean,
const std::vector<float>& std, bool is_scale = true,
const std::vector<float>& min = std::vector<float>(),
const std::vector<float>& max = std::vector<float>(),
ProcLib lib = ProcLib::DEFAULT, bool swap_rb = false);
/** \brief Process the input images
*
* \param[in] alpha set the value of the alpha parameter
*/
void SetAlpha(const std::vector<float>& alpha) {
alpha_.clear();
std::vector<float>().swap(alpha_);
alpha_.assign(alpha.begin(), alpha.end());
}
/** \brief Process the input images
*
* \param[in] beta set the value of the beta parameter
*/
void SetBeta(const std::vector<float>& beta) {
beta_.clear();
std::vector<float>().swap(beta_);
beta_.assign(beta.begin(), beta.end());
}
bool GetSwapRB() {
return swap_rb_;
}
/** \brief Process the input images
*
* \param[in] swap_rb set the value of the swap_rb parameter
*/
void SetSwapRB(bool swap_rb) {
swap_rb_ = swap_rb;
}
private:
std::vector<float> alpha_;
std::vector<float> beta_;
FDTensor gpu_alpha_;
FDTensor gpu_beta_;
bool swap_rb_;
};
} // namespace vision
} // namespace fastdeploy