mirror of
https://github.com/gosticks/openpose.git
synced 2026-08-12 20:30:20 +00:00
Deprecated non-API examples and further simplified readme/doc
Signed-off-by: Gines Hidalgo <gineshidalgo99@gmail.com>
This commit is contained in:
Gines Hidalgo
@@ -0,0 +1,187 @@
|
||||
// ------------------------- OpenPose Library Tutorial - Adding Module - Example 1 - Custom Post Processing -------------------------
|
||||
// Purpose of this example
|
||||
// To create a class in OpenPose format so it can be later added to the library.
|
||||
|
||||
// How to use?
|
||||
// 1. `userPostProcessing.hpp`: Implement your custom functionality there.
|
||||
// 2. `wUserPostProcessing.hpp`: Change 1 line in `work(TDatums& tDatums)` to use your custom function from
|
||||
// `userPostProcessing.hpp`.
|
||||
// 3. `userDatum.hpp`: Add any required output of your post-processing class there.
|
||||
// 4. `tutorial_add_module_custom_post_processing.cpp`: Change 1 line, when creating the `UserPostProcessing` class, add any specific
|
||||
// arguments/parameters than your class need.
|
||||
// 5. `tutorial_add_module_custom_post_processing.bin`: Compile and run this file (as you usually run the OpenPose demo) in order to
|
||||
// test your custom functionality.
|
||||
|
||||
// Syntax rules
|
||||
// 1. Class/template variables start by up (unique_ptr), sp (sahred_ptr), p (pointer) or m (non-pointer), and they
|
||||
// have no underscores, e.g., mThisIsAVariable.
|
||||
// 2. The internal temporary function variable equivalent would be thisIsAVariable.
|
||||
// 3. Every line cannot have more than 120 characters.
|
||||
// 4. If extra classes and files are required, add those extra files inside the OpenPose include and src folders,
|
||||
// under a new folder (i.e., `include/newMethod/` and `src/newMethod/`), including `namespace op` on those files.
|
||||
|
||||
// This example is a sub-case of `tutorial_api_cpp/16_synchronous_custom_postprocessing.cpp`, where only custom post-processing is
|
||||
// considered.
|
||||
|
||||
// Command-line user interface
|
||||
#include <openpose/flags.hpp>
|
||||
// OpenPose dependencies
|
||||
#include <openpose/headers.hpp>
|
||||
#include "tutorial_add_module/userDatum.hpp"
|
||||
#include "tutorial_add_module/wUserPostProcessing.hpp"
|
||||
|
||||
void configureWrapper(op::WrapperT<op::UserDatum>& opWrapperT)
|
||||
{
|
||||
try
|
||||
{
|
||||
// Configuring OpenPose
|
||||
|
||||
// logging_level
|
||||
op::checkBool(
|
||||
0 <= FLAGS_logging_level && FLAGS_logging_level <= 255, "Wrong logging_level value.",
|
||||
__LINE__, __FUNCTION__, __FILE__);
|
||||
op::ConfigureLog::setPriorityThreshold((op::Priority)FLAGS_logging_level);
|
||||
op::Profiler::setDefaultX(FLAGS_profile_speed);
|
||||
|
||||
// Applying user defined configuration - GFlags to program variables
|
||||
// producerType
|
||||
op::ProducerType producerType;
|
||||
op::String producerString;
|
||||
std::tie(producerType, producerString) = op::flagsToProducer(
|
||||
op::String(FLAGS_image_dir), op::String(FLAGS_video), op::String(FLAGS_ip_camera), FLAGS_camera,
|
||||
FLAGS_flir_camera, FLAGS_flir_camera_index);
|
||||
// cameraSize
|
||||
const auto cameraSize = op::flagsToPoint(op::String(FLAGS_camera_resolution), "-1x-1");
|
||||
// outputSize
|
||||
const auto outputSize = op::flagsToPoint(op::String(FLAGS_output_resolution), "-1x-1");
|
||||
// netInputSize
|
||||
const auto netInputSize = op::flagsToPoint(op::String(FLAGS_net_resolution), "-1x368");
|
||||
// faceNetInputSize
|
||||
const auto faceNetInputSize = op::flagsToPoint(op::String(FLAGS_face_net_resolution), "368x368 (multiples of 16)");
|
||||
// handNetInputSize
|
||||
const auto handNetInputSize = op::flagsToPoint(op::String(FLAGS_hand_net_resolution), "368x368 (multiples of 16)");
|
||||
// poseMode
|
||||
const auto poseMode = op::flagsToPoseMode(FLAGS_body);
|
||||
// poseModel
|
||||
const auto poseModel = op::flagsToPoseModel(op::String(FLAGS_model_pose));
|
||||
// JSON saving
|
||||
if (!FLAGS_write_keypoint.empty())
|
||||
op::opLog(
|
||||
"Flag `write_keypoint` is deprecated and will eventually be removed. Please, use `write_json`"
|
||||
" instead.", op::Priority::Max);
|
||||
// keypointScaleMode
|
||||
const auto keypointScaleMode = op::flagsToScaleMode(FLAGS_keypoint_scale);
|
||||
// heatmaps to add
|
||||
const auto heatMapTypes = op::flagsToHeatMaps(FLAGS_heatmaps_add_parts, FLAGS_heatmaps_add_bkg,
|
||||
FLAGS_heatmaps_add_PAFs);
|
||||
const auto heatMapScaleMode = op::flagsToHeatMapScaleMode(FLAGS_heatmaps_scale);
|
||||
// >1 camera view?
|
||||
const auto multipleView = (FLAGS_3d || FLAGS_3d_views > 1 || FLAGS_flir_camera);
|
||||
// Face and hand detectors
|
||||
const auto faceDetector = op::flagsToDetector(FLAGS_face_detector);
|
||||
const auto handDetector = op::flagsToDetector(FLAGS_hand_detector);
|
||||
// Enabling Google Logging
|
||||
const bool enableGoogleLogging = true;
|
||||
|
||||
// Pose configuration (use WrapperStructPose{} for default and recommended configuration)
|
||||
const op::WrapperStructPose wrapperStructPose{
|
||||
poseMode, netInputSize, outputSize, keypointScaleMode, FLAGS_num_gpu, FLAGS_num_gpu_start,
|
||||
FLAGS_scale_number, (float)FLAGS_scale_gap, op::flagsToRenderMode(FLAGS_render_pose, multipleView),
|
||||
poseModel, !FLAGS_disable_blending, (float)FLAGS_alpha_pose, (float)FLAGS_alpha_heatmap,
|
||||
FLAGS_part_to_show, op::String(FLAGS_model_folder), heatMapTypes, heatMapScaleMode, FLAGS_part_candidates,
|
||||
(float)FLAGS_render_threshold, FLAGS_number_people_max, FLAGS_maximize_positives, FLAGS_fps_max,
|
||||
op::String(FLAGS_prototxt_path), op::String(FLAGS_caffemodel_path),
|
||||
(float)FLAGS_upsampling_ratio, enableGoogleLogging};
|
||||
opWrapperT.configure(wrapperStructPose);
|
||||
// Face configuration (use op::WrapperStructFace{} to disable it)
|
||||
const op::WrapperStructFace wrapperStructFace{
|
||||
FLAGS_face, faceDetector, faceNetInputSize,
|
||||
op::flagsToRenderMode(FLAGS_face_render, multipleView, FLAGS_render_pose),
|
||||
(float)FLAGS_face_alpha_pose, (float)FLAGS_face_alpha_heatmap, (float)FLAGS_face_render_threshold};
|
||||
opWrapperT.configure(wrapperStructFace);
|
||||
// Hand configuration (use op::WrapperStructHand{} to disable it)
|
||||
const op::WrapperStructHand wrapperStructHand{
|
||||
FLAGS_hand, handDetector, handNetInputSize, FLAGS_hand_scale_number, (float)FLAGS_hand_scale_range,
|
||||
op::flagsToRenderMode(FLAGS_hand_render, multipleView, FLAGS_render_pose), (float)FLAGS_hand_alpha_pose,
|
||||
(float)FLAGS_hand_alpha_heatmap, (float)FLAGS_hand_render_threshold};
|
||||
opWrapperT.configure(wrapperStructHand);
|
||||
// Extra functionality configuration (use op::WrapperStructExtra{} to disable it)
|
||||
const op::WrapperStructExtra wrapperStructExtra{
|
||||
FLAGS_3d, FLAGS_3d_min_views, FLAGS_identification, FLAGS_tracking, FLAGS_ik_threads};
|
||||
opWrapperT.configure(wrapperStructExtra);
|
||||
// Producer (use default to disable any input)
|
||||
const op::WrapperStructInput wrapperStructInput{
|
||||
producerType, producerString, FLAGS_frame_first, FLAGS_frame_step, FLAGS_frame_last,
|
||||
FLAGS_process_real_time, FLAGS_frame_flip, FLAGS_frame_rotate, FLAGS_frames_repeat,
|
||||
cameraSize, op::String(FLAGS_camera_parameter_path), FLAGS_frame_undistort, FLAGS_3d_views};
|
||||
opWrapperT.configure(wrapperStructInput);
|
||||
// Output (comment or use default argument to disable any output)
|
||||
const op::WrapperStructOutput wrapperStructOutput{
|
||||
FLAGS_cli_verbose, op::String(FLAGS_write_keypoint), op::stringToDataFormat(FLAGS_write_keypoint_format),
|
||||
op::String(FLAGS_write_json), op::String(FLAGS_write_coco_json), FLAGS_write_coco_json_variants,
|
||||
FLAGS_write_coco_json_variant, op::String(FLAGS_write_images), op::String(FLAGS_write_images_format),
|
||||
op::String(FLAGS_write_video), FLAGS_write_video_fps, FLAGS_write_video_with_audio,
|
||||
op::String(FLAGS_write_heatmaps), op::String(FLAGS_write_heatmaps_format), op::String(FLAGS_write_video_3d),
|
||||
op::String(FLAGS_write_video_adam), op::String(FLAGS_write_bvh), op::String(FLAGS_udp_host),
|
||||
op::String(FLAGS_udp_port)};
|
||||
opWrapperT.configure(wrapperStructOutput);
|
||||
// GUI (comment or use default argument to disable any visual output)
|
||||
const op::WrapperStructGui wrapperStructGui{
|
||||
op::flagsToDisplayMode(FLAGS_display, FLAGS_3d), !FLAGS_no_gui_verbose, FLAGS_fullscreen};
|
||||
opWrapperT.configure(wrapperStructGui);
|
||||
|
||||
// Custom post-processing
|
||||
auto userPostProcessing = std::make_shared<op::UserPostProcessing>(/* Your class arguments here */);
|
||||
auto wUserPostProcessing = std::make_shared<op::WUserPostProcessing<std::shared_ptr<std::vector<std::shared_ptr<op::UserDatum>>>>>(
|
||||
userPostProcessing
|
||||
);
|
||||
// Add custom processing
|
||||
const auto workerProcessingOnNewThread = false;
|
||||
opWrapperT.setWorker(op::WorkerType::PostProcessing, wUserPostProcessing, workerProcessingOnNewThread);
|
||||
|
||||
// Set to single-thread (for sequential processing and/or debugging and/or reducing latency)
|
||||
if (FLAGS_disable_multi_thread)
|
||||
opWrapperT.disableMultiThreading();
|
||||
}
|
||||
catch (const std::exception& e)
|
||||
{
|
||||
op::error(e.what(), __LINE__, __FUNCTION__, __FILE__);
|
||||
}
|
||||
}
|
||||
|
||||
int tutorialAddModule1()
|
||||
{
|
||||
try
|
||||
{
|
||||
op::opLog("Starting OpenPose demo...", op::Priority::High);
|
||||
const auto opTimer = op::getTimerInit();
|
||||
|
||||
// Configure OpenPose
|
||||
op::opLog("Configuring OpenPose...", op::Priority::High);
|
||||
op::WrapperT<op::UserDatum> opWrapperT;
|
||||
configureWrapper(opWrapperT);
|
||||
|
||||
op::opLog("Starting thread(s)...", op::Priority::High);
|
||||
// Start, run & stop threads - it blocks this thread until all others have finished
|
||||
opWrapperT.exec();
|
||||
|
||||
// Measuring total time
|
||||
op::printTime(opTimer, "OpenPose demo successfully finished. Total time: ", " seconds.", op::Priority::High);
|
||||
|
||||
// Return successful message
|
||||
return 0;
|
||||
}
|
||||
catch (const std::exception&)
|
||||
{
|
||||
return -1;
|
||||
}
|
||||
}
|
||||
|
||||
int main(int argc, char *argv[])
|
||||
{
|
||||
// Parsing command line flags
|
||||
gflags::ParseCommandLineFlags(&argc, &argv, true);
|
||||
|
||||
// Running tutorialAddModule1
|
||||
return tutorialAddModule1();
|
||||
}
|
||||
Reference in New Issue
Block a user