中文|English
This sample provides reference for you to learn the Ascend AI Software Stack and cannot be used for commercial purposes.
This README file provides only guidance for running the sample in command line (CLI) mode. For details about how to run the sample in MindStudio, see Running Image Samples in MindStudio.
Function: Calls the cropandpaste interface of the DVPP to crop the specified part of an image and paste it to the specified position of the output image.
Input: Original YUV images.
Output: Cropped and pasted YUV images.
Check whether the following requirements are met. If not, perform operations according to the remarks. If the CANN version is upgraded, check whether the third-party dependencies need to be reinstalled. (The third-party dependencies for 5.0.4 and later versions are different from those for earlier versions.)
| Item | Requirement | Remarks |
|---|---|---|
| CANN version | >=5.0.4 | Install the CANN by referring to Installation in the About Ascend Samples Repository. If the CANN version is earlier than the required version, switch to the samples repository specific to the CANN version. See Release Notes. |
| Hardware | Atlas 200 DK/Atlas 300 (ai1s) | Currently, the Atlas 200 DK and Atlas 300 have passed the test. For details about the product description, see Hardware Platform. For other products, adaptation may be required. |
| Third-party dependency | Installation preparation | Set environment variables based on the installation preparation of each third-party dependency. |
You can download the source code in either of the following ways:
- Command line (The download takes a long time, but the procedure is simple.)
Note: To switch to another tag (for example, v0.5.0), run the following command:
# In the development environment, run the following commands as a non-root user to download the source repository: cd ${HOME} git clone https://github.com/Ascend/samples.gitgit checkout v0.5.0 - Compressed package (The download takes a short time, but the procedure is complex.)
Note: If you want to download the code of another version, switch the branch of the samples repository according to the prerequisites.# 1. Click "Clone or Download" in the upper right corner of the samples repository and click "Download ZIP". # 2. Upload the ZIP package to the home directory of a common user in the development environment, for example, "${HOME}/ascend-samples-master.zip". # 3. In the development environment, run the following commands to unzip the package: cd ${HOME} unzip ascend-samples-master.zip
Run the following commands to execute the compilation script to start sample compilation:
cd ${HOME}/samples/cplusplus/level2_simple_inference/0_data_process/cropandpaste/scripts
bash sample_build.sh
Note: If the development environment and operating environment are set up on the same server, skip step 1 and go to step 2 directly.
- Run the following commands to upload the cropandpaste directory in the development environment to any directory in the operating environment, for example, /home/HwHiAiUser, and log in to the operating environment (host) as the running user (HwHiAiUser):
# In the following information, <xxx.xxx.xxx.xxx> is the IP address of the operating environment. The IP address of Atlas 200 DK is 192.168.1.2 when it is connected over the USB port, and that of Atlas 300 (AI1s) is the corresponding public IP address. scp -r ${HOME}/samples/cplusplus/level2_simple_inference/0_data_process/cropandpaste HwHiAiUser@xxx.xxx.xxx.xxx:/home/HwHiAiUser ssh HwHiAiUser@xxx.xxx.xxx.xxx cd ${HOME}/cropandpaste/scripts - Execute the script to run the sample.
bash sample_run.sh
After running, the output YUV images are generated in out/output in the sample directory of the running environment.
For details about how to rectify the errors, see Troubleshooting. If an error is not included in Wiki, submit an issue to the samples repository.