FAQ

I. Venue

Q: How do I set up my camera?

A1: The horizontal distance between the two cameras is 2 metres (maximum 2.5 metres) and the vertical distance is 1 metre. The height of the main camera is 1 metre (the camera facing the actor is the main camera), the height of the secondary camera is 0.9 metre, the camera is placed horizontally, and cannot look up or down. Failure to follow this requirement for site layout will result in loss of motion capture accuracy.

A2: Keep the camera level with the ground, avoid looking up or down, as this will not capture the legs, resulting in a loss of leg quality and shaking.

Q: Camera model selection

A1:1 Support 1080p 30 fps Wide angle Fov between 90°-120° webcam, two cameras of the same model are required.

A2: 90° wide angle webcam is provided by default, if your venue is smaller, you can consider bigger wide angle webcam, such as 110°, 120°, which can capture the whole body of motion capture actors in a closer position.

A3: Recommend emeetC960.

Q: How should a motion-capture actor stand

A: The motion-capture actor needs to stand in a position where his or her whole body can be captured by both cameras and make sure that he or she is also captured during the motion-capture, otherwise there will be a loss of accuracy.

Q: What are the requirements for light, lighting, etc.

A1: Make sure the camera picture is clearly visible and can clearly shoot the whole body of the motion-capture actor, you can open the camera software that comes with the system to watch whether the picture taken by the camera is clear.

A2: The camera can not be directly hit by artificial light source or sunlight, otherwise it will be blurred by backlight shooting.

Q: What are the requirements for clothing

A1: Try to avoid loose, flowing clothing (skirts, baggy half trousers)

A2: Don't cover your wrists, you need to pull up your sleeves.

A3: Wearing a mask will lose face capture, wearing glasses has a chance of affecting eye capture

A4: Try to avoid clothing and background colour exactly the same

Q: What are the requirements for the venue

A1: Try to keep the field as open as possible, avoid too much debris to cover 

A2: Keep a certain level of brightness, too dark will lose the capture accuracy.

 

II. Common Capture Accuracy Loss Problems

Q: Finger shaking and twisting problem

A1: the wrist is blocked resulting in abnormal fingers, need to pull up the sleeve.

A2:After clicking Run, the initialisation process of the capture terminal program is caused by the motion-capture actor clenching his fist, and it is necessary to open the palm of the hand for initialisation

A3: The camera screen is blurred, and the fingers can't be captured due to strong light exposure

Q: Abnormal twisting and shaking of the legs

A1: The motion-capture actor is beyond the range of both cameras, too close to the camera

A2: Camera can't capture the legs resulting in shaking (camera placement height is too high, placing the camera in a tilted position)

A3: Sub-camera connection is unstable, dropped frames or high latency

Q:Poor capture quality

A1: Failure to place the camera as required, with the camera capturing backlit and blurred images

A2: The camera didn't get a full shot of your body.

 

III. FAQ about the Acquisition Terminal

Q: abnormally (Error: 800l,There is an exception in your windows, Antivirus software or windows denfender causes this)!

A1:Blocked by windows Security, you need to find the mistakenly deleted files in the protection history, recover them and add them to the trust zone, usually Cyan.exe and CyanMain.exe.

A2:Blocked by antivirus and firewall, you need to disable the firewall and antivirus, and find the blocked programs Cyan.exe and CyanMain.exe.

A3:The computer's local environment is abnormal, or the network it is connected to has an interception mechanism.

Q:Application Error(0xc000007b)

A1:Lack of runtime environment, please install Microsoft Visual C++ 2015 (https://www.microsoft.com/en-us/download/details.aspx?id=52685)

A2: Installation in the right-click folder

A3: Install Driver Wizard to supplement missing drivers

A4: Direct Repair Tool

 

Q:White screen after opening the capture program

A1:Click F5 to refresh the programme.

A2:Check whether the software installation path has non-English characters, you need a full English path.

A3:Check whether the computer user name is a non-English user name, you need an English user name.

A4:Check whether the computer is AMD graphics card, need to use nVidia graphics card

Q:Software startup fails, startup button cannot be clicked

A1:Check whether the software is blocked by windows security centre or antivirus software, open windows Security-Virus&threat protection-Protection history-find the blocked program, click restore operation.

A2:Check whether the computer is AMD graphics card, need to use nVidia graphics card

A3: Re-extract the software

Q: The header of the human status bar in the lower left corner of the collection side is white

A1:Update the graphics card driver and then restart the capture terminal.

A2:Check whether cyanmain.exe programme is checked by anti-virus software, add the software to the trust zone

A3:Check whether the computer is AMD graphics card, need to use nVidia graphics card 

Q:After clicking the Run button, the initialisation cannot be completed and the status bar does not turn all green

A1: Ensure that the motion capture actor can be captured by the camera's full body during initialisation, and ensure that there is no one else in the field of view of both cameras during initialisation

A2: Cameras are not placed according to the tutorial

Q:Open the capture terminal programme , not enough cameras are detected.

A1: Make sure both cameras are plugged into the computer and detected in the camera camera programme

A2: Make sure both cameras have the same model and name

Q:After clicking Run, the camera preview screen freezes

A: The webcam preview window freezes after clicking Run. This is normal because Windows does not allow two programmes to call the camera at the same time. It does not affect the use of the software.

Q:After the initialisation of the acquisition terminal is completed, the status bar turns red and shows that the leaving

A1: The actor is completely or partially out of the field of view of both cameras, please make sure that both cameras can capture the whole body of the actor.

A2:Too close to the camera, try to move away from the camera.

A3:Check if the camera placement is consistent with the tutorial, or the front and back cameras may be incorrectly identified, you need to click to switch cameras.

A4:There is an obvious shadow projection on the background wall, or there is a second person or a human-like object/poster in the venue.

Q:Serial number prompts that the bound host exceeds the upper limit

A1: 1.4.0 or above version of the collection terminal programme for unbinding operation, you can bind to a new PC

A2:One serial number can only bind 4 machines at the same time.

Q: Prompt for missing or missing software files

A: Click File Recovery.exe in the installation directory of the collection terminal programme.

Q:Acquisition Terminal program clicked to Run, prompting the server exception, token error

A1:Check whether the computer network connection is normal

A2:Check if the software is blocked by windows security centre or antivirus software

Q: The ground clearance parameter slider on the acquisition side cannot be dragged

A: Avoid enlarging the web page of the collection side, if the proportion of the web page of the collection side is enlarged, it will lead to the button being blocked and can't be clicked.

Q: Network issue, unable to connect to the server ,faild to bind!  Token validation error, motion capture cannot run!

A1: When binding the serial number, the background will send a command to our server to verify the serial number, the program is blocked by the firewall or security center can not be verified.

A2: computer does not have a network

 

IV. FAQ on the UE side

Q: How to control the lens and export data in the sample project

A1:Click the triangle button on the top editor or press F8 to switch to joystick control mode, long press the right mouse button, click QWEASD to control the camera.

Click the Record button on the left menu bar to start recording, click the Record button again to stop recording, click the Export button, tick all the options when the generation is finished, and save it to the local folder.

A2: For plug-in version, please use UE export function, see the tutorial document (UE export FBX function tutorial).

Q: Low frame rate of the screen seen on the UE side

A1:Open Graphics Settings in Window, add cyan.exe, cyanmain.exe and Unreal Editor to High Performance Mode.

A2:If you are using a laptop, please make sure that it is connected to a power source and has high performance mode enabled, and use a discrete graphics card to run the programme.

A3:Adjust the system file of the project version or CyanAnimApply of the plugin version, find LoopCount, and turn down the parameter.

Q:Opening the UE sample project shows IOCP Connect failed, and the capture does not start when the animation is playing by default.

A1: Sample project version: you need to modify the IP address in the system file to match the collection side, open the folder path CyanAnimation5_0\CyanAnimation5_0\Content\User\system of the sample project in the rendering side and fill in the IP address displayed in the interface of the collection side into the IP address: "IPaddress": "192.168.xx.xx". "192.168.xx.xx".

A2: Plugin version: Find CyanAnimApply in the project settings, change the IP address to the IP address displayed on the capture side.

Q:Launching UE sample project prompts

①The following modules are Missing or built with different engine version

CyanAnimApply  is could not be compiled.Try rebuilding from source manually

③The 'CyanAnimApply' plugin was designed for build 5, 1.0. Atempt to load it anyway?

A1:Choose No, because the wrong version is used to open the UE sample project, you need to download the corresponding UE version, right-click CyanAnimation5_0, select "switch Unreal Engine version", select the corresponding UE version. Open

A2: UE version is incomplete, open the Unreal Engine programme, right-click the corresponding UE version, and select Verify UE completeness.

Q: The model's feet are stuck in the scene, the model is hanging in the air

A1:Drag the floor parameter slider on the left side of the acquisition terminal programme.

A2:Adjust the system file of the project version or CyanAnimApply of the plug-in version, find the floor parameter and adjust the ground clearance parameter.

A3:Drag the scene to match the character model

Q:How to example project for your own model

A: Importing model files into UE, modifying bone bindings, creating animation blueprints to connect nodes, modifying character references, etc. Refer to our tutorial on switching characters and bone bindings.

Q: Facial data missing from exported fbx file

A: Ensure that expressions use arkit standard naming format, FBX export settings need to be ticked all options.

Q:No response for a long time after clicking the export button, can't export FBX file normally.

A1:Check whether the model lacks root node, which will lead to the model can not be exported normally

A2:Check if the model profile bone binding is filled correctly, wrong bone binding will cause the model can't be exported normally.

Q:After clicking Run, UE flashes back and reports an error.

A1:Check if the model reference is filled in wrongly, such as more spaces in the reference, double quotes are missing, and so on.

A2:Ue5.3/5.2 plugin version because of the lod problem will lead to the runtime error flashback, you need to change the value of Number of LODs to 1 in the model.

Q: The model can't jump when the motion-capture actor jumps

A1: Adjust the system file of the engineering version or CyanAnimApply of the plug-in version, find the floor parameter and adjust the off-ground parameter. Modify and restart UE to take effect.

A2:Adjust the ground clearance slider on the acquisition side.

Q: Models in the plug-in version do not drive properly

A1: Make sure the IP address of CyanAnimApply is changed in the project settings

A2: Make sure the model's position in the scene is the (0, 0, 0) point

A3:Make sure the front of the model is Y-axis facing forward

A4:Check if the character blueprint nodes are connected correctly

A5: Make sure the mocp character component is added correctly

A6:Make sure the values of BodyName and FaceName are filled in correctly.

A7:Make sure the character blueprint is dragged into the scene.

A8:Check that the naming of skeleton binding in datatable is correct.

A9:Make sure that the Acquisition Terminal shows the motion capture.

A10:Make sure the plugin version is installed correctly

A11:Make sure the character blueprint has selected the correct anim class.

A12:Ensure that the plug-in file is placed correctly, not more than one layer of folders.